ciph 0.0.0__py3-none-any.whl → 0.1.0__py3-none-any.whl

ciph/__init__.py

@@ -1 +1 @@
-# welcome to ciph
+__version__ = "0.1.0"

ciph/cli.py

@@ -0,0 +1,118 @@
+#!/usr/bin/env python3
+import sys, os, getpass, ctypes
+from tqdm import tqdm
+
+HERE = os.path.dirname(__file__)
+LIB = ctypes.CDLL(os.path.join(HERE, "_native", "libciph.so"))
+
+LIB.ciph_encrypt_stream.argtypes = [
+    ctypes.c_void_p, ctypes.c_void_p,
+    ctypes.c_char_p, ctypes.c_int,
+    ctypes.c_char_p
+]
+
+LIB.ciph_decrypt_stream.argtypes = [
+    ctypes.c_void_p, ctypes.c_void_p,
+    ctypes.c_char_p,
+    ctypes.c_char_p, ctypes.c_size_t
+]
+
+libc = ctypes.CDLL(None)
+fdopen = libc.fdopen
+fdopen.argtypes = [ctypes.c_int, ctypes.c_char_p]
+fdopen.restype = ctypes.c_void_p
+
+
+def detect_cipher():
+    try:
+        with open("/proc/cpuinfo") as f:
+            if "aes" in f.read().lower():
+                return 1
+    except Exception:
+        pass
+    return 2
+
+
+def get_password():
+    pwd = os.getenv("CIPH_PASSWORD")
+    if not pwd:
+        pwd = getpass.getpass("Password: ")
+    return pwd.encode()
+
+
+def c_file(py_file, mode):
+    fd = os.dup(py_file.fileno())   # 🔑 duplicate FD
+    return fdopen(fd, mode)
+
+
+def main():
+    if len(sys.argv) < 3:
+        print("usage: ciph encrypt|decrypt <file>")
+        sys.exit(1)
+
+    cmd, src = sys.argv[1], sys.argv[2]
+    password = get_password()
+    total_size = os.path.getsize(src)
+
+    fin_py = open(src, "rb")
+    fin = c_file(fin_py, b"rb")
+
+    name_buf = ctypes.create_string_buffer(256)
+
+    with tqdm(
+        total=total_size,
+        unit="B",
+        unit_scale=True,
+        desc=cmd.capitalize()
+    ) as bar:
+
+        if cmd == "encrypt":
+            out_name = src + ".ciph"
+            fout_py = open(out_name, "wb")
+            fout = c_file(fout_py, b"wb")
+
+            LIB.ciph_encrypt_stream(
+                fin,
+                fout,
+                password,
+                detect_cipher(),
+                os.path.basename(src).encode()
+            )
+
+            bar.update(total_size)
+
+        elif cmd == "decrypt":
+            tmp_name = ".__tmp__"
+            fout_py = open(tmp_name, "wb")
+            fout = c_file(fout_py, b"wb")
+
+            res = LIB.ciph_decrypt_stream(
+                fin,
+                fout,
+                password,
+                name_buf,
+                ctypes.sizeof(name_buf)
+            )
+
+            fout_py.close()
+
+            if res != 0:
+                os.remove(tmp_name)
+                print("ciph: wrong password or corrupted file", file=sys.stderr)
+                sys.exit(1)
+
+            out_name = name_buf.value.decode() or "output.dec"
+            os.rename(tmp_name, out_name)
+
+            bar.update(total_size)
+
+        else:
+            print("usage: ciph encrypt|decrypt <file>")
+            sys.exit(1)
+
+    fin_py.close()
+    print(f"[+] Output → {out_name}")
+
+
+if __name__ == "__main__":
+    main()

ciph-0.1.0.dist-info/METADATA

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: ciph
+Version: 0.1.0
+Summary: Fast, streaming file encryption for large media files and cloud uploads
+Author-email: Ankit Chaubey <m.ankitchaubey@gmail.com>
+License: Apache License 2.0
+Project-URL: Homepage, https://github.com/ankit-chaubey/ciph
+Project-URL: Source, https://github.com/ankit-chaubey/ciph
+Project-URL: Issues, https://github.com/ankit-chaubey/ciph/issues
+Keywords: encryption,cryptography,security,aes,chacha20,argon2,streaming,files,privacy
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: System :: Archiving :: Backup
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Unix
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tqdm>=4.60.0
+Dynamic: license-file
+Dynamic: requires-python
+
+# ciph
+
+**ciph** is a fast, streaming file‑encryption tool built for **large media files** and **cloud uploads**. It uses modern, industry‑standard cryptography and is designed to safely encrypt files **larger than your system RAM**.
+
+> Encrypt locally. Upload anywhere. Decrypt only when you trust the environment.
+
+---
+
+## ❓ Why ciph?
+
+Most encryption tools load the entire file into memory before encrypting it. **ciph streams data in fixed-size chunks**, which means you can encrypt a **50 GB 4K video on a machine with only 2 GB of RAM**—smoothly and safely.
+
+## ✨ Features
+
+* 🔐 **Strong encryption** — AES‑256‑GCM or ChaCha20‑Poly1305
+* 🔑 **Password protection** — Argon2id (memory‑hard key derivation)
+* 🚀 **High performance** — streaming C core (1 MB chunks)
+* 🧠 **Constant memory usage** — works with 10 GB+ files
+* ⚙️ **Hardware‑aware** — AES‑NI when available, ChaCha fallback
+* 🧪 **Integrity protected** — AEAD authentication on every chunk
+* ☁️ **Cloud / Telegram safe** — encrypt before upload
+* 🏷️ **Filename preserved** — original filename & extension are stored and restored on decryption
+
+---
+
+## 🔐 Cryptographic Design
+
+`ciph` uses a **hybrid (envelope) encryption model**, similar to what is used in modern secure storage systems:
+
+1. A random **data key** encrypts the file in streaming mode.
+2. Your password is hardened using **Argon2id**.
+3. The data key is encrypted using the derived password key.
+4. Every chunk is authenticated to detect tampering.
+
+No custom crypto. No weak primitives.
+
+5. The **original filename (without path)** is stored as encrypted metadata and automatically restored on decryption.
+
+---
+
+## 🔒 Security Strength
+
+| Component                  | Algorithm                                | Strength     |
+| -------------------------- | ---------------------------------------- | ------------ |
+| File encryption            | AES‑256‑GCM                              | 256‑bit      |
+| File encryption (fallback) | ChaCha20‑Poly1305                        | 256‑bit      |
+| Password KDF               | Argon2id                                 | Memory‑hard  |
+| Integrity                  | AEAD                                     | Tamper‑proof |
+| Nonces                     | Key-derived per chunk (unique, no reuse) | No reuse     |
+
+### What this means
+
+* Brute‑force attacks are **computationally infeasible**
+* File corruption or tampering is **always detected**
+* Encrypted files are safe on **any cloud platform**
+* Losing the password means **data is unrecoverable**
+
+---
+
+## 🚀 Quick Start (Build from Source)
+
+```bash
+git clone https://github.com/ankit-chaubey/ciph
+cd ciph
+make
+pip install .
+```
+
+## 📦 Installation
+
+### Requirements
+
+* Linux / Termux
+* Python ≥ 3.8
+* libsodium
+
+### Install from PyPI
+
+```bash
+pip install ciph
+```
+
+---
+
+## 🚀 Usage
+
+### Encrypt a file
+
+```bash
+ciph encrypt video.mp4
+```
+
+Output:
+
+```
+video.mp4.ciph
+```
+
+### Decrypt a file
+
+```bash
+ciph decrypt video.mp4.ciph
+```
+
+Output:
+
+```
+video.mp4
+```
+
+> The original filename and extension are automatically restored, even if the encrypted file was renamed.`
+
+### Example workflow (Cloud / Telegram)
+
+```bash
+ciph encrypt movie.mkv
+# upload movie.mkv.ciph anywhere
+# share the password securely
+
+ciph decrypt movie.mkv.ciph
+```
+
+---
+
+## 📝 File Format (V2)
+
+| Offset | Size | Description                            |
+| ------ | ---- | -------------------------------------- |
+| 0      | 4    | Magic bytes (`CIPH`)                   |
+| 4      | 1    | Format version                         |
+| 5      | 1    | Cipher mode (1 = AES, 2 = ChaCha)      |
+| 6      | 16   | Argon2 salt                            |
+| 22     | 12   | Key nonce                              |
+| 34     | 1    | Filename length (N)                    |
+| 35     | N    | Original filename (UTF‑8)              |
+| 35+N   | 2    | Encrypted data‑key length              |
+| …      | …    | Encrypted data key + encrypted payload |
+
+## 📊 Performance
+
+* Processes data in **1 MB chunks**
+* Cryptography handled in **C (libsodium)**
+* Python used only for CLI orchestration
+* Typical throughput: **hundreds of MB/s** (CPU‑bound)
+
+Encryption is usually faster than your internet upload speed.
+
+---
+
+## ⚠️ Limitations (v0.1.0)
+
+* Linux / Termux only
+* No resume support yet
+* Progress bar shows start → finish (stream handled in C)
+* Password‑based encryption only (public‑key mode planned)
+* Filename metadata is visible (content remains fully encrypted)
+
+---
+
+## 🧑‍💻 Author & Project
+
+**ciph** is **designed, developed, and maintained** by
+
+[**Ankit Chaubey (@ankit‑chaubey)**](https://github.com/ankit-chaubey)
+
+GitHub Repository:
+👉 **[https://github.com/ankit-chaubey/ciph](https://github.com/ankit-chaubey/ciph)**
+
+The project focuses on building **secure, efficient, and practical cryptographic tools** for real‑world usage, especially for media files and cloud storage.
+
+---
+
+## 📜 License
+
+Apache License 2.0
+
+Copyright © 2026 Ankit Chaubey
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+You may obtain a copy of the License at:
+
+[https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License.
+
+---
+
+## 🔮 Roadmap
+
+Planned future improvements:
+
+* Parallel chunk encryption
+* Resume / partial decryption
+* Public‑key encryption mode
+* Real‑time progress callbacks
+* Prebuilt wheels (manylinux)
+
+---
+
+## ⚠️ Disclaimer
+
+This tool uses strong cryptography.
+
+If you forget your password, **your data cannot be recovered**.
+
+Use responsibly.

ciph-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+ciph/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+ciph/cli.py,sha256=xqYDleXrvH7Ofu4L4K5GkUsP5fnKPYXWjJavk7Szbco,2748
+ciph-0.1.0.dist-info/licenses/LICENSE,sha256=wIAeYhitIddhNGFIO7yoUMtu5FuHLn734sVnGI33J14,628
+ciph-0.1.0.dist-info/METADATA,sha256=OheBb-1mXpfPr20MA-gfKU8MWP6e6FdlQV2KDUBPUx8,7153
+ciph-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ciph-0.1.0.dist-info/entry_points.txt,sha256=0OC_DA7tkD2MSCIrXMOZ-wm6G_zKozrI54w2ATEb0W8,39
+ciph-0.1.0.dist-info/top_level.txt,sha256=_VGthmGuuNhqV4Y8z_PpGm8U9wxfKq78RQMo4IpnMh0,5
+ciph-0.1.0.dist-info/RECORD,,

ciph-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ciph = ciph.cli:main

ciph-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Ankit Chaubey
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

ciph-0.0.0.dist-info/METADATA

@@ -1,15 +0,0 @@
-Metadata-Version: 2.4
-Name: ciph
-Version: 0.0.0
-Summary: Placeholder package reserved for future development.
-Author-email: Ankit Chaubey <m.ankitchaubey@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/ankit-chaubey/ciph
-Project-URL: Source, https://github.com/ankit-chaubey/ciph
-Project-URL: Issues, https://github.com/ankit-chaubey/ciph/issues
-Keywords: encryption,security,crypto
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown

ciph-0.0.0.dist-info/RECORD

@@ -1,5 +0,0 @@
-ciph/__init__.py,sha256=_bSj0I8bgLEogZTOPu1HcSf9iqm-WqZXV7FUQe7HC94,18
-ciph-0.0.0.dist-info/METADATA,sha256=Qf7itUdPYMReH0jH5nQdxCuBrHeYAzxbmc7PJQ-cKzI,610
-ciph-0.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ciph-0.0.0.dist-info/top_level.txt,sha256=_VGthmGuuNhqV4Y8z_PpGm8U9wxfKq78RQMo4IpnMh0,5
-ciph-0.0.0.dist-info/RECORD,,