Python utils for everyday use.
Project description
Python Humble Utils
Python utils for everyday use.
- Documentation.
- Please, open issues before sending emails to the maintainers: You will get a much faster response!
Feature Areas
- File operations.
- File/directory paths extraction.
- File/directory paths randomization.
- String case conversions.
- Python class convenience shortcuts.
- py.test fixtures and helpers.
Installation
$ pip install python-humble-utils
or install from sources:
$ python setup.py install
Refer to Installation for detailed instructions.
Usage
import os from pathlib import Path from python_humble_utils.filesystem import yield_file_paths from python_humble_utils.strings import camel_or_pascal_case_to_snake_case # ... file_paths = yield_file_paths( dir_path=Path("dir") / "with" / "scripts", allowed_file_extensions=(".sh", ".bash"), recursively=True ) assert set(file_paths) == set(("s1.sh", "s2.bash", "s3.bash")) s = camel_or_pascal_case_to_snake_case("camelCasedString") assert s == "camel_cased_string" s = camel_or_pascal_case_to_snake_case("PascalCasedString") assert s == "pascal_cased_string" # ...
Contributing
Your contributions are very much welcome! Refer to Contributing for more details.
Code of Conduct
All those using python-humble-utils, including its codebase and project management ecosystem are expected to follow the Python Community Code of Conduct.
Acknowledgements
This package was initially scaffolded via Cookiecutter with audreyr/cookiecutter-pypackage template.
History
v3.0.0
Breaking changes:
- The following functions have been removed as part of the Remove redundant utilities/utilities making no sense effort:
- extract_file_name_with_extension
- extract_file_name_and_extension
- extract_file_dir_path
- parse_tuple_from_string
- generate_hex_uuid_4
- generate_random_file_name_with_extension
- get_class_name
- get_class_qualname
- Package structure has been altered.
- Drop support for Python 3.5.
Other changes:
- Update the docs.
- Switch from Python 3.6+ typing.Collection back to typing.Sequence for backward compatibility with Python 3.5.
- Support Python 3.8.
- Switch to native Python paths.
- Support Python 3.7.
- Upgrade all dependencies to the latest versions to date.
v2.0.0
v1.0.3
v1.0.0
v0.5.0
- Document python_humble_utils package.
- Introduce local requirements.
- Stop using pip-tools.
- Point out that all paths in docs are relative to the project root.
- Prevent pip-tools from injecting indirect requirements.
- Target stable docs version only.
- Fix README not rendered on PyPI.
- Ensure codecov evaluates coverage against payload files only.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size python_humble_utils-3.1.0-py2.py3-none-any.whl (8.0 kB) | File type Wheel | Python version py2.py3 | Upload date | Hashes View |
Filename, size python-humble-utils-3.1.0.tar.gz (16.6 kB) | File type Source | Python version None | Upload date | Hashes View |
Close
Hashes for python_humble_utils-3.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 34784313c997a19491893e4f98923efa2cd9176642ad5d4b729ddb8137239bd8 |
|
MD5 | 205d48dc27e6e965c62e53697cdcb628 |
|
BLAKE2-256 | ee55c331ecbf33c9aba370a4b77275e8dbb81d218325fa8497b30bb46cb608fa |
Close
Hashes for python-humble-utils-3.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1228edc5abe380b5041e5ec85c5a0ee966270972035816c3fb8af3f1c5b87377 |
|
MD5 | fc0ac3257ee712f6ba0671509c396bbf |
|
BLAKE2-256 | c87a792ec8e520bf82580d97fffc4efff1bcb1c48a8a90dd15123ec8e20cb7e5 |