Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anthonyaxenov/shell
[mirror] Multipurpose shell scripts and dotfiles
https://github.com/anthonyaxenov/shell
automation debian dotfiles dotfiles-linux install installation-script installation-scripts make makefile shell shell-scripts ubuntu
Last synced: 1 day ago
JSON representation
[mirror] Multipurpose shell scripts and dotfiles
- Host: GitHub
- URL: https://github.com/anthonyaxenov/shell
- Owner: anthonyaxenov
- License: wtfpl
- Created: 2022-10-06T10:33:29.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-12-25T16:50:10.000Z (13 days ago)
- Last Synced: 2024-12-25T17:27:17.805Z (13 days ago)
- Topics: automation, debian, dotfiles, dotfiles-linux, install, installation-script, installation-scripts, make, makefile, shell, shell-scripts, ubuntu
- Language: Shell
- Homepage: https://git.axenov.dev/anthony/shell
- Size: 2.33 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# My shell environment
`make`-ready bunch of scripts for easily (de)installation of different software and bunch of useful handy functions for custom scripting.
## Requirements
* Ubuntu >= 20.04 (not tested with version < 20)
* `bash`, `zsh` or other `sh`-compatible shell
* `make` (optional but recommended)
* `wget` (required for some scripts)
* `git` (required for some scripts)
If some dependecies are missed for some of these scripts it is enougth to run `./install/apt` in most cases, otherwise script will suggest (or even install) them.
## Usage
```shell
# with git
git clone [email protected]:anthony/my-env.git --depth=1 --single-branch
# without git
wget -qO - https://git.axenov.dev/anthony/my-env/archive/master.tar.gz | tar -zxf -
# get full list of `make` goals
cd my-env && make
```
## How to add my script?
1. Create a new shell script in `./install`, `./upgrade` or `./uninstall` directory.
At the beggining of a file you must write these two lines:
```shell
#!/bin/bash
##makedesc: Your description for Makefile
```
2. Make this script executable, e.g.:
```shell
sudo chmod a+x ./install/myscript
```
3. Test your script
4. Run `make self` to generate new `./Makefile`
## How to create a pack?
You can create new file inside `./packs` dir.
Syntax is same as classic makefile.
It is important to add a comment with short description:
```makefile
##mypack1: Pack description
mypack1: goal1 goal2 goalX ...
...
##mypackX: Pack description
mypackX: goalA goalB
@cp file1 file2
...
...
```
where:
* `mypack*` is the pack name of your choice
* `goal*` are script names in `./install`
## Useful links and sources used
* https://gist.github.com/anthonyaxenov/d53c4385b7d1466e0affeb56388b1005
* https://gist.github.com/anthonyaxenov/89c99e09ddb195985707e2b24a57257d
* ...and other my [gists](https://gist.github.com/anthonyaxenov/) with [SHELL] prefix
* https://github.com/nvie/gitflow/blob/develop/gitflow-common (BSD License)
* https://github.com/petervanderdoes/gitflow-avh/blob/develop/gitflow-common (FreeBSD License)
* https://github.com/vaniacer/bash_color/blob/master/color
* https://misc.flogisoft.com/bash/tip_colors_and_formatting
* https://www-users.york.ac.uk/~mijp1/teaching/2nd_year_Comp_Lab/guides/grep_awk_sed.pdf
* https://www.galago-project.org/specs/notification/
* https://laurvas.ru/bash-trap/
* https://stackoverflow.com/a/52674277
* https://rtfm.co.ua/bash-funkciya-getopts-ispolzuem-opcii-v-skriptax/
* https://gist.github.com/jacknlliu/7c51e0ee8b51881dc8fb2183c481992e
* https://gist.github.com/anthonyaxenov/d53c4385b7d1466e0affeb56388b1005
* https://github.com/nvie/gitflow/blob/develop/gitflow-common
* https://github.com/petervanderdoes/gitflow-avh/blob/develop/gitflow-common
* https://gitlab.com/kyb/autorsync/-/blob/master/
* https://lug.fh-swf.de/vim/vim-bash/StyleGuideShell.en.pdf
* https://www.thegeekstuff.com/2010/06/bash-array-tutorial/
* https://www.distributednetworks.com/linux-network-admin/module4/ephemeral-reserved-portNumbers.php
## License
[WTFPLv2](LICENSE) but other licences are also possible.