Metadata-Version: 2.1
Name: lutils
Version: 2.10.3.2
Summary: A Public Loitd Python Utility Library
Home-page: https://github.com/loitd/lutils
Author: Tran Duc Loi
Author-email: loitranduc@gmail.com
License: UNKNOWN
Project-URL: Website, https://inneka.com/
Project-URL: Documentation, https://inneka.com/
Project-URL: Source Code, https://github.com/loitd/lutils
Project-URL: Javascript, https://github.com/loitd/lutilsjs/
Project-URL: Pypi, https://pypi.org/project/lutils/
Description: # lutils
        ## A Loitd's Public Python Utilities Library. 
        Website: [https://inneka.com](https://inneka.com)  
        Pip: [https://pypi.org/project/lutils/](https://pypi.org/project/lutils/)  
        Git: [https://github.com/loitd/lutils/](https://github.com/loitd/lutils/)  
        JS: [https://github.com/loitd/lutilsjs/](https://github.com/loitd/lutilsjs/) - Not equivalent  
        ## Installation
        You can easily install this library with command `pip` or `pipenv`:  
        `pip install lutils`  
        With specific version (pip will automatically uninstall older version & install specific version):  
        `pip install lutils~=2.10.2`  
        Update existing installation:
        `pipenv update lutils`
        Update existing installation (manually):
        `pipenv uninstall lutils`  
        and then:  
        `pipenv install lutils`  
        ## Note
        - Works with Python 2.x, 3.x. Recommended Python 3.x for performance and full support features
        - Support Unicode from version 2.10.2.2. Then please update to newest version.
        - Backward compatible with Python 2.7 (recommended for 2.x) from version 2.10.2.1. From 2.10.2.1, lutils works on both 2.x and 3.x
        - Any suggestions are welcome with pull request or email at loitranduc[at]gmail.com
        - Introduction or guide (docs) if available will be at [https://inneka.com](https://inneka.com)  
        ## Usage
        In your python file:  
        ~~~
        # import printlog() to both PRINT to SCREEN & WRITE to LOGFILE
        from lutils.lutils import printlog, printwait
        
        # using printlog. If file not exist, printlog will creates a new one
        # If the log file exists, printlog will appends to the end of the log file
        printlog("abc", "test.log")
        
        # using printwait. Print text to console & write to logfile & wait with dots in specific seconds
        printwait("Please wait while doing things", 5, "logfile.log")
        
        
        ~~~
        To connect SSH to Linux servers and get disk space status
        ~~~
        # import LServer
        from lutils.lutils import LServer
        
        # init instance
        srv = LServer()
        
        # connect to server
        srv.connect(ip="192.168.1.2", uname="root", pwd="123456")
        
        # get disk space
        srv.getdiskspace()
        ~~~
        ## For developers
        To build this package:  
        * `pip install --upgrade pip setuptools wheel`
        * `pip install tqdm`
        * `pip install --user --upgrade twine keyring`  
        
        Compiling this package:  
        * `python setup.py sdist bdist_wheel`  
        
        Upload to PyPI:  
        * `python -m twine upload --skip-existing dist/*`  
        or
        * `python -m twine upload --skip-existing -u loitd --repository-url https://upload.pypi.org/legacy/ dist/*`  
        
        Easy upload with keyring:  
        `python -m keyring set https://upload.pypi.org/legacy/ loitd`
Keywords: python python2 python3 library utilities loitd
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Monitoring
Classifier: Natural Language :: English
Description-Content-Type: text/markdown
