https://github.com/j0fin/utile
The python package which eases your <codeflow> using decorators :sparkle:.
https://github.com/j0fin/utile
concurrent-programming decorators package python3 rust rust-bindings utility
Last synced: 10 months ago
JSON representation
The python package which eases your <codeflow> using decorators :sparkle:.
- Host: GitHub
- URL: https://github.com/j0fin/utile
- Owner: j0fiN
- License: mit
- Created: 2020-06-27T09:48:23.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-07-08T08:12:08.000Z (over 3 years ago)
- Last Synced: 2024-11-12T19:24:31.822Z (over 1 year ago)
- Topics: concurrent-programming, decorators, package, python3, rust, rust-bindings, utility
- Language: Python
- Homepage: https://pypi.org/project/utile/1.1/
- Size: 262 KB
- Stars: 16
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# utile
---
*The python package which eases your `````` using `@decorators`.*
### Now integrated with rust! (docs updated)
---
[](https://utile.readthedocs.io/)
[](https://app.circleci.com/pipelines/github/j0fiN/utile)
[](https://github.com/j0fiN/utile/actions?query=workflow%3ACI-utile)
[](https://github.com/j0fiN/utile/blob/master/LICENSE)
[](https://codecov.io/gh/j0fiN/utile/commits)
[](https://pypi.org/project/utile/1.0/)
[](#)
---
## Installation
```Powershell
pip install utile
```
---
***If you dont have rust compiler installed***
```bash
pip install utile==1.0
```
## The art of using decorators
Decorators is one of the many concepts which makes Python programming amazing. The key usage
of decorators is to modify the functionality or state (behavior) of a function. This package brings out a relatively
new concept of
**Function Foundation**.
Function Foundation is a style of programming where a function tends to do nothing and acts like a robust base (or
foundation) for decorators and these decorators can be made to do sophisticated processes over the idle function.
This (according to us) eases intricate function designing.
## Getting Started
#### @timer() decorator
To compute execution time of a function:
```python
from utile.Timer import timer
import time
@timer()
def foo():
time.sleep(1)
foo()
```
This will show the execution time (in seconds) irrespective of any print statements.
### Key features of utile
#### @threader() decorator
Provides an easy way to run multiple I/O bound tasks with no hassle of thread pools.
Everything is done for you!
```python
import requests
from utile.Threader import threader
def get_requester(endpoint):
return requests.get(f"https://localhost:5000/api/{endpoint}").text # sample GET request
@threader({get_requester: [["user/1"], ["user/1/followers"]]})
def foo(): pass
foo()
```
The ``@threader()`` decorator takes in a frame-determined structure of all your functions along with its arguments
and returns the list of all the return values of the tasks.
#### @processor decorator
Provides an easy way to run multiple CPU bound tasks with no hassle of Process pools.
Again, Everything is done for you!
```python
from utile.Processor import processor
def power(a, b):
return pow(a, b) # a sample method for computational task
if __name__ == "__main__": # important to ensure this.
@processor({power: [[123, 321] for _ in range(10000)]})
def foo(): pass
print(foo())
```
The ``@processor()`` decorator takes in a frame-determined structure of all your functions along with its arguments
and returns the list of all the return values of the tasks.
> It's that simple! We take care of all your Pooling processes and you do your work!
For more information, see [Documentation](https://utile.readthedocs.io/en/latest/documentation/).
## Disclaimer
- Rust compiler must be installed in your machine for the binding to work. So use v1.0 if dont dont have rust compiler installed.
## Contribution
We encourage anyone who comes up with new ideas using decorators
to [contribute](https://github.com/j0fiN/utile) and collaborate (do star the repo if you like it !).