core-mixins

This project contains common functions, decorators, and mixin classes as the base for other projects or libraries…

Installation

Install from PyPI using pip:

pip install core-mixins
uv pip install core-mixins  # Or using UV...

Features

This library provides the following modules and utilities:

Compatibility

Self - Type hint for self-referential classes
StrEnum - String enumeration compatibility across Python versions

Decorators (core_mixins.decorators)

cache / cache_memory_based - In-memory LRU memoization with optional maxsize and ttl
cache_file_based - Write-through two-level cache (L1 memory + L2 disk), survives process restarts
count_calls - Track function call counts
repeat - Execute functions multiple times
retry - Automatic retry with configurable backoff
singleton - Enforce single instance pattern
SyncWrapper - Convert async functions to synchronous
with_timeout - Subprocess-based timeout, cross-platform, sub-second precision
with_timeout_signal - Signal-based timeout (Unix/Linux only), minimal overhead
timer - Measure function execution time

File Utilities (core_mixins.files)

records_from_csv / records_to_csv - CSV file handling
records_from_buffer / records_to_buffer - In-memory CSV operations

Interfaces (core_mixins.interfaces)

IFactory - Factory pattern interface
ITask - Task interface with status tracking
TaskStatus - Task state enumeration
TaskException - Task-specific exceptions

Managers (core_mixins.managers)

TasksManager - Manage and execute multiple tasks
TaskResult - Task execution result container

Logging (core_mixins.logger)

get_logger - Standardized logger configuration

Utilities (core_mixins.utils)

random_string - Generate random strings
get_batches - Batch list processing
remove_attributes / rename_attributes / add_attributes - Dictionary manipulation
convert_data_type - Type conversion utilities
to_snake_case - Convert strings to snake_case
flatten_json - Flatten nested JSON structures
to_one_line - Convert multiline strings to single line
bytes_to_str - Convert bytes to string

Exceptions (core_mixins.exceptions)

get_exception_data - Extract structured exception information

CLI Utilities (core_mixins.cli)

ProgressTracker - TTY-aware progress bar; animates on real terminals, falls back to logger.info on Lambda/ECS/CI. Built as a zero-dependency alternative to tqdm, keeping core-mixins dependency-free so it does not pull transitive packages into production services where supply-chain surface area and package size matter.

Quick Start

Installation

Install the package:

pip install core-mixins
uv pip install core-mixins  # Or using UV...
pip install -e ".[dev]"    # For development...

Setting Up Environment

Install required libraries:

pip install --upgrade pip
pip install virtualenv

Create Python virtual environment:

virtualenv --python=python3.12 .venv

Activate the virtual environment:

source .venv/bin/activate

Install packages

pip install .
pip install -e ".[dev]"

Check tests and coverage

python manager.py run-tests                             # unit tests (default)
python manager.py run-tests -t integration              # integration tests
python manager.py run-tests -t functional -p "*.py"     # functional tests
python manager.py run-coverage                          # all tests with coverage

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Write tests for new functionality
Ensure all tests pass: python manager.py run-tests
Run linting: pylint core_mixins
Run security checks: bandit -r core_mixins
Submit a pull request

License

This project is licensed under the MIT License. See the LICENSE file for details.

Support

For questions or support, please open an issue on GitLab or contact the maintainers.

Authors

Alejandro Cora González - Initial work - alek.cora.glez@gmail.com

Metadata

Release files for core-mixins 3.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for core-mixins 3.2.1
File	Size	Uploaded
core_mixins-3.2.1.tar.gz	23.7 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for core-mixins 3.2.1
File	Interpreter	ABI	Platform	Reset
core_mixins-3.2.1-py3-none-any.whl 28.7 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 52.4 kB

Release files / core_mixins-3.2.1.tar.gz

Download URL	core_mixins-3.2.1.tar.gz
Size	23.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`1d7fa83f41d8774bd54caf4875af7e7318427acc215752fb196aa2eecc150734`
BLAKE2b-256 checksum How to use checksums	`e1aa0716be95cd2d65bd728a790e8141e007ed35c03c82ef10f857602a4c382c`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Release files / core_mixins-3.2.1-py3-none-any.whl

Download URL	core_mixins-3.2.1-py3-none-any.whl
Size	28.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2f1bf305ead3a80a7e94f11bd563f66358466643caf197a7b164abeb209594d0`
BLAKE2b-256 checksum How to use checksums	`5e46369a5455d57ae4474ca95afc1591ba4a0eb4ad773e3101a94ff806733a15`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`