├── .gitattributes
├── newsboat
├── coala
├── boxes
├── feh
├── typescript
├── curl
├── .tools
    ├── cheat-select-copy.sh
    ├── cheat-select.sh
    └── cheat.py
├── terminator
├── python-distribution
├── tlmgr
├── ansible
├── cocoapods
├── unix-archive
├── regex-recipies
├── vim-goyo
├── bash-tilde-expansion
├── gitlab-api
├── find
├── gradle
├── python-pipenv
├── bash-shortcuts
├── vim-spelling
├── pycharm
├── .hooks
    └── generate-mo.sh
├── clion
├── swift-cli
├── bpkg
├── python-virtualenvwrapper
├── .pre-commit-config.yaml
├── gpg
├── openapi-generator
├── bash-if
├── .github
    ├── README.md.mo
    ├── README.md
    └── LICENSE.md
├── gitlab-srv
├── linux
├── sysadmin
├── vim
├── jq
├── adb
├── apt
├── taskwarrior
├── git.yaml
├── vagrant
├── bash
├── markdown
├── git
├── pre-commit
├── bash-test
└── android-studio


/.gitattributes:
--------------------------------------------------------------------------------
1 | vagrant linguist-detectable=true linguist-language=Markdown
2 | 


--------------------------------------------------------------------------------
/newsboat:
--------------------------------------------------------------------------------
1 | #newsboat
2 | 
3 | # Feed format
4 | <url> [<tag1> <tag2> ...]
5 | 


--------------------------------------------------------------------------------
/coala:
--------------------------------------------------------------------------------
1 | # coala
2 | 
3 | ## Installation
4 | 
5 | `pip3 install coala coala-bears`
6 | 


--------------------------------------------------------------------------------
/boxes:
--------------------------------------------------------------------------------
1 | # boxes
2 | 
3 | # list all available box designs in the config file
4 | boxes -l
5 | 


--------------------------------------------------------------------------------
/feh:
--------------------------------------------------------------------------------
1 | <!-- vim: syntax=Markdown -->
2 | # Rotate the image 90 degrees (counter)clockwise
3 | <, >
4 | 


--------------------------------------------------------------------------------
/typescript:
--------------------------------------------------------------------------------
1 | # Typescript
2 | 
3 | # Getting started
4 | ```
5 | npm init
6 | npm install --save-dev typescript
7 | ```
8 | 


--------------------------------------------------------------------------------
/curl:
--------------------------------------------------------------------------------
1 | # curl
2 | 
3 | - Send urlencoded data `curl --data-urlencode "name=John Doe" http://example.com`
4 | 
5 | ## References
6 | 
7 | https://ec.haxx.se/
8 | 


--------------------------------------------------------------------------------
/.tools/cheat-select-copy.sh:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env bash
2 | 
3 | cheatsheet=$1
4 | 
5 | cat $cheatsheet | sed -n "s/\\$//pg" | pick | xclip -selection  clipboard -in
6 | 


--------------------------------------------------------------------------------
/terminator:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Horizontal split
 3 | Ctrl + Shift + E
 4 | 
 5 | # Vertical split
 6 | Ctrl + Shift + O
 7 | 
 8 | # Close terminal
 9 | Ctrl + Shift + W
10 | 


--------------------------------------------------------------------------------
/python-distribution:
--------------------------------------------------------------------------------
1 | <!-- vim: syntax=Markdown -->
2 | # Generate distribution archives
3 | python setup.py sdist bdist_wheel
4 | 
5 | # Upload the distribution archives
6 | twine upload dist/*
7 | 
8 | 


--------------------------------------------------------------------------------
/tlmgr:
--------------------------------------------------------------------------------
 1 | # tlmgr
 2 | 
 3 | Install a package
 4 | ```
 5 | tlmgr install <package>
 6 | ```
 7 | 
 8 | Search for a file in all packages
 9 | ```
10 | tlmgr search --global --file <file>
11 | ```
12 | 


--------------------------------------------------------------------------------
/ansible:
--------------------------------------------------------------------------------
 1 | # ansible
 2 | 
 3 | Execute a command on a host
 4 | ```bash
 5 | ansible <host> -m command -a "command to execute"
 6 | ```
 7 | 
 8 | View module documentation
 9 | ```bash
10 | ansible-doc <module>
11 | ```
12 | 


--------------------------------------------------------------------------------
/cocoapods:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # CocoaPods
 3 | 
 4 | Clear CocoaPods cache, re-download and re-install all pods
 5 | ```
 6 | rm -rf "${HOME}/Library/Caches/CocoaPods"
 7 | rm -rf "`pwd`/Pods/"
 8 | pod update
 9 | ```
10 | 


--------------------------------------------------------------------------------
/unix-archive:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | 
 3 | # Archiving Commands
 4 | 
 5 | ## List Content
 6 | 
 7 | List the content of the archive
 8 | ```
 9 | unzip -vl <archive>
10 | ```
11 | 
12 | ```
13 | zipinfo -m <archive>
14 | ```
15 | 
16 | ```
17 | gunzip -vl <archive>
18 | ```
19 | 


--------------------------------------------------------------------------------
/regex-recipies:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | 
 3 | # Match a markdown code block.
 4 | ```regex
 5 | ^(([ \t]*`{3,4})([^\n]*)([\s\S]+?)(^[ \t]*\2))
 6 | ```
 7 | 
 8 | # Match the include directive of the C/C++ pre-processor
 9 | ```regex
10 | ^\s*\#include\s+(["<][^">]+[">])
11 | ```
12 | 


--------------------------------------------------------------------------------
/vim-goyo:
--------------------------------------------------------------------------------
 1 | # vim goyo
 2 | 
 3 | # toggle Goyo with the specified dimension
 4 | `:Goyo [dimension]`
 5 | 
 6 | # the dimension follows this format
 7 | `<width>[(+|-)<xoffset>][x<height>[(+|-)<yoffset>]]`
 8 | 
 9 | # turn Goyo off
10 | `:Goyo!`
11 | 
12 | # configuration
13 | `g:goyo_width`
14 | `g:goyo_height`
15 | `g:goyo_linenr`
16 | 


--------------------------------------------------------------------------------
/bash-tilde-expansion:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Expands to home directory
 3 | ~
 4 | 
 5 | # Append home directory with the patch specified
 6 | ~/"path/to/another"
 7 | 
 8 | # Expand to the username's home directory
 9 | ~username
10 | 
11 | # Expand to current directory
12 | ~+
13 | 
14 | # Expand to previous working directory
15 | ~-
16 | 


--------------------------------------------------------------------------------
/.tools/cheat-select.sh:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env bash
 2 | 
 3 | cheatsheet=$1
 4 | 
 5 | command=$(cat $cheatsheet | sed -n "s/\\$//pg" | pick)
 6 | 
 7 | c="""
 8 | from fcntl import ioctl
 9 | from sys import stdin, argv
10 | from termios import TIOCSTI
11 | 
12 | [ioctl(stdin, TIOCSTI, c) for c in argv[1]]
13 | """
14 | 
15 | python -c "$c" "$command" 1> /dev/null 2>&1
16 | 


--------------------------------------------------------------------------------
/gitlab-api:
--------------------------------------------------------------------------------
1 | # gitlab api
2 | 
3 | # pull all projects visible to a user
4 | TOKEN="PASTE_YOUR_PRIVATE_TOKEN_HERE";
5 | JSON_KEY="ssh_url_to_repo";
6 | curl --header "PRIVATE-TOKEN: $TOKEN" http://gitlab.com/api/v3/projects/visible?per_page=100 | grep -o "\"$JSON_KEY\":[^ ,]\+" | awk -F ':' '{printf "ssh://"; for (i=2; i<NF; i++) printf $i "/"; print $NF}' | xargs -L1 git clone`
7 | 


--------------------------------------------------------------------------------
/find:
--------------------------------------------------------------------------------
 1 | # find
 2 | 
 3 | # find all directories that don't contain a specific subdirectory
 4 | find . -maxdepth 1 -type d -exec test ! -d "{}/<subdirectory>" \; -print
 5 | 
 6 | # exclude hidden files and directories from the results
 7 | find . -not -path '*/\.*'
 8 | 
 9 | # exclude hidden files and prune the search through hidden directories
10 | find . -type d -path '*/\.*' -prune -o -not -name '.*' -type f -print
11 | 


--------------------------------------------------------------------------------
/gradle:
--------------------------------------------------------------------------------
 1 | # gradle
 2 | 
 3 | List available tasks of a project
 4 | ```
 5 | gradle -q tasks [--all]
 6 | ```
 7 | 
 8 | Dependency insights of an Android project
 9 | ```
10 | gradlew :app:dependencyInsight --configuration [debug|release]CompileClasspath --dependency <dependency>
11 | # For a project with product flavours
12 | gradlew :app:dependencyInsight --configuration flavour[Debug|Release]CompileClasspath --dependency <dependency>
13 | ```
14 | 


--------------------------------------------------------------------------------
/python-pipenv:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Create a new virtual environment using python 3
 3 | pipenv --python 3
 4 | 
 5 | # Install a new package for the virtual environment (infereed from current directory)
 6 | pipenv install <package>
 7 | 
 8 | # Generate requirements.txt
 9 | pipenv lock --requirements > requirements.txt
10 | 
11 | # Generate developing requirements.txt
12 | pipenv lock --requirements --dev > requirements-dev.txt
13 | 
14 | 


--------------------------------------------------------------------------------
/bash-shortcuts:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Cuts text from the cursor until the end of the line
 3 | Control + K
 4 | 
 5 | # Paste text
 6 | Control + Y
 7 | 
 8 | # Paste into the terminal
 9 | Shift + Insert
10 | 
11 | # Move to the end of the line
12 | Control + E
13 | 
14 | # Move to the begin of the line
15 | Control + A
16 | 
17 | # Move to the next space
18 | Alt + F
19 | 
20 | # Move to the previous space
21 | Alt + B
22 | 
23 | # Delete previous word
24 | Alt + Backspace
25 | 


--------------------------------------------------------------------------------
/vim-spelling:
--------------------------------------------------------------------------------
 1 | # vim spelling
 2 | 
 3 | # enable spellchecking
 4 | `set spell!`
 5 | 
 6 | # navigate spelling errors
 7 | `]s` next error or warning
 8 | `[s` prev error or warning
 9 | `]S` next error (skip warning)
10 | `[S` prev error (skip warning)
11 | 
12 | # ask for a suggestion
13 | `z=`
14 | 
15 | # add and remove a word from the dictionary
16 | `zg` and `zug`
17 | 
18 | # mark and remove a word as misspelled
19 | `zw` and `zuw`
20 | 
21 | # change spellchecking language
22 | `set spelllang=es`
23 | 


--------------------------------------------------------------------------------
/pycharm:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # TODO https://www.jetbrains.com/help/pycharm/mastering-keyboard-shortcuts.html
 3 | # Open the documentation tool window
 4 | Ctrl + Q
 5 | 
 6 | # Show intention actions
 7 | Alt + Enter
 8 | - This can be used to add documentation to an existing function or method;
 9 | 
10 | # Open suggestion window
11 | Ctrl + Space
12 | 
13 | # Find action - search for commands and settings
14 | Ctrl + Shift + A
15 | 
16 | # Code inspection - check for errors and warnings
17 | Alt + Shift + I 
18 | 


--------------------------------------------------------------------------------
/.hooks/generate-mo.sh:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env bash
 2 | 
 3 | gitroot=$(git rev-parse --show-toplevel)
 4 | 
 5 | DISCLAIMER="<!-- DO NOT MODIFY THIS FILE, THIS FILE IS AUTO-GENERATED -->"
 6 | export DISCLAIMER
 7 | 
 8 | CHEAT_LISTING=$(cd "$gitroot" && find . -not -path "*/\.*" -maxdepth 1 -type f -exec basename {} \; | sort | awk 'NF{print "[" $0  "]" "(" $0 ");"}')
 9 | export CHEAT_LISTING
10 | 
11 | while (( "$#" )); do
12 | 	filename=$1
13 | 	output_filename=${filename%.mo}
14 | 	mo "$filename" > "$output_filename"
15 | 	shift
16 | done
17 | 


--------------------------------------------------------------------------------
/clion:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Multiline editing
 3 | 
 4 | ## Multiple editing cursor with mouse
 5 | Ctrl + Alt + Shift + Right Click
 6 | 
 7 | 
 8 | ## Multiple editing cursor spanning multiple lines
 9 | Ctrl + Ctrl (Hold) + Up|Down
10 | 
11 | ## Select next word occurancy
12 | (Windows/Linux) Alt + J
13 | (MacOSX) Alt + G
14 | ## Remove last occurency
15 | (Windows/Linux) Alt + Shift + J
16 | (MacOSX) Alt + Shift + G
17 | ## Select all occurancies
18 | (Windows/Linux) Alt + Ctrl + Shift + J
19 | (MaxOSX) Command + Alt + G
20 | 


--------------------------------------------------------------------------------
/swift-cli:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # swift cli
 3 | 
 4 | ## swift-package
 5 | 
 6 | Update the dependencies according to the restrictions inside `Package.swift` and update accordingly the 
 7 | file `Package.resolved`.
 8 | ```
 9 | swift package update
10 | ```
11 | 
12 | Resolve the dependencies declared inside `Package.resolved` when the file already exists or by taking into 
13 | account the restrictions inside `Package.swift`. In the last case the file `Package.resolved` will be 
14 | created.
15 | ```
16 | swift package resolve
17 | ```
18 | 


--------------------------------------------------------------------------------
/bpkg:
--------------------------------------------------------------------------------
 1 | # bpkg
 2 | > Lightweight bash package manager
 3 | 
 4 | # Up and running
 5 | ```bash
 6 | curl -Lo- "https://raw.githubusercontent.com/bpkg/bpkg/master/setup.sh" | bash
 7 | ```
 8 | 
 9 | # Local or global installation of packges
10 | ```bash
11 | bpkg install term  # locally installed from github.com/bpkg/term into ~/deps
12 | bpkg install -g term  # globally installed from github.com/bpkg/term into /usr/local/bin
13 | ```
14 | 
15 | # Specify a version
16 | ```bash
17 | bpkg install jwerle/suggest.sh@0.0.1 -g  # globally install from github.com/jwerle/suggest.sh
18 | ```
19 | 


--------------------------------------------------------------------------------
/python-virtualenvwrapper:
--------------------------------------------------------------------------------
 1 | # virtualenvwrapper
 2 | 
 3 | > A tool to work with virtual environments.
 4 | 
 5 | ## Work on a virtual environment.
 6 | ```bash
 7 | workon <name>
 8 | ```
 9 | 
10 | ## Stop working on a virtual environment.
11 | ```bash
12 | deactivate
13 | ```
14 | 
15 | ## List all virtual environments.
16 | ```bash
17 | # -l long mode
18 | # -b brief mode
19 | lsvirtualenv [-l|-b]
20 | ```
21 | 
22 | ## Destroy a virtual environment.
23 | ```bash
24 | rmvirtualenv <name>
25 | ```
26 | 
27 | ## Copy a virtual environment.
28 | ```bash
29 | cpvirtualenv <name>
30 | ```
31 | 


--------------------------------------------------------------------------------
/.pre-commit-config.yaml:
--------------------------------------------------------------------------------
 1 | # See https://pre-commit.com for more information
 2 | # See https://pre-commit.com/hooks.html for more hooks
 3 | repos:
 4 |   - repo: https://github.com/pre-commit/pre-commit-hooks
 5 |     rev: v1.2.1-1
 6 |     hooks:
 7 |       - id: trailing-whitespace
 8 |       - id: end-of-file-fixer
 9 | 
10 |   - repo: local
11 |     hooks:
12 |       - id: readme-generation
13 |         name: Generate README.md
14 |         description: This hook generate the README file for this repository.
15 |         language: script
16 |         files: '.*\.mo'
17 |         entry: ./.hooks/generate-mo.sh
18 | 


--------------------------------------------------------------------------------
/gpg:
--------------------------------------------------------------------------------
 1 | # gpg
 2 | 
 3 | Generate a key
 4 | $ gpg --expert --gen-key
 5 | 
 6 | Generate a revocation certificate and write it to a file
 7 | $ gpg --gen-revoke <key> > rev-certificate.asc
 8 | 
 9 | Edit a key
10 | $ gpg --edit-key <key>
11 | 
12 | Delete secret key
13 | $ gpg --delete-secret-key <key>
14 | 
15 | Export a backup of the secret keys
16 | $ gpg --export-secret-key <key> > secretkey-gpg.key
17 | 
18 | Import secret keys from a backup
19 | $ gpg --import secret-key-gpg.key
20 | 
21 | Export the public key
22 | $ gpg --armor --export <key> > public.asc
23 | 
24 | List public keys
25 | $ gpg -k
26 | 
27 | List private keys
28 | $ gpg -K
29 | 


--------------------------------------------------------------------------------
/openapi-generator:
--------------------------------------------------------------------------------
 1 | # openapi-generator
 2 | 
 3 | # jar installation
 4 | ```
 5 | wget http://central.maven.org/maven2/org/openapitools/openapi-generator-cli/4.0.2/openapi-generator-cli-4.0.2.jar -O openapi-generator-cli.jar
 6 | java -jar openapi-generator-cli.jar --help
 7 | ```
 8 | 
 9 | # launch script installation
10 | ```
11 | curl https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh > openapi-generator-cli
12 | chmod u+x openapi-generator-cli
13 | ```
14 | 
15 | # generate a client library
16 | ```
17 | java -jar openapi-generator-cli.jar generate -i openapi.json  -g bash -o bash
18 | ```
19 | 


--------------------------------------------------------------------------------
/.tools/cheat.py:
--------------------------------------------------------------------------------
 1 | from sys import stdin
 2 | from yaml import load, FullLoader
 3 | from pygments.lexers.shell import BashLexer
 4 | from pygments.formatters import TerminalFormatter
 5 | from pygments import highlight
 6 | 
 7 | 
 8 | def humanize(cheat):
 9 |     """
10 |     Renders a human readable cheat.
11 |     """
12 |     description = cheat["description"]
13 |     command = cheat["command"]
14 | 
15 |     print(description)
16 |     print()
17 |     print("\t" + highlight(command, BashLexer(), TerminalFormatter()))
18 |     print()
19 | 
20 | 
21 | if __name__ == "__main__":
22 |     list(map(humanize, load(stdin, Loader=FullLoader)["cheats"]))
23 | 


--------------------------------------------------------------------------------
/bash-if:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Syntax
 3 | 
 4 | ```
 5 | if <test>; then
 6 | 	<commands>
 7 | elif <test>; then
 8 | 	<commands>
 9 | else
10 | 	<commands>
11 | fi
12 | ```
13 | 
14 | The branch's condition *<test>* can be:
15 | 
16 | - a *command*, if it succeeds (return code is zero) then the *<test>* evaluates to true:
17 | 	- `test EXPRESSION`;
18 | 	- `[ EXPRESSION ]`: a synonym for *test*;
19 | 	- `(( EXPRESSION ))`: arithmetic expansion;
20 | - a combination of commands separated by control operators:
21 | 	- ! test EXPR1 && test EXPR2 || test EXPR3;
22 | - a bash's *keyword*:
23 | 	- `[[ EXPRESSION ]]`: *extended test expression*;
24 | 


--------------------------------------------------------------------------------
/.github/README.md.mo:
--------------------------------------------------------------------------------
 1 | {{DISCLAIMER}}
 2 | 
 3 | [license]: http://creativecommons.org/licenses/by-nc-sa/4.0/
 4 | [license-badge]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg?style=for-the-badge
 5 | 
 6 | # cheatsheet
 7 | 
 8 | [![License: Creative Commons by-nc-sa][license-badge]][license]
 9 | 
10 | {{CHEAT_LISTING}}
11 | 
12 | ## License
13 | 
14 | This work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][license].
15 | 
16 | ## Contribute
17 | 
18 | ### Rendering of cheatsheet on github
19 | 
20 | If you want your cheatsheet to be rendered by Github as a markdown file,
21 | without adding an extension, add this line on top `<!-- vim: syntax=Markdown
22 | -->`. According to `github-linguist`, it should be possible to do this with the
23 | `.gitattributes` but it doesn't seems to work at the moment.
24 | 


--------------------------------------------------------------------------------
/gitlab-srv:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # GitLab
 3 | 
 4 | ## Commands
 5 | 
 6 | | command                          | description                         |
 7 | |----------------------------------|-------------------------------------|
 8 | | gitlab-ctl status                | Check the status of GitLab services |
 9 | | gitlab-ctl restart               | Restart GitLab                      |
10 | | gitlab-rake gitlab:backup:create | Create a backup                     |
11 | 
12 | ## Backup
13 | 
14 | - Configuring cron to make daily backups:
15 |     1. edit the configuration file `/etc/gitlab/gitlab.rb` and change
16 |        `backup_keep_time` to limit the lifetime of backups;
17 |     2. reconfigure GitLab;
18 |     3. add a cron job as root user `crontab -e`:
19 |         ```
20 |         # CRON=1 teels the backup script to suppress all progress output if there are no errors
21 |         0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create CRON=1
22 |         ```
23 | 


--------------------------------------------------------------------------------
/linux:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # linux
 3 | 
 4 | ## Utilities
 5 | 
 6 | Remove password from a PDF file
 7 | ```
 8 | qpdf --password=YOURPASSWORD-HERE --decrypt input.pdf output.pdf
 9 | ```
10 | 
11 | ## Diff
12 | 
13 | List all files that differs between two directories, this will compare the content of the files
14 | ```
15 | diff --brief --recursive dir1/ dir2/ # GNU long options
16 | diff -qr dir1/ dir2/ # common short options
17 | ```
18 | 
19 | This will compare the files by using an hash algorithm
20 | ```
21 | rsync -rcnv a/* b/
22 | ```
23 | 
24 | ## Random
25 | 
26 | On `bash`, you can use the `$RANDOM` variable to get a number between 0 and 32767
27 | ```
28 | $RANDOM
29 | ```
30 | 
31 | On `bash`, you can get a number between 0 and n with
32 | ```
33 | $((RANDOM % n))
34 | ```
35 | 
36 | Shuffle the lines of a file and get the first n lines
37 | ```
38 | cat files.txt | shuf -n <n>
39 | ```
40 | 
41 | Generate a sequence of n shuffled numbers and pick the first one
42 | ```
43 | shuf -i 1-10 -n1
44 | ```
45 | 
46 | Generate a sequence of random numbers between 1 and 10 and pick only the first one
47 | ```
48 | shuf -i 1-10 -r -n1
49 | ```
50 | 


--------------------------------------------------------------------------------
/sysadmin:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # System Administration
 3 | 
 4 | ## Users and Groups
 5 | 
 6 | | command                                 | description                                      |
 7 | |-----------------------------------------|--------------------------------------------------|
 8 | | groupadd <name>                         | create a new group called *name*                 |
 9 | | usermod -a -G <group>[,<groups>] <user> | add an existing user to the group                |
10 | | usermod -g <group> <name>               | change the user primary group                    |
11 | | groups                                  | list the groups the current user is assigned to  |
12 | | groups <name>                           | list the groups the selected user is assigned to |
13 | | useradd -G <group> <name>               | create the user and assign it a group            |
14 | | getent group                            | list all groups on the system and their members  |
15 | 
16 | ## Network
17 | 
18 | - List all current open ports with relative processe using one of these
19 |   commands:
20 |     ```bash
21 |     sudo lsof -i
22 |     sudo netstat -lptu
23 |     sudo netstat -tulpn
24 |     ```
25 | 


--------------------------------------------------------------------------------
/vim:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Basics
 3 | :q 		quit vim
 4 | :q! 	quit vim without saving
 5 | :w <f>	write to <f>
 6 | :w!		overwrite the file if exit: 
 7 | :wq		write the file and quit
 8 | :x		quit and save
 9 | :r <f>	write the content of the file at the current cursor position
10 | :help	open the help guide
11 | ZZ		write file and quit
12 | 
13 | # Wrap selected lines
14 | (in visual mode) gq
15 | 
16 | # Tab commands to open and close tabs
17 | :tabedit {file}   edit specified file in a new tab
18 | :tabfind {file}   open a new tab with filename given, searching the 'path' to find it
19 | :tabclose         close current tab
20 | :tabclose {i}     close i-th tab
21 | :tabonly          close all other tabs (show only the current tab)
22 | 
23 | # Tab commands to navigate
24 | :tabs         list all tabs including their displayed windows
25 | :tabm 0       move current tab to first
26 | :tabm         move current tab to last
27 | :tabm {i}     move current tab to position i+1
28 | 
29 | :tabn         go to next tab
30 | :tabp         go to previous tab
31 | :tabfirst     go to first tab
32 | :tablast      go to last tabs
33 | 
34 | # Tab navigation shortcuts
35 | gt            go to next tab
36 | gT            go to previous tab
37 | {i}gt         go to tab in position i
38 | 
39 | 


--------------------------------------------------------------------------------
/jq:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # jq
 3 | 
 4 | ## Basic filters
 5 | 
 6 | | filter | description                                                              |
 7 | |--------|--------------------------------------------------------------------------|
 8 | | .      | identity takes its input and produces it unchanged as output             |
 9 | | \|     | pipe feeds the output of one filter into the input of another            |
10 | | .foo   | object-identifier produces the value of the given key, or null           |
11 | | .[]    | this returns all of the elements of the array or the values of an object |
12 | | .[1]   | array indexing                                                           |
13 | | .[1:5] | array slicing                                                            |
14 | | ,      | the same input is fed into both filters                                  |
15 | 
16 | ## Types and values
17 | 
18 | | type | description                                                           |
19 | |------|-----------------------------------------------------------------------|
20 | | []   | is used to construct arrays, the elements can be any jq expression    |
21 | | {}   | is used for constructing objects, the values can be any jq expression |
22 | 
23 | ## References
24 | - https://stedolan.github.io/jq/manual/
25 | 


--------------------------------------------------------------------------------
/adb:
--------------------------------------------------------------------------------
 1 | # adb
 2 | 
 3 | # List attached devices
 4 | adb devices
 5 | 
 6 | # Push a file from the host to the device
 7 | adb push <host> <target>
 8 | 
 9 | # Pull a file from the host to the device
10 | adb pull <device> <host>
11 | 
12 | # Reboot the device
13 | adb reboot
14 | 
15 | # Install an APK
16 | adb install <apk>
17 | 
18 | # Uninstall application
19 | adb uninstall <com.myapp.package>
20 | 
21 | # List all installed packages on device
22 | adb shell pm list packages
23 | 
24 | # Grant a given permission
25 | adb shell pm grant <com.myapp.package> <android.permission.INTERNET>
26 | 
27 | # Revoke a given permission
28 | adb shell pm revoke <com.myapp.package> <android.permission.INTERNET>
29 | 
30 | # List all properties
31 | adb shell getprop
32 | 
33 | # Retrieve the device Android API level
34 | adb shell getprop ro.build.version.sdk
35 | 
36 | # Set a property
37 | adb shell setprop debug.hwui.overdraw show
38 | 
39 | # Show scheduled alarms
40 | adb shell dumpsys alarm
41 | 
42 | # Show info about a given application
43 | adb shell dumpsys package <com.myapp.package>
44 | 
45 | # Show info about current visible activity
46 | adb shell dumpsys activity top
47 | 
48 | # Show helps on Activity info dump
49 | adb shell dumpsys activity -h
50 | 
51 | # Send input text to Android device
52 | adb input text "Send text"
53 | 


--------------------------------------------------------------------------------
/apt:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # apt
 3 | 
 4 | ## apt
 5 | 
 6 | | command                       | description                                   |
 7 | |-------------------------------|-----------------------------------------------|
 8 | | apt update                    | update package database                       |
 9 | | apt upgrade                   | upgrade installed packages                    |
10 | | apt install NAME[=VERSION]    | install the specific version of the package   |
11 | | apt remove NAME               | remove the package                            |
12 | | apt purge NAME                | remove the package and its configuration files|
13 | | apt remove --purge <packagename> | |
14 | | apt search QUERY              | search the packages that match QUERY          |
15 | | apt search --names-only QUERY | search all package's names that match QUERY   |
16 | | apt show PACKAGE              | show more information about PACKAGE           |
17 | | apt list --upgradeable        | list all upgradeable packages                 |
18 | | apt list --installed          | list installed packages                       |
19 | 
20 | ## apt-cache
21 | 
22 | | command                 | description                         |
23 | |-------------------------|-------------------------------------|
24 | | apt-cache pkgnames      | list all available packages         |
25 | | apt-cache pkgnames NAME | search all packages containing NAME |
26 | 


--------------------------------------------------------------------------------
/.github/README.md:
--------------------------------------------------------------------------------
 1 | <!-- DO NOT MODIFY THIS FILE, THIS FILE IS AUTO-GENERATED -->
 2 | 
 3 | [license]: http://creativecommons.org/licenses/by-nc-sa/4.0/
 4 | [license-badge]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg?style=for-the-badge
 5 | 
 6 | # cheatsheet
 7 | 
 8 | [![License: Creative Commons by-nc-sa][license-badge]][license]
 9 | 
10 | [android-studio](android-studio);
11 | [apt](apt);
12 | [bash](bash);
13 | [bash-if](bash-if);
14 | [bash-shortcuts](bash-shortcuts);
15 | [bash-test](bash-test);
16 | [bash-tilde-expansion](bash-tilde-expansion);
17 | [boxes](boxes);
18 | [bpkg](bpkg);
19 | [clion](clion);
20 | [coala](coala);
21 | [curl](curl);
22 | [feh](feh);
23 | [find](find);
24 | [git](git);
25 | [gitlab-api](gitlab-api);
26 | [gitlab-srv](gitlab-srv);
27 | [git.yaml](git.yaml);
28 | [jq](jq);
29 | [linux](linux);
30 | [markdown](markdown);
31 | [newsboat](newsboat);
32 | [openapi-generator](openapi-generator);
33 | [pre-commit](pre-commit);
34 | [pycharm](pycharm);
35 | [python-distribution](python-distribution);
36 | [python-pipenv](python-pipenv);
37 | [python-virtualenvwrapper](python-virtualenvwrapper);
38 | [regex-recipies](regex-recipies);
39 | [sysadmin](sysadmin);
40 | [taskwarrior](taskwarrior);
41 | [terminator](terminator);
42 | [vagrant](vagrant);
43 | [vim](vim);
44 | [vim-goyo](vim-goyo);
45 | [vim-spelling](vim-spelling);
46 | 
47 | ## License
48 | 
49 | This work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][license].
50 | 
51 | ## Contribute
52 | 
53 | ### Rendering of cheatsheet on github
54 | 
55 | If you want your cheatsheet to be rendered by Github as a markdown file,
56 | without adding an extension, add this line on top `<!-- vim: syntax=Markdown
57 | -->`. According to `github-linguist`, it should be possible to do this with the
58 | `.gitattributes` but it doesn't seems to work at the moment.
59 | 


--------------------------------------------------------------------------------
/taskwarrior:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Syntax
 3 | > All taskwarrior's commands follow this general syntax
 4 | 
 5 | ```bash
 6 | task <[filter]> <[command]> [<modifications> | <miscellaneous>]
 7 | ```
 8 | 
 9 | # Commands
10 | 
11 | > Some of the most common commands, for a full list visit https://taskwarrior.org/docs/commands/
12 | 
13 | | command                                               | description                              |
14 | |-------------------------------------------------------|------------------------------------------|
15 | | task <[filter]> modify <[modifications]>              | modify one or more task                  |
16 | | task add DESCRIPTION <[modifications]>                | add a new task                           |
17 | | task <[filter]> start                                 | start working on a task, make active     |
18 | | task <[filter]> stop                                  | stop working on a task, no longer active |
19 | | task <[filter]> done <[annotation]> <[modifications]> | complete a task                          |
20 | 
21 | # Reports
22 | 
23 | > For more information on report visit https://taskwarrior.org/docs/report.html
24 | 
25 | | report | description |
26 | | --- | --- |
27 | | task <[filter]> tags | filtered list of tags |
28 | | task <[filter]> projects | filtered list of projects, with task counts |
29 | | task <[filter]> summary | filtered project summary |
30 | 
31 | # Filters
32 | 
33 | Filters are used to specify a set of tasks, it is possible to filter
34 | 
35 | * by attribute's value `attribute: [value]`, or lack of value `attribute:`
36 | * by `+tag`, or lack of `-tag`,
37 | * or by looking for a match `/regex/`;
38 | 
39 | ## Examples
40 | 
41 | ```bash
42 | # list all task assigned to the 'home' project
43 | task project:home list
44 | ```
45 | 
46 | ```bash
47 | # list all task with the 'urgent' tag
48 | task +urgent list
49 | ```
50 | 
51 | ```bash
52 | # list all task but the ones included in the project C
53 | task project.not:C
54 | ```
55 | 
56 | # Attributes
57 | > Some of taskwarrior's core attributes, for a full list run the command `task _columns`
58 | 
59 | | attribute       | description                      |
60 | |-----------------|----------------------------------|
61 | | project: string | project.subproject               |
62 | | due: date       | the due date                     |
63 | | depends:        | the id of the task it depends on |
64 | 


--------------------------------------------------------------------------------
/git.yaml:
--------------------------------------------------------------------------------
 1 | type: terminal-command
 2 | cheats:
 3 |   - description: Create a new local branch from a remote one
 4 |     command: git checkout --track origin/<ref>
 5 |   - description: Checkout and create a new branch
 6 |     command: git checkout -b new-branch <ref>
 7 |   - description: Nice looking git log completed with stashes
 8 |     command: git log --oneline --graph --decorate --all $(git reflog show --format="%h" stash)
 9 |   - description: Remove a file from the index and keeps it in the local filesystem
10 |     command: git rm --cached <file>
11 |   - description: Rewind your current HEAD to the previous commit and preserves the changes in your working directory
12 |     command: git reset --soft HEAD~1
13 |   - description: Rewind your current HEAD to the previous commit and drop the changes
14 |     command: git reset --hard HEAD~1
15 |   - description: Stash untracked files and unstaged files
16 |     command: git stash -k -u
17 |   - description: Diff last commit with changes not yet staged
18 |     command: git diff
19 |   - description: Diff last commit with staged changes
20 |     command: git diff --staged
21 |   - description: Diff last commit with staged changes (synonym of --staged)
22 |     command: git diff --cached
23 |   - description: Display a short-format version of your local repository status
24 |     command: git status -s
25 |   - description: Rebase your current branch onto <target> branch
26 |     command: "
27 | git checkout <branch>
28 | git rebase origin/<remote>
29 | "
30 |   - description: Show a file at a specific version
31 |     command: git show <treeish>:<path>
32 |   - description: Add a submodule to your repository
33 |     command: git submodule add <repository> [<path>]
34 |   - description: Add a submodule to your repository with the given logical name
35 |     command: git submodule add <repository> [<path>] --name <logical>
36 |   - description: List all repository's submodules
37 |     command: git submodule status
38 |   - description: Initialize the submodules recorded in the index
39 |     command: git submodule init
40 |   - description: Clone the submodules
41 |     command: git submodule update
42 |   - description: Checkout the submodules to the remote tracking branch
43 |     command: git submodule update --remote
44 |   - description: Initialize and clone the submodule
45 |     command: git submodule update --init
46 |   - description: Clone a repository and download all submodules
47 |     command: git clone --recursive <url>
48 | 


--------------------------------------------------------------------------------
/vagrant:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Vagrant
 3 | 
 4 | Get information about SSH config
 5 | ```
 6 | vagrant ssh-config
 7 | ```
 8 | 
 9 | ## Up and running
10 | 
11 | ```bash
12 | # Initialize the environment with the specific Box. To find a box, go to https://app.vagrantup.com/boxes/search
13 | vagrant init ubuntu/bionic64
14 | # Start the vagrant environment
15 | vagrant up
16 | # Connect to the machine via SSH
17 | vagrant ssh
18 | ```
19 | 
20 | ## Creating and destroying Virtual Machine
21 | 
22 | | command                        | description                                                                                                    |
23 | |--------------------------------|----------------------------------------------------------------------------------------------------------------|
24 | | vagrant init                   | Create a Vagrant environment with an initial Vagrantfile.                                                      |
25 | | vagrant init [<config.vm.box>] | Specify the box to initilize the Vagrantfile with. To find a box, go to https://app.vagrantup.com/boxes/search |
26 | | vagrant destroy <id>           | Destroy the vagrant machine specified                                                                          |
27 | ## Starting a Virtual Machine
28 | 
29 | | command        | description                                                  |
30 | |----------------|--------------------------------------------------------------|
31 | | vagrant up     | starts vagrant environment and provisioning on the first run |
32 | | vagrant resume | resume a suspended machine                                   |
33 | | vagrant reload | restarts vagrant machine and loads new Vagrantfile           |
34 | 
35 | ## Stopping the Virtual Machine
36 | 
37 | | command         | description                |
38 | |-----------------|----------------------------|
39 | | vagrant halt    | stops the vagrant machine  |
40 | | vagrant suspend | suspends a virtual machine |
41 | 
42 | ## Logging into the Virtual Machine
43 | 
44 | | command             | description                                                                     |
45 | |---------------------|---------------------------------------------------------------------------------|
46 | | vagrant ssh         | connect to the machine via SSH                                                  |
47 | | vagrant ssh BOXNAME | connect to the machine with the given box's name, this works from any directory |
48 | 
49 | ## Miscelloneous
50 | 
51 | | commmand                        | description                              |
52 | |---------------------------------|------------------------------------------|
53 | | vagrant global-status [--prune] | check the status of all vagrant machines |
54 | 
55 | ## Configurations
56 | 
57 | ### Enable GUI
58 | 
59 | To enable the GUI, add the following snippet to your configuration file:
60 | 
61 | ```ruby
62 | config.vm.provider "virtualbox" do |v|
63 | 	v.gui = true
64 | end
65 | ```
66 | 
67 | # References
68 | 
69 | - https://gist.github.com/wpscholar/a49594e2e2b918f4d0c4
70 | 


--------------------------------------------------------------------------------
/bash:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Bash
 3 | 
 4 | ```bash
 5 | # only parses the script, without running it 
 6 | bash -n <script>
 7 | # verbose output
 8 | bash -v <script>
 9 | # trace script execution
10 | bash -x <script>
11 | ```
12 | 
13 | ```bash
14 | # treat unset variables as an error
15 | set -o nounset
16 | # trace script execution
17 | set -o xtrace
18 | # PS4 is expanded before each command displays, during an execution trace
19 | ```
20 | 
21 | ## Arithmetic Expansion
22 | It is possible to performs integer arithmetic operations using arithmetic
23 | expansion. The followings are three different variations on arithmetic
24 | expansion.
25 | 
26 | - Using the command `expr` and the backticks: ``RESULT=`expr EXPRESSION` ``;
27 | 
28 | - Using double parentheses:
29 | 	- as a command `(( EXPRESSION ))`, this returns 0 if expression is different is different from zero, else 1;
30 | 	- as an interpolation `VARIABLE=$(( EXPRESSION ))`, this returns the value of the expression;
31 | 
32 | - Using the command `let`: `let EXPRESSION`;
33 | 
34 | ## Parameter substitution
35 | 
36 | | command                 | description                                                                |
37 | |-------------------------|----------------------------------------------------------------------------|
38 | | ${parameter} $parameter | value of the variable *parameter*                                          |
39 | | ${parameter-default}    | if the *parameter* is not set, use *default*                               |
40 | | ${parameter:-default}   | if the *parameter* is set but null, use *default*                          |
41 | | ${parameter=default}    | if the *parameter* is not set, set it to *default*                         |
42 | | ${parameter:=default}   | if the *parameter* is set but null, set it to *default*                    |
43 | | ${parameter+alt_value}  | if the *parameter* is set, use *alt_value*, else use *null*                |
44 | | ${parameter:+alt_value} | if the *parameter* is set and not null, use *alt_value*, else use *null*   |
45 | | ${parameter?err_msg}    | if *parameter* is set, use it, else print *err_msg* and abort              |
46 | | ${parameter:?err_msg}   | if *parameter* is set and not null, use it, else print *err_msg* and abort |
47 | 
48 | | command         | description                                                    |
49 | |-----------------|----------------------------------------------------------------|
50 | | ${#var}         | string length, for an array the length of the first element    |
51 | | ${var#pattern}  | remove from the front of *var* the shortest match of *pattern* |
52 | | ${var##pattern} | remove from the front of *var* the longest match of *pattern*  |
53 | | ${var%pattern}  | remove from the back of *var* the shortest match of *pattern*  |
54 | | ${var%%pattern} | remove from the back of *var* the longest match of *pattern*   |
55 | 
56 | | command                        | description                                                                           |
57 | |--------------------------------|---------------------------------------------------------------------------------------|
58 | | ${var:pos}                     | expand *var* starting from offset *pos*                                               |
59 | | ${var:pos:len}                 | expand a maximum of *len* characters of *var*, starting from offset *pos*             |
60 | | ${var/pattern/replacement}     | replace the first match of *pattern*, within *var*, with *replacement*                |
61 | | ${var//pattern/replacement}    | replace all matches of *pattern*, within *var*, with *replacement*                    |
62 | | ${var/#pattern/replacement}    | if the start of *var* matches *pattern*, then substitute the match with *replacement* |
63 | | ${var/%Pattern/Replacement}    | if the end of *var* matches *pattern*, then substitute the match with *replacement*   |
64 | | ${!varprefix*}, ${!varprefix@} | expand to all variable's names matching *varprefix*                                   |
65 | 
66 | # Recipies
67 | 
68 | ## Check the return code of a command
69 | ```bash
70 | if [ $? -eq 0]; then
71 | 	echo OK
72 | else
73 | 	echo FAIL
74 | fi
75 | ```
76 | 


--------------------------------------------------------------------------------
/markdown:
--------------------------------------------------------------------------------
  1 | <!-- vim: syntax=Markdown -->
  2 | # Markdown
  3 | 
  4 | ## Headers
  5 | 
  6 | ```
  7 | # H1
  8 | ## H2
  9 | ### H3
 10 | #### H4
 11 | ##### H5
 12 | ###### H6
 13 | ```
 14 | ```
 15 | Alternatively, for H1 and H2, an underline-ish style:
 16 | 
 17 | Alt-H1
 18 | ======
 19 | 
 20 | Alt-H2
 21 | ------
 22 | ```
 23 | 
 24 | ## Emphasis
 25 | 
 26 | ```
 27 | Emphasis, aka italics, with *asterisks* or _underscores_.
 28 | 
 29 | Strong emphasis, aka bold, with **asterisks** or __underscores__.
 30 | 
 31 | Combined emphasis with **asterisks and _underscores_**.
 32 | 
 33 | Strikethrough uses two tildes. ~~Scratch this.~~
 34 | ```
 35 | ## Lists
 36 | 
 37 | ```
 38 | 1. First ordered list item
 39 | 2. Another item
 40 |   * Unordered sub-list. 
 41 | 1. Actual numbers don't matter, just that it's a number
 42 |   1. Ordered sub-list
 43 | 4. And another item.
 44 | 
 45 |    You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces.
 46 | 
 47 |    To have a line break without a paragraph, you will need to use two trailing spaces.  
 48 |    Note that this line is separate, but within the same paragraph.
 49 | ```
 50 | ```
 51 | * Unordered list can use asterisks
 52 | - Or minuses
 53 | + Or pluses
 54 | ```
 55 | 
 56 | ## Links
 57 | 
 58 | There are two ways to create links.
 59 | 
 60 | ```
 61 | [I'm an inline-style link](https://www.google.com)
 62 | 
 63 | [I'm an inline-style link with title](https://www.google.com "Google's Homepage")
 64 | 
 65 | [I'm a reference-style link][Arbitrary case-insensitive reference text]
 66 | 
 67 | [I'm a relative reference to a repository file](../blob/master/LICENSE)
 68 | 
 69 | [You can use numbers for reference-style link definitions][1]
 70 | 
 71 | Or leave it empty and use the [link text itself].
 72 | 
 73 | URLs and URLs in angle brackets will automatically get turned into links. 
 74 | http://www.example.com or <http://www.example.com> and sometimes 
 75 | example.com (but not on Github, for example).
 76 | 
 77 | Some text to show that the reference links can follow later.
 78 | 
 79 | [arbitrary case-insensitive reference text]: https://www.mozilla.org
 80 | [1]: http://slashdot.org
 81 | [link text itself]: http://www.reddit.com
 82 | ```
 83 | 
 84 | ## Images
 85 | 
 86 | ```
 87 | Inline-style: 
 88 | ![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 1")
 89 | ```
 90 | ```
 91 | Reference-style: 
 92 | ![alt text][logo]
 93 | 
 94 | [logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 2"
 95 | ```
 96 | 
 97 | ## Code and Syntax Highlighting
 98 | 
 99 | ```
100 | Inline `code` has `back-ticks around` it.
101 | ```
102 | 
103 | ```python
104 | s = "Python syntax highlighting"
105 | print s
106 | ```
107 | 
108 | ## Tables
109 | 
110 | ```
111 | Colons can be used to align columns.
112 | 
113 | | Tables        | Are           | Cool  |
114 | | ------------- |:-------------:| -----:|
115 | | col 3 is      | right-aligned | $1600 |
116 | | col 2 is      | centered      |   $12 |
117 | | zebra stripes | are neat      |    $1 |
118 | 
119 | There must be at least 3 dashes separating each header cell.
120 | The outer pipes (|) are optional, and you don't need to make the 
121 | raw Markdown line up prettily. You can also use inline Markdown.
122 | 
123 | Markdown | Less | Pretty
124 | --- | --- | ---
125 | *Still* | `renders` | **nicely**
126 | 1 | 2 | 3
127 | ```
128 | 
129 | ## Blockquotes
130 | 
131 | ```
132 | > Blockquotes are very handy in email to emulate reply text.
133 | > This line is part of the same quote.
134 | ```
135 | 
136 | ## Task List
137 | 
138 | ```
139 | - [x] Learn Markdown
140 | - [ ] Learn more Markdown
141 | ```
142 | 
143 | - [x] Learn Markdown
144 | - [ ] Learn more Markdown
145 | 
146 | ## Footnote [^1]
147 | 
148 | ```
149 | ## Footnote [^1]
150 | [^1]: This is a footnote
151 | ```
152 | 
153 | [^1]: This is a footnote
154 | 
155 | ## Heading ID
156 | 
157 | ```
158 | ## Heading ID
159 | [Jumb to the heading with ID](#heading-ID)
160 | ```
161 | 
162 | [Jumb to the heading with ID](#heading-ID)
163 | 
164 | ## Inline HTML
165 | 
166 | ```
167 | <dl>
168 |   <dt>Definition list</dt>
169 |   <dd>Is something people use sometimes.</dd>
170 | 
171 |   <dt>Markdown in HTML</dt>
172 |   <dd>Does *not* work **very** well. Use HTML <em>tags</em>.</dd>
173 | </dl>
174 | ```
175 | 
176 | ## Horizontal Rule
177 | 
178 | ```
179 | Three or more...
180 | 
181 | ---
182 | 
183 | Hyphens
184 | 
185 | ***
186 | 
187 | Asterisks
188 | 
189 | ___
190 | 
191 | Underscores
192 | ```
193 | 
194 | ## Line Breaks
195 | 
196 | ```
197 | Here's a line for us to start with.
198 | 
199 | This line is separated from the one above by two newlines, so it will be a *separate paragraph*.
200 | 
201 | This line is also a separate paragraph, but...
202 | This line is only separated by a single newline, so it's a separate line in the *same paragraph*.
203 | ```
204 | 


--------------------------------------------------------------------------------
/git:
--------------------------------------------------------------------------------
  1 | <!-- vim: syntax=Markdown -->
  2 | # git
  3 | 
  4 | Which commit a tag points to?
  5 | ```
  6 | $ git rev-list -n 1 $TAG
  7 | ```
  8 | 
  9 | List all commits between two commit hashes
 10 | ```
 11 | $ git rev-list --ancestry-path [commit1]^..[commit2]
 12 | ```
 13 | 
 14 | Clone a repository and download all submodules
 15 | ```
 16 | $ git clone --recursive <url>
 17 | ```
 18 | 
 19 | Display a short-format version of your local repository status
 20 | ```
 21 | $ git status -s
 22 | ```
 23 | 
 24 | Create a new local branch from a remote one
 25 | ```
 26 | $ git checkout --track origin/<ref>
 27 | ```
 28 | 
 29 | Create and checkout a new branch starting from `<ref>`
 30 | ```
 31 | $ git checkout -b <branch-name> <ref>
 32 | ```
 33 | 
 34 | Show a file at a specific version
 35 | ```
 36 | git show <treeish>:<path>
 37 | ```
 38 | 
 39 | List all files in a commit.
 40 | ```
 41 | git diff-tree --no-commit-id --name-only <ref> -r
 42 | ```
 43 | 
 44 | Return repository root directory
 45 | ```
 46 | $ git rev-parse --show-toplevel
 47 | ```
 48 | 
 49 | Amend the last commit without editing the message
 50 | ```
 51 | $ git commit --amend --no-edit
 52 | ```
 53 | 
 54 | ## Tags
 55 | 
 56 | List tags from all remotes or only the specified one
 57 | ```
 58 | git ls-remote --tags [remote]
 59 | ```
 60 | 
 61 | ## Rebase
 62 | 
 63 | Rebase **branch** starting from **upstream** onto **newbase**
 64 | ```
 65 | git rebase --onto newbase upstream branch
 66 | ```
 67 | 
 68 | <!-- id: 10 -->
 69 | Rebase your current branch onto <target> branch
 70 | ```
 71 | $ git checkout <branch>
 72 | $ git rebase origin/<remote>
 73 | ```
 74 | 
 75 | ## Branches
 76 | 
 77 | Reset the current branch to a specific commit
 78 | ```
 79 | git reset --hard [commit]
 80 | ```
 81 | 
 82 | Reset the current branch to the previous commit and keep the changes in the staging area
 83 | ```
 84 | git reset HEAD^
 85 | ```
 86 | 
 87 | Rename a local branch
 88 | ```
 89 | git branch -m [old-name] <new-name>
 90 | ```
 91 | 
 92 | Prune all stale (missing from remote) tracking branches
 93 | ```
 94 | git fetch --prune|-p
 95 | ```
 96 | 
 97 | ```
 98 | git remote prune origin
 99 | ```
100 | 
101 | ## Staging area
102 | 
103 | Remove a file from the index and keeps it in the local filesystem
104 | ```
105 | $ git rm --cached <file>
106 | ```
107 | 
108 | Rewind your current HEAD to the previous commit and preserves the changes in
109 | your working directory
110 | ```
111 | $ git reset --soft HEAD~1
112 | ```
113 | 
114 | Rewind your current HEAD to the previous commit and drop the changes
115 | ```
116 | $ git reset --hard HEAD~1
117 | ```
118 | 
119 | Selectively reset the changes (hunks) in the staging area
120 | ```
121 | $ git reset -p
122 | ```
123 | 
124 | ## Working area
125 | 
126 | Selectively reset the changes (hunks) in the working area
127 | ```
128 | $ git checkout -p
129 | ```
130 | 
131 | ## git-diff
132 | 
133 | Diff last commit with changes not yet staged
134 | ```
135 | $ git diff
136 | ```
137 | 
138 | Diff last commit with staged changes
139 | ```
140 | $ git diff --staged
141 | ```
142 | 
143 | Diff last commit with staged changes (synonym of --staged)
144 | ```
145 | $ git diff --cached
146 | ```
147 | 
148 | Display a summary of the changes
149 | ```
150 | git diff --stat
151 | ```
152 | 
153 | ## git-log
154 | 
155 | Nice looking git log completed with stashes
156 | ```
157 | $ git log --oneline --graph --decorate --all $(git reflog show --format="%h" stash)
158 | ```
159 | 
160 | Oneline log with a list of changed files
161 | ```
162 | $ git log --name-status --pretty="%h%x09%ad%x09%ar%x09%s" --date=short
163 | ```
164 | 
165 | Show path and status of changed files
166 | ```
167 | $ git log --name-status
168 | ```
169 | 
170 | ## git-submodule
171 | 
172 | Add a submodule to your repository
173 | ```
174 | $ git submodule add <repository> [<path>]
175 | ```
176 | 
177 | Add a submodule to your repository with the given logical name
178 | ```
179 | $ git submodule add <repository> [<path>] --name <logical>
180 | ```
181 | 
182 | List all repository's submodules
183 | ```
184 | $ git submodule status
185 | ```
186 | 
187 | Initialize the submodules recorded in the index
188 | ```
189 | $ git submodule init
190 | ```
191 | 
192 | Update the registered submodules, i.e. clone missing submodules and checkout
193 | the commit specified in the index of the superproject
194 | ```
195 | $ git submodule update [<path> ...]
196 | ```
197 | 
198 | Checkout the submodules to the remote tracking branch
199 | ```
200 | $ git submodule update --remote
201 | ```
202 | 
203 | Initialize and clone the submodule
204 | ```
205 | $ git submodule update --init
206 | ```
207 | 
208 | ## git-stash
209 | 
210 | Stash everything, `-u` untracked files too, but keep `-k` the staged changes in your working copy.
211 | The saved stash will contains everything, included the staged changes.
212 | ```
213 | $ git stash -k -u
214 | ```
215 | 
216 | Show only the untracked files stored inside a stash.
217 | ```
218 | git show 'stash@{0}^3'
219 | ```
220 | 


--------------------------------------------------------------------------------
/pre-commit:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # pre-commit
 3 | 
 4 | ## Installation
 5 | 
 6 | ```bash
 7 | pip install pre-commit
 8 | ```
 9 | 
10 | ## Up and running
11 | 
12 | - Create a configuration file called `.pre-commit-config.yaml`;
13 |     - Configure the hooks to be used by your repository, see **Configuration**
14 |       for more information.  pre-commit hooks are distributed using git
15 |       repository;
16 |     - Run `pre-commit sample-config > .pre-commit-config.yaml` to generate a
17 |       sample configuration file;
18 | - Run `pre-commit install` to install pre-commit into your git hooks;
19 | - (Optionally) Run all pre-commit hooks manually `pre-commit run --all-files`,
20 |   or just one `pre-commit run <hook_id>`;
21 | - Everytime you commit some changes, pre-commit will run your hooks;
22 | 
23 | ## Configuration
24 | 
25 | The pre-commit config file describes what repositories and hooks are installed.
26 | 
27 | | field                      | description                                           |
28 | |----------------------------|-------------------------------------------------------|
29 | | `repos`                    | a list of **repository mappings**, see below          |
30 | | `default_language_version` | a mapping from language to the default version to use |
31 | | `default_stages`           | a list of defaults stages                             |
32 | | `exclude`                  | a global file exclude pattern                         |
33 | | `fail_fast`                | whether to stop after the first failure or not        |
34 | 
35 | ### Repository mapping
36 | 
37 | > This mapping teels pre-commit where to get the code for the hook from:
38 | 
39 | | field   | description                                                         |
40 | |---------|---------------------------------------------------------------------|
41 | | `repo`  | the repository url, or the sentinel value `local` (see Local hooks) |
42 | | `rev`   | the revision or tag to clone at                                     |
43 | | `hooks` | a list of **hook mappings**                                         |
44 | 
45 | ### Hooks mapping
46 | 
47 | > This mapping configures which hook from the repository is used.
48 | 
49 | | field                     | description                                                                                |
50 | |---------------------------|--------------------------------------------------------------------------------------------|
51 | | `id`                      | the id of the hook to use                                                                  |
52 | | `alias`                   | additional id that can be used to reference this id                                        |
53 | | `name`                    | the name shown during hook execution                                                       |
54 | | `language_version`        | the language version for the hook                                                          |
55 | | `files`                   | override the default pattern for files to run on                                           |
56 | | `exclude`                 | file exclude pattern                                                                       |
57 | | `types`                   | override the default file types to run on                                                  |
58 | | `exclude_types`           | file types to exclude                                                                      |
59 | | `args`                    | list of additional arguments to pass to the hook                                           |
60 | | `stages`                  | run the hook to the *commit*, *push*, *commit-msg* or *manual* stage                       |
61 | | `additional_dependencies` | a list of dependencies that will be installed in the environment where this hooks gets run |
62 | | `always_run`              | whether to always run this hook or not                                                     |
63 | | `verbose`                 | forces the hook output to be printed                                                       |
64 | | `log_file`                | the hook output will additionally be written to a file                                     |
65 | 
66 | 
67 | ## Local hooks
68 | 
69 | > It is possible to use define and use hooks in the same repository. In this
70 | > case the hooks mapping must define `id`, `name`, `language`, `entry` and
71 | > `files` or `types`.
72 | 
73 | ```yaml
74 | -   repo: local
75 |     hooks:
76 |     -   id: pylint
77 |         name: pylint
78 |         entry: python -m pylint.__main__
79 |         language: system
80 |         types: [python]
81 | ```
82 | 
83 | ## Commands
84 | 
85 | | command                      | description                            |
86 | |------------------------------|----------------------------------------|
87 | | `pre-commit install`         | install pre-commit into your git hooks |
88 | | `pre-commit run --all-files` | manually run all pre-commit hooks      |
89 | | `pre-commit run <hook_id>`   | run the hook with the given id         |
90 | 


--------------------------------------------------------------------------------
/bash-test:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # test
 3 | 
 4 | > The *test* command, or the synonym *[*, are commands that returns 0 or 1
 5 | > based on the truth value of the expression.
 6 | 
 7 | ## Expressions
 8 | 
 9 | > Here a list of expressions that can be used with the *test* command.
10 | 
11 | | expression      | condition                                                                                       |
12 | |-----------------|-------------------------------------------------------------------------------------------------|
13 | | -b FILE         | True if FILE exists and is a block-special file.                                                |
14 | | -c FILE         | True if FILE exists and is a character-special file.                                            |
15 | | -d FILE         | True if FILE exists and is a directory.                                                         |
16 | | -e FILE         | True if FILE exists.                                                                            |
17 | | -f FILE         | True if FILE exists and is a regular file.                                                      |
18 | | -g FILE         | True if FILE exists and its SGID bit is set.                                                    |
19 | | -h FILE         | True if FILE exists and is a symbolic link.                                                     |
20 | | -k FILE         | True if FILE exists and its sticky bit is set.                                                  |
21 | | -p FILE         | True if FILE exists and is a named pipe (FIFO).                                                 |
22 | | -r FILE         | True if FILE exists and is readable.                                                            |
23 | | -s FILE         | True if FILE exists and has a size greater than zero.                                           |
24 | | -t FD           | True if file descriptor FD is open and refers to a terminal.                                    |
25 | | -u FILE         | True if FILE exists and its SUID (set user ID) bit is set.                                      |
26 | | -w FILE         | True if FILE exists and is writable.                                                            |
27 | | -x FILE         | True if FILE exists and is executable.                                                          |
28 | | -O FILE         | True if FILE exists and is owned by the effective user ID.                                      |
29 | | -G FILE         | True if FILE exists and is owned by the effective group ID.                                     |
30 | | -L FILE         | True if FILE exists and is a symbolic link.                                                     |
31 | | -N FILE         | True if FILE exists and has been modified since it was last read.                               |
32 | | -S FILE         | True if FILE exists and is a socket.                                                            |
33 | | FILE1 -nt FILE2 | True if FILE1 has been changed more recently than FILE2, or if FILE1 exists and FILE2 does not. |
34 | | FILE1 -ot FILE2 | True if FILE1 is older than FILE2, or is FILE2 exists and FILE1 does not.                       |
35 | | FILE1 -ef FILE2 | True if FILE1 and FILE2 refer to the same device and inode numbers.                             |
36 | 
37 | | expression     | condition                                      |
38 | |----------------|------------------------------------------------|
39 | | LEFT -eq RIGHT | True if LEFT is equal to RIGHT                 |
40 | | LEFT -ne RIGHT | True if LEFT is not equal to RIGHT             |
41 | | LEFT -gt RIGHT | True if LEFT is greater than RIGHT             |
42 | | LEFT -ge RIGHT | True if LEFT is greater than or equal to RIGHT |
43 | | LEFT -lt RIGHT | True if LEFT is less than RIGHT                |
44 | | LEFT -le RIGHT | True if LEFT is less than or equal to RIGHT    |
45 | 
46 | | expression    | condition                                            |
47 | |---------------|------------------------------------------------------|
48 | | LEFT == RIGHT | True if LEFT is equal to RIGHT                       |
49 | | LEFT != RIGHT | True if LEFT is not equal to RIGHT                   |
50 | | LEFT \< RIGHT | True if LEFT is lexicographically less than RIGHT    |
51 | | LEFT \> RIGHT | True if LEFT is lexicographically greater than RIGHT |
52 | | -z STRING     | True if STRING's length is zero                      |
53 | | -n STRING     | True if STRING's length is greater than zero         |
54 | 
55 | | expression     | condition                                                                                   |
56 | |----------------|---------------------------------------------------------------------------------------------|
57 | | ! EXPR         | True if EXPR is false.                                                                      |
58 | | ( EXPR )       | Returns the value of EXPR. This may be used to override the normal precedence of operators. |
59 | | EXPR1 -a EXPR2 | True if both EXPR1 and EXPR2 are true.                                                      |
60 | | EXPR1 -o EXPR2 | True if either EXPR1 or EXPR2 is true.                                                      |
61 | 


--------------------------------------------------------------------------------
/android-studio:
--------------------------------------------------------------------------------
 1 | <!-- vim: syntax=Markdown -->
 2 | # Shortcuts
 3 | 
 4 | > You can find some of these shortcuts inside the keymap reference (Help -> Keymap Reference.)
 5 | 
 6 | | Description               | OSX                     | Windows and Linux       |
 7 | |---------------------------|-------------------------|-------------------------|
 8 | | Override/implement method | Control + O             | Control + O             |
 9 | | Code completions          | Command + Space         | Control + Space         |
10 | | Quick documentation       | Command + J             | Control + Q             |
11 | | Recent files dialog       | Command + E             | Control + E             |
12 | | Fold code block           | Command + -             | Control + -             |
13 | | Unfold code block         | Command + +             | Control + +             |
14 | | Reformat code             | Command + Alt + L       | Control + Alt + L       |
15 | | Complete statement        | Command + Shift + Enter | Control + Shift + Enter |
16 | | Surround with tag         | Command + Alt + T       |                         |
17 | | Open 'select in' menu     | Alt + F1                | Alt + F1                |
18 | 
19 | ## Running
20 | 
21 | | Description                | OSX          | Windows and Linux |
22 | |----------------------------|--------------|-------------------|
23 | | Deploy on target           | Control + R  | Shift + F10       |
24 | | Deploy on target and debug | Control + D  | Shift + F9        |
25 | | Stop the application       | Command + F2 |                   |
26 | | Build the project          |              | Control + F9      |
27 | 
28 | ## Debugging
29 | 
30 | | Description          | OSX                  | Windows and Linux |
31 | |----------------------|----------------------|-------------------|
32 | | Toogle breakpoint    | Command + F8         |                   |
33 | | Show all breakpoints | Command + Shift + F8 |                   |
34 | 
35 | ## Editing
36 | 
37 | | Description                 | OSX                 | Windows and Linux   |
38 | |-----------------------------|---------------------|---------------------|
39 | | Choose from the last copies | Command + Shift + v | Control + Shift + v |
40 | | Edit multiple occurrences   | Control + g         | Alt + j             |
41 | | Expand selection            |                     | Control + W         |
42 | | Duplicate line              |                     | Control + D         |
43 | | Remove line                 |                     | Control + Y         |
44 | | Comment line                |                     | Control + /         |
45 | 
46 | ## Code Generation
47 | 
48 | | Description             | OSX         | Windows and Linux       |
49 | |-------------------------|-------------|-------------------------|
50 | | basic code completition |             | Control + Space         |
51 | | complete statement      |             | Control + Shift + Enter |
52 | | generate code           | Command + N | Alt + Insert            |
53 | | use live templates      | Command + j | Control + j             |
54 | 
55 | ## Code Navigation
56 | 
57 | | Description                           | OSX                          | Windows and Linux            |
58 | |---------------------------------------|------------------------------|------------------------------|
59 | | Switches between tabs                 |                              | Control + Tab                |
60 | | Recently opened files                 | Command + E                  | Control + E                  |
61 | | Recently edited files                 | Command + Shift + E          | Control + Shift + E          |
62 | | Navigate back and forward             | Command + Alt + Left (Right) | Control + Alt + Left (Right) |
63 | | Search a class                        | Command + o                  | Control + n                  |
64 | | Search any file                       | Command + Shift + o          | Control + Shift + n          |
65 | | Search symbol                         | Command + Alt + O            | Control + Alt + Shift + N    |
66 | | Open a symbol                         | Command + Option + o         | Alt + Shift + n              |
67 | | Go to declaration                     | Command + b                  | Control + b                  |
68 | | Go to type declaration                | Control + Shift + b          | Control + Shift + b          |
69 | | Go to implementation                  | Command + Option + b         | Control + Alt + b            |
70 | | Find usages                           |                              | Control + Alt + F7           |
71 | | Open Structure view                   |                              | Control + F12                |
72 | | Go to line                            | Command + L                  | Control + G                  |
73 | | Go to error or warning                |                              | F2                           |
74 | | Move to next and previous declaration | Control + Up (Down)          |                              |
75 | 
76 | ## Search
77 | 
78 | | Description       | OSX                 | Windows and Linux   |
79 | |-------------------|---------------------|---------------------|
80 | | Search everywhere | Shift (x2)          | Shift (x2)          |
81 | | Search actions    | Command + Shift + A | Control + Shift + A |
82 | 
83 | ## Refactoring
84 | 
85 | | Description        | OSX               | Windows and Linux |
86 | |--------------------|-------------------|-------------------|
87 | | rename             | Shift + F6        | Shift + F6        |
88 | | extract expression | Command + Alt + V | Control + Alt + V |
89 | | extract method     |                   | Control + Alt + M |
90 | 


--------------------------------------------------------------------------------
/.github/LICENSE.md:
--------------------------------------------------------------------------------
  1 | Attribution-NonCommercial-ShareAlike 4.0 International
  2 | 
  3 | =======================================================================
  4 | 
  5 | Creative Commons Corporation ("Creative Commons") is not a law firm and
  6 | does not provide legal services or legal advice. Distribution of
  7 | Creative Commons public licenses does not create a lawyer-client or
  8 | other relationship. Creative Commons makes its licenses and related
  9 | information available on an "as-is" basis. Creative Commons gives no
 10 | warranties regarding its licenses, any material licensed under their
 11 | terms and conditions, or any related information. Creative Commons
 12 | disclaims all liability for damages resulting from their use to the
 13 | fullest extent possible.
 14 | 
 15 | Using Creative Commons Public Licenses
 16 | 
 17 | Creative Commons public licenses provide a standard set of terms and
 18 | conditions that creators and other rights holders may use to share
 19 | original works of authorship and other material subject to copyright
 20 | and certain other rights specified in the public license below. The
 21 | following considerations are for informational purposes only, are not
 22 | exhaustive, and do not form part of our licenses.
 23 | 
 24 |      Considerations for licensors: Our public licenses are
 25 |      intended for use by those authorized to give the public
 26 |      permission to use material in ways otherwise restricted by
 27 |      copyright and certain other rights. Our licenses are
 28 |      irrevocable. Licensors should read and understand the terms
 29 |      and conditions of the license they choose before applying it.
 30 |      Licensors should also secure all rights necessary before
 31 |      applying our licenses so that the public can reuse the
 32 |      material as expected. Licensors should clearly mark any
 33 |      material not subject to the license. This includes other CC-
 34 |      licensed material, or material used under an exception or
 35 |      limitation to copyright. More considerations for licensors:
 36 | 	wiki.creativecommons.org/Considerations_for_licensors
 37 | 
 38 |      Considerations for the public: By using one of our public
 39 |      licenses, a licensor grants the public permission to use the
 40 |      licensed material under specified terms and conditions. If
 41 |      the licensor's permission is not necessary for any reason--for
 42 |      example, because of any applicable exception or limitation to
 43 |      copyright--then that use is not regulated by the license. Our
 44 |      licenses grant only permissions under copyright and certain
 45 |      other rights that a licensor has authority to grant. Use of
 46 |      the licensed material may still be restricted for other
 47 |      reasons, including because others have copyright or other
 48 |      rights in the material. A licensor may make special requests,
 49 |      such as asking that all changes be marked or described.
 50 |      Although not required by our licenses, you are encouraged to
 51 |      respect those requests where reasonable. More considerations
 52 |      for the public:
 53 | 	wiki.creativecommons.org/Considerations_for_licensees
 54 | 
 55 | =======================================================================
 56 | 
 57 | Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
 58 | Public License
 59 | 
 60 | By exercising the Licensed Rights (defined below), You accept and agree
 61 | to be bound by the terms and conditions of this Creative Commons
 62 | Attribution-NonCommercial-ShareAlike 4.0 International Public License
 63 | ("Public License"). To the extent this Public License may be
 64 | interpreted as a contract, You are granted the Licensed Rights in
 65 | consideration of Your acceptance of these terms and conditions, and the
 66 | Licensor grants You such rights in consideration of benefits the
 67 | Licensor receives from making the Licensed Material available under
 68 | these terms and conditions.
 69 | 
 70 | 
 71 | Section 1 -- Definitions.
 72 | 
 73 |   a. Adapted Material means material subject to Copyright and Similar
 74 |      Rights that is derived from or based upon the Licensed Material
 75 |      and in which the Licensed Material is translated, altered,
 76 |      arranged, transformed, or otherwise modified in a manner requiring
 77 |      permission under the Copyright and Similar Rights held by the
 78 |      Licensor. For purposes of this Public License, where the Licensed
 79 |      Material is a musical work, performance, or sound recording,
 80 |      Adapted Material is always produced where the Licensed Material is
 81 |      synched in timed relation with a moving image.
 82 | 
 83 |   b. Adapter's License means the license You apply to Your Copyright
 84 |      and Similar Rights in Your contributions to Adapted Material in
 85 |      accordance with the terms and conditions of this Public License.
 86 | 
 87 |   c. BY-NC-SA Compatible License means a license listed at
 88 |      creativecommons.org/compatiblelicenses, approved by Creative
 89 |      Commons as essentially the equivalent of this Public License.
 90 | 
 91 |   d. Copyright and Similar Rights means copyright and/or similar rights
 92 |      closely related to copyright including, without limitation,
 93 |      performance, broadcast, sound recording, and Sui Generis Database
 94 |      Rights, without regard to how the rights are labeled or
 95 |      categorized. For purposes of this Public License, the rights
 96 |      specified in Section 2(b)(1)-(2) are not Copyright and Similar
 97 |      Rights.
 98 | 
 99 |   e. Effective Technological Measures means those measures that, in the
100 |      absence of proper authority, may not be circumvented under laws
101 |      fulfilling obligations under Article 11 of the WIPO Copyright
102 |      Treaty adopted on December 20, 1996, and/or similar international
103 |      agreements.
104 | 
105 |   f. Exceptions and Limitations means fair use, fair dealing, and/or
106 |      any other exception or limitation to Copyright and Similar Rights
107 |      that applies to Your use of the Licensed Material.
108 | 
109 |   g. License Elements means the license attributes listed in the name
110 |      of a Creative Commons Public License. The License Elements of this
111 |      Public License are Attribution, NonCommercial, and ShareAlike.
112 | 
113 |   h. Licensed Material means the artistic or literary work, database,
114 |      or other material to which the Licensor applied this Public
115 |      License.
116 | 
117 |   i. Licensed Rights means the rights granted to You subject to the
118 |      terms and conditions of this Public License, which are limited to
119 |      all Copyright and Similar Rights that apply to Your use of the
120 |      Licensed Material and that the Licensor has authority to license.
121 | 
122 |   j. Licensor means the individual(s) or entity(ies) granting rights
123 |      under this Public License.
124 | 
125 |   k. NonCommercial means not primarily intended for or directed towards
126 |      commercial advantage or monetary compensation. For purposes of
127 |      this Public License, the exchange of the Licensed Material for
128 |      other material subject to Copyright and Similar Rights by digital
129 |      file-sharing or similar means is NonCommercial provided there is
130 |      no payment of monetary compensation in connection with the
131 |      exchange.
132 | 
133 |   l. Share means to provide material to the public by any means or
134 |      process that requires permission under the Licensed Rights, such
135 |      as reproduction, public display, public performance, distribution,
136 |      dissemination, communication, or importation, and to make material
137 |      available to the public including in ways that members of the
138 |      public may access the material from a place and at a time
139 |      individually chosen by them.
140 | 
141 |   m. Sui Generis Database Rights means rights other than copyright
142 |      resulting from Directive 96/9/EC of the European Parliament and of
143 |      the Council of 11 March 1996 on the legal protection of databases,
144 |      as amended and/or succeeded, as well as other essentially
145 |      equivalent rights anywhere in the world.
146 | 
147 |   n. You means the individual or entity exercising the Licensed Rights
148 |      under this Public License. Your has a corresponding meaning.
149 | 
150 | 
151 | Section 2 -- Scope.
152 | 
153 |   a. License grant.
154 | 
155 |        1. Subject to the terms and conditions of this Public License,
156 |           the Licensor hereby grants You a worldwide, royalty-free,
157 |           non-sublicensable, non-exclusive, irrevocable license to
158 |           exercise the Licensed Rights in the Licensed Material to:
159 | 
160 |             a. reproduce and Share the Licensed Material, in whole or
161 |                in part, for NonCommercial purposes only; and
162 | 
163 |             b. produce, reproduce, and Share Adapted Material for
164 |                NonCommercial purposes only.
165 | 
166 |        2. Exceptions and Limitations. For the avoidance of doubt, where
167 |           Exceptions and Limitations apply to Your use, this Public
168 |           License does not apply, and You do not need to comply with
169 |           its terms and conditions.
170 | 
171 |        3. Term. The term of this Public License is specified in Section
172 |           6(a).
173 | 
174 |        4. Media and formats; technical modifications allowed. The
175 |           Licensor authorizes You to exercise the Licensed Rights in
176 |           all media and formats whether now known or hereafter created,
177 |           and to make technical modifications necessary to do so. The
178 |           Licensor waives and/or agrees not to assert any right or
179 |           authority to forbid You from making technical modifications
180 |           necessary to exercise the Licensed Rights, including
181 |           technical modifications necessary to circumvent Effective
182 |           Technological Measures. For purposes of this Public License,
183 |           simply making modifications authorized by this Section 2(a)
184 |           (4) never produces Adapted Material.
185 | 
186 |        5. Downstream recipients.
187 | 
188 |             a. Offer from the Licensor -- Licensed Material. Every
189 |                recipient of the Licensed Material automatically
190 |                receives an offer from the Licensor to exercise the
191 |                Licensed Rights under the terms and conditions of this
192 |                Public License.
193 | 
194 |             b. Additional offer from the Licensor -- Adapted Material.
195 |                Every recipient of Adapted Material from You
196 |                automatically receives an offer from the Licensor to
197 |                exercise the Licensed Rights in the Adapted Material
198 |                under the conditions of the Adapter's License You apply.
199 | 
200 |             c. No downstream restrictions. You may not offer or impose
201 |                any additional or different terms or conditions on, or
202 |                apply any Effective Technological Measures to, the
203 |                Licensed Material if doing so restricts exercise of the
204 |                Licensed Rights by any recipient of the Licensed
205 |                Material.
206 | 
207 |        6. No endorsement. Nothing in this Public License constitutes or
208 |           may be construed as permission to assert or imply that You
209 |           are, or that Your use of the Licensed Material is, connected
210 |           with, or sponsored, endorsed, or granted official status by,
211 |           the Licensor or others designated to receive attribution as
212 |           provided in Section 3(a)(1)(A)(i).
213 | 
214 |   b. Other rights.
215 | 
216 |        1. Moral rights, such as the right of integrity, are not
217 |           licensed under this Public License, nor are publicity,
218 |           privacy, and/or other similar personality rights; however, to
219 |           the extent possible, the Licensor waives and/or agrees not to
220 |           assert any such rights held by the Licensor to the limited
221 |           extent necessary to allow You to exercise the Licensed
222 |           Rights, but not otherwise.
223 | 
224 |        2. Patent and trademark rights are not licensed under this
225 |           Public License.
226 | 
227 |        3. To the extent possible, the Licensor waives any right to
228 |           collect royalties from You for the exercise of the Licensed
229 |           Rights, whether directly or through a collecting society
230 |           under any voluntary or waivable statutory or compulsory
231 |           licensing scheme. In all other cases the Licensor expressly
232 |           reserves any right to collect such royalties, including when
233 |           the Licensed Material is used other than for NonCommercial
234 |           purposes.
235 | 
236 | 
237 | Section 3 -- License Conditions.
238 | 
239 | Your exercise of the Licensed Rights is expressly made subject to the
240 | following conditions.
241 | 
242 |   a. Attribution.
243 | 
244 |        1. If You Share the Licensed Material (including in modified
245 |           form), You must:
246 | 
247 |             a. retain the following if it is supplied by the Licensor
248 |                with the Licensed Material:
249 | 
250 |                  i. identification of the creator(s) of the Licensed
251 |                     Material and any others designated to receive
252 |                     attribution, in any reasonable manner requested by
253 |                     the Licensor (including by pseudonym if
254 |                     designated);
255 | 
256 |                 ii. a copyright notice;
257 | 
258 |                iii. a notice that refers to this Public License;
259 | 
260 |                 iv. a notice that refers to the disclaimer of
261 |                     warranties;
262 | 
263 |                  v. a URI or hyperlink to the Licensed Material to the
264 |                     extent reasonably practicable;
265 | 
266 |             b. indicate if You modified the Licensed Material and
267 |                retain an indication of any previous modifications; and
268 | 
269 |             c. indicate the Licensed Material is licensed under this
270 |                Public License, and include the text of, or the URI or
271 |                hyperlink to, this Public License.
272 | 
273 |        2. You may satisfy the conditions in Section 3(a)(1) in any
274 |           reasonable manner based on the medium, means, and context in
275 |           which You Share the Licensed Material. For example, it may be
276 |           reasonable to satisfy the conditions by providing a URI or
277 |           hyperlink to a resource that includes the required
278 |           information.
279 |        3. If requested by the Licensor, You must remove any of the
280 |           information required by Section 3(a)(1)(A) to the extent
281 |           reasonably practicable.
282 | 
283 |   b. ShareAlike.
284 | 
285 |      In addition to the conditions in Section 3(a), if You Share
286 |      Adapted Material You produce, the following conditions also apply.
287 | 
288 |        1. The Adapter's License You apply must be a Creative Commons
289 |           license with the same License Elements, this version or
290 |           later, or a BY-NC-SA Compatible License.
291 | 
292 |        2. You must include the text of, or the URI or hyperlink to, the
293 |           Adapter's License You apply. You may satisfy this condition
294 |           in any reasonable manner based on the medium, means, and
295 |           context in which You Share Adapted Material.
296 | 
297 |        3. You may not offer or impose any additional or different terms
298 |           or conditions on, or apply any Effective Technological
299 |           Measures to, Adapted Material that restrict exercise of the
300 |           rights granted under the Adapter's License You apply.
301 | 
302 | 
303 | Section 4 -- Sui Generis Database Rights.
304 | 
305 | Where the Licensed Rights include Sui Generis Database Rights that
306 | apply to Your use of the Licensed Material:
307 | 
308 |   a. for the avoidance of doubt, Section 2(a)(1) grants You the right
309 |      to extract, reuse, reproduce, and Share all or a substantial
310 |      portion of the contents of the database for NonCommercial purposes
311 |      only;
312 | 
313 |   b. if You include all or a substantial portion of the database
314 |      contents in a database in which You have Sui Generis Database
315 |      Rights, then the database in which You have Sui Generis Database
316 |      Rights (but not its individual contents) is Adapted Material,
317 |      including for purposes of Section 3(b); and
318 | 
319 |   c. You must comply with the conditions in Section 3(a) if You Share
320 |      all or a substantial portion of the contents of the database.
321 | 
322 | For the avoidance of doubt, this Section 4 supplements and does not
323 | replace Your obligations under this Public License where the Licensed
324 | Rights include other Copyright and Similar Rights.
325 | 
326 | 
327 | Section 5 -- Disclaimer of Warranties and Limitation of Liability.
328 | 
329 |   a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
330 |      EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
331 |      AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
332 |      ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
333 |      IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
334 |      WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
335 |      PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
336 |      ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
337 |      KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
338 |      ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
339 | 
340 |   b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
341 |      TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
342 |      NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
343 |      INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
344 |      COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
345 |      USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
346 |      ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
347 |      DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
348 |      IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
349 | 
350 |   c. The disclaimer of warranties and limitation of liability provided
351 |      above shall be interpreted in a manner that, to the extent
352 |      possible, most closely approximates an absolute disclaimer and
353 |      waiver of all liability.
354 | 
355 | 
356 | Section 6 -- Term and Termination.
357 | 
358 |   a. This Public License applies for the term of the Copyright and
359 |      Similar Rights licensed here. However, if You fail to comply with
360 |      this Public License, then Your rights under this Public License
361 |      terminate automatically.
362 | 
363 |   b. Where Your right to use the Licensed Material has terminated under
364 |      Section 6(a), it reinstates:
365 | 
366 |        1. automatically as of the date the violation is cured, provided
367 |           it is cured within 30 days of Your discovery of the
368 |           violation; or
369 | 
370 |        2. upon express reinstatement by the Licensor.
371 | 
372 |      For the avoidance of doubt, this Section 6(b) does not affect any
373 |      right the Licensor may have to seek remedies for Your violations
374 |      of this Public License.
375 | 
376 |   c. For the avoidance of doubt, the Licensor may also offer the
377 |      Licensed Material under separate terms or conditions or stop
378 |      distributing the Licensed Material at any time; however, doing so
379 |      will not terminate this Public License.
380 | 
381 |   d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
382 |      License.
383 | 
384 | 
385 | Section 7 -- Other Terms and Conditions.
386 | 
387 |   a. The Licensor shall not be bound by any additional or different
388 |      terms or conditions communicated by You unless expressly agreed.
389 | 
390 |   b. Any arrangements, understandings, or agreements regarding the
391 |      Licensed Material not stated herein are separate from and
392 |      independent of the terms and conditions of this Public License.
393 | 
394 | 
395 | Section 8 -- Interpretation.
396 | 
397 |   a. For the avoidance of doubt, this Public License does not, and
398 |      shall not be interpreted to, reduce, limit, restrict, or impose
399 |      conditions on any use of the Licensed Material that could lawfully
400 |      be made without permission under this Public License.
401 | 
402 |   b. To the extent possible, if any provision of this Public License is
403 |      deemed unenforceable, it shall be automatically reformed to the
404 |      minimum extent necessary to make it enforceable. If the provision
405 |      cannot be reformed, it shall be severed from this Public License
406 |      without affecting the enforceability of the remaining terms and
407 |      conditions.
408 | 
409 |   c. No term or condition of this Public License will be waived and no
410 |      failure to comply consented to unless expressly agreed to by the
411 |      Licensor.
412 | 
413 |   d. Nothing in this Public License constitutes or may be interpreted
414 |      as a limitation upon, or waiver of, any privileges and immunities
415 |      that apply to the Licensor or You, including from the legal
416 |      processes of any jurisdiction or authority.
417 | 
418 | =======================================================================
419 | 
420 | Creative Commons is not a party to its public
421 | licenses. Notwithstanding, Creative Commons may elect to apply one of
422 | its public licenses to material it publishes and in those instances
423 | will be considered the “Licensor.” The text of the Creative Commons
424 | public licenses is dedicated to the public domain under the CC0 Public
425 | Domain Dedication. Except for the limited purpose of indicating that
426 | material is shared under a Creative Commons public license or as
427 | otherwise permitted by the Creative Commons policies published at
428 | creativecommons.org/policies, Creative Commons does not authorize the
429 | use of the trademark "Creative Commons" or any other trademark or logo
430 | of Creative Commons without its prior written consent including,
431 | without limitation, in connection with any unauthorized modifications
432 | to any of its public licenses or any other arrangements,
433 | understandings, or agreements concerning use of licensed material. For
434 | the avoidance of doubt, this paragraph does not form part of the
435 | public licenses.
436 | 
437 | Creative Commons may be contacted at creativecommons.org.
438 | 


--------------------------------------------------------------------------------