Skip to content

Improve autodocs for top-level package names. #882

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 2 commits into from
May 18, 2015
Merged

Improve autodocs for top-level package names. #882

merged 2 commits into from
May 18, 2015

Conversation

@tseaver
Copy link
Contributor

@tseaver tseaver commented May 14, 2015

  • Drop the __init__ from them.
  • Include the ones imported from _implicit_environ'

Fixes #845.

@tseaver
Improve autodocs for top-level package names.
22e4c63 
- Drop the '__init__' from them.
- Include the ones imported from '_implicit_environ'.

Fixes #845.
@tseaver tseaver added api: datastore Issues related to the Datastore API. docs api: storage Issues related to the Cloud Storage API. api: pubsub Issues related to the Pub/Sub API. labels May 14, 2015
@googlebot googlebot added the cla: yes This human has signed the Contributor License Agreement. label May 14, 2015
@coveralls
Copy link

coveralls commented May 14, 2015

Coverage Status

Coverage remained the same at 100.0% when pulling 22e4c63 on tseaver:845-document__implicit_environ into 9c4867a on GoogleCloudPlatform:master.

@dhermes
Copy link
Contributor

dhermes commented May 14, 2015

I've checked out this branch and built the docs. All looks good, can you fix the docstring for datastore.set_defaults so the bullets render correctly? Use * instead of - for Sphinx.

@dhermes
Copy link
Contributor

dhermes commented May 14, 2015

Also a concern, this is very manual. How will we make sure new methods in __init__ get added to the docs?

@tseaver
Copy link
Contributor Author

tseaver commented May 14, 2015

fbba1c4 fixes the bullet rendering (not *, but a leading blank line, was required).

WRT manual config: We can't have best of all worlds for members imported into the base package:

  • Adding :imported-members: would pick up all the imports.
  • Adding just the ones we want to __all__ would make using the others look unsupported.

The real fix would be to move those implementations into the base package, and have them just tweak the defaults object in _implicit_environ.

@coveralls
Copy link

coveralls commented May 14, 2015

Coverage Status

Coverage remained the same at 100.0% when pulling fbba1c4 on tseaver:845-document__implicit_environ into 9c4867a on GoogleCloudPlatform:master.

@dhermes
Copy link
Contributor

dhermes commented May 14, 2015

I don't think the circular import gymnastics is worth it for this somewhat minor nit. Proceed: LGTM.

tseaver added a commit that referenced this pull request May 18, 2015
@tseaver
Merge pull request #882 from tseaver/845-document__implicit_environ
6bc4e02 
Improve autodocs for top-level package names.
@tseaver tseaver merged commit 6bc4e02 into googleapis:master May 18, 2015
@tseaver tseaver deleted the 845-document__implicit_environ branch May 18, 2015 18:45
@dhermes dhermes mentioned this pull request Jun 4, 2015
Merged
parthea pushed a commit that referenced this pull request Sep 18, 2025
@release-please
chore(main): release 0.28.0 (#882)
90af0df 
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
parthea pushed a commit that referenced this pull request Nov 22, 2025
@daniel-sanche @gcf-owl-bot
chore: add experimental async data client (#920)
07c1344 
* feat: add new v3.0.0 API skeleton (#745)

* feat: improve rows filters (#751)

* feat: read rows query model class (#752)

* feat: implement row and cell model classes (#753)

* feat: add pooled grpc transport (#748)

* feat: implement read_rows (#762)

* feat: implement mutate rows (#769)

* feat: literal value filter (#767)

* feat: row_exists and read_row (#778)

* feat: read_modify_write and check_and_mutate_row (#780)

* feat: sharded read rows (#766)

* feat: ping and warm with metadata (#810)

* feat: mutate rows batching (#770)

* chore: restructure module paths (#816)

* feat: improve timeout structure (#819)

* fix: api errors apply to all bulk mutations

* chore: reduce public api surface (#820)

* feat: improve error group tracebacks on < py11 (#825)

* feat: optimize read_rows (#852)

* chore: add user agent suffix (#842)

* feat: optimize retries (#854)

* feat: add test proxy (#836)

* chore(tests): add conformance tests to CI for v3 (#870)

* chore(tests): turn off fast fail for conformance tets (#882)

* feat: add TABLE_DEFAULTS enum for table method arguments (#880)

* fix: pass None for retry in gapic calls (#881)

* feat: replace internal dictionaries with protos in gapic calls (#875)

* chore: optimize gapic calls (#863)

* feat: expose retryable error codes to users (#879)

* chore: update api_core submodule (#897)

* chore: merge main into experimental_v3 (#900)

* chore: pin conformance tests to v0.0.2 (#903)

* fix: bulk mutation eventual success (#909)

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
parthea added a commit that referenced this pull request Nov 24, 2025
@gcf-owl-bot @parthea
chore(python): bump idna from 3.4 to 3.7 in .kokoro (#882)
cc6dcab 
* chore(python): bump idna from 3.4 to 3.7 in .kokoro

Source-Link: googleapis/synthtool@d50980e
Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-python:latest@sha256:5a4c19d17e597b92d786e569be101e636c9c2817731f80a5adec56b2aa8fe070

* Apply changes from googleapis/synthtool#1950

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>
parthea pushed a commit that referenced this pull request Nov 24, 2025
@rwhogg
feat: named db support (#882)
9ef29db
parthea added a commit that referenced this pull request Nov 25, 2025
@gcf-owl-bot @parthea
chore(python): bump idna from 3.4 to 3.7 in .kokoro (#882)
f7c9795 
* chore(python): bump idna from 3.4 to 3.7 in .kokoro

Source-Link: googleapis/synthtool@d50980e
Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-python:latest@sha256:5a4c19d17e597b92d786e569be101e636c9c2817731f80a5adec56b2aa8fe070

* Apply changes from googleapis/synthtool#1950

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>
parthea pushed a commit that referenced this pull request Nov 26, 2025
@tseaver
feat: add support for Python 3.10 (#882)
968306b
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

api: datastore Issues related to the Datastore API. api: pubsub Issues related to the Pub/Sub API. api: storage Issues related to the Cloud Storage API. cla: yes This human has signed the Contributor License Agreement.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Sphinx needs to document methods from _implicit_environ

4 participants

@tseaver @coveralls @dhermes @googlebot