il-postino 0.1.0__tar.gz

il_postino-0.1.0/.gitignore

@@ -0,0 +1,46 @@
+# Secrets
+.env
+.env.*
+!.env.example
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+build/
+dist/
+*.whl
+
+# Virtualenvs
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+
+# Type checkers
+.pyright/
+.mypy_cache/
+.ruff_cache/
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Local data
+*.db
+*.sqlite
+*.sqlite3
+
+# Worktrees
+.worktrees/

il_postino-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcello Barnaba
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

il_postino-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: il-postino
+Version: 0.1.0
+Summary: Typed Python CLI for administering Postfix + Dovecot mail servers (PostfixAdmin schema). Pluggable identity backend.
+Project-URL: Homepage, https://github.com/vjt/postino
+Project-URL: Issues, https://github.com/vjt/postino/issues
+Author-email: Marcello Barnaba <marcello.barnaba@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: System :: Systems Administration
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: bcrypt<5,>=4.0
+Requires-Dist: email-validator>=2.2
+Requires-Dist: passlib>=1.7
+Requires-Dist: pydantic-settings>=2.3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pymysql>=1.1
+Requires-Dist: rich>=13.7
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pyright>=1.1.370; extra == 'dev'
+Requires-Dist: pytest-freezer>=0.4; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# postino
+
+CLI tool to administer a Postfix + Dovecot mail server with the
+PostfixAdmin SQL schema as user/alias/domain backend.
+
+Pluggable identity backend (local password column or external IdP via
+Zitadel/SCIM). Built for FreeBSD mail hosts but portable.
+
+## Status
+
+MVP shipping. Design spec: [`docs/superpowers/specs/2026-05-09-postino-design.md`](docs/superpowers/specs/2026-05-09-postino-design.md).
+
+Requires Python 3.13+.
+
+## Install
+
+```sh
+pipx install il-postino
+```
+
+Import name remains `postino`. The PyPI distribution is published as
+`il-postino` because the bare `postino` name is squatted by an unrelated
+2017 package.
+
+### From git (mail host / production)
+
+```sh
+git clone https://github.com/vjt/postino.git /usr/local/src/postino
+cd /usr/local/src/postino
+python3.13 -m venv .venv
+. .venv/bin/activate
+pip install .
+ln -s /usr/local/src/postino/.venv/bin/postino /usr/local/bin/postino
+
+# update later: cd /usr/local/src/postino && git pull && .venv/bin/pip install .
+```
+
+## Usage
+
+```sh
+# All commands inherit POSTINO_* env vars or read /usr/local/etc/postino/postino.toml
+
+postino domain add example.com --max-mailboxes 100 --default-quota 5G
+postino user add foo@example.com --password 'hunter2' --name "Foo Bar" --quota 5G
+postino user list --domain example.com --json
+postino alias add foo@example.com forwarded@elsewhere.test
+postino quota show foo@example.com
+postino check
+postino status
+```
+
+## Configuration
+
+postino reads `/usr/local/etc/postino/postino.toml`. Example:
+
+```toml
+identity_backend = "local"
+postfix_sql_dir = "/usr/local/etc/postfix"
+virtual_mailbox_base = "/srv/mail"
+postcreation_hook = "/usr/local/sbin/postfixadmin-mailbox-postcreation.sh"
+vmail_uid = 1006
+vmail_gid = 1006
+default_password_scheme = "BLF-CRYPT"
+default_quota_bytes = 1073741824
+```
+
+DB credentials are NOT duplicated here — postino parses
+`/usr/local/etc/postfix/sql-virtual_mailbox_maps.cf` to extract them.
+
+## Development
+
+Set up a test MySQL/MariaDB schema (see
+`docs/superpowers/plans/2026-05-09-postino-mvp.md` § Test Database
+Prerequisites for the DDL), then:
+
+```sh
+python3.13 -m venv .venv
+. .venv/bin/activate
+pip install -e '.[dev]'
+export POSTINO_TEST_DB_URL='mysql+pymysql://postino_test:postino_test_dev@localhost/postino_test'
+./scripts/check.sh
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

il_postino-0.1.0/README.md

@@ -0,0 +1,86 @@
+# postino
+
+CLI tool to administer a Postfix + Dovecot mail server with the
+PostfixAdmin SQL schema as user/alias/domain backend.
+
+Pluggable identity backend (local password column or external IdP via
+Zitadel/SCIM). Built for FreeBSD mail hosts but portable.
+
+## Status
+
+MVP shipping. Design spec: [`docs/superpowers/specs/2026-05-09-postino-design.md`](docs/superpowers/specs/2026-05-09-postino-design.md).
+
+Requires Python 3.13+.
+
+## Install
+
+```sh
+pipx install il-postino
+```
+
+Import name remains `postino`. The PyPI distribution is published as
+`il-postino` because the bare `postino` name is squatted by an unrelated
+2017 package.
+
+### From git (mail host / production)
+
+```sh
+git clone https://github.com/vjt/postino.git /usr/local/src/postino
+cd /usr/local/src/postino
+python3.13 -m venv .venv
+. .venv/bin/activate
+pip install .
+ln -s /usr/local/src/postino/.venv/bin/postino /usr/local/bin/postino
+
+# update later: cd /usr/local/src/postino && git pull && .venv/bin/pip install .
+```
+
+## Usage
+
+```sh
+# All commands inherit POSTINO_* env vars or read /usr/local/etc/postino/postino.toml
+
+postino domain add example.com --max-mailboxes 100 --default-quota 5G
+postino user add foo@example.com --password 'hunter2' --name "Foo Bar" --quota 5G
+postino user list --domain example.com --json
+postino alias add foo@example.com forwarded@elsewhere.test
+postino quota show foo@example.com
+postino check
+postino status
+```
+
+## Configuration
+
+postino reads `/usr/local/etc/postino/postino.toml`. Example:
+
+```toml
+identity_backend = "local"
+postfix_sql_dir = "/usr/local/etc/postfix"
+virtual_mailbox_base = "/srv/mail"
+postcreation_hook = "/usr/local/sbin/postfixadmin-mailbox-postcreation.sh"
+vmail_uid = 1006
+vmail_gid = 1006
+default_password_scheme = "BLF-CRYPT"
+default_quota_bytes = 1073741824
+```
+
+DB credentials are NOT duplicated here — postino parses
+`/usr/local/etc/postfix/sql-virtual_mailbox_maps.cf` to extract them.
+
+## Development
+
+Set up a test MySQL/MariaDB schema (see
+`docs/superpowers/plans/2026-05-09-postino-mvp.md` § Test Database
+Prerequisites for the DDL), then:
+
+```sh
+python3.13 -m venv .venv
+. .venv/bin/activate
+pip install -e '.[dev]'
+export POSTINO_TEST_DB_URL='mysql+pymysql://postino_test:postino_test_dev@localhost/postino_test'
+./scripts/check.sh
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).