amsdal_mail 0.1.0__tar.gz

amsdal_mail-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,62 @@
+name: CI
+
+on:
+  pull_request:
+
+jobs:
+  license-check:
+    name: License check
+    runs-on: self-hosted
+    steps:
+      - name: Reset permissions
+        run: |
+          sudo chown -R $(id -u):$(id -g) .
+      - uses: actions/checkout@v5
+
+      - name: Python install
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+      - name: License check
+        run: |
+          pip install toml
+          python license_check.py
+
+  test-lint:
+    name: Run tests and check style
+    needs: [license-check]
+    runs-on: self-hosted
+    strategy:
+      max-parallel: 1
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    env:
+      PYTHON: ${{ matrix.python-version }}
+      DEPS: yes
+      _TYPER_FORCE_DISABLE_TERMINAL: true
+    steps:
+      - uses: actions/checkout@v5
+      - uses: szenius/set-timezone@v2.0
+        with:
+          timezoneLinux: "EEST"
+
+      - name: Set up python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Hatch and UV setup
+        run: |
+          pip install --upgrade uv hatch==1.14.2
+          hatch env prune
+          hatch env create
+          hatch run sync
+
+      - name: Run style checks
+        if: always()
+        run: hatch run all
+
+      - name: Run tests
+        if: always()
+        run: hatch run cov tests/

amsdal_mail-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,107 @@
+name: CD
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  license-check:
+    name: License check
+    runs-on: self-hosted
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Python install
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - name: License check
+        run: |
+          pip install toml
+          python license_check.py
+
+  build:
+    name: Build and compile
+    needs: [license-check]
+    runs-on: self-hosted
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12"]
+    env:
+      PYTHON: ${{ matrix.python-version }}
+      DEPS: yes
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install hatch
+        run: |
+          python -m pip install --upgrade setuptools
+          python -m pip install --upgrade hatch==1.14.2
+          python -m pip install --upgrade uv
+
+      - name: Build
+        run: hatch build
+
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    name: Publish to PyPi
+    runs-on: self-hosted
+    needs: build
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12"]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Branch info
+        id: branch_info
+        run: |
+          echo "SOURCE_TAG=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+
+      - name: Extract changelog for release
+        id: changelog
+        run: |
+          python scripts/extract_changelog.py ${{ steps.branch_info.outputs.SOURCE_TAG }} > latest-changelogs.md
+
+      - name: Install hatch
+        run: |
+          python -m pip install --upgrade setuptools
+          python -m pip install --upgrade hatch==1.14.2
+
+      - name: Publish
+        run: |
+          hatch publish --user ${{ secrets.PYPI_USERNAME }} --auth ${{ secrets.PYPI_TOKEN }}
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: latest-changelogs.md
+          files: dist/*
+          name: ${{ steps.branch_info.outputs.SOURCE_TAG }}
+          draft: false
+          prerelease: false

amsdal_mail-0.1.0/.github/workflows/tag_check.yml

@@ -0,0 +1,28 @@
+name: Tags Check
+
+on:
+  pull_request:
+    branches:
+      - main
+    types: [closed]
+
+jobs:
+  tags_check:
+    name: Tags Check
+    if: github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'main' && startsWith(github.event.pull_request.head.ref, 'release/')
+    runs-on: self-hosted
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: main
+          token: ${{ secrets.ACCESS_KEY }}
+
+      - name: Create tag from version
+        env:
+          GITHUB_TOKEN: ${{ secrets.ACCESS_KEY }}
+        run: |
+          VERSION=$(python -c "exec(open('amsdal_mail/__about__.py').read()); print(__version__)")
+          TAG="v${VERSION}"
+          echo "Creating tag: ${TAG}"
+          git tag "${TAG}"
+          git push origin "${TAG}"

amsdal_mail-0.1.0/.gitignore

@@ -0,0 +1,40 @@
+.venv/
+venv/
+/warehouse
+.python-version
+
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+build/
+dist/
+*.egg-info/
+
+.vscode/
+.idea/
+*.code-workspace
+.DS_Store
+Thumbs.db
+.claude/
+.jbeval/
+
+.env
+.env.*
+!.env.example
+
+
+/transactions/
+/migrations/
+/models/
+/fixtures/
+/static/
+.tmp

amsdal_mail-0.1.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-02-06
+
+### Added
+- Core architecture with backend abstraction and registry pattern
+- `send_mail()` and `asend_mail()` high-level API
+- `EmailMessage` and `Attachment` Pydantic models with full validation
+- `SendStatus` with per-recipient tracking (`is_success`, `has_failures`, etc.)
+- Console backend for development and debugging
+- Dummy backend for testing
+- SMTP backend with TLS/SSL support and async via aiosmtplib
+- AWS SES backend with boto3/aioboto3
+- Template support with `template_id`, `merge_data`, `merge_global_data` (SES)
+- Tags and metadata for email categorization and tracking
+- Click and open tracking (`track_opens`, `track_clicks`)
+- Inline images (CID) support via `Attachment.content_id`
+- Webhook handlers for SES tracking events (bounce, complaint, delivery, etc.)
+- Email tracking events via AMSDAL EventBus
+- AMSDAL Framework integration via `MailAppConfig`
+- Settings management via pydantic_settings
+- Exception hierarchy: `EmailError`, `ConfigurationError`, `EmailConnectionError`, `SendError`