René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"standardize samples directory layout","articleBody":"We have an odd mix of sample locations:\r\n\r\n- `docs/snippets.py` -- the original location, not very copy-pasteable / browsable\r\n- lots of samples in `samples/*.py`, but the test drivers are in `samples/tests/`\r\n- `samples/snippets/*.py`\r\n- `samples/geography/*.py`\r\n\r\nTo align with the infrastructure in https://github.com/googleapis/synthtool/tree/master/synthtool/gcp/templates/python_samples, the goal is to have:\r\n\r\n- `samples/snippets/` -- these samples just require the `google-cloud-bigquery` library \r\n- `samples/geography/` -- require extra dependencies for working with geography data\r\n- `sample/pandas/` -- require extra dependencies for working with pandas dataframes\r\n- more??? -- possibly a directory for the user-based authentication samples\r\n\r\nTo avoid breaking cloud.google.com docs, this needs to be done in several steps:\r\n\r\n1. Copy samples to correct location\r\n2. Update docs (Googler must do this)\r\n3. Delete duplicate samples in old location\r\n\r\nTowards: https://github.com/googleapis/python-bigquery/issues/366 (use templated noxfile) and ~https://github.com/googleapis/python-bigquery/issues/765 (blacken samples using templated noxfile(s))~","author":{"url":"https://github.com/tswast","@type":"Person","name":"tswast"},"datePublished":"2021-07-21T18:14:13.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/790/python-bigquery/issues/790"}