{"id":13800973,"url":"https://github.com/outr/scribe","last_synced_at":"2025-05-14T21:05:45.430Z","repository":{"id":3658438,"uuid":"50439358","full_name":"outr/scribe","owner":"outr","description":"The fastest logging library in the world. Built from scratch in Scala and programmatically configurable.","archived":false,"fork":false,"pushed_at":"2025-04-10T00:19:42.000Z","size":2813,"stargazers_count":527,"open_issues_count":17,"forks_count":43,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-13T17:46:46.816Z","etag":null,"topics":["logback","logging","logging-framework","logging-library","scala","scribe","slf4j"],"latest_commit_sha":null,"homepage":"","language":"Scala","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/outr.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-01-26T15:49:14.000Z","updated_at":"2025-04-04T15:04:16.000Z","dependencies_parsed_at":"2023-12-05T16:28:04.153Z","dependency_job_id":"830f698c-618e-4534-bb94-b2fa7305a3a4","html_url":"https://github.com/outr/scribe","commit_stats":{"total_commits":917,"total_committers":20,"mean_commits":45.85,"dds":0.6150490730643403,"last_synced_commit":"d364cfd2c952f17f5201e88c21f790b4cfb822af"},"previous_names":[],"tags_count":136,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outr%2Fscribe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outr%2Fscribe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outr%2Fscribe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/outr%2Fscribe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/outr","download_url":"https://codeload.github.com/outr/scribe/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254227611,"owners_count":22035669,"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":["logback","logging","logging-framework","logging-library","scala","scribe","slf4j"],"created_at":"2024-08-04T00:01:18.153Z","updated_at":"2025-05-14T21:05:45.391Z","avatar_url":"https://github.com/outr.png","language":"Scala","readme":"# scribe\n\n[![CI](https://github.com/outr/scribe/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/outr/scribe/actions/workflows/ci.yml)\n[![Codacy Grade](https://app.codacy.com/project/badge/Grade/f333f6b110974985b2d1dbea39665e9e)](https://www.codacy.com/gh/outr/scribe/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=outr/scribe\u0026amp;utm_campaign=Badge_Grade)\n[![Codacy Coverage](https://app.codacy.com/project/badge/Coverage/f333f6b110974985b2d1dbea39665e9e)](https://www.codacy.com/gh/outr/scribe/dashboard?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=outr/scribe\u0026utm_campaign=Badge_Coverage)\n[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/outr/scribe)\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.outr/scribe_2.13/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.outr/scribe_2.13)\n[![Latest version](https://index.scala-lang.org/outr/scribe/scribe/latest.svg)](https://index.scala-lang.org/outr/scribe)\n[![Javadocs](https://javadoc.io/badge/com.outr/scribe_2.13.svg)](https://javadoc.io/doc/com.outr/scribe_2.13)\n\nScribe is a completely different way of thinking about logging. Instead of wrapping around existing logging frameworks\nand bearing their performance and design flaws, Scribe is built from the ground up to provide fast and effective logging\nin Scala, Scala.js, and Scala Native without the need of configuration files or additional dependencies. All management\nof logging can be handled programmatically (of course, classic logging configuration can be utilized as well if desired)\nin Scala itself, giving the developer the freedom to use whatever configuration framework, if any, they should choose to\nuse.\n\n## Availability\n\nScribe is available on the JVM, Scala.js, and ScalaNative with cross-compiling for Scala 2.12, 2.13, and 3\n\n## Quick Start\n\nFor people that want to skip the explanations and see it action, this is the place to start!\n\n### Dependency Configuration\n\n```scala\nlibraryDependencies += \"com.outr\" %% \"scribe\" % \"3.16.1\"\n```\n\nFor Cross-Platform projects (JVM, JS, and/or Native):\n\n```scala\nlibraryDependencies += \"com.outr\" %%% \"scribe\" % \"3.16.1\"\n```\n\nOr, if you want interoperability with SLF4J (to allow better interoperability with existing libraries using other loggers):\n\n```scala\nlibraryDependencies += \"com.outr\" %% \"scribe-slf4j\" % \"3.16.1\"\n```\n\n### Usage\n\n```scala\nscribe.info(\"Yes, it's that simple!\")\n```\n\n### SBT Tip\nUsing the default logger in Scribe supports auto-line wrapping, but in SBT, the `[info]` prefixes cause that to get\nmessed up. It's recommended to set:\n```sbt\noutputStrategy := Some(StdoutOutput)\n```\nThis will disable the `[info]` and `[error]` prefixes so logging looks correct when running your application within SBT.\n\n## Why Another Logging Framework\n\nYes, we know there are too many Java logging frameworks to count, and a large number of decent logging frameworks in\nScala, so why did we write yet another logging framework?  Nearly every Scala logging framework is mostly just a wrapper\naround Java logging frameworks (usually SLF4J, Log4J, or Logback). This comes with a few problems:\n\n 1. No support for Scala.js\n 2. No support for Scala Native\n 3. Performance cost (Blog Post: https://matthicks.com/2018/02/06/scribe-2-0-fastest-jvm-logger-in-the-world/)\n 4. Additional dependencies\n 5. Substantial cost logging method and line numbers\n 6. Lack of programmatic configuration support\n\nA few of the main features that Scribe offers ([for a complete list](https://github.com/outr/scribe/wiki/Features)):\n\n 1. Performance is a critical consideration. We leverage Macros to handle optimization of everything possible at\ncompile-time to avoid logging slowing down your production application. As far as we are aware, Scribe is the fastest\nlogging framework on the JVM.\n 2. Programmatic configuration. No need to be bound to configuration files to configure your logging. This means you can\nrely on any configuration framework or you can configure real-time changes to your logging in your production environment.\nThis particularly comes in handy if you need to enable debug logging on something going wrong in production. No need to\nrestart your server, simply provide a mechanism to modify the logging configuration in real-time.\n 3. Clean logging. Macros allow us to introduce logging into a class via an import instead of a mix-in or unnecessary\nsetup code.\n 4. Zero cost class, method, and line number logging built-in. Never worry about your logger working up the stack to figure\nout the position of the logging statement at runtime. With Macros we determine that information at compile-time to avoid\nany runtime cost.\n 5. Asynchronous logging support. Scribe's logger is very fast, but if real-time performance is critical, the\nasynchronous logging support completely removes logging impact from your application's thread impact.\n\n## Documentation\n[Check out the wiki for complete documentation](https://github.com/outr/scribe/wiki)\n\n## Community\nThe best way to receive immediate feedback for any questions is via our [Gitter channel](https://gitter.im/outr/scribe)\n\n## Acknowledgements\nYourKit supports open source projects with its full-featured Java Profiler.\nYourKit, LLC is the creator of [YourKit Java Profiler](https://www.yourkit.com/java/profiler/)\nand [YourKit .NET Profiler](https://www.yourkit.com/.net/profiler/),\ninnovative and intelligent tools for profiling Java and .NET applications.\n","funding_links":[],"categories":["Table of Contents","Extensions","日志库","Logging"],"sub_categories":["Extensions"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foutr%2Fscribe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foutr%2Fscribe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foutr%2Fscribe/lists"}