Description
We have an odd mix of sample locations:
docs/snippets.py
-- the original location, not very copy-pasteable / browsable- lots of samples in
samples/*.py
, but the test drivers are insamples/tests/
samples/snippets/*.py
samples/geography/*.py
To align with the infrastructure in https://github.com/googleapis/synthtool/tree/master/synthtool/gcp/templates/python_samples, the goal is to have:
samples/snippets/
-- these samples just require thegoogle-cloud-bigquery
librarysamples/geography/
-- require extra dependencies for working with geography datasample/pandas/
-- require extra dependencies for working with pandas dataframes- more??? -- possibly a directory for the user-based authentication samples
To avoid breaking cloud.google.com docs, this needs to be done in several steps:
- Copy samples to correct location
- Update docs (Googler must do this)
- Delete duplicate samples in old location
Towards: #366 (use templated noxfile) and #765 (blacken samples using templated noxfile(s))