.env files. Written in Rust 🦀
Dotenv-linter can check / fix / compare .env files for problems that may cause the application to malfunction.
Available checks:
✅ Duplicated Key
✅ Ending Blank Line
✅ Extra Blank Line
✅ Incorrect delimiter
✅ Key without value
✅ Leading character
✅ Lowercase key
✅ Quote character
✅ Space character
✅ Trailing whitespace
✅ Unordered Key
The key features:
⚡️ Lightning-fast because it is written in Rust 🦀
💣 Can be used on any project regardless of the programming language 💥
🚀 Can be integrated with reviewdog and other CI services (including GitHub Actions and Super-Linter) 🔥
Articles about dotenv-linter: * [EN] [Dotenv-linter: looking after the environment for you](https://evrone.com/dotenv-linter?utmsource=github&utmcampaign=dotenv-linter) * [EN] [What's new in dotenv-linter v2.2.0?](https://evrone.com/dotenv-linter-v220?utmsource=github&utmcampaign=dotenv-linter) * [RU] [Dotenv-linter: линтер .env файлов](https://www.mgrachev.com/2020/04/20/dotenv-linter) * [RU] [Что нового в dotenv-linter v2.2.1?](https://evrone.ru/dotenv-linter-v220?utmsource=github&utmcampaign=dotenv-linter)
Dotenv-linter is created & supported by Evrone. What else we develop with Rust.
```shell script
$ curl -sSfL https://raw.githubusercontent.com/dotenv-linter/dotenv-linter/master/install.sh | sh -s
$ curl -sSfL https://git.io/JLbXn | sh -s
$ curl -sSfL https://git.io/JLbXn | sh -s -- -b usr/local/bin v2.0.0
$ wget -q -O - https://git.io/JLbXn | sh -s ```
You can find other installation methods here: https://dotenv-linter.github.io/#/installation
By default, dotenv-linter checks all .env files in the current directory:
```shell script $ dotenv-linter Checking .env .env:2 DuplicatedKey: The FOO key is duplicated .env:3 UnorderedKey: The BAR key should go before the FOO key
Checking .env.test .env.test:1 LeadingCharacter: Invalid leading character detected
Found 3 problems ```
It can also fix the found warnings with the fix command:
```shell $ dotenv-linter fix Fixing .env Original file was backed up to: ".env_1601378896"
.env:2 DuplicatedKey: The BAR key is duplicated .env:3 LowercaseKey: The foo key should be in uppercase
All warnings are fixed. Total: 2 ```
In addition, dotenv-linter can compare .env files with each other and output the difference between them:
shell
$ dotenv-linter compare .env .env.example
Comparing .env
Comparing .env.example
.env is missing keys: BAR
.env.example is missing keys: FOO
Other use cases you can find on the documentation site (https://dotenv-linter.github.io): * Check * Fix * Compare
dotenv-linter can also be used with CI services such as: GitHub Actions and Circle CI.
Benchmarking dotenv-linter/dotenv-linter and wemake-services/dotenv-linter has done using the hyperfine utility:
| Command | Mean [ms] | Min [ms] | Max [ms] | Relative |
|:---|---:|---:|---:|---:|
| dotenv-linter/dotenv-linter .env | 2.7 ± 0.4 | 2.0 | 4.3 | 1.00 |
| wemake-services/dotenv-linter .env | 162.6 ± 12.1 | 153.0 | 201.3 | 60.83 ± 10.20 |
Content of
.env file used for benchmarking
```dotenv SPACED=
KEY = VALUE
SECRET="my value"
SECRET=Already defined
kebab-case-name=1 snakecasename=2 ```
Dotenv-linter is not just a linter for .env files — it is also a contributor-friendly open-source project with the purpose of helping others learn Rust using a simple, but useful tool 😊
In addition to studying Rust, this project has another goal — to promote love for open-source, help you with the first steps in it and give an opportunity to contribute to the open-source project written in Rust ❤️
We act as a mentor within this project and help developers follow the path of a novice contributor from start to the top 🤗
If you've ever wanted to contribute to open source, now you have a great opportunity:
This project exists thanks to all the people who contribute. [Contribute].
Become a financial contributor and help us sustain our community.
