{"id":15718431,"url":"https://github.com/justintime50/woodchips","last_synced_at":"2025-09-05T22:34:40.915Z","repository":{"id":45963020,"uuid":"427787682","full_name":"Justintime50/woodchips","owner":"Justintime50","description":"The cutest little logger you've ever seen.","archived":false,"fork":false,"pushed_at":"2024-10-10T22:17:18.000Z","size":41,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-23T08:52:01.534Z","etag":null,"topics":["log","logger","logging","logs","wood","woodchips"],"latest_commit_sha":null,"homepage":"","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/Justintime50.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["Justintime50"]}},"created_at":"2021-11-13T22:39:08.000Z","updated_at":"2024-10-10T22:17:21.000Z","dependencies_parsed_at":"2022-09-23T09:00:15.090Z","dependency_job_id":"37348708-44f6-4e56-ba4b-abcdf8427f6b","html_url":"https://github.com/Justintime50/woodchips","commit_stats":{"total_commits":21,"total_committers":1,"mean_commits":21.0,"dds":0.0,"last_synced_commit":"9908c4a299e6fba6aa279b89eadec821ba719ea3"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":"Justintime50/python-template","purl":"pkg:github/Justintime50/woodchips","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fwoodchips","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fwoodchips/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fwoodchips/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fwoodchips/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Justintime50","download_url":"https://codeload.github.com/Justintime50/woodchips/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fwoodchips/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273832386,"owners_count":25176262,"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","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["log","logger","logging","logs","wood","woodchips"],"created_at":"2024-10-03T21:53:03.071Z","updated_at":"2025-09-05T22:34:40.893Z","avatar_url":"https://github.com/Justintime50.png","language":"Python","funding_links":["https://github.com/sponsors/Justintime50"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Woodchips\n\nThe cutest little logger you've ever seen.\n\n[![Build Status](https://github.com/Justintime50/woodchips/workflows/build/badge.svg)](https://github.com/Justintime50/woodchips/actions)\n[![Coverage Status](https://coveralls.io/repos/github/Justintime50/woodchips/badge.svg?branch=main)](https://coveralls.io/github/Justintime50/woodchips?branch=main)\n[![PyPi](https://img.shields.io/pypi/v/woodchips)](https://pypi.org/project/woodchips)\n[![Licence](https://img.shields.io/github/license/Justintime50/woodchips)](LICENSE)\n\n\u003cimg src=\"https://raw.githubusercontent.com/Justintime50/assets/main/src/woodchips/showcase.png\" alt=\"Showcase\"\u003e\n\n\u003c/div\u003e\n\n\u003e Aren't logs just a bunch of woodchips?\n\nWoodchips was created to be the cutest little logger you've ever seen. I wanted something dead simple and reusable as I found myself using the same logging setup over and over in projects. Woodchips gives you everything you need to setup the Python logging library in your project, all without the need to import or call on the `logging` package, know the various syntaxes for setting up handlers and formatters, etc which makes logging with Woodchips incredibly simple and clean.\n\n## Install\n\n```bash\n# Install tool\npip3 install woodchips\n\n# Install locally\njust install\n```\n\n## Usage\n\n- A `Logger` instance must be created to use Woodchips. Simply specify a name and logging level, tell Woodchips where to log items (console and/or files), and start chipping away!\n- Need multiple loggers, no problem. Spin up separate `Logger` instances for your needs. Maybe you need a console logger for certain output that requires a specific format while another module needs a generic file formatter. Woodchips makes it easy to setup and configure all your loggers.\n- **Logging to a file:** Woodchips will automatically roll over your log files once it reaches the `log_size`. You can configure `num_of_logs` to specify how many log files will be kept in the rotation.\n  - **NOTE:** Woodchips has a very small default log size of just `200kb` with `5` log files for a total of `1mb` of logs. For production applications, these values may need to be drastically increased.\n- **Formatters:** You can configure the format of log files per handler (console and/or files); however, defaults are set (and shown below) if you just need basic logging.\n\n### Setting up Woodchips\n\n```python\nimport woodchips\n\n# Setup a new logger instance\nlogger = woodchips.Logger(\n    name='my_logger_name',  # The name of your logger instance, often will be `__name__`\n    level='INFO',  # The log level you want to use\n)\n\n# Setup console logging\nlogger.log_to_console(formatter='%(message)s')\n\n# Setup file logging\nlogger.log_to_file(\n    location='path/to/log_files',\n    formatter='%(asctime)s - %(module)s.%(funcName)s - %(levelname)s - %(message)s',\n    log_size=200000,  # Size of a single file in bytes\n    num_of_logs=5,  # Number of log files to keep in the rotation\n)\n```\n\n### Using Woodchips\n\n```python\nimport woodchips\n\n# Retrieve a logger instance by name (assumes it's already been created)\nlogger = woodchips.get('my_logger_name')\n\n# Log a message (will be logged to console and a file based on the example from above)\nlogger.info('This is how to setup Woodchips!')\n```\n\n### Logger Levels\n\n- CRITICAL\n- ERROR\n- WARNING\n- INFO\n- DEBUG\n- NOTSET\n\n## Development\n\n```bash\n# Get a comprehensive list of development tools\njust --list\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustintime50%2Fwoodchips","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustintime50%2Fwoodchips","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustintime50%2Fwoodchips/lists"}