Metadata-Version: 2.1
Name: nestlog
Version: 2
Summary: Special logger for outputting tree like logs
Home-page: https://gitlab.com/sol-courtney/python-packages/nestlog
Download-URL: https://gitlab.com/sol-courtney/python-packages/nestlog
Author: Sol Courtney
Author-email: sol.courtney@gmail.com
Maintainer: Sol Courtney
Maintainer-email: sol.courtney@gmail.com
License: GNU General Public License v3 (GPLv3)
Project-URL: Documentation, https://nestlog.readthedocs.io
Project-URL: Gitlab Pages, https://sol-courtney.gitlab.io/python-packages/nestlog
Project-URL: Source Code, https://gitlab.com/sol-courtney/python-packages/nestlog
Project-URL: Tracker, https://gitlab.com/sol-courtney/python-packages/nestlog/-/issues
Keywords: Gitlab,Python
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE

[![PyPi Latest](https://img.shields.io/pypi/v/nestlog.svg)](https://pypi.org/project/nestlog/)
[![Build](https://gitlab.com/sol-courtney/python-packages/nestlog/badges/main/pipeline.svg)](https://gitlab.com/sol-courtney/python-packages/nestlog)
[![Codecov](https://codecov.io/gl/sol-courtney:python-packages/nestlog/branch/develop/graph/badge.svg)](https://codecov.io/gl/sol-courtney:python-packages/nestlog)
[![Docs](https://readthedocs.org/projects/nestlog/badge/?version=latest)](https://nestlog.readthedocs.io)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=sol-courtney_nestlog&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=sol-courtney_nestlog&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=sol-courtney_nestlog&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)
[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=sol-courtney_nestlog&metric=bugs)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)
[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=sol-courtney_nestlog&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)
[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=sol-courtney_nestlog&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)

[![Package Status](https://img.shields.io/pypi/status/nestlog.svg)](https://pypi.org/project/nestlog/)
[![PyVersions](https://img.shields.io/pypi/pyversions/nestlog.svg)](https://pypi.org/project/nestlog/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/nestlog.svg?label=PyPI%20downloads)](https://pypi.org/project/nestlog/)

[![License](https://img.shields.io/pypi/l/nestlog.svg)](https://gitlab.com/sol-courtney/python-packages/nestlog/-/blob/main/LICENSE)

# Welcome to Nestlog
nestlog is a formatted shell logger for producing colored tree like logs.

![Example](docs/images/level-3.png)

See the [Documentation](https://nestlog.readthedocs.io) for more help.

## Installation

From [PyPI](https://pypi.org/project/nestlog/) directly:

```
pip install nestlog
```

## Examples
This is how you use the logger

```py
import nestlog

logger = nestlog.NestLogger()

with logger('starting application'):

    with logger('starting section 1'):
        logger.okay('doing something important')
        logger.warn('warning message')
        logger.fail('failure message')

    with logger('starting section 1'):
        logger.okay('doing something important')
        logger.okay('doing something else important')
```

[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-orange.svg)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)

[![Quality gate](https://sonarcloud.io/api/project_badges/quality_gate?project=sol-courtney_nestlog)](https://sonarcloud.io/summary/new_code?id=sol-courtney_nestlog)
