Metadata-Version: 2.4
Name: lastpass-vault-py
Version: 0.1.0
Summary: An unofficial Python wrapper for the LastPass CLI (lpass).
Author-email: Paul Engler <kuidaore-open@kuidaore.ninja>
Project-URL: Homepage, https://github.com/kuidaore-open/lastpass-vault-py
Project-URL: Bug Tracker, https://github.com/kuidaore-open/lastpass-vault-py/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Dynamic: license-file

# LastPass Vault Py

An unoffical, Pythonic wrapper for the [LastPass CLI (`lpass`)](https://github.com/lastpass/lastpass-cli).

> **Disclaimer:** This project is an unofficial, community-driven tool. It is not affiliated with, maintained, or endorsed by LastPass. The author makes no claims to the LastPass name, brand, trademarks, or intellectual property.

## Features
- Secure authentication via official CLI.
- List, search, and retrieve passwords programmatically.
- Sync your vault with the server.
- Robust error handling and mock-ready for testing.

## Prerequisites
You must have the LastPass CLI installed:
- **Ubuntu/Debian:** `sudo apt install lastpass-cli`
- **macOS:** `brew install lastpass-cli`

## Installation
```bash
pip install lastpass-vault-py
```

## Quick Start
```python
from lastpass_vault import LastPassVault

vault = LastPassVault()

if not vault.is_logged_in():
    vault.login("user@example.com")

items = vault.list_items()
for item in items:
    print(item['name'])

password = vault.get_password("My Site")
```

## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## License
Licensed under the GNU General Public License v3 (GPLv3). See [LICENSE](LICENSE) for details.
