Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/epicstuff/python-epicstuff
A few somewhat useful (Epic) python objects/functions (Stuff)
https://github.com/epicstuff/python-epicstuff
helper pypi python python-library python3
Last synced: 3 days ago
JSON representation
A few somewhat useful (Epic) python objects/functions (Stuff)
- Host: GitHub
- URL: https://github.com/epicstuff/python-epicstuff
- Owner: EpicStuff
- License: other
- Created: 2024-01-31T19:16:59.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-09-05T17:24:23.000Z (5 months ago)
- Last Synced: 2025-01-10T14:36:30.322Z (14 days ago)
- Topics: helper, pypi, python, python-library, python3
- Language: Python
- Homepage: https://pypi.org/project/epicstuff/
- Size: 53.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EpicStuff
A few (currently only 3) somewhat useful (Epic) python objects/functions (Stuff)
## Installation
```bash
pip install epicstuff
```
## Bar
Makes using nested progress bars from rich.progress easier
- Example:
basically replaces
```python
from rich.progress import Progress
with Progress() as progress:
task = progress.add_task("task", total=100)
for i in range(100):
sub_task = progress.add_task("subtask", total=100)
for j in range(100):
time.sleep(0.01) # some task
progress.update(sub_task, advance=1)
progress.remove_task(sub_task)
progress.update(task, advance=1)
```
with
```python
from epicstuff import Bar
with Bar() as bar:
for i in bar(range(100)):
for j in bar(range(100), transient=True):
time.sleep(0.01) # some task
```
with minor extra features (fancier default bar)
## Dict
Lets you access a dictionary's keys as attributes
### new version
Simpler than [`Bar`](https://pypi.org/project/python-box/) (and faster i think) and with more features (basically only recursive conversion) than [`jdict`](https://pypi.org/project/pyjdict/) (and without some of the "extra" stuff)
- Example:
```python
from epicstuff import Dict
d = Dict({"a": 1, "b": {"c": 2, "d": 3}})
print(d.b.c) # 2
```
### old version
"Wraps" a target instead of converting it into a (new) `Dict` object. Useful for when your "target" is say, a `CommentedMap` and you don't want to loose the comments
- Example:
```python
from epicstuff import Dict
d = Dict(dict(), _convert=False) # ignore the unexpected-keyword-arg warning
# d._t points to the original dictionary
d.x = 1
```
downsides: currently no recursive "wrapping" and is "messier" than the new Dict in VSCode debugger
## Timer
a simple timer to time execution of code a code segment
- Example:
```python
from epicstuff import timer
with timer():
pass # some code
# outputs: Time elapsed: 0.0 seconds
# message can be changed by passing a string with {} to timer
```
## Stuff
extra functions:
- `open`: overwriting `open` to use `encoding='utf8'` by default
- `wrap`: just a renamed `functools.partial`
## TODO:
- [ ] when doing bar in bar with the second bar being transient, make so that the dots continue from where the previous bar left off
- [ ] implement auto transient for bar in bar
- [ ] add and implement simple=False for .Bar.track()
## Stuff:
- Note to self:
- "self install" using `pip install -U -e .`
- upload by running `python -m build` then `twine upload dist/*`