Skip to content

Annotate pylintrc w defaults and rationale - #368

Merged
tseaver merged 6 commits into
googleapis:masterfrom
tseaver:annotate_pylintrc_w_defaults_and_rationale
Nov 11, 2014
Merged

Annotate pylintrc w defaults and rationale#368
tseaver merged 6 commits into
googleapis:masterfrom
tseaver:annotate_pylintrc_w_defaults_and_rationale

Conversation

@tseaver

Copy link
Copy Markdown
Contributor

Generated from 'pylint --generate-rcfile'.

Defaults are commented out.

Exceptions to defaults include a rationale.

Note generation of 'pylintrc_reduced'.

Minor changes to code to conform w/ new config.

Helper, not API; unused outside 'gcloud.datastore.helpers'.
Removes pylintrc wart.
Generated from 'pylint --generate-rcfile'.
Defaults are commented out.
Exceptions to defaults include a rationale.
Note generation of 'pylintrc_reduced'.
@tseaver

Copy link
Copy Markdown
ContributorAuthor

@dhermes, @silvolu PTAL.

Comment threadpylintrc_default Outdated

This comment was marked as spam.

This comment was marked as spam.

@coveralls

Copy link
Copy Markdown

Coverage Status

Changes Unknown when pulling e9e69f9 on tseaver:annotate_pylintrc_w_defaults_and_rationale into * on GoogleCloudPlatform:master*.

Comment threadpylintrc_default Outdated

This comment was marked as spam.

Comment threadpylintrc_default

This comment was marked as spam.

This comment was marked as spam.

@coveralls

Copy link
Copy Markdown

Coverage Status

Changes Unknown when pulling 5e0f5c3 on tseaver:annotate_pylintrc_w_defaults_and_rationale into * on GoogleCloudPlatform:master*.

@coveralls

Copy link
Copy Markdown

Coverage Status

Changes Unknown when pulling 5e0f5c3 on tseaver:annotate_pylintrc_w_defaults_and_rationale into * on GoogleCloudPlatform:master*.

@tseaver

Copy link
Copy Markdown
ContributorAuthor

@dhermes any reason not to merge?

@dhermes

Copy link
Copy Markdown
Contributor

Sorry, was in transit.

RE: YAGNI, I totally agree. However I've seen the unused_ prefix used a fair deal throughout large code-bases, but it's very possible we'll never have issue where we have to preserve an interface without requiring an argument.

In general, these were the kinds of discussions I wanted to have about the config so we can eliminate the churn.

@tseaver are we proposing this is the "frozen" final config or just a first step towards it?

@tseaver

Copy link
Copy Markdown
ContributorAuthor

Given that I don't really believe in a "final" config, I'd say this is just a better config than what we have now: it drops some exclusions we no longer need, and documents the places where we adopt policies different than the out-of-the-box defaults. If we run up against future failures, it provides more information than we have now to decide whether to change the code or the pylintrc (by documenting all the defaults in place).

We could get to a "final" point for storage / datastore, and then still need to tweak it for either Py3k or a new API set (most of our explicit policies are due to API-mapping).

@coveralls

Copy link
Copy Markdown

Coverage Status

Changes Unknown when pulling 1a79f4c on tseaver:annotate_pylintrc_w_defaults_and_rationale into * on GoogleCloudPlatform:master*.

@tseaver

Copy link
Copy Markdown
ContributorAuthor

@dhermes OK to merge?

@dhermes

Copy link
Copy Markdown
Contributor

LGTM

tseaver added a commit that referenced this pull request Nov 11, 2014
…_rationale
Annotate pylintrc w defaults and rationale
@tseaver
tseaver merged commit 95e80e1 into googleapis:masterNov 11, 2014
@tseaver
tseaver deleted the annotate_pylintrc_w_defaults_and_rationale branch November 11, 2014 22:09
atulep pushed a commit that referenced this pull request Apr 3, 2023
* docs: Add documentation for latest models to RecognitionConfig
PiperOrigin-RevId: 446200223
Source-Link: googleapis/googleapis@4f586ea
Source-Link: googleapis/googleapis-gen@4ffe3d9
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNGZmZTNkOWZkZmYzY2M1NWRhNzBhNTZhOGM2NDM1ODdlMTZlMmZlOCJ9
* 🦉 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>
atulep pushed a commit that referenced this pull request Apr 6, 2023
* docs: Add documentation for latest models to RecognitionConfig
PiperOrigin-RevId: 446200223
Source-Link: googleapis/googleapis@4f586ea
Source-Link: googleapis/googleapis-gen@4ffe3d9
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNGZmZTNkOWZkZmYzY2M1NWRhNzBhNTZhOGM2NDM1ODdlMTZlMmZlOCJ9
* 🦉 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>
atulep pushed a commit that referenced this pull request Apr 6, 2023
* docs: Add documentation for latest models to RecognitionConfig
PiperOrigin-RevId: 446200223
Source-Link: googleapis/googleapis@4f586ea
Source-Link: googleapis/googleapis-gen@4ffe3d9
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNGZmZTNkOWZkZmYzY2M1NWRhNzBhNTZhOGM2NDM1ODdlMTZlMmZlOCJ9
* 🦉 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>
parthea pushed a commit that referenced this pull request Sep 22, 2023
Source-Link: googleapis/synthtool@eb78c98
Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-python:latest@sha256:8a5d3f6a2e43ed8293f34e06a2f56931d1e88a2694c3bb11b15df4eb256ad163
parthea pushed a commit that referenced this pull request Sep 22, 2023
* docs: update documentation to require certain fields
PiperOrigin-RevId: 530345646
Source-Link: googleapis/googleapis@ae157a1
Source-Link: googleapis/googleapis-gen@1798b3d
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTc5OGIzZDBiZDE2YzZmZmM2YTFjY2EzMWYzMTYyOTQyMzQ3MjdiYiJ9
* 🦉 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>
parthea pushed a commit that referenced this pull request Sep 22, 2023
* fix: integrate gapic-generator-python-1.4.1 and enable more py_test targets
PiperOrigin-RevId: 473833416
Source-Link: googleapis/googleapis@565a550
Source-Link: googleapis/googleapis-gen@1ee1a06
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMWVlMWEwNmM2ZGUzY2E4Yjg0MzU3MmMxZmRlMDU0OGY4NDIzNjk4OSJ9
* 🦉 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>
parthea pushed a commit that referenced this pull request Oct 21, 2023
parthea added a commit that referenced this pull request Oct 21, 2023
parthea pushed a commit that referenced this pull request Oct 21, 2023
Source-Link: https://togithub.com/googleapis/synthtool/commit/92006bb3cdc84677aa93c7f5235424ec2b157146
Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-python:latest@sha256:2e247c7bf5154df7f98cce087a20ca7605e236340c7d6d1a14447e5c06791bd6
parthea pushed a commit that referenced this pull request Oct 21, 2023
* feat: Add support for python 3.11
chore: Update gapic-generator-python to v1.8.0
PiperOrigin-RevId: 500768693
Source-Link: googleapis/googleapis@190b612
Source-Link: googleapis/googleapis-gen@7bf29a4
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiN2JmMjlhNDE0YjllY2FjMzE3MGYwYjY1YmRjMmE5NTcwNWMwZWYxYSJ9
* 🦉 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>
parthea added a commit that referenced this pull request Oct 21, 2023
* chore: allow releases on previous majors
* 🦉 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>
parthea added a commit that referenced this pull request Oct 21, 2023
Co-authored-by: Anthonios Partheniou <partheniou@google.com>
parthea pushed a commit that referenced this pull request Oct 21, 2023
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
parthea pushed a commit that referenced this pull request Oct 21, 2023
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
parthea pushed a commit that referenced this pull request Oct 22, 2023
* docs: Add documentation for latest models to RecognitionConfig
PiperOrigin-RevId: 446200223
Source-Link: googleapis/googleapis@4f586ea
Source-Link: googleapis/googleapis-gen@4ffe3d9
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNGZmZTNkOWZkZmYzY2M1NWRhNzBhNTZhOGM2NDM1ODdlMTZlMmZlOCJ9
* 🦉 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>
parthea pushed a commit that referenced this pull request Aug 21, 2025
parthea pushed a commit that referenced this pull request Sep 16, 2025
parthea pushed a commit that referenced this pull request Nov 24, 2025
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
parthea pushed a commit that referenced this pull request Nov 24, 2025
Source-Link: googleapis/synthtool@f15cc72
Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-python:latest@sha256:bc5eed3804aec2f05fad42aacf973821d9500c174015341f721a984a0825b6fd
parthea pushed a commit that referenced this pull request Nov 24, 2025
parthea added a commit that referenced this pull request Nov 24, 2025
* feat: Support the Count aggregation query
* Add `run_aggregation_query` interface to the http client.
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
* chore(deps): update all dependencies
* Update docs.yml
* Update lint.yml
---------
Co-authored-by: Lingqing Gan <lingqing.gan@gmail.com>
parthea pushed a commit that referenced this pull request Nov 24, 2025
#368)
Source-Link: googleapis/synthtool@de3def6
Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-python:latest@sha256:a1c5112b81d645f5bbc4d4bbc99d7dcb5089a52216c0e3fb1203a0eeabadd7d5
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
parthea pushed a commit that referenced this pull request Nov 24, 2025
* feat: bulk writer 555 rate_limiter (#368)
* added 555 throttle utility
* Update google/cloud/firestore_v1/throttle.py
Co-authored-by: Tres Seaver <tseaver@palladion.com>
* added ability to request a number of tokens
* replaced Callable now parameter with module function
* updated tests
* renamed throttle -> ramp up
* improved docstrings
* linting
* fixed test coverage
* rename to RateLimiter and defer clock to first op
* linting
Co-authored-by: Tres Seaver <tseaver@palladion.com>
* feat: added new batch class for BulkWriter (#397)
* feat: added new batch class for BulkWriter
* updated docstring to use less colloquial language
* feat: BulkWriter implementation (#384)
* feat: added `write` method to batch classes
* added docstrings to all 3 batch classes
instead of just the base
* updated batch classes to remove control flag
now branches logic via subclasses
* fixed broken tests off abstract class
* fixed docstring
* refactored BulkWriteBatch
this commit increases the distance between WriteBatch and BulkWriteBatch
* began adding [Async]BulkWriter
* continued implementation
* working impl or BW
* tidied up BW impl
* beginning of unit tests for BW
* fixed merge problem
* initial set of BW unit tests
* refactored bulkwriter sending mechanism
now consumes off the queue and schedules on the main thread, only going async to actually send
* final CI touch ups
* 🦉 Updates from OwlBot
See https://github.com/googleapis/repo-automation-bots/blob/master/packages/owl-bot/README.md
* 🦉 Updates from OwlBot
See https://github.com/googleapis/repo-automation-bots/blob/master/packages/owl-bot/README.md
* moved BulkWriter parameters to options format
* rebased off master
* test fixes
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
* feat: add retry support for BulkWriter errors (#413)
* parent 0176cc7fef8752433b5c2496046d3a56557eb824
author Craig Labenz <craig.labenz@gmail.com> 1623693904 -0700
committer Craig Labenz <craig.labenz@gmail.com> 1628617523 -0400
feat: add retries to bulk-writer
* fixed rebase error
Co-authored-by: Tres Seaver <tseaver@palladion.com>
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
parthea pushed a commit that referenced this pull request Nov 24, 2025
parthea pushed a commit that referenced this pull request Nov 26, 2025
…lure' occurs (#368)
* Add retry loop for fetching authentication token if any 'Internal failure' occurs
This is to prevent errors while client tries to connect with server and
fails with 'Internal Failure' because it was unable to fetch OAuth2
token.
* Add retry loop for fetching authentication token if any 'Internal failure' occurs
This is to prevent errors while client tries to connect with server and
fails with 'Internal Failure' because it was unable to fetch OAuth2
token.
parthea pushed a commit that referenced this pull request Mar 2, 2026
…cp/templates/python_library/.kokoro (#368)
Source-Link: googleapis/synthtool@b4fe62e
Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-python:latest@sha256:3bf87e47c2173d7eed42714589dc4da2c07c3268610f1e47f8e1a30decbfc7f1
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
parthea pushed a commit that referenced this pull request Mar 9, 2026
Co-authored-by: Frank Natividad <frankyn@users.noreply.github.com>
parthea added a commit that referenced this pull request Mar 9, 2026
parthea pushed a commit that referenced this pull request Mar 9, 2026
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@tseaver@coveralls@dhermes