python-humble-utils 2.0.0

Python utils for everyday use.

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 python_humble_utils.commands import (
    yield_file_paths,
    camel_or_pascal_case_to_snake_case
)


# ...


file_paths = yield_file_paths(dir_path=os.path.join('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 scaffolded via Cookiecutter with audreyr/cookiecutter-pypackage template.

History

v2.0.0

v2.0.0.

• Move tests to the root.
• Pick another naming scheme for tests.
• Convert NamedTuple’s to classes and document them.
• Clean up docstrings.
• Stop indexing tests in docs.

v1.0.4

v1.0.4.

• Update HISTORY.

v1.0.3

v1.0.3.

• Fix deployment to the new PyPI.
• Mention python-humble-utils in “Open Source Projects using Hypothesis”.
• Move bumpversion configuration from setup.cfg to .bumpversion.cfg.
• Enclose notes in Note blocks.
• Remove entrypoint section from setup.py.
• Add insert utility.

v1.0.2

v1.0.2.

• Add Code Climate badge to README.

v1.0.1

v1.0.1.

• Fix README not rendered properly on PyPI.

v1.0.0

v1.0.0.

• Bump package Development Status.
• Test package deployment locally.
• Fix relative paths notice.
• Add Gitter badge.
• Fill in HISTORY.

v0.5.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.

v0.4.0

v0.4.0.

• Support Python 3.6.

v0.3.0

v0.3.0.

• Setup ReadTheDocs.

v0.2.0

v0.2.0.

• First release on PyPI.