Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abseil/abseil-py
Abseil Common Libraries (Python)
https://github.com/abseil/abseil-py
application flags logging python python-library testing
Last synced: 7 days ago
JSON representation
Abseil Common Libraries (Python)
- Host: GitHub
- URL: https://github.com/abseil/abseil-py
- Owner: abseil
- License: apache-2.0
- Created: 2017-09-19T21:45:02.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-03-14T21:06:51.000Z (8 months ago)
- Last Synced: 2024-04-23T10:35:23.733Z (7 months ago)
- Topics: application, flags, logging, python, python-library, testing
- Language: Python
- Homepage:
- Size: 1.05 MB
- Stars: 2,215
- Watchers: 72
- Forks: 239
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# 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:
```bash
pip install absl-py
```
Or install from source:
```bash
python setup.py install
```
### Running Tests
To run Abseil tests, you can clone the git repo and run
[bazel](https://bazel.build/):
```bash
git clone https://github.com/abseil/abseil-py.git
cd abseil-py
bazel test absl/...
```
Please also validate the type annotations against the latest mypy:
```bash
pip install mypy
mypy absl
```
### Example Code
Please refer to
[smoke_tests/sample_app.py](https://github.com/abseil/abseil-py/blob/main/smoke_tests/sample_app.py)
as an example to get started.
## Documentation
See the [Abseil Python Developer Guide](https://abseil.io/docs/python/).
## 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](LICENSE) for more information.