diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..2affe1a --- /dev/null +++ b/.gitattributes @@ -0,0 +1,8 @@ +*.png filter=lfs diff=lfs merge=lfs -text +*.jpeg filter=lfs diff=lfs merge=lfs -text +*.jpg filter=lfs diff=lfs merge=lfs -text +*.bmp filter=lfs diff=lfs merge=lfs -text +*.svg filter=lfs diff=lfs merge=lfs -text +*.sketch filter=lfs diff=lfs merge=lfs -text +*.pkl filter=lfs diff=lfs merge=lfs -text +*.npz filter=lfs diff=lfs merge=lfs -text diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 0000000..94cac4e --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,38 @@ +name: Release + +on: + push: + branches: + - main + +env: + python_version: 3.11 + +jobs: + release: + runs-on: ubuntu-latest + outputs: + released: ${{ steps.release.outputs.released }} + version: ${{ steps.release.outputs.version }} + tag: ${{ steps.release.outputs.tag }} + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Install poetry & python-semantic-release + run: pipx install poetry~=1.8.3 python-semantic-release~=9.8.6 + + - name: Set up Python ${{ env.python_version }} + uses: actions/setup-python@v5 + with: + python-version: ${{ env.python_version }} + cache: "poetry" + + - name: Python Semantic Release + id: release + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + GIT_COMMIT_AUTHOR: "github-actions " + run: | + semantic-release --strict version --commit diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml new file mode 100644 index 0000000..0eb502f --- /dev/null +++ b/.github/workflows/test.yml @@ -0,0 +1,40 @@ +name: Test + +on: + pull_request: + types: [opened, synchronize, reopened] + branches: + - main + +jobs: + test: + runs-on: ubuntu-latest + strategy: + matrix: + python_version: ["3.11", "3.12"] + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Install poetry + run: pipx install poetry~=1.8.3 + + - name: Set up Python ${{ matrix.python_version }} + uses: actions/setup-python@v5 + with: + python-version: ${{ matrix.python_version }} + cache: 'poetry' + + - name: Install dependencies + run: poetry install --with=dev --with=benchmark --all-extras --no-interaction + - name: Black + run: poetry run black --check . + - name: Isort + run: poetry run isort --check-only . + - name: Mypy + run: poetry run mypy . + - name: Pylint + run: poetry run pylint + - name: Pytest + run: poetry run pytest --cov diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..475404c --- /dev/null +++ b/.gitignore @@ -0,0 +1,30 @@ +# Byte-compiled / optimized / DLL files +__pycache__/ + +# Distribution / packaging +build/ +*.egg-info/ +*.egg + +# Translations +*.mo +*.pot + +# Environments +venv/ +.venv/ + +# Tools +.mypy_cache/ +.pytest_cache/ +.coverage + +# IDEs +.idea +.vcode + +# OS +.DS_Store + +# Benchmark files +*.json \ No newline at end of file diff --git a/LICENSE-APACHE b/LICENSE-APACHE new file mode 100644 index 0000000..ce5d397 --- /dev/null +++ b/LICENSE-APACHE @@ -0,0 +1,403 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/LICENSE-MIT b/LICENSE-MIT new file mode 100644 index 0000000..e701c43 --- /dev/null +++ b/LICENSE-MIT @@ -0,0 +1,25 @@ +Copyright 2024 Michael Käser + +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. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..ecb1dcc --- /dev/null +++ b/README.md @@ -0,0 +1,210 @@ + + +# Eventlib-py + +Eventlib-py is a simple event framework for Python that can be used to decouple your code. + +Feature overview: + +- **Fast** - JIT-compiled event chains for fast event emission. +- **Lightweight** - No extra dependencies. +- **Asynchronous** - Full support for asynchronous event handlers and context managers. +- **Priority Ordering** - Control the order in which event handlers are called. +- **Monitoring** - Use context managers to monitor event processing. + +```python +import asyncio +import dataclasses + +import eventlib + + +@dataclasses.dataclass +class MyEvent(eventlib.BaseEvent): + value: str + + +@eventlib.subscribe() +async def on_my_event(event: MyEvent): + print(f"Received: {event.value}") + + +asyncio.run(MyEvent("Hello, world!").emit_async()) # Prints: "Received: Hello, world!" +``` + +## Usage + +### Event Inheritance + +```python +import eventlib + + +class MyEvent(eventlib.BaseEvent): + pass + + +class SubEvent(MyEvent): + pass + + +@eventlib.subscribe() +def on_base_event(event: MyEvent): + print("Received event", event.__class__.__name__) + + +SubEvent().emit() # Prints: "Received event SubEvent" +``` + +### Priority Ordering + +```python +import eventlib + + +class MyEvent(eventlib.BaseEvent): + pass + + +@eventlib.subscribe(priority=-1) +def first(): + print("first") + + +@eventlib.subscribe() # default: priority = 0 +def second(): + print("second") + + +@eventlib.subscribe(priority=1) +def third(): + print("third") + + +MyEvent().emit() # Prints: "first", "second", "third" +``` + +### Context Managers + +```python +import contextlib +import eventlib + + +class MyEvent(eventlib.BaseEvent): + pass + + +@eventlib.subscribe(priority=-1000) # Ensure that this is called first +@contextlib.contextmanager +def monitor(event: MyEvent): + print("Event received") + try: + yield + finally: + print("Event processed") + + +@eventlib.subscribe() +def on_event(event: MyEvent): + print("on_event") + + +MyEvent().emit() # Prints: "Event received", "on_event", "Event processed" +``` + +### Asyncio + +```python +import asyncio +import contextlib +import eventlib + + +class MyEvent(eventlib.BaseEvent): + pass + + +@eventlib.subscribe(priority=-1000) # Ensure that this is called first +@contextlib.asynccontextmanager +async def monitor(event: MyEvent): + print("Event received") + try: + yield + finally: + print("Event processed") + + +@eventlib.subscribe() +async def async_on_event(event: MyEvent): + print("async_on_event") + + +@eventlib.subscribe() +def on_event(event: MyEvent): + print("on_event") + + +asyncio.run(MyEvent().emit_async()) # Prints: "Event received", "async_on_event", "on_event", "Event processed" +``` + +## Benchmarks + +The [benchmark](benchmark/README.md) directory contains code to measure the performance of the eventlib-py library and compare it with a hard-coded reference implementation in Python. + +### Benchmark `case_all` + +The following table shows the overhead of the eventlib-py library in the [case_all](./benchmark/cases/case_all.py) benchmark. +It's a mixed benchmark with all kinds of sync & async event handlers and context managers. + +| Quantile | Hardcoded Time/Event | EventLib Time/Event | Overhead per Call | EventLib Setup | +|:---------|---------------------:|--------------------:|------------------:|---------------:| +| 0.50 | 42.289μs | 45.373μs | +7% | 135.125μs | +| 0.90 | 43.560μs | 46.809μs | +10% | 143.000μs | +| 0.99 | 46.658μs | 50.048μs | +15% | 260.393μs | + +The overhead per call is the additional time that is needed to call the event handlers introduced by the eventlib-py library. +The setup time is the additional nonrecurring overhead for subscribing the event handlers in the event system. +It shows that in the **worst case a 15% overhead per call** is introduced. +The expected **median overhead is around 7%** versus hard-coded event handling. + + +## Development + +Use poetry to setup the development environment. + +```bash +poetry install --with=dev +poetry shell +``` + +Run the auto-formatter, checks and linter: + +```bash +black . +isort . +mypy . +pylint . +``` + +Run the tests: + +```bash +pytest --cov +``` + +Performance test: + +```bash +pytest -s --runperf tests/eventlib_tests/test_performance.py +``` + +## Contributing + +## License + +Dual-licensed under the terms of either the [Apache License 2.0](LICENSE-APACHE) or the [MIT license](LICENSE-MIT). + +``` +SPDX-License-Identifier: (Apache-2.0 OR MIT) +``` diff --git a/benchmark/README.md b/benchmark/README.md new file mode 100644 index 0000000..3b388cc --- /dev/null +++ b/benchmark/README.md @@ -0,0 +1,55 @@ + + +# Eventlib-py Benchmark + +This benchmark compares the performance of the eventlib-py library with a reference implementation hard-coded in Python. + +## Usage + +In the root directory of this repo run the following commands: + +```bash +poetry install --with=dev --with=benchmark +poetry shell +python -m benchmark --help +``` + +- Use Python's `-O` flag to disable assertions and run the benchmark with optimized code. +- Use `nice -20` to give the benchmark process a higher priority. + +### Single run + +```bash +nice -20 python -O -m benchmark run -r 100 -i 10_000 +``` +- `-r` is the number of repetitions. +- `-i` is the number of iterations per repetition. +- The results will be printed to the console. + +```markdown +Results for benchmark 'benchmark.cases.case_all' and 10000 iterations: +| | Reference | Library | Library Init | Factor | +|:-----|------------:|----------:|---------------:|---------:| +| 0.50 | 42.289μs | 45.373μs | 135.125μs | 1.07 | +| 0.90 | 43.560μs | 46.809μs | 143.000μs | 1.10 | +| 0.99 | 46.658μs | 50.048μs | 260.393μs | 1.15 | +``` + +### Ranged run + +Run the benchmark for a range of iterations (from `1` to `2**{iterations-power}`, default: `2**18`). +It will write the results to a json file and show the rendering. + +```bash +nice -20 python -O -m benchmark range --file results.json +``` +- `--file` is the file to write the results to. +- The results will be shown as matplotlib plot. + +### Render a previous ranged run + +```bash +python -O -m benchmark render --file results.json +``` +- `--file` is the file to read the results from. +- The results will be shown as matplotlib plot. diff --git a/benchmark/__init__.py b/benchmark/__init__.py new file mode 100644 index 0000000..b717f71 --- /dev/null +++ b/benchmark/__init__.py @@ -0,0 +1,6 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Benchmark of the event system. +""" diff --git a/benchmark/__main__.py b/benchmark/__main__.py new file mode 100644 index 0000000..e08d43d --- /dev/null +++ b/benchmark/__main__.py @@ -0,0 +1,9 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +"""Benchmark main""" + +from .benchmark import benchmark_cli + +if __name__ == "__main__": + benchmark_cli() diff --git a/benchmark/benchmark.py b/benchmark/benchmark.py new file mode 100755 index 0000000..bc2e71a --- /dev/null +++ b/benchmark/benchmark.py @@ -0,0 +1,250 @@ +#!/usr/bin/env python3 +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Benchmark of the event system. + +The reference implementation is the following:: + + async def run_reference(event: B): + async with async_context_func(event), AsyncContextClass(event): + with sync_context_func(event), SyncContextClass(event): + sync_func0(event) + sync_func1(event) + await async_func(event) + +""" +import argparse +import asyncio +import dataclasses +import functools +import textwrap +import time +from typing import Callable, Protocol + +import pandas +import tqdm +from matplotlib import pyplot as plt +from matplotlib.ticker import PercentFormatter + +from benchmark.cases import case_all +from eventlib import Event, EventSystem + + +class BenchmarkCase(Protocol): + """Protocol interface for a benchmark case.""" + + @staticmethod + def build(system: EventSystem) -> None: + """Build the event system.""" + + @staticmethod + def new_event() -> Event: + """Get the event.""" + + @staticmethod + async def run_reference(event: Event) -> None: + """Run the reference implementation.""" + + @staticmethod + async def run_eventlib(system: EventSystem, event: Event) -> None: + """Run the event library implementation.""" + + +BENCHMARK_CASES: dict[str, BenchmarkCase] = {"all": case_all} # type: ignore +"""Benchmark cases available.""" + + +async def _timeit(iterations: int, func: Callable, *args, **kwargs) -> float: + """Measure the time of an async function.""" + if iterations <= 0: + return 0.0 + start = time.perf_counter() + for _ in range(iterations): + await func(*args, **kwargs) + return time.perf_counter() - start + + +def format_si_unit(value: int | float, suffix: str, decimals: int = 0) -> str: + """Format a number with SI units.""" + for unit in ["", "k", "M", "G", "T", "P", "E", "Z"]: + if value < 1e3: + break + value /= 1e3 + if value < 1: + for unit in ["", "m", "μ", "n", "p", "f"]: + if value >= 1: + break + value *= 1e3 + return f"{value:.{decimals}f}{unit}{suffix}" + + +@dataclasses.dataclass(frozen=True, slots=True) +class BenchmarkResult: + """Benchmark result.""" + + iterations: int + time_ref: float + time_lib: float + time_lib_init: float + + @property + def overhead_factor(self) -> float: + """The measured overhead factor of the eventlib package.""" + return self.time_lib / self.time_ref + + def __str__(self): + time_ref_per_it = format_si_unit(self.time_ref / self.iterations, "s") + time_lib_per_it = format_si_unit(self.time_lib / self.iterations, "s") + time_lib_init_fmt = format_si_unit(self.time_lib_init, "s") + return textwrap.dedent( + f"""Benchmark result for {self.iterations} iterations: + - Reference time: {self.time_ref:>5.3f}s (~{time_ref_per_it:>5}) + - Library time: {self.time_lib:>5.3f}s (~{time_lib_per_it:>5}) x{self.overhead_factor:.2f} + - Library init: {time_lib_init_fmt:>5} + """ + ) + + +def benchmark(case: BenchmarkCase, iterations: int) -> BenchmarkResult: + """Benchmark a single case with the amount of iterations.""" + # Measure event library - initialization + start = time.perf_counter() + system = EventSystem() + case.build(system) + time_lib_init = time.perf_counter() - start + + event = case.new_event() + time_ref = asyncio.run(_timeit(iterations, case.run_reference, event)) + time_lib = asyncio.run(_timeit(iterations, case.run_eventlib, system, event)) + + return BenchmarkResult(iterations, time_ref, time_lib, time_lib_init) + + +def dataframe_from_results(results: list[BenchmarkResult], repeat: int, warmup: int) -> pandas.DataFrame: + """Create a DataFrame from the benchmark results.""" + df = pandas.DataFrame( + { + "Iterations": [b.iterations for b in results], + "Reference": [b.time_ref for b in results], + "Library": [b.time_lib for b in results], + "Library Init": [b.time_lib_init for b in results], + "Factor": [b.time_lib / b.time_ref for b in results], + } + ) + df.attrs["repeat"] = repeat + df.attrs["warmup"] = warmup + return df + + +def benchmark_single(case: BenchmarkCase, iterations: int, warmup: int, repeat: int) -> pandas.DataFrame: + """Run a single benchmark.""" + results = [] + # Warmup + benchmark(case, warmup) + # Benchmark + with tqdm.tqdm(total=repeat * iterations) as pbar: + for _ in range(repeat): + results.append(benchmark(case, iterations)) + pbar.update(iterations) + return dataframe_from_results(results, repeat, warmup) + + +def benchmark_range(case: BenchmarkCase, repeat=100, warmup=10_000, iterations_power: int = 18) -> pandas.DataFrame: + """Run a range of benchmarks.""" + results: list[BenchmarkResult] = [] + total = repeat * sum(2**p for p in range(1, iterations_power + 1)) + # Warmup + benchmark(case, warmup) + # Benchmark + with tqdm.tqdm(total=total) as pbar: + for p in range(1, iterations_power + 1): + for _ in range(repeat): + result = benchmark(case, 2**p) + results.append(result) + pbar.update(result.iterations) + return dataframe_from_results(results, repeat, warmup) + + +def benchmark_render(frame: pandas.DataFrame): + """Render the benchmark results.""" + fig, (ax0, ax1) = plt.subplots(nrows=2) # type: ignore + fig.suptitle("Event System Benchmark") + + ax0.set_ylabel("Call Time (μs)") + ax0.set_xscale("log", base=2) + + ax1.set_ylabel("Overhead") + ax1.set_xscale("log", base=2) + ax1.set_ylim(0.95, 1.3) + ax1.yaxis.set_major_formatter(PercentFormatter(1.0, decimals=0)) + + # Normalize to microseconds + df = frame.copy() + df["Reference"] *= 1e6 / df["Iterations"] + df["Library"] *= 1e6 / df["Iterations"] + + values = df.groupby("Iterations").quantile(0.50) + values.plot(y="Reference", ax=ax0, label="Reference") + values.plot(y="Library", ax=ax0, label="Library") + values.plot(y="Factor", ax=ax1, label="Factor") + + ax0.grid(True, which="both", axis="y", linestyle=":") + ax1.grid(True, which="both", axis="y", linestyle=":") + + plt.show() + + +def benchmark_cli(): + """Command line for the benchmark.""" + parser = argparse.ArgumentParser() + cmd_parser = parser.add_subparsers(title="Commands", dest="command") + + cmd_run = cmd_parser.add_parser("run", help="Run a single benchmark") + cmd_run.add_argument("-c", "--case", type=str, default="all") + cmd_run.add_argument("-i", "--iterations", type=int, default=10_000) + cmd_run.add_argument("-r", "--repeat", type=int, default=100) + cmd_run.add_argument("-w", "--warmup", type=int, default=10_000) + + cmd_range = cmd_parser.add_parser("range", help="Run many benchmarks on a range of iterations") + cmd_range.add_argument("-c", "--case", type=str, default="all") + cmd_range.add_argument("-r", "--repeat", type=int, default=100) + cmd_range.add_argument("-w", "--warmup", type=int, default=10_000) + cmd_range.add_argument("--iterations-power", type=int, default=18) + cmd_range.add_argument("-f", "--file", type=str, default="benchmark_ranged.json") + cmd_range.add_argument("--no-render", action="store_false", dest="render") + + cmd_render = cmd_parser.add_parser("render", help="Render the benchmark results") + cmd_render.add_argument("-f", "--file", type=str, default="benchmark_ranged.json") + + args = parser.parse_args() + command = args.command or "simple" + + match command: + case "range": + case = BENCHMARK_CASES[args.case] + df = benchmark_range(case, args.repeat, args.warmup, iterations_power=args.iterations_power) + df.to_json(args.file) + if args.render: + benchmark_render(df) + case "render": + df = pandas.read_json(args.file) + assert isinstance(df, pandas.DataFrame) + benchmark_render(df) + case "run": + case = BENCHMARK_CASES[args.case] + iterations = args.iterations + df = benchmark_single(case, iterations, args.warmup, args.repeat) + print(f"Results for benchmark '{case.__name__}' and {args.iterations} iterations:") + result = df[["Reference", "Library", "Library Init", "Factor"]].quantile([0.5, 0.9, 0.99]) + + _format_si_unit = functools.partial(format_si_unit, suffix="s", decimals=3) + result["Reference"] = (result["Reference"] / iterations).apply(_format_si_unit) + result["Library"] = (result["Library"] / iterations).apply(_format_si_unit) + result["Library Init"] = result["Library Init"].apply(_format_si_unit) + print(result.to_markdown(floatfmt=".2f", colalign=("left", "right", "right", "right", "right"))) + + +if __name__ == "__main__": + benchmark_cli() diff --git a/benchmark/cases/__init__.py b/benchmark/cases/__init__.py new file mode 100644 index 0000000..d603b3d --- /dev/null +++ b/benchmark/cases/__init__.py @@ -0,0 +1,6 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Benchmark cases. +""" diff --git a/benchmark/cases/case_all.py b/benchmark/cases/case_all.py new file mode 100644 index 0000000..c06028c --- /dev/null +++ b/benchmark/cases/case_all.py @@ -0,0 +1,115 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Benchmark of a mixed use-case with all kinds of sync & async event functions and context managers. + +The reference implementation is the following:: + + async def run_reference(event: B): + async with async_context_func(event), AsyncContextClass(event): + with sync_context_func(event), SyncContextClass(event): + sync_func0(event) + sync_func1(event) + await async_func(event) +""" + +import asyncio +import contextlib + +from eventlib import Event, EventSystem + + +# pylint: disable=too-few-public-methods +class A(Event): + """Test event class""" + + +# pylint: disable=too-few-public-methods +class B(A): + """Test event class""" + + +def sync_func0(_: A): + """Sync event handler for A""" + + +def sync_func1(_: B): + """Sync event handler for B""" + + +async def async_func(_: B): + """Async event handler for B""" + await asyncio.sleep(0) + + +@contextlib.contextmanager +def sync_context_func(_: B): + """Sync context handler for B""" + yield + + +@contextlib.asynccontextmanager +async def async_context_func(_: B): + """Async context handler for B""" + await asyncio.sleep(0) + yield + await asyncio.sleep(0) + + +class SyncContextClass: + """Sync context handler class for B""" + + def __init__(self, _: B): + pass + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + pass + + +class AsyncContextClass: + """Async context handler class for B""" + + def __init__(self, _: B): + pass + + async def __aenter__(self): + return self + + async def __aexit__(self, exc_type, exc_val, exc_tb): + pass + + +def build(system: EventSystem) -> None: + """Prepare the event system.""" + system.subscribe(priority=-2)(async_context_func) + system.subscribe(priority=-2)(AsyncContextClass) + + system.subscribe(priority=-1)(sync_context_func) + system.subscribe(priority=-1)(SyncContextClass) + + system.subscribe(priority=0)(sync_func0) + system.subscribe(priority=1)(sync_func1) + system.subscribe(priority=2)(async_func) + + +def new_event() -> Event: + """Get the event.""" + return B() + + +async def run_reference(event: B) -> None: + """Run the reference implementation.""" + async with async_context_func(event), AsyncContextClass(event): + with sync_context_func(event), SyncContextClass(event): + sync_func0(event) + sync_func1(event) + await async_func(event) + + +async def run_eventlib(system: EventSystem, event: B) -> None: + """Run the eventlib implementation.""" + await system.emit_async(event) diff --git a/eventlib/__init__.py b/eventlib/__init__.py new file mode 100644 index 0000000..802f810 --- /dev/null +++ b/eventlib/__init__.py @@ -0,0 +1,33 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Event library for Python with asyncio support. +""" + +from .base import ( + BaseEvent, + emit, + emit_async, + get_event_system, + set_event_system, + subscribe, + unsubscribe, + unsubscribe_all, +) +from .core import Event, EventHandler, EventHandlerDecorator, EventSystem + +__all__ = [ + "Event", + "EventSystem", + "EventHandlerDecorator", + "EventHandler", + "BaseEvent", + "get_event_system", + "set_event_system", + "subscribe", + "unsubscribe", + "unsubscribe_all", + "emit", + "emit_async", +] diff --git a/eventlib/base.py b/eventlib/base.py new file mode 100644 index 0000000..b9c9f40 --- /dev/null +++ b/eventlib/base.py @@ -0,0 +1,102 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Base classes for the easy integration into the "global" singleton event system. + +You can use the method `set_default_event_system()` to set your own event system as the default one. +""" + +from typing import ClassVar, Self, TypeVar + +from eventlib.core import Event, EventHandler, EventHandlerDecorator, EventSystem + +E = TypeVar("E", bound=Event) +BASE_EVENT_SYSTEM = EventSystem() +"""The global event system.""" + + +class BaseEvent(Event): + """Event class that can be extended to create custom events. Use this for the global event system.""" + + event_system: ClassVar[EventSystem] + + @classmethod + def __init_subclass__(cls, /, event_system: EventSystem | None = None, **kwargs) -> None: + super().__init_subclass__(**kwargs) + parent_event0 = [base for base in cls.__bases__ if issubclass(base, BaseEvent)][0] + cls.event_system = ( + event_system or getattr(cls, "event_system", None) or parent_event0.event_system or BASE_EVENT_SYSTEM + ) + + @classmethod + def subscribe(cls, priority: int = 0, critical: bool = False) -> EventHandlerDecorator[Self]: + """Subscribe to this event.""" + return cls.event_system.subscribe(cls, priority=priority, critical=critical) + + @classmethod + def unsubscribe(cls, func: EventHandler[Self]): + """Unsubscribe from this event.""" + cls.event_system.unsubscribe(func) + + @classmethod + def unsubscribe_all(cls): + """Unsubscribe all event handlers from this event.""" + cls.event_system.unsubscribe_all(cls) + + def emit(self) -> Self: + """Emit this event.""" + self.event_system.emit(self) + return self + + async def emit_async(self) -> Self: + """Emit this event asynchronously.""" + await self.event_system.emit_async(self) + return self + + +# Set the default event system for the BaseEvent class +BaseEvent.event_system = BASE_EVENT_SYSTEM + + +# pylint: disable=global-statement +def set_event_system(event_system: EventSystem): + """ + Set the global event system for the BaseEvent class. + + This will not preserve any existing event system used by the BaseEvent class or derivatives. + Make sure to call this method before importing any modules that use the BaseEvent class. + """ + global BASE_EVENT_SYSTEM + BASE_EVENT_SYSTEM = event_system + BaseEvent.event_system = event_system + + +def get_event_system() -> EventSystem: + """Get the global event system for the BaseEvent class.""" + return BASE_EVENT_SYSTEM + + +def subscribe(priority: int = 0, critical: bool = False) -> EventHandlerDecorator[E]: + """Subscribe to an event in the global event system.""" + return BASE_EVENT_SYSTEM.subscribe(priority=priority, critical=critical) + + +def unsubscribe(func: EventHandler[Event]): + """Unsubscribe from an event in the global event system.""" + BASE_EVENT_SYSTEM.unsubscribe(func) + + +def unsubscribe_all(cls: type[Event]): + """Unsubscribe all event handlers from an event in the global event system.""" + BASE_EVENT_SYSTEM.unsubscribe_all(cls) + + +def emit(event: E) -> None: + """Emit an event in the global event system.""" + BASE_EVENT_SYSTEM.emit(event) + + +async def emit_async(event: E) -> None: + """Emit an event in the global event system asynchronously.""" + await BASE_EVENT_SYSTEM.emit_async(event) diff --git a/eventlib/core.py b/eventlib/core.py new file mode 100644 index 0000000..6dab320 --- /dev/null +++ b/eventlib/core.py @@ -0,0 +1,447 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Core of the event system framework. +""" + +import asyncio +import collections +import dataclasses +import enum +import inspect +from abc import ABC +from contextlib import AsyncExitStack, ExitStack +from typing import ( + Any, + AsyncContextManager, + Callable, + ContextManager, + Coroutine, + Generic, + Iterable, + Iterator, + Self, + TypeGuard, + TypeVar, +) + +from eventlib.type_utils import ( + assert_not_async, + assert_not_async_generator, + assert_not_generator, + is_async_context_manager, + is_context_manager, +) + + +# pylint: disable=too-few-public-methods +class Event(ABC): + """Event class that can be extended to create custom events.""" + + +E = TypeVar("E", bound=Event) +"""Generic type variable for events.""" + +EventHandler = Callable[[E], Any] +"""Generic alias for an event function.""" + +EventHandlerDecorator = Callable[[EventHandler[E]], EventHandler[E]] +"""Generic alias for an event function decorator.""" + + +class HandlerType(enum.Enum): + """Type of the event handler function.""" + + UNKNOWN = 0 + FUNCTION = 1 + ASYNC_FUNCTION = 2 + CONTEXT = 3 + ASYNC_CONTEXT = 4 + + +@dataclasses.dataclass(frozen=True, slots=True) +class EventSubMetadata: + """Metadata for an event subscription.""" + + priority: int = 0 + critical: bool = False + caching: bool = True + + +class EventSub(Generic[E]): + """ + Subscription to an event. + + This object is shared between all event chains that subscribe to the same event. + It caches the handler type and call method for performance, so that it doesn't have to be determined every time. + """ + + __slots__ = ( + "_event_type", + "_handler", + "_meta", + "_handler_hash", + "_handler_type", + "call", + "call_async", + ) + + def __init__(self, event_type: type[E], handler: EventHandler[E], meta: EventSubMetadata) -> None: + """ + Create a new event subscription. + + :param event_type: The type of the event. + :param handler: The handler function. + :param meta: The subscription metadata. + """ + self._event_type = event_type + self._handler = handler + self._meta = meta + self._handler_hash = hash((event_type, handler, meta.priority)) + self._handler_type = HandlerType.UNKNOWN + if inspect.iscoroutinefunction(self._handler): + self._handler_type = HandlerType.ASYNC_FUNCTION + # will be replaced by _call() and _call_async() + self.call: Callable[[E, ExitStack], Any] = self._call + self.call_async: Callable[[E, AsyncExitStack], Coroutine] = self._acall + + @property + def handler(self) -> EventHandler[E]: + """The handler function.""" + return self._handler + + @property + def meta(self) -> EventSubMetadata: + """The metadata of the handler.""" + return self._meta + + @property + def priority(self) -> int: + """The priority of the handler.""" + return self._meta.priority + + @property + def critical(self) -> bool: + """The criticality of the handler.""" + return self._meta.critical + + @property + def handler_type(self) -> HandlerType: + """The type of the handler, or HandlerType.Unknown if not determined yet.""" + return self._handler_type + + @property + def event_type(self) -> type[E]: + """The type of the subscribed event.""" + return self._event_type + + def __hash__(self): + return self._handler_hash + + def __eq__(self, other): + if isinstance(other, EventSub): + return self._handler_hash == other._handler_hash + return False + + @property + def requires_context(self) -> bool: + """True if the handler requires a context manager.""" + return self._handler_type in (HandlerType.CONTEXT, HandlerType.ASYNC_CONTEXT) + + def _call(self, event: E, stack: ExitStack) -> None: + """Call the handler function synchronously and remember the call method.""" + result = self._handler(event) + assert_not_async(result, self._handler) + assert_not_generator(result, self._handler) + if is_context_manager(result): + stack.enter_context(result) + # Remember + if self._meta.caching: + self.call = self.__call__context + self._handler_type = HandlerType.CONTEXT + # Remember + else: + if self._meta.caching: + self.call = self.__call__sync + self._handler_type = HandlerType.FUNCTION + + async def _acall(self, event: E, stack: AsyncExitStack) -> None: + """Call the handler function asynchronously and remember the call method.""" + result = self._handler(event) + assert_not_async_generator(result, self._handler) + assert_not_generator(result, self._handler) + if is_async_context_manager(result): + await stack.enter_async_context(result) + # Remember + if self._meta.caching: + self.call_async = self.__acall__async_context + self._handler_type = HandlerType.ASYNC_CONTEXT + elif inspect.isawaitable(result): + await result + # Remember + if self._meta.caching: + self.call_async = self.__acall__async + self._handler_type = HandlerType.ASYNC_FUNCTION + elif is_context_manager(result): + stack.enter_context(result) + # Remember + if self._meta.caching: + self.call_async = self.__acall__context + self._handler_type = HandlerType.CONTEXT + # Remember + else: + if self._meta.caching: + self.call_async = self.__acall__sync + self._handler_type = HandlerType.FUNCTION + + def __call__context(self, event: E, stack: ExitStack): + stack.enter_context(self._handler(event)) + + def __call__sync(self, event: E, _: ExitStack): + self._handler(event) + + async def __acall__async_context(self, event: E, stack: AsyncExitStack): + await stack.enter_async_context(self._handler(event)) + + async def __acall__async(self, event: E, _: AsyncExitStack): + await self._handler(event) + + async def __acall__context(self, event: E, stack: AsyncExitStack): + stack.enter_context(self._handler(event)) + + async def __acall__sync(self, event: E, _: AsyncExitStack): + self._handler(event) + + +class _NoExitStack(AsyncContextManager, ContextManager): + """Dummy object that can be used as a context manager without doing anything.""" + + def __enter__(self) -> Self: + return self + + def __exit__(self, exc_type, exc_val, exc_tb) -> bool | None: + return None + + async def __aenter__(self) -> Self: + return self + + async def __aexit__(self, exc_type, exc_val, exc_tb) -> bool | None: + return None + + +_NO_EXIT_STACK = _NoExitStack() +"""Dummy object that can be used as a context manager without doing anything.""" + + +class EventChain(Generic[E]): + """Chain of event subscriptions for a specific event type.""" + + __slots__ = ("event_type", "subs", "no_context") + + def __init__(self, event_type: type[E], subs: Iterable[EventSub[E]] = ()) -> None: + """ + Create a new event chain. + + :param event_type: The type of the event. + :param subs: The initial subscriptions (optional). + """ + self.event_type = event_type + self.subs: list[EventSub[E]] = list(subs) + self.subs.sort(key=lambda x: x.priority) + self.no_context: bool | None = None # None = We don't know (yet)! + + def __len__(self) -> int: + return len(self.subs) + + def __iter__(self) -> Iterator[EventSub[E]]: + return iter(self.subs) + + def copy(self) -> Self: + """Create a copy of the event chain.""" + return EventChain(self.event_type, self.subs) # type: ignore + + def add(self, sub: EventSub[E]): + """Add a new subscription to the chain.""" + subs = self.subs + [sub] + subs.sort(key=lambda x: x.priority) + self.no_context = None # None = We don't know (yet)! + self.subs = subs + + def remove(self, func: EventHandler): + """Remove a subscription from the chain.""" + self.subs = [sub for sub in self.subs if sub.handler != func] + + def remove_type(self, event_type: type[E]): + """Remove all subscriptions for a specific event type from the chain.""" + self.subs = [sub for sub in self.subs if sub.event_type != event_type] + + def call(self, event: E): + """Call all event subscriptions synchronously.""" + with _NO_EXIT_STACK if self.no_context else ExitStack() as stack: # type: ignore + subs = self.subs + exceptions: list[Exception] = [] + try: + for sub in subs: + try: + sub.call(event, stack) + # pylint: disable=broad-exception-caught + except Exception as exc: + exceptions.append(exc) + if sub.critical: + break # Stop event processing + finally: + if exceptions: + raise ExceptionGroup("Event error", exceptions) + if self.no_context is None: + self.no_context = not any(sub.requires_context for sub in subs) + + async def call_async(self, event: E): + """Call all event subscriptions asynchronously.""" + async with _NO_EXIT_STACK if self.no_context else AsyncExitStack() as stack: # type: ignore + subs = self.subs + exceptions: list[Exception] = [] + try: + for sub in subs: + try: + await sub.call_async(event, stack) + except asyncio.TimeoutError as exc: + exceptions.append(exc) + break # Stop event processing + # pylint: disable=broad-exception-caught + except Exception as exc: + exceptions.append(exc) + if sub.critical: + break # Stop event processing + finally: + if exceptions: + raise ExceptionGroup("Event error", exceptions) + if self.no_context is None: + self.no_context = not any(sub.requires_context for sub in subs) + + +def _get_event_parents(cls: type[Event]) -> Iterable[type[Event]]: + """Get all parent classes of an event class that are also event classes.""" + + def _get(clazz: type[Event], _result: collections.OrderedDict[type[Event], None]): + parents = tuple(c for c in clazz.__bases__ if issubclass(c, Event)) + _result.update(((c, None) for c in parents)) + for parent in parents: + _result.update(_get(parent, _result)) + return _result + + return tuple(_get(cls, collections.OrderedDict()).keys()) + + +class EventSystem: + """The event system that manages event subscriptions and calls.""" + + __slots__ = ("chains",) + + def __init__(self, other: "EventSystem | None" = None) -> None: + """ + Create a new event system or copy an existing one. + + :param other: event system to copy (optional) + """ + chains = {} if other is None else {k: v.copy() for k, v in other.chains.items()} + self.chains: dict[type[Event], EventChain] = chains + + def _get_parent_subs(self, event_type: type[E]) -> set[EventSub]: + """Get all subscribers of the parent classes of an event class.""" + return {s for parent in _get_event_parents(event_type) for s in (self.chains.get(parent) or ())} + + @classmethod + def _check_event_type(cls, event_type: type[E]) -> TypeGuard[E]: + """Check if the given type is a valid event type.""" + if not issubclass(event_type, Event): + raise TypeError(f"{event_type} is not a subclass of Event") + return True + + def _get_chain(self, event_type: type[E]) -> EventChain[E]: + """Get the event chain for a given event type.""" + if chain := self.chains.get(event_type): + return chain + # Unknown type, try to build from parents + self._check_event_type(event_type) + self.chains[event_type] = chain = EventChain(event_type, self._get_parent_subs(event_type)) + return chain + + # pylint: disable=too-many-arguments + def add_subscriber( + self, + func: EventHandler[E], + event_type: type[E] | None = None, + *, + priority: int = 0, + critical: bool = False, + caching: bool = True, + ): + """ + Add a new event subscriber. + + :param func: The handler function. + :param event_type: The type of the event (optional). + :param priority: The priority of the handler (default = 0) + :param critical: If True, stop event processing if an error occurs (default = False) + :param caching: If True, cache the handler's call method for performance (default = True) + """ + if event_type is None: + args = list(inspect.signature(func).parameters.values()) + if (not args) or any(arg.default is inspect.Parameter.empty for arg in args[1:]): + raise TypeError("Handler function must have exactly one argument") + event_type = args[0].annotation + if event_type is inspect.Parameter.empty: + raise TypeError("Event type must be specified if not given as annotation") + # Add subscriber to its event chain + chain = self._get_chain(event_type) + sub = EventSub(event_type, func, meta=EventSubMetadata(priority=priority, critical=critical, caching=caching)) + chain.add(sub) + # Add subscriber to all sub-event chains + for sub_event_type, sub_chain in self.chains.items(): + if issubclass(sub_event_type, event_type) and sub_chain is not chain: + sub_chain.add(sub) + + def subscribe( + self, event_type: type[E] | None = None, /, priority: int = 0, critical: bool = False, caching: bool = True + ) -> EventHandlerDecorator[E]: + """ + Subscribe to an event with a decorator. + + :param event_type: The type of the event (optional) + :param priority: The priority of the handler (default = 0) + :param critical: If True, stop event processing if an error occurs (default = False) + :param caching: If True, cache the handler's call method for performance (default = True) + :return: The decorator + """ + + def decorator(func): + self.add_subscriber(func, event_type, priority=priority, critical=critical, caching=caching) + return func + + return decorator + + def unsubscribe(self, func: EventHandler[E]): + """Unsubscribe a function from all event chains.""" + for chain in self.chains.values(): + chain.remove(func) + + def unsubscribe_all(self, event_type: type[E]): + """Unsubscribe all functions from an event chain.""" + self.chains.pop(event_type, None) + for chain in self.chains.values(): + chain.remove_type(event_type) + + def clear_all_subscriptions(self): + """Clear all event subscriptions.""" + self.chains = {} + + def emit(self, event: E) -> None: + """Call all event subscribers synchronously.""" + if chain := self._get_chain(type(event)): + chain.call(event) + + async def emit_async(self, event: E) -> None: + """Call all event subscribers asynchronously.""" + if chain := self._get_chain(type(event)): + await chain.call_async(event) diff --git a/eventlib/type_utils.py b/eventlib/type_utils.py new file mode 100644 index 0000000..63a804f --- /dev/null +++ b/eventlib/type_utils.py @@ -0,0 +1,61 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Module for asserting helpers +""" +import inspect +from typing import Any, AsyncContextManager, ContextManager, TypeGuard + + +def is_context_manager(obj) -> TypeGuard[ContextManager]: + """Check if an object is a context manager.""" + return hasattr(obj, "__enter__") and hasattr(obj, "__exit__") + + +def is_async_context_manager(obj) -> TypeGuard[AsyncContextManager]: + """Check if an object is an async context manager.""" + return hasattr(obj, "__aenter__") and hasattr(obj, "__aexit__") + + +if __debug__: + + def assert_not_generator(obj: Any, func: Any = None) -> None: + """Assert that the object is not a generator.""" + if inspect.isgenerator(obj): + err = TypeError("Cannot handle generator.") + if func: + err.add_note(f"The event function {func!r} returned a generator.") + err.add_note("Did you forget to annotate a context manager?") + raise err + + def assert_not_async_generator(obj: Any, func: Any = None) -> None: + """Assert that the object is not an async generator.""" + if inspect.isasyncgen(obj): + err = TypeError("Cannot await async generator.") + if func: + err.add_note(f"The event function {func!r} returned an async generator.") + err.add_note("Did you forget to annotate an async context manager?") + raise err + + def assert_not_async(obj: Any, func: Any = None) -> None: + """Assert that the object is not any awaitable or async context or async generator.""" + if inspect.isawaitable(obj) or is_async_context_manager(obj) or inspect.isasyncgen(obj): + err = TypeError("Cannot await in a synchronous event call.") + if func: + err.add_note(f"The event function {func!r} returned an async object.") + raise err + +else: + + def assert_not_generator(obj: Any, func: Any) -> None: # type: ignore + # pylint: disable=unused-argument,missing-function-docstring + pass + + def assert_not_async_generator(obj: Any, func: Any) -> None: # type: ignore + # pylint: disable=unused-argument,missing-function-docstring + pass + + def assert_not_async(obj: Any, func: Any) -> None: # type: ignore + # pylint: disable=unused-argument,missing-function-docstring + pass diff --git a/examples/__init__.py b/examples/__init__.py new file mode 100644 index 0000000..fa3e497 --- /dev/null +++ b/examples/__init__.py @@ -0,0 +1,2 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) diff --git a/examples/async.py b/examples/async.py new file mode 100644 index 0000000..da13f22 --- /dev/null +++ b/examples/async.py @@ -0,0 +1,52 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +# pylint: disable=unused-argument +""" +Example of using async handlers. +""" + +import asyncio +import contextlib + +import eventlib + + +class MyEvent(eventlib.BaseEvent): + """Some event""" + + +@eventlib.subscribe(priority=-1000) # Ensure that this is called first +@contextlib.asynccontextmanager +async def monitor(event: MyEvent): + """Async enter the context with the event""" + print("Event received") + try: + yield + finally: + print("Event processed") + + +@eventlib.subscribe() +async def async_on_event(event: MyEvent): + """Async handle the event""" + print("async_on_event") + + +@eventlib.subscribe() +def on_event(event: MyEvent): + """Synchronously handle the event""" + print("on_event") + + +# ================================================================================================== +# Example +async def async_example(): + """ + Emits a single event and calls all subscribers. + """ + await MyEvent().emit_async() + + +if __name__ == "__main__": + asyncio.run(async_example()) diff --git a/examples/complex_inheritance.py b/examples/complex_inheritance.py new file mode 100644 index 0000000..412b4dd --- /dev/null +++ b/examples/complex_inheritance.py @@ -0,0 +1,84 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Example that demonstrates how event handlers work with multiple inheritance. +An event handler is only called once per event, even if it is inherited multiple times. + +The class diagram:: + + Base + / \\ + Left Right + \\ / + Merged + + +""" + +from eventlib import BaseEvent, subscribe + + +# ================================================================================================== +# Events +class Base(BaseEvent): + """Base Events for this example""" + + +class Left(Base): + """Left class""" + + +class Right(Base): + """Right class""" + + +class Merged(Left, Right): + """Merged class of both left and right""" + + +# ================================================================================================== +# Event handlers +@subscribe() +def on_base(event: Base): + """Handle any base event""" + print(f"on_base({event!r})") + + +@subscribe() +def on_left(event: Left): + """Handle any left event""" + print(f"on_left({event!r})") + + +@subscribe() +def on_right(event: Right): + """Handle any right event""" + print(f"on_right({event!r})") + + +@subscribe() +def on_merged(event: Merged): + """Handle any merged event""" + print(f"on_merged({event!r})") + + +# ================================================================================================== +# Example +def inheritance_example(): + """ + Example that demonstrates how event handlers work with multiple inheritance. + An event handler is only called once per event, even if it is inherited multiple times. + """ + print("Merged event:") + Merged().emit() # prints: on_base(...), on_right(...), on_left(...), on_merged(...) + + print("\nLeft event:") + Left().emit() # prints: on_base(...), on_left(...) + + print("\nRight event:") + Right().emit() # prints: on_base(...), on_right(...) + + +if __name__ == "__main__": + inheritance_example() diff --git a/examples/copied_systems.py b/examples/copied_systems.py new file mode 100644 index 0000000..802aa71 --- /dev/null +++ b/examples/copied_systems.py @@ -0,0 +1,68 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Example of copying and extending event systems. +""" + +import dataclasses + +from eventlib import Event, EventSystem + + +@dataclasses.dataclass +class Foo(Event): + """Simple event with a value.""" + + value: str + + +@dataclasses.dataclass +class Bar(Event): + """Simple event with a value.""" + + value: str + + +original = EventSystem() + + +@original.subscribe() +def on_foo(event: Foo): + """Event handler for Foo events - in both event systems.""" + print(f"on_foo({event})") + + +# Copy of the outer event system +extended = EventSystem(original) + + +@extended.subscribe() +def on_bar(event: Bar): + """Event handler for Bar events - only in the extended event system.""" + print(f"on_bar({event})") + + +# ================================================================================================== +# Example +def copy_example(): + """ + Example of a copied event system. + + Output:: + + on_foo(Foo(value='Foo')) + --- + on_foo(Foo(value='Hello')) + on_bar(Bar(value='World')) + + """ + original.emit(Foo(value="Foo")) + original.emit(Bar(value="Bar")) # Nothing happens + print("---") + extended.emit(Foo(value="Hello")) + extended.emit(Bar(value="World")) + + +if __name__ == "__main__": + copy_example() diff --git a/examples/isolated_systems.py b/examples/isolated_systems.py new file mode 100644 index 0000000..9fdfee3 --- /dev/null +++ b/examples/isolated_systems.py @@ -0,0 +1,53 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Example of isolated event systems. +""" + +import dataclasses + +from eventlib import Event, EventSystem + +system_a = EventSystem() +system_b = EventSystem() + + +@dataclasses.dataclass +class MyEvent(Event): + """Simple event with a value.""" + + value: str + system: str | None = None + + +@system_a.subscribe() +def on_event_a(event: MyEvent): + """Event handler for MyEvent events in system A.""" + print(f"on_event_a({event})") + + +@system_b.subscribe() +def on_event_b(event: MyEvent): + """Event handler for MyEvent events in system B.""" + print(f"on_event_b({event})") + + +# ================================================================================================== +# Example +def isolated_example(): + """ + Example of isolated events. + + Output:: + + on_event_a(MyEvent(value='Hello', system='A')) + on_event_b(MyEvent(value='World', system='B')) + + """ + system_a.emit(MyEvent("Hello", system="A")) + system_b.emit(MyEvent("World", system="B")) + + +if __name__ == "__main__": + isolated_example() diff --git a/examples/use_cases/__init__.py b/examples/use_cases/__init__.py new file mode 100644 index 0000000..20f2a28 --- /dev/null +++ b/examples/use_cases/__init__.py @@ -0,0 +1,6 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Module for more specific use_cases of the library. +""" diff --git a/examples/use_cases/chat.py b/examples/use_cases/chat.py new file mode 100644 index 0000000..43f2e82 --- /dev/null +++ b/examples/use_cases/chat.py @@ -0,0 +1,81 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Example of a simple chat system with event handlers. +It demonstrates how to use event handlers to cancel messages, print messages, and handle errors. +""" +import contextlib +import dataclasses +import sys + +from eventlib import BaseEvent, subscribe + + +@dataclasses.dataclass() +class ChatEvent(BaseEvent): + """A simple chat event.""" + + name: str + message: str + cancelled: bool = False + + +@subscribe(priority=100) +def on_chat_print(event: ChatEvent): + """Print the message of the chat event.""" + if not event.cancelled: + print(f"{event.name}: {event.message}") + else: + print(f"{event.name}: cancelled the message.") + + +@subscribe() +def cancel_message(event: ChatEvent): + """Cancel the message if it starts with 'cancel'.""" + if event.message.startswith("cancel"): + event.cancelled = True + + +@subscribe() +def on_exit_message(event: ChatEvent): + """Stop the chat if the message starts with 'exit'.""" + if event.message.startswith("exit"): + sys.exit(0) + + +@subscribe(critical=True) +def raise_error_with_critical(event: ChatEvent): + """Raise an error if the message starts with 'fail'.""" + if event.message.startswith("fail"): + raise ValueError(f"Message {event.message!r} starts with word 'fail'.") + + +@subscribe(priority=-100) +@contextlib.contextmanager +def on_chat_error(event: ChatEvent): + """Handle errors in chat events.""" + try: + yield + except* ValueError as exc: + print(f"{event.name}: {exc!r}") + + +# ================================================================================================== +# Example +def chat_example(): + """ + Example of a simple chat system. + + Press Ctrl+C or enter "exit" to exit the chat. + """ + print("Enter 'exit' to exit the chat.") + ChatEvent(name="Alice", message="Hello World").emit() + ChatEvent(name="Bob", message="fail this message").emit() + ChatEvent(name="Alice", message="cancel this message").emit() + while message := input("Enter a message: "): + ChatEvent(name="You", message=message).emit() + + +if __name__ == "__main__": + chat_example() diff --git a/examples/use_cases/plugin_system.py b/examples/use_cases/plugin_system.py new file mode 100644 index 0000000..d3b0553 --- /dev/null +++ b/examples/use_cases/plugin_system.py @@ -0,0 +1,88 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Example of loading and starting plugins with dependencies between them. +""" + +from dataclasses import dataclass +from typing import Protocol + +from eventlib import BaseEvent + + +class Plugin(Protocol): + """Basic plugin interface in this example.""" + + name: str + + def load(self): + """Load the plugin.""" + + def start(self): + """Start the plugin.""" + + +@dataclass +class PluginEvent(BaseEvent): + """Event that occurs when any change to a plugin occurs.""" + + plugin: Plugin + + +class PluginLoadedEvent(PluginEvent): + """A plugin was loaded.""" + + +class PluginStartedEvent(PluginEvent): + """A plugin was started""" + + +# ================================================================================================== +# Another package (registered in Python's plugin system) + + +class CorePlugin(Plugin): + """Example core plugin.""" + + def load(self): + print("Core loaded") + + def start(self): + print("Core started") + + +# ================================================================================================== +# Another package (registered in Python's plugin system) +class MyPlugin(Plugin): + """Example plugin.""" + + def load(self): + PluginStartedEvent.subscribe()(self._on_plugin_started) + print("MyPlugin loaded") + + def _on_plugin_started(self, event: PluginStartedEvent): + if isinstance(event.plugin, CorePlugin): + print("Core is avaliable") + + def start(self): + print("MyPlugin started") + + +# ================================================================================================== +# Example +def plugin_example(): + """Plugin system example.""" + plugins = [MyPlugin(), CorePlugin()] + # Load plugins + for plugin in plugins: + plugin.load() + PluginLoadedEvent(plugin).emit() + # Start plugins + for plugin in plugins: + plugin.start() + PluginStartedEvent(plugin).emit() + + +if __name__ == "__main__": + plugin_example() diff --git a/examples/use_cases/worker_queue.py b/examples/use_cases/worker_queue.py new file mode 100644 index 0000000..8089a49 --- /dev/null +++ b/examples/use_cases/worker_queue.py @@ -0,0 +1,87 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Example of using an `asyncio.Queue` and workers to schedule and emit events. +""" + + +import asyncio +import dataclasses + +from eventlib import BaseEvent + +queue: asyncio.Queue[BaseEvent] = asyncio.Queue() + + +# ================================================================================================== +# Events +@dataclasses.dataclass +class MoreWorkEvents(BaseEvent): + """Schedule more events to the queue.""" + + events: list[BaseEvent] + + +@dataclasses.dataclass +class PrintEvent(BaseEvent): + """Prints a message.""" + + message: str + + +# ================================================================================================== +# Event handler +@MoreWorkEvents.subscribe() +async def schedule_more(event: MoreWorkEvents): + """Schedule more events to the queue.""" + for e in event.events: + await queue.put(e) + + +@PrintEvent.subscribe() +def print_message(event: PrintEvent): + """Prints the message of the event.""" + print(event.message) + + +# ================================================================================================== +# Event worker +async def worker(wid: int): + """Worker that consumes events from the queue and emits it.""" + while True: + event: BaseEvent = await queue.get() + try: + print(f"Worker {wid}: Working on {event}") + await event.emit_async() + print(f"Worker {wid}: Finished {event}") + finally: + queue.task_done() + + +# ================================================================================================== +# Example +async def worker_example(worker_count: int = 10): + """Example of a worker queue that emits events""" + queue.put_nowait( + MoreWorkEvents( + events=[ + PrintEvent(message="Hello"), + PrintEvent(message="World"), + ] + ) + ) + queue.put_nowait(PrintEvent(message="Goodbye")) + + async with asyncio.TaskGroup() as tg: + # Startup + workers = [tg.create_task(worker(wid)) for wid in range(worker_count)] + # Wait for all events to be consumed + await tg.create_task(queue.join()) + # Shutdown + for task in workers: + task.cancel() + + +if __name__ == "__main__": + asyncio.run(worker_example()) diff --git a/poetry.lock b/poetry.lock new file mode 100644 index 0000000..767aa89 --- /dev/null +++ b/poetry.lock @@ -0,0 +1,1116 @@ +# This file is automatically @generated by Poetry 1.8.3 and should not be changed by hand. + +[[package]] +name = "astroid" +version = "3.2.4" +description = "An abstract syntax tree for Python with inference support." +optional = false +python-versions = ">=3.8.0" +files = [ + {file = "astroid-3.2.4-py3-none-any.whl", hash = "sha256:413658a61eeca6202a59231abb473f932038fbcbf1666587f66d482083413a25"}, + {file = "astroid-3.2.4.tar.gz", hash = "sha256:0e14202810b30da1b735827f78f5157be2bbd4a7a59b7707ca0bfc2fb4c0063a"}, +] + +[[package]] +name = "black" +version = "24.8.0" +description = "The uncompromising code formatter." +optional = false +python-versions = ">=3.8" +files = [ + {file = "black-24.8.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:09cdeb74d494ec023ded657f7092ba518e8cf78fa8386155e4a03fdcc44679e6"}, + {file = "black-24.8.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:81c6742da39f33b08e791da38410f32e27d632260e599df7245cccee2064afeb"}, + {file = "black-24.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:707a1ca89221bc8a1a64fb5e15ef39cd755633daa672a9db7498d1c19de66a42"}, + {file = "black-24.8.0-cp310-cp310-win_amd64.whl", hash = "sha256:d6417535d99c37cee4091a2f24eb2b6d5ec42b144d50f1f2e436d9fe1916fe1a"}, + {file = "black-24.8.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:fb6e2c0b86bbd43dee042e48059c9ad7830abd5c94b0bc518c0eeec57c3eddc1"}, + {file = "black-24.8.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:837fd281f1908d0076844bc2b801ad2d369c78c45cf800cad7b61686051041af"}, + {file = "black-24.8.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:62e8730977f0b77998029da7971fa896ceefa2c4c4933fcd593fa599ecbf97a4"}, + {file = "black-24.8.0-cp311-cp311-win_amd64.whl", hash = "sha256:72901b4913cbac8972ad911dc4098d5753704d1f3c56e44ae8dce99eecb0e3af"}, + {file = "black-24.8.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:7c046c1d1eeb7aea9335da62472481d3bbf3fd986e093cffd35f4385c94ae368"}, + {file = "black-24.8.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:649f6d84ccbae73ab767e206772cc2d7a393a001070a4c814a546afd0d423aed"}, + {file = "black-24.8.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2b59b250fdba5f9a9cd9d0ece6e6d993d91ce877d121d161e4698af3eb9c1018"}, + {file = "black-24.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:6e55d30d44bed36593c3163b9bc63bf58b3b30e4611e4d88a0c3c239930ed5b2"}, + {file = "black-24.8.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:505289f17ceda596658ae81b61ebbe2d9b25aa78067035184ed0a9d855d18afd"}, + {file = "black-24.8.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:b19c9ad992c7883ad84c9b22aaa73562a16b819c1d8db7a1a1a49fb7ec13c7d2"}, + {file = "black-24.8.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1f13f7f386f86f8121d76599114bb8c17b69d962137fc70efe56137727c7047e"}, + {file = "black-24.8.0-cp38-cp38-win_amd64.whl", hash = "sha256:f490dbd59680d809ca31efdae20e634f3fae27fba3ce0ba3208333b713bc3920"}, + {file = "black-24.8.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:eab4dd44ce80dea27dc69db40dab62d4ca96112f87996bca68cd75639aeb2e4c"}, + {file = "black-24.8.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3c4285573d4897a7610054af5a890bde7c65cb466040c5f0c8b732812d7f0e5e"}, + {file = "black-24.8.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9e84e33b37be070ba135176c123ae52a51f82306def9f7d063ee302ecab2cf47"}, + {file = "black-24.8.0-cp39-cp39-win_amd64.whl", hash = "sha256:73bbf84ed136e45d451a260c6b73ed674652f90a2b3211d6a35e78054563a9bb"}, + {file = "black-24.8.0-py3-none-any.whl", hash = "sha256:972085c618ee94f402da1af548a4f218c754ea7e5dc70acb168bfaca4c2542ed"}, + {file = "black-24.8.0.tar.gz", hash = "sha256:2500945420b6784c38b9ee885af039f5e7471ef284ab03fa35ecdde4688cd83f"}, +] + +[package.dependencies] +click = ">=8.0.0" +mypy-extensions = ">=0.4.3" +packaging = ">=22.0" +pathspec = ">=0.9.0" +platformdirs = ">=2" + +[package.extras] +colorama = ["colorama (>=0.4.3)"] +d = ["aiohttp (>=3.7.4)", "aiohttp (>=3.7.4,!=3.9.0)"] +jupyter = ["ipython (>=7.8.0)", "tokenize-rt (>=3.2.0)"] +uvloop = ["uvloop (>=0.15.2)"] + +[[package]] +name = "click" +version = "8.1.7" +description = "Composable command line interface toolkit" +optional = false +python-versions = ">=3.7" +files = [ + {file = "click-8.1.7-py3-none-any.whl", hash = "sha256:ae74fb96c20a0277a1d615f1e4d73c8414f5a98db8b799a7931d1582f3390c28"}, + {file = "click-8.1.7.tar.gz", hash = "sha256:ca9853ad459e787e2192211578cc907e7594e294c7ccc834310722b41b9ca6de"}, +] + +[package.dependencies] +colorama = {version = "*", markers = "platform_system == \"Windows\""} + +[[package]] +name = "colorama" +version = "0.4.6" +description = "Cross-platform colored terminal text." +optional = false +python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7" +files = [ + {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"}, + {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"}, +] + +[[package]] +name = "contourpy" +version = "1.2.1" +description = "Python library for calculating contours of 2D quadrilateral grids" +optional = false +python-versions = ">=3.9" +files = [ + {file = "contourpy-1.2.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:bd7c23df857d488f418439686d3b10ae2fbf9bc256cd045b37a8c16575ea1040"}, + {file = "contourpy-1.2.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5b9eb0ca724a241683c9685a484da9d35c872fd42756574a7cfbf58af26677fd"}, + {file = "contourpy-1.2.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4c75507d0a55378240f781599c30e7776674dbaf883a46d1c90f37e563453480"}, + {file = "contourpy-1.2.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:11959f0ce4a6f7b76ec578576a0b61a28bdc0696194b6347ba3f1c53827178b9"}, + {file = "contourpy-1.2.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:eb3315a8a236ee19b6df481fc5f997436e8ade24a9f03dfdc6bd490fea20c6da"}, + {file = "contourpy-1.2.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:39f3ecaf76cd98e802f094e0d4fbc6dc9c45a8d0c4d185f0f6c2234e14e5f75b"}, + {file = "contourpy-1.2.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:94b34f32646ca0414237168d68a9157cb3889f06b096612afdd296003fdd32fd"}, + {file = "contourpy-1.2.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:457499c79fa84593f22454bbd27670227874cd2ff5d6c84e60575c8b50a69619"}, + {file = "contourpy-1.2.1-cp310-cp310-win32.whl", hash = "sha256:ac58bdee53cbeba2ecad824fa8159493f0bf3b8ea4e93feb06c9a465d6c87da8"}, + {file = "contourpy-1.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:9cffe0f850e89d7c0012a1fb8730f75edd4320a0a731ed0c183904fe6ecfc3a9"}, + {file = "contourpy-1.2.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:6022cecf8f44e36af10bd9118ca71f371078b4c168b6e0fab43d4a889985dbb5"}, + {file = "contourpy-1.2.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ef5adb9a3b1d0c645ff694f9bca7702ec2c70f4d734f9922ea34de02294fdf72"}, + {file = "contourpy-1.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6150ffa5c767bc6332df27157d95442c379b7dce3a38dff89c0f39b63275696f"}, + {file = "contourpy-1.2.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4c863140fafc615c14a4bf4efd0f4425c02230eb8ef02784c9a156461e62c965"}, + {file = "contourpy-1.2.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:00e5388f71c1a0610e6fe56b5c44ab7ba14165cdd6d695429c5cd94021e390b2"}, + {file = "contourpy-1.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d4492d82b3bc7fbb7e3610747b159869468079fe149ec5c4d771fa1f614a14df"}, + {file = "contourpy-1.2.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:49e70d111fee47284d9dd867c9bb9a7058a3c617274900780c43e38d90fe1205"}, + {file = "contourpy-1.2.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:b59c0ffceff8d4d3996a45f2bb6f4c207f94684a96bf3d9728dbb77428dd8cb8"}, + {file = "contourpy-1.2.1-cp311-cp311-win32.whl", hash = "sha256:7b4182299f251060996af5249c286bae9361fa8c6a9cda5efc29fe8bfd6062ec"}, + {file = "contourpy-1.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:2855c8b0b55958265e8b5888d6a615ba02883b225f2227461aa9127c578a4922"}, + {file = "contourpy-1.2.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:62828cada4a2b850dbef89c81f5a33741898b305db244904de418cc957ff05dc"}, + {file = "contourpy-1.2.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:309be79c0a354afff9ff7da4aaed7c3257e77edf6c1b448a779329431ee79d7e"}, + {file = "contourpy-1.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2e785e0f2ef0d567099b9ff92cbfb958d71c2d5b9259981cd9bee81bd194c9a4"}, + {file = "contourpy-1.2.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1cac0a8f71a041aa587410424ad46dfa6a11f6149ceb219ce7dd48f6b02b87a7"}, + {file = "contourpy-1.2.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:af3f4485884750dddd9c25cb7e3915d83c2db92488b38ccb77dd594eac84c4a0"}, + {file = "contourpy-1.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9ce6889abac9a42afd07a562c2d6d4b2b7134f83f18571d859b25624a331c90b"}, + {file = "contourpy-1.2.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:a1eea9aecf761c661d096d39ed9026574de8adb2ae1c5bd7b33558af884fb2ce"}, + {file = "contourpy-1.2.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:187fa1d4c6acc06adb0fae5544c59898ad781409e61a926ac7e84b8f276dcef4"}, + {file = "contourpy-1.2.1-cp312-cp312-win32.whl", hash = "sha256:c2528d60e398c7c4c799d56f907664673a807635b857df18f7ae64d3e6ce2d9f"}, + {file = "contourpy-1.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:1a07fc092a4088ee952ddae19a2b2a85757b923217b7eed584fdf25f53a6e7ce"}, + {file = "contourpy-1.2.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:bb6834cbd983b19f06908b45bfc2dad6ac9479ae04abe923a275b5f48f1a186b"}, + {file = "contourpy-1.2.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1d59e739ab0e3520e62a26c60707cc3ab0365d2f8fecea74bfe4de72dc56388f"}, + {file = "contourpy-1.2.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bd3db01f59fdcbce5b22afad19e390260d6d0222f35a1023d9adc5690a889364"}, + {file = "contourpy-1.2.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a12a813949e5066148712a0626895c26b2578874e4cc63160bb007e6df3436fe"}, + {file = "contourpy-1.2.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fe0ccca550bb8e5abc22f530ec0466136379c01321fd94f30a22231e8a48d985"}, + {file = "contourpy-1.2.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e1d59258c3c67c865435d8fbeb35f8c59b8bef3d6f46c1f29f6123556af28445"}, + {file = "contourpy-1.2.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:f32c38afb74bd98ce26de7cc74a67b40afb7b05aae7b42924ea990d51e4dac02"}, + {file = "contourpy-1.2.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d31a63bc6e6d87f77d71e1abbd7387ab817a66733734883d1fc0021ed9bfa083"}, + {file = "contourpy-1.2.1-cp39-cp39-win32.whl", hash = "sha256:ddcb8581510311e13421b1f544403c16e901c4e8f09083c881fab2be80ee31ba"}, + {file = "contourpy-1.2.1-cp39-cp39-win_amd64.whl", hash = "sha256:10a37ae557aabf2509c79715cd20b62e4c7c28b8cd62dd7d99e5ed3ce28c3fd9"}, + {file = "contourpy-1.2.1-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:a31f94983fecbac95e58388210427d68cd30fe8a36927980fab9c20062645609"}, + {file = "contourpy-1.2.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ef2b055471c0eb466033760a521efb9d8a32b99ab907fc8358481a1dd29e3bd3"}, + {file = "contourpy-1.2.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:b33d2bc4f69caedcd0a275329eb2198f560b325605810895627be5d4b876bf7f"}, + {file = "contourpy-1.2.1.tar.gz", hash = "sha256:4d8908b3bee1c889e547867ca4cdc54e5ab6be6d3e078556814a22457f49423c"}, +] + +[package.dependencies] +numpy = ">=1.20" + +[package.extras] +bokeh = ["bokeh", "selenium"] +docs = ["furo", "sphinx (>=7.2)", "sphinx-copybutton"] +mypy = ["contourpy[bokeh,docs]", "docutils-stubs", "mypy (==1.8.0)", "types-Pillow"] +test = ["Pillow", "contourpy[test-no-images]", "matplotlib"] +test-no-images = ["pytest", "pytest-cov", "pytest-xdist", "wurlitzer"] + +[[package]] +name = "coverage" +version = "7.6.1" +description = "Code coverage measurement for Python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "coverage-7.6.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b06079abebbc0e89e6163b8e8f0e16270124c154dc6e4a47b413dd538859af16"}, + {file = "coverage-7.6.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:cf4b19715bccd7ee27b6b120e7e9dd56037b9c0681dcc1adc9ba9db3d417fa36"}, + {file = "coverage-7.6.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e61c0abb4c85b095a784ef23fdd4aede7a2628478e7baba7c5e3deba61070a02"}, + {file = "coverage-7.6.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fd21f6ae3f08b41004dfb433fa895d858f3f5979e7762d052b12aef444e29afc"}, + {file = "coverage-7.6.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f59d57baca39b32db42b83b2a7ba6f47ad9c394ec2076b084c3f029b7afca23"}, + {file = "coverage-7.6.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:a1ac0ae2b8bd743b88ed0502544847c3053d7171a3cff9228af618a068ed9c34"}, + {file = "coverage-7.6.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:e6a08c0be454c3b3beb105c0596ebdc2371fab6bb90c0c0297f4e58fd7e1012c"}, + {file = "coverage-7.6.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:f5796e664fe802da4f57a168c85359a8fbf3eab5e55cd4e4569fbacecc903959"}, + {file = "coverage-7.6.1-cp310-cp310-win32.whl", hash = "sha256:7bb65125fcbef8d989fa1dd0e8a060999497629ca5b0efbca209588a73356232"}, + {file = "coverage-7.6.1-cp310-cp310-win_amd64.whl", hash = "sha256:3115a95daa9bdba70aea750db7b96b37259a81a709223c8448fa97727d546fe0"}, + {file = "coverage-7.6.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:7dea0889685db8550f839fa202744652e87c60015029ce3f60e006f8c4462c93"}, + {file = "coverage-7.6.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ed37bd3c3b063412f7620464a9ac1314d33100329f39799255fb8d3027da50d3"}, + {file = "coverage-7.6.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d85f5e9a5f8b73e2350097c3756ef7e785f55bd71205defa0bfdaf96c31616ff"}, + {file = "coverage-7.6.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9bc572be474cafb617672c43fe989d6e48d3c83af02ce8de73fff1c6bb3c198d"}, + {file = "coverage-7.6.1-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c0420b573964c760df9e9e86d1a9a622d0d27f417e1a949a8a66dd7bcee7bc6"}, + {file = "coverage-7.6.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1f4aa8219db826ce6be7099d559f8ec311549bfc4046f7f9fe9b5cea5c581c56"}, + {file = "coverage-7.6.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:fc5a77d0c516700ebad189b587de289a20a78324bc54baee03dd486f0855d234"}, + {file = "coverage-7.6.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:b48f312cca9621272ae49008c7f613337c53fadca647d6384cc129d2996d1133"}, + {file = "coverage-7.6.1-cp311-cp311-win32.whl", hash = "sha256:1125ca0e5fd475cbbba3bb67ae20bd2c23a98fac4e32412883f9bcbaa81c314c"}, + {file = "coverage-7.6.1-cp311-cp311-win_amd64.whl", hash = "sha256:8ae539519c4c040c5ffd0632784e21b2f03fc1340752af711f33e5be83a9d6c6"}, + {file = "coverage-7.6.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:95cae0efeb032af8458fc27d191f85d1717b1d4e49f7cb226cf526ff28179778"}, + {file = "coverage-7.6.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5621a9175cf9d0b0c84c2ef2b12e9f5f5071357c4d2ea6ca1cf01814f45d2391"}, + {file = "coverage-7.6.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:260933720fdcd75340e7dbe9060655aff3af1f0c5d20f46b57f262ab6c86a5e8"}, + {file = "coverage-7.6.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:07e2ca0ad381b91350c0ed49d52699b625aab2b44b65e1b4e02fa9df0e92ad2d"}, + {file = "coverage-7.6.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c44fee9975f04b33331cb8eb272827111efc8930cfd582e0320613263ca849ca"}, + {file = "coverage-7.6.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:877abb17e6339d96bf08e7a622d05095e72b71f8afd8a9fefc82cf30ed944163"}, + {file = "coverage-7.6.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:3e0cadcf6733c09154b461f1ca72d5416635e5e4ec4e536192180d34ec160f8a"}, + {file = "coverage-7.6.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:c3c02d12f837d9683e5ab2f3d9844dc57655b92c74e286c262e0fc54213c216d"}, + {file = "coverage-7.6.1-cp312-cp312-win32.whl", hash = "sha256:e05882b70b87a18d937ca6768ff33cc3f72847cbc4de4491c8e73880766718e5"}, + {file = "coverage-7.6.1-cp312-cp312-win_amd64.whl", hash = "sha256:b5d7b556859dd85f3a541db6a4e0167b86e7273e1cdc973e5b175166bb634fdb"}, + {file = "coverage-7.6.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:a4acd025ecc06185ba2b801f2de85546e0b8ac787cf9d3b06e7e2a69f925b106"}, + {file = "coverage-7.6.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a6d3adcf24b624a7b778533480e32434a39ad8fa30c315208f6d3e5542aeb6e9"}, + {file = "coverage-7.6.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d0c212c49b6c10e6951362f7c6df3329f04c2b1c28499563d4035d964ab8e08c"}, + {file = "coverage-7.6.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6e81d7a3e58882450ec4186ca59a3f20a5d4440f25b1cff6f0902ad890e6748a"}, + {file = "coverage-7.6.1-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:78b260de9790fd81e69401c2dc8b17da47c8038176a79092a89cb2b7d945d060"}, + {file = "coverage-7.6.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a78d169acd38300060b28d600344a803628c3fd585c912cacc9ea8790fe96862"}, + {file = "coverage-7.6.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:2c09f4ce52cb99dd7505cd0fc8e0e37c77b87f46bc9c1eb03fe3bc9991085388"}, + {file = "coverage-7.6.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6878ef48d4227aace338d88c48738a4258213cd7b74fd9a3d4d7582bb1d8a155"}, + {file = "coverage-7.6.1-cp313-cp313-win32.whl", hash = "sha256:44df346d5215a8c0e360307d46ffaabe0f5d3502c8a1cefd700b34baf31d411a"}, + {file = "coverage-7.6.1-cp313-cp313-win_amd64.whl", hash = "sha256:8284cf8c0dd272a247bc154eb6c95548722dce90d098c17a883ed36e67cdb129"}, + {file = "coverage-7.6.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:d3296782ca4eab572a1a4eca686d8bfb00226300dcefdf43faa25b5242ab8a3e"}, + {file = "coverage-7.6.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:502753043567491d3ff6d08629270127e0c31d4184c4c8d98f92c26f65019962"}, + {file = "coverage-7.6.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6a89ecca80709d4076b95f89f308544ec8f7b4727e8a547913a35f16717856cb"}, + {file = "coverage-7.6.1-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a318d68e92e80af8b00fa99609796fdbcdfef3629c77c6283566c6f02c6d6704"}, + {file = "coverage-7.6.1-cp313-cp313t-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:13b0a73a0896988f053e4fbb7de6d93388e6dd292b0d87ee51d106f2c11b465b"}, + {file = "coverage-7.6.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:4421712dbfc5562150f7554f13dde997a2e932a6b5f352edcce948a815efee6f"}, + {file = "coverage-7.6.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:166811d20dfea725e2e4baa71fffd6c968a958577848d2131f39b60043400223"}, + {file = "coverage-7.6.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:225667980479a17db1048cb2bf8bfb39b8e5be8f164b8f6628b64f78a72cf9d3"}, + {file = "coverage-7.6.1-cp313-cp313t-win32.whl", hash = "sha256:170d444ab405852903b7d04ea9ae9b98f98ab6d7e63e1115e82620807519797f"}, + {file = "coverage-7.6.1-cp313-cp313t-win_amd64.whl", hash = "sha256:b9f222de8cded79c49bf184bdbc06630d4c58eec9459b939b4a690c82ed05657"}, + {file = "coverage-7.6.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:6db04803b6c7291985a761004e9060b2bca08da6d04f26a7f2294b8623a0c1a0"}, + {file = "coverage-7.6.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:f1adfc8ac319e1a348af294106bc6a8458a0f1633cc62a1446aebc30c5fa186a"}, + {file = "coverage-7.6.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a95324a9de9650a729239daea117df21f4b9868ce32e63f8b650ebe6cef5595b"}, + {file = "coverage-7.6.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b43c03669dc4618ec25270b06ecd3ee4fa94c7f9b3c14bae6571ca00ef98b0d3"}, + {file = "coverage-7.6.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8929543a7192c13d177b770008bc4e8119f2e1f881d563fc6b6305d2d0ebe9de"}, + {file = "coverage-7.6.1-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:a09ece4a69cf399510c8ab25e0950d9cf2b42f7b3cb0374f95d2e2ff594478a6"}, + {file = "coverage-7.6.1-cp38-cp38-musllinux_1_2_i686.whl", hash = "sha256:9054a0754de38d9dbd01a46621636689124d666bad1936d76c0341f7d71bf569"}, + {file = "coverage-7.6.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:0dbde0f4aa9a16fa4d754356a8f2e36296ff4d83994b2c9d8398aa32f222f989"}, + {file = "coverage-7.6.1-cp38-cp38-win32.whl", hash = "sha256:da511e6ad4f7323ee5702e6633085fb76c2f893aaf8ce4c51a0ba4fc07580ea7"}, + {file = "coverage-7.6.1-cp38-cp38-win_amd64.whl", hash = "sha256:3f1156e3e8f2872197af3840d8ad307a9dd18e615dc64d9ee41696f287c57ad8"}, + {file = "coverage-7.6.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:abd5fd0db5f4dc9289408aaf34908072f805ff7792632250dcb36dc591d24255"}, + {file = "coverage-7.6.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:547f45fa1a93154bd82050a7f3cddbc1a7a4dd2a9bf5cb7d06f4ae29fe94eaf8"}, + {file = "coverage-7.6.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:645786266c8f18a931b65bfcefdbf6952dd0dea98feee39bd188607a9d307ed2"}, + {file = "coverage-7.6.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9e0b2df163b8ed01d515807af24f63de04bebcecbd6c3bfeff88385789fdf75a"}, + {file = "coverage-7.6.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:609b06f178fe8e9f89ef676532760ec0b4deea15e9969bf754b37f7c40326dbc"}, + {file = "coverage-7.6.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:702855feff378050ae4f741045e19a32d57d19f3e0676d589df0575008ea5004"}, + {file = "coverage-7.6.1-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:2bdb062ea438f22d99cba0d7829c2ef0af1d768d1e4a4f528087224c90b132cb"}, + {file = "coverage-7.6.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:9c56863d44bd1c4fe2abb8a4d6f5371d197f1ac0ebdee542f07f35895fc07f36"}, + {file = "coverage-7.6.1-cp39-cp39-win32.whl", hash = "sha256:6e2cd258d7d927d09493c8df1ce9174ad01b381d4729a9d8d4e38670ca24774c"}, + {file = "coverage-7.6.1-cp39-cp39-win_amd64.whl", hash = "sha256:06a737c882bd26d0d6ee7269b20b12f14a8704807a01056c80bb881a4b2ce6ca"}, + {file = "coverage-7.6.1-pp38.pp39.pp310-none-any.whl", hash = "sha256:e9a6e0eb86070e8ccaedfbd9d38fec54864f3125ab95419970575b42af7541df"}, + {file = "coverage-7.6.1.tar.gz", hash = "sha256:953510dfb7b12ab69d20135a0662397f077c59b1e6379a768e97c59d852ee51d"}, +] + +[package.extras] +toml = ["tomli"] + +[[package]] +name = "cycler" +version = "0.12.1" +description = "Composable style cycles" +optional = false +python-versions = ">=3.8" +files = [ + {file = "cycler-0.12.1-py3-none-any.whl", hash = "sha256:85cef7cff222d8644161529808465972e51340599459b8ac3ccbac5a854e0d30"}, + {file = "cycler-0.12.1.tar.gz", hash = "sha256:88bb128f02ba341da8ef447245a9e138fae777f6a23943da4540077d3601eb1c"}, +] + +[package.extras] +docs = ["ipython", "matplotlib", "numpydoc", "sphinx"] +tests = ["pytest", "pytest-cov", "pytest-xdist"] + +[[package]] +name = "dill" +version = "0.3.8" +description = "serialize all of Python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "dill-0.3.8-py3-none-any.whl", hash = "sha256:c36ca9ffb54365bdd2f8eb3eff7d2a21237f8452b57ace88b1ac615b7e815bd7"}, + {file = "dill-0.3.8.tar.gz", hash = "sha256:3ebe3c479ad625c4553aca177444d89b486b1d84982eeacded644afc0cf797ca"}, +] + +[package.extras] +graph = ["objgraph (>=1.7.2)"] +profile = ["gprof2dot (>=2022.7.29)"] + +[[package]] +name = "fonttools" +version = "4.53.1" +description = "Tools to manipulate font files" +optional = false +python-versions = ">=3.8" +files = [ + {file = "fonttools-4.53.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:0679a30b59d74b6242909945429dbddb08496935b82f91ea9bf6ad240ec23397"}, + {file = "fonttools-4.53.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:e8bf06b94694251861ba7fdeea15c8ec0967f84c3d4143ae9daf42bbc7717fe3"}, + {file = "fonttools-4.53.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b96cd370a61f4d083c9c0053bf634279b094308d52fdc2dd9a22d8372fdd590d"}, + {file = "fonttools-4.53.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a1c7c5aa18dd3b17995898b4a9b5929d69ef6ae2af5b96d585ff4005033d82f0"}, + {file = "fonttools-4.53.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:e013aae589c1c12505da64a7d8d023e584987e51e62006e1bb30d72f26522c41"}, + {file = "fonttools-4.53.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:9efd176f874cb6402e607e4cc9b4a9cd584d82fc34a4b0c811970b32ba62501f"}, + {file = "fonttools-4.53.1-cp310-cp310-win32.whl", hash = "sha256:c8696544c964500aa9439efb6761947393b70b17ef4e82d73277413f291260a4"}, + {file = "fonttools-4.53.1-cp310-cp310-win_amd64.whl", hash = "sha256:8959a59de5af6d2bec27489e98ef25a397cfa1774b375d5787509c06659b3671"}, + {file = "fonttools-4.53.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:da33440b1413bad53a8674393c5d29ce64d8c1a15ef8a77c642ffd900d07bfe1"}, + {file = "fonttools-4.53.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:5ff7e5e9bad94e3a70c5cd2fa27f20b9bb9385e10cddab567b85ce5d306ea923"}, + {file = "fonttools-4.53.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c6e7170d675d12eac12ad1a981d90f118c06cf680b42a2d74c6c931e54b50719"}, + {file = "fonttools-4.53.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bee32ea8765e859670c4447b0817514ca79054463b6b79784b08a8df3a4d78e3"}, + {file = "fonttools-4.53.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:6e08f572625a1ee682115223eabebc4c6a2035a6917eac6f60350aba297ccadb"}, + {file = "fonttools-4.53.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:b21952c092ffd827504de7e66b62aba26fdb5f9d1e435c52477e6486e9d128b2"}, + {file = "fonttools-4.53.1-cp311-cp311-win32.whl", hash = "sha256:9dfdae43b7996af46ff9da520998a32b105c7f098aeea06b2226b30e74fbba88"}, + {file = "fonttools-4.53.1-cp311-cp311-win_amd64.whl", hash = "sha256:d4d0096cb1ac7a77b3b41cd78c9b6bc4a400550e21dc7a92f2b5ab53ed74eb02"}, + {file = "fonttools-4.53.1-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:d92d3c2a1b39631a6131c2fa25b5406855f97969b068e7e08413325bc0afba58"}, + {file = "fonttools-4.53.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:3b3c8ebafbee8d9002bd8f1195d09ed2bd9ff134ddec37ee8f6a6375e6a4f0e8"}, + {file = "fonttools-4.53.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:32f029c095ad66c425b0ee85553d0dc326d45d7059dbc227330fc29b43e8ba60"}, + {file = "fonttools-4.53.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:10f5e6c3510b79ea27bb1ebfcc67048cde9ec67afa87c7dd7efa5c700491ac7f"}, + {file = "fonttools-4.53.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:f677ce218976496a587ab17140da141557beb91d2a5c1a14212c994093f2eae2"}, + {file = "fonttools-4.53.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:9e6ceba2a01b448e36754983d376064730690401da1dd104ddb543519470a15f"}, + {file = "fonttools-4.53.1-cp312-cp312-win32.whl", hash = "sha256:791b31ebbc05197d7aa096bbc7bd76d591f05905d2fd908bf103af4488e60670"}, + {file = "fonttools-4.53.1-cp312-cp312-win_amd64.whl", hash = "sha256:6ed170b5e17da0264b9f6fae86073be3db15fa1bd74061c8331022bca6d09bab"}, + {file = "fonttools-4.53.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:c818c058404eb2bba05e728d38049438afd649e3c409796723dfc17cd3f08749"}, + {file = "fonttools-4.53.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:651390c3b26b0c7d1f4407cad281ee7a5a85a31a110cbac5269de72a51551ba2"}, + {file = "fonttools-4.53.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e54f1bba2f655924c1138bbc7fa91abd61f45c68bd65ab5ed985942712864bbb"}, + {file = "fonttools-4.53.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c9cd19cf4fe0595ebdd1d4915882b9440c3a6d30b008f3cc7587c1da7b95be5f"}, + {file = "fonttools-4.53.1-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:2af40ae9cdcb204fc1d8f26b190aa16534fcd4f0df756268df674a270eab575d"}, + {file = "fonttools-4.53.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:35250099b0cfb32d799fb5d6c651220a642fe2e3c7d2560490e6f1d3f9ae9169"}, + {file = "fonttools-4.53.1-cp38-cp38-win32.whl", hash = "sha256:f08df60fbd8d289152079a65da4e66a447efc1d5d5a4d3f299cdd39e3b2e4a7d"}, + {file = "fonttools-4.53.1-cp38-cp38-win_amd64.whl", hash = "sha256:7b6b35e52ddc8fb0db562133894e6ef5b4e54e1283dff606fda3eed938c36fc8"}, + {file = "fonttools-4.53.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:75a157d8d26c06e64ace9df037ee93a4938a4606a38cb7ffaf6635e60e253b7a"}, + {file = "fonttools-4.53.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:4824c198f714ab5559c5be10fd1adf876712aa7989882a4ec887bf1ef3e00e31"}, + {file = "fonttools-4.53.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:becc5d7cb89c7b7afa8321b6bb3dbee0eec2b57855c90b3e9bf5fb816671fa7c"}, + {file = "fonttools-4.53.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:84ec3fb43befb54be490147b4a922b5314e16372a643004f182babee9f9c3407"}, + {file = "fonttools-4.53.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:73379d3ffdeecb376640cd8ed03e9d2d0e568c9d1a4e9b16504a834ebadc2dfb"}, + {file = "fonttools-4.53.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:02569e9a810f9d11f4ae82c391ebc6fb5730d95a0657d24d754ed7763fb2d122"}, + {file = "fonttools-4.53.1-cp39-cp39-win32.whl", hash = "sha256:aae7bd54187e8bf7fd69f8ab87b2885253d3575163ad4d669a262fe97f0136cb"}, + {file = "fonttools-4.53.1-cp39-cp39-win_amd64.whl", hash = "sha256:e5b708073ea3d684235648786f5f6153a48dc8762cdfe5563c57e80787c29fbb"}, + {file = "fonttools-4.53.1-py3-none-any.whl", hash = "sha256:f1f8758a2ad110bd6432203a344269f445a2907dc24ef6bccfd0ac4e14e0d71d"}, + {file = "fonttools-4.53.1.tar.gz", hash = "sha256:e128778a8e9bc11159ce5447f76766cefbd876f44bd79aff030287254e4752c4"}, +] + +[package.extras] +all = ["brotli (>=1.0.1)", "brotlicffi (>=0.8.0)", "fs (>=2.2.0,<3)", "lxml (>=4.0)", "lz4 (>=1.7.4.2)", "matplotlib", "munkres", "pycairo", "scipy", "skia-pathops (>=0.5.0)", "sympy", "uharfbuzz (>=0.23.0)", "unicodedata2 (>=15.1.0)", "xattr", "zopfli (>=0.1.4)"] +graphite = ["lz4 (>=1.7.4.2)"] +interpolatable = ["munkres", "pycairo", "scipy"] +lxml = ["lxml (>=4.0)"] +pathops = ["skia-pathops (>=0.5.0)"] +plot = ["matplotlib"] +repacker = ["uharfbuzz (>=0.23.0)"] +symfont = ["sympy"] +type1 = ["xattr"] +ufo = ["fs (>=2.2.0,<3)"] +unicode = ["unicodedata2 (>=15.1.0)"] +woff = ["brotli (>=1.0.1)", "brotlicffi (>=0.8.0)", "zopfli (>=0.1.4)"] + +[[package]] +name = "iniconfig" +version = "2.0.0" +description = "brain-dead simple config-ini parsing" +optional = false +python-versions = ">=3.7" +files = [ + {file = "iniconfig-2.0.0-py3-none-any.whl", hash = "sha256:b6a85871a79d2e3b22d2d1b94ac2824226a63c6b741c88f7ae975f18b6778374"}, + {file = "iniconfig-2.0.0.tar.gz", hash = "sha256:2d91e135bf72d31a410b17c16da610a82cb55f6b0477d1a902134b24a455b8b3"}, +] + +[[package]] +name = "isort" +version = "5.13.2" +description = "A Python utility / library to sort Python imports." +optional = false +python-versions = ">=3.8.0" +files = [ + {file = "isort-5.13.2-py3-none-any.whl", hash = "sha256:8ca5e72a8d85860d5a3fa69b8745237f2939afe12dbf656afbcb47fe72d947a6"}, + {file = "isort-5.13.2.tar.gz", hash = "sha256:48fdfcb9face5d58a4f6dde2e72a1fb8dcaf8ab26f95ab49fab84c2ddefb0109"}, +] + +[package.extras] +colors = ["colorama (>=0.4.6)"] + +[[package]] +name = "kiwisolver" +version = "1.4.5" +description = "A fast implementation of the Cassowary constraint solver" +optional = false +python-versions = ">=3.7" +files = [ + {file = "kiwisolver-1.4.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:05703cf211d585109fcd72207a31bb170a0f22144d68298dc5e61b3c946518af"}, + {file = "kiwisolver-1.4.5-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:146d14bebb7f1dc4d5fbf74f8a6cb15ac42baadee8912eb84ac0b3b2a3dc6ac3"}, + {file = "kiwisolver-1.4.5-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:6ef7afcd2d281494c0a9101d5c571970708ad911d028137cd558f02b851c08b4"}, + {file = "kiwisolver-1.4.5-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:9eaa8b117dc8337728e834b9c6e2611f10c79e38f65157c4c38e9400286f5cb1"}, + {file = "kiwisolver-1.4.5-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:ec20916e7b4cbfb1f12380e46486ec4bcbaa91a9c448b97023fde0d5bbf9e4ff"}, + {file = "kiwisolver-1.4.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:39b42c68602539407884cf70d6a480a469b93b81b7701378ba5e2328660c847a"}, + {file = "kiwisolver-1.4.5-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:aa12042de0171fad672b6c59df69106d20d5596e4f87b5e8f76df757a7c399aa"}, + {file = "kiwisolver-1.4.5-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2a40773c71d7ccdd3798f6489aaac9eee213d566850a9533f8d26332d626b82c"}, + {file = "kiwisolver-1.4.5-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:19df6e621f6d8b4b9c4d45f40a66839294ff2bb235e64d2178f7522d9170ac5b"}, + {file = "kiwisolver-1.4.5-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:83d78376d0d4fd884e2c114d0621624b73d2aba4e2788182d286309ebdeed770"}, + {file = "kiwisolver-1.4.5-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:e391b1f0a8a5a10ab3b9bb6afcfd74f2175f24f8975fb87ecae700d1503cdee0"}, + {file = "kiwisolver-1.4.5-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:852542f9481f4a62dbb5dd99e8ab7aedfeb8fb6342349a181d4036877410f525"}, + {file = "kiwisolver-1.4.5-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:59edc41b24031bc25108e210c0def6f6c2191210492a972d585a06ff246bb79b"}, + {file = "kiwisolver-1.4.5-cp310-cp310-win32.whl", hash = "sha256:a6aa6315319a052b4ee378aa171959c898a6183f15c1e541821c5c59beaa0238"}, + {file = "kiwisolver-1.4.5-cp310-cp310-win_amd64.whl", hash = "sha256:d0ef46024e6a3d79c01ff13801cb19d0cad7fd859b15037aec74315540acc276"}, + {file = "kiwisolver-1.4.5-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:11863aa14a51fd6ec28688d76f1735f8f69ab1fabf388851a595d0721af042f5"}, + {file = "kiwisolver-1.4.5-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:8ab3919a9997ab7ef2fbbed0cc99bb28d3c13e6d4b1ad36e97e482558a91be90"}, + {file = "kiwisolver-1.4.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:fcc700eadbbccbf6bc1bcb9dbe0786b4b1cb91ca0dcda336eef5c2beed37b797"}, + {file = "kiwisolver-1.4.5-cp311-cp311-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:dfdd7c0b105af050eb3d64997809dc21da247cf44e63dc73ff0fd20b96be55a9"}, + {file = "kiwisolver-1.4.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:76c6a5964640638cdeaa0c359382e5703e9293030fe730018ca06bc2010c4437"}, + {file = "kiwisolver-1.4.5-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bbea0db94288e29afcc4c28afbf3a7ccaf2d7e027489c449cf7e8f83c6346eb9"}, + {file = "kiwisolver-1.4.5-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ceec1a6bc6cab1d6ff5d06592a91a692f90ec7505d6463a88a52cc0eb58545da"}, + {file = "kiwisolver-1.4.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:040c1aebeda72197ef477a906782b5ab0d387642e93bda547336b8957c61022e"}, + {file = "kiwisolver-1.4.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:f91de7223d4c7b793867797bacd1ee53bfe7359bd70d27b7b58a04efbb9436c8"}, + {file = "kiwisolver-1.4.5-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:faae4860798c31530dd184046a900e652c95513796ef51a12bc086710c2eec4d"}, + {file = "kiwisolver-1.4.5-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:b0157420efcb803e71d1b28e2c287518b8808b7cf1ab8af36718fd0a2c453eb0"}, + {file = "kiwisolver-1.4.5-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:06f54715b7737c2fecdbf140d1afb11a33d59508a47bf11bb38ecf21dc9ab79f"}, + {file = "kiwisolver-1.4.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:fdb7adb641a0d13bdcd4ef48e062363d8a9ad4a182ac7647ec88f695e719ae9f"}, + {file = "kiwisolver-1.4.5-cp311-cp311-win32.whl", hash = "sha256:bb86433b1cfe686da83ce32a9d3a8dd308e85c76b60896d58f082136f10bffac"}, + {file = "kiwisolver-1.4.5-cp311-cp311-win_amd64.whl", hash = "sha256:6c08e1312a9cf1074d17b17728d3dfce2a5125b2d791527f33ffbe805200a355"}, + {file = "kiwisolver-1.4.5-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:32d5cf40c4f7c7b3ca500f8985eb3fb3a7dfc023215e876f207956b5ea26632a"}, + {file = "kiwisolver-1.4.5-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:f846c260f483d1fd217fe5ed7c173fb109efa6b1fc8381c8b7552c5781756192"}, + {file = "kiwisolver-1.4.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5ff5cf3571589b6d13bfbfd6bcd7a3f659e42f96b5fd1c4830c4cf21d4f5ef45"}, + {file = "kiwisolver-1.4.5-cp312-cp312-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7269d9e5f1084a653d575c7ec012ff57f0c042258bf5db0954bf551c158466e7"}, + {file = "kiwisolver-1.4.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:da802a19d6e15dffe4b0c24b38b3af68e6c1a68e6e1d8f30148c83864f3881db"}, + {file = "kiwisolver-1.4.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3aba7311af82e335dd1e36ffff68aaca609ca6290c2cb6d821a39aa075d8e3ff"}, + {file = "kiwisolver-1.4.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:763773d53f07244148ccac5b084da5adb90bfaee39c197554f01b286cf869228"}, + {file = "kiwisolver-1.4.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2270953c0d8cdab5d422bee7d2007f043473f9d2999631c86a223c9db56cbd16"}, + {file = "kiwisolver-1.4.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:d099e745a512f7e3bbe7249ca835f4d357c586d78d79ae8f1dcd4d8adeb9bda9"}, + {file = "kiwisolver-1.4.5-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:74db36e14a7d1ce0986fa104f7d5637aea5c82ca6326ed0ec5694280942d1162"}, + {file = "kiwisolver-1.4.5-cp312-cp312-musllinux_1_1_ppc64le.whl", hash = "sha256:7e5bab140c309cb3a6ce373a9e71eb7e4873c70c2dda01df6820474f9889d6d4"}, + {file = "kiwisolver-1.4.5-cp312-cp312-musllinux_1_1_s390x.whl", hash = "sha256:0f114aa76dc1b8f636d077979c0ac22e7cd8f3493abbab152f20eb8d3cda71f3"}, + {file = "kiwisolver-1.4.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:88a2df29d4724b9237fc0c6eaf2a1adae0cdc0b3e9f4d8e7dc54b16812d2d81a"}, + {file = "kiwisolver-1.4.5-cp312-cp312-win32.whl", hash = "sha256:72d40b33e834371fd330fb1472ca19d9b8327acb79a5821d4008391db8e29f20"}, + {file = "kiwisolver-1.4.5-cp312-cp312-win_amd64.whl", hash = "sha256:2c5674c4e74d939b9d91dda0fae10597ac7521768fec9e399c70a1f27e2ea2d9"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:3a2b053a0ab7a3960c98725cfb0bf5b48ba82f64ec95fe06f1d06c99b552e130"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3cd32d6c13807e5c66a7cbb79f90b553642f296ae4518a60d8d76243b0ad2898"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:59ec7b7c7e1a61061850d53aaf8e93db63dce0c936db1fda2658b70e4a1be709"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:da4cfb373035def307905d05041c1d06d8936452fe89d464743ae7fb8371078b"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2400873bccc260b6ae184b2b8a4fec0e4082d30648eadb7c3d9a13405d861e89"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:1b04139c4236a0f3aff534479b58f6f849a8b351e1314826c2d230849ed48985"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:4e66e81a5779b65ac21764c295087de82235597a2293d18d943f8e9e32746265"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:7931d8f1f67c4be9ba1dd9c451fb0eeca1a25b89e4d3f89e828fe12a519b782a"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-musllinux_1_1_ppc64le.whl", hash = "sha256:b3f7e75f3015df442238cca659f8baa5f42ce2a8582727981cbfa15fee0ee205"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-musllinux_1_1_s390x.whl", hash = "sha256:bbf1d63eef84b2e8c89011b7f2235b1e0bf7dacc11cac9431fc6468e99ac77fb"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:4c380469bd3f970ef677bf2bcba2b6b0b4d5c75e7a020fb863ef75084efad66f"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-win32.whl", hash = "sha256:9408acf3270c4b6baad483865191e3e582b638b1654a007c62e3efe96f09a9a3"}, + {file = "kiwisolver-1.4.5-cp37-cp37m-win_amd64.whl", hash = "sha256:5b94529f9b2591b7af5f3e0e730a4e0a41ea174af35a4fd067775f9bdfeee01a"}, + {file = "kiwisolver-1.4.5-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:11c7de8f692fc99816e8ac50d1d1aef4f75126eefc33ac79aac02c099fd3db71"}, + {file = "kiwisolver-1.4.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:53abb58632235cd154176ced1ae8f0d29a6657aa1aa9decf50b899b755bc2b93"}, + {file = "kiwisolver-1.4.5-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:88b9f257ca61b838b6f8094a62418421f87ac2a1069f7e896c36a7d86b5d4c29"}, + {file = "kiwisolver-1.4.5-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3195782b26fc03aa9c6913d5bad5aeb864bdc372924c093b0f1cebad603dd712"}, + {file = "kiwisolver-1.4.5-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fc579bf0f502e54926519451b920e875f433aceb4624a3646b3252b5caa9e0b6"}, + {file = "kiwisolver-1.4.5-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5a580c91d686376f0f7c295357595c5a026e6cbc3d77b7c36e290201e7c11ecb"}, + {file = "kiwisolver-1.4.5-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:cfe6ab8da05c01ba6fbea630377b5da2cd9bcbc6338510116b01c1bc939a2c18"}, + {file = "kiwisolver-1.4.5-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:d2e5a98f0ec99beb3c10e13b387f8db39106d53993f498b295f0c914328b1333"}, + {file = "kiwisolver-1.4.5-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:a51a263952b1429e429ff236d2f5a21c5125437861baeed77f5e1cc2d2c7c6da"}, + {file = "kiwisolver-1.4.5-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:3edd2fa14e68c9be82c5b16689e8d63d89fe927e56debd6e1dbce7a26a17f81b"}, + {file = "kiwisolver-1.4.5-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:74d1b44c6cfc897df648cc9fdaa09bc3e7679926e6f96df05775d4fb3946571c"}, + {file = "kiwisolver-1.4.5-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:76d9289ed3f7501012e05abb8358bbb129149dbd173f1f57a1bf1c22d19ab7cc"}, + {file = "kiwisolver-1.4.5-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:92dea1ffe3714fa8eb6a314d2b3c773208d865a0e0d35e713ec54eea08a66250"}, + {file = "kiwisolver-1.4.5-cp38-cp38-win32.whl", hash = "sha256:5c90ae8c8d32e472be041e76f9d2f2dbff4d0b0be8bd4041770eddb18cf49a4e"}, + {file = "kiwisolver-1.4.5-cp38-cp38-win_amd64.whl", hash = "sha256:c7940c1dc63eb37a67721b10d703247552416f719c4188c54e04334321351ced"}, + {file = "kiwisolver-1.4.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:9407b6a5f0d675e8a827ad8742e1d6b49d9c1a1da5d952a67d50ef5f4170b18d"}, + {file = "kiwisolver-1.4.5-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:15568384086b6df3c65353820a4473575dbad192e35010f622c6ce3eebd57af9"}, + {file = "kiwisolver-1.4.5-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:0dc9db8e79f0036e8173c466d21ef18e1befc02de8bf8aa8dc0813a6dc8a7046"}, + {file = "kiwisolver-1.4.5-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:cdc8a402aaee9a798b50d8b827d7ecf75edc5fb35ea0f91f213ff927c15f4ff0"}, + {file = "kiwisolver-1.4.5-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:6c3bd3cde54cafb87d74d8db50b909705c62b17c2099b8f2e25b461882e544ff"}, + {file = "kiwisolver-1.4.5-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:955e8513d07a283056b1396e9a57ceddbd272d9252c14f154d450d227606eb54"}, + {file = "kiwisolver-1.4.5-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:346f5343b9e3f00b8db8ba359350eb124b98c99efd0b408728ac6ebf38173958"}, + {file = "kiwisolver-1.4.5-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b9098e0049e88c6a24ff64545cdfc50807818ba6c1b739cae221bbbcbc58aad3"}, + {file = "kiwisolver-1.4.5-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:00bd361b903dc4bbf4eb165f24d1acbee754fce22ded24c3d56eec268658a5cf"}, + {file = "kiwisolver-1.4.5-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:7b8b454bac16428b22560d0a1cf0a09875339cab69df61d7805bf48919415901"}, + {file = "kiwisolver-1.4.5-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:f1d072c2eb0ad60d4c183f3fb44ac6f73fb7a8f16a2694a91f988275cbf352f9"}, + {file = "kiwisolver-1.4.5-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:31a82d498054cac9f6d0b53d02bb85811185bcb477d4b60144f915f3b3126342"}, + {file = "kiwisolver-1.4.5-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:6512cb89e334e4700febbffaaa52761b65b4f5a3cf33f960213d5656cea36a77"}, + {file = "kiwisolver-1.4.5-cp39-cp39-win32.whl", hash = "sha256:9db8ea4c388fdb0f780fe91346fd438657ea602d58348753d9fb265ce1bca67f"}, + {file = "kiwisolver-1.4.5-cp39-cp39-win_amd64.whl", hash = "sha256:59415f46a37f7f2efeec758353dd2eae1b07640d8ca0f0c42548ec4125492635"}, + {file = "kiwisolver-1.4.5-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:5c7b3b3a728dc6faf3fc372ef24f21d1e3cee2ac3e9596691d746e5a536de920"}, + {file = "kiwisolver-1.4.5-pp37-pypy37_pp73-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:620ced262a86244e2be10a676b646f29c34537d0d9cc8eb26c08f53d98013390"}, + {file = "kiwisolver-1.4.5-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:378a214a1e3bbf5ac4a8708304318b4f890da88c9e6a07699c4ae7174c09a68d"}, + {file = "kiwisolver-1.4.5-pp37-pypy37_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:aaf7be1207676ac608a50cd08f102f6742dbfc70e8d60c4db1c6897f62f71523"}, + {file = "kiwisolver-1.4.5-pp37-pypy37_pp73-win_amd64.whl", hash = "sha256:ba55dce0a9b8ff59495ddd050a0225d58bd0983d09f87cfe2b6aec4f2c1234e4"}, + {file = "kiwisolver-1.4.5-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:fd32ea360bcbb92d28933fc05ed09bffcb1704ba3fc7942e81db0fd4f81a7892"}, + {file = "kiwisolver-1.4.5-pp38-pypy38_pp73-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:5e7139af55d1688f8b960ee9ad5adafc4ac17c1c473fe07133ac092310d76544"}, + {file = "kiwisolver-1.4.5-pp38-pypy38_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:dced8146011d2bc2e883f9bd68618b8247387f4bbec46d7392b3c3b032640126"}, + {file = "kiwisolver-1.4.5-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c9bf3325c47b11b2e51bca0824ea217c7cd84491d8ac4eefd1e409705ef092bd"}, + {file = "kiwisolver-1.4.5-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:5794cf59533bc3f1b1c821f7206a3617999db9fbefc345360aafe2e067514929"}, + {file = "kiwisolver-1.4.5-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:e368f200bbc2e4f905b8e71eb38b3c04333bddaa6a2464a6355487b02bb7fb09"}, + {file = "kiwisolver-1.4.5-pp39-pypy39_pp73-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e5d706eba36b4c4d5bc6c6377bb6568098765e990cfc21ee16d13963fab7b3e7"}, + {file = "kiwisolver-1.4.5-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:85267bd1aa8880a9c88a8cb71e18d3d64d2751a790e6ca6c27b8ccc724bcd5ad"}, + {file = "kiwisolver-1.4.5-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:210ef2c3a1f03272649aff1ef992df2e724748918c4bc2d5a90352849eb40bea"}, + {file = "kiwisolver-1.4.5-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:11d011a7574eb3b82bcc9c1a1d35c1d7075677fdd15de527d91b46bd35e935ee"}, + {file = "kiwisolver-1.4.5.tar.gz", hash = "sha256:e57e563a57fb22a142da34f38acc2fc1a5c864bc29ca1517a88abc963e60d6ec"}, +] + +[[package]] +name = "matplotlib" +version = "3.9.1.post1" +description = "Python plotting package" +optional = false +python-versions = ">=3.9" +files = [ + {file = "matplotlib-3.9.1.post1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:3779ad3e8b72df22b8a622c5796bbcfabfa0069b835412e3c1dec8ee3de92d0c"}, + {file = "matplotlib-3.9.1.post1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ec400340f8628e8e2260d679078d4e9b478699f386e5cc8094e80a1cb0039c7c"}, + {file = "matplotlib-3.9.1.post1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:82c18791b8862ea095081f745b81f896b011c5a5091678fb33204fef641476af"}, + {file = "matplotlib-3.9.1.post1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:621a628389c09a6b9f609a238af8e66acecece1cfa12febc5fe4195114ba7446"}, + {file = "matplotlib-3.9.1.post1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:9a54734ca761ebb27cd4f0b6c2ede696ab6861052d7d7e7b8f7a6782665115f5"}, + {file = "matplotlib-3.9.1.post1-cp310-cp310-win_amd64.whl", hash = "sha256:0721f93db92311bb514e446842e2b21c004541dcca0281afa495053e017c5458"}, + {file = "matplotlib-3.9.1.post1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:b08b46058fe2a31ecb81ef6aa3611f41d871f6a8280e9057cb4016cb3d8e894a"}, + {file = "matplotlib-3.9.1.post1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:22b344e84fcc574f561b5731f89a7625db8ef80cdbb0026a8ea855a33e3429d1"}, + {file = "matplotlib-3.9.1.post1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4b49fee26d64aefa9f061b575f0f7b5fc4663e51f87375c7239efa3d30d908fa"}, + {file = "matplotlib-3.9.1.post1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:89eb7e89e2b57856533c5c98f018aa3254fa3789fcd86d5f80077b9034a54c9a"}, + {file = "matplotlib-3.9.1.post1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:c06e742bade41fda6176d4c9c78c9ea016e176cd338e62a1686384cb1eb8de41"}, + {file = "matplotlib-3.9.1.post1-cp311-cp311-win_amd64.whl", hash = "sha256:c44edab5b849e0fc1f1c9d6e13eaa35ef65925f7be45be891d9784709ad95561"}, + {file = "matplotlib-3.9.1.post1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:bf28b09986aee06393e808e661c3466be9c21eff443c9bc881bce04bfbb0c500"}, + {file = "matplotlib-3.9.1.post1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:92aeb8c439d4831510d8b9d5e39f31c16c7f37873879767c26b147cef61e54cd"}, + {file = "matplotlib-3.9.1.post1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f15798b0691b45c80d3320358a88ce5a9d6f518b28575b3ea3ed31b4bd95d009"}, + {file = "matplotlib-3.9.1.post1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d59fc6096da7b9c1df275f9afc3fef5cbf634c21df9e5f844cba3dd8deb1847d"}, + {file = "matplotlib-3.9.1.post1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:ab986817a32a70ce22302438691e7df4c6ee4a844d47289db9d583d873491e0b"}, + {file = "matplotlib-3.9.1.post1-cp312-cp312-win_amd64.whl", hash = "sha256:0d78e7d2d86c4472da105d39aba9b754ed3dfeaeaa4ac7206b82706e0a5362fa"}, + {file = "matplotlib-3.9.1.post1-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:bd07eba6431b4dc9253cce6374a28c415e1d3a7dc9f8aba028ea7592f06fe172"}, + {file = "matplotlib-3.9.1.post1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ca230cc4482010d646827bd2c6d140c98c361e769ae7d954ebf6fff2a226f5b1"}, + {file = "matplotlib-3.9.1.post1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ace27c0fdeded399cbc43f22ffa76e0f0752358f5b33106ec7197534df08725a"}, + {file = "matplotlib-3.9.1.post1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9a4f3aeb7ba14c497dc6f021a076c48c2e5fbdf3da1e7264a5d649683e284a2f"}, + {file = "matplotlib-3.9.1.post1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:23f96fbd4ff4cfa9b8a6b685a65e7eb3c2ced724a8d965995ec5c9c2b1f7daf5"}, + {file = "matplotlib-3.9.1.post1-cp39-cp39-win_amd64.whl", hash = "sha256:2808b95452b4ffa14bfb7c7edffc5350743c31bda495f0d63d10fdd9bc69e895"}, + {file = "matplotlib-3.9.1.post1-pp39-pypy39_pp73-macosx_10_15_x86_64.whl", hash = "sha256:ffc91239f73b4179dec256b01299d46d0ffa9d27d98494bc1476a651b7821cbe"}, + {file = "matplotlib-3.9.1.post1-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:f965ebca9fd4feaaca45937c4849d92b70653057497181100fcd1e18161e5f29"}, + {file = "matplotlib-3.9.1.post1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:801ee9323fd7b2da0d405aebbf98d1da77ea430bbbbbec6834c0b3af15e5db44"}, + {file = "matplotlib-3.9.1.post1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:50113e9b43ceb285739f35d43db36aa752fb8154325b35d134ff6e177452f9ec"}, + {file = "matplotlib-3.9.1.post1.tar.gz", hash = "sha256:c91e585c65092c975a44dc9d4239ba8c594ba3c193d7c478b6d178c4ef61f406"}, +] + +[package.dependencies] +contourpy = ">=1.0.1" +cycler = ">=0.10" +fonttools = ">=4.22.0" +kiwisolver = ">=1.3.1" +numpy = ">=1.23" +packaging = ">=20.0" +pillow = ">=8" +pyparsing = ">=2.3.1" +python-dateutil = ">=2.7" + +[package.extras] +dev = ["meson-python (>=0.13.1)", "numpy (>=1.25)", "pybind11 (>=2.6)", "setuptools (>=64)", "setuptools_scm (>=7)"] + +[[package]] +name = "mccabe" +version = "0.7.0" +description = "McCabe checker, plugin for flake8" +optional = false +python-versions = ">=3.6" +files = [ + {file = "mccabe-0.7.0-py2.py3-none-any.whl", hash = "sha256:6c2d30ab6be0e4a46919781807b4f0d834ebdd6c6e3dca0bda5a15f863427b6e"}, + {file = "mccabe-0.7.0.tar.gz", hash = "sha256:348e0240c33b60bbdf4e523192ef919f28cb2c3d7d5c7794f74009290f236325"}, +] + +[[package]] +name = "mypy" +version = "1.11.1" +description = "Optional static typing for Python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "mypy-1.11.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:a32fc80b63de4b5b3e65f4be82b4cfa362a46702672aa6a0f443b4689af7008c"}, + {file = "mypy-1.11.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c1952f5ea8a5a959b05ed5f16452fddadbaae48b5d39235ab4c3fc444d5fd411"}, + {file = "mypy-1.11.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e1e30dc3bfa4e157e53c1d17a0dad20f89dc433393e7702b813c10e200843b03"}, + {file = "mypy-1.11.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:2c63350af88f43a66d3dfeeeb8d77af34a4f07d760b9eb3a8697f0386c7590b4"}, + {file = "mypy-1.11.1-cp310-cp310-win_amd64.whl", hash = "sha256:a831671bad47186603872a3abc19634f3011d7f83b083762c942442d51c58d58"}, + {file = "mypy-1.11.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:7b6343d338390bb946d449677726edf60102a1c96079b4f002dedff375953fc5"}, + {file = "mypy-1.11.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e4fe9f4e5e521b458d8feb52547f4bade7ef8c93238dfb5bbc790d9ff2d770ca"}, + {file = "mypy-1.11.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:886c9dbecc87b9516eff294541bf7f3655722bf22bb898ee06985cd7269898de"}, + {file = "mypy-1.11.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:fca4a60e1dd9fd0193ae0067eaeeb962f2d79e0d9f0f66223a0682f26ffcc809"}, + {file = "mypy-1.11.1-cp311-cp311-win_amd64.whl", hash = "sha256:0bd53faf56de9643336aeea1c925012837432b5faf1701ccca7fde70166ccf72"}, + {file = "mypy-1.11.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:f39918a50f74dc5969807dcfaecafa804fa7f90c9d60506835036cc1bc891dc8"}, + {file = "mypy-1.11.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0bc71d1fb27a428139dd78621953effe0d208aed9857cb08d002280b0422003a"}, + {file = "mypy-1.11.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b868d3bcff720dd7217c383474008ddabaf048fad8d78ed948bb4b624870a417"}, + {file = "mypy-1.11.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:a707ec1527ffcdd1c784d0924bf5cb15cd7f22683b919668a04d2b9c34549d2e"}, + {file = "mypy-1.11.1-cp312-cp312-win_amd64.whl", hash = "sha256:64f4a90e3ea07f590c5bcf9029035cf0efeae5ba8be511a8caada1a4893f5525"}, + {file = "mypy-1.11.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:749fd3213916f1751fff995fccf20c6195cae941dc968f3aaadf9bb4e430e5a2"}, + {file = "mypy-1.11.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:b639dce63a0b19085213ec5fdd8cffd1d81988f47a2dec7100e93564f3e8fb3b"}, + {file = "mypy-1.11.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4c956b49c5d865394d62941b109728c5c596a415e9c5b2be663dd26a1ff07bc0"}, + {file = "mypy-1.11.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:45df906e8b6804ef4b666af29a87ad9f5921aad091c79cc38e12198e220beabd"}, + {file = "mypy-1.11.1-cp38-cp38-win_amd64.whl", hash = "sha256:d44be7551689d9d47b7abc27c71257adfdb53f03880841a5db15ddb22dc63edb"}, + {file = "mypy-1.11.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:2684d3f693073ab89d76da8e3921883019ea8a3ec20fa5d8ecca6a2db4c54bbe"}, + {file = "mypy-1.11.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:79c07eb282cb457473add5052b63925e5cc97dfab9812ee65a7c7ab5e3cb551c"}, + {file = "mypy-1.11.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11965c2f571ded6239977b14deebd3f4c3abd9a92398712d6da3a772974fad69"}, + {file = "mypy-1.11.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:a2b43895a0f8154df6519706d9bca8280cda52d3d9d1514b2d9c3e26792a0b74"}, + {file = "mypy-1.11.1-cp39-cp39-win_amd64.whl", hash = "sha256:1a81cf05975fd61aec5ae16501a091cfb9f605dc3e3c878c0da32f250b74760b"}, + {file = "mypy-1.11.1-py3-none-any.whl", hash = "sha256:0624bdb940255d2dd24e829d99a13cfeb72e4e9031f9492148f410ed30bcab54"}, + {file = "mypy-1.11.1.tar.gz", hash = "sha256:f404a0b069709f18bbdb702eb3dcfe51910602995de00bd39cea3050b5772d08"}, +] + +[package.dependencies] +mypy-extensions = ">=1.0.0" +typing-extensions = ">=4.6.0" + +[package.extras] +dmypy = ["psutil (>=4.0)"] +install-types = ["pip"] +mypyc = ["setuptools (>=50)"] +reports = ["lxml"] + +[[package]] +name = "mypy-extensions" +version = "1.0.0" +description = "Type system extensions for programs checked with the mypy type checker." +optional = false +python-versions = ">=3.5" +files = [ + {file = "mypy_extensions-1.0.0-py3-none-any.whl", hash = "sha256:4392f6c0eb8a5668a69e23d168ffa70f0be9ccfd32b5cc2d26a34ae5b844552d"}, + {file = "mypy_extensions-1.0.0.tar.gz", hash = "sha256:75dbf8955dc00442a438fc4d0666508a9a97b6bd41aa2f0ffe9d2f2725af0782"}, +] + +[[package]] +name = "numpy" +version = "2.0.1" +description = "Fundamental package for array computing in Python" +optional = false +python-versions = ">=3.9" +files = [ + {file = "numpy-2.0.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:0fbb536eac80e27a2793ffd787895242b7f18ef792563d742c2d673bfcb75134"}, + {file = "numpy-2.0.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:69ff563d43c69b1baba77af455dd0a839df8d25e8590e79c90fcbe1499ebde42"}, + {file = "numpy-2.0.1-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:1b902ce0e0a5bb7704556a217c4f63a7974f8f43e090aff03fcf262e0b135e02"}, + {file = "numpy-2.0.1-cp310-cp310-macosx_14_0_x86_64.whl", hash = "sha256:f1659887361a7151f89e79b276ed8dff3d75877df906328f14d8bb40bb4f5101"}, + {file = "numpy-2.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4658c398d65d1b25e1760de3157011a80375da861709abd7cef3bad65d6543f9"}, + {file = "numpy-2.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4127d4303b9ac9f94ca0441138acead39928938660ca58329fe156f84b9f3015"}, + {file = "numpy-2.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:e5eeca8067ad04bc8a2a8731183d51d7cbaac66d86085d5f4766ee6bf19c7f87"}, + {file = "numpy-2.0.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:9adbd9bb520c866e1bfd7e10e1880a1f7749f1f6e5017686a5fbb9b72cf69f82"}, + {file = "numpy-2.0.1-cp310-cp310-win32.whl", hash = "sha256:7b9853803278db3bdcc6cd5beca37815b133e9e77ff3d4733c247414e78eb8d1"}, + {file = "numpy-2.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:81b0893a39bc5b865b8bf89e9ad7807e16717f19868e9d234bdaf9b1f1393868"}, + {file = "numpy-2.0.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:75b4e316c5902d8163ef9d423b1c3f2f6252226d1aa5cd8a0a03a7d01ffc6268"}, + {file = "numpy-2.0.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:6e4eeb6eb2fced786e32e6d8df9e755ce5be920d17f7ce00bc38fcde8ccdbf9e"}, + {file = "numpy-2.0.1-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:a1e01dcaab205fbece13c1410253a9eea1b1c9b61d237b6fa59bcc46e8e89343"}, + {file = "numpy-2.0.1-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:a8fc2de81ad835d999113ddf87d1ea2b0f4704cbd947c948d2f5513deafe5a7b"}, + {file = "numpy-2.0.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5a3d94942c331dd4e0e1147f7a8699a4aa47dffc11bf8a1523c12af8b2e91bbe"}, + {file = "numpy-2.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:15eb4eca47d36ec3f78cde0a3a2ee24cf05ca7396ef808dda2c0ddad7c2bde67"}, + {file = "numpy-2.0.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:b83e16a5511d1b1f8a88cbabb1a6f6a499f82c062a4251892d9ad5d609863fb7"}, + {file = "numpy-2.0.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1f87fec1f9bc1efd23f4227becff04bd0e979e23ca50cc92ec88b38489db3b55"}, + {file = "numpy-2.0.1-cp311-cp311-win32.whl", hash = "sha256:36d3a9405fd7c511804dc56fc32974fa5533bdeb3cd1604d6b8ff1d292b819c4"}, + {file = "numpy-2.0.1-cp311-cp311-win_amd64.whl", hash = "sha256:08458fbf403bff5e2b45f08eda195d4b0c9b35682311da5a5a0a0925b11b9bd8"}, + {file = "numpy-2.0.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:6bf4e6f4a2a2e26655717a1983ef6324f2664d7011f6ef7482e8c0b3d51e82ac"}, + {file = "numpy-2.0.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7d6fddc5fe258d3328cd8e3d7d3e02234c5d70e01ebe377a6ab92adb14039cb4"}, + {file = "numpy-2.0.1-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:5daab361be6ddeb299a918a7c0864fa8618af66019138263247af405018b04e1"}, + {file = "numpy-2.0.1-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:ea2326a4dca88e4a274ba3a4405eb6c6467d3ffbd8c7d38632502eaae3820587"}, + {file = "numpy-2.0.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:529af13c5f4b7a932fb0e1911d3a75da204eff023ee5e0e79c1751564221a5c8"}, + {file = "numpy-2.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6790654cb13eab303d8402354fabd47472b24635700f631f041bd0b65e37298a"}, + {file = "numpy-2.0.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:cbab9fc9c391700e3e1287666dfd82d8666d10e69a6c4a09ab97574c0b7ee0a7"}, + {file = "numpy-2.0.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:99d0d92a5e3613c33a5f01db206a33f8fdf3d71f2912b0de1739894668b7a93b"}, + {file = "numpy-2.0.1-cp312-cp312-win32.whl", hash = "sha256:173a00b9995f73b79eb0191129f2455f1e34c203f559dd118636858cc452a1bf"}, + {file = "numpy-2.0.1-cp312-cp312-win_amd64.whl", hash = "sha256:bb2124fdc6e62baae159ebcfa368708867eb56806804d005860b6007388df171"}, + {file = "numpy-2.0.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:bfc085b28d62ff4009364e7ca34b80a9a080cbd97c2c0630bb5f7f770dae9414"}, + {file = "numpy-2.0.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:8fae4ebbf95a179c1156fab0b142b74e4ba4204c87bde8d3d8b6f9c34c5825ef"}, + {file = "numpy-2.0.1-cp39-cp39-macosx_14_0_arm64.whl", hash = "sha256:72dc22e9ec8f6eaa206deb1b1355eb2e253899d7347f5e2fae5f0af613741d06"}, + {file = "numpy-2.0.1-cp39-cp39-macosx_14_0_x86_64.whl", hash = "sha256:ec87f5f8aca726117a1c9b7083e7656a9d0d606eec7299cc067bb83d26f16e0c"}, + {file = "numpy-2.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1f682ea61a88479d9498bf2091fdcd722b090724b08b31d63e022adc063bad59"}, + {file = "numpy-2.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8efc84f01c1cd7e34b3fb310183e72fcdf55293ee736d679b6d35b35d80bba26"}, + {file = "numpy-2.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:3fdabe3e2a52bc4eff8dc7a5044342f8bd9f11ef0934fcd3289a788c0eb10018"}, + {file = "numpy-2.0.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:24a0e1befbfa14615b49ba9659d3d8818a0f4d8a1c5822af8696706fbda7310c"}, + {file = "numpy-2.0.1-cp39-cp39-win32.whl", hash = "sha256:f9cf5ea551aec449206954b075db819f52adc1638d46a6738253a712d553c7b4"}, + {file = "numpy-2.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:e9e81fa9017eaa416c056e5d9e71be93d05e2c3c2ab308d23307a8bc4443c368"}, + {file = "numpy-2.0.1-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:61728fba1e464f789b11deb78a57805c70b2ed02343560456190d0501ba37b0f"}, + {file = "numpy-2.0.1-pp39-pypy39_pp73-macosx_14_0_x86_64.whl", hash = "sha256:12f5d865d60fb9734e60a60f1d5afa6d962d8d4467c120a1c0cda6eb2964437d"}, + {file = "numpy-2.0.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eacf3291e263d5a67d8c1a581a8ebbcfd6447204ef58828caf69a5e3e8c75990"}, + {file = "numpy-2.0.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:2c3a346ae20cfd80b6cfd3e60dc179963ef2ea58da5ec074fd3d9e7a1e7ba97f"}, + {file = "numpy-2.0.1.tar.gz", hash = "sha256:485b87235796410c3519a699cfe1faab097e509e90ebb05dcd098db2ae87e7b3"}, +] + +[[package]] +name = "packaging" +version = "24.1" +description = "Core utilities for Python packages" +optional = false +python-versions = ">=3.8" +files = [ + {file = "packaging-24.1-py3-none-any.whl", hash = "sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124"}, + {file = "packaging-24.1.tar.gz", hash = "sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002"}, +] + +[[package]] +name = "pandas" +version = "2.2.2" +description = "Powerful data structures for data analysis, time series, and statistics" +optional = false +python-versions = ">=3.9" +files = [ + {file = "pandas-2.2.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:90c6fca2acf139569e74e8781709dccb6fe25940488755716d1d354d6bc58bce"}, + {file = "pandas-2.2.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c7adfc142dac335d8c1e0dcbd37eb8617eac386596eb9e1a1b77791cf2498238"}, + {file = "pandas-2.2.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4abfe0be0d7221be4f12552995e58723c7422c80a659da13ca382697de830c08"}, + {file = "pandas-2.2.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8635c16bf3d99040fdf3ca3db669a7250ddf49c55dc4aa8fe0ae0fa8d6dcc1f0"}, + {file = "pandas-2.2.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:40ae1dffb3967a52203105a077415a86044a2bea011b5f321c6aa64b379a3f51"}, + {file = "pandas-2.2.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:8e5a0b00e1e56a842f922e7fae8ae4077aee4af0acb5ae3622bd4b4c30aedf99"}, + {file = "pandas-2.2.2-cp310-cp310-win_amd64.whl", hash = "sha256:ddf818e4e6c7c6f4f7c8a12709696d193976b591cc7dc50588d3d1a6b5dc8772"}, + {file = "pandas-2.2.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:696039430f7a562b74fa45f540aca068ea85fa34c244d0deee539cb6d70aa288"}, + {file = "pandas-2.2.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:8e90497254aacacbc4ea6ae5e7a8cd75629d6ad2b30025a4a8b09aa4faf55151"}, + {file = "pandas-2.2.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:58b84b91b0b9f4bafac2a0ac55002280c094dfc6402402332c0913a59654ab2b"}, + {file = "pandas-2.2.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6d2123dc9ad6a814bcdea0f099885276b31b24f7edf40f6cdbc0912672e22eee"}, + {file = "pandas-2.2.2-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:2925720037f06e89af896c70bca73459d7e6a4be96f9de79e2d440bd499fe0db"}, + {file = "pandas-2.2.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:0cace394b6ea70c01ca1595f839cf193df35d1575986e484ad35c4aeae7266c1"}, + {file = "pandas-2.2.2-cp311-cp311-win_amd64.whl", hash = "sha256:873d13d177501a28b2756375d59816c365e42ed8417b41665f346289adc68d24"}, + {file = "pandas-2.2.2-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:9dfde2a0ddef507a631dc9dc4af6a9489d5e2e740e226ad426a05cabfbd7c8ef"}, + {file = "pandas-2.2.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:e9b79011ff7a0f4b1d6da6a61aa1aa604fb312d6647de5bad20013682d1429ce"}, + {file = "pandas-2.2.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1cb51fe389360f3b5a4d57dbd2848a5f033350336ca3b340d1c53a1fad33bcad"}, + {file = "pandas-2.2.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eee3a87076c0756de40b05c5e9a6069c035ba43e8dd71c379e68cab2c20f16ad"}, + {file = "pandas-2.2.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:3e374f59e440d4ab45ca2fffde54b81ac3834cf5ae2cdfa69c90bc03bde04d76"}, + {file = "pandas-2.2.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:43498c0bdb43d55cb162cdc8c06fac328ccb5d2eabe3cadeb3529ae6f0517c32"}, + {file = "pandas-2.2.2-cp312-cp312-win_amd64.whl", hash = "sha256:d187d355ecec3629624fccb01d104da7d7f391db0311145817525281e2804d23"}, + {file = "pandas-2.2.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:0ca6377b8fca51815f382bd0b697a0814c8bda55115678cbc94c30aacbb6eff2"}, + {file = "pandas-2.2.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:9057e6aa78a584bc93a13f0a9bf7e753a5e9770a30b4d758b8d5f2a62a9433cd"}, + {file = "pandas-2.2.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:001910ad31abc7bf06f49dcc903755d2f7f3a9186c0c040b827e522e9cef0863"}, + {file = "pandas-2.2.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66b479b0bd07204e37583c191535505410daa8df638fd8e75ae1b383851fe921"}, + {file = "pandas-2.2.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:a77e9d1c386196879aa5eb712e77461aaee433e54c68cf253053a73b7e49c33a"}, + {file = "pandas-2.2.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:92fd6b027924a7e178ac202cfbe25e53368db90d56872d20ffae94b96c7acc57"}, + {file = "pandas-2.2.2-cp39-cp39-win_amd64.whl", hash = "sha256:640cef9aa381b60e296db324337a554aeeb883ead99dc8f6c18e81a93942f5f4"}, + {file = "pandas-2.2.2.tar.gz", hash = "sha256:9e79019aba43cb4fda9e4d983f8e88ca0373adbb697ae9c6c43093218de28b54"}, +] + +[package.dependencies] +numpy = [ + {version = ">=1.23.2", markers = "python_version == \"3.11\""}, + {version = ">=1.26.0", markers = "python_version >= \"3.12\""}, +] +python-dateutil = ">=2.8.2" +pytz = ">=2020.1" +tzdata = ">=2022.7" + +[package.extras] +all = ["PyQt5 (>=5.15.9)", "SQLAlchemy (>=2.0.0)", "adbc-driver-postgresql (>=0.8.0)", "adbc-driver-sqlite (>=0.8.0)", "beautifulsoup4 (>=4.11.2)", "bottleneck (>=1.3.6)", "dataframe-api-compat (>=0.1.7)", "fastparquet (>=2022.12.0)", "fsspec (>=2022.11.0)", "gcsfs (>=2022.11.0)", "html5lib (>=1.1)", "hypothesis (>=6.46.1)", "jinja2 (>=3.1.2)", "lxml (>=4.9.2)", "matplotlib (>=3.6.3)", "numba (>=0.56.4)", "numexpr (>=2.8.4)", "odfpy (>=1.4.1)", "openpyxl (>=3.1.0)", "pandas-gbq (>=0.19.0)", "psycopg2 (>=2.9.6)", "pyarrow (>=10.0.1)", "pymysql (>=1.0.2)", "pyreadstat (>=1.2.0)", "pytest (>=7.3.2)", "pytest-xdist (>=2.2.0)", "python-calamine (>=0.1.7)", "pyxlsb (>=1.0.10)", "qtpy (>=2.3.0)", "s3fs (>=2022.11.0)", "scipy (>=1.10.0)", "tables (>=3.8.0)", "tabulate (>=0.9.0)", "xarray (>=2022.12.0)", "xlrd (>=2.0.1)", "xlsxwriter (>=3.0.5)", "zstandard (>=0.19.0)"] +aws = ["s3fs (>=2022.11.0)"] +clipboard = ["PyQt5 (>=5.15.9)", "qtpy (>=2.3.0)"] +compression = ["zstandard (>=0.19.0)"] +computation = ["scipy (>=1.10.0)", "xarray (>=2022.12.0)"] +consortium-standard = ["dataframe-api-compat (>=0.1.7)"] +excel = ["odfpy (>=1.4.1)", "openpyxl (>=3.1.0)", "python-calamine (>=0.1.7)", "pyxlsb (>=1.0.10)", "xlrd (>=2.0.1)", "xlsxwriter (>=3.0.5)"] +feather = ["pyarrow (>=10.0.1)"] +fss = ["fsspec (>=2022.11.0)"] +gcp = ["gcsfs (>=2022.11.0)", "pandas-gbq (>=0.19.0)"] +hdf5 = ["tables (>=3.8.0)"] +html = ["beautifulsoup4 (>=4.11.2)", "html5lib (>=1.1)", "lxml (>=4.9.2)"] +mysql = ["SQLAlchemy (>=2.0.0)", "pymysql (>=1.0.2)"] +output-formatting = ["jinja2 (>=3.1.2)", "tabulate (>=0.9.0)"] +parquet = ["pyarrow (>=10.0.1)"] +performance = ["bottleneck (>=1.3.6)", "numba (>=0.56.4)", "numexpr (>=2.8.4)"] +plot = ["matplotlib (>=3.6.3)"] +postgresql = ["SQLAlchemy (>=2.0.0)", "adbc-driver-postgresql (>=0.8.0)", "psycopg2 (>=2.9.6)"] +pyarrow = ["pyarrow (>=10.0.1)"] +spss = ["pyreadstat (>=1.2.0)"] +sql-other = ["SQLAlchemy (>=2.0.0)", "adbc-driver-postgresql (>=0.8.0)", "adbc-driver-sqlite (>=0.8.0)"] +test = ["hypothesis (>=6.46.1)", "pytest (>=7.3.2)", "pytest-xdist (>=2.2.0)"] +xml = ["lxml (>=4.9.2)"] + +[[package]] +name = "pandas-stubs" +version = "2.2.2.240807" +description = "Type annotations for pandas" +optional = false +python-versions = ">=3.9" +files = [ + {file = "pandas_stubs-2.2.2.240807-py3-none-any.whl", hash = "sha256:893919ad82be4275f0d07bb47a95d08bae580d3fdea308a7acfcb3f02e76186e"}, + {file = "pandas_stubs-2.2.2.240807.tar.gz", hash = "sha256:64a559725a57a449f46225fbafc422520b7410bff9252b661a225b5559192a93"}, +] + +[package.dependencies] +numpy = ">=1.23.5" +types-pytz = ">=2022.1.1" + +[[package]] +name = "pathspec" +version = "0.12.1" +description = "Utility library for gitignore style pattern matching of file paths." +optional = false +python-versions = ">=3.8" +files = [ + {file = "pathspec-0.12.1-py3-none-any.whl", hash = "sha256:a0d503e138a4c123b27490a4f7beda6a01c6f288df0e4a8b79c7eb0dc7b4cc08"}, + {file = "pathspec-0.12.1.tar.gz", hash = "sha256:a482d51503a1ab33b1c67a6c3813a26953dbdc71c31dacaef9a838c4e29f5712"}, +] + +[[package]] +name = "pillow" +version = "10.4.0" +description = "Python Imaging Library (Fork)" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pillow-10.4.0-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:4d9667937cfa347525b319ae34375c37b9ee6b525440f3ef48542fcf66f2731e"}, + {file = "pillow-10.4.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:543f3dc61c18dafb755773efc89aae60d06b6596a63914107f75459cf984164d"}, + {file = "pillow-10.4.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7928ecbf1ece13956b95d9cbcfc77137652b02763ba384d9ab508099a2eca856"}, + {file = "pillow-10.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e4d49b85c4348ea0b31ea63bc75a9f3857869174e2bf17e7aba02945cd218e6f"}, + {file = "pillow-10.4.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:6c762a5b0997f5659a5ef2266abc1d8851ad7749ad9a6a5506eb23d314e4f46b"}, + {file = "pillow-10.4.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:a985e028fc183bf12a77a8bbf36318db4238a3ded7fa9df1b9a133f1cb79f8fc"}, + {file = "pillow-10.4.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:812f7342b0eee081eaec84d91423d1b4650bb9828eb53d8511bcef8ce5aecf1e"}, + {file = "pillow-10.4.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:ac1452d2fbe4978c2eec89fb5a23b8387aba707ac72810d9490118817d9c0b46"}, + {file = "pillow-10.4.0-cp310-cp310-win32.whl", hash = "sha256:bcd5e41a859bf2e84fdc42f4edb7d9aba0a13d29a2abadccafad99de3feff984"}, + {file = "pillow-10.4.0-cp310-cp310-win_amd64.whl", hash = "sha256:ecd85a8d3e79cd7158dec1c9e5808e821feea088e2f69a974db5edf84dc53141"}, + {file = "pillow-10.4.0-cp310-cp310-win_arm64.whl", hash = "sha256:ff337c552345e95702c5fde3158acb0625111017d0e5f24bf3acdb9cc16b90d1"}, + {file = "pillow-10.4.0-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:0a9ec697746f268507404647e531e92889890a087e03681a3606d9b920fbee3c"}, + {file = "pillow-10.4.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dfe91cb65544a1321e631e696759491ae04a2ea11d36715eca01ce07284738be"}, + {file = "pillow-10.4.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5dc6761a6efc781e6a1544206f22c80c3af4c8cf461206d46a1e6006e4429ff3"}, + {file = "pillow-10.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5e84b6cc6a4a3d76c153a6b19270b3526a5a8ed6b09501d3af891daa2a9de7d6"}, + {file = "pillow-10.4.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:bbc527b519bd3aa9d7f429d152fea69f9ad37c95f0b02aebddff592688998abe"}, + {file = "pillow-10.4.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:76a911dfe51a36041f2e756b00f96ed84677cdeb75d25c767f296c1c1eda1319"}, + {file = "pillow-10.4.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:59291fb29317122398786c2d44427bbd1a6d7ff54017075b22be9d21aa59bd8d"}, + {file = "pillow-10.4.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:416d3a5d0e8cfe4f27f574362435bc9bae57f679a7158e0096ad2beb427b8696"}, + {file = "pillow-10.4.0-cp311-cp311-win32.whl", hash = "sha256:7086cc1d5eebb91ad24ded9f58bec6c688e9f0ed7eb3dbbf1e4800280a896496"}, + {file = "pillow-10.4.0-cp311-cp311-win_amd64.whl", hash = "sha256:cbed61494057c0f83b83eb3a310f0bf774b09513307c434d4366ed64f4128a91"}, + {file = "pillow-10.4.0-cp311-cp311-win_arm64.whl", hash = "sha256:f5f0c3e969c8f12dd2bb7e0b15d5c468b51e5017e01e2e867335c81903046a22"}, + {file = "pillow-10.4.0-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:673655af3eadf4df6b5457033f086e90299fdd7a47983a13827acf7459c15d94"}, + {file = "pillow-10.4.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:866b6942a92f56300012f5fbac71f2d610312ee65e22f1aa2609e491284e5597"}, + {file = "pillow-10.4.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:29dbdc4207642ea6aad70fbde1a9338753d33fb23ed6956e706936706f52dd80"}, + {file = "pillow-10.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bf2342ac639c4cf38799a44950bbc2dfcb685f052b9e262f446482afaf4bffca"}, + {file = "pillow-10.4.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:f5b92f4d70791b4a67157321c4e8225d60b119c5cc9aee8ecf153aace4aad4ef"}, + {file = "pillow-10.4.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:86dcb5a1eb778d8b25659d5e4341269e8590ad6b4e8b44d9f4b07f8d136c414a"}, + {file = "pillow-10.4.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:780c072c2e11c9b2c7ca37f9a2ee8ba66f44367ac3e5c7832afcfe5104fd6d1b"}, + {file = "pillow-10.4.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:37fb69d905be665f68f28a8bba3c6d3223c8efe1edf14cc4cfa06c241f8c81d9"}, + {file = "pillow-10.4.0-cp312-cp312-win32.whl", hash = "sha256:7dfecdbad5c301d7b5bde160150b4db4c659cee2b69589705b6f8a0c509d9f42"}, + {file = "pillow-10.4.0-cp312-cp312-win_amd64.whl", hash = "sha256:1d846aea995ad352d4bdcc847535bd56e0fd88d36829d2c90be880ef1ee4668a"}, + {file = "pillow-10.4.0-cp312-cp312-win_arm64.whl", hash = "sha256:e553cad5179a66ba15bb18b353a19020e73a7921296a7979c4a2b7f6a5cd57f9"}, + {file = "pillow-10.4.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8bc1a764ed8c957a2e9cacf97c8b2b053b70307cf2996aafd70e91a082e70df3"}, + {file = "pillow-10.4.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6209bb41dc692ddfee4942517c19ee81b86c864b626dbfca272ec0f7cff5d9fb"}, + {file = "pillow-10.4.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bee197b30783295d2eb680b311af15a20a8b24024a19c3a26431ff83eb8d1f70"}, + {file = "pillow-10.4.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1ef61f5dd14c300786318482456481463b9d6b91ebe5ef12f405afbba77ed0be"}, + {file = "pillow-10.4.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:297e388da6e248c98bc4a02e018966af0c5f92dfacf5a5ca22fa01cb3179bca0"}, + {file = "pillow-10.4.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:e4db64794ccdf6cb83a59d73405f63adbe2a1887012e308828596100a0b2f6cc"}, + {file = "pillow-10.4.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bd2880a07482090a3bcb01f4265f1936a903d70bc740bfcb1fd4e8a2ffe5cf5a"}, + {file = "pillow-10.4.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4b35b21b819ac1dbd1233317adeecd63495f6babf21b7b2512d244ff6c6ce309"}, + {file = "pillow-10.4.0-cp313-cp313-win32.whl", hash = "sha256:551d3fd6e9dc15e4c1eb6fc4ba2b39c0c7933fa113b220057a34f4bb3268a060"}, + {file = "pillow-10.4.0-cp313-cp313-win_amd64.whl", hash = "sha256:030abdbe43ee02e0de642aee345efa443740aa4d828bfe8e2eb11922ea6a21ea"}, + {file = "pillow-10.4.0-cp313-cp313-win_arm64.whl", hash = "sha256:5b001114dd152cfd6b23befeb28d7aee43553e2402c9f159807bf55f33af8a8d"}, + {file = "pillow-10.4.0-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:8d4d5063501b6dd4024b8ac2f04962d661222d120381272deea52e3fc52d3736"}, + {file = "pillow-10.4.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:7c1ee6f42250df403c5f103cbd2768a28fe1a0ea1f0f03fe151c8741e1469c8b"}, + {file = "pillow-10.4.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b15e02e9bb4c21e39876698abf233c8c579127986f8207200bc8a8f6bb27acf2"}, + {file = "pillow-10.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7a8d4bade9952ea9a77d0c3e49cbd8b2890a399422258a77f357b9cc9be8d680"}, + {file = "pillow-10.4.0-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:43efea75eb06b95d1631cb784aa40156177bf9dd5b4b03ff38979e048258bc6b"}, + {file = "pillow-10.4.0-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:950be4d8ba92aca4b2bb0741285a46bfae3ca699ef913ec8416c1b78eadd64cd"}, + {file = "pillow-10.4.0-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:d7480af14364494365e89d6fddc510a13e5a2c3584cb19ef65415ca57252fb84"}, + {file = "pillow-10.4.0-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:73664fe514b34c8f02452ffb73b7a92c6774e39a647087f83d67f010eb9a0cf0"}, + {file = "pillow-10.4.0-cp38-cp38-win32.whl", hash = "sha256:e88d5e6ad0d026fba7bdab8c3f225a69f063f116462c49892b0149e21b6c0a0e"}, + {file = "pillow-10.4.0-cp38-cp38-win_amd64.whl", hash = "sha256:5161eef006d335e46895297f642341111945e2c1c899eb406882a6c61a4357ab"}, + {file = "pillow-10.4.0-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:0ae24a547e8b711ccaaf99c9ae3cd975470e1a30caa80a6aaee9a2f19c05701d"}, + {file = "pillow-10.4.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:298478fe4f77a4408895605f3482b6cc6222c018b2ce565c2b6b9c354ac3229b"}, + {file = "pillow-10.4.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:134ace6dc392116566980ee7436477d844520a26a4b1bd4053f6f47d096997fd"}, + {file = "pillow-10.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:930044bb7679ab003b14023138b50181899da3f25de50e9dbee23b61b4de2126"}, + {file = "pillow-10.4.0-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:c76e5786951e72ed3686e122d14c5d7012f16c8303a674d18cdcd6d89557fc5b"}, + {file = "pillow-10.4.0-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:b2724fdb354a868ddf9a880cb84d102da914e99119211ef7ecbdc613b8c96b3c"}, + {file = "pillow-10.4.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:dbc6ae66518ab3c5847659e9988c3b60dc94ffb48ef9168656e0019a93dbf8a1"}, + {file = "pillow-10.4.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:06b2f7898047ae93fad74467ec3d28fe84f7831370e3c258afa533f81ef7f3df"}, + {file = "pillow-10.4.0-cp39-cp39-win32.whl", hash = "sha256:7970285ab628a3779aecc35823296a7869f889b8329c16ad5a71e4901a3dc4ef"}, + {file = "pillow-10.4.0-cp39-cp39-win_amd64.whl", hash = "sha256:961a7293b2457b405967af9c77dcaa43cc1a8cd50d23c532e62d48ab6cdd56f5"}, + {file = "pillow-10.4.0-cp39-cp39-win_arm64.whl", hash = "sha256:32cda9e3d601a52baccb2856b8ea1fc213c90b340c542dcef77140dfa3278a9e"}, + {file = "pillow-10.4.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:5b4815f2e65b30f5fbae9dfffa8636d992d49705723fe86a3661806e069352d4"}, + {file = "pillow-10.4.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:8f0aef4ef59694b12cadee839e2ba6afeab89c0f39a3adc02ed51d109117b8da"}, + {file = "pillow-10.4.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9f4727572e2918acaa9077c919cbbeb73bd2b3ebcfe033b72f858fc9fbef0026"}, + {file = "pillow-10.4.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ff25afb18123cea58a591ea0244b92eb1e61a1fd497bf6d6384f09bc3262ec3e"}, + {file = "pillow-10.4.0-pp310-pypy310_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:dc3e2db6ba09ffd7d02ae9141cfa0ae23393ee7687248d46a7507b75d610f4f5"}, + {file = "pillow-10.4.0-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:02a2be69f9c9b8c1e97cf2713e789d4e398c751ecfd9967c18d0ce304efbf885"}, + {file = "pillow-10.4.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:0755ffd4a0c6f267cccbae2e9903d95477ca2f77c4fcf3a3a09570001856c8a5"}, + {file = "pillow-10.4.0-pp39-pypy39_pp73-macosx_10_15_x86_64.whl", hash = "sha256:a02364621fe369e06200d4a16558e056fe2805d3468350df3aef21e00d26214b"}, + {file = "pillow-10.4.0-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:1b5dea9831a90e9d0721ec417a80d4cbd7022093ac38a568db2dd78363b00908"}, + {file = "pillow-10.4.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9b885f89040bb8c4a1573566bbb2f44f5c505ef6e74cec7ab9068c900047f04b"}, + {file = "pillow-10.4.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:87dd88ded2e6d74d31e1e0a99a726a6765cda32d00ba72dc37f0651f306daaa8"}, + {file = "pillow-10.4.0-pp39-pypy39_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:2db98790afc70118bd0255c2eeb465e9767ecf1f3c25f9a1abb8ffc8cfd1fe0a"}, + {file = "pillow-10.4.0-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:f7baece4ce06bade126fb84b8af1c33439a76d8a6fd818970215e0560ca28c27"}, + {file = "pillow-10.4.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:cfdd747216947628af7b259d274771d84db2268ca062dd5faf373639d00113a3"}, + {file = "pillow-10.4.0.tar.gz", hash = "sha256:166c1cd4d24309b30d61f79f4a9114b7b2313d7450912277855ff5dfd7cd4a06"}, +] + +[package.extras] +docs = ["furo", "olefile", "sphinx (>=7.3)", "sphinx-copybutton", "sphinx-inline-tabs", "sphinxext-opengraph"] +fpx = ["olefile"] +mic = ["olefile"] +tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "packaging", "pyroma", "pytest", "pytest-cov", "pytest-timeout"] +typing = ["typing-extensions"] +xmp = ["defusedxml"] + +[[package]] +name = "platformdirs" +version = "4.2.2" +description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`." +optional = false +python-versions = ">=3.8" +files = [ + {file = "platformdirs-4.2.2-py3-none-any.whl", hash = "sha256:2d7a1657e36a80ea911db832a8a6ece5ee53d8de21edd5cc5879af6530b1bfee"}, + {file = "platformdirs-4.2.2.tar.gz", hash = "sha256:38b7b51f512eed9e84a22788b4bce1de17c0adb134d6becb09836e37d8654cd3"}, +] + +[package.extras] +docs = ["furo (>=2023.9.10)", "proselint (>=0.13)", "sphinx (>=7.2.6)", "sphinx-autodoc-typehints (>=1.25.2)"] +test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=7.4.3)", "pytest-cov (>=4.1)", "pytest-mock (>=3.12)"] +type = ["mypy (>=1.8)"] + +[[package]] +name = "pluggy" +version = "1.5.0" +description = "plugin and hook calling mechanisms for python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pluggy-1.5.0-py3-none-any.whl", hash = "sha256:44e1ad92c8ca002de6377e165f3e0f1be63266ab4d554740532335b9d75ea669"}, + {file = "pluggy-1.5.0.tar.gz", hash = "sha256:2cffa88e94fdc978c4c574f15f9e59b7f4201d439195c3715ca9e2486f1d0cf1"}, +] + +[package.extras] +dev = ["pre-commit", "tox"] +testing = ["pytest", "pytest-benchmark"] + +[[package]] +name = "pylint" +version = "3.2.6" +description = "python code static checker" +optional = false +python-versions = ">=3.8.0" +files = [ + {file = "pylint-3.2.6-py3-none-any.whl", hash = "sha256:03c8e3baa1d9fb995b12c1dbe00aa6c4bcef210c2a2634374aedeb22fb4a8f8f"}, + {file = "pylint-3.2.6.tar.gz", hash = "sha256:a5d01678349454806cff6d886fb072294f56a58c4761278c97fb557d708e1eb3"}, +] + +[package.dependencies] +astroid = ">=3.2.4,<=3.3.0-dev0" +colorama = {version = ">=0.4.5", markers = "sys_platform == \"win32\""} +dill = [ + {version = ">=0.3.6", markers = "python_version >= \"3.11\" and python_version < \"3.12\""}, + {version = ">=0.3.7", markers = "python_version >= \"3.12\""}, +] +isort = ">=4.2.5,<5.13.0 || >5.13.0,<6" +mccabe = ">=0.6,<0.8" +platformdirs = ">=2.2.0" +tomlkit = ">=0.10.1" + +[package.extras] +spelling = ["pyenchant (>=3.2,<4.0)"] +testutils = ["gitpython (>3)"] + +[[package]] +name = "pyparsing" +version = "3.1.2" +description = "pyparsing module - Classes and methods to define and execute parsing grammars" +optional = false +python-versions = ">=3.6.8" +files = [ + {file = "pyparsing-3.1.2-py3-none-any.whl", hash = "sha256:f9db75911801ed778fe61bb643079ff86601aca99fcae6345aa67292038fb742"}, + {file = "pyparsing-3.1.2.tar.gz", hash = "sha256:a1bac0ce561155ecc3ed78ca94d3c9378656ad4c94c1270de543f621420f94ad"}, +] + +[package.extras] +diagrams = ["jinja2", "railroad-diagrams"] + +[[package]] +name = "pytest" +version = "8.3.2" +description = "pytest: simple powerful testing with Python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pytest-8.3.2-py3-none-any.whl", hash = "sha256:4ba08f9ae7dcf84ded419494d229b48d0903ea6407b030eaec46df5e6a73bba5"}, + {file = "pytest-8.3.2.tar.gz", hash = "sha256:c132345d12ce551242c87269de812483f5bcc87cdbb4722e48487ba194f9fdce"}, +] + +[package.dependencies] +colorama = {version = "*", markers = "sys_platform == \"win32\""} +iniconfig = "*" +packaging = "*" +pluggy = ">=1.5,<2" + +[package.extras] +dev = ["argcomplete", "attrs (>=19.2)", "hypothesis (>=3.56)", "mock", "pygments (>=2.7.2)", "requests", "setuptools", "xmlschema"] + +[[package]] +name = "pytest-asyncio" +version = "0.23.8" +description = "Pytest support for asyncio" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pytest_asyncio-0.23.8-py3-none-any.whl", hash = "sha256:50265d892689a5faefb84df80819d1ecef566eb3549cf915dfb33569359d1ce2"}, + {file = "pytest_asyncio-0.23.8.tar.gz", hash = "sha256:759b10b33a6dc61cce40a8bd5205e302978bbbcc00e279a8b61d9a6a3c82e4d3"}, +] + +[package.dependencies] +pytest = ">=7.0.0,<9" + +[package.extras] +docs = ["sphinx (>=5.3)", "sphinx-rtd-theme (>=1.0)"] +testing = ["coverage (>=6.2)", "hypothesis (>=5.7.1)"] + +[[package]] +name = "pytest-cov" +version = "5.0.0" +description = "Pytest plugin for measuring coverage." +optional = false +python-versions = ">=3.8" +files = [ + {file = "pytest-cov-5.0.0.tar.gz", hash = "sha256:5837b58e9f6ebd335b0f8060eecce69b662415b16dc503883a02f45dfeb14857"}, + {file = "pytest_cov-5.0.0-py3-none-any.whl", hash = "sha256:4f0764a1219df53214206bf1feea4633c3b558a2925c8b59f144f682861ce652"}, +] + +[package.dependencies] +coverage = {version = ">=5.2.1", extras = ["toml"]} +pytest = ">=4.6" + +[package.extras] +testing = ["fields", "hunter", "process-tests", "pytest-xdist", "virtualenv"] + +[[package]] +name = "pytest-mock" +version = "3.14.0" +description = "Thin-wrapper around the mock package for easier use with pytest" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pytest-mock-3.14.0.tar.gz", hash = "sha256:2719255a1efeceadbc056d6bf3df3d1c5015530fb40cf347c0f9afac88410bd0"}, + {file = "pytest_mock-3.14.0-py3-none-any.whl", hash = "sha256:0b72c38033392a5f4621342fe11e9219ac11ec9d375f8e2a0c164539e0d70f6f"}, +] + +[package.dependencies] +pytest = ">=6.2.5" + +[package.extras] +dev = ["pre-commit", "pytest-asyncio", "tox"] + +[[package]] +name = "python-dateutil" +version = "2.9.0.post0" +description = "Extensions to the standard Python datetime module" +optional = false +python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7" +files = [ + {file = "python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3"}, + {file = "python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427"}, +] + +[package.dependencies] +six = ">=1.5" + +[[package]] +name = "pytz" +version = "2024.1" +description = "World timezone definitions, modern and historical" +optional = false +python-versions = "*" +files = [ + {file = "pytz-2024.1-py2.py3-none-any.whl", hash = "sha256:328171f4e3623139da4983451950b28e95ac706e13f3f2630a879749e7a8b319"}, + {file = "pytz-2024.1.tar.gz", hash = "sha256:2a29735ea9c18baf14b448846bde5a48030ed267578472d8955cd0e7443a9812"}, +] + +[[package]] +name = "six" +version = "1.16.0" +description = "Python 2 and 3 compatibility utilities" +optional = false +python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*" +files = [ + {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"}, + {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"}, +] + +[[package]] +name = "tabulate" +version = "0.9.0" +description = "Pretty-print tabular data" +optional = false +python-versions = ">=3.7" +files = [ + {file = "tabulate-0.9.0-py3-none-any.whl", hash = "sha256:024ca478df22e9340661486f85298cff5f6dcdba14f3813e8830015b9ed1948f"}, + {file = "tabulate-0.9.0.tar.gz", hash = "sha256:0095b12bf5966de529c0feb1fa08671671b3368eec77d7ef7ab114be2c068b3c"}, +] + +[package.extras] +widechars = ["wcwidth"] + +[[package]] +name = "tomlkit" +version = "0.13.0" +description = "Style preserving TOML library" +optional = false +python-versions = ">=3.8" +files = [ + {file = "tomlkit-0.13.0-py3-none-any.whl", hash = "sha256:7075d3042d03b80f603482d69bf0c8f345c2b30e41699fd8883227f89972b264"}, + {file = "tomlkit-0.13.0.tar.gz", hash = "sha256:08ad192699734149f5b97b45f1f18dad7eb1b6d16bc72ad0c2335772650d7b72"}, +] + +[[package]] +name = "tqdm" +version = "4.66.5" +description = "Fast, Extensible Progress Meter" +optional = false +python-versions = ">=3.7" +files = [ + {file = "tqdm-4.66.5-py3-none-any.whl", hash = "sha256:90279a3770753eafc9194a0364852159802111925aa30eb3f9d85b0e805ac7cd"}, + {file = "tqdm-4.66.5.tar.gz", hash = "sha256:e1020aef2e5096702d8a025ac7d16b1577279c9d63f8375b63083e9a5f0fcbad"}, +] + +[package.dependencies] +colorama = {version = "*", markers = "platform_system == \"Windows\""} + +[package.extras] +dev = ["pytest (>=6)", "pytest-cov", "pytest-timeout", "pytest-xdist"] +notebook = ["ipywidgets (>=6)"] +slack = ["slack-sdk"] +telegram = ["requests"] + +[[package]] +name = "types-pytz" +version = "2024.1.0.20240417" +description = "Typing stubs for pytz" +optional = false +python-versions = ">=3.8" +files = [ + {file = "types-pytz-2024.1.0.20240417.tar.gz", hash = "sha256:6810c8a1f68f21fdf0f4f374a432487c77645a0ac0b31de4bf4690cf21ad3981"}, + {file = "types_pytz-2024.1.0.20240417-py3-none-any.whl", hash = "sha256:8335d443310e2db7b74e007414e74c4f53b67452c0cb0d228ca359ccfba59659"}, +] + +[[package]] +name = "types-tqdm" +version = "4.66.0.20240417" +description = "Typing stubs for tqdm" +optional = false +python-versions = ">=3.8" +files = [ + {file = "types-tqdm-4.66.0.20240417.tar.gz", hash = "sha256:16dce9ef522ea8d40e4f5b8d84dd8a1166eefc13ceee7a7e158bf0f1a1421a31"}, + {file = "types_tqdm-4.66.0.20240417-py3-none-any.whl", hash = "sha256:248aef1f9986b7b8c2c12b3cb4399fc17dba0a29e7e3f3f9cd704babb879383d"}, +] + +[[package]] +name = "typing-extensions" +version = "4.12.2" +description = "Backported and Experimental Type Hints for Python 3.8+" +optional = false +python-versions = ">=3.8" +files = [ + {file = "typing_extensions-4.12.2-py3-none-any.whl", hash = "sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d"}, + {file = "typing_extensions-4.12.2.tar.gz", hash = "sha256:1a7ead55c7e559dd4dee8856e3a88b41225abfe1ce8df57b7c13915fe121ffb8"}, +] + +[[package]] +name = "tzdata" +version = "2024.1" +description = "Provider of IANA time zone data" +optional = false +python-versions = ">=2" +files = [ + {file = "tzdata-2024.1-py2.py3-none-any.whl", hash = "sha256:9068bc196136463f5245e51efda838afa15aaeca9903f49050dfa2679db4d252"}, + {file = "tzdata-2024.1.tar.gz", hash = "sha256:2674120f8d891909751c38abcdfd386ac0a5a1127954fbc332af6b5ceae07efd"}, +] + +[metadata] +lock-version = "2.0" +python-versions = "^3.11" +content-hash = "0c3057aef40fdbd2d86f861224b7455e12680aeec7f8fdbc3e5ecc4e56936a59" diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..62c0cfe --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,114 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) +[build-system] +requires = ["poetry-core"] +build-backend = "poetry.core.masonry.api" + +[tool.poetry] +name = "eventlib-py" +version = "0.1.0" +description = "A Python event framework to decouple code using events." +authors = ["Michael Käser "] +license = "(Apache-2.0 OR MIT)" +readme = "README.md" +packages = [ + { include = "eventlib" }, + { include = "tests", format = "sdist" }, + { include = "examples", format = "sdist" }, +] +classifiers = [ + "Programming Language :: Python :: 3", + "Programming Language :: Python :: 3.11", + "Programming Language :: Python :: 3.12", + "License :: OSI Approved :: MIT License", + "License :: OSI Approved :: Apache Software License", + "Operating System :: OS Independent", + "Framework :: AsyncIO", + "Topic :: Software Development", + "Topic :: Software Development :: Libraries", + "Typing :: Typed", +] + +[tool.poetry.dependencies] +python = "^3.11" + +[tool.poetry.group.dev.dependencies] +pytest = "^8.3" +pytest-asyncio = "*" +pytest-cov = "*" +pytest-mock = "*" +pylint = "^3.2" +mypy = "^1.11" +black = "^24.4" +isort = "^5.13" + +[tool.poetry.group.benchmark.dependencies] +numpy = "^2.0.1" +matplotlib = "^3.9.1" +pandas = "^2.2.2" +pandas-stubs = "*" +tqdm = "^4.66.5" +types-tqdm = "*" +tabulate = "^0.9" + +# ================================================================================================== +# Mypy +[tool.mypy] +python_version = "3.11" +warn_return_any = true +warn_unused_configs = true +exclude = ["^\\.?venv"] + +# ================================================================================================== +# Pylint +[tool.pylint.master] +recursive = true +output-format = "colorized" +ignore = [ + "venv", + ".venv", + ".run", + ".vscode", + ".idea", + ".mypy_cache", + ".pytest_cache", + "build", +] + +[tool.pylint.format] +max-line-length = 120 + +[tool.pylint.basic] +class-rgx = "[A-Z_][a-zA-Z0-9]*$" + +# ================================================================================================== +# Black +[tool.black] +line-length = 120 +target-version = ['py311'] + +# ================================================================================================== +# Isort +[tool.isort] +py_version = "311" +line_length = 120 +profile = "black" +src_paths = [".", "tests"] + +# ================================================================================================== +# Pytest +[tool.pytest.ini_options] +addopts = ["--import-mode=importlib"] + +[tool.coverage.run] +omit = ["tests/*", "examples/*", "benchmark/*", "venv/*", ".venv/*"] + +# ================================================================================================== +# Semantic Release +[tool.semantic_release] +branch = "main" +version_toml = ["pyproject.toml:tool.poetry.version"] +major_on_zero = false +upload_to_vcs_release = true +changelog_file = "CHANGELOG.md" +build_command = "poetry build" diff --git a/tests/eventlib_tests/__init__.py b/tests/eventlib_tests/__init__.py new file mode 100644 index 0000000..3c771fe --- /dev/null +++ b/tests/eventlib_tests/__init__.py @@ -0,0 +1,6 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Tests for the eventlib package. +""" diff --git a/tests/eventlib_tests/conftest.py b/tests/eventlib_tests/conftest.py new file mode 100644 index 0000000..f2b651f --- /dev/null +++ b/tests/eventlib_tests/conftest.py @@ -0,0 +1,16 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Pytest configuration for the eventlib_tests tests. +""" + +import pytest + +from eventlib import EventSystem + + +@pytest.fixture() +def system() -> EventSystem: + """Event system for testing.""" + return EventSystem() diff --git a/tests/eventlib_tests/test_base.py b/tests/eventlib_tests/test_base.py new file mode 100644 index 0000000..bb3da1e --- /dev/null +++ b/tests/eventlib_tests/test_base.py @@ -0,0 +1,132 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Test for the base events and global event system. +""" + +from typing import Callable +from unittest import mock + +import pytest + +from eventlib import ( + BaseEvent, + EventSystem, + emit, + emit_async, + get_event_system, + set_event_system, + subscribe, + unsubscribe, + unsubscribe_all, +) + +test_system = EventSystem() + + +@pytest.fixture(scope="module", autouse=True) +def set_base_system(): + """Fixture to temporary set the global event system to the `test_system`.""" + default = get_event_system() + try: + yield set_event_system(test_system) + finally: + set_event_system(default) + + +class BaseA(BaseEvent, event_system=test_system): + """BaseA event class.""" + + +class BaseB(BaseA): + """BaseB event class.""" + + +class BaseC(BaseB): + """BaseC event class.""" + + +def test_base_events(): + """Test the events are correctly set.""" + # Assert + assert BaseA.event_system is test_system + assert BaseB.event_system is test_system + assert BaseC.event_system is test_system + + +def test_subscribe(): + """Test subscribing to events""" + test_system.clear_all_subscriptions() + + # Arrange + _mock_a = mock.Mock(Callable) + _mock_b = mock.Mock(Callable) + _mock_c = mock.Mock(Callable) + BaseA.subscribe()(_mock_a) + BaseB.subscribe()(_mock_b) + BaseC.subscribe()(_mock_c) + # Act + event1 = BaseB().emit() + # Assert + _mock_a.assert_called_once_with(event1) + _mock_b.assert_called_once_with(event1) + _mock_c.assert_not_called() + + +def test_unsubscribe(): + """Test unsubscribing from events.""" + test_system.clear_all_subscriptions() + _call = mock.Mock(Callable) + + @subscribe() + def _sub_a(_: BaseA): + pytest.fail("This should not be called") # pragma: no cover + + @subscribe() + def _sub_b(_: BaseB): + pytest.fail("This should not be called") # pragma: no cover + + @subscribe() + def _sub_c(event: BaseC): + _call(event) + + # Arrange + unsubscribe(_sub_a) + unsubscribe_all(BaseB) + # Act + BaseB().emit() + # Assert + _call.assert_not_called() + + # Act + event_c = BaseC().emit() + # Assert + _call.assert_called_once_with(event_c) + + +def test_emit(): + """Test emitting events via the global event system.""" + # Arrange + test_system.clear_all_subscriptions() + _call = mock.Mock(Callable) + BaseC.subscribe()(_call) + event = BaseC() + # Act + emit(event) + # Assert + _call.assert_called_once_with(event) + + +@pytest.mark.asyncio +async def test_emit_async(): + """Test emitting events asynchronously via the global event system.""" + # Arrange + test_system.clear_all_subscriptions() + _call = mock.AsyncMock(Callable) + BaseC.subscribe()(_call) + event = BaseC() + # Act + await emit_async(event) + # Assert + _call.assert_awaited_once_with(event) diff --git a/tests/eventlib_tests/test_core.py b/tests/eventlib_tests/test_core.py new file mode 100644 index 0000000..f2ce15a --- /dev/null +++ b/tests/eventlib_tests/test_core.py @@ -0,0 +1,406 @@ +# Copyright 2024 Michael Käser +# SPDX-License-Identifier: (Apache-2.0 OR MIT) + +""" +Test the core of the event system. +""" + +import asyncio +import contextlib +from typing import Awaitable, Callable +from unittest import mock + +import pytest + +from eventlib import Event, EventSystem + + +# pylint: disable=too-few-public-methods +class A(Event): + """Test event class""" + + +# pylint: disable=too-few-public-methods +class B(A): + """Test event class""" + + +# pylint: disable=too-few-public-methods +class C(B): + """Test event class""" + + +@pytest.mark.asyncio +async def test_event(): + """Test the basic event system""" + # Arrange + system = EventSystem() + _sync = mock.Mock(spec_set=Callable) + _async = mock.AsyncMock(spec_set=Awaitable) + _context_sync = mock.Mock() + _context_sync.return_value.__enter__ = mock.Mock() + _context_sync.return_value.__exit__ = mock.Mock(return_value=False) + _context_async = mock.Mock() + _context_async.return_value.__aenter__ = mock.AsyncMock() + _context_async.return_value.__aexit__ = mock.AsyncMock(return_value=False) + system.subscribe(B)(_sync) + system.subscribe(B)(_async) + system.subscribe(B)(_context_sync) + system.subscribe(B)(_context_async) + # Act 0 + event = C() + await system.emit_async(event) + # Assert 0 + _sync.assert_called_once_with(event) + _async.assert_awaited_once_with(event) + _context_sync.assert_called_once_with(event) + _context_async.assert_called_once_with(event) + _context_sync.return_value.__enter__.assert_called_once() + _context_async.return_value.__aenter__.assert_awaited_once() + # Act 1 + other = A() + await system.emit_async(other) + # Assert 1 + assert _sync.call_count == 1 + assert _async.await_count == 1 + assert _context_sync.call_count == 1 + assert _context_async.call_count == 1 + assert _context_sync.return_value.__enter__.call_count == 1 + assert _context_async.return_value.__aenter__.await_count == 1 + # Act 2 + event = B() + await system.emit_async(event) + # Assert 2 + assert _sync.call_count == 2 + assert _async.await_count == 2 + assert _context_sync.call_count == 2 + assert _context_async.call_count == 2 + assert _context_sync.return_value.__enter__.call_count == 2 + assert _context_async.return_value.__aenter__.await_count == 2 + # Act x + event = C() + for _ in range(8): + await system.emit_async(event) + # Assert 2 + assert _sync.call_count == 10 + assert _async.await_count == 10 + assert _context_sync.call_count == 10 + assert _context_async.call_count == 10 + assert _context_sync.return_value.__enter__.call_count == 10 + assert _context_async.return_value.__aenter__.await_count == 10 + + +@pytest.mark.asyncio +async def test_priority(system): + """Test the priority of event handlers""" + # Arrange + results = [] + system.subscribe(A, priority=-1)(lambda _: results.append(-1)) + system.subscribe(A)(lambda _: results.append(0)) + system.subscribe(A, priority=1)(lambda _: results.append(1)) + # Act + await system.emit_async(A()) + # Assert + assert results == [-1, 0, 1] + + +@pytest.mark.asyncio +async def test_context(system): + """Test that context manager work.""" + # Arrange + results = [] + + @system.subscribe(A, priority=-1) + @contextlib.asynccontextmanager + async def first(_): + results.append(-1) + yield + results.append(-1) + + @system.subscribe(A, priority=0) + @contextlib.contextmanager + def second(_): + results.append(0) + yield + results.append(0) + + system.subscribe(A, priority=1)(lambda _: results.append(1)) + system.subscribe(A, priority=1337)(lambda _: results.append(1337)) + # Act + await system.emit_async(A()) + # Assert + assert results == [-1, 0, 1, 1337, 0, -1] + + +# pylint: disable=unused-argument +def test_usage_annotation(system): + """Test usage of subscribing with annotation""" + + def handle(event: A): + """A function that can subscribe to events.""" + + class Handler: + """An event handler that uses the constructor to subscribe and is a context manager.""" + + def __init__(self, event: A): + pass + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + pass + + # pylint: disable=too-few-public-methods + class Other: + """Some class method that can subscribe to events.""" + + def handle(self, event: A): + """Method to handle events""" + + system.subscribe()(handle) + system.subscribe()(Handler) + system.subscribe()(Other().handle) + system.emit(A()) + + +def test_usage_annotation_missing(system): + """Test usage error on missing annotation.""" + + def handle(_): + pass + + with pytest.raises(TypeError): + system.subscribe()(handle) + + +# pylint: disable=unused-argument +def test_usage_annotation_too_many_args(system): + """Test usage error on too many arguments.""" + + def handle(event, other): # noqa + pass + + with pytest.raises(TypeError): + system.subscribe()(handle) # type:ignore + + +@pytest.mark.asyncio +async def test_handler_usage_no_async_func(system): + """Test error on non-async function""" + + _awaitable = asyncio.get_running_loop().create_future() + + def _call(_: A): + return _awaitable + + system.subscribe(A)(_call) + # with warnings.catch_warnings(action="error", category=RuntimeWarning): + with pytest.raises(ExceptionGroup) as exc: + system.emit(A()) + assert len(exc.value.exceptions) == 1 + assert isinstance(exc.value.exceptions[0], TypeError) + + +def test_handler_usage_no_async_context(system): + """Test handler error on non-async context manager""" + + @contextlib.asynccontextmanager + async def _context(_: A): + yield + + system.subscribe(A)(_context) + with pytest.raises(ExceptionGroup) as exc: + system.emit(A()) + assert len(exc.value.exceptions) == 1 + assert isinstance(exc.value.exceptions[0], TypeError) + + +def test_handler_error(system): + """Test handler error""" + system.subscribe(A)(lambda _: 1 / 0) + with pytest.raises(ExceptionGroup) as exc: + system.emit(A()) + assert len(exc.value.exceptions) == 1 + assert isinstance(exc.value.exceptions[0], ZeroDivisionError) + + +@pytest.mark.asyncio +async def test_handler_error_async(system): + """Async test handler error""" + system.subscribe(A)(lambda _: 1 / 0) + with pytest.raises(ExceptionGroup) as exc: + await system.emit_async(A()) + assert len(exc.value.exceptions) == 1 + assert isinstance(exc.value.exceptions[0], ZeroDivisionError) + + +@pytest.mark.asyncio +async def test_emit_timeout_with_error_async(system): + """Async test for emitting events with timeout and handler error combined""" + system.subscribe(A)(lambda _: 1 / 0) + system.subscribe(A)(lambda _: asyncio.sleep(1)) + with pytest.raises(ExceptionGroup) as exc: + await asyncio.wait_for(system.emit_async(A()), timeout=0.01) + assert len(exc.value.exceptions) == 1 + assert isinstance(exc.value.exceptions[0], ZeroDivisionError) + + +def test_emit(system): + """Test for emitting events""" + # Arrange + _call = mock.Mock(Callable, name="_call") + _context = mock.Mock(Callable, name="_context") + _context.return_value.__enter__ = mock.Mock(Callable) + _context.return_value.__exit__ = mock.Mock(Callable) + system.add_subscriber(_call, A) + system.add_subscriber(_context, A) + # Act + event1 = A() + system.emit(event1) + # Assert + _call.assert_called_once_with(event1) + _context.assert_called_once_with(event1) + _context.return_value.__enter__.assert_called() + _context.return_value.__exit__.assert_called() + # Act + event2 = A() + system.emit(event2) + # Assert + _call.assert_has_calls([mock.call(event1), mock.call(event2)]) + _context.assert_has_calls([mock.call(event1), mock.call(event2)], any_order=True) + assert _context.return_value.__enter__.call_count == 2 + assert _context.return_value.__exit__.call_count == 2 + + +@pytest.mark.asyncio +async def test_emit_async(system): + """Async test for emitting events""" + + # Arrange + _call = mock.AsyncMock(Callable, name="_call") + _context = mock.Mock(Callable, name="_context") + _context.return_value.__aenter__ = mock.AsyncMock(Callable) + _context.return_value.__aexit__ = mock.AsyncMock(Callable) + system.add_subscriber(_call, A) + system.add_subscriber(_context, A) + # Act + event1 = A() + await system.emit_async(event1) + # Assert + _call.assert_awaited_once_with(event1) + _context.assert_called_once_with(event1) + _context.return_value.__aenter__.assert_awaited_once() + _context.return_value.__aexit__.assert_awaited_once() + # Act + event2 = A() + await system.emit_async(event2) + # Assert + _call.assert_has_awaits([mock.call(event1), mock.call(event2)]) + _context.assert_has_calls([mock.call(event1), mock.call(event2)], any_order=True) + assert _context.return_value.__aenter__.await_count == 2 + assert _context.return_value.__aexit__.await_count == 2 + + +def test_emit_invalid_event(system): + """Test error on invalid event type""" + with pytest.raises(TypeError): + system.emit(object()) # type: ignore + + +@pytest.mark.asyncio +async def test_emit_timeout(system): + """Timeout of event handler""" + system.subscribe(A)(lambda _: asyncio.sleep(1)) + with pytest.raises(asyncio.TimeoutError): + await asyncio.wait_for(system.emit_async(A()), timeout=0.01) + + +@pytest.mark.asyncio +async def test_handler_timeout_async(system): + """Async timeout of event handler""" + + # Arrange + @system.subscribe() + async def _raising(_event: A): + raise asyncio.TimeoutError() + + _call = mock.Mock(Callable) + system.subscribe(A, priority=1)(_call) + + # Act & Assert + event = A() + with pytest.raises(ExceptionGroup) as exc: + await system.emit_async(event) + assert exc.group_contains(asyncio.TimeoutError) + _call.assert_not_called() + + +def test_handler_critical(system): + """Test for critical events""" + + # Arrange + @system.subscribe(critical=True) + def _raising(_event: A): + raise ValueError("test") + + _call = mock.Mock(Callable) + system.subscribe(A, priority=1)(_call) + + # Act & Assert + event = A() + with pytest.raises(ExceptionGroup) as exc: + system.emit(event) + assert exc.group_contains(ValueError, match="test") + _call.assert_not_called() + + +@pytest.mark.asyncio +async def test_handler_critical_async(system): + """Async test for critical events""" + + # Arrange + @system.subscribe(critical=True) + async def _raising(_event: A): + raise ValueError("test") + + _call = mock.Mock(Callable) + system.subscribe(A, priority=1)(_call) + + # Act & Assert + event = A() + with pytest.raises(ExceptionGroup) as exc: + await system.emit_async(event) + assert exc.group_contains(ValueError, match="test") + _call.assert_not_called() + + +def test_handler_no_context(system): + """Test error of handler that returns a generator""" + + # Arrange + @system.subscribe(critical=True) + def invalid_generator(event: A): + yield + + # Act & Assert + event = A() + with pytest.raises(ExceptionGroup) as exc: + system.emit(event) + exc.group_contains(TypeError, match="Cannot handle generator.") + + +@pytest.mark.asyncio +async def test_handler_no_context_async(system): + """Test error of handler that returns a generator""" + + # Arrange + @system.subscribe(critical=True) + async def invalid_generator(event: A): + yield + + # Act & Assert + event = A() + with pytest.raises(ExceptionGroup) as exc: + await system.emit_async(event) + exc.group_contains(TypeError, match="Cannot handle async generator.")