Metadata-Version: 2.4
Name: crypt32
Version: 1.0.0
Summary: The official library for the 'crypt32' cipher
Author-email: Johnathan31 <ab1049669@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/johnathan31/crypt32
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<h1 align="center">crypt32</h1>

<p align="center">
  <strong>A lightweight, pattern-resistant substitution cipher for Python.</strong><br>
  Designed for experimentation, education, and creating unpredictable encrypted text.
</p>

<p align="center">
  <img src="https://img.shields.io/badge/python-3.9%2B-blue.svg" />
  <img src="https://img.shields.io/badge/status-active-success.svg" />
  <img src="https://img.shields.io/badge/license-MIT-green.svg" />
</p>

---

## 🔐 Overview

**crypt32** is a custom substitution-based cipher focused on producing highly unpredictable output.  
It is *not* designed to replace modern cryptography, but rather to serve as:

- A practical cryptography exercise  
- A lightweight cipher for creative or non-sensitive applications  
- A demonstration of unpredictable substitutions and salt-based variation  

The cipher includes built-in *salt generation* which increases the complexity and makes outputs harder to guess or pattern-match.

> ⚠️ **Security Warning**  
> This library is **not a modern secure cipher** and should **not** be used to protect confidential or critical data.

---

## ✨ Features

- 🔁 Encrypt & decrypt Latin text  
- 🧂 Built-in random salt generation  
- 🌀 Pattern-resistant output  
- 🧩 Simple and clean Python API  
- 🎯 Lightweight and dependency-free  
- 📂 Fully open source

---

## 🔢 Instructions
for instructions & examples, visit  the [instructions page](docs/instructions.md).
