{"id":20178127,"url":"https://github.com/vsnthdev/itivrutaha","last_synced_at":"2025-07-30T22:07:13.577Z","repository":{"id":42657503,"uuid":"189856335","full_name":"vsnthdev/itivrutaha","owner":"vsnthdev","description":"( इतिवृत्तः ) — An 👌 easy-to-use, 🛠️ configurable, Bun-first ⚡ console logger.","archived":false,"fork":false,"pushed_at":"2025-01-02T14:24:01.000Z","size":9347,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-19T13:46:35.568Z","etag":null,"topics":["bun","cli","javascript","library","logger","logging","nodejs"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vsnthdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2019-06-02T14:27:17.000Z","updated_at":"2025-01-02T14:24:05.000Z","dependencies_parsed_at":"2023-02-08T12:05:12.620Z","dependency_job_id":"7a41f429-bda0-47f1-9e89-9cae6daee373","html_url":"https://github.com/vsnthdev/itivrutaha","commit_stats":{"total_commits":94,"total_committers":4,"mean_commits":23.5,"dds":"0.26595744680851063","last_synced_commit":"9f53801d9a0cfd617b011b913c670862678a33b3"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsnthdev%2Fitivrutaha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsnthdev%2Fitivrutaha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsnthdev%2Fitivrutaha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsnthdev%2Fitivrutaha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vsnthdev","download_url":"https://codeload.github.com/vsnthdev/itivrutaha/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248157406,"owners_count":21057005,"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":["bun","cli","javascript","library","logger","logging","nodejs"],"created_at":"2024-11-14T02:19:27.366Z","updated_at":"2025-04-10T04:33:13.129Z","avatar_url":"https://github.com/vsnthdev.png","language":"TypeScript","readme":"\u003ch5 align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/vsnthdev/itivrutaha/blob/designs/header.png?raw=true\" alt=\"itivrutaha\"\u003e\n\u003c/h5\u003e\n\u003cp align=\"center\"\u003e\u003cstrong\u003e( इतिवृत्तः ) — An 👌 easy-to-use, 🛠️ configurable, Bun-first ⚡ console logger.\u003c/strong\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca target=\"_blank\" rel=\"noopener\" href=\"https://www.npmjs.com/package/itivrutaha\"\u003e\n        \u003cimg src=\"https://img.shields.io/npm/v/itivrutaha.svg?style=flat-square\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u003ca target=\"_blank\" rel=\"noopener\" href=\"https://www.npmjs.com/package/itivrutaha?activeTab=versions\"\u003e\n        \u003cimg src=\"https://img.shields.io/npm/dm/itivrutaha.svg?style=flat-square\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/vsnthdev/itivrutaha/issues\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/issues/vsnthdev/itivrutaha.svg?style=flat-square\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/vsnthdev/itivrutaha/commits/main\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/last-commit/vsnthdev/itivrutaha.svg?style=flat-square\"\n            alt=\"\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n**itivrutaha** is my first ever JavaScript *(initially)* project. It is a Bun-first *(developed, tested with [Bun](https://bun.sh) but also works in [Node](https://nodejs.org))* console logging module to be used in CLIs, GUI desktop apps \u0026 web servers.\n\n\u003e Tweet me \u003ca target=\"_blank\" rel=\"noopener\" href=\"https://vas.cx/twitter\"\u003e@vsnthdev\u003c/a\u003e, I would love to know your opinion/experience on this project 😍\n\n## 🚀 Migrating from v2.x\n\nVersion 3 is a complete rewrite with several features removed, trimmed down and optimized, while modernizing the codebase and adding Bun.js support.\n\nThe `v2.x.x` versions can be found in the [v2](https://github.com/vsnthdev/itivrutaha/tree/v2) branch containing the older version of `itivrutaha`.\n\n### ⚠️ Major changes\n\n1. Luxon has been replaced in favor of [date-format](https://www.npmjs.com/package/date-format) which is more lightweight.\n2. Removed automatic logs when app starts, and how long it ran when the app exists. (An additional utility will be shipped in a later version.)\n3. The `verboseIdentifer` and `quietIdentifier` config option has been removed.\n4. `v3` no longer uses TypeScript classes, favors functional approach instead.\n5. Multiple scopes (previously contexts) are now support by single instance of `itivrutaha` unlike previous.\n6. File logging was completely removed.\n7. The `:message` variable has been replaced by `:msg`.\n8. Following variables are no longer supported `:node_path`, `:script_path`, `:node_version`, `:v8_version`, `:filename`, `:openssl_version`, `:electron_version`. These will be added again on request basis.\n\n## ⚡️ Features\n\n1. Easy to customize according to your needs\n2. Flexible theming support with [chalk](https://www.npmjs.com/package/chalk)\n3. Different log levels (ex. silent, verbose etc) *(Planned)*\n4. Ability to log without any ANSI characters *(Planned)*\n5. Support for uppercase message types (ex. INFO instead of info) *(Planned)*\n\n## 💿 Installation\n\n```bash\nbun i itivrutaha\nnpm i itivrutaha # if you're using Node.js\n```\n\n## 🚴‍♂️ Quick Start\nAfter `itivrutaha` has been installed, you start using it by the following way 👇\n\n```typescript\nimport { itivrutaha, defaultConfig } from 'itivrutaha'\n\nconst log = itivrutaha(defaultConfig)\n\n// errors can be given directly, logs nicely\nlog.error(new Error('Ouch!'))\n\n// additional data can also be given for extra context\nlog.note('Point to be noted', { someData: 'very useful' })\n\n// entire thing can also be an object\nlog.okay({\n    msg: 'Not an info message'\n})\n\n// a scope can be attached to easily identify\n// which part of the application this log came from\nlog.success('Makes users happy', {}, 'web')\n\n// entire thing can also be an object\nlog.info({\n    msg: 'Nice to know something is happening',\n    scope: 'web',\n    extra: 'data',\n    maybeAnError: new Error('Something broke') // will be printed with trace\n})\n\n// supports emoji, colors and theming\nlog.verbose(\"Always makes developer's life easy 😀\")\n```\n\n## 🛠 Building\n\n* `bun install` — Installs required dependencies.\n* `bun run dev` — Watches for changes \u0026 runs TypeScript compiler.\n* `bun run build` — Freshly compiles TypeScript code.\n* `npm run docs` — Freshly builds by reading code and templates.\n\nℹ️ **Note:** You can run `bun run examples/index.ts` to test `itivrutaha` with the latest code.\n\n## 📰 License\n\u003e The **itivrutaha** project is released under the [MIT license](https://github.com/vasanthdeveloper/itivrutaha/blob/main/LICENSE.md).\n\u003chr\u003e\n\n\u003e [vsnth.dev](https://vsnth.dev) \u0026nbsp;\u0026middot;\u0026nbsp;\n\u003e YouTube [@vsnthdev](https://vas.cx/videos) \u0026nbsp;\u0026middot;\u0026nbsp;\n\u003e Twitter [@vsnthdev](https://vas.cx/@vsnthdev) \u0026nbsp;\u0026middot;\u0026nbsp;\n\u003e Discord [Vasanth Developer](https://vas.cx/@discord)","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsnthdev%2Fitivrutaha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvsnthdev%2Fitivrutaha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsnthdev%2Fitivrutaha/lists"}