{"id":19932191,"url":"https://github.com/fliegwerk/logsemts","last_synced_at":"2025-05-03T11:31:36.437Z","repository":{"id":37927122,"uuid":"290530137","full_name":"fliegwerk/logsemts","owner":"fliegwerk","description":"A semantic logging solution implemented with TypeScript","archived":false,"fork":false,"pushed_at":"2024-05-14T23:09:13.000Z","size":1366,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-28T22:18:04.413Z","etag":null,"topics":["browser","color","color-coded","dev-tools","javascript","logger","logging","nodejs","semantic","typescript"],"latest_commit_sha":null,"homepage":"https://fliegwerk.github.io/logsemts/","language":"TypeScript","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/fliegwerk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2020-08-26T15:11:17.000Z","updated_at":"2024-06-19T17:37:37.441Z","dependencies_parsed_at":"2024-06-19T17:37:27.552Z","dependency_job_id":"23b6d35c-839d-4ee6-833d-0c6bd1847df2","html_url":"https://github.com/fliegwerk/logsemts","commit_stats":{"total_commits":182,"total_committers":6,"mean_commits":"30.333333333333332","dds":0.5164835164835164,"last_synced_commit":"73aa6639f21f63acb164b56ea09a631c61e4368d"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fliegwerk%2Flogsemts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fliegwerk%2Flogsemts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fliegwerk%2Flogsemts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fliegwerk%2Flogsemts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fliegwerk","download_url":"https://codeload.github.com/fliegwerk/logsemts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224360230,"owners_count":17298319,"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":["browser","color","color-coded","dev-tools","javascript","logger","logging","nodejs","semantic","typescript"],"created_at":"2024-11-12T23:09:20.917Z","updated_at":"2024-11-12T23:09:21.466Z","avatar_url":"https://github.com/fliegwerk.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg alt=\"LogSemTS Logo\" height=\"300\" src=\"assets/logo.png\" /\u003e\n\u003c/p\u003e\n\n# @fliegwerk/logsemts - A modular, semantic logger written in TypeScript\n\n[npm package](https://npmjs.com/package/@fliegwerk/logsemts)\n| [Library Documentation](https://fliegwerk.github.io/logsemts)\n\n![CI](https://github.com/fliegwerk/logsemts/workflows/CI/badge.svg)\n![ShiftLeft Scan](https://github.com/fliegwerk/logsemts/workflows/ShiftLeft%20Scan/badge.svg)\n![CodeQL](https://github.com/fliegwerk/logsemts/workflows/CodeQL/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/fliegwerk/logsemts/badge.svg?branch=master)](https://coveralls.io/github/fliegwerk/logsemts?branch=master)\n[![Maintainability](https://api.codeclimate.com/v1/badges/c2d8d3ab896d0bb100ea/maintainability)](https://codeclimate.com/github/fliegwerk/logsemts/maintainability)\n[![Rate on Openbase](https://badges.openbase.io/js/rating/@fliegwerk/logsemts.svg)](https://openbase.io/js/@fliegwerk/logsemts?utm_source=embedded\u0026utm_medium=badge\u0026utm_campaign=rate-badge)\n\nA modular, color-coded, TypeScript-based semantic logger that can be used in NodeJS, the browser and in many other scenarios.\n\n## Example\n\n```ts\n// Import the logger:\nimport Logger, { BrowserLogger } from '@fliegwerk/logsemts';\n\n// Create a new logger\nconst logger = new Logger({\n\tloggers: [BrowserLogger()] // that exclusively outputs to the browser dev tools\n});\n\n// get a new subsystem logger for the API Client\nconst apiClientLogger = logger.getComponentLogger('API Client');\n\n// log a success message\napiClientLogger.success('Data fetched successfully');\n```\n\n## Installation\n\n```shell script\n$ npm install @fliegwerk/logsemts\n```\n\nor\n\n```shell script\n$ yarn add @fliegwerk/logsemts\n```\n\n## Concept\n\n![Concept Overview Diagram](assets/drawio/concept-overview.png)\n\nThere are three primary components in logsemts:\n\n- _Component Loggers_: Logger objects for specific subsystems (for example, an API connector and a login form).\n  These objects contain functions like `.log()`, `.debug()`, `.warn()`, etc. to log messages regarding this subsystem.\n- _Log Functions_: Functions that log a message to a specific target. Targets could be the Browser's Developer tools, a\n  Database and an API.\n- _Core_: The library's core consists of the `Logger` class. Usually, only one instance of that class gets used in an\n  application. It manages the different components (_Component Loggers_ get created using the\n  `logger.getComponentLogger(name)` function) and _Log Functions_. It also forwards the messages from the _Component\n  Loggers_ to the registered _Log Functions_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffliegwerk%2Flogsemts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffliegwerk%2Flogsemts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffliegwerk%2Flogsemts/lists"}