Getting started with Lets

If you already have lets.yaml then just go to that directory and run lets to see all available commands.

If you are starting from scratch and want to create a new lets.yaml, please, take a look at Creating new config section.

Config lookup#

lets will be looking for a config starting from where you call lets and up to the /.

For example:

cd /home/me
touch lets.yaml

mkdir ./project
cd ./project

lets # it will use lets.yaml at /home/me/lets.yaml

touch lets.yaml

lets # it will use lets.yaml right here (at /home/me/project/lets.yaml)

Creating new config#

Create lets.yaml file in your project directory
Add commands to lets.yaml config. Config reference

shell: /bin/sh

commands:
    echo:
      description: Echo text
      cmd: |
        echo "Hello"
    
    run:
      description: Run some command
      options: |
        Usage: lets run [--debug] [--level=<level>]
        
        Options:
          --debug, -d     Run with debug
          --level=<level> Log level
      cmd: |
        env

Run commands

lets echo # will print 
# Hello

lets run --debug --level=info # will print
# LETSOPT_DEBUG=true
# LETSOPT_LEVEL=info
# LETSCLI_DEBUG=--debug
# LETSCLI_LEVEL=--level info

Lets directory#

At first run lets will create .lets directory in the current directory.

lets uses .lets to store some specific data such as checksums, etc.

It's better to add .lets to your .gitignore end exclude it in your favorite ide.