A python 3.5+ admin client for the open source mail delivery platform postal.
This package is only for postal administrators and do not include support for the message and send API.
Postal currently don't have a proper HTTP API for administation so we rely on faking a brower filling forms and dealing with csrf tokens to make rails happy.
This can for example be used to manage and create new organizations.
This package can be installed from PyPI
pip install postal-admin-client
Initalize client
>> import postal_admin_client
>>
>> client = postal_admin_client.Client(
>> 'https://postal.example.com',
>> email='[email protected]',
>> password='myhopefullysecurepassword',
>> )
List/create/delete organization
>> client.list_organizations()
[{'name': 'Anansi Technologies', 'shortname': 'at'},
{'name': 'Council of Venice', 'shortname': 'cov'},
{'name': 'Orochi Group', 'shortname': 'og'}]
>> client.create_organization('Illuminati')
{'name': 'Illuminati', 'shortname': 'il'}
>> client.delete_organization('il')
List and create/invite users
>> client.list_users('il')
[{'name': 'Kirsten Geary', 'email': '[email protected]'},
{'name': 'Alex McCall', 'email': '[email protected]'}]
>> client.create_user('il', '[email protected]', admin=False)
- List organizations
- Create organization
- Delete organization
- List users in organization
- Invite user to organization
Basic Setup
python -m virtualenv .venv
. .venv/bin/activate
python setup.py develop
Tests
pip install -r tests/requirements.txt
tox
- Properly parse out validation errors. For example:
create_user
raisesHTTPError(422)
in three different cases and it would be useful for the user to easily be able to separate between them. - Add CLI support
- Support more operations
This package is using logging
. You can configure logging behaviour
(handler, log level, propagation etc) by obtaining the logger for this package.
logger = logging.getLogger('postal_admin_client')
Do not hesistate creating pull requests with completed or partial work or create issues. There are very likely many things to improve.
This project is sponsored by zetta.io