fix: make pip install cryptex-cli work out of the box + harden CLI (v1.2.0)

The published package crashed on startup for any user without the native
`zbar` system library, because `pyzbar` was imported at module load time.
Effectively every clean `pip install` on macOS/Linux was unusable. This
release fixes that and tightens the CLI.

Fixed
- Replace `pyzbar` (needs a system `zbar` library that pip cannot install)
  with `zxing-cpp`, which ships self-contained binary wheels. A clean
  `pip install cryptex-cli` now runs with no extra system setup. QR-image and
  TOTP-from-image decoding behave exactly as before.

Changed (BREAKING)
- Saving to a file now uses an explicit `-o/--output FILE` option instead of a
  bare positional argument. Previously any stray word (e.g. `cryptex generate`)
  was silently written to a file of that name. Use `cryptex -o secrets.txt`.

Removed
- Drop end-of-life Python 3.8 and 3.9. Supported runtimes are now 3.10–3.13.

Other
- Add a terminal demo (assets/demo.gif) to the README.
- Bump version to 1.2.0.

Author: TarekCheikh

README.md

@@ -6,13 +6,17 @@
 
 [![PyPI version](https://img.shields.io/pypi/v/cryptex-cli.svg)](https://pypi.org/project/cryptex-cli/)
 [![Downloads](https://static.pepy.tech/badge/cryptex-cli)](https://pepy.tech/project/cryptex-cli)
-[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
+[![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Security](https://img.shields.io/badge/security-cryptographically%20secure-green.svg)](https://docs.python.org/3/library/secrets.html)
 [![CLI Framework](https://img.shields.io/badge/CLI-Click-brightgreen.svg)](https://click.palletsprojects.com/)
 
 A **production-ready CLI tool** for generating cryptographically secure passwords with enterprise integrations, compliance templates, and advanced customization options.
 
+<p align="center">
+  <img src="assets/demo.gif" alt="Cryptex demo" width="100%">
+</p>
+
 ## Key Features
 
 ### Core Security
@@ -494,13 +498,13 @@ cryptex -l 12 --save-keychain --keychain-service "test" --keychain-account "test
 ## Dependencies
 
 ### Required
-- Python 3.8+
+- Python 3.10+
 - click 8.0+ (CLI framework)
 - qrcode 7.0+ (QR code generation)
 - boto3 1.26+ (AWS integration)
 - hvac 1.0+ (Vault integration)
 - keyring 24.0+ (OS keychain)
-- pyzbar 0.1.9+ (QR code image decoding)
+- zxing-cpp 2.0+ (QR code image decoding — self-contained, no system libs)
 - Pillow 9.0+ (Image processing)
 
 ### Optional System Tools

assets/demo.gif

@@ -3,7 +3,7 @@
 A production-ready CLI tool for generating secure passwords with advanced features.
 """
 
-__version__ = "1.1.0"
+__version__ = "1.2.0"
 __author__ = "Tarek CHEIKH"
 __email__ = "tarek@tocconsulting.fr"
 __description__ = "Enhanced random password generator with advanced security features"

cryptex/__init__.py

@@ -229,12 +229,14 @@
     help='Vault URL',
     show_default=True
 )
-@click.argument(
-    'output_file',
+@click.option(
+    '-o', '--output', 'output_file',
     type=click.Path(),
-    required=False
+    default=None,
+    help='Save generated password(s)/TOTP details to a file '
+         'instead of printing to the terminal.'
 )
-@click.version_option(version='1.1.0', prog_name='cryptex')
+@click.version_option(version='1.2.0', prog_name='cryptex')
 def main(
     length: int,
     count: int,

cryptex/cli.py

@@ -17,8 +17,8 @@
 
 import click
 import qrcode
+import zxingcpp
 from PIL import Image
-from pyzbar.pyzbar import decode as pyzbar_decode
 
 
 class Colors:
@@ -149,9 +149,9 @@ def decode_qr_image(image_path: str) -> Optional[str]:
     """Decode a QR code image and return its text content."""
     try:
         image = Image.open(image_path)
-        decoded_objects = pyzbar_decode(image)
-        if decoded_objects:
-            return decoded_objects[0].data.decode('utf-8')
+        results = zxingcpp.read_barcodes(image)
+        if results:
+            return results[0].text
         return None
     except Exception:
         return None

cryptex/utils.py

@@ -4,21 +4,21 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cryptex-cli"
-version = "1.1.0"
+version = "1.2.0"
 description = "Enhanced random password generator with advanced security features"
 authors = [
     {name = "Tarek CHEIKH", email = "tarek@tocconsulting.fr"},
 ]
 license = {text = "MIT"}
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 dependencies = [
     "click>=8.0.0",
     "qrcode>=7.0.0",
     "boto3>=1.26.0",
     "hvac>=1.0.0",
     "keyring>=24.0.0",
-    "pyzbar>=0.1.9",
+    "zxing-cpp>=2.0.0",
     "Pillow>=9.0.0",
 ]
 
@@ -30,11 +30,10 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Security",
     "Topic :: System :: Systems Administration",
     "Topic :: Utilities",
@@ -73,10 +72,10 @@ packages = ["cryptex"]
 
 [tool.black]
 line-length = 100
-target-version = ['py38']
+target-version = ['py310', 'py311', 'py312', 'py313']
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.10"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true