Skip to content

Commit

Permalink
improve readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Alexander Gaal committed Aug 10, 2022
1 parent 43e2d2c commit 0773a46
Show file tree
Hide file tree
Showing 6 changed files with 14 additions and 26 deletions.
40 changes: 14 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,44 +21,32 @@ composer require gipfel-dev/alias

After installing Alias CLI we recommend to call the setup command once for automatically creation of `aliases.json`.

```bash
./vendor/bin/alias setup
```
<img src="./docs/images/setup-example.png" width="400px"/>

## Usage
### Summary
To get an overview of all available commands you can call alias without any parameters.
```bash
./vendor/bin/alias
```

<img src="./docs/images/summary-example.png" width="400px"/>

### Execute an alias
After defining your aliases in `aliases.json` or `aliases.dev.json` you can call
```bash
./vendor/bin/alias execute
```

<img src="./docs/images/execute-example.png" width="400px"/>

to get an overview of all available aliases. You can also call an alias directly:

```bash
./vendor/bin/alias execute {alias}
```
<img src="./docs/images/execute-with-alias-example.png" width="400px"/>

## aliases.json
At the moment our package looks for `aliases.dev.json` and if not exists for `aliases.json`. Run `./vendor/bin/alias setup` for automatically creating a `aliases.json` file. Please be aware that your values must be executable by your terminal.

### Allowed schema
```json
{
"about": "echo 'This is allowed.'",

"update": [
"echo 'This is also allowed'",
"composer update",
"npm update"
]
}
```
At the moment our packages scans your root directory of your project for following files
- `aliases.dev.json`
- `aliases.json`

Please be aware that your values must be executable by your terminal.

### `aliases.json` example
<img src="./docs/images/aliases-example.png" width="400px"/>

## Support the development
**Do you like this project? Support it by donating**
Expand Down
Binary file added docs/images/aliases-example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/execute-example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/execute-with-alias-example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/setup-example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/summary-example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 0773a46

Please sign in to comment.