oo7 Python Bindings

Python bindings for oo7, providing access to Secret Service API on Linux. Automatically uses a file-based keyring when running in a sandboxed environment.

Installation

cd python
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
maturin develop

Usage

import asyncio
import oo7

async def main():
    # Create keyring
    keyring = await oo7.Keyring.new()

    # Store a secret
    await keyring.create_item(
        "My Password",
        {"application": "myapp", "username": "alice"},
        b"secret-password",
        replace=True
    )

    # Search for items
    items = await keyring.search_items({"application": "myapp"})
    for item in items:
        secret = await item.secret()
        print(f"Secret: {secret}")

    # Clean up
    await keyring.delete({"application": "myapp"})

asyncio.run(main())

Running Tests

pytest

Examples

See tests/test_keyring.py for more examples.

License

MIT