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.2.tar.gz (6.4 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.2-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cryzen-0.1.2.tar.gz
  • Upload date:
  • Size: 6.4 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.2.tar.gz
Algorithm Hash digest
SHA256 e22a5d4b0e294970918c6aded7a3567431c46c03db755f60cb4508932d2cfcb2
MD5 3c0ec0de90264b823794cba4b3cad937
BLAKE2b-256 bc7f5a6001a0de2ba617539f416698dec513d757c664427ae4673df5298ad4db

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cryzen-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 8.2 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 34a447d3349d0528e113a79c9151d88f6395db555d0fea702626345116e46d84
MD5 95f10ceebdbea460e98758f028bd5530
BLAKE2b-256 ad8d27085b558611acf731bdc5610c1fd6b3aff772556b17d9b2c7e2433b66da

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