host secure, password-protected static sites
Project description
StatiCrypt
StatiCrypt is a Python-based tool designed to help users host secure, password-protected static sites including markdown content. It provides the following functionality:
- Markdown to HTML Conversion: Converts Markdown files into HTML using the
md2html.pyscript. - HTML Encryption: Encrypts HTML files with a password using the
encrypt.pyscript, ensuring secure storage and transmission. - Decryption via Static HTML: Generates a static HTML file with embedded encrypted content that can be decrypted in the browser using JavaScript.
Features
- Secure Static Hosting: Host password-protected static sites without requiring server-side processing.
- Markdown Conversion: Easily convert Markdown files to HTML.
- Secure Encryption: Protect your HTML content with AES encryption.
- Browser-Based Decryption: Decrypt and render encrypted content directly in the browser.
Usage
Protect Command
Use the protect command to convert, encrypt, and embed Markdown or HTML content into a password-protected static site:
python -m staticrypt protect \
-i <path-to-input> \
--password <encryption-password> \
[--style <path-to-css>] \
[--allow-unsafe-password]
<path-to-input>: Path to the input file. Can be a Markdown (.md) or HTML (.html) file.--style: Optional. Path to a CSS file to style the generated HTML. For Markdown files, the CSS is applied during the conversion to HTML. For HTML files, the CSS is directly injected into the<head>section.--allow-unsafe-password: Optional. Skip strength validation on the supplied password. Use with caution; weak passwords are insecure.
Convert Command
Use the convert command to convert a Markdown file to HTML:
python -m staticrypt convert -i <path-to-markdown> [-o <path-to-html>] [--style <path-to-css>]
--style: Optional. Path to a CSS file to style the generated HTML.
Encrypt Command
Use the encrypt command to encrypt an HTML file:
python -m staticrypt encrypt \
-i <path-to-html> \
--password <encryption-password> \
[--allow-unsafe-password]
--allow-unsafe-password: Optional. Skip strength validation on the supplied password. Use with caution.
Decrypt Command
Use the decrypt command to decrypt an encrypted HTML file:
python -m staticrypt decrypt -i <path-to-encrypted-html> --password <encryption-password>
Example
python -m staticrypt protect -i ./resources/sample.md --password "YourPassword123" --style ./resources/style.css
This will:
- Convert
sample.mdto HTML. - Encrypt the HTML with the provided password.
- Generate a static HTML file (e.g.,
sample.protected.html) that can decrypt and display the content in the browser.
Requirements
- UV
- Python 3.8+
cryptographylibrarymarkdownlibrary
uv sync
Contributing
Contributions are welcome! If you encounter issues or have suggestions for improvement, please open an issue or submit a pull request.
# Clone the repository
git clone https://github.com/Au2mater/StatiCrypt.git
# installing StatiCrypt locally for development:
uv sync --dev
uv pip install -e .
# run StatiCrypt with the example file:
staticrypt --help
staticrypt protect -i ./resources/sample.md --password "YourPassword123!" --style ./resources/style.css
# run tests:
pytest
# uninstall StatiCrypt after development:
uv pip uninstall staticrypt
License
This repository is licensed under the MIT License. See the LICENSE file for more details.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file staticrypt-0.1.1.tar.gz.
File metadata
- Download URL: staticrypt-0.1.1.tar.gz
- Upload date:
- Size: 10.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fead99ba7ed415cdb8bfd4bbe1f1ac91d94e3b194d193776c5440f20809f5a7b
|
|
| MD5 |
8580680c47c0f67177a2fd4a0b0e06d8
|
|
| BLAKE2b-256 |
a3681dff1feb641002ad1231568efe2e3bd80d0d5448bad24ad6633207abbbe2
|
File details
Details for the file staticrypt-0.1.1-py3-none-any.whl.
File metadata
- Download URL: staticrypt-0.1.1-py3-none-any.whl
- Upload date:
- Size: 10.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0ef41455b5045d21a83aa690128a95cf3c290a6e48b8370a7e07dfebde8d8ae2
|
|
| MD5 |
0a45460bc380df4a23bc4da1cbde7c95
|
|
| BLAKE2b-256 |
1aede1c7a8c55e2841310ad72cb82290bc7509ad731c5abcb17c871cd0a07914
|
