mode-streaming 0.3.4__tar.gz → 0.5.0__tar.gz

{mode-streaming-0.3.4 → mode_streaming-0.5.0}/.editorconfig

@@ -10,5 +10,9 @@ insert_final_newline = true
 charset = utf-8
 end_of_line = lf
 
+[{*.yml,*.yaml}]
+indent_style = space
+indent_size = 2
+
 [Makefile]
 indent_style = tab

mode-streaming-0.3.4/.github/workflows/gh-pages.yml → mode_streaming-0.5.0/.github/workflows/deploy-docs.yml

@@ -8,29 +8,36 @@ on:
   release:
     types: [created]
     branches:
-      - 'master'
+      - master
+  workflow_dispatch:
 
 jobs:
   build:
-    name: "Build docs"
+    name: Build docs
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/setup-python@v4
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
-    - name: "Install runtime dependencies in order to get package metadata"
-      run: "scripts/install"
-    - name: "Install deps and build with Sphinx"
-      run: make docs
-    - name: "Upload artifacts"
-      uses: actions/upload-pages-artifact@v1
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install dependencies
+      run: pip install -r requirements.txt
+
+    - name: Build docs
+      run: scripts/build-docs.sh
+
+    - name: Upload artifacts
+      uses: actions/upload-pages-artifact@v3
       with:
         # Upload built docs
-        path: "./Documentation"
+        path: "./site"
   deploy:
-    name: "Deploy docs"
-    if: github.event_name == 'release' && github.event.action == 'published'
+    name: Deploy docs
+    if: github.event_name == 'release' && github.event.action == 'created'
     needs: build
     runs-on: ubuntu-latest
     # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
@@ -42,6 +49,6 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
-    - uses: actions/deploy-pages@v1
+    - uses: actions/deploy-pages@v4
       id: deployment
       name: "Deploy to GitHub Pages"

mode_streaming-0.5.0/.github/workflows/publish.yml

@@ -0,0 +1,63 @@
+name: Publish Package
+
+on:
+  # Only run when release is created in the master branch
+  release:
+    types: [created]
+    branches:
+      - 'master'
+  # Manual re-publish/backfill: run from a tag to rebuild and upload any
+  # files missing on PyPI for that version (skip-existing keeps the rest).
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distributable files
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Checkout source repository'
+        uses: actions/checkout@v4
+        with:
+            fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install build dependencies
+        # --upgrade packaging: the system interpreter satisfies twine's floor
+        # with packaging 24.0, which predates Metadata-Version 2.4 / PEP 639
+        # License-File support and fails `twine check` on wheels built by
+        # setuptools >= 77.
+        run: pip install --upgrade build twine packaging
+
+      - name: 'Build package'
+        run: scripts/build.sh
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-packages
+          path: 'dist/*'
+          if-no-files-found: error
+
+  upload_pypi:
+    name: Upload packages
+    needs: ['build']
+    runs-on: 'ubuntu-latest'
+    if: >-
+      (github.event_name == 'release' && github.event.action == 'created')
+      || github.event_name == 'workflow_dispatch'
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-packages
+          path: dist
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: '__token__'
+          password: '${{ secrets.PYPI_API_TOKEN }}'
+          skip-existing: true

mode_streaming-0.5.0/.github/workflows/tests.yml

@@ -0,0 +1,71 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: Python package
+
+on:
+  push:
+    branches: ["master"]
+  pull_request:
+    branches: ["master"]
+
+jobs:
+  tests:
+    name: "Run tests with Python ${{ matrix.python-version }}"
+    runs-on: "ubuntu-latest"
+
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "pypy3.9"
+          - "pypy3.10"
+          - "3.9"
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+        experimental: [ false ]
+        include:
+          - python-version: "~3.14.0-0"
+            experimental: true
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+            fetch-depth: 0
+      - uses: "actions/setup-python@v4"
+        with:
+          python-version: "${{ matrix.python-version }}"
+          cache: "pip"
+          cache-dependency-path: |
+            requirements-docs.txt
+            requirements-tests.txt
+            pyproject.toml
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Run linting checks
+        run: scripts/lint.sh
+
+      - name: Run tests
+        run: scripts/tests.sh
+
+      - name: Enforce coverage
+        uses: codecov/codecov-action@v4
+        with:
+            token: ${{ secrets.CODECOV_TOKEN }}
+
+  check:  # This job does nothing and is only used for the branch protection
+    name: ✅ Ensure the required checks passing
+    if: always()
+    needs:
+      - tests
+    runs-on: ubuntu-latest
+    steps:
+    - name: Decide whether the needed jobs succeeded or failed
+      uses: re-actors/alls-green@release/v1
+      with:
+        jobs: ${{ toJSON(needs) }}

mode_streaming-0.5.0/.gitignore

@@ -0,0 +1,102 @@
+# Python template
+## Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*.pyc
+*$py.class
+
+## Distribution / packaging
+.Python
+build/
+.build/
+_build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+## 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/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+## pyenv
+.python-version
+
+## Environments
+.venv
+venv/
+ENV/
+
+## mkdocs documentation
+/site
+
+## mypy
+.mypy_cache/
+
+# VisualStudioCode template
+.vscode/
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+# Emacs
+*~
+
+# Vim template
+## Swap
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-v][a-z]
+[._]sw[a-p]
+
+## Session
+Session.vim
+
+# Auto-generated tag files
+tags
+.pytest_cache/
+.ipython/
+.ruff_cache/
+
+### PyCharm
+.idea
+
+# Misc
+.DS_Store
+.directory
+erl_crash.dump
+*.db
+.ropeproject/
+.project
+.pydevproject
+.ve*
+.vagrant/
+*-cache*
+.pyre/

mode_streaming-0.5.0/.pre-commit-config.yaml

@@ -0,0 +1,35 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v3.18.0
+    hooks:
+      - id: commitizen
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.12.1
+    hooks:
+      # Run the linter
+      - id: ruff-check
+        args:
+          - --fix
+      # Run the formatter
+      - id: ruff-format
+
+# NOTE(@manawasp): uncomment when mypy restored
+#   - repo: https://github.com/pre-commit/mirrors-mypy
+#     rev: v1.8.0
+#     hooks:
+#       - id: mypy
+#         entry: mypy
+#         files: \.py$
+#         language: system
+#         exclude: ^(t|venv|env|examples|docs)/
+#         args: [--install-types, --non-interactive]

mode_streaming-0.5.0/CHANGELOG.md

@@ -0,0 +1,4 @@
+
+## v0.2.0 (2024-03-02)
+
+## 0.1.0 (2023-01-10)

mode-streaming-0.3.4/docs/includes/code-of-conduct.txt → mode_streaming-0.5.0/CODE_OF_CONDUCT.md

@@ -1,5 +1,4 @@
-Code of Conduct
-===============
+# Code of Conduct
 
 Everyone interacting in the project's codebases, issue trackers, chat rooms,
 and mailing lists is expected to follow the Mode Code of Conduct.

mode_streaming-0.5.0/CONTRIBUTING.md

@@ -0,0 +1,131 @@
+# Contributing
+
+Contributions to mode are very welcome, feel free to open an issue to propose your ideas.
+
+To make a contribution please create a pull request.
+
+## Developing
+
+First it is recommended to fork this repository into your personal Github account then clone your freshly generated fork locally.
+
+### Setup environment
+
+Here are some guidelines to set up your environment:
+
+```sh
+$ cd mode/
+$ python -m venv env # Create python virtual environment, a `env/` has been created
+$ source env/bin/active # Activate the environment
+(venv) $ which pip # Ensure everything is well configured
+/some/directory/mode/env/bin/pip
+```
+
+### Install project dependencies
+
+```sh
+(venv) $ pip install -r requirements.txt
+Obtaining file:///some/directory/mode
+  Installing build dependencies ... done
+  Checking if build backend supports build_editable ... done
+  Getting requirements to build editable ... done
+  Installing backend dependencies ... done
+  Preparing editable metadata (pyproject.toml) ... done
+Ignoring pre-commit: markers 'python_version < "3.9"' don't match your environment
+...
+```
+
+This project apply some quality rules on code and commit, to enforce them at commit time you should install the [pre-commit](https://pre-commit.com/) hook:
+
+```sh
+(venv) $ pre-commit install
+pre-commit installed at .git/hooks/pre-commit
+```
+
+### Format & lint the code
+
+You can run the format script to make your change compliant:
+
+```sh
+(venv) $ ./scripts/format.sh
++ ruff format mode tests
+79 files left unchanged
++ ruff check mode tests --fix
+```
+
+_The script uses [ruff](https://github.com/astral-sh/ruff) & [mypy](https://mypy-lang.org/)._
+
+### Run tests
+
+A script is also available to run them:
+
+```
+(venv) $ ./scripts/tests.sh
++ pytest tests --cov=mode
+Test session starts (platform: linux, Python 3.12.2, pytest 8.1.1, pytest-sugar 1.0.0)
+...
+```
+
+_The script uses [pytest](https://docs.pytest.org/en/8.0.x/contents.html)._
+
+### Commit format
+
+Commit should be formatted following [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/).
+
+You can commit manually and respect the convention or you can use the cli to help you formatting correctly:
+
+```sh
+(venv) $ cz commit
+? Select the type of change you are committing docs: Documentation only changes
+? What is the scope of this change? (class or file name): (press [enter] to skip)
+ README
+? Write a short and imperative summary of the code changes: (lower case and no period)
+ correct spelling of README
+? Provide additional contextual information about the code changes: (press [enter] to skip)
+
+? Is this a BREAKING CHANGE? Correlates with MAJOR in SemVer No
+? Footer. Information about Breaking Changes and reference issues that this commit closes: (press [enter] to skip)
+
+
+docs(README): correct spelling of README
+```
+
+## Documentation
+
+To be able to run the documentation locally you should setup your environment and install dependencies, if not already you can read the two first part of the Developing section.
+
+```sh
+(venv) $ mkdocs serve
+INFO    -  Building documentation...
+INFO    -  Cleaning site directory
+INFO    -  Documentation built in 1.78 seconds
+INFO    -  [19:38:48] Watching paths for changes: 'docs', 'mkdocs.yml'
+INFO    -  [19:38:48] Serving on http://127.0.0.1:8000/
+```
+
+Then, you can browse the documentation on http://127.0.0.1:8000.
+
+## Maintainers
+
+### Publish a new release
+
+1. First create a new tag and update changelog
+
+```sh
+(venv) $ ./scripts/bump.sh
++ cz bump --changelog
+bump: version 0.2.0 → 0.2.1
+tag to create: 0.2.1
+increment detected: PATCH
+
+[master b35722f] bump: version 0.2.0 → 0.2.1
+ 2 files changed, 2 insertions(+), 1 deletion(-)
+
+...
+
+Done!
+```
+
+!!! note
+    If this pass it will automatically push the commit and tags to the remote server, you may want to use `cz bump --changelog --dry-run` to check generated changes.
+
+2. Then after ensuring github pass you could publish the release via the Github interface. (An action will triggered and will publish the package to pypi and documentation to the Github pages).