limits 4.5__tar.gz → 4.7__tar.gz

{limits-4.5 → limits-4.7}/HISTORY.rst

@@ -3,6 +3,23 @@
 Changelog
 =========
 
+v4.7
+----
+Release Date: 2025-04-08
+
+* Documentation
+
+  * Add benchmarking results in documentation
+
+v4.6
+----
+Release Date: 2025-04-03
+
+* Bug Fix
+
+  * Ensure mongo clients are closed on storage destruction.
+    `Issue 264 <https://github.com/alisaifee/limits/issues/264>`_
+
 v4.5
 ----
 Release Date: 2025-04-03
@@ -835,6 +852,8 @@ Release Date: 2015-01-08
 
 
 
+
+
 
 
 

{limits-4.5 → limits-4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: limits
-Version: 4.5
+Version: 4.7
 Summary: Rate limiting utilities
 Home-page: https://limits.readthedocs.org
 Author: Ali-Akber Saifee

{limits-4.5 → limits-4.7}/doc/source/conf.py

@@ -2,6 +2,11 @@
 
 import os
 import sys
+from pathlib import Path
+
+from docutils import nodes
+from sphinx.application import Sphinx
+from sphinx.util.docutils import SphinxDirective
 
 sys.path.insert(0, os.path.abspath("../../"))
 sys.path.insert(0, os.path.abspath("./"))
@@ -13,6 +18,7 @@ import limits
 project = "limits"
 description = "limits is a python library to perform rate limiting with commonly used storage backends"
 copyright = "2023, Ali-Akber Saifee"
+
 if ".post0.dev" in limits.__version__:
     version, ahead = limits.__version__.split(".post0.dev")
 else:
@@ -20,7 +26,22 @@ else:
 
 release = version
 
-html_static_path = ["./_static"]
+
+if branch_from_env := os.environ.get("READTHEDOCS_VERSION", None):
+    benchmark_git_context = {
+        "branch": branch_from_env,
+        "sha": os.environ.get("READTHEDOCS_GIT_COMMIT_HASH", "")
+    }
+else:
+    import limits._version
+    git_info = limits._version.git_pieces_from_vcs("", os.path.abspath("../../"), False)
+    benchmark_git_context = {
+        "branch": git_info.get("branch", ""),
+        "sha": git_info.get("long", None)
+    }
+
+html_static_path = ["_static"]
+
 html_css_files = [
     "custom.css",
     "https://fonts.googleapis.com/css2?family=Fira+Code:wght@300;400;700&family=Fira+Sans:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap",
@@ -38,6 +59,7 @@ try:
         html_title = f"{project} <small><b style='color: var(--color-brand-primary)'>{{dev}}</b></small>"
 except:
     pass
+sys.path.append(str(Path('ext').resolve()))
 
 extensions = [
     "sphinx.ext.autodoc",
@@ -53,6 +75,7 @@ extensions = [
     "sphinx_copybutton",
     "sphinx_inline_tabs",
     "sphinx_paramlinks",
+    "bench_chart",
 ]
 
 autodoc_default_options = {
@@ -70,6 +93,8 @@ autosectionlabel_prefix_document = True
 
 extlinks = {"pypi": ("https://pypi.org/project/%s", "%s")}
 
+copybutton_exclude = '.gp, .go'
+
 intersphinx_mapping = {
     "python": ("http://docs.python.org/", None),
     "coredis": ("https://coredis.readthedocs.io/en/latest/", None),

limits-4.7/doc/source/ext/_static/benchmark-chart.css

@@ -0,0 +1,10 @@
+.benchmark-chart {
+    width: 100%;
+}
+.benchmark-details{
+    .benchmark-details-section {
+       thead > tr {
+           color: var(--color-purple);
+       }
+    }
+}

limits-4.7/doc/source/ext/_static/js/benchmark-chart.js

@@ -0,0 +1,194 @@
+const KNOWN_PARAMS = ["storage_type", "limit", "strategy", "async"];
+
+function getBenchmarkData(result, query) {
+  let benchmarks = result.benchmarks;
+  return benchmarks.filter(function (benchmark) {
+    let okay = true;
+    if (query) {
+      Object.entries(query).forEach((entry) => {
+        if (entry[0] != "group" && benchmark.params[entry[0]] != entry[1]) {
+          okay = false;
+        }
+        if (entry[0] == "group" && entry[1] != benchmark.group) {
+          okay = false;
+        }
+      });
+    }
+    return okay;
+  });
+}
+
+function formatRateLimit(str) {
+  var m = str.match(/(\d+(?:\.\d+)?)\s+per\s+1\s+(\w+)/i);
+  if (!m) return str;
+  var n = parseFloat(m[1]),
+    u = m[2].toLowerCase(),
+    num =
+      n >= 1000
+        ? (n / 1000) % 1 === 0
+          ? n / 1000 + "K"
+          : (n / 1000).toFixed(1) + "K"
+        : n.toString(),
+    umap = {
+      second: "s",
+      seconds: "s",
+      minute: "min",
+      minutes: "mins",
+      hour: "hr",
+      hours: "hr",
+      day: "day",
+      days: "day",
+    };
+  return num + "/" + (umap[u] || u);
+}
+
+function nameTransform(benchmark, stripParams, query) {
+  let name = benchmark.name;
+  params = benchmark.params;
+  name = name
+    .replace(/\[.*?\]/, "")
+    .replace("_async", "")
+    .replaceAll("_", "-");
+  name = name.replace(benchmark.group, "");
+  let queryParam = Object.entries(query).map((entry) => entry[0]);
+  let additional = getRemainingGroups(benchmark, query);
+  Object.entries(additional).forEach((param) => {
+    let value = param[1];
+    if (param[0] === "limit") {
+      value = formatRateLimit(value);
+    }
+    if (name) {
+      name += ` - ${value}`;
+    } else {
+      name = `${value}`;
+    }
+  });
+  return name;
+}
+
+function getRemainingGroups(benchmark, query) {
+  let queryParam = Object.entries(query).map((entry) => entry[0]);
+  let additional = {};
+  Object.entries(benchmark.params).forEach((param) => {
+    if (!queryParam.includes(param[0]) && KNOWN_PARAMS.includes(param[0])) {
+      additional[param[0]] = param[1];
+    }
+  });
+  return additional;
+}
+
+function getColorForStorage(storageType) {
+  const storageColorMap = {
+    memory: window
+      .getComputedStyle(document.body)
+      .getPropertyValue("--color-purple"),
+    mongodb: window
+      .getComputedStyle(document.body)
+      .getPropertyValue("--color-yellow"),
+    memcached: window
+      .getComputedStyle(document.body)
+      .getPropertyValue("--color-aqua"),
+    redis: window
+      .getComputedStyle(document.body)
+      .getPropertyValue("--color-red"),
+  };
+
+  // Fallback color if an unknown storageType appears
+  return storageColorMap[storageType] || "#7f7f7f"; // gray
+}
+
+function sortBenchmarksByParams(benchmarks, sortKeys) {
+  return benchmarks.sort((a, b) => {
+    for (const key of sortKeys) {
+      let valA = (a.params?.[key] || "").toLowerCase();
+      let valB = (b.params?.[key] || "").toLowerCase();
+      if (key == "limit") {
+        valA = parseInt(valA.split(" ")[0]);
+        valB = parseInt(valB.split(" ")[0]);
+      }
+      return valA < valB ? -1 : valA > valB ? 1 : 0;
+    }
+
+    return a.name.localeCompare(b.name);
+  });
+}
+function sortBenchmarksByParams(benchmarks, sortKeys) {
+  return benchmarks.sort(function (a, b) {
+    for (const key of sortKeys) {
+      let valA = (a.params?.[key] || "").toLowerCase();
+      let valB = (b.params?.[key] || "").toLowerCase();
+      if (key === "limit") {
+        valA = parseInt(valA.split(" ")[0], 10);
+        valB = parseInt(valB.split(" ")[0], 10);
+      }
+      if (valA < valB) return -1;
+      if (valA > valB) return 1;
+    }
+    return a.name.localeCompare(b.name);
+  });
+}
+let dispatched = new Set();
+
+document.addEventListener("DOMContentLoaded", function () {
+  const charts = document.querySelectorAll(".benchmark-chart");
+  charts.forEach((chart) => {
+    let source = chart.dataset.source;
+    let filters = JSON.parse(chart.dataset.filters);
+    let query = JSON.parse(chart.dataset.query);
+    let sortBy = JSON.parse(
+      chart.dataset.sortBy || '["storage_type", "limit"]',
+    );
+    if (!dispatched.has(source)) {
+      fetchBenchmarkData(`${source}.json`).then((result) => {
+        window.Benchmarks[source] = result;
+        event = new Event(`${source}-loaded`);
+        window.dispatchEvent(event);
+      });
+    }
+    dispatched.add(source);
+    window.addEventListener(`${chart.dataset.source}-loaded`, function () {
+      let results = Benchmarks[chart.dataset.source];
+      let unsorted = getBenchmarkData(results, query);
+      let data = sortBenchmarksByParams(
+        getBenchmarkData(results, query),
+        sortBy,
+      );
+
+      const layout = {
+        yaxis: {
+          title: { text: "Time (ms)" },
+          exponentformat: "none",
+          ticksuffix: " ms",
+          tickformat: ",.2f",
+        },
+      };
+      Plotly.newPlot(
+        chart,
+        data.map(function (benchmark) {
+          let item = {
+            type: "box",
+            name: nameTransform(benchmark, true, query),
+            y: benchmark.stats.data || [
+              benchmark.stats.min * 1e3,
+              benchmark.stats.q1 * 1e3,
+              benchmark.stats.median * 1e3,
+              benchmark.stats.q3 * 1e3,
+              benchmark.stats.max * 1e3,
+            ],
+            boxmean: true,
+            boxpoints: false,
+            line: { width: 1 },
+            marker: {
+              color: getColorForStorage(benchmark.params.storage_type),
+            },
+            showlegend: true,
+            legendgroup: benchmark.params.storage_type,
+            legendgrouptitle: { text: benchmark.params.storage_type },
+          };
+          return item;
+        }),
+        layout,
+      );
+    });
+  });
+});

limits-4.7/doc/source/ext/_static/js/benchmark-details.js

@@ -0,0 +1,87 @@
+import { render, html } from "https://unpkg.com/uhtml@3.2.1?module";
+document.addEventListener("DOMContentLoaded", function () {
+  const details = document.querySelectorAll(".benchmark-details");
+  details.forEach((detail) => {
+    let source = detail.dataset.source;
+    if (!dispatched.has(source)) {
+      fetchBenchmarkData(`${source}.json`).then((result) => {
+        window.Benchmarks[source] = result;
+        event = new Event(`${source}-loaded`);
+        window.dispatchEvent(event);
+      });
+    }
+    dispatched.add(source);
+    window.addEventListener(`${detail.dataset.source}-loaded`, function () {
+      const machine_info = window.Benchmarks[source].machine_info;
+      const commit_info = window.Benchmarks[source].commit_info;
+      const cpu = window.Benchmarks[source].machine_info.cpu;
+      console.log(machine_info);
+      render(
+        detail,
+        html`
+          <table class="benchmark-details-section">
+            <thead>
+              <tr>
+                <th>Machine Information</th>
+              </tr>
+            </thead>
+            <tbody>
+              <tr>
+                <td>Operating System</td>
+                <td>${machine_info.system} (${machine_info.release})</td>
+              </tr>
+              <tr>
+                <td>CPU</td>
+                <td>
+                  ${cpu.brand_raw} ${cpu.processor} @ ${cpu.hz_actual_friendly}
+                </td>
+              </tr>
+              <tr>
+                <td>Python</td>
+                <td>${machine_info.python_version}</td>
+              </tr>
+            </tbody>
+          </table>
+          <table class="benchmark-details-section">
+            <thead>
+              <tr>
+                <th>Source Information</th>
+              </tr>
+            </thead>
+            <tbody>
+              <tr>
+                <td>Branch</td>
+                <td>${commit_info.branch}</td>
+              </tr>
+              <tr>
+                <td>Commit Hash</td>
+                <td>${commit_info.id}</td>
+              </tr>
+            </tbody>
+          </table>
+          <table class="benchmark-details-section">
+            <thead>
+              <tr>
+                <th>Storage Information</th>
+              </tr>
+            </thead>
+            <tbody>
+              <tr>
+                <td>Redis</td>
+                <td>${machine_info.redis.redis_version}</td>
+              </tr>
+              <tr>
+                <td>Memcached</td>
+                <td>${machine_info.memcached.version}</td>
+              </tr>
+              <tr>
+                <td>MongoDB</td>
+                <td>${machine_info.mongodb.version}</td>
+              </tr>
+            </tbody>
+          </table>
+        `,
+      );
+    });
+  });
+});

limits-4.7/doc/source/ext/_static/js/benchmark-loader.js

@@ -0,0 +1,32 @@
+const BENCHMARK_PATHS = [
+  `https://${GITSHA}--py-limits.netlify.app/`,
+  `https://${GITBRANCH}--py-limits.netlify.app/`,
+];
+
+window.Benchmarks = new Map();
+
+function fetchBenchmarkData(filename) {
+  let attempts = 0;
+
+  function tryFetch() {
+    if (attempts >= BENCHMARK_PATHS.length) {
+      return Promise.reject("All fetch attempts failed.");
+    }
+
+    const base = BENCHMARK_PATHS[attempts++];
+    const url = base + filename;
+
+    // First send a HEAD request to quietly check existence
+    return fetch(url, { method: "HEAD" })
+      .then((headRes) => {
+        if (!headRes.ok) throw new Error("HEAD check failed");
+        return fetch(url).then((res) => {
+          if (!res.ok) throw new Error(`GET failed from ${url}`);
+          return res.json();
+        });
+      })
+      .catch(() => tryFetch());
+  }
+
+  return tryFetch();
+}

limits-4.7/doc/source/ext/_templates/git_info.js

@@ -0,0 +1,2 @@
+window.GITBRANCH = "{{branch}}";
+window.GITSHA = "{{sha}}";

limits-4.7/doc/source/ext/bench_chart.py

@@ -0,0 +1,128 @@
+from __future__ import annotations
+
+import json
+import os
+from typing import TYPE_CHECKING
+
+from docutils import nodes
+from sphinx.util.docutils import SphinxDirective
+from sphinx.util.osutil import ensuredir
+
+if TYPE_CHECKING:
+    from sphinx.application import Sphinx
+
+here = os.path.dirname(os.path.abspath(__file__))
+
+def check_bool(value):
+    if value.lower() in ["true", "false"]:
+        return value.lower() == "true"
+    return value
+
+def query(argument):
+    if not argument.strip():
+        return {}
+    queries = {}
+    for query in argument.strip().split(","):
+        key, value = query.split("=")
+        queries[key] = check_bool(value)
+    return queries
+
+def filters(argument):
+    filters: dict[str, list|bool] = {}
+    for filter in argument.strip().split(","):
+        if ":" in filter:
+            source, value = filter.split(":")
+            filters.setdefault(source, []).append(value)
+        else:
+            filters[filter] = True
+    return filters
+
+def sortBy(argument):
+    return [k.strip() for k in argument.split(",")] if argument else []
+
+class BenchmarkDetails(SphinxDirective):
+    required_arguments = 0
+    final_argument_whitespace = False
+    option_spec = {
+        "source": str,
+    }
+    has_content = False
+    def run(self):
+        source = self.options.get("source", "benchmark-summary")
+        html = f"""
+                <div
+                    class='benchmark-details'
+                    data-source='{source}'
+                </div>
+                """
+
+        return [nodes.raw("", html, format="html")]
+
+class BenchmarkChart(SphinxDirective):
+    required_arguments = 0
+    final_argument_whitespace = False
+    option_spec = {
+        "source": str,
+        "query": query,
+        "filters": filters,
+        "sort": sortBy,
+    }
+    has_content = False
+    def run(self):
+        source = self.options.get("source", "benchmark-summary")
+        filters = self.options.get("filters", ["group"])
+        query = self.options.get("query", {})
+        sortBy = self.options.get("sort", [])
+
+        html = f"""
+                <div
+                    class='benchmark-chart'
+                    data-source='{source}'
+                    data-filters='{json.dumps(filters)}'
+                    data-query='{json.dumps(query)}'
+                    data-sortBy='{json.dumps(sortBy)}'>
+                </div>
+                """
+
+        return [nodes.raw("", html, format="html")]
+
+def render_js_template(app) -> None:
+    context = {
+        "branch": app.config.benchmark_git_context.get("branch", ""),
+        "sha": app.config.benchmark_git_context.get("sha", ""),
+    }
+
+    template = app.builder.templates.environment.get_template("git_info.js")
+    rendered_js = template.render(context)
+
+    out_dir = os.path.join(app.outdir, "_static", "js")
+    ensuredir(out_dir)
+    out_path = os.path.join(out_dir, "git_info.js")
+
+    with open(out_path, "w", encoding="utf-8") as f:
+        f.write(rendered_js)
+    app.add_js_file("js/git_info.js")
+
+def setup(app: Sphinx):
+    app.add_directive("benchmark-chart", BenchmarkChart)
+    app.add_directive("benchmark-details", BenchmarkDetails)
+    app.add_config_value("benchmark_git_context", default={}, rebuild="env")
+    def add_assets(app, env) -> None:
+        static_path = os.path.join(here, "_static")
+        if static_path not in app.config.html_static_path:
+            app.config.html_static_path.append(static_path)
+        app.add_js_file("js/benchmark-chart.js")
+        app.add_js_file("js/benchmark-details.js", type="module")
+        app.add_js_file("js/benchmark-loader.js")
+        app.add_js_file("https://cdn.plot.ly/plotly-3.0.1.min.js")
+        app.add_css_file("benchmark-chart.css")
+    app.config.templates_path += [os.path.join(here, "_templates")]
+    app.connect("env-updated", add_assets)
+    app.connect("builder-inited", render_js_template)
+
+    return {
+        "version": "0.1",
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+
+    }

{limits-4.5 → limits-4.7}/doc/source/index.rst

@@ -37,6 +37,7 @@ For an overview of supported backends refer to :ref:`storage:storage backends`.
     quickstart
     strategies
     storage
+    performance
     async
     api
     custom-storage

limits-4.7/doc/source/performance.rst

@@ -0,0 +1,221 @@
+Performance
+===========
+
+The performance of each rate-limiting strategy and storage backend
+differs in both throughput and storage cost characteristics.
+
+Performance by storage and strategy
+-----------------------------------
+Below you will find benchmarks for each strategy and storage when using
+a rate limit of ``500/minute``. (For details about the benchmarking environment
+please refer to :ref:`performance:benchmark run details`).
+
+
+.. tab:: Hit
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: limit=500 per 1 minute,group=hit,async=false
+       :sort: storage_type,strategy
+
+
+.. tab:: Hit (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: limit=500 per 1 minute,group=hit,async=true
+       :sort: storage_type,strategy
+
+
+
+.. tab:: Test
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: limit=500 per 1 minute,group=test,async=false
+       :sort: storage_type,strategy
+
+
+.. tab:: Test (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: limit=500 per 1 minute,group=test,async=true
+       :sort: storage_type,strategy
+
+
+
+.. tab:: Get Window Stats
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: limit=500 per 1 minute,group=get-window-stats,async=false
+       :sort: storage_type,strategy
+
+
+.. tab:: Get Window Stats (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: limit=500 per 1 minute,group=get-window-stats,async=true
+       :sort: storage_type,strategy
+
+
+Performance implication of limit sizes
+--------------------------------------
+
+Though for :ref:`strategies:fixed window` and :ref:`strategies:sliding window counter` both the
+storage cost and performance of operations remains constant when the limit window and size varies,
+this is not true for :ref:`strategies:moving window` which maintains a complete log of successful
+requests within the window.
+
+The following benchmarks demonstrate the implications when using various limits.
+
+Fixed Window
+~~~~~~~~~~~~
+
+.. tab::  Hit
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=hit,strategy=fixed-window
+       :sort: storage_type,limit
+
+
+.. tab::  Hit (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=hit,strategy=fixed-window
+       :sort: storage_type,limit
+
+
+.. tab:: Test
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=test,strategy=fixed-window
+       :sort: storage_type,limit
+
+
+.. tab:: Test (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=test,strategy=fixed-window
+       :sort: storage_type,limit
+
+
+.. tab:: Get Window Stats
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=get-window-stats,strategy=fixed-window
+       :sort: storage_type,limit
+
+.. tab:: Get Window Stats (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=get-window-stats,strategy=fixed-window
+       :sort: storage_type,limit
+
+Moving Window
+~~~~~~~~~~~~~
+
+.. tab:: Hit
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=hit,strategy=moving-window
+       :sort: storage_type,limit
+
+.. tab:: Hit (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=hit,strategy=moving-window
+       :sort: storage_type,limit
+
+
+.. tab:: Test
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=test,strategy=moving-window
+       :sort: storage_type,limit
+
+.. tab:: Test (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=test,strategy=moving-window
+       :sort: storage_type,limit
+
+
+.. tab:: Get Window Stats
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=get-window-stats,strategy=moving-window
+       :sort: storage_type,limit
+
+.. tab:: Get Window Stats (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=get-window-stats,strategy=moving-window
+       :sort: storage_type,limit
+
+
+Sliding Window
+~~~~~~~~~~~~~~
+
+.. tab:: Hit
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=hit,strategy=sliding-window
+       :sort: storage_type,limit
+
+.. tab:: Hit (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=hit,strategy=sliding-window
+       :sort: storage_type,limit
+
+.. tab:: Test
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=test,strategy=sliding-window
+       :sort: storage_type,limit
+
+.. tab:: Test (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=test,strategy=sliding-window
+       :sort: storage_type,limit
+
+
+.. tab:: Get Window Stats
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=false,group=get-window-stats,strategy=sliding-window
+       :sort: storage_type,limit
+
+.. tab:: Get Window (Async)
+
+    .. benchmark-chart::
+       :source: benchmark-summary
+       :query: async=true,group=get-window-stats,strategy=sliding-window
+       :sort: storage_type,limit
+
+
+Benchmark run details
+---------------------
+.. benchmark-details::
+   :source: benchmark-summary

{limits-4.5 → limits-4.7}/doc/source/theme_config.py

@@ -33,6 +33,15 @@ html_theme_options = {
         "font-stack--monospace": "Fira Code, monospace",
         "color-brand-primary": colors["purple2"],
         "color-brand-content": colors["blue2"],
+        "color-bg": colors["bg2"],
+        "color-fg": colors["fg2"],
+        "color-red": colors["red2"],
+        "color-orange": colors["orange2"],
+        "color-yellow": colors["yellow2"],
+        "color-green": colors["green2"],
+        "color-aqua": colors["aqua2"],
+        "color-blue": colors["blue2"],
+        "color-purple": colors["purple2"],
     },
     "dark_css_variables": {
         "color-brand-primary": colors["purple"],
@@ -43,6 +52,15 @@ html_theme_options = {
         "color-foreground-secondary": colors["bg1"],
         "color-highlighted-background": colors["yellow"],
         "color-highlight-on-target": colors["fg2"],
+        "color-bg": colors["fg1"],
+        "color-fg": colors["bg0"],
+        "color-red": colors["red"],
+        "color-orange": colors["orange"],
+        "color-yellow": colors["yellow"],
+        "color-green": colors["green"],
+        "color-aqua": colors["aqua"],
+        "color-blue": colors["blue"],
+        "color-purple": colors["purple"],
     },
 }
 

{limits-4.5 → limits-4.7}/limits/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2025-04-03T09:10:26-0700",
+ "date": "2025-04-08T13:37:22-0700",
  "dirty": false,
  "error": null,
- "full-revisionid": "600e96abcf2692e49909b8cf6ca19fc0ee3b2ac3",
- "version": "4.5"
+ "full-revisionid": "c20794b223ba2e7984ecf12c4395c092aadcad88",
+ "version": "4.7"
 }
 '''  # END VERSION_JSON
 

{limits-4.5 → limits-4.7}/limits/aio/storage/mongodb.py

@@ -517,3 +517,6 @@ class MongoDBStorage(Storage, MovingWindowSupport, SlidingWindowCounterSupport):
                 current_ttl,
             )
         return 0, 0.0, 0, 0.0
+
+    def __del__(self) -> None:
+        self.storage and self.storage.close()

{limits-4.5 → limits-4.7}/limits/storage/mongodb.py

@@ -479,6 +479,10 @@ class MongoDBStorageBase(
         )
         return cast(bool, result["_acquired"])
 
+    def __del__(self) -> None:
+        if self.storage:
+            self.storage.close()
+
 
 @versionadded(version="2.1")
 @versionchanged(

{limits-4.5 → limits-4.7}/limits.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: limits
-Version: 4.5
+Version: 4.7
 Summary: Rate limiting utilities
 Home-page: https://limits.readthedocs.org
 Author: Ali-Akber Saifee

{limits-4.5 → limits-4.7}/limits.egg-info/SOURCES.txt

@@ -16,11 +16,18 @@ doc/source/conf.py
 doc/source/custom-storage.rst
 doc/source/index.rst
 doc/source/installation.rst
+doc/source/performance.rst
 doc/source/quickstart.rst
 doc/source/storage.rst
 doc/source/strategies.rst
 doc/source/theme_config.py
 doc/source/_static/custom.css
+doc/source/ext/bench_chart.py
+doc/source/ext/_static/benchmark-chart.css
+doc/source/ext/_static/js/benchmark-chart.js
+doc/source/ext/_static/js/benchmark-details.js
+doc/source/ext/_static/js/benchmark-loader.js
+doc/source/ext/_templates/git_info.js
 limits/__init__.py
 limits/_version.py
 limits/errors.py