bpyutils: A Collection of Python Utilities

0.5.8 · active · verified Mon Apr 13

bpyutils by Achilles Rasquinha is a collection of various common Python utilities designed to assist with general programming tasks. The current version is 0.5.8. Its release cadence is irregular, typically driven by the addition or refinement of utility functions rather than a fixed schedule.

Warnings

gotcha Do not confuse this 'bpyutils' PyPI package with Blender's built-in 'bpy.utils' module. They are entirely separate libraries with different functionalities and import paths. This library (achillesrasquinha/bpyutils) is a general Python utility collection.
Fix: Ensure you are importing from `bpyutils` (for this package) or `bpy.utils` (when scripting within Blender) as appropriate for your project.
gotcha The documentation for specific utility functions and their APIs within the `achillesrasquinha/bpyutils` repository can be sparse. Users may need to inspect the source code to understand exact function signatures and behaviors.
Fix: Refer directly to the GitHub repository's source code for the most accurate and up-to-date API details if official documentation is insufficient.
deprecated As a general utility collection, specific functions or modules within `bpyutils` may undergo changes or deprecation in minor versions without explicit warnings in the top-level README or PyPI page. Follow semantic versioning strictly and review changes between updates.
Fix: Always test your application thoroughly after updating `bpyutils` to a new version, even minor ones. Monitor the project's GitHub for release notes or commit logs detailing changes.

Install

pip install bpyutils Install with pip

Imports

common utility functions or classes
```
from bpyutils.util.system import get_os
```
This `bpyutils` is distinct from Blender's `bpy.utils` module. Direct import of common utilities from submodules is the expected pattern. Specific module and function names will depend on the utility needed.

Quickstart

This quickstart demonstrates importing and using a couple of common utility functions from `bpyutils.util.system` and `bpyutils.util.datetime` to get the current operating system and a timestamp.

from bpyutils.util.system import get_os
from bpyutils.util.datetime import get_timestamp

print(f"Operating System: {get_os()}")
print(f"Current Timestamp: {get_timestamp()}")

view raw JSON →