diff options
Diffstat (limited to 'venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info')
5 files changed, 231 insertions, 0 deletions
diff --git a/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/INSTALLER b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/METADATA b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/METADATA new file mode 100644 index 0000000..b5f6907 --- /dev/null +++ b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/METADATA @@ -0,0 +1,195 @@ +Metadata-Version: 2.1 +Name: fast-query-parsers +Version: 1.0.3 +Classifier: Development Status :: 5 - Production/Stable +Classifier: Environment :: Web Environment +Classifier: License :: OSI Approved :: MIT License +Classifier: Natural Language :: English +Classifier: Operating System :: OS Independent +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: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python +Classifier: Programming Language :: Rust +Classifier: Topic :: Internet :: WWW/HTTP +Classifier: Topic :: Software Development :: Libraries +Classifier: Topic :: Software Development +Classifier: Typing :: Typed +License-File: LICENSE +Summary: Ultra-fast query string and url-encoded form-data parsers +Keywords: query,query string,qs,query parameters,rust,asgi,starlite,litestar,parser +Author: Na'aman Hirschfeld <nhirschfeld@gmail.com> +Author-email: Na'aman Hirschfeld <nhirschfeld@gmail.com> +Requires-Python: >=3.8 +Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM +Project-URL: Source Code, https://github.com/starlite-api/fast-query-parsers + +<!-- markdownlint-disable --> +<p align="center"> + <img src="https://github.com/litestar-org/branding/blob/473f54621e55cde9acbb6fcab7fc03036173eb3d/assets/Branding%20-%20SVG%20-%20Transparent/Logo%20-%20Banner%20-%20Inline%20-%20Light.svg#gh-light-mode-only" alt="Litestar Logo - Light" width="100%" height="auto" /> + <img src="https://github.com/litestar-org/branding/blob/473f54621e55cde9acbb6fcab7fc03036173eb3d/assets/Branding%20-%20SVG%20-%20Transparent/Logo%20-%20Banner%20-%20Inline%20-%20Dark.svg#gh-dark-mode-only" alt="Litestar Logo - Dark" width="100%" height="auto" /> +</p> +<!-- markdownlint-restore --> + +<div align="center"> + +<!-- prettier-ignore-start --> + +| Project | | Status | +|-----------|:----|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| CI/CD | | [](https://github.com/litestar-org/fast-query-parsers/actions/workflows/publish.yaml) [](https://github.com/litestar-org/fast-query-parsers/actions/workflows/ci.yaml) | +| Package | | [](https://badge.fury.io/py/litestar)   | +| Community | | [](https://reddit.com/r/litestarapi) [](https://discord.gg/X3FJqy8d2j) [](https://matrix.to/#/#litestar:matrix.org) [](https://blog.litestar.dev) [](https://twitter.com/LitestarAPI) [](https://blog.litestar.dev) | +| Meta | | [](https://github.com/litestar-org/fast-query-parsers) [](https://spdx.org/licenses/) [](https://github.com/sponsors/litestar-org) [](https://github.com/astral-sh/ruff) [](https://github.com/psf/black) | + +<!-- prettier-ignore-end --> +</div> + +# Fast Query Parsers + +This library includes ultra-fast Rust based query string and urlencoded parsers. These parsers are used +by [`Litestar`](https://github.com/litestar-org/litestar), but are developed separately - and can of course be used separately. + +> [!IMPORTANT]\ +> [**_Starlite has been renamed to Litestar_**](https://litestar.dev/about/organization.html#litestar-and-starlite) + +</div> + +## Installation + +```shell +pip install fast-query-parsers +``` + +## Usage + +The library exposes two function `parse_query_string` and `parse_url_encoded_dict`. + +### `parse_query_string` + +This function is used to parse a query string into a list of key/value tuples. + +```python +from fast_query_parsers import parse_query_string + +result = parse_query_string(b"value=1&value=2&type=dollar&country=US", "&") +# [("value", "1"), ("value", "2"), ("type", "dollar"), ("country", "US")] +``` + +The first argument to this function is a byte string that includes the query string to be parsed, the second argument is +the separator used. + +#### Benchmarks + +Query string parsing is more than x5 times faster than the standard library: + +```text +stdlib parse_qsl parsing query string: Mean +- std dev: 2.86 us +- 0.03 us +..................... +parse_query_string parsing query string: Mean +- std dev: 916 ns +- 13 ns +..................... +stdlib parse_qsl parsing urlencoded query string: Mean +- std dev: 8.30 us +- 0.10 us +..................... +parse_query_string urlencoded query string: Mean +- std dev: 1.50 us +- 0.03 us +``` + +### `parse_url_encoded_dict` + +This function is used to parse a url-encoded form data dictionary and parse it into the python equivalent of JSON types. + +```python +from urllib.parse import urlencode + +from fast_query_parsers import parse_url_encoded_dict + +encoded = urlencode( + [ + ("value", "10"), + ("value", "12"), + ("veggies", '["tomato", "potato", "aubergine"]'), + ("nested", '{"some_key": "some_value"}'), + ("calories", "122.53"), + ("healthy", "true"), + ("polluting", "false"), + ("json", "null"), + ] +).encode() + +result = parse_url_encoded_dict(encoded, parse_numbers=True) + +# result == { +# "value": [10, 12], +# "veggies": ["tomato", "potato", "aubergine"], +# "nested": {"some_key": "some_value"}, +# "calories": 122.53, +# "healthy": True, +# "polluting": False, +# "json": None, +# } +``` + +This function handles type conversions correctly - unlike the standard library function `parse_qs`. Additionally, it +does not nest all values inside lists. + +Note: the second argument passed to `parse_url_encoded_dict` dictates whether numbers should be parsed. If `True`, +the value will be parsed into an int or float as appropriate, otherwise it will be kept as a string. +By default the value of this arg is `True`. + +#### Benchmarks + +Url Encoded parsing is more than x2 times faster than the standard library, without accounting for parsing of values: + +```text +stdlib parse_qs parsing url-encoded values into dict: Mean +- std dev: 8.99 us +- 0.09 us +..................... +parse_url_encoded_dict parse url-encoded values into dict: Mean +- std dev: 3.77 us +- 0.08 us +``` + +To actually mimic the parsing done by `parse_url_encoded_dict` we will need a utility along these lines: + +```python +from collections import defaultdict +from contextlib import suppress +from json import loads, JSONDecodeError +from typing import Any, DefaultDict, Dict, List +from urllib.parse import parse_qsl + + +def parse_url_encoded_form_data(encoded_data: bytes) -> Dict[str, Any]: + """Parse an url encoded form data into dict of parsed values""" + decoded_dict: DefaultDict[str, List[Any]] = defaultdict(list) + for k, v in parse_qsl(encoded_data.decode(), keep_blank_values=True): + with suppress(JSONDecodeError): + v = loads(v) if isinstance(v, str) else v + decoded_dict[k].append(v) + return {k: v if len(v) > 1 else v[0] for k, v in decoded_dict.items()} +``` + +With the above, the benchmarks looks like so: + +```text +python parse_url_encoded_form_data parsing url-encoded values into dict: Mean +- std dev: 19.7 us +- 0.1 us +..................... +parse_url_encoded_dict parsing url-encoded values into dict: Mean +- std dev: 3.69 us +- 0.03 us +``` + +## Contributing + +All contributions are of course welcome! + +### Repository Setup + +1. Run `cargo install` to setup the rust dependencies and `poetry install` to setup the python dependencies. +2. Install the pre-commit hooks with `pre-commit install` (requires [pre-commit](https://pre-commit.com/)). + +### Building + +Run `poetry run maturin develop --release --strip` to install a release wheel (without debugging info). This wheel can be +used in tests and benchmarks. + +### Benchmarking + +There are basic benchmarks using pyperf in place. To run these execute `poetry run python benchrmarks.py`. + diff --git a/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/RECORD b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/RECORD new file mode 100644 index 0000000..fda3507 --- /dev/null +++ b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/RECORD @@ -0,0 +1,10 @@ +fast_query_parsers-1.0.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+fast_query_parsers-1.0.3.dist-info/METADATA,sha256=hoxTvWfq4rN5m3ijxf1dgBYd28g-kxZsDcvHSKcmxHA,12907
+fast_query_parsers-1.0.3.dist-info/RECORD,,
+fast_query_parsers-1.0.3.dist-info/WHEEL,sha256=s-tN1T45JYU6mTMueK5SvnKPSEJdXJWF2Xpfd1qgEQY,129
+fast_query_parsers-1.0.3.dist-info/license_files/LICENSE,sha256=68TrBuYmbVEPRGBI7Mxkj7PhXCxzmBHL-nBQ0NS5qZk,1085
+fast_query_parsers/__init__.py,sha256=8a-aMoMh3uBYz9DlIInIqKqGk7r1jAsRWADonXzp3XY,155
+fast_query_parsers/__init__.pyi,sha256=8A9D1kX6avlQJly_u942_ttn4n06-Z3tbj2-dMt8u-0,671
+fast_query_parsers/__pycache__/__init__.cpython-311.pyc,,
+fast_query_parsers/fast_query_parsers.abi3.so,sha256=K1axQjn4rZxM9LIIlWboSWxXtskLIt7G6f-hW-4peRs,2185632
+fast_query_parsers/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/WHEEL b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/WHEEL new file mode 100644 index 0000000..2f322f8 --- /dev/null +++ b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: maturin (0.14.17) +Root-Is-Purelib: false +Tag: cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64 diff --git a/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/license_files/LICENSE b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/license_files/LICENSE new file mode 100644 index 0000000..419898b --- /dev/null +++ b/venv/lib/python3.11/site-packages/fast_query_parsers-1.0.3.dist-info/license_files/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2022, 2023 Starlite-API + +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. |