MareArts Crystal

Python encryption library for software licensing and data protection. Simple, fast, and cross-platform.

🎯 Core Features

• Software Licensing - Generate and validate time-limited license keys with signatures
• File Encryption - Protect any file type with filename-based encryption
• Data Security - Encrypt strings, configs, and binary data with one line of code

💡 Why MareArts Crystal?

• Simple - Just pip install marearts-crystal and start coding
• Fast - Cython-compiled for C++ performance
• Compatible - Python 3.9-3.14, Windows/macOS/Linux
• Proven - Used in production by real businesses

Installation

pip install marearts-crystal

Requirements: Python 3.9-3.14, Windows/macOS/Linux

Quick Start

License Key Generation

from marearts_crystal import ma_crystal

mask = ma_crystal("your-company-secret")

# Generate license key with signature
today = mask.get_today_date()  # "2025-09-12"
expire = mask.generate_end_date(years=1)  # "2026-09-12"
license_key, signature = mask.generate_serial_key("customer@email.com", today, expire)

print(f"License Key: {license_key}")
# Output: License Key: MAEV2:gAAAAABow91CXuG7dJR3eAWpEXj67RP-qboPAHiDGpVfd2dGN5yBXp...

print(f"Signature: {signature}")
# Output: Signature: a21521da5beb6d7c

# Validate license
result = mask.validate_serial_key("customer@email.com", license_key)
if result:
    start_date, end_date, signature = result
    # start_date = "2025-09-12", end_date = "2026-09-12", signature = "a21521da5beb6d7c"
    if mask.validate_date(start_date, end_date):
        print(f"✅ License active until {end_date}")
        # Output: ✅ License active until 2026-09-12

# Using signature for tracking
license_db = {}  # Your database

# Store license with signature
license_key, signature = mask.generate_serial_key("user@email.com", today, expire)
license_db[signature] = {
    "email": "user@email.com",
    "key": license_key,
    "created": today
}

# Later, verify and track
result = mask.validate_serial_key("user@email.com", license_key)
if result:
    start, end, sig = result
    print(f"License {sig} is valid")  # Use signature as ID

File Encryption

# Encrypt file
with open("document.pdf", "rb") as f:
    file_data = f.read()  # Read original file (e.g., 241979 bytes)

encrypted = mask.encrypt_data(file_data)
print(f"Encrypted size: {len(encrypted)} bytes")
# Output: Encrypted size: 322724 bytes

with open("document.pdf.enc", "wb") as f:
    f.write(encrypted)

# Decrypt file
with open("document.pdf.enc", "rb") as f:
    encrypted_data = f.read()

decrypted = mask.decrypt_data(encrypted_data)
print(f"Decrypted size: {len(decrypted)} bytes")
# Output: Decrypted size: 241979 bytes (matches original)

with open("document_decrypted.pdf", "wb") as f:
    f.write(decrypted)
print("✅ File successfully decrypted")
# Output: ✅ File successfully decrypted

More Examples

Python Examples (View on GitHub)

• License key generation and validation
• File encryption/decryption
• Config file encryption
• License manager class implementation
• Password vault implementation
• All API methods demonstration

Jupyter Notebook (Interactive Tutorial)

• Interactive step-by-step tutorial
• Visual output of each operation
• Real-time testing environment

API Reference

Basic Methods

Utility Methods

Maintainer CI/CD Layout

Root folder keeps only 3 main CI scripts:

• ./building_wheels.sh - build local Linux wheels
• ./publish_wheels.sh - upload local artifacts to PyPI
• ./trigger_github_action.sh - push release tag to trigger GitHub Actions (macOS/Windows wheels)

All helper scripts are under scripts/:

• scripts/pipeline/ - orchestrators and pipeline entry scripts
• scripts/build/linux/ - per-Python/per-arch Linux wheel builders
• scripts/verify/ - wheel and PyPI verification scripts
• scripts/helpers/ - utility scripts (version sync, helpers)
• scripts/legacy/ - deprecated scripts kept for reference

Example maintainer flow:

./building_wheels.sh
./publish_wheels.sh
./trigger_github_action.sh

Optional helper commands:

./scripts/verify/verify_wheels_docker.sh
./scripts/verify/verify_pypi_install.sh
./scripts/helpers/update_version.sh
./scripts/pipeline/build_all_wheels.sh

🔗 MareArts AI Package Family

MareArts Crystal is part of our comprehensive AI and utility package ecosystem:

Support

• Email: hello@marearts.com
• Website: marearts.com

License

MIT License