معرفی شرکت ها
asyncz-0.2.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
The scheduler that nobody wants but every application needs.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | asyncz-0.2.0 |
| نام | asyncz |
| نسخه کتابخانه | 0.2.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | - |
| ایمیل نویسنده | Tiago Silva <tiago.arasilva@gmail.com> |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/asyncz/ |
| مجوز | - |
# Asyncz
<p align="center">
<a href="https://asyncz.tarsil.io"><img src="https://res.cloudinary.com/dymmond/image/upload/v1671461421/asyncz/asyncz-bg_bapqg1.png" alt='Asyncz'></a>
</p>
<p align="center">
<em>🚀 The scheduler that simply works. 🚀</em>
</p>
<p align="center">
<a href="https://github.com/tarsil/asyncz/workflows/Test%20Suite/badge.svg?event=push&branch=main" target="_blank">
<img src="https://github.com/tarsil/asyncz/workflows/Test%20Suite/badge.svg?event=push&branch=main" alt="Test Suite">
</a>
<a href="https://pypi.org/project/asyncz" target="_blank">
<img src="https://img.shields.io/pypi/v/asyncz?color=%2334D058&label=pypi%20package" alt="Package version">
</a>
<a href="https://pypi.org/project/asyncz" target="_blank">
<img src="https://img.shields.io/pypi/pyversions/asyncz.svg?color=%2334D058" alt="Supported Python versions">
</a>
</p>
---
**Documentation**: [https://asyncz.tarsild.io](https://asyncz.tarsild.io) 📚
**Source Code**: [https://github.com/tarsil/asyncz](https://github.com/tarsil/asyncz)
---
Asyncz is a scheduler for any ASGI application that needs to have those complicated scheduled operations with the
best of what pydantic can offer.
## Motivation
Nowadays using async frameworks with python is somewhat common and becoming even more mainstream. A lot of applications
usually need a complex stack of technologies to fullfil their needs and directly or indirectly, a scheduler.
There are great frameworks out there that do the task extremely well, the best example is APScheduler, which is where
Asyncz came from.
To be even more honest, Asyncz is a revamp of APScheduler. Without the APScheduler there is no Asyncz, so much that
even the APScheduler tests are used within asyncz. That is how great APScheduler is!
So what was the reason why recreating another similar version of APScheduler? Well, it is not entirely the same
thing. Asyncz was designed to work only with ASGI and AsyncIO as well as integrating pydantic and bring the modern
python into the table.
APScheduler is widely used by millions of python developers and Asyncz **does not aim to replace** it, instead
is a more focused and optimised solution for async and ASGI frameworks out there.
See the [vendors](./vendors/apscheduler/README.md) for more details.
## Logging
We all struggle with the logging and the configurations and with that in mind Asyncz comes with natice support
for loguru.
This will make the logging a lot easier to understand and clear to read.
## Async and ASGI
What does this mean? Well, Asyncz does not need to run inside any specific framework, actually you can use it
completely indepent from any framework as well as inside ASGI frameworks such as
[Esmerald](https://esmerald.dymmond.com), FastAPI, Starlette, Starlite, Quart... You can pick one and go for it.
Asyncz comes with special support to [Esmerald](https://esmerald.dymmond.com) for the simple reason that the author is
the same but it can be added more support. If you are interested in adding support to your favourite frameworks then
see the [contributing](https://asyncz.tarsild.io/contributing.md) section.
## Concepts
Like APScheduler, Asyncz also brings four kinds of components:
* [Schedulers](https://asyncz.tarsild.io/schedulers.md)
* [Triggers](https://asyncz.tarsild.io/triggers.md)
* [Stores](https://asyncz.tarsild.io/stores.md)
* [Executors](https://asyncz.tarsild.io/executors.md)
## Requirements
* Python 3.7+
Asyncz wouldn't be possible without two giants:
* <a href="https://apscheduler.readthedocs.io/en/3.x/" class="external-link" target="_blank">APScheduler</a>
* <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a>
## Installation
```shell
$ pip install asyncz
```
## The right decisions
How do you know if you are choosing the right [scheduler](https://asyncz.tarsild.io/schedulers.md),
[triggers](https://asyncz.tarsild.io/triggers.md), [stores](https://asyncz.tarsild.io/stores.md)
and [executors](https://asyncz.tarsild.io/executors.md)?
Well, Asyncz is intentionally designed for specific systems and already helps you out with some of
those questions.
* **Schedulers** - Natively only supports the [AsyncIOScheduler](https://asyncz.tarsild.io/schedulers.md#asyncioscheduler).
* **Triggers** - Here it will depend of the periocidity of our tasks. Example:
* [CronTrigger](https://asyncz.tarsild.io/triggers.md#crontrigger) - UNIX like cron and gives you the same feeling as
scheduling a task on a native UNIX like based system.
* [DateTrigger](https://asyncz.tarsild.io/triggers.md#datetrigger) - When you need to run a task once on a specific
point of time.
* [IntervalTrigger](https://asyncz.tarsild.io/triggers.md#intervaltrigger) - When you need to run tasks in specific
intervals of time.
* [OrTrigger](https://asyncz.tarsild.io/triggers.md#ortrigger)/[AndTrigger](https://asyncz.tarsild.io/triggers.md#andtrigger) - If you would
like to combine more than one trigger (cron, interval and date) together.
* **Stores** - Natively only supports [redis](https://asyncz.tarsild.io/stores.md#redisstore),
[mongo](https://asyncz.tarsild.io/stores.md#mongodbstore) and [memory](https://asyncz.tarsild.io/stores.md#memorystore).
* **Executors** - Natively only supports [AsyncIOExecutor](https://asyncz.tarsild.io/executors.md#asyncioexecutor),
[ThreadPoolExecutor](https://asyncz.tarsild.io/executors.md#threadpoolexecutor) and
[ProcessPoolExecutor](https://asyncz.tarsild.io/executors.md#processpoolexecutor).
Sometimes having a lot of options makes the decision making very hard and Asyncz is intentionally
designed and driven to simplify and for specific use cases but is not limited to those. In every
section you have the option of uilding your own stores, executors, triggers and schedulers.
## Configuring the scheduler
Due its simplificy, Asyncz provides some ways of configuring the scheduler for you.
First way:
```python
from asyncz.schedulers.asyncio import AsyncIOScheduler
scheduler = AsyncIOScheduler()
```
Second way:
```python
from asyncz.schedulers import AsyncIOScheduler
scheduler = AsyncIOScheduler()
```
Initialize the rest of the application after the `scheduler` initialisation.
More [details](https://asyncz.tarsild.io/schedulers.md) can be found with more thorough explanations.
This is in simple terms and in a nutshell how to start with Asyncz quickly. For more information,
details and examples how to leverage Asyncz simply navigate through the documentation and have
fun 😁🎉.
## ASGI support
Asyncz currently supports the [Esmerald framework](https://asyncz.tarsild.io/contrib/esmerald/index.md)
and brings some batteries that are currently used by the framework and leveraging Asyncz.
If you wish to have support to any other framework such as FastAPI, Starlite, Starlette or
literally any other, check the [contributing](https://asyncz.tarsild.io/contributing.md) section and see how you can
do it.
## Sponsors
Currently there are no sponsors of **Asyncz** but you can financially help and support the author though
[GitHub sponsors](https://github.com/sponsors/tarsil) and become a **Special one** or a **Legend**.
نیازمندی
| مقدار | نام |
|---|---|
| - | asyncio<4.0.0,>=3.4.3 |
| - | loguru<0.7.0,>=0.6.0 |
| - | pydantic<2.0.0,>=1.10.5 |
| - | pytz>=2022.6 |
| - | tzlocal<5.0,>=4.2 |
| xtr | asyncio<4.0.0,>=3.4.3; |
| xtr | pydantic<2.0.0,>=1.10.5; |
| xtr | pytz>=2022.6; |
| xtr | tzlocal<5.0,>=4.2; |
| xtr | autoflake<3.0.0,>=1.4.0; |
| xtr | black<23.0.0,>=22.10.0; |
| xtr | flake8<7.0.0,>=3.8.3; |
| xtr | isort<6.0.0,>=5.0.6; |
| xtr | loguru<0.7.0,>=0.6.0; |
| xtr | mypy<2.0.0,>=0.982; |
| xtr | pre-commit<3.0.0,>=2.17.0; |
| xtr | watchfiles<0.20.0,>=0.16.1; |
| xtr | mdx-include<2.0.0,>=1.4.2; |
| xtr | mkautodoc<0.3.0,>=0.2.0; |
| xtr | mkdocs-markdownextradata-plugin<0.3.0,>=0.2.5; |
| xtr | mkdocs-material<10.0.0,>=9.0.13; |
| xtr | mkdocs<2.0.0,>=1.1.2; |
| xtr | mkdocstrings<0.30.0,>=0.20.0; |
| xtr | pyyaml<7.0.0,>=6.0; |
| xtr | esmerald==0.4.2; |
| xtr | mock>=4.0.3; |
| xtr | pymongo<5.0.0,>=4.3.3; |
| xtr | pytest-asyncio<1.0.0,>=0.19.0; |
| xtr | pytest-cov<5.0.0,>=2.12.0; |
| xtr | pytest-loguru<1,>=0.2.0; |
| xtr | pytest<8.0.0,>=7.1.3; |
| xtr | redis<5.0.0,>=4.4.0; |
| xtr | requests<3.0.0,>=2.27.0; |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.8 | Python |
نحوه نصب
نصب پکیج whl asyncz-0.2.0:
pip install asyncz-0.2.0.whl
نصب پکیج tar.gz asyncz-0.2.0:
pip install asyncz-0.2.0.tar.gz