limits 5.4.0__tar.gz → 5.6.0__tar.gz

limits-5.6.0/.devcontainer/devcontainer.json

@@ -0,0 +1,28 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/python
+{
+	"name": "Python 3",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+	"workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind",
+	"workspaceFolder": "/workspace",
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	"features": {
+		"ghcr.io/devcontainers/features/docker-in-docker:2": {}
+	},
+	"mounts": [
+		"type=bind,source=${localEnv:HOME}${localEnv:USERPROFILE}/.ssh,target=${localEnv:HOME}${localEnv:USERPROFILE}/.ssh,readonly"
+	],
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	"postCreateCommand": "pip install --no-binary protobuf -r requirements/ci.txt"
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

limits-5.6.0/.gitattributes

@@ -0,0 +1,2 @@
+flask_ratelimits/_version.py export-subst
+limits/_version.py export-subst

limits-5.6.0/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: alisaifee
+open_collective: limits

limits-5.6.0/.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,39 @@
+---
+name: Bug Report
+about: Submit a bug report
+labels: 'bug'
+
+---
+
+<!--- Provide a general summary of the issue in the Title above -->
+
+## Expected Behaviour
+
+<!--- What should happen -->
+
+## Current Behaviour
+
+<!--- What happens instead of the expected behaviour -->
+
+## Steps to Reproduce
+
+<!---
+Provide a link to an example, or an unambiguous set of steps to
+reproduce this bug. Include code to reproduce, if relevant
+--->
+1.
+1.
+1.
+1.
+
+## Your Environment
+
+<!--- Include as many relevant details about the environment you experienced the bug in -->
+
+- limits version:
+- Operating system:
+
+<!--
+You can freely edit this text. Remove any lines you believe are unnecessary.
+-->
+

limits-5.6.0/.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,17 @@
+---
+name: Feature or Enhancement
+about: Propose a new feature or enhancement
+labels: 'enhancement'
+
+---
+
+<!--- Provide a general summary of the proposal in the Title above -->
+
+## Expected Behaviour
+
+<!--- How should this new feature work -->
+
+<!--
+You can freely edit this text. Remove any lines you believe are unnecessary.
+-->
+

limits-5.6.0/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "daily"

limits-5.6.0/.github/workflows/compatibility.yml

@@ -0,0 +1,71 @@
+name: Compatibility
+
+on:
+  push:
+    branches: ['master']
+    tags: ['*']
+  schedule:
+  - cron: 0 23 * * *
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        service_version: ["ALL_LATEST=true"]
+        async_redis_implementation: ["coredis"]
+        marker: [not integration]
+        include:
+          - service_version: "LIMITS_REDIS_SERVER_VERSION=8.0"
+            marker: "redis or redis_cluster or redis_sentinel"
+          - service_version: "LIMITS_REDIS_SERVER_VERSION=7.4"
+            marker: "redis or redis_cluster or redis_sentinel"
+          - service_version: "LIMITS_REDIS_SERVER_VERSION=7.2"
+            marker: "redis or redis_cluster or redis_sentinel"
+          - service_version: "LIMITS_REDIS_SERVER_VERSION=7.0"
+            marker: "redis or redis_cluster or redis_sentinel"
+          - service_version: "LIMITS_REDIS_SERVER_VERSION=7.4"
+            marker: "redis or redis_cluster or redis_sentinel"
+            async_redis_implementation: "redispy"
+          - service_version: "LIMITS_REDIS_SERVER_VERSION=7.2"
+            marker: "redis or redis_cluster or redis_sentinel"
+            async_redis_implementation: "redispy"
+          - service_version: "LIMITS_REDIS_SERVER_VERSION=7.0"
+            marker: "redis or redis_cluster or redis_sentinel"
+            async_redis_implementation: "redispy"
+          - service_version: "LIMITS_MONGODB_SERVER_VERSION=8.0"
+            marker: "mongodb"
+          - service_version: "LIMITS_MONGODB_SERVER_VERSION=7.0"
+            marker: "mongodb"
+          - service_version: "LIMITS_MONGODB_SERVER_VERSION=6.0"
+            marker: "mongodb"
+          - service_version: "LIMITS_MONGODB_SERVER_VERSION=5.0"
+            marker: "mongodb"
+          - service_version: "LIMITS_MEMCACHED_SERVER_VERSION=1.6.15"
+            marker: "memcached"
+          - service_version: "LIMITS_MEMCACHED_SERVER_VERSION=1.6.6"
+            marker: "memcached"
+          - service_version: "LIMITS_MEMCACHED_SERVER_VERSION=1.5.16"
+            marker: "memcached"
+          - service_version: "LIMITS_VALKEY_SERVER_VERSION=7.2"
+            marker: "valkey"
+          - service_version: "LIMITS_VALKEY_SERVER_VERSION=8.0"
+            marker: "valkey"
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
+    - name: Setup uv venv
+      run: |
+        uv sync --locked --all-extras --group ci
+    - name: Tests
+      env:
+        CI: "True"
+        ASYNC_REDIS_IMPLEMENTATION: "${{ matrix.async_redis_implementation }}"
+      run: |
+        eval "export ${{ matrix.service_version }}"
+        uv run py.test -m "${{ matrix.marker }} and not benchmark" --cov-report=xml --cov-branch --max-runs=3

limits-5.6.0/.github/workflows/main.yml

@@ -0,0 +1,262 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
+    - name: Setup uv venv
+      run: |
+        uv sync --locked --all-extras --group ci
+    - name: Lint with ruff
+      run: |
+        uv run ruff check --select I limits tests
+        uv run ruff format --check limits tests
+        uv run ruff check limits tests
+    - name: Check types
+      run: |
+        uv run mypy limits
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10"]
+        marker: [not (integration or benchmark)]
+        os: [ubuntu-latest]
+        async_redis_implementation: ["coredis"]
+        include:
+          - python-version: "3.10"
+            marker: 'not benchmark'
+            os: ubuntu-latest
+          - python-version: "3.11"
+            marker: 'not benchmark'
+            os: ubuntu-latest
+          - python-version: "3.12"
+            marker: 'not benchmark'
+            os: ubuntu-latest
+          - python-version: "3.12"
+            marker: 'not benchmark and (redis or redis_cluster or redis_sentinel) and asyncio'
+            os: ubuntu-latest
+            async_redis_implementation: "redispy"
+          - python-version: "3.13"
+            marker: 'not benchmark and (redis or redis_cluster or redis_sentinel) and asyncio'
+            os: ubuntu-latest
+            async_redis_implementation: "redispy"
+          - python-version: "3.12"
+            marker: 'not benchmark and (memcached and asyncio)'
+            os: ubuntu-latest
+            async_memcached_implementation: "emcache"
+          - python-version: "3.13"
+            marker: 'not benchmark'
+            os: ubuntu-latest
+    runs-on: "${{ matrix.os }}"
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
+    - name: Setup uv venv
+      run: |
+        uv sync --locked --all-extras --group ci
+    - name: Tests
+      env:
+        CI: "True"
+        ASYNC_REDIS_IMPLEMENTATION: "${{ matrix.async_redis_implementation }}"
+        ASYNC_MEMCACHED_IMPLEMENTATION: "${{ matrix.async_memcached_implementation }}"
+      run: |
+        uv run py.test -m "${{ matrix.marker }}" --junitxml=junit.xml -o junit_family=legacy --cov-branch --max-runs=3
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v5
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+    - name: Upload test results to Codecov
+      if: ${{ !cancelled() }}
+      uses: codecov/test-results-action@v1
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+
+  benchmark:
+    needs: [lint]
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+    env:
+      BRANCH_NAME: ${{ github.head_ref || github.ref_name }}
+      COMMIT: ${{ github.sha }}
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
+    - name: Setup uv venv
+      run: |
+        uv sync --locked --all-extras --group ci
+    - name: Set up Node
+      uses: actions/setup-node@v4
+    - name: Install dependencies
+      run: |
+        npm install -g netlify-cli
+    - name: Benchmark
+      env:
+        CI: "True"
+      run: |
+        mkdir -p benchmarks
+        uv run pytest -m "benchmark" --benchmark-json=benchmarks/full.json
+    - name: Split results
+      run: |
+        mv benchmarks/full.json benchmarks/full_raw.json
+        jq '.benchmarks |= map(. + {name: (.name | sub("^test_"; "")), fullname: (.fullname | sub("^.*::test_"; ""))})' benchmarks/full_raw.json > benchmarks/benchmark.json
+        jq '.benchmarks |= map(del(.stats.data))' benchmarks/benchmark.json > benchmarks/benchmark-summary.json
+        storages=("memory" "redis" "memcached" "mongodb");
+        for storage in "${storages[@]}"; do
+            cat benchmarks/benchmark.json | jq --arg storage "$storage" '.benchmarks |= map(select(.params.storage_type==$storage))' > benchmarks/benchmark-$storage.json
+            cat benchmarks/benchmark-summary.json | jq --arg storage "$storage" '.benchmarks |= map(select(.params.storage_type==$storage))' > benchmarks/benchmark-$storage-summary.json
+        done
+        rm benchmarks/full_raw.json
+    - name: Upload benchmark results
+      if: github.repository_owner == 'alisaifee' && github.event_name == 'push'
+      uses: actions/upload-artifact@v4
+      with:
+        name: benchmark
+        path: benchmarks/*
+    - name: Deploy to Netlify
+      if: github.repository_owner == 'alisaifee' && github.event_name == 'push'
+      env:
+        NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+      run: |
+        cp _netlify_headers benchmarks/_headers
+        netlify deploy --site ${{ secrets.NETLIFY_SITE_ID }} --alias $COMMIT --dir=benchmarks --message "Benchmarks for $COMMIT"
+        netlify deploy --site ${{ secrets.NETLIFY_SITE_ID }} --alias $BRANCH_NAME --dir=benchmarks --message "Benchmarks for $BRANCH_NAME"
+  build_wheels:
+    needs: [lint]
+    name: Build wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install uv and Python
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - name: Setup uv venv
+        run: |
+          uv sync --locked --all-extras --group ci
+      - name: Build wheels
+        run: |
+          uv build --wheel
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels
+          path: ./dist/*.whl
+  build_sdist:
+    needs: [lint]
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install uv and Python
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - name: Setup uv venv
+        run: |
+          uv sync --locked --all-extras --group ci
+      - name: Build sdist
+        run: |
+          uv build --sdist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: src_dist
+          path: dist/*.tar.gz
+  upload_pypi:
+    needs: [test, build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/master'
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: dist
+      - uses: actions/download-artifact@v4
+        with:
+          name: src_dist
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository_url: https://test.pypi.org/legacy/
+          skip_existing: true
+  upload_pypi_release:
+    needs: [test, benchmark, build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: dist
+      - uses: actions/download-artifact@v4
+        with:
+          name: src_dist
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+  github_release:
+    needs: [upload_pypi_release]
+    name: Create Release
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: dist
+      - name: Download source artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: src_dist
+          path: dist
+      - name: Download benchmark results
+        uses: actions/download-artifact@v4
+        with:
+          name: benchmark
+          path: benchmarks
+      - name: Generate release notes
+        run: |
+          ./scripts/github_release_notes.sh > release_notes.md
+      - name: Create Release
+        uses: ncipollo/release-action@v1
+        with:
+          artifacts: "dist/*,benchmarks/*"
+          bodyFile: release_notes.md
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+
+

limits-5.6.0/.gitignore

@@ -0,0 +1,15 @@
+*.pyc
+*.log
+limits/_version.py
+cover/*
+.mypy_cache/*
+.coverage*
+.test_env
+.tool-versions
+.idea
+build/
+dist/
+htmlcov
+*egg-info*
+.python-version
+.*.swp

limits-5.6.0/.readthedocs.yml

@@ -0,0 +1,12 @@
+version: 2
+build:
+  os: ubuntu-20.04
+  tools:
+    python: "3.13"
+  commands:
+    - pip install uv
+    - cd doc
+    - uv run --group docs python -m sphinx doc/source $READTHEDOCS_OUTPUT/html -b html
+
+sphinx:
+   configuration: doc/source/conf.py

limits-5.6.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

{limits-5.4.0 → limits-5.6.0}/HISTORY.rst

@@ -3,6 +3,27 @@
 Changelog
 =========
 
+v5.6.0
+------
+Release Date: 2025-09-29
+
+* Development
+
+  * Move all project metadata to pyproject
+  * Use uv for development
+  * Use hatch for package build
+  * Remove versioneer for versioning
+
+v5.5.0
+------
+Release Date: 2025-08-05
+
+* Compatibility
+
+  * Relax upper bound of ``packaging`` requirement
+  * Increase upper bound of ``coredis`` requirement
+  * Increase upper bound of ``redis`` requirement
+
 v5.4.0
 ------
 Release Date: 2025-06-16
@@ -877,3 +898,5 @@ Release Date: 2015-01-08
 
 
 
+
+

{limits-5.4.0 → limits-5.6.0}/MANIFEST.in

@@ -3,12 +3,7 @@ include LICENSE.txt
 include HISTORY.rst
 include CONTRIBUTIONS.rst
 include CLASSIFIERS
-include versioneer.py
-recursive-include requirements *.txt
-recursive-include requirements/storage *.txt
 recursive-include doc/source *
 recursive-include doc *.py Make*
-include limits/_version.py
-include limits/py.typed
 recursive-include limits *.lua
 recursive-include limits/resources *

limits-5.6.0/Makefile

@@ -0,0 +1,11 @@
+lint:
+	uv run ruff check --select I limits tests doc
+	uv run ruff check limits tests doc
+	uv run ruff format --check limits tests doc
+	uv run mypy limits
+
+lint-fix:
+	uv run ruff check --select I --fix limits tests doc
+	uv run ruff check --fix limits tests doc
+	uv run ruff format limits tests doc
+	uv run mypy limits