Metadata-Version: 2.4
Name: pqcdualusb
Version: 0.1.1
Summary: Enterprise-grade dual USB backup library with post-quantum cryptography protection for maximum security
Author: Johnson Ajibi
Author-email: Johnson Ajibi <johnsonajibi@example.com>
License: MIT
Project-URL: Homepage, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library
Project-URL: Repository, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library
Project-URL: Documentation, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library#readme
Project-URL: Issues, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library/issues
Project-URL: Discussions, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library/discussions
Project-URL: Releases, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library/releases
Project-URL: Security, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library/security/policy
Project-URL: Changelog, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library/blob/master/CHANGELOG.md
Project-URL: Contributing, https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library/blob/master/CONTRIBUTING.md
Keywords: security,backup,usb,cryptography,post-quantum,dual-usb,enterprise,quantum-resistant,encryption,memory-protection,audit-logging,cross-platform,dilithium,aes-256,argon2,hsm,air-gapped
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: System :: Archiving :: Backup
Classifier: Topic :: System :: Hardware :: Universal Serial Bus (USB)
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cryptography>=3.4.8
Requires-Dist: argon2-cffi>=21.3.0
Provides-Extra: pqc
Requires-Dist: python-oqs>=0.7.0; extra == "pqc"
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=3.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=0.991; extra == "dev"
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# PostQuantum DualUSB Token Library

**Enterprise-grade dual USB backup system with post-quantum cryptography protection**

[![PyPI version](https://badge.fury.io/py/pqcdualusb.svg)](https://badge.fury.io/py/pqcdualusb)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://pepy.tech/badge/pqcdualusb)](https://pepy.tech/project/pqcdualusb)

## What is pqcdualusb?

PostQuantum DualUSB Token Library is a Python package that implements quantum-resistant dual USB token storage with advanced security features. It's designed for organizations and individuals who need maximum protection for sensitive data against both current and future quantum computing threats.

## Why choose pqcdualusb?

### 🛡️ **Quantum-Resistant Security**
- **Post-quantum cryptography** using Dilithium digital signatures
- **Future-proof protection** against quantum computer attacks  
- **NIST-approved algorithms** following latest standards

### 🔐 **Dual USB Architecture**
- **Split secret design** - no single point of failure
- **Physical separation** of authentication tokens
- **Hardware binding** prevents USB drive cloning

### 💎 **Enterprise Features**
- **Memory protection** with secure allocation and cleanup
- **Timing attack resistance** with constant-time operations
- **Comprehensive audit logging** with tamper-evident chains
- **Cross-platform support** for Windows, Linux, and macOS

## Quick Start

```bash
# Install the library
pip install pqcdualusb

# Initialize dual USB setup
pqcdualusb init --primary /media/usb1 --secondary /media/usb2

# Create encrypted backup
pqcdualusb backup --data "sensitive.json" --passphrase "strong-passphrase"

# Restore from backup
pqcdualusb restore --backup-file backup.enc --restore-primary /media/usb_new
```

## Python API Example

```python
from pqcdualusb import init_dual_usb, verify_dual_setup
from pathlib import Path

# Set up dual USB security
primary = Path("/media/usb_primary")
secondary = Path("/media/usb_backup")

success = init_dual_usb(
    primary_path=primary,
    secondary_path=secondary,
    passphrase="your-secure-passphrase"
)

if success:
    print("Dual USB setup complete!")
    is_valid = verify_dual_setup(primary, secondary)
    print(f"Setup verification: {is_valid}")
```

## Use Cases

- **Offline password managers** with air-gapped security
- **Cryptocurrency wallet protection** with dual redundancy
- **Enterprise key custody** solutions
- **Secure document archival** with quantum protection
- **Development environments** requiring secure key storage

## Security Features

| Component | Algorithm | Quantum Resistant |
|-----------|-----------|-------------------|
| Encryption | AES-256-GCM | ✅ |
| Key Derivation | Argon2id | ✅ |
| Digital Signatures | Dilithium | ✅ |
| Authentication | HMAC-SHA256 | ✅ |
| Memory Protection | OS-level locking | ✅ |

## Performance

- **USB Detection**: < 1 second
- **Token Creation**: < 5 seconds
- **Backup/Restore**: 1-10 seconds  
- **Memory Usage**: < 100MB peak

## Requirements

- Python 3.8 or higher
- Windows, Linux, or macOS
- Two USB drives for dual storage setup

## Links

- **GitHub Repository**: https://github.com/Johnsonajibi/PostQuantum-DualUSB-Token-Library
- **Documentation**: Full README with examples
- **Security Policy**: Responsible disclosure process
- **Issue Tracker**: Bug reports and feature requests
- **Releases**: Version history and changelogs

## License

MIT License - see LICENSE file for details.

---

**Secure your digital assets with quantum-resistant protection!**
