message-sender 0.1.0__tar.gz

message_sender-0.1.0/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: daily
+    labels:
+    - skip-changelog
+    - dependencies
+  - package-ecosystem: "github-actions"
+    directory: '/'
+    schedule:
+      interval: daily
+    labels:
+    - skip-changelog
+    - dependencies

message_sender-0.1.0/.github/release_drafter_template.yml

@@ -0,0 +1,25 @@
+name-template: 'v$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+exclude-labels:
+  - 'dependencies'
+  - 'skip-changelog'
+version-resolver:
+  major:
+    labels:
+      - 'breaking-change'
+  minor:
+    labels:
+      - 'enhancement'
+  default: patch
+categories:
+  - title: '⚠ Breaking changes'
+    label: 'breaking-change'
+  - title: 'Features'
+    labels: 'enhancement'
+  - title: 'Bug Fixes'
+    labels: 'bug'
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+template: |
+  ## Changes
+
+  $CHANGES

message_sender-0.1.0/.github/workflows/pypi_publish.yml

@@ -0,0 +1,27 @@
+name: PyPi Publish
+on:
+  release:
+    types:
+    - published
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      # For PyPI's trusted publishing.
+      id-token: write
+    steps:
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        enable-cache: true
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.14"
+    - name: Install Dependencies
+      run: uv sync --frozen
+    - name: Build package
+      run: uv build
+    - name: Publish package
+      run: uv publish

message_sender-0.1.0/.github/workflows/release_drafter.yml

@@ -0,0 +1,16 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  update_release_draft:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6
+        with:
+          config-name: release_drafter_template.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

message_sender-0.1.0/.github/workflows/testing.yml

@@ -0,0 +1,57 @@
+name: Testing
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+env:
+  UV_CACHE_DIR: /tmp/.uv-cache
+  PYTHON_VERSION: "3.11"
+jobs:
+  linting:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install Dependencies
+        run: uv sync --frozen
+      - name: Ruff format check
+        run: uv run ruff format message_sender tests --check
+      - name: Lint with ruff
+        run: uv run ruff check .
+      - name: mypy check
+        run: uv run mypy .
+  testing:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Dependencies
+        run: uv sync --frozen
+      - name: Test with pytest
+        run: uv run pytest --cov-report=xml
+      - name: Upload coverage
+        uses: codecov/codecov-action@v5.5.2
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: true

message_sender-0.1.0/.gitignore

@@ -0,0 +1,138 @@
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# OS Files
+*.swp
+*.DS_Store
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# editors
+.idea
+.vscode

message_sender-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-toml
+      - id: check-yaml
+      - id: debug-statements
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: no-commit-to-branch
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.19.1
+    hooks:
+      - id: mypy
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.13
+    hooks:
+      - id: ruff-check
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format

message_sender-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Paul Sanders
+
+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.

message_sender-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: message-sender
+Version: 0.1.0
+Summary: Sends Messages with different services such as email
+Author-email: Paul Sanders <paul@paulsanders.dev>
+License: MIT License
+        
+        Copyright (c) 2026 Paul Sanders
+        
+        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.
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: aiosmtplib>=5.0.0
+Requires-Dist: httpx>=0.28.1
+Description-Content-Type: text/markdown
+
+# Message Sender
+
+[![Tests Status](https://github.com/sanders41/message-sender/actions/workflows/testing.yml/badge.svg?branch=main&event=push)](https://github.com/sanders41/message-sender/actions?query=workflow%3ATesting+branch%3Amain+event%3Apush)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/sanders41/message-sender/main.svg)](https://results.pre-commit.ci/latest/github/sanders41/message-sender/main)
+[![Coverage](https://codecov.io/github/sanders41/message-sender/coverage.svg?branch=main)](https://codecov.io/gh/sanders41/message-sender)
+[![PyPI version](https://badge.fury.io/py/message-sender.svg)](https://badge.fury.io/py/message-sender)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/message-sender?color=5cc141)](https://github.com/sanders41/message-sender)
+
+Sends messages with different services such as email and Google Chat.
+
+## Installation
+
+```sh
+pip install message-sender
+```
+
+## Usage
+
+### Google Chat
+
+Send messages to Google Chat via webhooks. To set this up, create a "space" in Google Chat, then go
+to Apps & integrations and create a new webhook.
+
+#### Sync Client
+
+```py
+from message_sender.google_chat import GoogleChatClient
+
+with GoogleChatClient("https://your-webhook-url.com") as client:
+    client.send_message("Some test message")
+```
+
+#### Async Client
+
+```py
+from message_sender.google_chat import AsyncGoogleChatClient
+
+async with AsyncGoogleChatClient("https://your-webhook-url.com") as client:
+    await client.send_message("Some test message")
+```
+
+### Proton Email
+
+Send emails through Proton Mail's SMTP service. For setup instructions see
+[https://proton.me/support/smtp-submission](https://proton.me/support/smtp-submission)
+
+#### Sync Client
+
+```py
+from message_sender.email.proton import ProtonEmailClient
+
+client = ProtonEmailClient(
+    email_address="smtp_setup_email@proton.me", smtp_token="your-token"
+)
+client.send_email(
+    message="Your message body",
+    email_to="someone@email.com",
+    subject="Example",
+    html_content="<p>Your HTML message body</p>",  # optional
+)
+```
+
+#### Async Client
+
+```py
+from message_sender.email.proton import AsyncProtonEmailClient
+
+client = AsyncProtonEmailClient(
+    email_address="smtp_setup_email@proton.me", smtp_token="your-token"
+)
+await client.send_email(
+    message="Your message body",
+    email_to="someone@email.com",
+    subject="Example",
+    html_content="<p>Your HTML message body</p>",  # optional
+)
+```

message_sender-0.1.0/README.md

@@ -0,0 +1,77 @@
+# Message Sender
+
+[![Tests Status](https://github.com/sanders41/message-sender/actions/workflows/testing.yml/badge.svg?branch=main&event=push)](https://github.com/sanders41/message-sender/actions?query=workflow%3ATesting+branch%3Amain+event%3Apush)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/sanders41/message-sender/main.svg)](https://results.pre-commit.ci/latest/github/sanders41/message-sender/main)
+[![Coverage](https://codecov.io/github/sanders41/message-sender/coverage.svg?branch=main)](https://codecov.io/gh/sanders41/message-sender)
+[![PyPI version](https://badge.fury.io/py/message-sender.svg)](https://badge.fury.io/py/message-sender)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/message-sender?color=5cc141)](https://github.com/sanders41/message-sender)
+
+Sends messages with different services such as email and Google Chat.
+
+## Installation
+
+```sh
+pip install message-sender
+```
+
+## Usage
+
+### Google Chat
+
+Send messages to Google Chat via webhooks. To set this up, create a "space" in Google Chat, then go
+to Apps & integrations and create a new webhook.
+
+#### Sync Client
+
+```py
+from message_sender.google_chat import GoogleChatClient
+
+with GoogleChatClient("https://your-webhook-url.com") as client:
+    client.send_message("Some test message")
+```
+
+#### Async Client
+
+```py
+from message_sender.google_chat import AsyncGoogleChatClient
+
+async with AsyncGoogleChatClient("https://your-webhook-url.com") as client:
+    await client.send_message("Some test message")
+```
+
+### Proton Email
+
+Send emails through Proton Mail's SMTP service. For setup instructions see
+[https://proton.me/support/smtp-submission](https://proton.me/support/smtp-submission)
+
+#### Sync Client
+
+```py
+from message_sender.email.proton import ProtonEmailClient
+
+client = ProtonEmailClient(
+    email_address="smtp_setup_email@proton.me", smtp_token="your-token"
+)
+client.send_email(
+    message="Your message body",
+    email_to="someone@email.com",
+    subject="Example",
+    html_content="<p>Your HTML message body</p>",  # optional
+)
+```
+
+#### Async Client
+
+```py
+from message_sender.email.proton import AsyncProtonEmailClient
+
+client = AsyncProtonEmailClient(
+    email_address="smtp_setup_email@proton.me", smtp_token="your-token"
+)
+await client.send_email(
+    message="Your message body",
+    email_to="someone@email.com",
+    subject="Example",
+    html_content="<p>Your HTML message body</p>",  # optional
+)
+```

message_sender-0.1.0/justfile

@@ -0,0 +1,31 @@
+@_default:
+  just --list
+
+@lint:
+  echo mypy
+  just --justfile {{justfile()}} mypy
+  echo ruff-check
+  just --justfile {{justfile()}} ruff-check
+  echo ruff-format
+  just --justfile {{justfile()}} ruff-format
+
+@mypy:
+  uv run mypy message_sender tests
+
+@ruff-check:
+  uv run ruff check message_sender tests
+
+@ruff-format:
+  uv run ruff format message_sender tests
+
+@lock:
+  uv lock
+
+@lock-upgrade:
+  uv lock --upgrade
+
+@install:
+  uv sync --frozen --all-extras
+
+@test *args="":
+  uv run pytest {{args}}

message_sender-0.1.0/message_sender/__init__.py

@@ -0,0 +1,3 @@
+from message_sender._version import VERSION
+
+__version__ = VERSION

message_sender-0.1.0/message_sender/_version.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+VERSION = "0.1.0"