https://github.com/bbugyi200/logutils

Better logging made easy with support for structlog and the standard logging module.
https://github.com/bbugyi200/logutils

cc-python python

Last synced: 3 months ago
JSON representation

Better logging made easy with support for structlog and the standard logging module.

• Host: GitHub
• URL: https://github.com/bbugyi200/logutils
• Owner: bbugyi200
• Created: 2021-09-25T16:53:25.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-11-24T16:37:26.000Z (about 4 years ago)
• Last Synced: 2025-04-20T00:11:27.508Z (9 months ago)
• Topics: cc-python, python
• Language: Python
• Homepage:
• Size: 83 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# logutils

**Better logging made easy with support for structlog and the standard logging module.**

## Badges 📛

project status badges:

[![CI Workflow](https://github.com/bbugyi200/logutils/actions/workflows/ci.yml/badge.svg)](https://github.com/bbugyi200/logutils/actions/workflows/ci.yml)

[![Coverage](https://codecov.io/gh/bbugyi200/logutils/branch/master/graph/badge.svg)](https://codecov.io/gh/bbugyi200/logutils)

[![Documentation Status](https://readthedocs.org/projects/pylogutils/badge/?version=latest)](https://pylogutils.readthedocs.io/en/latest/?badge=latest)

[![Package Health](https://snyk.io/advisor/python/pylogutils/badge.svg)](https://snyk.io/advisor/python/pylogutils)

version badges:

[![Project Version](https://img.shields.io/pypi/v/pylogutils)](https://pypi.org/project/pylogutils/)

[![Python Versions](https://img.shields.io/pypi/pyversions/pylogutils)](https://pypi.org/project/pylogutils/)

[![Cookiecutter: cc-python](https://img.shields.io/static/v1?label=cc-python&message=2021.09.23-2&color=d4aa00&logo=cookiecutter&logoColor=d4aa00)](https://github.com/bbugyi200/cc-python)

[![Docker: bbugyi/python](https://img.shields.io/static/v1?label=bbugyi%20%2F%20python&message=2021.09.25&color=8ec4ad&logo=docker&logoColor=8ec4ad)](https://github.com/bbugyi200/docker-python)

tools / frameworks used by test suite (i.e. used by `make test`):

[![Framework: pytest](https://img.shields.io/badge/framework-pytest-a76465)](https://github.com/pytest-dev/pytest)

[![Framework: doctest](https://img.shields.io/badge/framework-doctest-66a6f6)](https://docs.python.org/3/library/doctest.html)

[![Runner: tox](https://img.shields.io/badge/runner-tox-9da246)](https://github.com/tox-dev/tox)

[![Types: typeguard](https://img.shields.io/badge/types-typeguard-3a7163)](https://github.com/agronholm/typeguard)

[![Mocks: pytest-mock](https://img.shields.io/static/v1?label=mocks&message=pytest-mock&color=9c70d7)](https://github.com/pytest-dev/pytest-mock)

[![Snapshots: syrupy](https://img.shields.io/static/v1?label=snapshots&message=syrupy&color=436fa8)](https://github.com/tophat/syrupy)

linters used to maintain code quality (i.e. used by `make lint`):

[![Linter: pylint](https://img.shields.io/badge/linter-pylint-ffff00)](https://github.com/PyCQA/pylint)

[![Linter: flake8](https://img.shields.io/badge/linter-flake8-008080)](https://github.com/PyCQA/flake8)

[![Types: mypy](https://img.shields.io/badge/types-mypy-cd00cd)](https://github.com/python/mypy)

[![Docstrings: pydocstyle](https://img.shields.io/badge/docstrings-pydocstyle-AFD3E6)](https://github.com/PyCQA/pydocstyle)

[![Code Style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![Imports: isort](https://img.shields.io/badge/imports-isort-ef8336)](https://github.com/PyCQA/isort)

tools / frameworks used to render documentation (i.e used by `make build-docs`):

[![Rendered By: sphinx](https://img.shields.io/badge/rendered%20by-sphinx-9cc676)](https://github.com/sphinx-doc/sphinx)

[![Hosted On: ReadTheDocs](https://img.shields.io/badge/hosted%20on-ReadTheDocs-e08839)](https://docs.readthedocs.io/en/stable/)

[![Types: sphinx-autodoc-typehints](https://img.shields.io/static/v1?label=API&message=sphinx-autodoc-typehints&color=9c70d7)](https://github.com/agronholm/sphinx-autodoc-typehints)

[![Markdown: m2r2](https://img.shields.io/badge/markdown-m2r2-8e1e3d)](https://github.com/CrossNox/m2r2)

miscellaneous tools used to maintain this project:

[![Cookiecutter Updates: cruft](https://img.shields.io/badge/cc%20updates-cruft-6a4aef)](https://github.com/cruft/cruft)

[![Requirements: pip-tools](https://img.shields.io/static/v1?label=requirements&message=pip-tools&color=a77bb5)](https://github.com/jazzband/pip-tools)

[![Releases: bump2version](https://img.shields.io/badge/releases-bump2version-163b1a)](https://github.com/c4urself/bump2version)

[![Versioning: setuptools_scm](https://img.shields.io/static/v1?label=versioning&message=setuptools-scm&color=f61a61)](https://github.com/pypa/setuptools_scm)

## Installation 🗹

To install `pylogutils` using [pip][9], run the following

commands in your terminal:

``` shell

python3 -m pip install --user pylogutils  # install logutils

```

If you don't have pip installed, this [Python installation guide][10] can guide

you through the process.

## Useful Links 🔗

* [API Reference][3]: A developer's reference of the API exposed by this

  project.

* [cc-python][4]: The [cookiecutter][5] that was used to generate this project.

  Changes made to this cookiecutter are periodically synced with this project

  using [cruft][12].

* [CHANGELOG.md][2]: We use this file to document all notable changes made to

  this project.

* [CONTRIBUTING.md][7]: This document contains guidelines for developers

  interested in contributing to this project.

* [Create a New Issue][13]: Create a new GitHub issue for this project.

* [Documentation][1]: This project's full documentation.

[1]: https://pylogutils.readthedocs.io/en/latest

[2]: https://github.com/bbugyi200/logutils/blob/master/CHANGELOG.md

[3]: https://pylogutils.readthedocs.io/en/latest/modules.html

[4]: https://github.com/bbugyi200/cc-python

[5]: https://github.com/cookiecutter/cookiecutter

[6]: https://docs.readthedocs.io/en/stable/

[7]: https://github.com/bbugyi200/logutils/blob/master/CONTRIBUTING.md

[8]: https://github.com/bbugyi200/logutils

[9]: https://pip.pypa.io

[10]: http://docs.python-guide.org/en/latest/starting/installation/

[11]: https://github.com/pypa/pipx

[12]: https://github.com/cruft/cruft

[13]: https://github.com/bbugyi200/logutils/issues/new/choose