{"id":13507650,"url":"https://github.com/bitwalker/conform","last_synced_at":"2025-05-15T23:08:47.101Z","repository":{"id":16897745,"uuid":"19658570","full_name":"bitwalker/conform","owner":"bitwalker","description":"Easy, powerful, and extendable configuration tooling for releases.","archived":false,"fork":false,"pushed_at":"2019-11-20T10:54:28.000Z","size":59946,"stargazers_count":377,"open_issues_count":15,"forks_count":67,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-08T10:34:46.985Z","etag":null,"topics":["configuration","configuration-management","elixir"],"latest_commit_sha":null,"homepage":"","language":"Elixir","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/bitwalker.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}},"created_at":"2014-05-11T04:38:28.000Z","updated_at":"2025-03-23T15:49:34.000Z","dependencies_parsed_at":"2022-07-08T06:50:29.072Z","dependency_job_id":null,"html_url":"https://github.com/bitwalker/conform","commit_stats":null,"previous_names":[],"tags_count":70,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitwalker%2Fconform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitwalker%2Fconform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitwalker%2Fconform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitwalker%2Fconform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitwalker","download_url":"https://codeload.github.com/bitwalker/conform/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254436949,"owners_count":22070947,"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":["configuration","configuration-management","elixir"],"created_at":"2024-08-01T02:00:37.416Z","updated_at":"2025-05-15T23:08:41.312Z","avatar_url":"https://github.com/bitwalker.png","language":"Elixir","readme":"# Conform\n\n[![Master](https://travis-ci.org/bitwalker/conform.svg?branch=master)](https://travis-ci.org/bitwalker/conform)\n[![Hex.pm Version](http://img.shields.io/hexpm/v/conform.svg?style=flat)](https://hex.pm/packages/conform)\n\nSee the full documentation [here](https://hexdocs.pm/conform).\n\nThe definition of conform is \"Adapt or conform oneself to new or different conditions\". As this library is used to adapt your application to its deployed environment, I think it's rather fitting. It's also a play on the word configuration, and the fact that Conform uses an init-style configuration, maintained in a `.conf` file.\n\n# Deprecation Notice\n\n**IMPORTANT: I am discontinuing maintenance of this project moving forward, in favor of a replacement based\non TOML, found [here](https://github.com/bitwalker/toml-elixir). It is has a formal specification and supports\nmuch richer ways of expressing complex data (maps and lists), and supports several Elixir data types out of\nthe box. The `toml-elixir` library also provides a simple transformation mechnanism for extending the basic set\nof datatypes with your own (including structs and records). Everything you could accomplish with Conform is doable\nwith `toml-elixir`, and in a cleaner, easier to maintain format. In addition, it has full support for Distillery 2.0's\nconfig provider framework, allowing you to natively configure your Elixir releases with TOML config files**\n\nIf anyone is interested in taking over maintainership of this library, please reach out to me here via issue, or\nby email, and I'll be glad to discuss the transition with you.\n\n--------\n\n## Features\n\nIt provides the following features:\n\n- An easy-to-use configuration file to end-users and/or system administrators.\n- Post-processing of simplified configuration options to more complex forms required by your application, \n  without pushing that complexity on the user.\n- Richly-typed configuration options, such as IP addresses, URIs, etc., with the ability to define your own types.\n- Automatic validation of end-user configuration against a schema\n- Keep documentation of configuration options synced up automatically\n- Hidden configuration options: hide advanced options from end-users, but leave them available for power users or developers\n- Allow fetching information dynamically when the configuration is evaluated.\n- Can be used with releases\n\n## Rationale\n\nConform was designed for Elixir applications which are deployed via releases built with `exrm` or `distillery`. It was created in order\nto resolve some painful issues with the configuration mechanisms provided out of the box by both Erlang and Elixir.\n\nElixir offers a convenient configuration mechanism via `config/config.exs`, but it has downsides:\n\n- To change config settings, it requires you to recompile your app to regenerate the app.config/sys.config files used by the VM. Alternatively you can modify the sys.config file directly during deployment, using Erlang terms. Neither of these things are ops-friendly, or necessarily accessible to sysadmins who may not understand Elixir or Erlang semantics.\n- You can put comments in `config/config.exs`, but once transformed to app.config/sys.config, those comments are lost, leaving sysadmins lost when trying to understand what configuration values are allowed and what they do.\n- There is no config validation\n- You can't offer a nice interface for configuration to your apps users via something akin to conform's translations. They have to know how to work in Elixir terms, which is pleasant enough for a dev, but not so much for someone unfamiliar with programming.\n\nConform is intended to fix these problems in the following way:\n\n- It uses an init-style configuration, which should be very familiar to any sysadmin.\n- It is intended to be used during the release process, once your app has been deployed.\n- Conform works by taking the schema, the .conf file, and `config.exs` if it is being used, and combines them into the `sys.config` file used by the Erlang VM. However, unlike `config.exs`, you can bring the .conf into production with you, and use it for configuration instead of `sys.config`. This means that the docs provided in your schema file are available to the users configuring your application in production. The .conf is validated when it is parsed as well, so your users will get immediate feedback if they've provided invalid config settings.\n\nI'm glad to hear from anyone using this on what problems they are having, if any, and any ideas you may have. Feel free to open issues on the tracker or come find me in `#elixir-lang` on freenode.\n\n## License\n\nThe .conf parser in `conform_parse.peg` is licensed under Apache 2.0, per Basho. \n\nThe rest of this project is licensed under the MIT license. Use as you see fit.\n","funding_links":[],"categories":["Configuration"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitwalker%2Fconform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitwalker%2Fconform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitwalker%2Fconform/lists"}