Metadata-Version: 2.1
Name: bella
Version: 1.2.2
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
Description: # 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
        
        
        ### Utils
        
        
        ```python
        from bella import throttle
        
        
        @throttle(5)
        def fn(a):
            print('No call multi times within 5 seconds')
            print(a)
        
        
        fn(1)
        fn(2)
        fn(3)
        fn(4)
        fn(5)
        fn(6)
        fn(7)
        ```
        
        
        # 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)
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
