Skip to content

Commit

Permalink
Merge pull request #5 from gbh-tech/docs-DSO-00-update-readme
Browse files Browse the repository at this point in the history
docs: (DSO-00) Update readme file
  • Loading branch information
javiercm1410 authored Sep 4, 2024
2 parents 473a68c + 3801971 commit 5bf4252
Showing 1 changed file with 51 additions and 17 deletions.
68 changes: 51 additions & 17 deletions README.md
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.

0 comments on commit 5bf4252

Please sign in to comment.