locust 2.27.1.dev12__tar.gz → 2.27.1.dev20__tar.gz

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: locust
-Version: 2.27.1.dev12
-Summary: Developer friendly load testing framework
+Version: 2.27.1.dev20
+Summary: Developer-friendly load testing framework
 License: MIT
 Project-URL: Homepage, https://github.com/locustio/locust
 Project-URL: Documentation, https://docs.locust.io/
@@ -49,7 +49,7 @@ Requires-Dist: pywin32; platform_system == "Windows"
 [![GitHub contributors](https://img.shields.io/github/contributors/locustio/locust.svg)](https://github.com/locustio/locust/graphs/contributors)
 [![Support Ukraine Badge](https://bit.ly/support-ukraine-now)](https://github.com/support-ukraine/support-ukraine)
 
-Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer friendly approach lets you to define your tests in regular Python code.
+Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer-friendly approach lets you define your tests in regular Python code.
 
 Locust tests can be run from command line or using its web-based UI. Throughput, response times and errors can be viewed in real time and/or exported for later analysis.
 

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/README.md

@@ -7,7 +7,7 @@
 [![GitHub contributors](https://img.shields.io/github/contributors/locustio/locust.svg)](https://github.com/locustio/locust/graphs/contributors)
 [![Support Ukraine Badge](https://bit.ly/support-ukraine-now)](https://github.com/support-ukraine/support-ukraine)
 
-Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer friendly approach lets you to define your tests in regular Python code.
+Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer-friendly approach lets you define your tests in regular Python code.
 
 Locust tests can be run from command line or using its web-based UI. Throughput, response times and errors can be viewed in real time and/or exported for later analysis.
 

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/docs/custom-load-shape.rst

@@ -98,26 +98,23 @@ This shape would create create in the first 10 seconds 10 User of ``UserA``. In
 
 .. _use-common-options:
 
-Reusing command line parameters in custom shapes
-------------------------------------------------
+Reusing common options in custom shapes
+---------------------------------------
 
-By default, using a custom shape will disregard default run parameters (in both the CLI and the Web UI):
-- `--run-time`
-- `--spawn-rate`
-- `--users`
-
-
-If you need one or all of those parameters, you can force locust to accept them by setting the `use_common_options` attribute to `True`:
+When using shapes, the the *Users*, *Spawn Rate* and *Run Time* options will be hidden from the UI, and if you specify them on command line Locust will log a warning. This is because those options dont directly apply to shapes, and specifying them might be a mistake.
 
+If you really want to combine a shape with these options, set the ``use_common_options`` attribute and access them from ``self.runner.environment.parsed_options``:
 
 .. code-block:: python
 
     class MyCustomShape(LoadTestShape):
-
         use_common_options = True
-
+        
         def tick(self):
-            expected_run_time = self.runner.environment.parsed_options.run_time
-            # Do something with this expected run time
-            ...
+            run_time = self.get_run_time()
+            if run_time < self.runner.environment.parsed_options.run_time:
+                # User count rounded to nearest hundred, just like in previous example
+                user_count = round(run_time, -2)
+                return (user_count, self.runner.environment.parsed_options.spawn_rate)
+                
             return None

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/docs/what-is-locust.rst

@@ -2,7 +2,7 @@
 What is Locust?
 ===============================
 
-Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer friendly approach lets you define your tests in regular Python code.
+Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer-friendly approach lets you define your tests in regular Python code.
 
 Locust tests can be run from command line or using its web-based UI. Throughput, response times and errors can be viewed in real time and/or exported for later analysis.
 

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/locust/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.27.1.dev12'
-__version_tuple__ = version_tuple = (2, 27, 1, 'dev12')
+__version__ = version = '2.27.1.dev20'
+__version_tuple__ = version_tuple = (2, 27, 1, 'dev20')

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/locust/web.py

@@ -211,11 +211,14 @@ class WebUI:
             for key, value in request.form.items():
                 if key == "user_count":  # if we just renamed this field to "users" we wouldn't need this
                     user_count = int(value)
+                    parsed_options_dict["users"] = user_count
                 elif key == "spawn_rate":
                     spawn_rate = float(value)
+                    parsed_options_dict[key] = spawn_rate
                 elif key == "host":
                     # Replace < > to guard against XSS
                     environment.host = str(request.form["host"]).replace("<", "").replace(">", "")
+                    parsed_options_dict[key] = environment.host
                 elif key == "user_classes":
                     # Set environment.parsed_options.user_classes to the selected user_classes
                     parsed_options_dict[key] = request.form.getlist("user_classes")
@@ -224,6 +227,7 @@ class WebUI:
                         continue
                     try:
                         run_time = parse_timespan(value)
+                        parsed_options_dict[key] = run_time
                     except ValueError:
                         err_msg = "Valid run_time formats are : 20, 20s, 3m, 2h, 1h20m, 3h30m10s, etc."
                         logger.error(err_msg)

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/locust.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: locust
-Version: 2.27.1.dev12
-Summary: Developer friendly load testing framework
+Version: 2.27.1.dev20
+Summary: Developer-friendly load testing framework
 License: MIT
 Project-URL: Homepage, https://github.com/locustio/locust
 Project-URL: Documentation, https://docs.locust.io/
@@ -49,7 +49,7 @@ Requires-Dist: pywin32; platform_system == "Windows"
 [![GitHub contributors](https://img.shields.io/github/contributors/locustio/locust.svg)](https://github.com/locustio/locust/graphs/contributors)
 [![Support Ukraine Badge](https://bit.ly/support-ukraine-now)](https://github.com/support-ukraine/support-ukraine)
 
-Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer friendly approach lets you to define your tests in regular Python code.
+Locust is an open source performance/load testing tool for HTTP and other protocols. Its developer-friendly approach lets you define your tests in regular Python code.
 
 Locust tests can be run from command line or using its web-based UI. Throughput, response times and errors can be viewed in real time and/or exported for later analysis.
 

{locust-2.27.1.dev12 → locust-2.27.1.dev20}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "locust"
 license = { text = "MIT" }
-description = "Developer friendly load testing framework"
+description = "Developer-friendly load testing framework"
 dynamic = ["version"]
 requires-python = ">=3.9"
 dependencies = [