https://github.com/djmoch/py9pfactotum
Python implementation of the plan9port auth library
https://github.com/djmoch/py9pfactotum
factotum keyring plan9 python
Last synced: 6 months ago
JSON representation
Python implementation of the plan9port auth library
- Host: GitHub
- URL: https://github.com/djmoch/py9pfactotum
- Owner: djmoch
- License: isc
- Created: 2024-06-13T09:54:07.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-06T04:52:29.000Z (7 months ago)
- Last Synced: 2025-12-07T10:37:34.993Z (7 months ago)
- Topics: factotum, keyring, plan9, python
- Language: Python
- Homepage:
- Size: 131 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
py9pfactotum
============
py9pfactotum is Python's plan9port Factotum client. It also provides
the following extras:
- Helper functions that mirror plan9port's auth(3) library
- A [Keyring](https://pypi.org/project/keyring/) backend to connect
to your running factotum server.
Usage
-----
In the current (alpha) state of maturity, the implementation is
incomplete. Currently enough is implemented to support the Keyring
backend (i.e., to read passwords from the running server).
When using the FactotumClient directly, arguments are passed as
keyword arguments, which are built into a key template internally:
``` python
from py9pfactotum import FactotumClient
c = FactotumClient()
c.getpass(server='mail.example.org', user='johndoe')
{ 'user': 'johndoe', 'passwd': 'insecure' }
```
As with the example above, the client provides high-level methods
that supply the correct 'proto' and 'role' attributes to the key
template. See factotum(4) for more information.
When using the auth(3) functions, the function signatures mirror
their plan9port counterparts, except that structures are replaced
with dictionaries.
``` python
from py9pfactotum import auth_getuserpasswd
c = auth_getuserpasswd(server='mail.example.org')
{ 'user': 'johndoe', 'passwd': 'insecure' }
```
Keyring
-------
The Keyring user interface is transparent, but that library must
be explicitly installed on the system (it is not a hard dependency
of py9pfactotum). Because factotum is not able to persist passwords
(or password deletions), attempts to use the Keyring to do so will
throw an error.