easyspeak-linux 0.1.0__tar.gz

easyspeak_linux-0.1.0/.github/workflows/pipeline.yml

@@ -0,0 +1,49 @@
+name: Pipeline
+
+on:
+  pull_request:
+    branches:
+    - main
+    - dev
+  push:
+    branches:
+    - main
+    - dev
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        task:
+        - format --diff
+        - lint --
+        - types
+        - package
+        - functional
+      fail-fast: false
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+      with:
+        python-version: '3.12'
+    - uses: extractions/setup-just@v3
+    - run: just ${{ matrix.task }}
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version:
+        - '3.10'
+        - '3.11'
+        - '3.12'
+      fail-fast: false
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+    - uses: extractions/setup-just@v3
+    - run: just pytest
+    - run: just coverage

easyspeak_linux-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish
+
+on:
+  push:
+    tags:
+    - '*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+      with:
+        python-version: '3.12'
+    - uses: extractions/setup-just@v3
+    - name: Build the Python package
+      run: just package
+    - name: Verify that package version matches Git tag
+      run: just ensure_version_matches ${{ github.ref_name }}
+    - name: Publish package to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

easyspeak_linux-0.1.0/.github/workflows/safety.yml

@@ -0,0 +1,22 @@
+name: Safety
+
+on:
+  schedule:
+  - cron: "0 0 * * *"
+
+jobs:
+  safety:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        task:
+        - audit
+        - requirements
+      fail-fast: false
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+      with:
+        python-version: '3.12'
+    - uses: extractions/setup-just@v3
+    - run: just ${{ matrix.task }}

easyspeak_linux-0.1.0/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Testing
+.coverage
+coverage.json
+coverage.xml
+htmlcov/
+junit-report.xml
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+.tox/
+requirements.txt
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.wav
+*.log

easyspeak_linux-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,63 @@
+# Contributing
+
+Contributions welcome. Please open an issue first to discuss changes.
+
+Areas that need work:
+- More application integrations
+
+## Planned Enhancements
+
+- Window controls (maximize, minimize)
+- Dictation focus detection fix
+- Further GNOME integration for desktop control
+- Verbal help per section (say "help browser" for spoken commands)
+- Auto-discover installed apps for launcher
+- Clipboard commands (copy, paste)
+
+## Development
+
+This project sports a [Justfile](https://just.systems/man/en/) to simplify
+all local development activities, and for running the same tasks in the CI
+pipeline.
+
+```console
+just
+```
+
+```console
+just all
+```
+
+```console
+UV_PYTHON=3.12 just pytest -q -x
+```
+
+```console
+just clean
+```
+
+The setup uses [uv](https://docs.astral.sh/uv/concepts/) under the hood,
+which transparently manages virtual environments and package installation.
+uv also allows you to install several Python versions on your computer in
+parallel. We use this to test against all supported Python versions.
+
+### Prerequisites
+
+You need to install `uv` and `just`, e.g.
+
+```console
+python3 -m pip install uv
+```
+
+```console
+uv tool install rust-just
+```
+
+## Packaging & Version Numbers
+
+The packaging configuration is in `pyproject.toml`, supported by
+`MANIFEST.in`. Version numbers are generated automatically by
+[setuptools-scm](https://setuptools-scm.readthedocs.io/) based on the
+latest Git tag and the distance from that tag in number of commits.
+
+To publish a new release, push a new Git tag (e.g. 2.1.0) to GitHub.