Lacus Solutions' Utils

Reusable utilities library for Lacus Solutions' Python packages.

Python Support

Passing ✔	Passing ✔	Passing ✔	Passing ✔	Passing ✔

Features

• Type description: Python-native type labels for error messages (NoneType, dict, tuple, built-ins, lists)
• Random sequences: Generate numeric, alphabetic, or alphanumeric sequences of any length
• Zero dependencies: No external runtime packages required

Installation

$ pip install lacus.utils

Import

from lacus.utils import describe_type, generate_random_sequence, SequenceType

Quick Start

describe_type(None)           # 'NoneType'
describe_type("hello")        # 'string'
describe_type(42)             # 'integer number'
describe_type(3.14)           # 'float number'
describe_type(float("nan"))   # 'NaN'
describe_type({})             # 'dict'
describe_type([1, 2, 3])      # 'number[]'
describe_type([1, "a", 2])    # '(number | string)[]'
describe_type((1, 2))         # 'number tuple'

generate_random_sequence(10, "numeric")       # e.g. '9956000611'
generate_random_sequence(6, "alphabetic")   # e.g. 'AXQMZB'
generate_random_sequence(8, "alphanumeric") # e.g. '8ZFB2K09'

API

All functions are implemented in src/lacus/utils/ and covered by tests in tests/.

describe_type(value) -> str

Describes the type of a value for error messages.

generate_random_sequence(size: int, sequence_type: SequenceType) -> str

Generates a random character sequence of the given length and type.

• size: Length of the sequence (e.g. 10).
• sequence_type: One of:
  • 'numeric': digits 0-9
  • 'alphabetic': uppercase letters A-Z
  • 'alphanumeric': digits and uppercase letters 0-9A-Z

Exports summary

Contribution & Support

We welcome contributions! Please see our Contributing Guidelines for details. If you find this project helpful, please consider:

• Starring the repository
• Contributing to the codebase
• Suggesting new features
• Reporting bugs

License

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

Changelog

See CHANGELOG for a list of changes and version history.

Made with ❤️ by Lacus Solutions