Merge pull request #742 from cheat/dependabot/go_modules/github.com/cloudflare/circl-1.3.7

chore(deps): bump github.com/cloudflare/circl from 1.3.6 to 1.3.7

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Submit a bug report
+title: ''
+labels: 'bug'
+assignees: ''
+
+---
+
+Thanks for submitting a bug report. Please provide the following information:
+
+**A description of the problem**
+Describe the problem here.
+
+**cheat version info**
+Please paste the output of `cheat -v` here.
+
+**cheat configuration info**
+If your bug pertains to how cheatsheets are loaded and/or displayed, please
+paste here the following information:
+
+1. The output of `cheat -d`
+2. The contents of your `conf.yml` file

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: 'enhancement'
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+- package-ecosystem: gomod
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10
+  ignore:
+  - dependency-name: github.com/alecthomas/chroma
+    versions:
+    - 0.9.1

.github/workflows/build.yml

@@ -0,0 +1,46 @@
+---
+name: Go
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  # TODO: is it possible to DRY out these jobs? Aside from `runs-on`, they are
+  # identical.
+  # See: https://github.com/actions/runner/issues/1182
+  build-linux:
+    runs-on: [ubuntu-latest]
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: 1.19
+      - name: Set up Revive (linter)
+        run: go get -u github.com/boyter/scc github.com/mgechev/revive
+        env:
+          GO111MODULE: "off"
+      - name: Build
+        run: make build
+      - name: Test
+        run: make test
+
+  build-osx:
+    runs-on: [macos-latest]
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: 1.19
+      - name: Set up Revive (linter)
+        run: go get -u github.com/boyter/scc github.com/mgechev/revive
+        env:
+          GO111MODULE: "off"
+      - name: Build
+        run: make build
+      - name: Test
+        run: make test

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,30 @@
+---
+name: CodeQL
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  schedule:
+    - cron: '45 23 * * 0'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [go]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v1
+        with:
+          languages: ${{ matrix.language }}
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v1
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v1

.github/workflows/homebrew.yml

@@ -0,0 +1,19 @@
+---
+name: homebrew
+
+on:
+  push:
+    tags: '*'
+
+jobs:
+  homebrew:
+    name: Bump Homebrew formula
+    runs-on: ubuntu-latest
+    steps:
+      - uses: mislav/bump-homebrew-formula-action@v1
+        with:
+          # A PR will be sent to github.com/Homebrew/homebrew-core to update
+          # this formula:
+          formula-name: cheat
+        env:
+          COMMITTER_TOKEN: ${{ secrets.COMMITTER_TOKEN }}

.gitignore

@@ -1,6 +1,2 @@
-*.pyc
-.env
-MANIFEST
-build
-cheat.egg-info
 dist
+tags

CONTRIBUTING.md

@@ -1,29 +1,48 @@
-Contributing
+CONTRIBUTING
 ============
-If you would like to contribute cheetsheets or program functionality, please
-fork this repository, make your changes, and submit a pull request against the
-`master` branch.
+Do you want to contribute to `cheat`? There are a few ways to help:
+
+#### Submit a cheatsheet ####
+Do you have a witty bash one-liner to share? [Open a pull-request][pr] against
+the [cheatsheets][] repository. (The `cheat` executable source code lives in
+[cheat/cheat][cheat]. Cheatsheet content lives in
+[cheat/cheatsheets][cheatsheets].)
+
+#### Report a bug ####
+Did you find a bug? Report it in the [issue tracker][issues]. (But before you
+do, please look through the open issues to make sure that it hasn't already
+ been reported.)
+
+#### Add a feature ####
+Do you have a feature that you'd like to contribute? Propose it in the [issue
+tracker][issues] to discuss with the maintainer whether it would be considered
+for merging.
+
+`cheat` is mostly mature and feature-complete, but may still have some room for
+new features. See [HACKING.md][hacking] for a quick-start guide to `cheat`
+development.
+
+#### Add documentation ####
+Did you encounter features, bugs, edge-cases, use-cases, or environment
+considerations that were undocumented or under-documented? Add them to the
+[wiki][]. (You may also open a pull-request against the `README`, if
+appropriate.)
+
+Do you enjoy technical writing or proofreading? Help keep the documentation
+error-free and well-organized.
+
+#### Spread the word ####
+Are you unable to do the above, but still want to contribute? You can help
+`cheat` simply by telling others about it. Share it with friends and coworkers
+that might benefit from using it.
+
+#### Pull Requests ####
+Please open all pull-requests against the `develop` branch.
 
 
-## Python standards ##
-Python code should conform to [PEP 8][].
-
-
-## Cheatsheet Format ##
-Please pattern your cheatsheets after the following:
-
-```sh
-# To extract an uncompressed archive:
-tar -xvf /path/to/foo.tar
-
-# To create an uncompressed archive:
-tar -cvf /path/to/foo.tar /path/to/foo/
-
-# To extract a .gz archive:
-tar -xzvf /path/to/foo.tgz
-```
-
-If you are submitting a cheatsheet that contains side-by-side columns of text,
-please align the columns using spaces rather than tabs.
-
-[PEP 8]: http://legacy.python.org/dev/peps/pep-0008/ 
+[cheat]: https://github.com/cheat/cheat
+[cheatsheets]: https://github.com/cheat/cheatsheets
+[hacking]: HACKING.md
+[issues]: https://github.com/cheat/cheat/issues 
+[pr]: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork
+[wiki]: https://github.com/cheat/cheat/wiki

Dockerfile

@@ -0,0 +1,8 @@
+# NB: this image isn't used anywhere in the build pipeline. It exists to
+# conveniently facilitate ad-hoc experimentation in a sandboxed environment
+# during development.
+FROM golang:1.15-alpine
+
+RUN apk add git less make
+
+WORKDIR /app

HACKING.md

@@ -0,0 +1,57 @@
+Hacking
+=======
+The following is a quickstart guide for developing `cheat`.
+
+## 1. Install system dependencies
+Before you begin, you must install a handful of system dependencies. The
+following are required, and must be available on your `PATH`:
+
+- `git`
+- `go` (>= 1.17 is recommended)
+- `make`
+
+The following dependencies are optional:
+- `docker`
+- `pandoc` (necessary to generate a `man` page)
+
+## 2. Install utility applications
+Run `make setup` to install `scc` and `revive`, which are used by various
+`make` targets.
+
+## 3. Development workflow
+After your environment has been configured, your development workflow will
+resemble the following:
+
+1. Make changes to the `cheat` source code.
+2. Run `make test` to run unit-tests.
+3. Fix compiler errors and failing tests as necessary.
+4. Run `make`. A `cheat` executable will be written to the `dist` directory.
+5. Use the new executable by running `dist/cheat <command>`.
+6. Run `make install` to install `cheat` to your `PATH`.
+7. Run `make build-release` to build cross-platform binaries in `dist`.
+8. Run `make clean` to clean the `dist` directory when desired.
+
+You may run `make help` to see a list of available `make` commands.
+
+### Developing with docker
+It may be useful to test your changes within a pristine environment. An
+Alpine-based docker container has been provided for that purpose.
+
+If you would like to build the docker container, run:
+```sh
+make docker-setup
+```
+
+To shell into the container, run:
+```sh
+make docker-sh
+```
+
+The `cheat` source code will be mounted at `/app` within the container.
+
+If you would like to destroy this container, you may run:
+```sh
+make distclean
+```
+
+[go]: https://go.dev/

INSTALLING.md

@@ -0,0 +1,79 @@
+Installing
+==========
+`cheat` has no runtime dependencies. As such, installing it is generally
+straightforward. There are a few methods available:
+
+### Install manually
+#### Unix-like
+On Unix-like systems, you may simply paste the following snippet into your terminal:
+
+```sh
+cd /tmp \
+  && wget https://github.com/cheat/cheat/releases/download/4.4.2/cheat-linux-amd64.gz \
+  && gunzip cheat-linux-amd64.gz \
+  && chmod +x cheat-linux-amd64 \
+  && sudo mv cheat-linux-amd64 /usr/local/bin/cheat
+```
+
+You may need to need to change the version number (`4.4.2`) and the archive
+(`cheat-linux-amd64.gz`) depending on your platform.
+
+See the [releases page][releases] for a list of supported platforms.
+
+#### Windows
+TODO: community support is requested here. Please open a PR if you'd like to
+contribute installation instructions for Windows.
+
+### Install via `go install`
+If you have `go` version `>=1.17` available on your `PATH`, you can install
+`cheat` via `go install`:
+
+```sh
+go install github.com/cheat/cheat/cmd/cheat@latest
+```
+
+### Install via package manager
+Several community-maintained packages are also available:
+
+Package manager  | Package(s)
+---------------- | -----------
+aur              | [cheat][pkg-aur-cheat], [cheat-bin][pkg-aur-cheat-bin]
+brew             | [cheat][pkg-brew]
+docker           | [docker-cheat][pkg-docker]
+nix              | [nixos.cheat][pkg-nix]
+snap             | [cheat][pkg-snap]
+
+<!--[pacman][]       |-->
+
+## Configuring
+Three things must be done before you can use `cheat`:
+1. A config file must be generated
+2. [`cheatpaths`][cheatpaths] must be configured
+3. [Community cheatsheets][community] must be downloaded
+
+On first run, `cheat` will run an installer that will do all of the above
+automatically. After the installer is complete, it is strongly advised that you
+view the configuration file that was generated, as you may want to change some
+of its default values (to enable colorization, change the paginator, etc).
+
+### conf.yml ###
+`cheat` is configured by a YAML file that will be auto-generated on first run.
+
+By default, the config file is assumed to exist on an XDG-compliant
+configuration path like `~/.config/cheat/conf.yml`. If you would like to store
+it elsewhere, you may export a `CHEAT_CONFIG_PATH` environment variable that
+specifies its path:
+
+```sh
+export CHEAT_CONFIG_PATH="~/.dotfiles/cheat/conf.yml"
+```
+
+[cheatpaths]:        README.md#cheatpaths
+[community]:         https://github.com/cheat/cheatsheets/
+[pkg-aur-cheat-bin]: https://aur.archlinux.org/packages/cheat-bin
+[pkg-aur-cheat]:     https://aur.archlinux.org/packages/cheat
+[pkg-brew]:          https://formulae.brew.sh/formula/cheat 
+[pkg-docker]:        https://github.com/bannmann/docker-cheat
+[pkg-nix]:           https://search.nixos.org/packages?channel=unstable&show=cheat&from=0&size=50&sort=relevance&type=packages&query=cheat 
+[pkg-snap]:          https://snapcraft.io/cheat
+[releases]:          https://github.com/cheat/cheat/releases

LICENSE

@@ -1,2 +0,0 @@
-This program is dual-licensed under the MIT and GPL3 licenses. See the licenses
-directory for the license text in full.

LICENSE.txt

@@ -1,4 +1,4 @@
-The MIT License (MIT) Copyright (c) 2016 Chris Allen Lane
+Copyright 2013 Christopher Allen Lane
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

MANIFEST.in

@@ -1,6 +0,0 @@
-include CHANGELOG
-include CONTRIBUTING.md
-include LICENSE
-include README.md
-include licenses/gpl-3.txt
-include licenses/mit.txt

Makefile

@@ -0,0 +1,218 @@
+# paths
+makefile := $(realpath $(lastword $(MAKEFILE_LIST)))
+cmd_dir  := ./cmd/cheat
+dist_dir := ./dist
+
+# executables
+CAT    := cat
+COLUMN := column
+CTAGS  := ctags
+DOCKER := docker
+GO     := go
+GREP   := grep
+GZIP   := gzip --best
+LINT   := revive
+MAN    := man
+MKDIR  := mkdir -p
+PANDOC := pandoc
+RM     := rm
+SCC    := scc
+SED    := sed
+SORT   := sort
+ZIP    := zip -m
+
+docker_image := cheat-devel:latest
+
+# build flags
+BUILD_FLAGS  := -ldflags="-s -w" -mod vendor -trimpath
+GOBIN        :=
+TMPDIR       := /tmp
+
+# release binaries
+releases :=                        \
+	$(dist_dir)/cheat-darwin-amd64 \
+	$(dist_dir)/cheat-linux-386    \
+	$(dist_dir)/cheat-linux-amd64  \
+	$(dist_dir)/cheat-linux-arm5   \
+	$(dist_dir)/cheat-linux-arm6   \
+	$(dist_dir)/cheat-linux-arm64  \
+	$(dist_dir)/cheat-linux-arm7   \
+	$(dist_dir)/cheat-netbsd-amd64  \
+	$(dist_dir)/cheat-openbsd-amd64  \
+	$(dist_dir)/cheat-solaris-amd64  \
+	$(dist_dir)/cheat-windows-amd64.exe
+
+## build: build an executable for your architecture
+.PHONY: build
+build: | clean $(dist_dir) generate fmt lint vet vendor man
+	$(GO) build $(BUILD_FLAGS) -o $(dist_dir)/cheat $(cmd_dir)
+
+## build-release: build release executables
+.PHONY: build-release
+build-release: $(releases)
+
+# cheat-darwin-amd64
+$(dist_dir)/cheat-darwin-amd64: prepare
+	GOARCH=amd64 GOOS=darwin \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-linux-386
+$(dist_dir)/cheat-linux-386: prepare
+	GOARCH=386 GOOS=linux \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-linux-amd64
+$(dist_dir)/cheat-linux-amd64: prepare
+	GOARCH=amd64 GOOS=linux \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-linux-arm5
+$(dist_dir)/cheat-linux-arm5: prepare
+	GOARCH=arm GOOS=linux GOARM=5 \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-linux-arm6
+$(dist_dir)/cheat-linux-arm6: prepare
+	GOARCH=arm GOOS=linux GOARM=6 \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-linux-arm7
+$(dist_dir)/cheat-linux-arm7: prepare
+	GOARCH=arm GOOS=linux GOARM=7 \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+	
+# cheat-linux-arm64
+$(dist_dir)/cheat-linux-arm64: prepare
+	GOARCH=arm64 GOOS=linux \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-netbsd-amd64
+$(dist_dir)/cheat-netbsd-amd64: prepare
+	GOARCH=amd64 GOOS=netbsd \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-openbsd-amd64
+$(dist_dir)/cheat-openbsd-amd64: prepare
+	GOARCH=amd64 GOOS=openbsd \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-plan9-amd64
+$(dist_dir)/cheat-plan9-amd64: prepare
+	GOARCH=amd64 GOOS=plan9 \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-solaris-amd64
+$(dist_dir)/cheat-solaris-amd64: prepare
+	GOARCH=amd64 GOOS=solaris \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(GZIP) $@ && chmod -x $@.gz
+
+# cheat-windows-amd64
+$(dist_dir)/cheat-windows-amd64.exe: prepare
+	GOARCH=amd64 GOOS=windows \
+	$(GO) build $(BUILD_FLAGS) -o $@ $(cmd_dir) && $(ZIP) $@.zip $@ -j
+
+# ./dist
+$(dist_dir):
+	$(MKDIR) $(dist_dir)
+
+.PHONY: generate
+generate:
+	$(GO) generate $(cmd_dir)
+
+## install: build and install cheat on your PATH
+.PHONY: install
+install: build
+	$(GO) install $(BUILD_FLAGS) $(GOBIN) $(cmd_dir) 
+
+## clean: remove compiled executables
+.PHONY: clean
+clean:
+	$(RM) -f $(dist_dir)/* $(cmd_dir)/str_config.go $(cmd_dir)/str_usage.go
+
+## distclean: remove the tags file
+.PHONY: distclean
+distclean:
+	$(RM) -f tags
+	@$(DOCKER) image rm -f $(docker_image)
+
+## setup: install revive (linter) and scc (sloc tool)
+.PHONY: setup
+setup:
+	GO111MODULE=off $(GO) get -u github.com/boyter/scc github.com/mgechev/revive
+
+## sloc: count "semantic lines of code"
+.PHONY: sloc
+sloc:
+	$(SCC) --exclude-dir=vendor
+
+## tags: build a tags file
+.PHONY: tags
+tags:
+	$(CTAGS) -R --exclude=vendor --languages=go
+
+## man: build a man page
+# NB: pandoc may not be installed, so we're ignoring this error on failure
+.PHONY: man
+man:
+	-$(PANDOC) -s -t man doc/cheat.1.md -o doc/cheat.1
+
+## vendor: download, tidy, and verify dependencies
+.PHONY: vendor
+vendor:
+	$(GO) mod vendor && $(GO) mod tidy && $(GO) mod verify
+
+## vendor-update: update vendored dependencies
+vendor-update:
+	$(GO) get -t -u ./... && $(GO) mod vendor && $(GO) mod tidy && $(GO) mod verify
+
+## fmt: run go fmt
+.PHONY: fmt
+fmt:
+	$(GO) fmt ./...
+
+## lint: lint go source files
+.PHONY: lint
+lint: vendor
+	$(LINT) -exclude vendor/... ./...
+
+## vet: vet go source files
+.PHONY: vet
+vet:
+	$(GO) vet ./...
+
+## test: run unit-tests
+.PHONY: test
+test: 
+	$(GO) test ./...
+
+## coverage: generate a test coverage report
+.PHONY: coverage
+coverage:
+	$(GO) test ./... -coverprofile=$(TMPDIR)/cheat-coverage.out && \
+	$(GO) tool cover -html=$(TMPDIR)/cheat-coverage.out
+
+## check: format, lint, vet, vendor, and run unit-tests
+.PHONY: check
+check: | vendor fmt lint vet test
+
+.PHONY: prepare
+prepare: | clean $(dist_dir) generate vendor fmt lint vet test
+
+## docker-setup: create a docker image for use during development
+.PHONY: docker-setup
+docker-setup:
+	$(DOCKER) build  -t $(docker_image) -f Dockerfile .
+
+## docker-sh: shell into the docker development container
+.PHONY: docker-sh
+docker-sh:
+	$(DOCKER) run -v $(shell pwd):/app -ti $(docker_image) /bin/ash
+
+## help: display this help text
+.PHONY: help
+help:
+	@$(CAT) $(makefile) | \
+	$(SORT)             | \
+	$(GREP) "^##"       | \
+	$(SED) 's/## //g'   | \
+	$(COLUMN) -t -s ':'

README.md

@@ -1,7 +1,9 @@
-[![PyPI](https://img.shields.io/pypi/v/cheat.svg)](https://pypi.python.org/pypi/cheat/)
+![Workflow status](https://github.com/cheat/cheat/actions/workflows/build.yml/badge.svg)
+
 
 cheat
 =====
+
 `cheat` allows you to create and view interactive cheatsheets on the
 command-line. It was designed to help remind \*nix system administrators of
 options for commands that they use frequently, but not frequently enough to
@@ -9,6 +11,8 @@ remember.
 
 ![The obligatory xkcd](http://imgs.xkcd.com/comics/tar.png 'The obligatory xkcd')
 
+Use `cheat` with [cheatsheets][].
+
 
 Example
 -------
@@ -19,10 +23,10 @@ Google, you may run:
 cheat tar
 ```
 
-You will be presented with a cheatsheet resembling:
+You will be presented with a cheatsheet resembling the following:
 
 ```sh
-# To extract an uncompressed archive: 
+# To extract an uncompressed archive:
 tar -xvf '/path/to/foo.tar'
 
 # To extract a .gz archive:
@@ -38,132 +42,152 @@ tar -xjvf '/path/to/foo.tgz'
 tar -cjvf '/path/to/foo.tgz' '/path/to/foo/'
 ```
 
-To see what cheatsheets are available, run `cheat -l`.
+Usage
+-----
+To view a cheatsheet:
+
+```sh
+cheat tar      # a "top-level" cheatsheet
+cheat foo/bar  # a "nested" cheatsheet
+```
+
+To edit a cheatsheet:
+
+```sh
+cheat -e tar     # opens the "tar" cheatsheet for editing, or creates it if it does not exist
+cheat -e foo/bar # nested cheatsheets are accessed like this
+```
+
+To view the configured cheatpaths:
+
+```sh
+cheat -d
+```
+
+To list all available cheatsheets:
+
+```sh
+cheat -l
+```
+
+To list all cheatsheets that are tagged with "networking":
+
+```sh
+cheat -l -t networking
+```
+
+To list all cheatsheets on the "personal" path:
+
+```sh
+cheat -l -p personal
+```
+
+To search for the phrase "ssh" among cheatsheets:
+
+```sh
+cheat -s ssh
+```
+
+To search (by regex) for cheatsheets that contain an IP address:
+
+```sh
+cheat -r -s '(?:[0-9]{1,3}\.){3}[0-9]{1,3}'
+```
+
+Flags may be combined in intuitive ways. Example: to search sheets on the
+"personal" cheatpath that are tagged with "networking" and match a regex:
+
+```sh
+cheat -p personal -t networking --regex -s '(?:[0-9]{1,3}\.){3}[0-9]{1,3}'
+```
 
-Note that, while `cheat` was designed primarily for \*nix system administrators,
-it is agnostic as to what content it stores. If you would like to use `cheat`
-to store notes on your favorite cookie recipes, feel free.
 
 
 Installing
 ----------
-It is recommended to install `cheat` with `pip`:
+For installation and configuration instructions, see [INSTALLING.md][].
 
-```sh
-[sudo] pip install cheat
-```
-
-[Other installation methods are available][installing].
-
-
-Modifying Cheatsheets
----------------------
-The value of `cheat` is that it allows you to create your own cheatsheets - the
-defaults are meant to serve only as a starting point, and can and should be
-modified.
-
-Cheatsheets are stored in the `~/.cheat/` directory, and are named on a
-per-keyphrase basis. In other words, the content for the `tar` cheatsheet lives
-in the `~/.cheat/tar` file.
-
-Provided that you have a `CHEAT_EDITOR`, `VISUAL`, or `EDITOR` environment
-variable set, you may edit cheatsheets with:
-
-```sh
-cheat -e foo
-```
-
-If the `foo` cheatsheet already exists, it will be opened for editing.
-Otherwise, it will be created automatically.
-
-After you've customized your cheatsheets, I urge you to track `~/.cheat/` along
-with your [dotfiles][].
-
-
-Configuring
+Cheatsheets
 -----------
-
-### Setting a DEFAULT_CHEAT_DIR ###
-Personal cheatsheets are saved in the `~/.cheat` directory by default, but you
-can specify a different default by exporting a `DEFAULT_CHEAT_DIR` environment
-variable:
+Cheatsheets are plain-text files with no file extension, and are named
+according to the command used to view them:
 
 ```sh
-export DEFAULT_CHEAT_DIR='/path/to/my/cheats'
+cheat tar     # file is named "tar"
+cheat foo/bar # file is named "bar", in a "foo" subdirectory
 ```
 
-### Setting a CHEATPATH ###
-You can additionally instruct `cheat` to look for cheatsheets in other
-directories by exporting a `CHEATPATH` environment variable:
+Cheatsheet text may optionally be preceeded by a YAML frontmatter header that
+assigns tags and specifies syntax:
 
-```sh
-export CHEATPATH='/path/to/my/cheats'
+```
+---
+syntax: javascript
+tags: [ array, map ]
+---
+// To map over an array:
+const squares = [1, 2, 3, 4].map(x => x * x);
 ```
 
-You may, of course, append multiple directories to your `CHEATPATH`:
+The `cheat` executable includes no cheatsheets, but [community-sourced
+cheatsheets are available][cheatsheets]. You will be asked if you would like to
+install the community-sourced cheatsheets the first time you run `cheat`.
 
-```sh
-export CHEATPATH="$CHEATPATH:/path/to/more/cheats"
+Cheatpaths
+----------
+Cheatsheets are stored on "cheatpaths", which are directories that contain
+cheatsheets. Cheatpaths are specified in the `conf.yml` file.
+
+It can be useful to configure `cheat` against multiple cheatpaths. A common
+pattern is to store cheatsheets from multiple repositories on individual
+cheatpaths:
+
+```yaml
+# conf.yml:
+# ...
+cheatpaths:
+  - name: community                   # a name for the cheatpath
+    path: ~/documents/cheat/community # the path's location on the filesystem
+    tags: [ community ]               # these tags will be applied to all sheets on the path
+    readonly: true                    # if true, `cheat` will not create new cheatsheets here
+
+  - name: personal
+    path: ~/documents/cheat/personal  # this is a separate directory and repository than above
+    tags: [ personal ]
+    readonly: false                   # new sheets may be written here
+# ...
 ```
 
-You may view which directories are on your `CHEATPATH` with `cheat -d`.
+The `readonly` option instructs `cheat` not to edit (or create) any cheatsheets
+on the path. This is useful to prevent merge-conflicts from arising on upstream
+cheatsheet repositories.
 
-### Enabling Syntax Highlighting ###
-`cheat` can optionally apply syntax highlighting to your cheatsheets. To
-enable syntax highlighting, export a `CHEATCOLORS` environment variable:
+If a user attempts to edit a cheatsheet on a read-only cheatpath, `cheat` will
+transparently copy that sheet to a writeable directory before opening it for
+editing.
 
-```sh
-export CHEATCOLORS=true
-```
+### Directory-scoped Cheatpaths ###
+At times, it can be useful to closely associate cheatsheets with a directory on
+your filesystem. `cheat` facilitates this by searching for a `.cheat` folder in
+the current working directory. If found, the `.cheat` directory will
+(temporarily) be added to the cheatpaths.
 
-Note that [pygments][] must be installed on your system for this to work.
+Autocompletion
+--------------
+Shell autocompletion is currently available for `bash`, `fish`, and `zsh`. Copy
+the relevant [completion script][completions] into the appropriate directory on
+your filesystem to enable autocompletion. (This directory will vary depending
+on operating system and shell specifics.)
 
+Additionally, `cheat` supports enhanced autocompletion via integration with
+[fzf][]. To enable `fzf` integration:
 
-#### Specifying a Syntax Highlighter ####
-You may manually specify which syntax highlighter to use for each cheatsheet by
-wrapping the sheet's contents in a [Github-Flavored Markdown code-fence][gfm].
+1. Ensure that `fzf` is available on your `$PATH`
+2. Set an envvar: `export CHEAT_USE_FZF=true`
 
-Example:
-
-<pre>
-```sql
--- to select a user by ID
-SELECT *
-FROM Users
-WHERE id = 100
-```
-</pre>
-
-If no syntax highlighter is specified, the `bash` highlighter will be used by
-default.
-
-### Enabling Search Match Highlighting ###
-`cheat` can optionally be configured to highlight search term matches in search
-results. To do so, export a `CHEAT_HIGHLIGHT` environment variable with a value
-of one of the following:
-
-- blue
-- cyan
-- green
-- grey
-- magenta
-- red
-- white
-- yellow
-
-Note that the `termcolor` module must be installed on your system for this to
-work.
-
-
-See Also:
----------
-- [Enabling Command-line Autocompletion][autocompletion]
-- [Related Projects][related-projects]
-
-
-[autocompletion]:   https://github.com/chrisallenlane/cheat/wiki/Enabling-Command-line-Autocompletion
-[dotfiles]:         http://dotfiles.github.io/
-[gfm]:              https://help.github.com/articles/creating-and-highlighting-code-blocks/
-[installing]:       https://github.com/chrisallenlane/cheat/wiki/Installing
-[pygments]:         http://pygments.org/
-[related-projects]: https://github.com/chrisallenlane/cheat/wiki/Related-Projects
+[INSTALLING.md]: INSTALLING.md
+[Releases]:      https://github.com/cheat/cheat/releases
+[cheatsheets]:   https://github.com/cheat/cheatsheets
+[completions]:   https://github.com/cheat/cheat/tree/master/scripts
+[fzf]:           https://github.com/junegunn/fzf
+[go]:            https://golang.org

bin/cheat

@@ -1,75 +0,0 @@
-#!/usr/bin/env python
-
-"""cheat
-
-Create and view cheatsheets on the command line.
-
-Usage:
-  cheat <cheatsheet>
-  cheat -e <cheatsheet>
-  cheat -s <keyword>
-  cheat -l
-  cheat -d
-  cheat -v
-
-Options:
-  -d --directories  List directories on CHEATPATH
-  -e --edit         Edit cheatsheet
-  -l --list         List cheatsheets
-  -s --search       Search cheatsheets for <keyword>
-  -v --version      Print the version number
-
-Examples:
-
-  To view the `tar` cheatsheet:
-    cheat tar
-
-  To edit (or create) the `foo` cheatsheet:
-    cheat -e foo
-
-  To list all available cheatsheets:
-    cheat -l
-
-  To search for "ssh" among all cheatsheets:
-    cheat -s ssh
-"""
-
-# require the dependencies
-from __future__ import print_function
-from cheat.sheets import Sheets
-from cheat.sheet import Sheet
-from cheat.utils import Utils
-from cheat.configuration import Configuration
-from docopt import docopt
-import os
-
-
-if __name__ == '__main__':
-
-    # parse the command-line options
-    options = docopt(__doc__, version='cheat 2.4.0')
-
-    config = Configuration()
-    sheets = Sheets(config)
-    utils = Utils(config)
-    sheet = Sheet(sheets, utils)
-
-    # list directories
-    if options['--directories']:
-        print("\n".join(sheets.paths()))
-
-    # list cheatsheets
-    elif options['--list']:
-        print(sheets.list(), end="")
-
-    # create/edit cheatsheet
-    elif options['--edit']:
-        sheet.create_or_edit(options['<cheatsheet>'])
-
-    # search among the cheatsheets
-    elif options['--search']:
-        print(utils.colorize(sheets.search(options['<keyword>'])), end="")
-
-    # print the cheatsheet
-    else:
-        print(utils.colorize(sheet.read(options['<cheatsheet>'])), end="")

build/embed.go

@@ -0,0 +1,92 @@
+//go:build ignore
+// +build ignore
+
+// This script embeds `docopt.txt and `conf.yml` into the binary during at
+// build time.
+
+package main
+
+import (
+	"fmt"
+	"io/ioutil"
+	"log"
+	"os"
+	"path/filepath"
+)
+
+func main() {
+
+	// get the cwd
+	cwd, err := os.Getwd()
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	// get the project root
+	root, err := filepath.Abs(cwd + "../../../")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	// specify template file information
+	type file struct {
+		In     string
+		Out    string
+		Method string
+	}
+
+	// enumerate the template files to process
+	files := []file{
+		file{
+			In:     "cmd/cheat/docopt.txt",
+			Out:    "cmd/cheat/str_usage.go",
+			Method: "usage"},
+		file{
+			In:     "configs/conf.yml",
+			Out:    "cmd/cheat/str_config.go",
+			Method: "configs"},
+	}
+
+	// iterate over each static file
+	for _, file := range files {
+
+		// delete the outfile
+		os.Remove(filepath.Join(root, file.Out))
+
+		// read the static template
+		bytes, err := ioutil.ReadFile(filepath.Join(root, file.In))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		// render the template
+		data := template(file.Method, string(bytes))
+
+		// write the file to the specified outpath
+		spath := filepath.Join(root, file.Out)
+		err = ioutil.WriteFile(spath, []byte(data), 0644)
+		if err != nil {
+			log.Fatal(err)
+		}
+	}
+}
+
+// template packages the
+func template(method string, body string) string {
+
+	// specify the template string
+	t := `package main
+
+// Code generated .* DO NOT EDIT.
+
+import (
+	"strings"
+)
+
+func %s() string {
+	return strings.TrimSpace(%s)
+}
+`
+
+	return fmt.Sprintf(t, method, "`"+body+"`")
+}

cheat/__init__.py

@@ -1,4 +0,0 @@
-from . import sheet
-from . import sheets
-from . import utils
-from . import configuration

cheat/autocompletion/cheat.bash

@@ -1,9 +0,0 @@
-function _cheat_autocomplete {
-    sheets=$(cheat -l | cut -d' ' -f1)
-    COMPREPLY=()
-    if [ $COMP_CWORD = 1 ]; then
-	COMPREPLY=(`compgen -W "$sheets" -- $2`)
-    fi
-}
-
-complete -F _cheat_autocomplete cheat

cheat/autocompletion/cheat.fish

@@ -1,12 +0,0 @@
-#completion for cheat
-complete -c cheat -s h -l help -f -x --description "Display help and exit"
-complete -c cheat -l edit -f -x --description "Edit <cheatsheet>"
-complete -c cheat -s e -f -x --description "Edit <cheatsheet>"
-complete -c cheat -s l -l list -f -x --description "List all available cheatsheets"
-complete -c cheat -s d -l cheat-directories -f -x --description "List all current cheat dirs"
-complete -c cheat --authoritative -f
-for cheatsheet in (cheat -l | cut -d' ' -f1)
-    complete -c cheat -a "$cheatsheet"
-    complete -c cheat -o e -a "$cheatsheet" 
-    complete -c cheat -o '-edit' -a "$cheatsheet"
-end

cheat/autocompletion/cheat.zsh

@@ -1,5 +0,0 @@
-#compdef cheat
-
-declare -a cheats
-cheats=$(cheat -l | cut -d' ' -f1)
-_arguments "1:cheats:(${cheats})" && return 0

cheat/cheatsheets/7z

@@ -1,29 +0,0 @@
-7z
-A file archiver with highest compression ratio
-
-Args:
-a       add
-d       delete
-e       extract
-l       list
-t       test
-u       update
-x       extract with full paths
-
-Example:
-7z a -t7z -m0=lzma -mx=9 -mfb=64 -md=32m -ms=on archive.7z dir1
-
--t7z        7z archive
--m0=lzma    lzma method
--mx=9       level of compression = 9 (ultra)
--mfb=64     number of fast bytes for lzma = 64
--md=32m     dictionary size = 32 Mb
--ms=on      solid archive = on
-
-7z exit codes:
-0       normal (no errors or warnings)
-1       warning (non-fatal errors)
-2       fatal error
-7       bad cli arguments
-8       not enough memory for operation
-255     process was interrupted

cheat/cheatsheets/ab

@@ -1,5 +0,0 @@
-# send 100 requests with a concurency of 50 requests to an URL
-ab -n 100 -c 50 http://www.example.com/
-
-# send requests during 30 seconds with a concurency of 50 requests to an URL
-ab -t 30 -c 50 URL http://www.example.com/

cheat/cheatsheets/alias

@@ -1,5 +0,0 @@
-# Show a list of your current shell aliases
-alias
-
-# Map `ll` to `ls -l` (Can be used per session or put inside a shell config file)
-alias ll='ls -l'

cheat/cheatsheets/ansi

@@ -1,72 +0,0 @@
-# Reset
-Color_Off='\e[0m'       # Text Reset
-
-# Regular Colors
-Black='\e[0;30m'        # Black
-Red='\e[0;31m'          # Red
-Green='\e[0;32m'        # Green
-Yellow='\e[0;33m'       # Yellow
-Blue='\e[0;34m'         # Blue
-Purple='\e[0;35m'       # Purple
-Cyan='\e[0;36m'         # Cyan
-White='\e[0;37m'        # White
-
-# Bold
-BBlack='\e[1;30m'       # Black
-BRed='\e[1;31m'         # Red
-BGreen='\e[1;32m'       # Green
-BYellow='\e[1;33m'      # Yellow
-BBlue='\e[1;34m'        # Blue
-BPurple='\e[1;35m'      # Purple
-BCyan='\e[1;36m'        # Cyan
-BWhite='\e[1;37m'       # White
-
-# Underline
-UBlack='\e[4;30m'       # Black
-URed='\e[4;31m'         # Red
-UGreen='\e[4;32m'       # Green
-UYellow='\e[4;33m'      # Yellow
-UBlue='\e[4;34m'        # Blue
-UPurple='\e[4;35m'      # Purple
-UCyan='\e[4;36m'        # Cyan
-UWhite='\e[4;37m'       # White
-
-# Background
-On_Black='\e[40m'       # Black
-On_Red='\e[41m'         # Red
-On_Green='\e[42m'       # Green
-On_Yellow='\e[43m'      # Yellow
-On_Blue='\e[44m'        # Blue
-On_Purple='\e[45m'      # Purple
-On_Cyan='\e[46m'        # Cyan
-On_White='\e[47m'       # White
-
-# High Intensity
-IBlack='\e[0;90m'       # Black
-IRed='\e[0;91m'         # Red
-IGreen='\e[0;92m'       # Green
-IYellow='\e[0;93m'      # Yellow
-IBlue='\e[0;94m'        # Blue
-IPurple='\e[0;95m'      # Purple
-ICyan='\e[0;96m'        # Cyan
-IWhite='\e[0;97m'       # White
-
-# Bold High Intensity
-BIBlack='\e[1;90m'      # Black
-BIRed='\e[1;91m'        # Red
-BIGreen='\e[1;92m'      # Green
-BIYellow='\e[1;93m'     # Yellow
-BIBlue='\e[1;94m'       # Blue
-BIPurple='\e[1;95m'     # Purple
-BICyan='\e[1;96m'       # Cyan
-BIWhite='\e[1;97m'      # White
-
-# High Intensity backgrounds
-On_IBlack='\e[0;100m'   # Black
-On_IRed='\e[0;101m'     # Red
-On_IGreen='\e[0;102m'   # Green
-On_IYellow='\e[0;103m'  # Yellow
-On_IBlue='\e[0;104m'    # Blue
-On_IPurple='\e[0;105m'  # Purple
-On_ICyan='\e[0;106m'    # Cyan
-On_IWhite='\e[0;107m'   # White

cheat/cheatsheets/apk

@@ -1,14 +0,0 @@
-# Install a package
-apk add $package
-
-# Remove a package
-apk del $package
-
-# Update repos
-apk update
-
-# Upgrade all packages
-apk upgrade
-
-# Find a package
-apk search $package

cheat/cheatsheets/apparmor

@@ -1,18 +0,0 @@
-# Desc: Apparmor will protect the system by confining programs to a limited set of resources.
-
-# To activate a profile:
-sudo aa-enforce usr.bin.firefox
-# OR
-export _PROFILE_='usr.bin.firefox' sudo $(rm /etc/apparmor.d/disable/$_PROFILE_ ; cat /etc/apparmor.d/$_PROFILE_ | apparmor_parser -a )
-
-# TO disable a profile:
-sudo aa-disable usr.bin.firefox
-# OR
-export _PROFILE_='usr.bin.firefox' sudo $(ln -s /etc/apparmor.d/$_PROFILE_ /etc/apparmor.d/disable/ && apparmor_parser -R /etc/apparmor.d/$_PROFILE_)
-
-# To list profiles loaded:
-sudo aa-status
-# OR
-sudo apparmor_status
-
-# List of profiles aviables: /etc/apparmor.d/

cheat/cheatsheets/apt

@@ -1,23 +0,0 @@
-# To search a package:
-apt search package
-
-# To show package informations:
-apt show package
-
-# To fetch package list:
-apt update
-
-# To download and install updates without installing new package:
-apt upgrade
-
-# To download and install the updates AND install new necessary packages:
-apt dist-upgrade
-
-# Full command:
-apt update && apt dist-upgrade
-
-# To install a new package(s):
-apt install package(s)
-
-# To uninstall package(s)
-apt remove package(s)

cheat/cheatsheets/apt-cache

@@ -1,12 +0,0 @@
-# To search for apt packages:
-apt-cache search "whatever"
-
-# To display package records for the named package(s):
-apt-cache show pkg(s)
-
-# To display reverse dependencies of a package
-apt-cache rdepends package_name
-
-# To display package versions, reverse dependencies and forward dependencies 
-# of a package
-apt-cache showpkg package_name

cheat/cheatsheets/apt-get

@@ -1,28 +0,0 @@
-# Desc: Allows to update the operating system
-
-# To fetch package list
-apt-get update
-
-# To download and install updates without installing new package.
-apt-get upgrade
-
-# To download and install the updates AND install new necessary packages
-apt-get dist-upgrade
-
-# Full command:
-apt-get update && apt-get dist-upgrade
-
-# To install a new package(s)
-apt-get install package(s)
-
-# Download a package without installing it. (The package will be downloaded in your current working dir)
-apt-get download modsecurity-crs
-
-# Change Cache dir and archive dir (where .deb are stored).
-apt-get -o Dir::Cache="/path/to/destination/dir/" -o Dir::Cache::archives="./" install ...
-
-# Show apt-get installed packages.
-grep 'install ' /var/log/dpkg.log
-
-# Silently keep old configuration during batch updates
-apt-get update -o DPkg::Options::='--force-confold' ...

cheat/cheatsheets/aptitude

@@ -1,15 +0,0 @@
-# To search for packages:
-aptitude search "whatever"
-
-# To display package records for the named package(s):
-aptitude show pkg(s)
-
-# To install a package:
-aptitude install package
-
-# To remove a package:
-aptitude remove package
-
-# To remove unnecessary package:
-aptitude autoclean
-

cheat/cheatsheets/aria2c

@@ -1,12 +0,0 @@
-# Just download a file
-# The url can be a http(s), ftp, .torrent file or even a magnet link
-aria2c <url>
-
-# To prevent downloading the .torrent file
-aria2c --follow-torrent=mem <url>
-
-# Download 1 file at a time (-j) 
-# continuing (-c) any partially downloaded ones
-# to the directory specified (-d)
-# reading urls from the file (-i)
-aria2c -j 1 -c -d ~/Downloads -i /path/to/file

cheat/cheatsheets/asciiart

@@ -1,22 +0,0 @@
-# To show some text in ASCII Art:
-
-figlet Cheat
-#  ____ _                _
-# / ___| |__   ___  __ _| |_
-#| |   | '_ \ / _ \/ _` | __|
-#| |___| | | |  __/ (_| | |_
-# \____|_| |_|\___|\__,_|\__|
-#
-
-
-# To have some text with color and other options:
-# Show with a border
-toilet -F border Cheat
-# Basic show (filled)
-toilet Cheat
-#   mmm  #                      m
-# m"   " # mm    mmm    mmm   mm#mm
-# #      #"  #  #"  #  "   #    #
-# #      #   #  #""""  m"""#    #
-#  "mmm" #   #  "#mm"  "mm"#    "mm
-#

cheat/cheatsheets/asterisk

@@ -1,17 +0,0 @@
-# To connect to a running Asterisk session:
-asterisk -rvvv
-
-# To issue a command to Asterisk from the shell:
-asterisk -rx "<command>"
-
-# To originate an echo call from a SIP trunk on an Asterisk server, to a specified number:
-asterisk -rx "channel originate SIP/<trunk>/<number> application echo"
-
-# To print out the details of SIP accounts:
-asterisk -rx "sip show peers"
-
-# To print out the passwords of SIP accounts:
-asterisk -rx "sip show users"
-
-# To print out the current active channels:
-asterisk -rx "core show channels"

cheat/cheatsheets/at

@@ -1,17 +0,0 @@
-# To schedule a one time task
-at {time}
-{command 0}
-{command 1}
-Ctrl-d
-
-# {time} can be either
-now | midnight | noon | teatime (4pm)
-HH:MM
-now + N {minutes | hours | days | weeks}
-MM/DD/YY
-
-# To list pending jobs
-atq
-
-# To remove a job (use id from atq)
-atrm {id}

cheat/cheatsheets/awk

@@ -1,11 +0,0 @@
-# sum integers from a file or stdin, one integer per line:
-printf '1\n2\n3\n' | awk '{ sum += $1} END {print sum}'
-
-# using specific character as separator to sum integers from a file or stdin
-printf '1:2:3' | awk -F ":" '{print $1+$2+$3}'
-
-# print a multiplication table
-seq 9 | sed 'H;g' | awk -v RS='' '{for(i=1;i<=NF;i++)printf("%dx%d=%d%s", i, NR, i*NR, i==NR?"\n":"\t")}'
-
-# Specify output separator character
-printf '1 2 3' | awk 'BEGIN {OFS=":"}; {print $1,$2,$3}'

cheat/cheatsheets/bash

@@ -1,27 +0,0 @@
-# To implement a for loop:
-for file in *;
-do 
-    echo $file found;
-done
-
-# To implement a case command:
-case "$1"
-in
-    0) echo "zero found";;
-    1) echo "one found";;
-    2) echo "two found";;
-    3*) echo "something beginning with 3 found";;
-esac
-
-# Turn on debugging:
-set -x
-
-# Turn off debugging:
-set +x
-
-# Retrieve N-th piped command exit status
-printf 'foo' | fgrep 'foo' | sed 's/foo/bar/'
-echo ${PIPESTATUS[0]}  # replace 0 with N
-
-# Lock file:
-( set -o noclobber; echo > my.lock ) || echo 'Failed to create lock file'

cheat/cheatsheets/bower

@@ -1,26 +0,0 @@
-# Install a package locally
-bower install <package-name>
-
-# Install a package locally directly from github
-bower install <user>/<repo>
-
-# Install a specific package locally
-bower install <package-name>#<version>
-
-# Install a package locally and save installed package into bower.json
-bower install <package-name> --save
-
-# Retrieve info of a particular package
-bower info <package-name>
-
-# List local packages
-bower list
-
-# Search for a package by name
-bower search <package-name>
-
-# Update a package to their newest version
-bower update <package-name>
-
-# Remove a local package
-bower uninstall <package-name>

cheat/cheatsheets/bzip2

@@ -1,11 +0,0 @@
-# compress foo -> foo.bz2
-bzip2 -z foo
-
-# decompress foo.bz2 -> foo
-bzip2 -d foo.bz2
-
-# compress foo to stdout
-bzip2 -zc foo > foo.bz2
-
-# decompress foo.bz2 to stdout
-bzip2 -dc foo.bz2

cheat/cheatsheets/cat

@@ -1,8 +0,0 @@
-# Display the contents of a file
-cat /path/to/foo
-
-# Display contents with line numbers
-cat -n /path/to/foo
-
-# Display contents with line numbers (blank lines excluded)
-cat -b /path/to/foo

cheat/cheatsheets/cd

@@ -1,11 +0,0 @@
-#Go to the given directory
-cd path/to/directory
-
-#Go to home directory of current user
-cd
-
-#Go up to the parent of the current directory
-cd ..
-
-#Go to the previously chosen directory
-cd -

cheat/cheatsheets/cheat

@@ -1,14 +0,0 @@
-# To see example usage of a program:
-cheat <command>
-
-# To edit a cheatsheet
-cheat -e <command>
-
-# To list available cheatsheets
-cheat -l
-
-# To search available cheatsheets
-cheat -s <command>
-
-# To get the current `cheat' version
-cheat -v

cheat/cheatsheets/chmod

@@ -1,36 +0,0 @@
-# Add execute for all (myscript.sh)
-chmod a+x myscript.sh
-
-# Set user to read/write/execute, group/global to read only (myscript.sh), symbolic mode
-chmod u=rwx, go=r myscript.sh 
-
-# Remove write from user/group/global (myscript.sh), symbolic mode
-chmod a-w myscript.sh
-
-# Remove read/write/execute from user/group/global (myscript.sh), symbolic mode
-chmod = myscript.sh
-
-# Set user to read/write and group/global read (myscript.sh), octal notation
-chmod 644 myscript.sh
-
-# Set user to read/write/execute and group/global read/execute (myscript.sh), octal notation
-chmod 755 myscript.sh
-
-# Set user/group/global to read/write (myscript.sh), octal notation
-chmod 666 myscript.sh
-
-# Roles
-u - user (owner of the file)
-g - group (members of file's group)
-o - global (all users who are not owner and not part of group)
-a - all (all 3 roles above)
-
-# Numeric representations
-7 - full (rwx)
-6 - read and write (rw-)
-5 - read and execute (r-x)
-4 - read only (r--)
-3 - write and execute (-wx)
-2 - write only (-w-)
-1 - execute only (--x)
-0 - none (---)

cheat/cheatsheets/chown

@@ -1,11 +0,0 @@
-# Change file owner
-chown user file
-
-# Change file owner and group
-chown user:group file
-
-# Change owner recursively
-chown -R user directory
-
-# Change ownership to match another file
-chown --reference=/path/to/ref_file file

cheat/cheatsheets/convert

@@ -1,19 +0,0 @@
-# To resize an image to a fixed width and proportional height:
-convert original-image.jpg -resize 100x converted-image.jpg
-
-# To resize an image to a fixed height and proportional width:
-convert original-image.jpg -resize x100 converted-image.jpg
-
-# To resize an image to a fixed width and height:
-convert original-image.jpg -resize 100x100 converted-image.jpg
-
-# To resize an image and simultaneously change its file type:
-convert original-image.jpg -resize 100x converted-image.png
-
-# To resize all of the images within a directory:
-# To implement a for loop:
-for file in `ls original/image/path/`;
-    do new_path=${file%.*};
-    new_file=`basename $new_path`;
-    convert $file -resize 150 converted/image/path/$new_file.png;
-done

cheat/cheatsheets/cp

@@ -1,11 +0,0 @@
-# Create a copy of a file
-cp ~/Desktop/foo.txt ~/Downloads/foo.txt
-
-# Create a copy of a directory
-cp -r ~/Desktop/cruise_pics/ ~/Pictures/
-
-# Create a copy but ask to overwrite if the destination file already exists
-cp -i ~/Desktop/foo.txt ~/Documents/foo.txt
-
-# Create a backup file with date
-cp foo.txt{,."$(date +%Y%m%d-%H%M%S)"}

cheat/cheatsheets/cpdf

@@ -1,132 +0,0 @@
-# Read in.pdf, select pages 1, 2, 3 and 6, and write those pages to
-# out.pdf
-cpdf in.pdf 1-3,6 -o out.pdf
-
-# Select the even pages (2, 4, 6...) from in.pdf and write those pages
-# to out.pdf
-cpdf in.pdf even -o out.pdf
-
-# Using AND to perform several operations in order, here merging two
-# files together and adding a copyright stamp to every page.
-cpdf -merge in.pdf in2.pdf AND -add-text "Copyright 2014" -o out.pdf
-
-# Read control.txt and use its contents as the command line arguments
-# for cpdf.
-cpdf -control control.txt
-
-# Merge in.pdf and in2.pdf into one document, writing to out.pdf.
-cpdf -merge in.pdf in2.pdf -o out.pdf
-
-# Split in.pdf into ten-page chunks, writing them to Chunk001.pdf,
-# Chunk002.pdf etc
-cpdf -split in.pdf -o Chunk%%%.pdf -chunk 10
-
-# Split in.pdf on bookmark boundaries, writing each to a file whose
-# name is the bookmark label
-cpdf -split-bookmarks 0 in.pdf -o @N.pdf
-
-# Scale both the dimensions and contents of in.pdf by a factor of two
-# in x and y directions.
-cpdf -scale-page "2 2" in.pdf -o out.pdf
-
-# Scale the pages in in.pdf to fit the US Letter page size, writing to
-# out.pdf
-cpdf -scale-to-fit usletterportrait in.pdf -o out.pdf
-
-# Shift the contents of the page by 26 pts in the x direction, and 18
-# millimetres in the y direction, writing to out.pdf
-cpdf -shift "26pt 18mm" in.pdf -o out.pdf
-
-# Rotate the contents of the pages in in.pdf by ninety degrees and
-# write to out.pdf.
-cpdf -rotate-contents 90 in.pdf -o out.pdf
-
-# Crop the pages in in.pdf to a 600 pts by 400 pts rectangle.
-cpdf -crop "0 0 600pt 400pt" in.pdf -o out.pdf
-
-# Encrypt using 128bit PDF encryption using the owner password 'fred'
-# and the user password 'joe'
-cpdf -encrypt 128bit fred joe in.pdf -o out.pdf
-
-# Decrypt using the owner password, writing to out.pdf.
-cpdf -decrypt in.pdf owner=fred -o out.pdf
-
-# Compress the data streams in in.pdf, writing the result to out.pdf.
-cpdf -compress in.pdf -o out.pdf
-
-# Decompress the data streams in in.pdf, writing to out.pdf.
-cpdf -decompress in.pdf -o out.pdf
-
-# List the bookmarks in in.pdf. This would produce:
-cpdf -list-bookmarks in.pdf
-
-# Outputs:
-
-# Add bookmarks in the same form from a prepared file bookmarks.txt to
-# in.pdf, writing to out.pdf.
-cpdf -add-bookmarks bookmarks.txt in.pdf -o out.pdf
-
-# Use the Split style to build a presentation from the PDF in.pdf,
-# each slide staying 10 seconds on screen unless manually advanced.
-# The first page, being a title does not move on automatically, and
-# has no transition effect.
-cpdf -presentation in.pdf 2-end -trans Split -duration 10 -o out.pdf
-
-# Stamp the file watermark.pdf on to each page of in.pdf, writing the
-# result to out.pdf.
-cpdf -stamp-on watermark.pdf in.pdf -o out.pdf
-
-# Add a page number and date to all the pages in in.pdf using the
-# Courier font, writing to out.pdf
-cpdf -topleft 10 -font Courier -add-text "Page %Page\nDate %d-%m-%Y" in.pdf -o out.pdf
-
-# Two up impose the file in.pdf, writing to out.pdf
-cpdf -twoup-stack in.pdf -o out.pdf
-
-# Add extra blank pages after pages one, three and four of a document.
-cpdf -pad-after 1,3,4 in.pdf -o out.pdf
-
-# List the annotations in a file in.pdf to standard output.
-cpdf -list-annotations in.pdf
-
-# Might Produce:
-
-# -- # Annotation text content 1 # -- # -- # Annotation text content 2
-# --
-
-# Copy the annotations from from.pdf to in.pdf, writing to out.pdf.
-cpdf -copy-annotations from.pdf in.pdf -o out.pdf
-
-# Set the document title of in.pdf. writing to out.pdf.
-cpdf -set-title "The New Title" in.pdf -o out.pdf
-
-# Set the document in.pdf to open with the Acrobat Viewer's toolbar
-# hidden, writing to out.pdf.
-cpdf -hide-toolbar true in.pdf -o out.pdf
-
-# Set the metadata in a PDF in.pdf to the contents of the file
-# metadata.xml, and write the output to out.pdf.
-cpdf -set-metadata metadata.xml in.pdf -o out.pdf
-
-# Set the document in.pdf to open in Acrobat Viewer showing two
-# columns of pages, starting on the right, putting the result in
-# out.pdf.
-cpdf -set-page-layout TwoColumnRight in.pdf -o out.pdf
-
-# Set the document in.pdf to open in Acrobat Viewer in full screen
-# mode, putting the result in out.pdf.
-cpdf -set-page-mode FullScreen in.pdf -o out.pdf
-
-# Attach the file sheet.xls to in.pdf, writing to out.pdf.
-cpdf -attach-file sheet.xls in.pdf -o out.pdf
-
-# Remove any attachments from in.pdf, writing to out.pdf.
-cpdf -remove-files in.pdf -o out.pdf
-
-# Blacken all the text in in.pdf, writing to out.pdf.
-cpdf -blacktext in.pdf -o out.pdf
-
-# Make sure all lines in in.pdf are at least 2 pts wide, writing to
-# out.pdf.
-cpdf -thinlines 2pt in.pdf -o out.pdf
-

cheat/cheatsheets/crontab

@@ -1,22 +0,0 @@
-# set a shell
-SHELL=/bin/bash
-
-# crontab format
-* * * * *  command_to_execute
-- - - - -
-| | | | |
-| | | | +- day of week (0 - 7) (where sunday is 0 and 7)
-| | | +--- month (1 - 12)
-| | +----- day (1 - 31)
-| +------- hour (0 - 23)
-+--------- minute (0 - 59)
-
-# example entries
-# every 15 min
-*/15 * * * * /home/user/command.sh
-
-# every midnight
-0 0 * * * /home/user/command.sh
-
-# every Saturday at 8:05 AM
-5 8 * * 6 /home/user/command.sh

cheat/cheatsheets/cryptsetup

@@ -1,8 +0,0 @@
-# open encrypted partition /dev/sdb1 (reachable at /dev/mapper/backup)
-cryptsetup open --type luks /dev/sdb1 backup
-
-# open encrypted partition /dev/sdb1 using a keyfile (reachable at /dev/mapper/hdd)
-cryptsetup open --type luks --key-file hdd.key /dev/sdb1 hdd
-
-# close luks container at /dev/mapper/hdd
-cryptsetup close hdd

cheat/cheatsheets/csplit

@@ -1,5 +0,0 @@
-# Split a file based on pattern
-csplit input.file '/PATTERN/'
-
-# Use prefix/suffix to improve resulting file names
-csplit -f 'prefix-' -b '%d.extension' input.file '/PATTERN/' '{*}'

cheat/cheatsheets/cups

@@ -1,22 +0,0 @@
-# Manage printers through CUPS:
-http://localhost:631 (in web browser)
-
-# Print file from command line
-lp myfile.txt
-
-# Display print queue
-lpq
-
-# Remove print job from queue
-lprm 545
-or
-lprm -
-
-# Print log location
-/var/log/cups
-
-# Reject new jobs
-cupsreject printername
-
-# Accept new jobs
-cupsaccept printername

cheat/cheatsheets/curl

@@ -1,41 +0,0 @@
-# Download a single file
-curl http://path.to.the/file
-
-# Download a file and specify a new filename
-curl http://example.com/file.zip -o new_file.zip
-
-# Download multiple files
-curl -O URLOfFirstFile -O URLOfSecondFile
-
-# Download all sequentially numbered files (1-24)
-curl http://example.com/pic[1-24].jpg
-
-# Download a file and pass HTTP Authentication
-curl -u username:password URL 
-
-# Download a file with a Proxy
-curl -x proxysever.server.com:PORT http://addressiwantto.access
-
-# Download a file from FTP
-curl -u username:password -O ftp://example.com/pub/file.zip
-
-# Get an FTP directory listing
-curl ftp://username:password@example.com
-
-# Resume a previously failed download
-curl -C - -o partial_file.zip http://example.com/file.zip
-
-# Fetch only the HTTP headers from a response
-curl -I http://example.com
-
-# Fetch your external IP and network info as JSON
-curl http://ifconfig.me/all.json
-
-# Limit the rate of a download
-curl --limit-rate 1000B -O http://path.to.the/file
-
-# Get your global IP
-curl httpbin.org/ip 
-
-# Get only the HTTP status code
-curl -o /dev/null -w '%{http_code}\n' -s -I URL

cheat/cheatsheets/cut

@@ -1,2 +0,0 @@
-# To cut out the third field of text or stdoutput that is delimited by a #:
-cut -d# -f3

cheat/cheatsheets/date

@@ -1,8 +0,0 @@
-# Print date in format suitable for affixing to file names
-date +"%Y%m%d_%H%M%S"
-
-# Convert Unix timestamp to Date(Linux)
-date -d @1440359821
-
-# Convert Unix timestamp to Date(Mac)
-date -r 1440359821

cheat/cheatsheets/dd

@@ -1,22 +0,0 @@
-# Read from {/dev/urandom} 2*512 Bytes and put it into {/tmp/test.txt}
-# Note: At the first iteration, we read 512 Bytes.
-# Note: At the second iteration, we read 512 Bytes.
-dd if=/dev/urandom of=/tmp/test.txt count=2 bs=512
-
-# Watch the progress of 'dd'
-dd if=/dev/zero of=/dev/null bs=4KB &; export dd_pid=`pgrep '^dd'`; while [[ -d /proc/$dd_pid ]]; do kill -USR1 $dd_pid && sleep 1 && clear; done
-
-# Watch the progress of 'dd' with `pv` and `dialog` (apt-get install pv dialog)
-(pv -n /dev/zero | dd of=/dev/null bs=128M conv=notrunc,noerror) 2>&1 | dialog --gauge "Running dd command (cloning), please wait..." 10 70 0
-
-# Watch the progress of 'dd' with `pv` and `zenity` (apt-get install pv zenity)
-(pv -n /dev/zero | dd of=/dev/null bs=128M conv=notrunc,noerror) 2>&1 | zenity --title 'Running dd command (cloning), please wait...' --progress
-
-# Watch the progress of 'dd' with the built-in `progress` functionality (introduced in coreutils v8.24)
-dd if=/dev/zero of=/dev/null bs=128M status=progress
-
-# DD with "graphical" return
-dcfldd if=/dev/zero of=/dev/null bs=500K
-
-# This will output the sound from your microphone port to the ssh target computer's speaker port. The sound quality is very bad, so you will hear a lot of hissing.
-dd if=/dev/dsp | ssh -c arcfour -C username@host dd of=/dev/dsp

cheat/cheatsheets/deb

@@ -1,7 +0,0 @@
-# Extract contents of a .deb file
-$ ar vx foo.deb    # -> data.tar.gz
-$ tar xf data.tar.gz
-
-# Install .deb file to a debian like system, e.g. ubuntu
-$ sudo dpkg -i foo.deb
-$ sudo apt-get install -f

cheat/cheatsheets/df

@@ -1,2 +0,0 @@
-# Printout disk free space in a human readable format
-df -h

cheat/cheatsheets/dhclient

@@ -1,10 +0,0 @@
-# To release the current IP address:
-sudo dhclient -r
-
-# To obtain a new IP address:
-sudo dhclient
-
-# Running the above in sequence is a common way of refreshing an IP.
-
-# To obtain a new IP address for a specific interface:
-sudo dhclient eth0

cheat/cheatsheets/diff

@@ -1,26 +0,0 @@
-# To view the differences between two files:
-diff -u version1 version2
-
-# To view the differences between two directories:
-diff -ur folder1/ folder2/
-
-# To ignore the white spaces:
-diff -ub version1 version2
-
-# To ignore the blank lines:
-diff -uB version1 version2
-
-# To ignore the differences between uppercase and lowercase:
-diff -ui version1 version2
-
-# To report whether the files differ:
-diff -q version1 version2
-
-# To report whether the files are identical:
-diff -s version1 version2
-
-# To diff the output of two commands or scripts:
-diff <(command1) <(command2)
-
-# Generate a patch file from two files
-diff -Naur version1 version2 > version.patch

cheat/cheatsheets/distcc

@@ -1,29 +0,0 @@
-# INSTALL
-# ==============================================================================
-# Edit /etc/default/distcc and set theses vars
-# STARTDISTCC="true"
-# ALLOWEDNETS="127.0.0.1 192.168.1.0/24"# Your computer and local computers
-# #LISTENER="127.0.0.1"# Comment it
-# ZEROCONF="true"# Auto configuration
-
-# REMEMBER 1:
-# Start/Restart your distccd servers before using one of these commands.
-# service distccd start
-
-# REMEMBER 2:
-# Do not forget to install on each machine DISTCC.
-# No need to install libs ! Only main host need libs !
-
-# USAGE
-# ==============================================================================
-
-# Run make with 4 thread (a cross network) in auto configuration.
-# Note: for gcc, Replace CXX by CC and g++ by gcc
-ZEROCONF='+zeroconf' make -j4 CXX='distcc g++'
-
-# Run make with 4 thread (a cross network) in static configuration (2 ip)
-# Note: for gcc, Replace CXX by CC and g++ by gcc
-DISTCC_HOSTS='127.0.0.1 192.168.1.69' make -j4 CXX='distcc g++'
-
-# Show hosts aviables
-ZEROCONF='+zeroconf' distcc --show-hosts

cheat/cheatsheets/dnf

@@ -1,16 +0,0 @@
-# To install the latest version of a package:
-dnf install <package name>
-
-# To search package details for the given string
-dnf search <string>
-
-# To find which package provides a binary
-dnf provides <path to binary>
-
-# The following are available after installing "dnf-plugins-core"
-
-# Download a package
-dnf download <package name>
-
-# install the build dependencies for a SRPM or from a .spec file
-dnf builddep <srpm/.spec file>

cheat/cheatsheets/docker

@@ -1,32 +0,0 @@
-# Start docker daemon
-docker -d
-
-# start a container with an interactive shell
-docker run -ti <image_name> /bin/bash
-
-# "shell" into a running container (docker-1.3+)
-docker exec -ti <container_name> bash
-
-# inspect a running container
-docker inspect <container_name> (or <container_id>)
-
-# Get the process ID for a container
-# Source: https://github.com/jpetazzo/nsenter
-docker inspect --format {{.State.Pid}} <container_name_or_ID>
-
-# List the current mounted volumes for a container (and pretty print)
-# Source:
-# http://nathanleclaire.com/blog/2014/07/12/10-docker-tips-and-tricks-that-will-make-you-sing-a-whale-song-of-joy/
-docker inspect --format='{{json .Volumes}}' <container_id> | python -mjson.tool
-
-# Copy files/folders between a container and your host
-docker cp foo.txt mycontainer:/foo.txt
-
-# list currently running containers
-docker ps
-
-# list all containers
-docker ps -a
-
-# list all images
-docker images

cheat/cheatsheets/dpkg

@@ -1,11 +0,0 @@
-# Install the package or upgrade it
-dpkg -i test.deb
-
-# Remove a package including configuration files
-dpkg -P test.deb
-
-# List all installed packages with versions and details
-dpkg -I
-
-# Find out if a Debian package is installed or not
-dpkg -s test.deb | grep Status

cheat/cheatsheets/du

@@ -1,5 +0,0 @@
-# To sort directories/files by size
-du -sk *| sort -rn
-
-# To show cumulative humanreadable size
-du -sh

cheat/cheatsheets/emacs

@@ -1,64 +0,0 @@
-# Running emacs
-
-  GUI mode            $ emacs
-  Terminal mode       $ emacs -nw
-
-# Basic usage
-
-  Indent              Select text then press TAB
-  Cut                 CTRL-w
-  Copy                ALT-w
-  Paste ("yank")      CTRL-y
-  Begin selection     CTRL-SPACE
-  Search/Find         CTRL-s
-  Replace             ALT-% (ALT-SHIFT-5)
-  Save                CTRL-x CTRL-s
-  Save as             CTRL-x CTRL-w
-  Load/Open           CTRL-x CTRL-f
-  Undo                CTRL-x u
-  Highlight all text  CTRL-x h
-  Directory listing   CTRL-x d
-  Cancel a command    CTRL-g
-  Font size bigger    CTRL-x CTRL-+
-  Font size smaller   CTRL-x CTRL--
-
-# Buffers
-
-  Split screen vertically                         CTRL-x 2
-  Split screen vertically with 5 row height       CTRL-u 5 CTRL-x 2
-  Split screen horizontally                       CTRL-x 3
-  Split screen horizontally with 24 column width  CTRL-u 24 CTRL-x 3
-  Revert to single screen                         CTRL-x 1
-  Hide the current screen                         CTRL-x 0
-  Move to the next screen                         CTRL-x o
-  Kill the current buffer                         CTRL-x k
-  Select a buffer                                 CTRL-x b
-  Run command in the scratch buffer               CTRL-x CTRL-e
-
-# Navigation ( backward / forward )
-  
-  Character-wise                                  CTRL-b , CTRL-f
-  Word-wise                                       ALT-b  , ALT-f
-  Line-wise                                       CTRL-p , CTRL-n
-  Sentence-wise                                   ALT-a  , ALT-e
-  Paragraph-wise                                  ALT-{ , ALT-}
-  Function-wise                                   CTRL-ALT-a , CTRL-ALT-e
-  Line beginning / end                            CTRL-a , CTRL-e
-
-# Other stuff
-
-  Open a shell         ALT-x eshell
-  Goto a line number   ALT-x goto-line
-  Word wrap            ALT-x toggle-word-wrap
-  Spell checking       ALT-x flyspell-mode
-  Line numbers         ALT-x linum-mode
-  Toggle line wrap     ALT-x visual-line-mode
-  Compile some code    ALT-x compile
-  List packages        ALT-x package-list-packages
-
-# Line numbers
-
-  To add line numbers and enable moving to a line with CTRL-l:
-
-    (global-set-key "\C-l" 'goto-line)
-    (add-hook 'find-file-hook (lambda () (linum-mode 1)))

cheat/cheatsheets/export

@@ -1,5 +0,0 @@
-# Calling export with no arguments will show current shell attributes
-export
-
-# Create new environment variable
-export VARNAME="value"

cheat/cheatsheets/ffmpeg

@@ -1,23 +0,0 @@
-# Print file metadata etc.
-ffmpeg -i path/to/file.ext
-
-# Convert all m4a files to mp3
-for f in *.m4a; do ffmpeg -i "$f" -acodec libmp3lame -vn -b:a 320k "${f%.m4a}.mp3"; done
-
-# Convert video from .foo to .bar
-# -g : GOP, for searchability
-ffmpeg -i input.foo -vcodec bar -acodec baz -b:v 21000k -b:a 320k -g 150 -threads 4 output.bar
-
-# Convert image sequence to video
-ffmpeg -r 18 -pattern_type glob -i '*.png' -b:v 21000k -s hd1080 -vcodec vp9 -an -pix_fmt yuv420p -deinterlace output.ext
-
-# Combine video and audio into one file
-ffmpeg -i video.ext -i audio.ext -c:v copy -c:a copy output.ext
-
-# Listen to 10 seconds of audio from a video file
-#
-# -ss : start time
-# -t  : seconds to cut
-# -autoexit : closes ffplay as soon as the audio finishes
-ffmpeg -ss 00:34:24.85 -t 10 -i path/to/file.mp4 -f mp3 pipe:play | ffplay -i pipe:play -autoexit
-

cheat/cheatsheets/find

@@ -1,47 +0,0 @@
-# To find files by case-insensitive extension (ex: .jpg, .JPG, .jpG):
-find . -iname "*.jpg"
-
-# To find directories:
-find . -type d
-
-# To find files:
-find . -type f
-
-# To find files by octal permission:
-find . -type f -perm 777
-
-# To find files with setuid bit set:
-find . -xdev \( -perm -4000 \) -type f -print0 | xargs -0 ls -l
-
-# To find files with extension '.txt' and remove them:
-find ./path/ -name '*.txt' -exec rm '{}' \;
-
-# To find files with extension '.txt' and look for a string into them:
-find ./path/ -name '*.txt' | xargs grep 'string'
-
-# To find files with size bigger than 5 Mebibyte and sort them by size:
-find . -size +5M -type f -print0 | xargs -0 ls -Ssh | sort -z
-
-# To find files bigger than 2 Megabyte and list them:
-find . -type f -size +200000000c -exec ls -lh {} \; | awk '{ print $9 ": " $5 }'
-
-# To find files modified more than 7 days ago and list file information
-find . -type f -mtime +7d -ls
-
-# To find symlinks owned by a user and list file information
-find . -type l --user=username -ls
-
-# To search for and delete empty directories
-find . -type d -empty -exec rmdir {} \;
-
-# To search for directories named build at a max depth of 2 directories
-find . -maxdepth 2 -name build -type d
-
-# To search all files who are not in .git directory
-find . ! -iwholename '*.git*' -type f
-
-# To find all files that have the same node (hard link) as MY_FILE_HERE
-find . -type f -samefile MY_FILE_HERE 2>/dev/null
-
-# To find all files in the current directory and modify their permissions
-find . -type f -exec chmod 644 {} \;

cheat/cheatsheets/for

@@ -1,35 +0,0 @@
-# basic loop
-for i in 1 2 3 4 5 6 7 8 9 10
-do
-  echo $i
-done
-
-# loop ls command results
-for var in `ls -alF`
-do
-  echo $var
-done
-
-# loop over all the JPG files in the current directory
-for jpg_file in *.jpg
-do
-  echo $jpg_file
-done
-
-# loop specified number of times
-for i in `seq 1 10`
-do
-  echo $i
-done
-
-# loop specified number of times: the C/C++ style
-for ((i=1;i<=10;++i))
-do
-  echo $i
-done
-
-# loop specified number of times: the brace expansion
-for i in {1..10}
-do
-  echo $i
-done

cheat/cheatsheets/gcc

@@ -1,21 +0,0 @@
-# Compile a file
-gcc file.c
-
-# Compile a file with a custom output
-gcc -o file file.c
-
-# Debug symbols
-gcc -g
-
-# Debug with all symbols.
-gcc -ggdb3
-
-# Build for 64 bytes
-gcc -m64
-
-# Include the directory {/usr/include/myPersonnal/lib/} to the list of path for #include <....>
-# With this option, no warning / error will be reported for the files in {/usr/include/myPersonnal/lib/}
-gcc -isystem /usr/include/myPersonnal/lib/
-
-# Build a GUI for windows (Mingw) (Will disable the term/console)
-gcc -mwindows

cheat/cheatsheets/gdb

@@ -1,26 +0,0 @@
-# start the debugger
-gdb your-executable
-
-# set a breakpoint
-b some-method, break some-method
-
-# run the program
-r, run
-
-# when a breakpoint was reached:
-
-# run the current line, stepping over any invocations
-n, next
-# run the current line, stepping into any invocations
-s, step
-# print a stacktrace
-bt, backtrace
-# evaluate an expression and print the result
-p length=strlen(string)
-# list surrounding source code
-l, list
-# continue execution
-c, continue
-
-# exit gdb (after program terminated)
-q, quit

cheat/cheatsheets/git

@@ -1,151 +0,0 @@
-# To set your identity:
-git config --global user.name "John Doe"
-git config --global user.email johndoe@example.com
-
-# To set your editor:
-git config --global core.editor emacs
-
-# To enable color:
-git config --global color.ui true
-
-# To stage all changes for commit:
-git add --all
-
-# To stash changes locally, this will keep the changes in a separate changelist
-# called stash and the working directory is cleaned. You can apply changes
-# from the stash anytime
-git stash
-
-# To stash changes with a message
-git stash save "message"
-
-# To list all the stashed changes
-git stash list
-
-# To apply the most recent change and remove the stash from the stash list
-git stash pop
-
-# To apply any stash from the list of stashes. This does not remove the stash
-# from the stash list
-git stash apply stash@{6}
-
-# To commit staged changes
-git commit -m "Your commit message"
-
-# To edit previous commit message
-git commit --amend
-
-# Git commit in the past
-git commit --date="`date --date='2 day ago'`"
-git commit --date="Jun 13 18:30:25 IST 2015"
-# more recent versions of Git also support --date="2 days ago" directly
-
-# To change the date of an existing commit
-git filter-branch --env-filter \
-    'if [ $GIT_COMMIT = 119f9ecf58069b265ab22f1f97d2b648faf932e0 ]
-     then
-         export GIT_AUTHOR_DATE="Fri Jan 2 21:38:53 2009 -0800"
-         export GIT_COMMITTER_DATE="Sat May 19 01:01:01 2007 -0700"
-     fi'
-
-# To removed staged and working directory changes
-git reset --hard
-
-# To go 2 commits back
-git reset --hard HEAD~2
-
-# To remove untracked files
-git clean -f -d
-
-# To remove untracked and ignored files
-git clean -f -d -x
-
-# To push to the tracked master branch:
-git push origin master
-
-# To push to a specified repository:
-git push git@github.com:username/project.git
-
-# To delete the branch "branch_name"
-git branch -D branch_name
-
-# To make an exisiting branch track a remote branch
-git branch -u upstream/foo
-
-# To see who commited which line in a file
-git blame filename
-
-# To sync a fork with the master repo:
-git remote add upstream git@github.com:name/repo.git    # Set a new repo
-git remote -v                                           # Confirm new remote repo
-git fetch upstream                                      # Get branches
-git branch -va                                          # List local - remote branches
-git checkout master                                     # Checkout local master branch
-git checkout -b new_branch                              # Create and checkout a new branch
-git merge upstream/master                               # Merge remote into local repo
-git show 83fb499                                        # Show what a commit did.
-git show 83fb499:path/fo/file.ext                       # Shows the file as it appeared at 83fb499.
-git diff branch_1 branch_2                              # Check difference between branches
-git log                                                 # Show all the commits
-git status                                              # Show the changes from last commit
-
-# Commit history of a set of files
-git log --pretty=email --patch-with-stat --reverse --full-index -- Admin\*.py > Sripts.patch
-
-# Import commits from another repo
-git --git-dir=../some_other_repo/.git format-patch -k -1 --stdout <commit SHA> | git am -3 -k
-
-# View commits that will be pushed
-git log @{u}..
-
-# View changes that are new on a feature branch
-git log -p feature --not master
-git diff master...feature
-
-# Interactive rebase for the last 7 commits
-git rebase -i @~7
-
-# Diff files WITHOUT considering them a part of git
-# This can be used to diff files that are not in a git repo!
-git diff --no-index path/to/file/A path/to/file/B
-
-# To pull changes while overwriting any local commits
-git fetch --all
-git reset --hard origin/master
-
-# Update all your submodules
-git submodule update --init --recursive
-
-# Perform a shallow clone to only get latest commits
-# (helps save data when cloning large repos)
-git clone --depth 1 <remote-url>
-
-# To unshallow a clone
-git pull --unshallow
-
-# Create a bare branch (one that has no commits on it)
-git checkout --orphan branch_name
-
-# Checkout a new branch from a different starting point
-git checkout -b master upstream/master
-
-# Remove all stale branches (ones that have been deleted on remote)
-# So if you have a lot of useless branches, delete them on Github and then run this
-git remote prune origin
-
-# The following can be used to prune all remotes at once
-git remote prune $(git remote | tr '\n' ' ')
-
-# Revisions can also be identified with :/text
-# So, this will show the first commit that has "cool" in their message body
-git show :/cool
-
-# Undo parts of last commit in a specific file
-git checkout -p HEAD^ -- /path/to/file
-
-# Revert a commit and keep the history of the reverted change as a separate revert commit
-git revert <commit SHA>
-
-# Pich a commit from a branch to current branch. This is different than merge as
-# this just applies a single commit from a branch to current branch
-git cherry-pick <commit SHA1>

cheat/cheatsheets/gpg

@@ -1,173 +0,0 @@
-# Create a key
-
- gpg --gen-key
-
-
-# Show keys
-
-  To list a summary of all keys
-
-    gpg --list-keys
-
-  To show your public key
-
-    gpg --armor --export
-
-  To show the fingerprint for a key
-
-    gpg --fingerprint KEY_ID
-
-# Search for keys
-
-  gpg --search-keys 'user@emailaddress.com'
-
-
-# To Encrypt a File
-
-  gpg --encrypt --recipient 'user@emailaddress.com' example.txt
-
-
-# To Decrypt a File
-
-  gpg --output example.txt --decrypt example.txt.gpg
-
-
-# Export keys
-
-  gpg --output ~/public_key.txt --armor --export KEY_ID
-  gpg --output ~/private_key.txt --armor --export-secret-key KEY_ID
-
-  Where KEY_ID is the 8 character GPG key ID.
-
-  Store these files to a safe location, such as a USB drive, then
-  remove the private key file.
-
-    shred -zu ~/private_key.txt
-
-# Import keys
-
-  Retrieve the key files which you previously exported.
-
-    gpg --import ~/public_key.txt
-    gpg --allow-secret-key-import --import ~/private_key.txt
-
-  Then delete the private key file.
-
-    shred -zu ~/private_key.txt
-
-# Revoke a key
-
-  Create a revocation certificate.
-
-    gpg --output ~/revoke.asc --gen-revoke KEY_ID
-
-  Where KEY_ID is the 8 character GPG key ID.
-
-  After creating the certificate import it.
-
-    gpg --import ~/revoke.asc
-
-  Then ensure that key servers know about the revokation.
-
-    gpg --send-keys KEY_ID
-
-# Signing and Verifying files
-
-  If you're uploading files to launchpad you may also want to include
-  a GPG signature file.
-
-    gpg -ba filename
-
-  or if you need to specify a particular key:
-
-    gpg --default-key <key ID> -ba filename
-
-  This then produces a file with a .asc extension which can be uploaded.
-  If you need to set the default key more permanently then edit the
-  file ~/.gnupg/gpg.conf and set the default-key parameter.
-
-  To verify a downloaded file using its signature file.
-
-  gpg --verify filename.asc
-
-# Signing Public Keys
-
-  Import the public key or retrieve it from a server.
-
-    gpg --keyserver <keyserver> --recv-keys <Key_ID>
-
-  Check its fingerprint against any previously stated value.
-
-    gpg --fingerprint <Key_ID>
-
-  Sign the key.
-
-    gpg --sign-key <Key_ID>
-
-  Upload the signed key to a server.
-
-    gpg --keyserver <keyserver> --send-key <Key_ID>
-
-# Change the email address associated with a GPG key
-
-  gpg --edit-key <key ID>
-  adduid
-
-  Enter the new name and email address. You can then list the addresses with:
-
-    list
-
-  If you want to delete a previous email address first select it:
-
-    uid <list number>
-
-  Then delete it with:
-
-    deluid
-
-  To finish type:
-
-    save
-
-  Publish the key to a server:
-
-    gpg --send-keys <key ID>
-
-# Creating Subkeys
-
-  Subkeys can be useful if you don't wish to have your main GPG key
-  installed on multiple machines. In this way you can keep your
-  master key safe and have subkeys with expiry periods or which may be
-  separately revoked installed on various machines. This avoids
-  generating entirely separate keys and so breaking any web of trust
-  which has been established.
-
-    gpg --edit-key <key ID>
-
-  At the prompt type:
-
-    addkey
-
-  Choose RSA (sign only), 4096 bits and select an expiry period.
-  Entropy will be gathered.
-
-  At the prompt type:
-
-    save
-
-  You can also repeat the procedure, but selecting RSA (encrypt only).
-  To remove the master key, leaving only the subkey/s in place:
-
-    gpg --export-secret-subkeys <subkey ID> > subkeys
-    gpg --export <key ID> > pubkeys
-    gpg --delete-secret-key <key ID>
-
-  Import the keys back.
-
-    gpg --import pubkeys subkeys
-
-  Verify the import.
-
-    gpg -K
-
-  Should show sec# instead of just sec.

cheat/cheatsheets/grep

@@ -1,29 +0,0 @@
-# Search a file for a pattern
-grep pattern file
-
-# Case insensitive search (with line numbers)
-grep -in pattern file
-
-# Recursively grep for string <pattern> in folder:
-grep -R pattern folder
-
-# Read search patterns from a file (one per line)
-grep -f pattern_file file
-
-# Find lines NOT containing pattern
-grep -v pattern file
-
-# You can grep with regular expressions
-grep "^00" file  #Match lines starting with 00
-grep -E "[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}" file  #Find IP add
-
-# Find all files which match {pattern} in {directory}
-# This will show: "file:line my research"
-grep -rnw 'directory' -e "pattern"
-
-# Exclude grep from your grepped output of ps.
-# Add [] to the first letter. Ex: sshd -> [s]shd
-ps aux | grep '[h]ttpd'
-
-# Colour in red {bash} and keep all other lines
-ps aux | grep -E --color 'bash|$'

cheat/cheatsheets/gs

@@ -1,3 +0,0 @@
-# To reduce the size of a pdf file:
-gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -sOutputFile=output.pdf input.pdf
-

cheat/cheatsheets/gyb

@@ -1,12 +0,0 @@
-# To estimate the number and the size of all mails on youremail@gmail.com
-gyb --email youremail@gmail.com --action estimate
-
-# To backup from youremail@gmail.com to your local-folder 
-gyb --email youremail@gmail.com --action backup --local-folder "~/MyLocalFolder/"
-
-# To backup from youremail@gmail.com only important or starred emails to the
-# default local folder GYB-GMail-Backup-youremail@gmail.com
-gyb --email youremail@gmail.com --search "is:important OR is:starred"
-
-# To restore from your local-folder to youremail@gmail.com
-gyb --email youremail@gmail.com --action restore --local-folder "~/MyLocalFolder/" 

cheat/cheatsheets/gzip

@@ -1,17 +0,0 @@
-# To create a *.gz compressed file
-gzip test.txt
-
-# To create a *.gz compressed file to a specific location using -c option (standard out)
-gzip -c test.txt > test_custom.txt.gz
-
-# To uncompress a *.gz file
-gzip -d test.txt.gz
-
-# Display compression ratio of the compressed file using gzip -l
-gzip -l *.gz
-
-# Recursively compress all the files under a specified directory
-gzip -r documents_directory
-
-# To create a *.gz compressed file and keep the original
-gzip < test.txt > test.txt.gz

cheat/cheatsheets/hardware-info

@@ -1,32 +0,0 @@
-# Display all hardware details
-sudo lshw
-
-# List currently loaded kernel modules
-lsmod
-
-# List all modules available to the system
-find /lib/modules/$(uname -r) -type f -iname "*.ko"
-
-# Load a module into kernel
-modprobe modulename
-
-# Remove a module from kernel 
-modprobe -r modulename
-
-# List devices connected via pci bus
-lspci
-
-# Debug output for pci devices (hex)
-lspci -vvxxx
-
-# Display cpu hardware stats
-cat /proc/cpuinfo
-
-# Display memory hardware stats
-cat /proc/meminfo
-
-# Output the kernel ring buffer
-dmesg
-
-# Ouput kernel messages
-dmesg --kernel

cheat/cheatsheets/head

@@ -1,8 +0,0 @@
-# To show the first 10 lines of file
-head file
-
-# To show the first N lines of file
-head -n N file
-
-# To show the first N bytes of file
-head -c N file

cheat/cheatsheets/hg

@@ -1,20 +0,0 @@
-# Clone a directory
-hg clone
-
-# Add files to hg tracker
-hg add filename
-
-# Add all files in a folder to hg tracker
-hg add folder/
-
-# Create a commit with all tracked changes and a message
-hg commit -m "message"
-
-# Push commits to source repository
-hg push
-
-# Pull changes from source repository
-hg pull
-
-# Rebase local commits to disambiguate with remote repository
-hg pull --rebase

cheat/cheatsheets/history

@@ -1,3 +0,0 @@
-# To see most used top 10 commands:
-history | awk '{CMD[$2]++;count++;}END { for (a in CMD)print CMD[a] " " CMD[a]/count*100 "% " a;}' | grep -v "./" | column -c3 -s " " -t | sort -nr | nl | head -n10
-

cheat/cheatsheets/http

@@ -1,195 +0,0 @@
-# Custom HTTP method HTTP headers and JSON data:
-http PUT example.org X-API-Token:123 name=John
-
-# Submitting forms:
-http -f POST example.org hello=World
-
-# See the request that is being sent using one of the output options:
-http -v example.org
-
-# Use Github API to post a comment on an issue with authentication:
-http -a USERNAME POST https://api.github.com/repos/jkbrzt/httpie/issues/83/comments body='HTTPie is awesome!'
-
-# Upload a file using redirected input:
-http example.org < file.json
-
-# Download a file and save it via redirected output:
-http example.org/file > file
-
-# Download a file wget style:
-http --download example.org/file
-
-# Use named sessions_ to make certain aspects or the communication
-# persistent between requests to the same host:
-# http --session=logged-in -a username:password httpbin.org/get API-Key:123
-http --session=logged-in httpbin.org/headers
-
-# Set a custom Host header to work around missing DNS records:
-http localhost:8000 Host:example.com
-
-# Simple JSON example:
-http PUT example.org name=John email=john@example.org
-
-# Non-string fields use the := separator, which allows you to embed raw
-# JSON into the resulting object. Text and raw JSON files can also be
-# embedded into fields using =@ and :=@:
-http PUT api.example.com/person/1 name=John age:=29 married:=false hobbies:='["http", "pies"]' description=@about-john.txt bookmarks:=@bookmarks.json
-
-# Send JSON data stored in a file:
-http POST api.example.com/person/1 < person.json
-
-# Regular Forms
-http --form POST api.example.org/person/1 name='John Smith' email=john@example.org cv=@~/Documents/cv.txt
-
-# File Upload Forms
-# If one or more file fields is present, the serialization and content
-# type is multipart/form-data:
-http -f POST example.com/jobs name='John Smith' cv@~/Documents/cv.pdf
-
-# To set custom headers you can use the Header:Value notation:
-http example.org  User-Agent:Bacon/1.0  'Cookie:valued-visitor=yes;foo=bar' X-Foo:Bar  Referer:http://httpie.org/
-
-# Basic auth:
-http -a username:password example.org
-
-# Digest auth:
-http --auth-type=digest -a username:password example.org
-
-# With password prompt:
-http -a username example.org
-
-# Authorization information from your ~/.netrc file is honored as well:
-cat ~/.netrc
-    machine httpbin.org
-    login httpie
-    # password test
-http httpbin.org/basic-auth/httpie/test
-
-# You can specify proxies to be used through the --proxy argument for each
-# protocol (which is included in the value in case of redirects across
-# protocols):
-http --proxy=http:http://10.10.1.10:3128 --proxy=https:https://10.10.1.10:1080 example.org
-
-# With Basic authentication:
-http --proxy=http:http://user:pass@10.10.1.10:3128 example.org
-
-# To skip the HOST'S SSL CERTIFICATE VERIFICATION, you can pass
-# --verify=no (default is yes):
-http --verify=no https://example.org
-
-# You can also use --verify=<CA_BUNDLE_PATH> to set a CUSTOM CA BUNDLE path:
-http --verify=/ssl/custom_ca_bundle https://example.org
-
-# To use a CLIENT SIDE CERTIFICATE for the SSL communication, you can pass
-# the path of the cert file with --cert:
-http --cert=client.pem https://example.org
-
-# If the PRIVATE KEY is not contained in the cert file you may pass the
-# path of the key file with --cert-key:
-http --cert=client.crt --cert-key=client.key https://example.org
-
-# You can control what should be printed via several options:
-  # --headers, -h   Only the response headers are printed.
-  # --body, -b      Only the response body is printed.
-  # --verbose, -v   Print the whole HTTP exchange (request and response).
-  # --print, -p     Selects parts of the HTTP exchange.
-http --verbose PUT httpbin.org/put hello=world
-
-# Print request and response headers:
-  # Character   Stands for
-  # ----------- -------------------
-  # H           Request headers.
-  # B           Request body.
-  # h           Response headers.
-  # b           Response body.
-http --print=Hh PUT httpbin.org/put hello=world
-
-# Let's say that there is an API that returns the whole resource when it
-# is updated, but you are only interested in the response headers to see
-# the status code after an update:
-http --headers PATCH example.org/Really-Huge-Resource name='New Name'
-
-# Redirect from a file:
-http PUT example.com/person/1 X-API-Token:123 < person.json
-
-# Or the output of another program:
-grep '401 Unauthorized' /var/log/httpd/error_log | http POST example.org/intruders
-
-# You can use echo for simple data:
-echo '{"name": "John"}' | http PATCH example.com/person/1 X-API-Token:123
-
-# You can even pipe web services together using HTTPie:
-http GET https://api.github.com/repos/jkbrzt/httpie | http POST httpbin.org/post
-
-# You can use cat to enter multiline data on the terminal:
-cat | http POST example.com
-    <paste>
-    # ^D
-cat | http POST example.com/todos Content-Type:text/plain
-    - buy milk
-    - call parents
-    ^D
-
-# On OS X, you can send the contents of the clipboard with pbpaste:
-pbpaste | http PUT example.com
-
-# Passing data through stdin cannot be combined with data fields specified
-# on the command line:
-echo 'data' | http POST example.org more=data   # This is invalid
-
-
-# AN ALTERNATIVE TO REDIRECTED stdin is specifying a filename (as
-# @/path/to/file) whose content is used as if it came from stdin.
-
-# It has the advantage that THE Content-Type HEADER IS AUTOMATICALLY SET
-# to the appropriate value based on the filename extension. For example,
-# the following request sends the verbatim contents of that XML file with
-# Content-Type: application/xml:
-http PUT httpbin.org/put @/data/file.xml
-
-# Download a file:
-http example.org/Movie.mov > Movie.mov
-
-# Download an image of Octocat, resize it using ImageMagick, upload it
-# elsewhere:
-http octodex.github.com/images/original.jpg | convert - -resize 25% -  | http example.org/Octocats
-
-# Force colorizing and formatting, and show both the request and the
-# response in less pager:
-http --pretty=all --verbose example.org | less -R
-
-# When enabled using the --download, -d flag, response headers are printed
-# to the terminal (stderr), and a progress bar is shown while the response
-# body is being saved to a file.
-http --download https://github.com/jkbrzt/httpie/tarball/master
-
-# You can also redirect the response body to another program while the
-# response headers and progress are still shown in the terminal:
-http -d https://github.com/jkbrzt/httpie/tarball/master |  tar zxf -
-
-# If --output, -o is specified, you can resume a partial download using
-# the --continue, -c option. This only works with servers that support
-# Range requests and 206 Partial Content responses. If the server doesn't
-# support that, the whole file will simply be downloaded:
-http -dco file.zip example.org/file
-
-# Prettified streamed response:
-http --stream -f -a YOUR-TWITTER-NAME https://stream.twitter.com/1/statuses/filter.json track='Justin Bieber'
-
-# Send each new tweet (JSON object) mentioning "Apple" to another
-# server as soon as it arrives from the Twitter streaming API:
-http --stream -f -a YOUR-TWITTER-NAME https://stream.twitter.com/1/statuses/filter.json track=Apple | while read tweet; do echo "$tweet" | http POST example.org/tweets ; done
-
-# Create a new session named user1 for example.org:
-http --session=user1 -a user1:password example.org X-Foo:Bar
-
-# Now you can refer to the session by its name, and the previously used
-# authorization and HTTP headers will automatically be set:
-http --session=user1 example.org
-
-# To create or reuse a different session, simple specify a different name:
-http --session=user2 -a user2:password example.org X-Bar:Foo
-
-# Instead of a name, you can also directly specify a path to a session
-# file. This allows for sessions to be re-used across multiple hosts:
-http --session=/tmp/session.json example.orghttp --session=/tmp/session.json admin.example.orghttp --session=~/.httpie/sessions/another.example.org/test.json example.orghttp --session-read-only=/tmp/session.json example.org

cheat/cheatsheets/hub

@@ -1,74 +0,0 @@
-As a contributor to open-source
--------------------------------
-
-# clone your own project
-$ git clone dotfiles
-→ git clone git://github.com/YOUR_USER/dotfiles.git
-
-# clone another project
-$ git clone github/hub
-→ git clone git://github.com/github/hub.git
-
-# see the current project's issues
-$ git browse -- issues
-→ open https://github.com/github/hub/issues
-
-# open another project's wiki
-$ git browse mojombo/jekyll wiki
-→ open https://github.com/mojombo/jekyll/wiki
-
-## Example workflow for contributing to a project:
-$ git clone github/hub
-$ cd hub
-# create a topic branch
-$ git checkout -b feature
-→ ( making changes ... )
-$ git commit -m "done with feature"
-# It's time to fork the repo!
-$ git fork
-→ (forking repo on GitHub...)
-→ git remote add YOUR_USER git://github.com/YOUR_USER/hub.git
-# push the changes to your new remote
-$ git push YOUR_USER feature
-# open a pull request for the topic branch you've just pushed
-$ git pull-request
-→ (opens a text editor for your pull request message)
-
-
-As an open-source maintainer
-----------------------------
-
-# fetch from multiple trusted forks, even if they don't yet exist as remotes
-$ git fetch mislav,cehoffman
-→ git remote add mislav git://github.com/mislav/hub.git
-→ git remote add cehoffman git://github.com/cehoffman/hub.git
-→ git fetch --multiple mislav cehoffman
-
-# check out a pull request for review
-$ git checkout https://github.com/github/hub/pull/134
-→ (creates a new branch with the contents of the pull request)
-
-# directly apply all commits from a pull request to the current branch
-$ git am -3 https://github.com/github/hub/pull/134
-
-# cherry-pick a GitHub URL
-$ git cherry-pick https://github.com/xoebus/hub/commit/177eeb8
-→ git remote add xoebus git://github.com/xoebus/hub.git
-→ git fetch xoebus
-→ git cherry-pick 177eeb8
-
-# `am` can be better than cherry-pick since it doesn't create a remote
-$ git am https://github.com/xoebus/hub/commit/177eeb8
-
-# open the GitHub compare view between two releases
-$ git compare v0.9..v1.0
-
-# put compare URL for a topic branch to clipboard
-$ git compare -u feature | pbcopy
-
-# create a repo for a new project
-$ git init
-$ git add . && git commit -m "It begins."
-$ git create -d "My new thing"
-→ (creates a new project on GitHub with the name of current directory)
-$ git push origin master

cheat/cheatsheets/iconv

@@ -1,3 +0,0 @@
-# To convert file (iconv.src) from iso-8859-1 to utf-8 and save to
-# /tmp/iconv.out
-iconv -f iso-8859-1 -t utf-8 iconv.src -o /tmp/iconv.out

cheat/cheatsheets/ifconfig

@@ -1,14 +0,0 @@
-# Display network settings of the first ethernet adapter
-ifconfig wlan0
-
-# Display all interfaces, even if down
-ifconfig -a
-
-# Take down / up the wireless adapter
-ifconfig wlan0 {up|down} 
-
-# Set a static IP and netmask
-ifconfig eth0 192.168.1.100 netmask 255.255.255.0
-
-# You may also need to add a gateway IP
-route add -net 192.168.1.0 netmask 255.255.255.0 gw 192.168.1.1

cheat/cheatsheets/indent

@@ -1,2 +0,0 @@
-# format C/C++ source according to the style of Kernighan and Ritchie (K&R), no tabs, 3 spaces per indent, wrap lines at 120 characters.
-indent -i3 -kr -nut -l120

cheat/cheatsheets/ip

@@ -1,32 +0,0 @@
-# Display all interfaces with addresses
-ip addr
-
-# Take down / up the wireless adapter
-ip link set dev wlan0 {up|down}
-
-# Set a static IP and netmask
-ip addr add 192.168.1.100/32 dev eth0
-
-# Remove a IP from an interface
-ip addr del 192.168.1.100/32 dev eth0
-
-# Remove all IPs from an interface
-ip address flush dev eth0
-
-# Display all routes
-ip route
-
-# Display all routes for IPv6
-ip -6 route
-
-# Add default route via gateway IP
-ip route add default via 192.168.1.1
-
-# Add route via interface
-ip route add 192.168.0.0/24 dev eth0
-
-# Change your mac address 
-ip link set dev eth0 address aa:bb:cc:dd:ee:ff
-
-# View neighbors (using ARP and NDP) 
-ip neighbor show

cheat/cheatsheets/iptables

@@ -1,40 +0,0 @@
-# Show hit for rules with auto refresh
-watch --interval 0 'iptables -nvL | grep -v "0     0"'
-
-# Show hit for rule with auto refresh and highlight any changes since the last refresh
-watch -d -n 2 iptables -nvL
-
-# Block the port 902 and we hide this port from nmap.
-iptables -A INPUT -i eth0 -p tcp --dport 902 -j REJECT --reject-with icmp-port-unreachable
-
-# Note, --reject-with accept:
-#	icmp-net-unreachable
-#	icmp-host-unreachable
-#	icmp-port-unreachable <- Hide a port to nmap
-#	icmp-proto-unreachable
-#	icmp-net-prohibited
-#	icmp-host-prohibited or
-#	icmp-admin-prohibited
-#	tcp-reset
-
-# Add a comment to a rule:
-iptables ... -m comment --comment "This rule is here for this reason"
-
-
-# To remove or insert a rule:
-# 1) Show all rules
-iptables -L INPUT --line-numbers
-# OR iptables -nL --line-numbers
-
-# Chain INPUT (policy ACCEPT)
-#     num  target prot opt source destination
-#     1    ACCEPT     udp  --  anywhere  anywhere             udp dpt:domain
-#     2    ACCEPT     tcp  --  anywhere  anywhere             tcp dpt:domain
-#     3    ACCEPT     udp  --  anywhere  anywhere             udp dpt:bootps
-#     4    ACCEPT     tcp  --  anywhere  anywhere             tcp dpt:bootps
-
-# 2.a) REMOVE (-D) a rule. (here an INPUT rule)
-iptables -D INPUT 2
-
-# 2.b) OR INSERT a rule.
-iptables -I INPUT {LINE_NUMBER} -i eth1 -p tcp --dport 21 -s 123.123.123.123 -j ACCEPT -m comment --comment "This rule is here for this reason"

cheat/cheatsheets/irssi

@@ -1,33 +0,0 @@
-# To connect to an IRC server
-/connect <server domain name>
-
-# To join a channel
-/join #<channel name>
-
-# To set a nickname
-/nick <my nickname>
-
-# To send a private message to a user
-/msg <nickname>
-
-# To close the current channel window
-/wc
-
-# To switch between channel windows
-ALT+<number>, eg. ALT+1, ALT+2
-
-# To list the nicknames within the active channel
-/names
-
-# To change the channel topic
-/topic <description>
-
-# To limit channel background noise (joins, parts, quits, etc.)
-/ignore #foo,#bar JOINS PARTS QUITS NICKS   # Quieten only channels `#foo`, `#bar`
-/ignore * JOINS PARTS QUITS NICKS           # Quieten all channels
-
-# To save the current Irssi session config into the configuration file
-/save
-
-# To quit Irssi
-/exit

cheat/cheatsheets/iwconfig

@@ -1,8 +0,0 @@
-# Display wireless settings of the first wireless adapter
-iwconfig wlan0
-
-# Take down / up the wireless adapter
-iwconfig wlan0 txpower {on|auto|off}
-
-# Change the mode of the wireless adapter
-iwconfig wlan0 mode {managed|ad-hoc|monitor}

cheat/cheatsheets/journalctl

@@ -1,32 +0,0 @@
-# Actively follow log (like tail -f)
-journalctl -f
-
-# Display all errors since last boot
-journalctl -b -p err
-
-# Filter by time period
-journalctl --since=2012-10-15 --until="2011-10-16 23:59:59"
-
-# Show list of systemd units logged in journal
-journalctl -F _SYSTEMD_UNIT
-
-# Filter by specific unit
-journalctl -u dbus
-
-# Filter by executable name
-journalctl /usr/bin/dbus-daemon
-
-# Filter by PID
-journalctl _PID=123
-
-# Filter by Command, e.g., sshd
-journalctl _COMM=sshd
-
-# Filter by Command and time period
-journalctl _COMM=crond --since '10:00' --until '11:00'
-
-# List all available boots 
-journalctl --list-boots
-
-# Filter by specific User ID e.g., user id 1000 
-journalctl _UID=1000

cheat/cheatsheets/jq

@@ -1,13 +0,0 @@
-# Pretty print the json
-jq "." < filename.json
-
-# Access the value at key "foo"
-jq '.foo'
-
-# Access first list item
-jq '.[0]'
-
-# Slice & Dice
-jq '.[2:4]'
-jq '.[:3]'
-jq '.[-2:]'

cheat/cheatsheets/jrnl

@@ -1,25 +0,0 @@
-# Add entry to default jrnl (from your configured text editor)
-jrnl
-
-# Add entry to default jrnl
-jrnl Write entry here.
-
-# List of tags
-jrnl --tags
-
-# Entries per tag
-jrnl @tag
-
-# Export jrnl as json
-jrnl --export json
-
-# Entries in a timeframe
-jrnl -from 2009 -until may
-
-# Add Sublime text to .jrnl_config
-
-# Windows
-"editor": "F:\\Powerpack\\Sublime\\sublime_text.exe -w"
-
-# Linux
-"editor": "/usr/bin/sublime -w"

cheat/cheatsheets/kill

@@ -1,5 +0,0 @@
-# Kill a process gracefully
-kill -15 <process id>
-
-# Kill a process forcefully
-kill -9 <process id>

cheat/cheatsheets/less

@@ -1,9 +0,0 @@
-# To disable the terminal refresh when exiting
-less -X
-
-# To save the contents to a file
-# Method 1 - Only works when the input is a pipe
-s <filename>
-
-# Method 2 - This should work whether input is a pipe or an ordinary file.
-Type g or < (g or less-than) | $ (pipe then dollar) then cat > <filename> and Enter.

cheat/cheatsheets/lib

@@ -1,23 +0,0 @@
-# Display available libraries
-ldconfig -p
-
-# Update library resources
-ldconfig
-
-# Display libraries and file location
-ldd
-
-# Libraries available to apps in real-time
-"Dynamic Libraries" (.so.)
-
-# Libraries only available to apps when installed (imported)
-"Static Libraries" (.a.)
-
-# Standard (usual) library file location
-/lib
-
-# Sofware-accessible source for library info 
-/etc/ld.so.cache 	# (binary)
-
-# Human-readable source for library info
-/etc/ld.so.conf 	# (points to /etc/ld.so.conf.d)

cheat/cheatsheets/ln

@@ -1,5 +0,0 @@
-# To create a symlink:
-ln -s path/to/the/target/directory name-of-symlink
-
-# Symlink, while overwriting existing destination files
-ln -sf /some/dir/exec /usr/bin/exec

cheat/cheatsheets/ls

@@ -1,17 +0,0 @@
-# Displays everything in the target directory
-ls path/to/the/target/directory
-
-# Displays everything including hidden files
-ls -a
-
-# Displays all files, along with the size (with unit suffixes) and timestamp
-ls -lh 
-
-# Display files, sorted by size
-ls -S
-
-# Display directories only
-ls -d */
-
-# Display directories only, include hidden
-ls -d .*/ */

cheat/cheatsheets/lsblk

@@ -1,21 +0,0 @@
-# Show all available block devices along with their partitioning schemes
-lsblk
-
-# To show SCSI devices:
-lsblk --scsi
-
-# To show a specific device
-lsblk /dev/sda
-
-# To verify TRIM support:
-# Check the values of DISC-GRAN (discard granularity) and DISC-MAX (discard max bytes) columns.
-# Non-zero values indicate TRIM support
-lsblk --discard
-
-# To featch info about filesystems:
-lsblk --fs
-
-# For JSON, LIST or TREE output formats use the following flags:
-lsblk --json
-lsblk --list
-lsblk --tree # default view