generated from delucca/template
-
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.
chore(docs): updates structure and docs
- Loading branch information
Daniel De Lucca
authored
Apr 17, 2021
1 parent
6f0d0f0
commit 425400d
Showing
16 changed files
with
35 additions
and
841 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
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,27 +1,46 @@ | ||
# Customizing your repository | ||
<p align="center"> | ||
<br> | ||
<img src="https://media.giphy.com/media/lPcghSeSxVeBl8qtt1/giphy.gif" alt="A scene from Rick and Morty where Morty's head is a planet that is vomiting rainbowns" title="Shell Functions header's GIF" /> | ||
<br> | ||
</p> | ||
<p align="center"> | ||
Helper functions to use in my custom shell scripts | ||
</p> | ||
|
||
After creating a new repository with this template, some files may require proper customization. To do so, please follow these steps: | ||
# Shell Functions | ||
|
||
## Prerequisites | ||
* [Why](#why) | ||
* [Quickstart](#quickstart) | ||
* [Usage](#usage) | ||
* [License](#license) | ||
|
||
* [gomplate][] | ||
* [tree][] | ||
## Why | ||
|
||
## Customization | ||
While coding shell scripts, there are plenty of standard tasks that I need to do. This repository contains modules that can be imported by other scripts. | ||
|
||
### Step 1: Define your variables | ||
|
||
You can do so by replacing the values inside the `customize.json` file | ||
|
||
### Step 2: Run the customization binary | ||
## Quickstart | ||
|
||
You can import a given script with the following line: | ||
```sh | ||
./customize | ||
<replace> | ||
``` | ||
|
||
### Step 3: Enjoy! | ||
This will add all helpers functions from that module to your shell script | ||
|
||
## Usage | ||
|
||
Each module has it's own usage and functions. Below, I've wrote an one-liner for each module, explaining their general purpose: | ||
|
||
* [Feedback][feedback-module]: Functions that give feedback for our user in the CLI, such as logs, spinners, and others | ||
* [Validation][validation-module]: Functions that validate date, throwing errors when they are not valid | ||
* [Authorization][authorization-module]: Functions that handle relevant authorization tasks | ||
|
||
## License | ||
|
||
Now, your repository is ready to go! | ||
This repository is distributed under the Apache 2.0 License. See [`LICENSE`][license] for more information. | ||
|
||
[gomplate]: https://docs.gomplate.ca/installing/ | ||
[tree]: https://linux.die.net/man/1/tree | ||
[contributing]: CONTRIBUTING.md | ||
[license]: LICENSE | ||
[feedback-module]: modules/feedback.sh | ||
[validation-module]: modules/validation.sh | ||
[authorization-module]: modules/authorization.sh |
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.