-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #5 from gbh-tech/docs-DSO-00-update-readme
docs: (DSO-00) Update readme file
- Loading branch information
Showing
1 changed file
with
51 additions
and
17 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,38 +1,72 @@ | ||
<!-- omit in toc --> | ||
# Werf Env File (.env) Generator | ||
# Dot Env (.env) Generator | ||
|
||
<!-- omit in toc --> | ||
## Contents | ||
|
||
- [Summary](#summary) | ||
- [Install](#install) | ||
- [Run](#run) | ||
- [Compile](#compile) | ||
- [π Description](#-description) | ||
- [Features](#features) | ||
- [π’ Installation](#-installation) | ||
- [π§ Usage](#-usage) | ||
- [Commands](#commands) | ||
- [Examples](#examples) | ||
- [π€ Contributing](#-contributing) | ||
- [π License](#-license) | ||
|
||
## Summary | ||
## π Description | ||
|
||
This is a simple tool that help us generate a .env based on the render of werf. | ||
Dot Env Generator CLI is a command-line tool designed to generate .env files using various providers, including Werf and 1Password. | ||
|
||
## Install | ||
### Features | ||
|
||
To install dependencies: | ||
- **Create .env with Werf:** Generate environment files based on configurations managed by Werf. | ||
- **Create .env with 1Password:** Securely generate environment files using secrets stored in 1Password. | ||
|
||
## π’ Installation | ||
|
||
To install Dot Env Generator CLI from the source, follow these steps: | ||
|
||
```bash | ||
bun install | ||
curl -s -L https://github.com/gbh-tech/dot-env-generator/releases/download/v0.3.0/dot-env-generator-darwin-x64.tar.gz | tar xz | ||
chmod +x dot-env-generator | ||
sudo mv dot-env-generator /usr/local/bin | ||
``` | ||
|
||
## Run | ||
## π§ Usage | ||
|
||
Once installed, you can use the dot-env-generator command to generate .env files based on Werf or 1Password. | ||
|
||
### Commands | ||
|
||
werf: Generate a .env file using Werf configurations. | ||
1pass: Generate a .env file using 1Password secrets. | ||
help: Display help information about any command. | ||
|
||
### Examples | ||
|
||
To run: | ||
To generate a .env file using Werf: | ||
|
||
```bash | ||
./cli.ts --environment 'stage' --secrets | ||
./dot-env-generator werf -e stage -o .env | ||
``` | ||
|
||
## Compile | ||
|
||
To compile the project: | ||
To generate a .env file using 1Password: | ||
|
||
```bash | ||
bun build ./cli.ts --compile --outfile werf-env-generator | ||
./dot-env-generator op -v vault-id -i item-id -o .env | ||
``` | ||
|
||
## π€ Contributing | ||
|
||
Contributions are welcome! Please follow these steps to contribute: | ||
|
||
1. Fork the repository. | ||
2. Create a new branch (git checkout -b feature-branch). | ||
3. Make your changes. | ||
4. Commit your changes (git commit -m 'Add new feature'). | ||
5. Push to the branch (git push origin feature-branch). | ||
6. Open a Pull Request. | ||
|
||
## π License | ||
|
||
This project is licensed under the MIT License. See the LICENSE file for details. |