pyhttplib 0.0.0__tar.gz

pyhttplib-0.0.0/.codecov.yml

@@ -0,0 +1,10 @@
+coverage:
+  status:
+    project:
+      default:
+        target: 100%
+  precision: 2
+  range: 80..100
+ignore:
+  - "tests/*"
+  - "scripts/*"

pyhttplib-0.0.0/.coveragerc

@@ -0,0 +1,8 @@
+[run]
+omit =
+    */tests/*
+
+[report]
+exclude_lines =
+    pragma: no cover
+    if __name__ == .__main__:

pyhttplib-0.0.0/.github/workflows/dependabot-auto-merge.yml

@@ -0,0 +1,31 @@
+
+name: Dependabot auto-merge
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  automerge:
+    if: github.event.pull_request.user.login == 'dependabot[bot]'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Fetch Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@25dd0e34f4fe68f24cc83900b1fe3fe149efef98 # v3.1.0
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable auto-merge
+        if: |
+          steps.metadata.outputs.update-type == 'version-update:semver-patch' ||
+          steps.metadata.outputs.update-type == 'version-update:semver-minor'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PR_URL: ${{ github.event.pull_request.html_url }}
+        run: gh pr merge --auto --squash "$PR_URL"

pyhttplib-0.0.0/.github/workflows/publish.yml

@@ -0,0 +1,274 @@
+name: Build
+
+on: push
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+permissions:
+  contents: read
+
+jobs:
+  ensure-tag:
+    runs-on: ubuntu-latest
+    outputs:
+      should_build: ${{ steps.detect.outputs.should_build }}
+  # pyhttplib_version and release_display_name are computed in the build job
+  # to keep version logic centralized in scripts/get_version.py
+    # This job needs write permissions to push tags back to the repository
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Ensure release has a tag
+        id: ensure_tag
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          RELEASE_TAG="${{ github.event.release.tag_name }}"
+          echo "Release tag (from event): '$RELEASE_TAG'"
+
+          if [ -n "$RELEASE_TAG" ]; then
+            echo "Release already has tag: $RELEASE_TAG"
+            echo "should_build=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Reuse the same detection logic the later step uses to find a candidate
+          FOUND=0
+          TAG=""
+          for commit in $(git rev-list --max-count=200 HEAD); do
+            msg=$(git log -1 --pretty=%B "$commit" | sed -n '1p' | tr -d '\r')
+            if echo "$msg" | grep -q "-"; then
+              candidate=$(echo "$msg" | cut -d'-' -f1 | tr -d '[:space:]')
+              if echo "$candidate" | grep -E -q '^[0-9]+[A-Za-z]?$'; then
+                FOUND=1
+                TAG="$candidate"
+                break
+              fi
+            fi
+          done
+
+          if [ "$FOUND" -eq 0 ]; then
+            echo "No matching commit found; should_build=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          echo "Found tag candidate from commits: $TAG"
+
+          # Push tag only if it doesn't exist remotely
+          if git ls-remote --tags origin "refs/tags/$TAG" | grep -q "$TAG"; then
+            echo "Tag $TAG already exists on remote"
+          else
+            echo "Creating tag: $TAG"
+            git config user.name "github-actions[bot]"
+            git config user.email "github-actions[bot]@users.noreply.github.com"
+            git tag -a "$TAG" -m "Tag for release $TAG"
+            git push origin "refs/tags/$TAG"
+          fi
+          echo "should_build=true" >> "$GITHUB_OUTPUT"
+          # Export the chosen tag as a step output so later steps can use it
+          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+
+      - name: Detect release candidate in commits
+        id: detect
+        run: |
+          set -euo pipefail
+          # If CI explicitly sets PYHTTPLIB_VERSION, build
+          if [ -n "${PYHTTPLIB_VERSION-}" ]; then
+            echo "should_build=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          FOUND=0
+          for commit in $(git rev-list --max-count=200 HEAD); do
+            msg=$(git log -1 --pretty=%B "$commit" | sed -n '1p' | tr -d '\r')
+            if echo "$msg" | grep -q "-"; then
+              candidate=$(echo "$msg" | cut -d'-' -f1 | tr -d '[:space:]')
+              if echo "$candidate" | grep -E -q '^[0-9]+[A-Za-z]?$'; then
+                FOUND=1
+                break
+              fi
+            fi
+          done
+          if [ "$FOUND" -eq 1 ]; then
+            echo "should_build=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_build=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      # The numeric package version is determined in the build job using
+      # scripts/get_version.py; removing the set_version step keeps the
+      # ensure-tag job focused on tagging only and avoids cross-job
+      # heredoc/python invocation complexity.
+
+  build:
+    runs-on: ubuntu-latest
+    needs:
+      - ensure-tag
+    if: needs.ensure-tag.outputs.should_build == 'true'
+    outputs:
+      pyhttplib_version: ${{ steps.get_version.outputs.pyhttplib_version }}
+      release_display_name: ${{ steps.get_version.outputs.release_display_name }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Determine package version
+        id: get_version
+        run: |
+          set -euo pipefail
+          python -c "from scripts.get_version import get_pyhttplib_version,get_release_display_name; print(get_pyhttplib_version()); print(get_release_display_name())" > /tmp/_vers
+          echo "pyhttplib_version=$(sed -n '1p' /tmp/_vers)" >> "$GITHUB_OUTPUT"
+          echo "release_display_name=$(sed -n '2p' /tmp/_vers)" >> "$GITHUB_OUTPUT"
+
+      - name: Log resolved version
+        run: |
+          set -euo pipefail
+          echo "Resolved PYHTTPLIB_VERSION=${{ steps.get_version.outputs.pyhttplib_version }}"
+          echo "Resolved RELEASE_DISPLAY_NAME=${{ steps.get_version.outputs.release_display_name }}"
+          # Append to the GitHub Actions job summary for quick visibility
+          if [ -n "${GITHUB_STEP_SUMMARY-}" ]; then
+            echo "### pyhttplib version info" >> "$GITHUB_STEP_SUMMARY"
+            echo "* PYHTTPLIB_VERSION: ${{ steps.get_version.outputs.pyhttplib_version }}" >> "$GITHUB_STEP_SUMMARY"
+            echo "* RELEASE_DISPLAY_NAME: ${{ steps.get_version.outputs.release_display_name }}" >> "$GITHUB_STEP_SUMMARY"
+          fi
+
+      - name: Build release distributions
+        run: |
+          set -euo pipefail
+          # Clean any previous build artifacts so we don't upload stale packages
+          rm -rf dist || true
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - build
+    if: needs.build.result == 'success' && needs.ensure-tag.outputs.should_build == 'true'
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      url: https://pypi.org/project/pyhttplib
+      #
+      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+      # ALTERNATIVE: exactly, uncomment the following line instead:
+      # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Determine version and check PyPI
+        id: check_pypi
+        run: |
+          set -euo pipefail
+          # Prefer the canonical version discovered during the build job.
+          if [ -n "${{ needs.build.outputs.pyhttplib_version }}" ]; then
+            VER="${{ needs.build.outputs.pyhttplib_version }}"
+            echo "Using version from build job: $VER"
+          else
+            # Fall back to inferring from the sdist filename
+            SDIST=$(ls dist/*.tar.gz 2>/dev/null | head -n 1 || true)
+            if [ -z "$SDIST" ]; then
+              echo "No sdist found in dist/; cannot determine version" >&2
+              echo "skip_publish=true" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+            FNAME=$(basename "$SDIST")
+            VER=$(echo "$FNAME" | sed -E 's/^[Pp][Yy][Hh][Tt][Tt][Pp][Ll][Ii][Bb]-//; s/\.tar\.gz$//')
+          fi
+          echo "version=$VER" >> "$GITHUB_OUTPUT"
+          echo "Version to publish: $VER"
+
+          # Query PyPI for the version; 200 means it already exists.
+          STATUS=$(curl -s -o /dev/null -w "%{http_code}" "https://pypi.org/pypi/pyhttplib/$VER/json" || true)
+          if [ "$STATUS" = "200" ]; then
+            echo "Version $VER already exists on PyPI; skipping publish"
+            echo "skip_publish=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "skip_publish=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Clean dist directory
+        if: steps.check_pypi.outputs.skip_publish != 'true'
+        run: |
+          set -euo pipefail
+          rm -rf dist || true
+
+      - name: Retrieve release distributions
+        if: steps.check_pypi.outputs.skip_publish != 'true'
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Select latest artifact and prune others
+        if: steps.check_pypi.outputs.skip_publish != 'true'
+        run: |
+          set -euo pipefail
+          echo "Listing dist contents before selection:"
+          ls -l dist || true
+
+          # Find newest sdist by modification time
+          SDIST=$(ls -t dist/*.tar.gz 2>/dev/null | head -n 1 || true)
+          if [ -z "$SDIST" ]; then
+            echo "No sdist found in dist/; nothing to publish" >&2
+            ls -l dist || true
+            exit 1
+          fi
+
+          echo "Selected sdist: $SDIST"
+          FNAME=$(basename "$SDIST")
+          # Normalize project name prefix and strip .tar.gz to obtain version
+          VER=$(echo "$FNAME" | sed -E 's/^[Pp][Yy]?[Nn]?[Ee]?[Tt]?[Ss]?[Pp]?[Ll]?[Ii]?[Tt]-//; s/\.tar\.gz$//')
+          echo "Determined version: $VER"
+
+          # Remove other sdists not matching the selected version
+          for f in dist/*.tar.gz; do
+            if [ -f "$f" ] && [ "$f" != "$SDIST" ]; then
+              echo "Removing extra sdist: $f"
+              rm -f "$f"
+            fi
+          done
+
+          echo "dist/ contents after pruning:"
+          ls -l dist || true
+
+      - name: Prune wheels by METADATA Version
+        if: steps.check_pypi.outputs.skip_publish != 'true'
+        env:
+          SELECTED_VER: ${{ steps.check_pypi.outputs.version }}
+        run: |
+          set -euo pipefail
+          python scripts/prune_wheels.py
+
+      - name: Publish to PyPI (OIDC)
+        if: steps.check_pypi.outputs.skip_publish != 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

pyhttplib-0.0.0/.github/workflows/pytest.yml

@@ -0,0 +1,48 @@
+name: pytest
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pytest pytest-asyncio coverage codecov
+
+    - name: Run tests with coverage
+      run: |
+        python -m coverage run -m pytest
+        python -m coverage xml -o coverage.xml
+        python -m coverage report -m
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        # Upload the generated coverage.xml. For public repos a token is
+        # not required, but you can add CODECOV_TOKEN as a secret if needed.
+        files: ./coverage.xml
+        # Add a flag/name so uploads are easy to identify in Codecov UI
+        flags: unittests
+        name: pytest-coverage
+        # Do not fail the CI if upload to Codecov has an issue (helps debug badge problems)
+        fail_ci_if_error: false
+
+    - name: Show coverage.xml (first 40 lines)  # helps debug Codecov uploads
+      if: always()
+      run: |
+        echo '--- coverage.xml (preview) ---'
+        head -n 40 coverage.xml || true

pyhttplib-0.0.0/.gitignore

@@ -0,0 +1,12 @@
+examples/chat/users.json
+*.pyc
+*.pyd
+*__*
+*-info*
+dist
+*cache
+*.gz
+*.whl
+dist/
+*.egg-info/
+.coverage

pyhttplib-0.0.0/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+    "python.analysis.typeCheckingMode": "strict",
+    "python.REPL.enableREPLSmartSend": false,
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true,
+    "python.defaultInterpreterPath": "d:\\GitHub\\http\\.venv\\Scripts\\python.exe"
+}

pyhttplib-0.0.0/COPYING.md

@@ -0,0 +1,131 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

pyhttplib-0.0.0/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: pyhttplib
+Version: 0.0.0
+Summary: pyhttplib
+Home-page: https://github.com/Omena0/http
+Author: Omena0
+License: PolyForm Noncommercial 1.0.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: COPYING.md
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license-file
+Dynamic: summary
+
+
+# httplib
+
+[![pytest](https://github.com/Omena0/http/actions/workflows/pytest.yml/badge.svg)](https://github.com/Omena0/http/actions/workflows/pytest.yml)
+[![codecov](https://codecov.io/gh/Omena0/http/branch/master/graph/badge.svg?token=)](https://codecov.io/gh/Omena0/http)
+
+Simple, asynchronous, dependency-free, strictly-typed, fully docstringed HTTP server framework.
+
+## Example
+
+```py
+from typing import Any
+import httplib as app
+
+@app.route('/')
+async def index() -> Any:
+    return app.template('static/index.html')
+
+@app.route('/hello/<name>')
+async def hello(name: str) -> Any:
+    return f'<h1>Hello, {name}!'
+
+@app.error(404)
+async def not_found() -> Any:
+    return await app.template('static/404.html')
+
+app.serve('localhost')
+
+```

pyhttplib-0.0.0/README.md

@@ -0,0 +1,29 @@
+
+# httplib
+
+[![pytest](https://github.com/Omena0/http/actions/workflows/pytest.yml/badge.svg)](https://github.com/Omena0/http/actions/workflows/pytest.yml)
+[![codecov](https://codecov.io/gh/Omena0/http/branch/master/graph/badge.svg?token=)](https://codecov.io/gh/Omena0/http)
+
+Simple, asynchronous, dependency-free, strictly-typed, fully docstringed HTTP server framework.
+
+## Example
+
+```py
+from typing import Any
+import httplib as app
+
+@app.route('/')
+async def index() -> Any:
+    return app.template('static/index.html')
+
+@app.route('/hello/<name>')
+async def hello(name: str) -> Any:
+    return f'<h1>Hello, {name}!'
+
+@app.error(404)
+async def not_found() -> Any:
+    return await app.template('static/404.html')
+
+app.serve('localhost')
+
+```

pyhttplib-0.0.0/VERSION

@@ -0,0 +1 @@
+0.0.0