Skip to main content

A powerful & modular toolkit for modern cryptography and hashing.

Project description

cryzen

cryzen is a small, focused Python library providing 3 reversible ciphers and 3 irreversible hashing schemes, designed to be simple to use and suitable for many common tasks.

Important: This library intentionally exposes friendly, unique function names (FluxCipher, ZenCode, AstraCrypt, NovaHash, TerraHash, OmegaHash). Internally standard primitives are used (AES, BLAKE2, SHA256, PBKDF2).

Features

  • FluxCipher (flux_encrypt / flux_decrypt) — XOR-based reversible cipher (fast, NOT recommended for strong secrets)
  • ZenCode (zen_encode / zen_decode) — URL-safe compact base64 wrapper for tokens
  • AstraCrypt (astra_encrypt / astra_decrypt) — AES-256-CBC reversible encryption (requires pycryptodome)
  • NovaHash (nova_hash) — fast irreversible BLAKE2b-based hash
  • TerraHash (terra_hash) — SHA-256 irreversible hash
  • OmegaHash (omega_hash) — PBKDF2-HMAC-SHA512 (salted) irreversible hash for passwords

Installation (development)

# For AES support install pycryptodome
pip install pycryptodome

# then install locally for testing
pip install -e .

Quick usage

from cryzen import flux_encrypt, flux_decrypt, zen_encode, zen_decode
from cryzen import astra_encrypt, astra_decrypt
from cryzen import nova_hash, terra_hash, omega_hash

# flux
ct = flux_encrypt("hello world", key="s3cr3t")
print(flux_decrypt(ct, key="s3cr3t"))

# zencode
t = zen_encode("keep this")
print(zen_decode(t))

# astra (AES) - requires pycryptodome
token = astra_encrypt("sensitive", "my_secret_key")
print(astra_decrypt(token, "my_secret_key"))

# hashes
print(nova_hash("value"))
print(terra_hash("value", salt="optional"))
print(omega_hash("password"))  # returns salt$derived_hex

API & help()

Each function includes a docstring. Use Python's built-in help() or dir():

import cryzen
help(cryzen.flux_encrypt)
dir(cryzen)

Security notes

  • flux_encrypt is not cryptographically secure — use only for obfuscation or non-critical tasks.
  • astra_encrypt is secure when secret_key is strong and kept private. Use pycryptodome for AES implementation.
  • Use omega_hash for password storage (store full token).
  • Never hardcode secrets in distributed code.

License

MIT. See LICENSE file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cryzen-0.1.1.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cryzen-0.1.1-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

Details for the file cryzen-0.1.1.tar.gz.

File metadata

  • Download URL: cryzen-0.1.1.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for cryzen-0.1.1.tar.gz
Algorithm Hash digest
SHA256 f1a37c70e6edcbe99808b79379acf93cc4d3c8a33abc8c7fbd6b0d8195e832d9
MD5 49aca73bbd954135129c08413750f7c8
BLAKE2b-256 b1cae51d3c5caabad147560beb0e93633bf7837df899ab62d38e2321d383cd9a

See more details on using hashes here.

File details

Details for the file cryzen-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: cryzen-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for cryzen-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9b2eeb52a020714a557f83eb3edcac53a62137545755df24fc04b1d58c2cc2d0
MD5 02de4edba7934b2185f7476bd9010ca5
BLAKE2b-256 4d8215bd3583c32e3a12fc3e2412b9f3eb4dca0fe0de940dce1d07b4530860e3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page