simplecrypter 0.1.0__py3-none-any.whl

simplecrypter/__init__.py

@@ -0,0 +1,8 @@
+"""Small, password-based authenticated encryption for Python strings."""
+
+from .core import easy_decrypt, easy_encrypt
+
+ez_e = easy_encrypt
+ez_d = easy_decrypt
+
+__all__ = ["easy_encrypt", "easy_decrypt", "ez_e", "ez_d"]

simplecrypter/core.py

@@ -0,0 +1,52 @@
+"""Password-based authenticated encryption built on cryptography primitives."""
+
+import base64
+import binascii
+import os
+
+from cryptography.fernet import Fernet, InvalidToken
+from cryptography.hazmat.primitives.kdf.scrypt import Scrypt
+
+_PREFIX = "simplecrypter:v1:"
+_SALT_BYTES = 16
+
+
+def _require_text(value: str, name: str) -> None:
+    if not isinstance(value, str):
+        raise TypeError(f"{name} must be a string")
+    if not value:
+        raise ValueError(f"{name} must not be empty")
+
+
+def _key_from_password(password: str, salt: bytes) -> bytes:
+    _require_text(password, "password")
+    key = Scrypt(salt=salt, length=32, n=2**14, r=8, p=1).derive(password.encode("utf-8"))
+    return base64.urlsafe_b64encode(key)
+
+
+def easy_encrypt(phrase: str, password: str) -> str:
+    """Encrypt a text phrase with a password and return a self-contained string."""
+    _require_text(phrase, "phrase")
+    salt = os.urandom(_SALT_BYTES)
+    encrypted = Fernet(_key_from_password(password, salt)).encrypt(phrase.encode("utf-8"))
+    encoded_salt = base64.urlsafe_b64encode(salt).decode("ascii")
+    return f"{_PREFIX}{encoded_salt}:{encrypted.decode('ascii')}"
+
+
+def easy_decrypt(ciphertext: str, password: str) -> str:
+    """Decrypt text returned by :func:`easy_encrypt` using its original password."""
+    _require_text(ciphertext, "ciphertext")
+    _require_text(password, "password")
+
+    try:
+        if not ciphertext.startswith(_PREFIX):
+            raise ValueError
+        encoded_salt, encrypted = ciphertext.removeprefix(_PREFIX).split(":", 1)
+        if not encrypted:
+            raise ValueError
+        salt = base64.urlsafe_b64decode(encoded_salt.encode("ascii"))
+        if len(salt) != _SALT_BYTES:
+            raise ValueError
+        return Fernet(_key_from_password(password, salt)).decrypt(encrypted.encode("ascii")).decode("utf-8")
+    except (ValueError, UnicodeError, binascii.Error, InvalidToken) as error:
+        raise ValueError("ciphertext is invalid or the password is incorrect") from error

simplecrypter-0.1.0.dist-info/METADATA

@@ -0,0 +1,48 @@
+Metadata-Version: 2.5
+Name: simplecrypter
+Version: 0.1.0
+Summary: Small, password-based authenticated encryption for Python strings.
+Author: Muck
+License: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.9
+Requires-Dist: cryptography>=42
+Description-Content-Type: text/markdown
+
+# simplecrypter
+
+Password-based authenticated encryption for short text values.
+
+## Install
+
+```bash
+pip install simplecrypter
+```
+
+## Use
+
+```python
+import simplecrypter
+
+encrypted = simplecrypter.easy_encrypt("phrase", "password")
+original = simplecrypter.easy_decrypt(encrypted, "password")
+```
+
+Short aliases are available:
+
+```python
+encrypted = simplecrypter.ez_e("phrase", "password")
+original = simplecrypter.ez_d(encrypted, "password")
+```
+
+Each encryption uses a new random salt. The encrypted text includes that salt, so only the encrypted value and the password are needed to decrypt it. A wrong password or altered encrypted text raises `ValueError`.
+
+## Notes
+
+- Use a long, unique password and store it in a password manager or secret manager.
+- This package encrypts text, not files or database records.
+- Losing the password means the data cannot be recovered.

simplecrypter-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+simplecrypter/__init__.py,sha256=1N8XoWQuzGNSerAAGw9Fr9LbNwpU9xiEy9to-QsJXvE,220
+simplecrypter/core.py,sha256=XMPXNi2tVReCgSKMt31HBK4FDsAVANxo20YSYMnRYV8,2026
+simplecrypter-0.1.0.dist-info/METADATA,sha256=Y3zWHceDhcVBvHkFJVRo4cwQyp9hazETRvF0Na7tfUc,1356
+simplecrypter-0.1.0.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
+simplecrypter-0.1.0.dist-info/licenses/LICENSE,sha256=F_4KeGprt40t5Of62-s2dKrsWvMlLvg-aupLPfFqrtA,1061
+simplecrypter-0.1.0.dist-info/RECORD,,

simplecrypter-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.3
+Root-Is-Purelib: true
+Tag: py3-none-any

simplecrypter-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muck
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.