UniversalFunctions

UniversalFunctions is a Python utility library providing foundational functions, validators, decorators, type utilities, and infrastructure for building structured Python applications and domain-specific APIs.

It is designed as an independent foundation layer that can be used on its own or as a dependency of larger projects such as GeometricalDomination.

Installation

Install UniversalFunctions from PyPI:

pip install UniversalFunctions

The package requires Python 3.14 or later.

Usage

UniversalFunctions is imported through the UF Python package:

from UF.Validators import TypeValidate from numbers import Real

TypeValidate(Real)(56)

The distribution name is UniversalFunctions, while the Python import package is UF.

Package Structure

UniversalFunctions is organized into several foundational components:

UF

The main package containing the core infrastructure and utilities.

UF.Validators

Provides runtime validation utilities and validation classes for enforcing types, ranges, relationships, and other constraints.

Notable components include:

TypeValidate
TupleValidate
LessThan
LessOrEqual
GreaterOrEqual
Positive
real_validate
str_validate
Callable validation utilities

The validation system also contains the Quantum Turtle Mechanics (QTM) validation infrastructure used for more structured runtime validation.

Decorators

UniversalFunctions provides reusable decorator infrastructure, including decorator composition and class-level decorator utilities.

Notable components include:

class_decorator
deco_superposition
cls_deco_superposition
Quantum Turtle Mechanics validation decorators

Helper Functions

The library contains foundational helper functions intended to be reused by higher-level applications and APIs.

These utilities include mathematical and general-purpose functionality used throughout the surrounding ecosystem.

Design Philosophy

UniversalFunctions exists as a foundational layer rather than as a standalone end-user application.

Its purpose is to provide reusable infrastructure that higher-level projects can build upon without duplicating common functionality.

The architecture separates foundational utilities from domain-specific functionality, allowing projects to depend on UniversalFunctions independently.

In the GeometricalDomination ecosystem, UniversalFunctions acts as the bridge between the underlying infrastructure and higher-level systems.

Quantum Dimension

UniversalFunctions contains several architectural concepts inspired by the internal terminology of GeometricalDomination.

These include:

Quantum Turtle Mechanics (QTM)
Classical Turtle Mechanics (CTM)
Quantum Turtle String Theory (QTST)
The Quantum Dimension

These names describe architectural concepts within the project's validation and infrastructure systems.

Requirements

Python 3.14 or later

UniversalFunctions is designed for modern Python and makes use of contemporary Python typing and language features.

Development

Clone the repository and install it in editable mode:

git clone https://github.com/Mangosaber2026/UniversalFunctions.git cd UniversalFunctions pip install -e .

Editable installation allows changes to the source code to be reflected immediately without reinstalling the package.

License

UniversalFunctions is distributed under the terms of the license included in this repository.

Author

Miah M. Sabiq

UniversalFunctions is developed as an independent Python package and serves as foundational infrastructure for larger projects within the author's software ecosystem.

Metadata

Release files for UniversalFunctions 1.1.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 UniversalFunctions 1.1.1
File	Size	Uploaded	Provenance
universalfunctions-1.1.1.tar.gz	10.8 kB	Oct 4, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for UniversalFunctions 1.1.1
File	Interpreter	ABI	Platform	Reset
universalfunctions-1.1.1-py3-none-any.whl 13.0 kB Oct 4, 2026 With provenance	Python 3	none	any	Details

Total release size: 23.8 kB

Release files / universalfunctions-1.1.1.tar.gz

Download URL	universalfunctions-1.1.1.tar.gz
Size	10.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`956515ab529e0a94e5529ce6190180a4527d9a6279073a93945c4abad623d8d4`
BLAKE2b-256 checksum How to use checksums	`dd012225ae58876634a0898f7882f9109d788468dd7d1f540f6da23b5edcf898`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Mangosaber2026/UniversalFunctions
Publishing commit: github.com/Mangosaber2026/UniversalFunctions/tree/ad98c757964af9dc6d86f9fd66b40d9942099293

Workflow

Publishing configuration: github.com/Mangosaber2026/UniversalFunctions/blob/ad98c757964af9dc6d86f9fd66b40d9942099293/.github/workflows/release.yml
Publishing logs: github.com/Mangosaber2026/UniversalFunctions/actions/runs/37209408344/attempts/1

Artifact

Subject: universalfunctions-1.1.1.tar.gz
SHA-256 checksum: 956515ab529e0a94e5529ce6190180a4527d9a6279073a93945c4abad623d8d4 Verifying attestations

Release files / universalfunctions-1.1.1-py3-none-any.whl

Download URL	universalfunctions-1.1.1-py3-none-any.whl
Size	13.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`99b24a024083cecbf977e7f0de12d559b00c1368950bd4708a62024c241c28c2`
BLAKE2b-256 checksum How to use checksums	`56a95bf711f31cd445fbeb1f54a04b75abe943c33e8c1c596c75e1875de464e6`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Mangosaber2026/UniversalFunctions
Publishing commit: github.com/Mangosaber2026/UniversalFunctions/tree/ad98c757964af9dc6d86f9fd66b40d9942099293

Workflow

Publishing configuration: github.com/Mangosaber2026/UniversalFunctions/blob/ad98c757964af9dc6d86f9fd66b40d9942099293/.github/workflows/release.yml
Publishing logs: github.com/Mangosaber2026/UniversalFunctions/actions/runs/37209408344/attempts/1

Artifact

Subject: universalfunctions-1.1.1-py3-none-any.whl
SHA-256 checksum: 99b24a024083cecbf977e7f0de12d559b00c1368950bd4708a62024c241c28c2 Verifying attestations

Security for UniversalFunctions 1.1.1

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for universalfunctions-1.1.1.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Mangosaber2026/UniversalFunctions
Publishing commit: github.com/Mangosaber2026/UniversalFunctions/tree/ad98c757964af9dc6d86f9fd66b40d9942099293

Workflow

Publishing configuration: github.com/Mangosaber2026/UniversalFunctions/blob/ad98c757964af9dc6d86f9fd66b40d9942099293/.github/workflows/release.yml
Publishing logs: github.com/Mangosaber2026/UniversalFunctions/actions/runs/37209408344/attempts/1

Artifact

Subject: universalfunctions-1.1.1.tar.gz
SHA-256 checksum: 956515ab529e0a94e5529ce6190180a4527d9a6279073a93945c4abad623d8d4 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.