locust 2.29.2.dev32__tar.gz → 2.29.2.dev42__tar.gz

{locust-2.29.2.dev32 → locust-2.29.2.dev42}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.1
 Name: locust
-Version: 2.29.2.dev32
+Version: 2.29.2.dev42
 Summary: Developer-friendly load testing framework
+Home-page: https://locust.io/
 License: MIT
-Project-URL: Homepage, https://github.com/locustio/locust
-Project-URL: Documentation, https://docs.locust.io/
-Project-URL: Code, https://github.com/locustio/locust
-Project-URL: Help/Questions, https://stackoverflow.com/questions/tagged/locust
-Project-URL: Issue tracker, https://github.com/locustio/locust/issues
-Classifier: Topic :: Software Development :: Testing :: Traffic Generation
+Author: Jonatan Heyman
+Maintainer: Lars Holmberg
+Requires-Python: >=3.9
 Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
@@ -18,29 +18,32 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Testing :: Traffic Generation
 Classifier: Topic :: System :: Distributed Computing
-Requires-Python: >=3.9
+Requires-Dist: ConfigArgParse (>=1.5.5)
+Requires-Dist: Flask-Cors (>=3.0.10)
+Requires-Dist: Flask-Login (>=0.6.3)
+Requires-Dist: Werkzeug (>=2.0.0)
+Requires-Dist: flask (>=2.0.0)
+Requires-Dist: gevent (>=22.10.2)
+Requires-Dist: geventhttpclient (>=2.3.1)
+Requires-Dist: msgpack (>=1.0.0)
+Requires-Dist: psutil (>=5.9.1)
+Requires-Dist: pywin32 ; sys_platform == "win32"
+Requires-Dist: pyzmq (>=25.0.0)
+Requires-Dist: requests (>=2.26.0) ; python_full_version <= "3.11.0"
+Requires-Dist: requests (>=2.32.2) ; python_full_version > "3.11.0"
+Requires-Dist: tomli (>=1.1.0) ; python_version < "3.11"
+Requires-Dist: typing_extensions (>=4.6.0) ; python_version < "3.11"
+Project-URL: Documentation, https://docs.locust.io/
+Project-URL: Help/Questions, https://github.com/orgs/locustio/discussions/
+Project-URL: Issue Tracker, https://github.com/locustio/locust/issues
+Project-URL: Repository, https://github.com/locustio/locust
+Project-URL: Stack Overflow, https://stackoverflow.com/questions/tagged/locust
+Project-URL: Slack, https://locustio.slack.com/
+Project-URL: Slack/Signup, https://communityinviter.com/apps/locustio/locust
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: gevent>=22.10.2
-Requires-Dist: flask>=2.0.0
-Requires-Dist: Werkzeug>=2.0.0
-Requires-Dist: requests>=2.26.0
-Requires-Dist: requests>=2.32.2; python_version > "3.11"
-Requires-Dist: msgpack>=1.0.0
-Requires-Dist: pyzmq>=25.0.0
-Requires-Dist: geventhttpclient>=2.3.1
-Requires-Dist: ConfigArgParse>=1.5.5
-Requires-Dist: tomli>=1.1.0; python_version < "3.11"
-Requires-Dist: typing_extensions>=4.6.0; python_version < "3.11"
-Requires-Dist: psutil>=5.9.1
-Requires-Dist: Flask-Login>=0.6.3
-Requires-Dist: Flask-Cors>=3.0.10
-Requires-Dist: pywin32; platform_system == "Windows"
 
 # Locust
 
@@ -112,6 +115,7 @@ Locust's code base is intentionally kept small and doesn't solve everything out
 
 * Documentation: [docs.locust.io](https://docs.locust.io)
 * Support/Questions: [StackOverflow](https://stackoverflow.com/questions/tagged/locust)
+* Github Discussions: [Github Discussions](https://github.com/orgs/locustio/discussions)
 * Chat/discussion: [Slack](https://locustio.slack.com) [(signup)](https://communityinviter.com/apps/locustio/locust)
 
 ## Authors
@@ -124,3 +128,4 @@ Locust's code base is intentionally kept small and doesn't solve everything out
 ## License
 
 Open source licensed under the MIT license (see _LICENSE_ file for details).
+

{locust-2.29.2.dev32 → locust-2.29.2.dev42}/README.md

@@ -68,6 +68,7 @@ Locust's code base is intentionally kept small and doesn't solve everything out
 
 * Documentation: [docs.locust.io](https://docs.locust.io)
 * Support/Questions: [StackOverflow](https://stackoverflow.com/questions/tagged/locust)
+* Github Discussions: [Github Discussions](https://github.com/orgs/locustio/discussions)
 * Chat/discussion: [Slack](https://locustio.slack.com) [(signup)](https://communityinviter.com/apps/locustio/locust)
 
 ## Authors

{locust-2.29.2.dev32 → locust-2.29.2.dev42}/locust/_version.py

@@ -3,6 +3,7 @@
 TYPE_CHECKING = False
 if TYPE_CHECKING:
     from typing import Tuple, Union
+
     VERSION_TUPLE = Tuple[Union[int, str], ...]
 else:
     VERSION_TUPLE = object
@@ -12,5 +13,8 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.29.2.dev32'
-__version_tuple__ = version_tuple = (2, 29, 2, 'dev32')
+
+__version__ = "2.29.2.dev42"
+version = __version__
+__version_tuple__ = (2, 29, 2, "dev42")
+version_tuple = __version_tuple__

{locust-2.29.2.dev32 → locust-2.29.2.dev42}/locust/contrib/fasthttp.py

@@ -483,7 +483,7 @@ class FastResponse(CompatResponse):
 
     _response: HTTPSocketPoolResponse | None = None
 
-    encoding: str | None = None
+    encoding: str | float | None = None
     """In some cases setting the encoding explicitly is needed. If so, do it before calling .text"""
 
     request: FastRequest | None = None

{locust-2.29.2.dev32 → locust-2.29.2.dev42}/locust/dispatch.py

@@ -90,13 +90,13 @@ class UsersDispatcher(Iterator):
         assert len(user_classes) > 0
         assert len(set(self._user_classes)) == len(self._user_classes)
 
-        self._target_user_count: int = None
+        self._target_user_count: int = 0
 
-        self._spawn_rate: float = None
+        self._spawn_rate: float = 0.0
 
-        self._user_count_per_dispatch_iteration: int = None
+        self._user_count_per_dispatch_iteration: int = 0
 
-        self._wait_between_dispatch: float = None
+        self._wait_between_dispatch: float = 0.0
 
         self._initial_users_on_workers = {
             worker_node.id: {user_class.__name__: 0 for user_class in self._user_classes}
@@ -107,7 +107,8 @@ class UsersDispatcher(Iterator):
 
         self._current_user_count = self.get_current_user_count()
 
-        self._dispatcher_generator: Generator[dict[str, dict[str, int]], None, None] = None
+        self._dispatcher_generator: Generator[dict[str, dict[str, int]], None, None] = None  # type: ignore
+        # a generator is assigned (in new_dispatch()) to _dispatcher_generator before it's used
 
         self._user_generator = self._user_gen()
 
@@ -131,7 +132,7 @@ class UsersDispatcher(Iterator):
         return sum(map(sum, map(dict.values, self._users_on_workers.values())))
 
     @property
-    def dispatch_in_progress(self):
+    def dispatch_in_progress(self) -> bool:
         return self._dispatch_in_progress
 
     @property

{locust-2.29.2.dev32 → locust-2.29.2.dev42}/locust/stats.py

@@ -9,25 +9,12 @@ import signal
 import time
 from abc import abstractmethod
 from collections import OrderedDict, defaultdict, namedtuple
-from collections import (
-    OrderedDict as OrderedDictType,
-)
 from collections.abc import Iterable
 from copy import copy
 from html import escape
 from itertools import chain
-from tempfile import NamedTemporaryFile
 from types import FrameType
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    NoReturn,
-    Protocol,
-    TypedDict,
-    TypeVar,
-    cast,
-)
+from typing import TYPE_CHECKING, Any, Callable, NoReturn, Protocol, TypedDict, TypeVar, cast
 
 import gevent
 
@@ -319,12 +306,12 @@ class StatsEntry:
         A {response_time => count} dict that holds the response time distribution of all
         the requests.
 
-        The keys (the response time in ms) are rounded to store 1, 2, ... 9, 10, 20. .. 90,
-        100, 200 .. 900, 1000, 2000 ... 9000, in order to save memory.
+        The keys (the response time in ms) are rounded to store 1, 2, ... 98, 99, 100, 110, 120, ... 980, 990, 1000,
+        1100, 1200, ... 9800, 9900, 10_000, 11_000, 12_000 ... in order to save memory.
 
         This dict is used to calculate the median and percentile response times.
         """
-        self.response_times_cache: OrderedDictType[int, CachedResponseTimes] | None = None
+        self.response_times_cache: OrderedDict[int, CachedResponseTimes] | None = None
         """
         If use_response_times_cache is set to True, this will be a {timestamp => CachedResponseTimes()}
         OrderedDict that holds a copy of the response_times dict for each of the last 20 seconds.

locust-2.29.2.dev42/pre_build.py

@@ -0,0 +1,14 @@
+import os
+import subprocess
+
+
+def build() -> None:
+    if os.environ.get("SKIP_PRE_BUILD", "") == "true":
+        print("Skipping front end build...")
+        return
+    print("Building front end...")
+    subprocess.run(["make", "frontend_build"])
+
+
+if __name__ == "__main__":
+    build()

locust-2.29.2.dev42/pyproject.toml

@@ -0,0 +1,209 @@
+[build-system]
+requires = ["poetry-core>=1.0.0", "poetry-dynamic-versioning>=1.0.0,<2.0.0"]
+build-backend = "poetry_dynamic_versioning.backend"
+
+[tool.poetry]
+name = "locust"
+description = "Developer-friendly load testing framework"
+version = "2.29.2.dev42"
+license = "MIT"
+readme = "README.md"
+authors = ["Jonatan Heyman", "Lars Holmberg"]
+maintainers = ["Lars Holmberg", "Jonatan Heyman", "Andrew Baldwin"]
+
+homepage = "https://locust.io/"
+repository = "https://github.com/locustio/locust"
+documentation = "https://docs.locust.io/"
+
+classifiers = [
+    "Topic :: Software Development :: Testing :: Traffic Generation",
+    "Development Status :: 5 - Production/Stable",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Testing :: Traffic Generation",
+    "Topic :: System :: Distributed Computing",
+]
+
+packages = [{ include = "locust" }]
+include = [
+    "locust/webui/dist/**/*",
+    "locust/_version.py",
+    { path = "poetry.lock", format = [
+        "sdist",
+        "wheel",
+    ] },
+]
+exclude = [
+    "locust/webui/public",
+    "locust/webui/src",
+    "locust/webui/**",
+    "locust/webui/node_modules",
+    "locust/test",
+]
+
+[tool.poetry.build]
+script = "pre_build.py"
+generate-setup-file = false
+
+[tool.poetry.urls]
+"Help/Questions" = "https://github.com/orgs/locustio/discussions/"
+"Issue Tracker" = "https://github.com/locustio/locust/issues"
+
+"Stack Overflow" = "https://stackoverflow.com/questions/tagged/locust"
+"Slack" = "https://locustio.slack.com/"
+"Slack/Signup" = "https://communityinviter.com/apps/locustio/locust"
+
+[tool.poetry-dynamic-versioning]
+enable = false
+vcs = "git"
+style = "pep440"
+latest-tag = true
+pattern = "^(?P<base>\\d+\\.\\d+\\.\\d+)(?P<stage>.*)$"
+format-jinja = """
+{%- if distance == 0 -%}
+{{ serialize_pep440(base) }}
+{%- else -%}
+{{ serialize_pep440(bump_version(base), dev=distance) }}
+{%- endif -%}
+"""
+
+[tool.poetry-dynamic-versioning.files."locust/_version.py"]
+persistent-substitution = true
+initial-content = """
+# file generated by setuptools_scm
+# don't change, don't track in version control
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple, Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+
+__version__ = "0.0.0"
+version = __version__
+__version_tuple__ = (0, 0, 0)
+version_tuple = __version_tuple__
+"""
+
+[tool.poetry.dependencies]
+python = ">=3.9"
+
+gevent = ">=22.10.2"
+flask = ">=2.0.0"
+Werkzeug = ">=2.0.0"
+requests = [
+    { version = ">=2.26.0", python = "<=3.11" },
+    { version = ">=2.32.2", python = ">3.11" },
+]
+msgpack = ">=1.0.0"
+pyzmq = ">=25.0.0"
+geventhttpclient = ">=2.3.1"
+ConfigArgParse = ">=1.5.5"
+tomli = { version = ">=1.1.0", python = "<3.11" }
+typing_extensions = { version = ">=4.6.0", python = "<3.11" }
+psutil = ">=5.9.1"
+Flask-Login = ">=0.6.3"
+Flask-Cors = ">=3.0.10"
+pywin32 = { version = "*", markers = "sys_platform == 'win32'" }
+
+[tool.poetry.group.dev]
+optional = true
+
+[tool.poetry.group.dev.dependencies]
+mypy = "1.10.0"
+pre-commit = "^3.7.1"
+ruff = "0.3.7"
+tox = "^4.16.0"
+twine = "^5.1.1"
+
+[tool.poetry.group.test]
+optional = true
+
+[tool.poetry.group.test.dependencies]
+cryptography = "^42.0.8"
+pyquery = "^2.0.0"
+mock = "^5.1.0"
+mypy = "1.10.0"
+retry = "^0.9.2"
+ruff = "0.3.7"
+tox = "^4.16.0"
+types-requests = "^2.32.0.20240622"
+
+[tool.poetry.group.docs]
+optional = true
+
+[tool.poetry.group.docs.dependencies]
+sphinx = "7.3.7"
+sphinx-rtd-theme = "2.0.0"
+readthedocs-sphinx-search = "0.3.2"
+Sphinx-Substitution-Extensions = "2020.9.30.0"
+Pygments = "2.16.1"
+alabaster = "0.7.16"
+babel = "2.13.0"
+docutils = "0.18.1"
+imagesize = "1.4.1"
+snowballstemmer = "2.2.0"
+sphinx-prompt = "1.5.0"
+sphinxcontrib-applehelp = "1.0.4"
+sphinxcontrib-devhelp = "1.0.2"
+sphinxcontrib-htmlhelp = "2.0.1"
+sphinxcontrib-jsmath = "1.0.1"
+sphinxcontrib-qthelp = "1.0.3"
+sphinxcontrib-serializinghtml = "1.1.10"
+
+[tool.poetry.scripts]
+locust = "locust.main:main"
+
+[tool.ruff]
+target-version = "py39"
+line-length = 120
+extend-exclude = [
+    "build",
+    "examples/issue_*.py",
+    "src/readthedocs-sphinx-search/",
+]
+lint.ignore = ["E402", "E501", "E713", "E731", "E741", "F401"]
+lint.select = ["E", "F", "W", "UP", "FA102", "I001"]
+
+[tool.ruff.lint.per-file-ignores]
+"examples/*" = ["F841"]
+
+[tool.ruff.lint.isort]
+section-order = [
+    "future",
+    "locust",
+    "standard-library",
+    "third-party",
+    "first-party",
+    "local-folder",
+]
+# Custom selection-order: to ensure locust is imported as first in locustfiles (for successful gevent monkey patching)
+
+[tool.ruff.lint.isort.sections]
+locust = ["locust"]
+
+[tool.mypy]
+# missing type stubs
+ignore_missing_imports = true
+python_version = "3.9"
+
+[tool.pyright]
+exclude = ["locust/test"]
+reportOptionalMemberAccess = "none"
+analyzeUnannotatedFunctions = false

locust-2.29.2.dev32/.coveragerc

@@ -1,19 +0,0 @@
-[run]
-branch = True
-source = locust
-
-[report]
-exclude_lines =
-    pragma: no cover
-    def __repr__
-    if self\.debug
-    raise AssertionError
-    raise NotImplementedError
-    if 0:
-    if __name__ == .__main__.:
-ignore_errors = True
-omit =
-    docs/*
-    examples/*
-    locust/test/*
-    setup.py

locust-2.29.2.dev32/.dockerignore

@@ -1,8 +0,0 @@
-locust.egg-info/**
-locustio.egg-info/**
-dist/
-build/
-.coverage
-.tox/
-docs/_build
-# Dockerfile # We'd like to ignore this, but it messes up scm_version's detection because it thinks the checkout is dirty

locust-2.29.2.dev32/.git-blame-ignore-revs

@@ -1,15 +0,0 @@
-# Migrate code style to Black
-7c0fcc213d3988f6e7c6ffef63b24afe00e5fbd9
-2e7a8b5697a98d1d314d6fc3ef0589f81f09d7fe
-# upgrade code style to 3.6 using pyupgrade
-6ec972f4dbb880bf0c7a11809e6c1ba194c9784c
-# upgrade code style to use f-strings using flynt
-313b80f27f525441c449593a3aeaf38389f63c13
-# upgrade typing annotations using fix-future-annotations
-b5324820b299b1fe7da0608f0cc8ec47f58b1e40
-# upgrade code style to 3.8 using pyupgrade
-60f3bceacc4ab9567433d40ae3ed280750f55ff1
-# sort imports using ruff
-f99e9df700a8020e4c1967eb42dcb37ddd26e296
-# apply ruff 0.3.0
-64428a0b4dfc75a00b175b4231db33704d8f5d36

locust-2.29.2.dev32/.gitattributes

@@ -1,20 +0,0 @@
-# Set default behaviour, in case users don't have core.autocrlf set.
-* text=auto
-
-# Explicitly declare text files we want to always be normalized and converted 
-# to native line endings on checkout.
-*.c text
-*.h text
-*.py text
-*.js text
-*.rst text
-*.css text
-*.html text
-
-# Declare files that will always have CRLF line endings on checkout.
-*.sln text eol=crlf
-
-# Denote all files that are truly binary and should not be modified.
-*.png binary
-*.jpg binary
-*.gif binary

locust-2.29.2.dev32/.github/CONTRIBUTING.md

@@ -1,10 +0,0 @@
-## Release Process
-
- * Install github_changelog_generator (https://github.com/github-changelog-generator/github-changelog-generator/) if not installed 
- * Run github_changelog_generator to update `CHANGELOG.md`
-  - `make changelog`
- * Update `locust/__init__.py` with new version number: `__version__ = "VERSION"`
- * Make git tag
- * Push git tag
- * Update Automated Builds configuration in Docker Hub so that the newly created 
-   git tag is built as the "latest" docker tag

locust-2.29.2.dev32/.github/ISSUE_TEMPLATE/bug.yml

@@ -1,63 +0,0 @@
-name: Bug
-description: Report an error
-labels: ["bug"]
-body:
-  - type: checkboxes
-    attributes:
-      label: Prerequisites
-      options:
-        - label: I am using [the latest version of Locust](https://github.com/locustio/locust/releases/)
-          required: true
-        - label: I am reporting a bug, not asking a question
-          required: true
-
-  - type: markdown
-    attributes:
-      value: |
-        If you just need help with something, then:
-
-         * [Check the documentation](https://docs.locust.io/en/stable/)
-         * [Check the FAQ in the wiki](https://github.com/locustio/locust/wiki/FAQ) 
-         * Search [Stack Overflow](https://stackoverflow.com/questions/tagged/locust), or [ask there](https://stackoverflow.com/questions/ask) yourself. If you tag your question with `locust` we will see it.
-         * Ask on [Locust's slack](https://locustio.slack.com) [(sign up here)](https://communityinviter.com/apps/locustio/locust)
-
-  - type: textarea
-    attributes:
-      label: Description
-      description: What happened, and what did you want/expect to happen?
-    validations:
-      required: true
-
-  - type: input
-    attributes:
-      label: Command line
-      description: |
-        For example: locust -f mylocustfile.py -t 10s --headless
-    validations:
-      required: true
-
-  - type: textarea
-    attributes:
-      label: Locustfile contents
-      description: Please remove everything that isn't necessary to trigger the issue.
-      render: python3
-    validations:
-      required: true
-
-  - type: input
-    attributes:
-      label: Python version
-    validations:
-      required: true
-
-  - type: input
-    attributes:
-      label: Locust version
-    validations:
-      required: true
-
-  - type: input
-    attributes:
-      label: Operating system
-    validations:
-      required: true

locust-2.29.2.dev32/.github/ISSUE_TEMPLATE/config.yml

@@ -1 +0,0 @@
-blank_issues_enabled: false

locust-2.29.2.dev32/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,29 +0,0 @@
-name: Feature request
-description: Suggest an improvement
-labels: ["feature request"]
-body:
-  - type: checkboxes
-    attributes:
-      label: Prerequisites
-      options:
-        - label: I am using [the latest version of Locust](https://github.com/locustio/locust/releases/)
-          required: true
-        - label: I am suggesting a new feature, not asking a question
-          required: true
-
-  - type: markdown
-    attributes:
-      value: |
-        If you just need help with something, then:
-
-         * [Check the documentation](https://docs.locust.io/en/stable/)
-         * [Check the FAQ in the wiki](https://github.com/locustio/locust/wiki/FAQ) 
-         * Search [Stack Overflow](https://stackoverflow.com/questions/tagged/locust), or [ask there](https://stackoverflow.com/questions/ask) yourself. If you tag your question with `locust` we will see it.
-         * Ask on [Locust's slack](https://locustio.slack.com) [(sign up here)](https://communityinviter.com/apps/locustio/locust)
-
-  - type: textarea
-    attributes:
-      label: Description
-      description: Describe what feature you are missing, and what alternatives you have considered.
-    validations:
-      required: true

locust-2.29.2.dev32/.github/workflows/stale.yml

@@ -1,26 +0,0 @@
-name: Mark stale issues
-
-on:
-  schedule:
-    - cron: "30 1 * * *"
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  stale:
-    permissions:
-      issues: write  # for actions/stale to close stale issues
-      pull-requests: write  # for actions/stale to close stale PRs
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/stale@v3
-        with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          stale-issue-message: "This issue is stale because it has been open 60 days with no activity. Remove stale label or comment or this will be closed in 10 days."
-          close-issue-message: "This issue was closed because it has been stalled for 10 days with no activity. This does not necessarily mean that the issue is bad, but it most likely means that nobody is willing to take the time to fix it. If you have found Locust useful, then consider contributing a fix yourself!"
-          stale-pr-message: "This PR is stale because it has been open 60 days with no activity. Remove stale label or comment or this will be closed in 10 days."
-          close-pr-message: "This PR was closed because it has been stalled for 10 days with no activity."
-          days-before-close: 10