Metadata-Version: 2.1
Name: securipy
Version: 3.0.3
Summary: Encrypter and Decrypter of all types of human-readable file formats and much more Using Python
Home-page: https://pypi.org/project/SecuriPy
Author: Anupam Kanoongo
Author-email: programmer.tiak@gmail.com
License: MIT
Project-URL: Our Website, https://anupam1707.github.io/
Project-URL: Our YT Handle, https://youtube.com/@developer.anupam
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

[![PyPi](https://img.shields.io/pypi/v/SecuriPy)](https://pypi.org/project/SecuriPy/)
# SecuriPy

SecuriPy is a Python library that provides a set of functions for encrypting and decrypting human-readable file formats into undefined non-readable files. It offers a simple yet powerful way to protect sensitive information from unauthorized access.

## Installation

To use SecuriPy, you will need Python 3.x installed on your system. You can install SecuriPy using pip, the Python package installer, by executing the following command:

```shell
pip install SecuriPy
```

## Usage

Import the classes you need:

```python
from SecuriPy import Text, Image, File, DNA
```

### Text — Password-based obfuscation

> **Note:** The `Text` class uses a simple additive cipher. It provides obfuscation only and is **not cryptographically secure**. For strong encryption use `File` or `Image`.

```python
from SecuriPy import Text

encrypted = Text.encrypt("Hello World", password="mypassword")
original  = Text.decrypt(encrypted, password="mypassword")
print(original)  # Hello World
```

### Image — Fernet (AES-128) image encryption

```python
from SecuriPy import Image

Image.Key()                                # generates key.txt
Image.Encrypt("key.txt", "photo.png")     # encrypts photo.png in-place
Image.Decrypt("key.txt", "photo.png")     # decrypts back to original

# Encrypt / decrypt everything in the current directory
Image.EncryptAll("key.txt")
Image.DecryptAll("key.txt")
```

### File — Fernet (AES-128) file encryption

```python
from SecuriPy import File

File.Key()                                 # generates key.txt
File.Encrypt("key.txt", "document.pdf")   # encrypts in-place
File.Decrypt("key.txt", "document.pdf")   # decrypts back to original

# Encrypt / decrypt everything in the current directory
File.EncryptAll("key.txt")
File.DecryptAll("key.txt")
```

### DNA — DNA base-sequence encoding

Encodes text as a sequence of DNA bases (A, T, C, G). This is an encoding scheme, not a cryptographic cipher.

```python
from SecuriPy import DNA

encoded  = DNA.encrypt("Hello")   # e.g. 'TACGTATGTA...'
original = DNA.decrypt(encoded)   # 'Hello'
```

## Security Considerations

- Use a strong and unique key for each encryption operation to enhance security.
- Always store your `key.txt` securely — losing it means losing access to your encrypted data.
- `Image` and `File` classes use **Fernet symmetric encryption** (AES-128-CBC + HMAC-SHA256).
- The `Text` class is a **lightweight obfuscation** cipher only.

## Contributing

Contributions to SecuriPy are welcome! If you find any issues or have suggestions for improvement, please create a GitHub issue or submit a pull request.

## License

SecuriPy is released under the [MIT License](https://opensource.org/licenses/MIT). See the [LICENSE](https://github.com/Anupam1707/SecuriPy/blob/main/LICENSE) file for more details.

## Contact

If you have any questions, suggestions, or feedback, you can reach out to the project maintainers at [programmer.tiak@gmail.com](mailto:programmer.tiak@gmail.com).

Happy encrypting with SecuriPy!

