Metadata-Version: 2.1
Name: scilogger
Version: 1.1.0
Summary: SciLogger - Python Logging for Science
Author-email: Thomas Guillod <guillod@otvam.ch>
Maintainer-email: Thomas Guillod <guillod@otvam.ch>
License: BSD-2-Clause
Project-URL: Homepage, https://github.com/otvam/scilogger
Project-URL: Repository, https://github.com/otvam/scilogger
Project-URL: Releases, https://github.com/otvam/scilogger/releases
Project-URL: Issues, https://github.com/otvam/scilogger/issues
Project-URL: Tags, https://github.com/otvam/scilogger/tags
Keywords: Python,Timing,Logging,Logger,Log
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Natural Language :: English
Classifier: Environment :: Console
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# SciLogger - Python Logging for Science 

> * **Repository: [github.com/otvam/scilogger](https://github.com/otvam/scilogger)**
> * **Package: [pypi.org/project/scilogger](https://pypi.org/project/scilogger)**

## Summary

**SciLogger** is a **Python Logging** module:
* Specially targeted for **scientific applications**.
* Use a **global timer** to measure the **elapsed time**.
* Provide a class for **timing code blocks**.
* Definition of **custom indentation levels**.
* Definition of **colors** for the logging levels.

**SciLogger** is using a global **INI configuration** file:
* First, the **default configuration** is loaded (`scilogger/scilogger.ini`).
* Afterward, a **custom file** can be loaded with an environment variable (`SCILOGGER`)

SciLogger is written in Python without any external dependencies.

## Warning

* This logging module is **based** on the **Python logging module**.
* The philosophy of this logging module is slightly different. 
* Mixing both modules can create strange/incorrect behaviors.

## Example

An example is located in the `example` folder of the repository:
* `run_logger.py` contains an example file for the logger
* `configlogger.ini` contains a custom configuration file

```bash
# Set the configuration file.
export SCILOGGER="configlocal.ini"

# Run the Python script.
python run_logger.py
```

## Project Links

* Repository: https://github.com/otvam/scilogger
* Releases: https://github.com/otvam/scilogger/releases
* Tags: https://github.com/otvam/scilogger/tags
* Issues: https://github.com/otvam/scilogger/issues
* PyPi: https://pypi.org/project/scilogger

## Author

* **Thomas Guillod**
* Email: guillod@otvam.ch
* Website: https://otvam.ch

## Copyright

> (c) 2023 - Thomas Guillod
> 
>  BSD 2-Clause "Simplified" License
