Metadata-Version: 2.4
Name: passwd-generator
Version: 2026.1.1
Summary: Simple Python library to generate, hash, and verify secure passwords with modern crack time analysis
Project-URL: Homepage, https://github.com/Areoxy/passwd-generator
Project-URL: Repository, https://github.com/Areoxy/passwd-generator
Project-URL: Bug Tracker, https://github.com/Areoxy/passwd-generator/issues
Author-email: Areo <areo@envyre.de>
License: MIT
License-File: LICENSE.txt
Keywords: generate,hash,password,sha256,validation
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown

[![Downloads](https://static.pepy.tech/badge/passwd-generator)](https://pepy.tech/project/passwd-generator) [![Downloads](https://static.pepy.tech/badge/passwd-generator/month)](https://pepy.tech/project/passwd-generator)

# passwd-generator

passwd-generator is a simple Python library to generate, hash, and verify secure passwords with modern crack time analysis.

## Documentation

Install the Package with 

`pip install passwd-generator` 
or install the Development Version with 
`pip install git+`

### **Generate a password**

```python
from passwd_generator import passwd

# available types: 'char' (letters+symbols), 'num' (numbers only), 'nchar' (all chars)
password = passwd().generate_passwd(length=12, type="nchar")
```

### **Validate a password**

```python
from passwd_generator import passwd

print(passwd().validate_passwd(password="text", min_length=4))
```

Example Ouput:
```commandline
{
    'valid': True,
    'length': 11,
    'score': 4,
    'cracktime' 24y
    'requirements': {
        'digits': True,
        'upper': True,
        'lower': True,
        'special': True
    }
}
```

### **Hash a password/text**
```python
from passwd_generator import passwd

password_hash = passwd().hash_passwd("text")
```

### **Verify a hash**
```python
from passwd_generator import passwd

password_hash = passwd().verify_hash("new_hash", "old_hash")
```
