{"id":28670837,"url":"https://github.com/arpit-omprakash/cryptex-tools","last_synced_at":"2025-06-13T18:11:05.298Z","repository":{"id":157669058,"uuid":"301317313","full_name":"arpit-omprakash/cryptex-tools","owner":"arpit-omprakash","description":"An educational cryptography toolkit written in Python, designed for learners and hobbyists. It demonstrates classical ciphers, basic cryptanalysis tools, and allows users to experiment with encryption and decryption via a simple command-line interface (CLI).","archived":false,"fork":false,"pushed_at":"2025-06-09T07:26:21.000Z","size":45,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-09T08:30:11.596Z","etag":null,"topics":["cipher-algorithms","cryptography","encryption-decryption","python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/cryptex-tools/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arpit-omprakash.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-10-05T06:48:17.000Z","updated_at":"2025-06-09T07:27:26.000Z","dependencies_parsed_at":"2025-06-09T08:42:02.898Z","dependency_job_id":null,"html_url":"https://github.com/arpit-omprakash/cryptex-tools","commit_stats":null,"previous_names":["arpit-omprakash/cryptex-tools"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/arpit-omprakash/cryptex-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpit-omprakash%2Fcryptex-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpit-omprakash%2Fcryptex-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpit-omprakash%2Fcryptex-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpit-omprakash%2Fcryptex-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arpit-omprakash","download_url":"https://codeload.github.com/arpit-omprakash/cryptex-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpit-omprakash%2Fcryptex-tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259695305,"owners_count":22897514,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cipher-algorithms","cryptography","encryption-decryption","python"],"created_at":"2025-06-13T18:11:02.512Z","updated_at":"2025-06-13T18:11:05.279Z","avatar_url":"https://github.com/arpit-omprakash.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔐 Cryptex Tools\n\n**cryptex_tools** is an educational cryptography toolkit written in Python, designed for learners and hobbyists. It demonstrates classical ciphers, basic cryptanalysis tools, and allows users to experiment with encryption and decryption via a simple command-line interface (CLI).\n\n---\n\n## 📦 Features\n\n- Classical Ciphers:\n  - Caesar, Vigenère, Atbash, Affine, Pigpen, ROT13, Keyboard Shift, Playfair, Rail Fence\n- Cryptanalysis Tools:\n  - Frequency analysis\n  - Vigenère cipher cracking (with auto alignment and dictionary support)\n  - Caesar cipher cracking (brute force)\n- File-based encryption/decryption support\n- Modular, extensible architecture with clean CLI powered by `click`\n\n---\n\n|||\n|-|-|\n|Author   | Arpit Omprakash             |\n|License  | MIT License                 |\n|Homepage | https://github.com/arpit-omprakash/cryptex-tools |\n\n---\n\n## 📁 Project Structure\n\ncryptex-tools/  \n├── src/cryptex_tools/  \n│ ├── ciphers/ # Individual cipher modules  \n│ ├── cli/ # CLI entry point and command setup  \n│ ├── cryptanalysis/ # Cryptanalysis tools and helpers  \n│ ├── utils/ # Utility functions like cipher loader  \n├── tests/ # Unit tests for ciphers and CLI  \n├── README.md  \n└── requirements.txt  \n\n---\n\n## Supported Ciphers\n\n`cryptex_tools` currently supports the following ciphers (see `src/cryptex_tools/ciphers`):\n\n1. **Caesar Cipher** – Shifts each letter by a fixed number of positions.\n2. **ROT13 Cipher** – Caesar cipher with a fixed shift of 13.\n3. **Affine Cipher** – Encrypts using the formula `(a*x + b) mod 26`.\n4. **Atbash Cipher** – Substitutes each letter with its reverse in the alphabet.\n5. **Keyboard Shift Cipher** – Shifts letters according to their position in QWERTY keyboard rows.\n6. **Pigpen Cipher (Unicode)** – Substitutes each letter with a Unicode Pigpen symbol.\n7. **Playfair Cipher** – Digraph substitution cipher using a 5x5 matrix based on a keyword.\n8. **Rail Fence Cipher** – Transposition cipher writing text in a zigzag pattern.\n9. **Vigenère Cipher** – Uses a keyword to shift letters; the keyword repeats to match text length.\n\n---\n\n\n## 🚀 Getting Started\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/arpit-omprakash/cryptex-tools.git\ncd cryptex-tools\n```\n\n### 2. Set up virtual environment and install\n\n```bash\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\npip install -r requirements.txt\n\n# Install the package\npip install -e .\n```\n\n### 3. Run the CLI\n\n```bash\n# Help for the program\npython -m cryptex_tools --help\n\n# Help for a specific submenu\npython -m cryptex_tools encrypt --help \n```\n\n---\n\n## 🛠 Usage Examples \n\n### Encrypt using Caesar Cipher\n\n```bash\n$ python -m cryptex_tools encrypt \"caesar cipher\" --text \"HELLO\" --key 3\n\n# Output\n$ KHOOR\n```\n\n### Decrypt using Vigenere Cipher\n\n```bash\n$ python -m cryptex_tools decrypt \"vigenere cipher\" --text \"RIJVS\" --key \"KEY\"\n\n# Output\n$ HELLO\n```\n\n### Crack Vigenere Cipher using Dictionary\n\n```bash\n$ python -m cryptex_tools analyze crack-vigenere --text \"LLKJMLSQGJWTYI\"\n\n# Output\n$ [+] Guessed key: SECRET\n$ [+] Decrypted text:\n$ THISISAMESSAGE\n```\n\n## ✅ Running Tests\n\nTo run all tests:\n\n```bash\ntests\\run_tests.bat # Windows\n\n# or manually\npython -m unittest discover -s tests\n```\n\n## ✨ Contributing\n\nPull Requests, Feedback, and Suggestions are Welcome!\n\n## 📜 License\n\n```\nMIT License\n\nCopyright (c) 2025 Arpit Omprakash\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpit-omprakash%2Fcryptex-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farpit-omprakash%2Fcryptex-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpit-omprakash%2Fcryptex-tools/lists"}