AsyncLoad 0.1.1__py3-none-any.whl

asyncload-0.1.1.dist-info/METADATA

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: AsyncLoad
+Version: 0.1.1
+Summary: Asynchronous HTTP Load Testing Tool with Database Storage and Betterstack Integration
+Home-page: https://github.com/Saptarshi2001/pyload
+Author: Saptarshi Dutta
+Author-email: Saptarshi Dutta <saptarshidutta2001@gmail.com>
+Maintainer-email: Saptarshi Dutta <saptarshidutta2001@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Your Name
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/Saptarshi2001/AsyncLoad
+Project-URL: Documentation, https://github.com/Saptarshi2001/AsyncLoad#readme
+Project-URL: Repository, https://github.com/Saptarshi2001/AsyncLoad
+Project-URL: Issues, https://github.com/Saptarshi2001/AsyncLoad/issues
+Project-URL: Changelog, https://github.com/Saptarshi2001/AsyncLoad/blob/main/CHANGELOG.md
+Keywords: load-testing,http,async,aiohttp,performance,monitoring,betterstack
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Software Development :: Testing :: Traffic Generation
+Classifier: Topic :: System :: Benchmark
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.7.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dotenv>=0.15.0
+Requires-Dist: logtail>=1.0.1
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.14.0; extra == "dev"
+Requires-Dist: coverage>=5.0.0; extra == "dev"
+Requires-Dist: black>=21.0.0; extra == "dev"
+Requires-Dist: flake8>=3.8.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=6.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.14.0; extra == "test"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# AsyncLoad
+
+AsyncLoad is an asynchronous load testing CLI designed to stress test your applications under heavy concurrent load. It contains database storage for session history as well as a Betterstack integration for monitoring and observability.
+
+---
+
+## Installation
+
+### Install from pip
+
+For version releases, use pip:
+
+```bash
+pip install async-load-tester
+asyncload -setup
+
+Set your betterstack env variables inside the global config file thats created."%LOCALAPPDATA%/loadtester/config.env" for Windows,"~/.config/loadtester/config.env" for linux and Mac. You can setup the number of requests,concurrent requests, as well as the http method either in the config file or simply use the cmd flags to override the values. Default values for number of requests,concurrent requests,http method is 100,10,GET.   
+
+```
+Head over to your cmd and type:
+
+```bash
+asyncload https://httpbin.org/ -n 100 -c 10 -GET
+```
+
+### Install from GitHub source
+
+For building from source, install directly from the git repository:
+
+```bash
+git clone <repository-url>
+cd Asyncload
+pip install .
+cp config.env.example config.env # set up your config file 
+python -m unittest discover tests/ # Run all tests
+asyncload https://httpbin.org/ -n 100 -c 10 -GET
+```
+
+Or Use Docker to build and run the source:
+
+```bash
+docker compose build
+docker compose run --rm asyncload https://httpbin.org/ -n 100 -c 10 -GET
+```
+
+
+### Running the tests
+
+```bash
+# Run all tests
+python -m unittest discover tests/
+
+# Run specific test modules
+python -m unittest tests.testload
+python -m unittest tests.testasync
+python -m unittest tests.testdb
+
+# Run with verbose output
+python -m unittest -v tests.testload
+```
+
+
+
+
+
+## Examples
+
+```bash
+# Basic GET request
+asyncload https://jsonplaceholder.typicode.com/posts -n 1000 -c 50 -GET
+
+# Test user creation endpoint
+asyncload https://reqres.in/api/users -n 100 -c 10 -POST -d '{"name": "John Doe", "job": "developer"}'
+
+# High concurrency test
+asyncload https://httpbin.org/delay/1 -n 1000 -c 100 -GET
+
+# Stress test with timeout
+asyncload https://httpbin.org/delay/2 -n 100 -c 10 -GET
+
+
+```
+
+---
+
+## API Reference
+
+### ensure_global_config()
+
+Creates the global config file in the user's system
+
+### read()
+
+Reads the command line arguments before executing the load test.
+
+---
+
+### testurl(url, numreq, conreq, reqtype, headers=None)
+
+The core function of AsyncLoad. Sends requests to the specified URL asynchronously.
+
+**Parameters:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `url` | `str` | The URL to test |
+| `numreq` | `int` | Number of total requests |
+| `conreq` | `int` | Number of concurrent requests |
+| `reqtype` | `str` | HTTP method (GET, POST, PUT, DELETE, etc.) |
+| `headers` | `dict` | Optional HTTP headers |
+
+---
+
+### insertpayload(reqlist)
+
+Stores the return values from the requests in an SQLite database instance.
+
+**Parameters:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `reqlist` | `list` | List of request results to store |
+
+---
+
+### history(timemode=None)
+
+Retrieves the session history from the database instance.
+
+**Parameters:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `timemode` | `str` | Optional filter: 'weekly', 'monthly', or 'yearly' |
+
+---
+
+### stats(totresponsetime, firstbytetime, lastbytetime)
+
+Calculates minimum, maximum, and average of total response time, first byte time, and last byte time.
+
+**Parameters:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `totresponsetime` | `list` | List of total response times |
+| `firstbytetime` | `list` | List of first byte times |
+| `lastbytetime` | `list` | List of last byte times |
+
+
+---
+
+### desc()
+
+Displays the load test statistics in the terminal.
+
+
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `-n` | Number of requests |
+| `-c` | Number of concurrent requests |
+| `-GET` / `-POST` / `-DELETE` / `-PUT` / `-HEAD` / `-PATCH` | HTTP method |
+| `-d` | JSON data for POST/PUT/PATCH/DELETE |
+| `-history` | View session history |
+| `-history -weekly` | View weekly session history |
+| `-history -monthly` | View monthly session history |
+| `-history -yearly` | View yearly session history |
+
+---
+
+## Changelog
+
+### [1.0.0] - 2026-05-11
+#### Added
+- Initial release of AsyncLoad
+- Asynchronous load testing CLI with concurrent request support
+- Database storage for session history using SQLite
+- Betterstack integration for monitoring and observability
+- Support for multiple HTTP methods (GET, POST, PUT, DELETE, HEAD, PATCH)
+- Configurable concurrency and request count
+- Session history viewing (weekly, monthly, yearly)
+- Load testing stats 

asyncload-0.1.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+asyncload-0.1.1.dist-info/licenses/LICENSE,sha256=l6425dmjnidzk4JQwhT01C8SpICmjSBMNREAdPnPA9E,1087
+asyncload-0.1.1.dist-info/METADATA,sha256=uXA6Jxvn-LVYbIgFHQI1sOjDkQIvLgge7qRQadSZ5SQ,8368
+asyncload-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+asyncload-0.1.1.dist-info/entry_points.txt,sha256=Y0hNqAIqXHXbYgMeFF6rLKpe3bGQaGGSV42R2ETzYTQ,45
+asyncload-0.1.1.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+asyncload-0.1.1.dist-info/RECORD,,

asyncload-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

asyncload-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+asyncload = asyncload:main

asyncload-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

asyncload-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+