{ "info": { "author": "Vince Forgione", "author_email": "v.forgione@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Console", "Environment :: Web Environment", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "Intended Audience :: System Administrators", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: MacOS", "Operating System :: POSIX", "Programming Language :: Python :: 3.6" ], "description": "==========\n logging2\n==========\n\nA More Pythonic Logging System; *or,* You Deserve Better Than log4j\n\n.. image:: https://travis-ci.org/vforgione/logging2.svg?branch=master\n :target: https://travis-ci.org/vforgione/logging2\n.. image:: https://coveralls.io/repos/github/vforgione/logging2/badge.svg?branch=master\n :target: https://coveralls.io/github/vforgione/logging2?branch=master\n.. image:: https://readthedocs.org/projects/logging2/badge/?version=latest\n :target: http://logging2.readthedocs.io/en/latest/?badge=latest\n\n-------------------------------\n The Basic Contract of Logging\n-------------------------------\n\nLogging should be simple and intuitive.\n\nFor most use cases, you want to quickly instantiate a logger and dump some text\nto a stream. You would expect a common workflow based on a minimum level of\nverbosity in the log entries and for those entries to be formatted in some\nfashion that is both human readable and machine parseable. There should also be\na set of common metadata that can be used to provide context to the entry.\n\nThat context should also be easily extended to suit everyone's use cases.\nAdditionally, the values passed to that context should be pliable - users should\nhave the option to override those values as they deem necessary.\n\nCommon meta information should conform to as widely adopted standards as\npossible - i.e. ISO 8601 timestamps and full unicode supported messages.\n\nAs stated foremost, the interface to this system should be simple and\nintuitive. This means the complexity of the system should be minimized,\nconfiguration should have sane defaults and the supporting library should\nbe packed with expressive documentation.\n\nImplementation of the Contract\n------------------------------\n\nThe user should only be concerned with three components:\n\n- Verbosity (``LogLevel``)\n- Message Producers (``Handler``)\n- Message Creation (``Logger``)\n\n--------------\n Installation\n--------------\n\n``logging2`` is available through PyPI, and thus can be installed via pip::\n\n $ pip install logging2\n\n\n------------\n Quickstart\n------------\n\nLogging should be simple and intuitive. With that in mind, the easiest way to get up and running is\nto instantiate a ``Logger`` and start producing entries::\n\n >>> from logging2 import Logger\n\n >>> logger = Logger('app')\n >>> logger.info('Hello, world!')\n 2017-04-29T17:08:23.156795+00:00 INFO app: Hello, world!\n\nThe default logger will dump all log entries to STDOUT with a minimum verbosity of ``info``.\n\nThere are numerous configurations, all with simple and easy to rationalize behavior:\n\n- log entry verbosity\n- log producers (handlers)\n- intuitive interface to creating log entries (loggers)\n\n``Logger`` s have a handful of ways of creating log entries via:\n\n- ``debug`` for the most verbose level of messages\n- ``info`` for typical informational messages\n- ``warning`` for calling user attention to a potentially hazardous conditions\n- ``error`` for altering users to captured and recovered from error conditions\n- ``exception`` for capturing exception tracebacks in the log\n\nThe mechanism for producing the log entries to the output streams is via ``Handler`` s. Handlers\nare broken into three groups:\n\n- ``streaming`` for common IO messaging (typically STDOUT and STDERR)\n- ``files`` for file system based IO\n- ``sockets`` for network based messaging\n\nAll of which are found in the ``logging2.handlers`` package.\n\n---------\n Caveats\n---------\n\n**This logging utility is designed for Python 3.6 and better.** It will not be\nbackported to support any earlier versions of Python.", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/vforgione/logging2", "keywords": "logging", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "logging2", "package_url": "https://pypi.org/project/logging2/", "platform": "", "project_url": "https://pypi.org/project/logging2/", "project_urls": { "Homepage": "https://github.com/vforgione/logging2" }, "release_url": "https://pypi.org/project/logging2/0.1.2/", "requires_dist": null, "requires_python": "", "summary": "A More Pythonic Logging System", "version": "0.1.2" }, "last_serial": 2842161, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "868e3651986938ee0f53c133f1930c04", "sha256": "29eb9b09a69ee0c1b4dcdeeec379b205d0f2638d9ec82597addcffb227c7cb11" }, "downloads": -1, "filename": "logging2-0.1.0.tar.gz", "has_sig": true, "md5_digest": "868e3651986938ee0f53c133f1930c04", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5901, "upload_time": "2017-05-01T05:36:15", "url": "https://files.pythonhosted.org/packages/38/d0/b140249851429e3520758a191b0375f3d75a3c199731390ad49ac17555ce/logging2-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "1acc1b4b145f432ccf010aeee9d2f1c2", "sha256": "16d14fec156c65dd7ba20cee43129e52de5e506d76d994d523f067ee94b2372e" }, "downloads": -1, "filename": "logging2-0.1.1.tar.gz", "has_sig": true, "md5_digest": "1acc1b4b145f432ccf010aeee9d2f1c2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8555, "upload_time": "2017-05-01T05:52:08", "url": "https://files.pythonhosted.org/packages/1e/df/3994d6f04915dbfa2ea900807aeeff36801d87868f83e1fad3fb6518bc5f/logging2-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "1abd4a04e23a8b6ae60eea419eabeb7a", "sha256": "947356fd3e5c972749e1c2539843b6dbfc755bdc2611aaf9237904e7304b6d55" }, "downloads": -1, "filename": "logging2-0.1.2.tar.gz", "has_sig": true, "md5_digest": "1abd4a04e23a8b6ae60eea419eabeb7a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9249, "upload_time": "2017-05-01T15:22:39", "url": "https://files.pythonhosted.org/packages/ff/0f/5777f6436834a7cdefb61cfefbdc9b2c02a0f9c903f237148b8756681fd9/logging2-0.1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1abd4a04e23a8b6ae60eea419eabeb7a", "sha256": "947356fd3e5c972749e1c2539843b6dbfc755bdc2611aaf9237904e7304b6d55" }, "downloads": -1, "filename": "logging2-0.1.2.tar.gz", "has_sig": true, "md5_digest": "1abd4a04e23a8b6ae60eea419eabeb7a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9249, "upload_time": "2017-05-01T15:22:39", "url": "https://files.pythonhosted.org/packages/ff/0f/5777f6436834a7cdefb61cfefbdc9b2c02a0f9c903f237148b8756681fd9/logging2-0.1.2.tar.gz" } ] }