log21
=====
[](https://www.codefactor.io/repository/github/mpcodewriter21/log21)
A simple logging package that helps you log colorized messages in Windows console and other operating systems.
Features
--------
+ Colors : The main reason for this package was to log text in the Windows console with the support of ANSI colors.
+ Argument parsing : log21's argument parser can be used like python's argparse but it also colorizes the output.
+ Logging : A similar logger to logging. Logger but with colorized output and other options such as levelname
modifications. It can also decolorize the output if you want to log into a file.
+ Pretty printing : Have you ever wanted to colorize the output of the pprint module? log21's pretty printer can do
that.
+ Tree printing : You can pass a dict or list to `log21.tree_print` function and it will print it in a tree-like
structure. It's also colorized XD.
+ ProgressBar : log21's progress bar can be used to show progress of a process in a beautiful way.
+ LoggingWindow : Helps you to log messages and debug your code in a window other than the console.
+ CrashReporter : log21's crash reporter can be used to report crashes in different
ways. You can use it to log crashes to console or files or use it to receive crash
reports of your program through email. And you can also define your own crash
reporter functions and use them instead!
+ Argumentify : You can use the argumentify feature to decrease the number of lines you
need to write to parse command-line arguments. It's colored by the way!
+ Any idea? Feel free to [open an issue](https://github.com/MPCodeWriter21/log21/issues) or submit a pull request.
Installation
------------
Well, this is a python package so the first thing you need is python.
If you don't have python installed, please visit [Python.org](https://python.org) and install the latest version of
python.
Then you can install log21 using pip module:
```bash
python -m pip install log21 -U
```
Or you can clone [the repository](https://github.com/MPCodeWriter21/log21) and run:
```bash
pip install .
```
Or let the pip get it using git:
```bash
pip install git+https://github.com/MPCodeWriter21/log21
```
Changes
-------
### 2.10.0
+ Added some exception classes to raise in the "argumentified" functions to show
*parser error* to the user: `ArgumentError`, `IncompatibleArguments`,
`RequiredArgument`, `TooFewArguments`
[Full CHANGELOG](https://github.com/MPCodeWriter21/log21/blob/master/CHANGELOG.md)
Usage Examples:
---------------
See [EXAMPLES.md](https://github.com/MPCodeWriter21/log21/blob/master/EXAMPLES.md)
About
-----
Author: CodeWriter21 (Mehrad Pooryoussof)
GitHub: [MPCodeWriter21](https://github.com/MPCodeWriter21)
Telegram Channel: [@CodeWriter21](https://t.me/CodeWriter21)
### License
[apache-2.0](http://www.apache.org/licenses/LICENSE-2.0)
### Donate
In order to support this project you can donate some crypto of your choice 8D
[Donate Addresses](https://github.com/MPCodeWriter21/log21/blob/master/DONATE.md)
Or if you can't, give [this project](https://github.com/MPCodeWriter21/log21) a star on GitHub :)
References
----------
+ ANSI Color Codes (
Wikipedia): [https://en.wikipedia.org/wiki/ANSI_escape_code](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors)
Raw data
{
"_id": null,
"home_page": null,
"name": "log21",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "python, log, colorize, color, logging, Python3, CodeWriter21",
"author": null,
"author_email": "\"CodeWriter21(Mehrad Pooryoussof)\" <CodeWriter21@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/41/96/62e364c1331dde0a8f518b1ad29e61fc660d53b193c81876bd91d4ea6514/log21-2.10.0.tar.gz",
"platform": null,
"description": "log21\n=====\n\n\n\n\n\n[](https://www.codefactor.io/repository/github/mpcodewriter21/log21)\n\nA simple logging package that helps you log colorized messages in Windows console and other operating systems.\n\nFeatures\n--------\n\n+ Colors : The main reason for this package was to log text in the Windows console with the support of ANSI colors.\n+ Argument parsing : log21's argument parser can be used like python's argparse but it also colorizes the output.\n+ Logging : A similar logger to logging. Logger but with colorized output and other options such as levelname\n modifications. It can also decolorize the output if you want to log into a file.\n+ Pretty printing : Have you ever wanted to colorize the output of the pprint module? log21's pretty printer can do\n that.\n+ Tree printing : You can pass a dict or list to `log21.tree_print` function and it will print it in a tree-like\n structure. It's also colorized XD.\n+ ProgressBar : log21's progress bar can be used to show progress of a process in a beautiful way.\n+ LoggingWindow : Helps you to log messages and debug your code in a window other than the console.\n+ CrashReporter : log21's crash reporter can be used to report crashes in different\n ways. You can use it to log crashes to console or files or use it to receive crash\n reports of your program through email. And you can also define your own crash\n reporter functions and use them instead!\n+ Argumentify : You can use the argumentify feature to decrease the number of lines you\n need to write to parse command-line arguments. It's colored by the way!\n+ Any idea? Feel free to [open an issue](https://github.com/MPCodeWriter21/log21/issues) or submit a pull request.\n\n\n\n\nInstallation\n------------\n\nWell, this is a python package so the first thing you need is python.\n\nIf you don't have python installed, please visit [Python.org](https://python.org) and install the latest version of\npython.\n\nThen you can install log21 using pip module:\n\n```bash\npython -m pip install log21 -U\n```\n\nOr you can clone [the repository](https://github.com/MPCodeWriter21/log21) and run:\n\n```bash\npip install .\n```\n\nOr let the pip get it using git:\n```bash\npip install git+https://github.com/MPCodeWriter21/log21\n```\n\nChanges\n-------\n\n### 2.10.0\n\n+ Added some exception classes to raise in the \"argumentified\" functions to show \n *parser error* to the user: `ArgumentError`, `IncompatibleArguments`,\n `RequiredArgument`, `TooFewArguments`\n\n[Full CHANGELOG](https://github.com/MPCodeWriter21/log21/blob/master/CHANGELOG.md)\n\n\nUsage Examples:\n---------------\n\nSee [EXAMPLES.md](https://github.com/MPCodeWriter21/log21/blob/master/EXAMPLES.md)\n\n\nAbout\n-----\nAuthor: CodeWriter21 (Mehrad Pooryoussof)\n\nGitHub: [MPCodeWriter21](https://github.com/MPCodeWriter21)\n\nTelegram Channel: [@CodeWriter21](https://t.me/CodeWriter21)\n\n### License\n\n\n\n[apache-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\n### Donate\n\nIn order to support this project you can donate some crypto of your choice 8D\n\n[Donate Addresses](https://github.com/MPCodeWriter21/log21/blob/master/DONATE.md)\n\nOr if you can't, give [this project](https://github.com/MPCodeWriter21/log21) a star on GitHub :)\n\nReferences\n----------\n\n+ ANSI Color Codes (\n Wikipedia): [https://en.wikipedia.org/wiki/ANSI_escape_code](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors)\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "A simple logging package that helps you log colorized messages in Windows console.",
"version": "2.10.0",
"project_urls": {
"Donations": "https://github.com/MPCodeWriter21/log21/blob/master/DONATE.md",
"Homepage": "https://github.com/MPCodeWriter21/log21",
"Source": "https://github.com/MPCodeWriter21/log21"
},
"split_keywords": [
"python",
" log",
" colorize",
" color",
" logging",
" python3",
" codewriter21"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4a5b3cc8c4aa1c8cef537ace8265a50740aca348855dccd1c055603a2085b510",
"md5": "f77a17115a66794d6bb2aed4f739a304",
"sha256": "b5efa213a9e74072aa10f81353db2e6c1d1203616fc82ec37322ef8dd1a53700"
},
"downloads": -1,
"filename": "log21-2.10.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f77a17115a66794d6bb2aed4f739a304",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 64679,
"upload_time": "2024-05-13T12:48:13",
"upload_time_iso_8601": "2024-05-13T12:48:13.379490Z",
"url": "https://files.pythonhosted.org/packages/4a/5b/3cc8c4aa1c8cef537ace8265a50740aca348855dccd1c055603a2085b510/log21-2.10.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "419662e364c1331dde0a8f518b1ad29e61fc660d53b193c81876bd91d4ea6514",
"md5": "73c3879319eeea2d90fbaef59050ace2",
"sha256": "44888dfdfef29ba1953c6f1f56591b558b726fe0550a7d7a2950821f405dc168"
},
"downloads": -1,
"filename": "log21-2.10.0.tar.gz",
"has_sig": false,
"md5_digest": "73c3879319eeea2d90fbaef59050ace2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 60346,
"upload_time": "2024-05-13T12:48:15",
"upload_time_iso_8601": "2024-05-13T12:48:15.614827Z",
"url": "https://files.pythonhosted.org/packages/41/96/62e364c1331dde0a8f518b1ad29e61fc660d53b193c81876bd91d4ea6514/log21-2.10.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-13 12:48:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MPCodeWriter21",
"github_project": "log21",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "log21"
}
JSON
