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.3.tar.gz (6.1 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.3-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cryzen-0.1.3.tar.gz
  • Upload date:
  • Size: 6.1 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.3.tar.gz
Algorithm Hash digest
SHA256 f433112151960d086550bb93666c299024de4c8eb3ef9d5c64480427c7de9ab3
MD5 18d82734038371e73dcd317ff45c9b35
BLAKE2b-256 2f24fa6f292c27c50341fc4daa88775372c6c9c5ae5b531fe7e07621145468a3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cryzen-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 7.8 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7b7b4c86ed457f6cf7c7652d4e438461d2d5a00f8f59fb4ec3993cfe8368abcd
MD5 8c82fd714f6be63fd9cfb00522e28dee
BLAKE2b-256 5414203c190a8d79ece49f110e8c709dd238adc22b6294afdfec2dd1e72713b8

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