# py-log-mjk
### **Um pacote de logging completo e profissional para aplicações Python.**
[](https://badge.fury.io/py/py-log-mjk)
[](https://choosealicense.com/licenses/mit/)
[](https://www.python.org/downloads/release/python-3120/)
## **Visão Geral**
O `py-log-mjk` é uma solução de logging robusta e fácil de usar para projetos em Python. Ele foi projetado para ser configurado de forma declarativa, permitindo que você personalize o comportamento do logging sem precisar alterar o código da sua aplicação.
Com o `py-log-mjk`, você obtém:
- **Configuração Simples**: Gerenciamento de configurações através de um arquivo JSON.
- **Formatação Rica**: Saída de logs colorida e formatada com a biblioteca **`rich`**.
- **Logs Estruturados**: Logs em formato JSON para facilitar o monitoramento em ferramentas como o ELK Stack ou o Datadog.
- **Filtragem Avançada**: Controle de nível de log por módulo.
- **Processamento Assíncrono**: Desempenho otimizado com `QueueHandler` para processar logs em segundo plano.
## **Instalação**
Recomendamos usar o **Poetry** para gerenciar as dependências e o ambiente virtual.
```bash
# Adicione a biblioteca ao seu projeto
poetry add py-log-mjk
# Ou, se estiver desenvolvendo o pacote localmente, instale-o em modo editável
poetry install
Uso Básico
Basta importar a função get_logger e começar a usar.
# app.py
from py_log_mjk import get_logger
# Obtenha o logger. A configuração é automática.
logger = get_logger(__name__)
logger.info("A aplicação foi iniciada com sucesso!")
logger.debug("Esta é uma mensagem de depuração.")
logger.error("Ops, algo deu errado!", exc_info=True)
```
## **Instalação**
Uso Básico
Basta importar a função get_logger e começar a usar.
```bash
# app.py
from py_log_mjk import get_logger
# Obtenha o logger. A configuração é automática.
logger = get_logger(__name__)
logger.info("A aplicação foi iniciada com sucesso!")
logger.debug("Esta é uma mensagem de depuração.")
logger.error("Ops, algo deu errado!", exc_info=True)
```
## **Créditos**
Este projeto é fruto de uma aula sobre logging do prof. Luiz Otávio Miranda!
```bash
Estude, copie, adapte, melhore e compartilhe! ☕
```
Raw data
{
"_id": null,
"home_page": null,
"name": "py_log_mjk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "python, logging, toolkit, log, logging-library",
"author": "Mauricio Araujo",
"author_email": "mjk_araujo@hotmail.com",
"download_url": "https://files.pythonhosted.org/packages/ca/fe/11c90f25bfe0e5a9527618b6ced9099f7047936c116a9c276fdd828f1564/py_log_mjk-0.1.3.tar.gz",
"platform": null,
"description": "# py-log-mjk\n\n### **Um pacote de logging completo e profissional para aplica\u00e7\u00f5es Python.**\n\n[](https://badge.fury.io/py/py-log-mjk)\n[](https://choosealicense.com/licenses/mit/)\n[](https://www.python.org/downloads/release/python-3120/)\n\n## **Vis\u00e3o Geral**\n\nO `py-log-mjk` \u00e9 uma solu\u00e7\u00e3o de logging robusta e f\u00e1cil de usar para projetos em Python. Ele foi projetado para ser configurado de forma declarativa, permitindo que voc\u00ea personalize o comportamento do logging sem precisar alterar o c\u00f3digo da sua aplica\u00e7\u00e3o.\n\nCom o `py-log-mjk`, voc\u00ea obt\u00e9m:\n\n- **Configura\u00e7\u00e3o Simples**: Gerenciamento de configura\u00e7\u00f5es atrav\u00e9s de um arquivo JSON.\n- **Formata\u00e7\u00e3o Rica**: Sa\u00edda de logs colorida e formatada com a biblioteca **`rich`**.\n- **Logs Estruturados**: Logs em formato JSON para facilitar o monitoramento em ferramentas como o ELK Stack ou o Datadog.\n- **Filtragem Avan\u00e7ada**: Controle de n\u00edvel de log por m\u00f3dulo.\n- **Processamento Ass\u00edncrono**: Desempenho otimizado com `QueueHandler` para processar logs em segundo plano.\n\n## **Instala\u00e7\u00e3o**\n\nRecomendamos usar o **Poetry** para gerenciar as depend\u00eancias e o ambiente virtual.\n\n```bash\n# Adicione a biblioteca ao seu projeto\npoetry add py-log-mjk\n\n# Ou, se estiver desenvolvendo o pacote localmente, instale-o em modo edit\u00e1vel\npoetry install\n\nUso B\u00e1sico\nBasta importar a fun\u00e7\u00e3o get_logger e come\u00e7ar a usar.\n\n# app.py\nfrom py_log_mjk import get_logger\n\n# Obtenha o logger. A configura\u00e7\u00e3o \u00e9 autom\u00e1tica.\nlogger = get_logger(__name__)\n\nlogger.info(\"A aplica\u00e7\u00e3o foi iniciada com sucesso!\")\nlogger.debug(\"Esta \u00e9 uma mensagem de depura\u00e7\u00e3o.\")\nlogger.error(\"Ops, algo deu errado!\", exc_info=True)\n\n```\n\n## **Instala\u00e7\u00e3o**\nUso B\u00e1sico\nBasta importar a fun\u00e7\u00e3o get_logger e come\u00e7ar a usar.\n\n```bash\n# app.py\nfrom py_log_mjk import get_logger\n\n# Obtenha o logger. A configura\u00e7\u00e3o \u00e9 autom\u00e1tica.\nlogger = get_logger(__name__)\n\nlogger.info(\"A aplica\u00e7\u00e3o foi iniciada com sucesso!\")\nlogger.debug(\"Esta \u00e9 uma mensagem de depura\u00e7\u00e3o.\")\nlogger.error(\"Ops, algo deu errado!\", exc_info=True)\n\n```\n\n## **Cr\u00e9ditos**\nEste projeto \u00e9 fruto de uma aula sobre logging do prof. Luiz Ot\u00e1vio Miranda!\n\n```bash\nEstude, copie, adapte, melhore e compartilhe! \u2615\n\n```",
"bugtrack_url": null,
"license": "MIT",
"summary": "Um pacote de logging completo e profissional para aplica\u00e7\u00f5es Python.",
"version": "0.1.3",
"project_urls": null,
"split_keywords": [
"python",
" logging",
" toolkit",
" log",
" logging-library"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bf7f7b0a6fa0cf1693272c88ba0c903dff592799e047dafc922f554c736f2d68",
"md5": "1ce76aec81d33d18f3891a5d65f93c95",
"sha256": "65c5696bebdffc782eb57869f4cd8f615802baea762d1eeb5efd48b893f2dee6"
},
"downloads": -1,
"filename": "py_log_mjk-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1ce76aec81d33d18f3891a5d65f93c95",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 10979,
"upload_time": "2025-09-13T16:00:50",
"upload_time_iso_8601": "2025-09-13T16:00:50.154069Z",
"url": "https://files.pythonhosted.org/packages/bf/7f/7b0a6fa0cf1693272c88ba0c903dff592799e047dafc922f554c736f2d68/py_log_mjk-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cafe11c90f25bfe0e5a9527618b6ced9099f7047936c116a9c276fdd828f1564",
"md5": "1467c4f49aca14c959a452c27019f9a2",
"sha256": "e542f5a47e2dc0de9ad8232cddcf5f236c6f248d3a24c926dfa82c4210bce6ef"
},
"downloads": -1,
"filename": "py_log_mjk-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "1467c4f49aca14c959a452c27019f9a2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 7674,
"upload_time": "2025-09-13T16:00:51",
"upload_time_iso_8601": "2025-09-13T16:00:51.151764Z",
"url": "https://files.pythonhosted.org/packages/ca/fe/11c90f25bfe0e5a9527618b6ced9099f7047936c116a9c276fdd828f1564/py_log_mjk-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-13 16:00:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "py_log_mjk"
}
JSON