Clarify the docstring for mark_flags_as_mutual_exclusive

The docstring has a disclaimer clarifying that this specifically checks whether a flag is "set" by checking if the value is not None. That's a good indication that it can gain a lot of clarity by avoiding the use of the word "set" elsewhere in the docstring, instead using "is None" or "is not None" specifically. The disclaimer can also do a little more to call out the fact that default values are not distinguished from explicit values by this validator.

PiperOrigin-RevId: 227527623
1 file changed
tree: 78712ebef839e83e799797487ca1839b245f478f
  1. absl/
  2. smoke_tests/
  3. third_party/
  4. AUTHORS
  5. CONTRIBUTING.md
  6. LICENSE
  7. README.md
  8. setup.py
  9. WORKSPACE
README.md

Abseil Python Common Libraries

This repository is a collection of Python library code for building Python applications. The code is collected from Google's own Python code base, and has been extensively tested and used in production.

Features

  • Simple application startup
  • Distributed commandline flags system
  • Custom logging module with additional features
  • Testing utilities

Getting Started

Installation

To install the package, simply run:

pip install absl-py

Or install from source:

python setup.py install

Running Tests

To run Abseil tests, you can clone the git repo and run bazel:

git clone https://github.com/abseil/abseil-py.git
cd abseil-py
bazel test absl/...

Example Code

Please refer to smoke_tests/sample_app.py as an example to get started.

Documentation

Full documentation is forthcoming on https://abseil.io. For now, please refer to the in-code Python docstrings.

Future Releases

The current repository includes an initial set of libraries for early adoption. More components and interoperability with Abseil C++ Common Libraries will come in future releases.

License

The Abseil Python library is licensed under the terms of the Apache license. See LICENSE for more information.