{"id":13640447,"url":"https://github.com/zio/zio-config","last_synced_at":"2025-05-15T08:05:39.863Z","repository":{"id":38422126,"uuid":"210273454","full_name":"zio/zio-config","owner":"zio","description":"Easily use and document any config from anywhere in ZIO apps","archived":false,"fork":false,"pushed_at":"2025-03-15T16:45:08.000Z","size":2301,"stargazers_count":238,"open_issues_count":117,"forks_count":116,"subscribers_count":13,"default_branch":"series/4.x","last_synced_at":"2025-04-07T20:05:41.275Z","etag":null,"topics":["config","scala","zio"],"latest_commit_sha":null,"homepage":"https://zio.dev/zio-config","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-23T05:43:56.000Z","updated_at":"2025-03-21T19:21:55.000Z","dependencies_parsed_at":"2023-10-15T02:14:25.743Z","dependency_job_id":"47e43973-adcc-4c25-a252-e341dd94e443","html_url":"https://github.com/zio/zio-config","commit_stats":{"total_commits":580,"total_committers":69,"mean_commits":8.405797101449275,"dds":0.6655172413793103,"last_synced_commit":"b832b8be2e212b7f9a496c3095a7c67f0a19a54b"},"previous_names":[],"tags_count":110,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zio","download_url":"https://codeload.github.com/zio/zio-config/tar.gz/refs/heads/series/4.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248976277,"owners_count":21192364,"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":["config","scala","zio"],"created_at":"2024-08-02T01:01:11.241Z","updated_at":"2025-04-14T23:23:48.808Z","avatar_url":"https://github.com/zio.png","language":"Scala","funding_links":[],"categories":["Official ZIO Libraries"],"sub_categories":[],"readme":"[//]: # (This file was autogenerated using `zio-sbt-website` plugin via `sbt generateReadme` command.)\n[//]: # (So please do not edit it manually. Instead, change \"docs/index.md\" file or sbt setting keys)\n[//]: # (e.g. \"readmeDocumentation\" and \"readmeSupport\".)\n\n# ZIO Config\n\n# ZIO Config\n\n[ZIO Config](https://zio.dev/zio-config/) is a ZIO-based library and act as an extension to core library ZIO's `Config` language.\n\n\n[![Production Ready](https://img.shields.io/badge/Project%20Stage-Production%20Ready-brightgreen.svg)](https://github.com/zio/zio/wiki/Project-Stages) ![CI Badge](https://github.com/zio/zio-config/workflows/CI/badge.svg) [![Sonatype Releases](https://img.shields.io/nexus/r/https/oss.sonatype.org/dev.zio/zio-config_2.13.svg?label=Sonatype%20Release)](https://oss.sonatype.org/content/repositories/releases/dev/zio/zio-config_2.13/) [![Sonatype Snapshots](https://img.shields.io/nexus/s/https/oss.sonatype.org/dev.zio/zio-config_2.13.svg?label=Sonatype%20Snapshot)](https://oss.sonatype.org/content/repositories/snapshots/dev/zio/zio-config_2.13/) [![javadoc](https://javadoc.io/badge2/dev.zio/zio-config-docs_2.13/javadoc.svg)](https://javadoc.io/doc/dev.zio/zio-config-docs_2.13) [![ZIO Config](https://img.shields.io/github/stars/zio/zio-config?style=social)](https://github.com/zio/zio-config)\n\nLet's enumerate some key features of this library:\n\n- **Support for Various Sources** — It can read flat or nested configurations. Thanks to `IndexedFlat`.\n- **Automatic Document Generation** — It can auto-generate documentation of configurations.\n- **Automatic Derivation** — It has built-in support for automatic derivation of readers and writers for case classes and sealed traits.\n- **Type-level Constraints and Automatic Validation** — because it supports _Refined_ types, we can write type-level predicates which constrain the set of values described for data types.\n- **Descriptive Errors** — It accumulates all errors and reports all of them to the user rather than failing fast.\n- **Integrations** — Integrations with a variety of libraries\n\n\nIf you are only interested in automatic derivation of configuration, find the details [here](https://zio.dev/zio-config/automatic-derivation-of-config)\n\n## Installation\n\nIn order to use this library, we need to add the following line in our `build.sbt` file:\n\n```scala\nlibraryDependencies += \"dev.zio\" %% \"zio-config\" % \"\u003cversion\u003e\" \n```\n\n# Quick Start\n\nLet's add these four lines to our `build.sbt` file as we are using these modules in our examples:\n\n```scala\nlibraryDependencies += \"dev.zio\" %% \"zio-config\"          % \"\u003cversion\u003e\"\nlibraryDependencies += \"dev.zio\" %% \"zio-config-magnolia\" % \"\u003cversion\u003e\"\nlibraryDependencies += \"dev.zio\" %% \"zio-config-typesafe\" % \"\u003cversion\u003e\"\nlibraryDependencies += \"dev.zio\" %% \"zio-config-refined\"  % \"\u003cversion\u003e\"\n```\n\nThere are many examples in [here](https://github.com/zio/zio-config/tree/master/examples/shared/src/main/scala/zio/config/examples)\n\n## Documentation\n\nLearn more on the [ZIO Config homepage](https://zio.dev/zio-config/)!\n\n## Contributing\n\nFor the general guidelines, see ZIO [contributor's guide](https://zio.dev/about/contributing).\n\n## Code of Conduct\n\nSee the [Code of Conduct](https://zio.dev/about/code-of-conduct)\n\n## Support\n\nCome chat with us on [![Badge-Discord]][Link-Discord].\n\n[Badge-Discord]: https://img.shields.io/discord/629491597070827530?logo=discord \"chat on discord\"\n[Link-Discord]: https://discord.gg/2ccFBr4 \"Discord\"\n\n## License\n\n[License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzio%2Fzio-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzio%2Fzio-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzio%2Fzio-config/lists"}