pyrotcrypt 0.1.0__py3-none-any.whl

pyrotcrypt/__init__.py

@@ -0,0 +1,83 @@
+import argparse
+import sys
+from importlib.metadata import version
+from typing import Protocol, TextIO
+
+from pyrotcrypt.files import slurp, write_file
+from pyrotcrypt.rot import normalize_rotnum, rot, rotleft_equivalent
+
+__version__ = version("pyrotcrypt")
+
+
+class Reader(Protocol):
+    def readline(self) -> str: ...
+
+
+parser = argparse.ArgumentParser(
+    prog="pyrotcrypt",
+    description="Encrypt/Decrypt text by rotating the letters of the alphabet",
+)
+parser.add_argument(
+    "-n",
+    "--num",
+    type=int,
+    default=13,
+    dest="num",
+    help="the number of positions to rotate each letter",
+)
+parser.add_argument(
+    "-d",
+    "--decrypt",
+    default=False,
+    action="store_true",
+    dest="decrypt",
+    help="decrypt the ciphertext (instead of encrypting the plaintext)",
+)
+parser.add_argument(
+    "-w",
+    "--write",
+    default=False,
+    action="store_true",
+    dest="write_files",
+    help="write cyperthext to files (instead of stdout)",
+)
+parser.add_argument(
+    "-v", "--version", action="version", version=f"%(prog)s {__version__}"
+)
+parser.add_argument(
+    "in_files", nargs="*", help="paths to files to be encrypted/decrypted"
+)
+
+
+def run(argv: list[str], stdin: Reader, stdout: TextIO, stderr: TextIO) -> int:
+    args = parser.parse_args(argv)
+    num: int = normalize_rotnum(args.num)
+    in_files: list[str] = args.in_files
+    decrypt: bool = args.decrypt
+    write_files: bool = args.write_files
+
+    if decrypt:
+        num = rotleft_equivalent(num)
+
+    if len(in_files) > 0:
+        if write_files:
+            for file in in_files:
+                filename = f"{file.removesuffix('.txt')}.{'plain' if decrypt else 'cipher'}.rot{args.num}.txt"
+                content = rot(slurp(file), num)
+                write_file(filename, content)
+        else:
+            stdout.writelines(rot(slurp(file), num) for file in in_files)
+    else:
+        if write_files:
+            filename = f"{'plain' if decrypt else 'cipher'}.rot{args.num}.txt"
+            content = rot("".join(list(iter(stdin.readline, ""))), num)
+            write_file(filename, content)
+        else:
+            while line := stdin.readline():
+                stdout.write(rot(line, num))
+
+    return 0
+
+
+def main() -> None:
+    sys.exit(run(sys.argv[1:], sys.stdin, sys.stdout, sys.stderr))

pyrotcrypt/files.py

@@ -0,0 +1,8 @@
+def slurp(path: str) -> str:
+    with open(path, encoding="utf-8") as w:
+        return w.read()
+
+
+def write_file(path: str, content: str) -> None:
+    with open(path, "w", encoding="utf-8") as w:
+        w.write(content)

pyrotcrypt/rot.py

@@ -0,0 +1,28 @@
+_alpha_size = ord("z") - ord("a") + 1
+"""The number of characters in the english alphabet."""
+
+
+def normalize_rotnum(num: int) -> int:
+    """Rotating _alpha_size times is equivalent to not rotating at all.
+    This function ensures the rotation count stays in the [0, _alpha_size) interval.
+    """
+    return num % _alpha_size
+
+
+def rotleft_equivalent(num: int) -> int:
+    """If the text is going to be decrypted, this function calculates the number
+    of rotations equivalent to rotating num times to the left.
+    """
+    return _alpha_size - normalize_rotnum(num)
+
+
+def rot(text: str, n: int) -> str:
+    return "".join(rotate_char(c, n) for c in text)
+
+
+def rotate_char(c: str, n: int) -> str:
+    """Rotate a single character by n positions, preserving case."""
+    if c.isalpha():
+        base = ord("a") if c.islower() else ord("A")
+        return chr((ord(c) - base + n) % 26 + base)
+    return c

pyrotcrypt-0.1.0.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.3
+Name: pyrotcrypt
+Version: 0.1.0
+Summary: Encrypt and decrypt a text by rotating letters of the alphpabet.
+Author: angel
+Author-email: angel <gitsoor@proton.me>
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Pyrotcrypt
+
+A CLI to encrypt and decrypt text using [Caesar's cipher](https://en.wikipedia.org/wiki/Caesar_cipher).
+(Don't use it to encrypt secrets, only for fun!)
+
+# Usage
+
+Encrypt text from stdin, using the default 13 rotations:
+
+```bash
+$ pyrotcrypt < example.txt
+```
+
+Decrypt text from stdin using the `--decrypt` flag:
+
+```bash
+$ pyrotcrypt --decrypt < example.encrypted.txt
+```
+
+Encrypt and decrypt usign a different number of rotations:
+
+```bash
+$ pyrotcrypt --num 10 < example.txt
+$ pyrotcrypt --num 10 --decrypt < example.encrypted.txt
+```
+
+Encrypt files, writing the ciphertext to stdout:
+
+```bash
+$ pyrotcrypt example.txt another_example.txt
+```
+
+Encrypt files, writing the ciphertext to files:
+
+```bash
+$ pyrotcrypt --write example.txt another_example.txt
+```
+
+Writes the result of encrypting _example.txt_ to _example.cipher.rot13.txt_ and _another_example.txt_ to _another_example.cipher.rot13.txt_.
+
+Encrypt from stin to a file called _cipher.rot7.txt_:
+
+```bash
+$ pyrotcrypt --num 7 --write < example.txt
+```

pyrotcrypt-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+pyrotcrypt/__init__.py,sha256=cc62GOuhnjCBjNORUdWzn_Mseza7HqSsYXou9xgvM-s,2304
+pyrotcrypt/files.py,sha256=-C1AGrKsiaj_5UWJAebPCt-p-a1WwO_MWKTYAWCyGxc,222
+pyrotcrypt/rot.py,sha256=LsY09Sn6y6t2yBTFkNGZH_2hUHKAYLvjAnUSLH37XsI,909
+pyrotcrypt-0.1.0.dist-info/WHEEL,sha256=e4_1dyBeezi8ZjfxrZ3bnVOxFDa3ksqVqH0jTHkUZ3k,81
+pyrotcrypt-0.1.0.dist-info/entry_points.txt,sha256=DkE-og9XwVFLqNAXVWPsEPIi7xdIOL_QAZX-G3wjzGk,48
+pyrotcrypt-0.1.0.dist-info/METADATA,sha256=LEjXB_xrYfeazbeGhSbhWF3X4zoYWky71fbjVT7V7Ew,1275
+pyrotcrypt-0.1.0.dist-info/RECORD,,

pyrotcrypt-0.1.0.dist-info/WHEEL

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

pyrotcrypt-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pyrotcrypt = pyrotcrypt:main
+