# 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.
