Python Utility Package

rites to write py right

---

Report a Bug | Request a Feature | Ask a Question | Make a Suggestion | Start a Discussion

---

Table of Contents

• About
• Features
• Quick Start
  • Installation
  • Basic Usage
• Documentation
• Contributing
• Authors
• License
• Disclaimer

---

About

rite is a modern Python utility library with zero external runtime dependencies. Built with Python 3.12+ in mind, it provides a comprehensive collection of utilities for cryptography, filesystem operations, text processing, collections, conversions, networking, and more.

Key Features

• Zero Dependencies: No external runtime dependencies
• Type Safe: Comprehensive type hints with Python 3.12+ syntax
• Well Tested: >99% code coverage with extensive test suite
• Modern Python: Supports Python 3.12, 3.13
• Modular Design: Clear module organization with consistent structure
• Fully Documented: Extensive documentation and practical examples

Module Overview

Module	Description
collections	Buffers, caches (LRU/LFU/TTL), dict/list/set utilities, queues, trees
conversion	Type conversions, format transformations, unit conversions
crypto	UUID generation, hashing (SHA-256, MD5, BLAKE2), ciphers, random
diagnostics	Debugging, error handling, logging, metrics, profiling
filesystem	File/folder operations, compression, path utilities, MIME types
functional	Composition, currying, decorators, memoization, predicates
markup	HTML/XML/Markdown processing, entity encoding, sanitization
net	HTTP utilities, MIME types, URL encoding, request helpers
numeric	Math operations, statistics, number formatting
reflection	Attributes, inspection, signatures, type checking
serialization	JSON, CSV, INI, TOML, pickle serialization
system	Environment, platform detection, process management, shell
temporal	Date/time utilities, timestamp operations, formatting
text	Slug generation, case conversion, sanitization, analysis, search

---

Quick Start

Installation

From PyPI:

pip install rite

Using Poetry:

poetry add rite

From Source:

git clone https://github.com/scape-agency/rite.git
cd rite
poetry install

View on PyPI

Basic Usage

# Cryptography
from rite.crypto.uuid import uuid_hex
from rite.crypto.hash import hash_sha256

user_id = uuid_hex()
password_hash = hash_sha256("secure_password")

# Filesystem
from rite.filesystem.file import file_copy, file_exists

if file_exists("config.json"):
    file_copy("config.json", "config.backup.json")

# Text Processing
from rite.text.slug import slug_generate
from rite.text.case import case_to_snake

slug = slug_generate("Hello World!")  # 'hello-world'
snake = case_to_snake("helloWorld")   # 'hello_world'

# Collections
from rite.collections.list import list_unique, list_flatten

unique = list_unique([1, 2, 2, 3])    # [1, 2, 3]
flat = list_flatten([[1, 2], [3, 4]]) # [1, 2, 3, 4]

# Serialization
from rite.serialization.json import json_load, json_dump

data = json_load("config.json")
json_dump(data, "output.json", indent=2)

# Functional
from rite.functional.composition import composition_pipe

pipeline = composition_pipe(str.strip, str.lower, str.title)
result = pipeline("  hello world  ")  # 'Hello World'

# System
from rite.system.platform import platform_is_linux, platform_name

if platform_is_linux():
    print(f"Running on {platform_name()}")

# Diagnostics
from rite.diagnostics.profiling import profiling_stopwatch

with profiling_stopwatch() as timer:
    # ... your code ...
    pass
print(f"Elapsed: {timer.elapsed:.3f}s")

---

Documentation

User Documentation

• Getting Started - Quick introduction and module overview
• Installation Guide - Detailed installation instructions
• Usage Examples - Practical examples for all modules
• API Reference - Complete API documentation

Developer Documentation

• Contributing Guide - How to contribute to Rite
• Development Setup - Set up your development environment
• Code Style Guide - Code standards and conventions
• Testing Guide - Testing practices and patterns
• Configuration Reference - Configuration files and settings

AI Agent Documentation

• AI Instructions - Guidelines for AI agents and GitHub Copilot

Additional Resources

• Changelog - Version history and release notes
• Architecture - System architecture overview
• Security Policy - Security guidelines and reporting
• License - MIT License details

---

Authors

rite is an open-source project by Scape Agency.

Scape Agency is a spatial innovation collective that dreams, discovers and designs the everyday of tomorrow. We blend design thinking with emerging technologies to create a brighter perspective for people and planet. Our products and services naturalise technology in liveable and sustainable –scapes that spark the imagination and inspire future generations.

• website: scape.agency
• github: github.com/scape-agency

---

Contributing

We'd love for you to contribute and to make rite even better than it is today! Please refer to the contribution guidelines for details on:

• Code of conduct
• Development workflow
• Code standards
• Testing requirements
• Pull request process

Quick start for contributors:

# Clone the repository
git clone https://github.com/scape-agency/rite.git
cd rite

# Install dependencies
poetry install --with dev

# Install pre-commit hooks
poetry run pre-commit install

# Run tests
make test

# Run all checks
make check

---

License

Except where otherwise noted, rite is licensed under the terms of the MIT License.

---

Disclaimer

THIS SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.

---

Made with ♥ by Scape Agency
_{Copyright 2025 Scape Agency. All Rights Reserved}