Simple, easy-to-use loading sequence/progress bar module.
Project description
# PyLoadBar
> _**Simple, easy-to-use loading sequence module.**_
## About
---
- Useful for small intermittant pauses between console text returns, or code actions.
- Customizable, optional loading and completion messages available to print to the console.
- Loading message defaults to `"Loading..."`.
- Completion message defaults to `"Done!"`.
- Includes an _optional_ progress bar (simple change the `progressbar` parameter to equal `"True"`).
## Installing PyLoadBar
---
### Using pip
> _Easiest_ method.
- Run the following to install:
```python
pip install PyLoadBar
```
---
### Manual Installation
1. Download source code from the [PyLoadBar GitHub](https://github.com/PyLoadBar) repo.
2. Extract contents of the containing `**.zip` file to desired install location.
3. Navigate to directory containing extracted contents, and open said folder within a terminal.
4. Enter `pip install -r requirements.txt` to install all dependencies for this package.
5. Finally, move the `"PyLoadBar-vx.x.x"` diretory to your global Python 3rd-party package installation directory to be able to import `PyLoadBar` like any other module:
- `"path/to/python/Lib/site-packages/here"`
6. Done!
---
## Usage
- Within a `.py` project, simply import the `PyLoadBar` module to start using your custom loading sequence.
- `PyLoadBar` is _very_ simple to use.
- For example, try running the following:
```python
from PyLoadBar import load
equation = 20 * 20
load(msg_loading = 'Solving', msg_complete = 'Okay!\n')
print(equation)
```
- This will return:
```python
Solving...
100%|█████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 5/5 [00:00<00:00, 8.94it/s].
Okay!
400
```
- Of course, the _loading_ and _loading complete_ messages can be customized by passing custom strings to the `msg_loading` and `msg_complete` parameters respectively.
- Note that the progress bar **can** be toggled using the `progressbar: bool` parameter within the `load(msg_complete: str, msg_loading: str, progressbar: bool, time: int)` method.
- The time taken to completely fill the progress bar can be determined using the `time: int` parameter.
- Every 5 units = 1 second.
- e.g. `load(time=10)` would take 2 seconds to fill the progress bar.
---
## Contributing to PyLoadBar
- If you wish to help contribute to this project, along with the tools you need to develop and run tests, please run the following in your virtual env:
'''python
pip install -e .[dev]
'''
## Contact
- If you have any questions, comments, or concerns that cannot be alleviated through the [project's GitHub repository](https://github.com/schlopp96/PyLoadBar), please feel free to contact me through my email address:
- `schloppdaddy@gmail.com`
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
PyLoadBar-0.0.3.1.tar.gz
(16.9 kB
view hashes)
Built Distribution
Close
Hashes for PyLoadBar-0.0.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae7cbf2eef7b4ddc32f8ac0e7637f828b62d544bc1862998c7bfe0ae07f57eaa |
|
MD5 | b9e94e89a97996d70cd53415ee21592c |
|
BLAKE2b-256 | ff453c8e08bba79830bc9e3771f7bfafbf3c65341fd8d54a167820a2fa3d6444 |