https://github.com/loitd/lutils
Loitd Public Ultilities Project
https://github.com/loitd/lutils
library python python3
Last synced: about 1 year ago
JSON representation
Loitd Public Ultilities Project
- Host: GitHub
- URL: https://github.com/loitd/lutils
- Owner: loitd
- License: apache-2.0
- Created: 2019-06-18T02:42:38.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T10:54:07.000Z (over 3 years ago)
- Last Synced: 2024-04-25T13:43:04.328Z (about 2 years ago)
- Topics: library, python, python3
- Language: Python
- Homepage: https://loitd.github.io/lutils/
- Size: 280 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# lutils
[](https://codecov.io/gh/loitd/lutils)
[](https://circleci.com/gh/loitd/lutils)
## A Loitd's Public Python Utilities Library.
Website: [https://loitd.github.io/lutils](https://loitd.github.io/lutils/)
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.11.74`
Install with pipenv:
`pipenv install lutils~=2.11.74`
Update existing installation:
`pipenv update lutils`
Update existing installation (manually):
`pipenv uninstall lutils`
and then:
`pipenv install lutils`
## Note
- Works with Python 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://github.com/loitd/lutils/](https://github.com/loitd/lutils/)
## Usage
In your python file:
~~~
from lutils.utils import printlog, printwait
printlog("abc", "test.log")
printwait("Please wait while doing things", 5, "logfile.log")
~~~
To connect SSH to Linux servers and get disk space status
~~~
from lutils.utils import LServer
srv = LServer()
srv.connect(ip="192.168.1.2", uname="root", pwd="123456")
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`
CI/CD Automated with Pytest and Circle CI
* `https://app.circleci.com/pipelines/github/loitd/lutils`
## License
* [License](https://github.com/loitd/lutils/blob/master/LICENSE)