Metadata-Version: 2.1
Name: neologger
Version: 1.3.1
Summary: NeoLogger is a versatile Python library that simplifies and enhances logging and notifications in your applications. NeoLogger seamlessly integrates with Slack and Microsoft Teams for real-time notifications and supports broadcasting messages over the STOMP protocol. With its straightforward API, it streamlines the incorporation of advanced logging and notification features, saving you development time and effort.
Author-email: Pablo Martinez <neolink3891@gmail.com>
License: MIT License
        
        Copyright (c) 2024 Pablo Martinez
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        1. The above copyright notice and this permission notice shall be included in
           all copies or substantial portions of the Software.
        
        2. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
           LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
           FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
           DEALINGS IN THE SOFTWARE.
        
Project-URL: Homepage, https://github.com/neolink3891/NeoLogger
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: stomp.py
Requires-Dist: requests

# NeoLogger

![PyPI Downloads](https://static.pepy.tech/badge/neologger)     
   

<p align="center">
  <img src="docs/imgs/neologger_banner.png" alt="NeoLogger Banner">
</p>

A collection of Python notification classes for enhanced logging, messaging, and Slack notifications.   

[Find me on PyPi.org](https://pypi.org/project/neologger/) 

## Overview

NeoLogger provides a set of tools to improve logging output with customizable styles, send messages over STOMP protocol, and send Slack notifications with rich formatting.

## Features

- **NeoLogger**: Advanced logging with customizable colors, styles, and templates.
- **StompBabbler**: Send messages over STOMP protocol to a specified queue.
- **SlackNotification**: Assemble and send richly formatted notifications to Slack channels via webhooks.

## Installation

You can install NeoLogger via pip:

```bash
pip install neologger
```

## Requirements

Python 3.9 or higher

## Dependencies:
stomp.py    
requests

## Package Content

- [NeoLogger](docs/neologger.md)    
Examples of NeoLogger usage as well as examples for customisation for logs.

<p align="center">
  <img src="docs/imgs/neologger_6.png" alt="NeoLogger Banner">
</p>
<p align="center">
  <img src="docs/imgs/neologger_11.png" alt="NeoLogger Banner">
</p>
<p align="center">
  <img src="docs/imgs/neologger_16.png" alt="NeoLogger Banner">
</p>

- [SlackNotifications](docs/slacknotifications.md)    
Examples of Slack Notification usage as well as examples for custom for notifications.

<p align="center">
  <img src="docs/imgs/neologger_17.png" alt="NeoLogger Banner">
</p>

- [StompBabbler](docs/stompbabbler.md)    
Examples of Stomp Notification usage.

## Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss changes.

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Acknowledgments

Inspired by the need for customizable logging and notification tools in Python applications.

Utilizes the stomp.py library for STOMP protocol messaging.     
Utilizes the requests library for HTTP requests to Slack webhooks.

## Contact

📧 - For questions or suggestions, please contact Pablo Martinez at neolink3891@gmail.com    

🌐 - You can also connect with me on [LinkedIn](https://www.linkedin.com/in/orlando-martinez-2649051aa).

## Full Documentation

For full documentation, please refer to our [GitHub repository](https://github.com/neolink3891/NeoLogger).
