Metadata-Version: 2.1
Name: bella
Version: 1.1.0
Summary: BellaPy - A useful helper for any python program
Home-page: https://gitlab.com/ndaidong/bellapy
Author: @ndaidong
Author-email: ndaidong@gmail.com
License: MIT
Keywords: detection,manipulation,datetime,utils,helpers
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
Provides-Extra: test
Requires-Dist: pycodestyle ; extra == 'test'
Requires-Dist: safety ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'

# bellapy
BellaPy - A useful helper for any python program

[![PyPI version](https://badge.fury.io/py/bella.svg)](https://badge.fury.io/py/bella)
[![Build Status](https://gitlab.com/ndaidong/bellapy/badges/master/build.svg)](https://gitlab.com/ndaidong/bellapy/pipelines)


## Contents

* [Setup](#setup)
* [APIs](#apis)
* [Dev & Test](#dev-test)
* [License](#license)


## Setup

```bash
pip install bella
```


# APIs

- genid(leng, prefix)

Return a random string


```python
from bella import genid

print(genid())  # --> akrqHX7eQyT3neF6
print(genid(5))  # --> xzxNK
print(genid(10, 'id_'))  # --> id_j0fpXAZ
```


### Hashing



```python
from bella import md5, md160
```


- `md5(text)`

Return md5 hashed string


```python
md5('hello')  # --> 5d41402abc4b2a76b9719d911017c592
```


- `md160(text)`

Return md160 hashed string


```python
md160('hello')  # --> 108f07b8382412612c048d07d13f814118445acd
```


### Detection

- `is_int(value)`

Return True if value is integer

- `is_float(value)`

Return True if value is float

- `is_num(value)`

Return True if value is number

- `is_str(value)`

Return True if value is string

- `is_list(value)`

Return True if value is list

- `is_dict(value)`

Return True if value is dict


### Date & time


- `get_time()`

Return current timestamp (passed mili seconds since 00:00:00 1/1/1970)

- `format_time(time, pattern)`

Return formated datetime string of `time` by specific `pattern`


- `get_local_time()`

Return current datetime of local system

- `get_utc_time()`

Return current UCT datetime

- `get_times_distance(time_1, time_2)`

Return distance between 2 timepoints, in the friendly format such as `1d 3h 4m 5s`.


### Hardware


```python
from bella import hw
```


- `hw.get_ip()`

Return IP address of current machine


- `hw.get_mac()`

Return MAC address of current device


### Filesystem


```python
from bella import fs
```

- `fs.remove(path)`


Remove given file or folder, then return result as Boolean

- `fs.copy(source, dest)`


Copy file or folder `source` into `dest`, then return result as Boolean



# Dev & Test

```bash
git clone https://gitlab.com/ndaidong/bellapy.git
cd bellapy
python3 -m venv venv
source venv/bin/activate

# clean previous build
(venv) ./clean

# build
(venv) python setup.py install

# install packages for test
(venv) pip install -r requirements.txt
(venv) ./qualify.sh
```


# License

The MIT License (MIT)

