{"id":18975002,"url":"https://github.com/bufferapp/python-bufflog","last_synced_at":"2026-04-08T18:30:18.464Z","repository":{"id":57456753,"uuid":"292026870","full_name":"bufferapp/python-bufflog","owner":"bufferapp","description":"Python logger for Buffer services","archived":false,"fork":false,"pushed_at":"2020-10-22T15:24:38.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-01T09:09:32.881Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bufferapp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-09-01T14:53:50.000Z","updated_at":"2020-10-22T15:24:41.000Z","dependencies_parsed_at":"2022-09-02T14:21:18.963Z","dependency_job_id":null,"html_url":"https://github.com/bufferapp/python-bufflog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufferapp%2Fpython-bufflog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufferapp%2Fpython-bufflog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufferapp%2Fpython-bufflog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufferapp%2Fpython-bufflog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bufferapp","download_url":"https://codeload.github.com/bufferapp/python-bufflog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239972563,"owners_count":19727401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T15:16:56.489Z","updated_at":"2026-04-08T18:30:18.422Z","avatar_url":"https://github.com/bufferapp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Python Bufflog\n\n![GitHub Workflow Status](https://img.shields.io/github/workflow/status/bufferapp/python-bufflog/Publish%20Python%20%F0%9F%90%8D%20distributions%20%F0%9F%93%A6%20to%20PyPI)\n[![PyPI](https://img.shields.io/pypi/v/python-bufflog?label=version\u0026style=flat)](https://pypi.org/project/python-bufflog/)\n![GitHub](https://img.shields.io/github/license/bufferapp/python-bufflog?style=flat)\n\nPython logger for Buffer services.\n\n## Installation\n\nYou can use `pip` to install `python-bufflog`:\n\n```python\npip install python-bufflog\n```\n\n## Usage\n\n```python\n\nimport bufflog\n\nbufflog = bufflog.get_logger(__name__)\n\nbufflog.debug('Hello debug', context={\"some\":\"stuff\"})\nbufflog.info('Hello info')\nbufflog.error('Hello error')\nbufflog.critical('Hello critical')\n```\n\n## Log verbosity levels\n\nIf you wish to see more logs, simply set the `LOG_LEVEL` to the desired level. Here a list with some use case:\n\n|  Levels  | Use case                                                                                                                               | Examples                                                                                                          |\n| :------: | -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |\n|  DEBUG   | Information used for interactive investigation, with no long-term value. Activate it with `LOG_LEVEL=DEBUG`                            | Printing function names, steps inside a function.                                                                 |\n|   INFO   | Interesting events. Track the general flow of the application.  Activate it with `LOG_LEVEL=INFO`                                      | User logs in, SQL logs, worker process/delete a message...                                                        |\n|  NOTICE  | Uncommon events. **This is the default verbosity level**.                                                                              | Missing environment variables, page redirection, pod starting/restarting/terminating, retrying to query an API... |\n| WARNING  | Exceptional occurrences that are not errors. Undesirable things that are not necessarily wrong.                                        | Use of deprecated APIs,  poor use of an API, unauthorized access, pod restart because of memory limit ...         |\n|  ERROR   | Runtime errors. Highlight when the current flow of execution is stopped due to a failure.                                              | Exceptions messages, incorect credentials or permissions...                                                       |\n| CRITICAL | Critical conditions. Describe an unrecoverable application, system crash, or a catastrophic failure that requires immediate attention. | Application component unavailable, unexpected exception. entire website down, database unavailable ...            |\n\n## Development\n\nFor local development, create a new virtual environment and activate it. That can be done with Python `venv` module.\n\n```bash\n$ python -m venv venv\n$ source venv/bin/activate\n```\n\nOnce the virtual environment is activated, install `python-bufflog` locally:\n\n```bash\n$ pip install -e .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbufferapp%2Fpython-bufflog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbufferapp%2Fpython-bufflog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbufferapp%2Fpython-bufflog/lists"}