Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/martinthoma/mpu
Martins Python Utilities - Stuff that comes in Handy
https://github.com/martinthoma/mpu
python python-3-6 python-3-7 python-3-8 python3 utility utility-library
Last synced: 24 days ago
JSON representation
Martins Python Utilities - Stuff that comes in Handy
- Host: GitHub
- URL: https://github.com/martinthoma/mpu
- Owner: MartinThoma
- License: mit
- Created: 2018-04-28T07:17:23.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T13:38:32.000Z (almost 2 years ago)
- Last Synced: 2024-10-07T22:43:30.728Z (29 days ago)
- Topics: python, python-3-6, python-3-7, python-3-8, python3, utility, utility-library
- Language: Python
- Size: 488 KB
- Stars: 59
- Watchers: 5
- Forks: 8
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://badge.fury.io/py/mpu)
[](https://pypi.org/project/mpu/)
[](http://mpu.readthedocs.io/en/latest/?badge=latest)
[](https://travis-ci.org/MartinThoma/mpu)
[](https://app.circleci.com/pipelines/github/MartinThoma/mpu)
[](https://dev.azure.com/martinthoma/mpu/_build/latest?definitionId=1&branchName=master)
[](https://coveralls.io/github/MartinThoma/mpu?branch=master)
[](https://github.com/psf/black)
[](https://www.codefactor.io/repository/github/martinthoma/mpu/overview/master)
[](https://img.shields.io/badge/mutmut-1417%2F1813-lightgrey)
# mpu
Martins Python Utilities (mpu) is a collection of utility functions and classes
with no other dependencies.
The total size of the package will never be bigger than 10 MB and currently it
is 120 kB in zipped form. This makes it a candidate to include into AWS Lambda
projects.
## Installation
```bash
$ pip install git+https://github.com/MartinThoma/mpu.git
```
It can, of course, also be installed via PyPI.
## Usage
### Datastructures
```python-repl
>>> from mpu.datastructures import EList
>>> l = EList([2, 1, 0])
>>> l[2]
0
>>> l[[2, 0]]
[0, 2]
>>> l[l]
[0, 1, 2]
```
### Shell
To enhance your terminals output, you might want to do something like:
```python
from mpu.shell import Codes
print("{c.GREEN}{c.UNDERLINED}Works{c.RESET_ALL}".format(c=Codes))
```
### Quick Examples
Creating small example datastructures is a task I encounter once in a while
for StackExchange answers.
```python
from mpu.pd import example_df
df = example_df()
print(df)
```
gives
```
country population population_time EUR
0 Germany 82521653.0 2016-12-01 True
1 France 66991000.0 2017-01-01 True
2 Indonesia 255461700.0 2017-01-01 False
3 Ireland 4761865.0 NaT True
4 Spain 46549045.0 2017-06-01 True
5 Vatican NaN NaT True
```
### Money
```python
import mpu
from fractions import Fraction
gross_income = mpu.units.Money("2345.10", "EUR")
net_income = gross_income * Fraction("0.80")
apartment = mpu.units.Money("501.23", "EUR")
savings = net_income - apartment
print(savings)
```
prints `1375.31 Euro`
### IO
* Download files with [`mpu.io.download(source, sink)`](https://mpu.readthedocs.io/en/latest/io.html#mpu.io.download).
* Read CSV, JSON and pickle with [`mpu.io.read(filepath)`](https://mpu.readthedocs.io/en/latest/io.html#mpu.io.write).
* Write CSV, JSON and pickle with [`mpu.io.write(filepath, data)`](https://mpu.readthedocs.io/en/latest/io.html#mpu.io.read)