A Modern And Secure CLI Tool For Managing Environment Variables
About • Profiles • Installation • Usage • Contributing • License
To see the GPG encryption demo go here
About
envio is an open source CLI tool that helps make managing environment variables a breeze. With envio, users can create encrypted profiles that contain a collection of environment variables associated with a specific project or use case. envio ensures security and simplifies the development process by allowing users to easily switch between profiles as needed and load them in their current terminal session for immediate use.
Some key features of envio include:
Encryptedprofiles throughpassphraseorGPGencryption- Load profiles into your
terminal sessions Persistentenvironment variables that are available infuture sessionsRunprograms with your profilesImportingprofiles from a fileDownloadingprofiles and then importing themExportingprofiles to a file
Profiles
In envio, a profile is a collection of environment variables that are associated with a specific project, application, or use case. Users can create multiple profiles, each with their own set of environment variables, and easily switch between them as needed.
For example, a developer might create a profile for a web development project that includes environment variables for the database connection, API keys, and other project-specific settings. They could then switch to a different profile for a mobile app project that requires a different set of environment variables.
The benefit of using profiles is that users can easily manage and switch between different sets of environment variables without having to manually set and unset them every time they switch tasks. Additionally, in envio, profiles are encrypted, so users can rest assured that their sensitive environment variables are secure and require a key to access them.
Installation
You can install envio through a few methods
Releases
You can head over to the releases page and download the official envio binaries from there for your target operating system. Windows MSI installers are also available
Cargo Repository
You can install envio through the Cargo repository using the following command:
$ cargo install envio
Source
Go here to see how
More methods of installation will be added in the future!
Usage
Go here to see how to use the tool
Development
In addition to the command-line tool, envio can also be used as a library in Rust programs to manage environment variables. To use envio in your program, add it as a dependency in your Cargo.toml file:
Please note that the envio library is not stable right now and can be subjected to many changes!
[dependencies]
envio = "0.5.0"
Then, in your Rust code, you can use the envio crate to read and write environment variables Here's a simple example:
// In this example we get the profile passed as an argument to the program and then print the environment variables in that profile fn main() { let args: Vec<String> = std::env::args().collect(); if args.len() != 3 { println!("Usage:); return; } let profile_name = args[1].to_string(); let key = args[2].to_string(); // All profiles have a key that is used to encrypt the environment variables, this ensures that the environment variables are secure // We use the age encryption type here // If the profile was encrypted with a different encryption type you can use the encryption type that was used to encrypt the profile // For example if the profile was encrypted with the GPG encryption type you would use the following line instead: // let encryption_type = envio::crypto::create_encryption_type(key, "gpg"); -- Over here key would be the fingerprint of the GPG key used to encrypt the profile let encryption_type = envio::crypto::create_encryption_type(key, "age"); // print the environment variables in that profile for (env_var, value) in &envio::get_profile(profile_name, encryption_type) .unwrap() .envs { println!("{}: {}", env_var, value); } } "
For more examples check out the examples directory
Currently, envio is only available as a Rust library
Contributors
 Vojtch |
 Erjan Kalybek |
Contributing
Contributions to envio are always welcome! Please see the Contributing Guidelines for more information.
License
This project is licensed under the MIT License and the Apache License
2 Jan 4, 2022
9 Dec 16, 2022
4 Dec 11, 2023
1 Apr 5, 2022
16 Feb 20, 2023
7 May 1, 2024
6 Dec 15, 2022
4 Oct 24, 2022
5 Nov 30, 2022
13 Oct 31, 2022
7 Aug 14, 2022
7 Nov 20, 2022
3 Jul 21, 2023
5 Aug 23, 2024
4 Aug 7, 2023
12 Nov 9, 2023
3 Oct 30, 2022
8 May 10, 2022
14 Dec 2, 2022
