From 1c7eea08e30fd7295de85a4b3966fef651c00b9b Mon Sep 17 00:00:00 2001 From: JMARyA Date: Fri, 31 Jan 2025 20:10:15 +0100 Subject: [PATCH] update --- technology/applications/Applications.md | 3 + technology/applications/cli/csvlens.md | 80 +++++++++++++++++++ technology/applications/cli/timr-tui.md | 23 ++++++ .../applications/development/licensit.md | 66 +++++++++++++++ 4 files changed, 172 insertions(+) create mode 100644 technology/applications/cli/csvlens.md create mode 100644 technology/applications/cli/timr-tui.md create mode 100644 technology/applications/development/licensit.md diff --git a/technology/applications/Applications.md b/technology/applications/Applications.md index 398209b..5ac52a2 100644 --- a/technology/applications/Applications.md +++ b/technology/applications/Applications.md @@ -199,6 +199,7 @@ rev: 2025-01-30 - [bat](./cli/bat.md) - [glow](./cli/glow.md) - [tailspin](./cli/tailspin.md) +- [csvlens](./cli/csvlens.md) ### Editor - [nano](./cli/nano.md) @@ -248,6 +249,7 @@ rev: 2025-01-30 - [refold](./cli/refold.md) - [rexturl](./cli/rexturl.md) - [mhost](./cli/mhost.md) +- [timr-tui](./cli/timr-tui.md) ## System - [Core Utils](./cli/system/Core%20Utils.md) @@ -279,6 +281,7 @@ rev: 2025-01-30 - [serie](./cli/serie.md) - [usql](./cli/usql.md) - [kondo](./cli/kondo.md) +- [licensit](./development/licensit.md) ## Media - [yt-dlp](./media/yt-dlp.md) diff --git a/technology/applications/cli/csvlens.md b/technology/applications/cli/csvlens.md new file mode 100644 index 0000000..4ebb5be --- /dev/null +++ b/technology/applications/cli/csvlens.md @@ -0,0 +1,80 @@ +--- +obj: application +repo: https://github.com/ys-l/csvlens +rev: 2025-01-31 +--- + +# csvlens +`csvlens` is a command line CSV file viewer. It is like `less` but made +for CSV. + +## Usage +Run `csvlens` by providing the CSV filename: + +``` +csvlens +``` + +Pipe CSV data directly to `csvlens`: + +``` + | csvlens +``` + +### Key bindings + +| Key | Action | +| ---------------------------- | ------------------------------------------------------------------ | +| `hjkl` (or `← ↓ ↑→ `) | Scroll one row or column in the given direction | +| `Ctrl + f` (or `Page Down`) | Scroll one window down | +| `Ctrl + b` (or `Page Up`) | Scroll one window up | +| `Ctrl + d` (or `d`) | Scroll half a window down | +| `Ctrl + u` (or `u`) | Scroll half a window up | +| `Ctrl + h` | Scroll one window left | +| `Ctrl + l` | Scroll one window right | +| `Ctrl + ←` | Scroll left to first column | +| `Ctrl + →` | Scroll right to last column | +| `G` (or `End`) | Go to bottom | +| `g` (or `Home`) | Go to top | +| `G` | Go to line `n` | +| `/` | Find content matching regex and highlight matches | +| `n` (in Find mode) | Jump to next result | +| `N` (in Find mode) | Jump to previous result | +| `&` | Filter rows using regex (show only matches) | +| `*` | Filter columns using regex (show only matches) | +| `TAB` | Toggle between row, column or cell selection modes | +| `>` | Increase selected column's width | +| `<` | Decrease selected column's width | +| `Shift + ↓` (or `Shift + j`) | Sort rows or toggle sort direction by the selected column | +| `#` (in Cell mode) | Find and highlight rows like the selected cell | +| `@` (in Cell mode) | Filter rows like the selected cell | +| `y` | Copy the selected row or cell to clipboard | +| `Enter` (in Cell mode) | Print the selected cell to stdout and exit | +| `-S` | Toggle line wrapping | +| `-W` | Toggle line wrapping by words | +| `r` | Reset to default view (clear all filters and custom column widths) | +| `H` (or `?`) | Display help | +| `q` | Exit | + +### Optional parameters + +* `-d `: Use this delimiter when parsing the CSV + (e.g. `csvlens file.csv -d '\t'`). + + Specify `-d auto` to auto-detect the delimiter. + +* `-t`, `--tab-separated`: Use tab as the delimiter (when specified, `-d` is ignored). + +* `-i`, `--ignore-case`: Ignore case when searching. This flag is ignored if any + uppercase letters are present in the search string. + +* `--no-headers`: Do not interpret the first row as headers. + +* `--columns `: Use this regex to select columns to display by default. + +* `--filter `: Use this regex to filter rows to display by default. + +* `--find `: Use this regex to find and highlight matches by default. + +* `--echo-column `: Print the value of this column at the selected + row to stdout on `Enter` key and then exit. diff --git a/technology/applications/cli/timr-tui.md b/technology/applications/cli/timr-tui.md new file mode 100644 index 0000000..a4d4acc --- /dev/null +++ b/technology/applications/cli/timr-tui.md @@ -0,0 +1,23 @@ +--- +obj: application +repo: https://github.com/sectore/timr-tui +rev: 2025-01-31 +--- + +# timr-tui +TUI to organize your time: Pomodoro, Countdown, Timer. + +## CLI +Usage: `timr-tui [OPTIONS]` + +| Option | Description | +| -------- | ----------------------------------------------------------------------------------------------- | +| `–c` | Countdown time to start from. Formats: 'ss', 'mm:ss', or 'hh:mm:ss' | +| `–w` | Work time to count down from. Formats: 'ss', 'm:ss', or 'h:mm:s' | +| `–p` | Pause time to count down from. Formats: 'ss', 'm:ss', or 'h:m:s' | +| `–d` | Show deciseconds | +| `–m` | Mode to start with. [possible values: countdown, timer, pomodoro] | +| `–s` | Style to display time with. [possible values: full, light, medium, dark, thick, cross, braille] | +| `--menu` | Open the menu | +| `–r` | Reset stored values to default values. | +| `–n` | Toggle desktop notifications on or off. Experimental. [possible values: on, off] | diff --git a/technology/applications/development/licensit.md b/technology/applications/development/licensit.md new file mode 100644 index 0000000..3dab595 --- /dev/null +++ b/technology/applications/development/licensit.md @@ -0,0 +1,66 @@ +--- +obj: application +repo: https://github.com/neuromeow/licensit +rev: 2025-01-31 +--- + +# licensit +`licensit` is a command-line tool to create LICENSE files. + +### Supported licenses + +- GNU Affero General Public License v3.0 (AGPL-3.0) +- Apache License 2.0 (Apache-2.0) +- BSD 2-Clause “Simplified” License (BSD-2-Clause) +- BSD 3-Clause “New” or “Revised” License (BSD-3-Clause) +- Boost Software License 1.0 (BSL-1.0) +- Creative Commons Zero v1.0 Universal (CC0-1.0) +- Eclipse Public License 2.0 (EPL-2.0) +- GNU General Public License v2.0 (GPL-2.0) +- GNU General Public License v3.0 (GPL-3.0) +- GNU Lesser General Public License v2.1 (LGPL-2.1) +- MIT License (MIT) +- Mozilla Public License 2.0 (MPL-2.0) +- The Unlicense (Unlicense) + +## Usage +`licensit` simplifies the process of creating and managing license files for your projects. + +### Listing Available Licenses +``` +licensit list +``` + +Shows all supported licenses. + +### Showing License Content +To view the content of a specific license with the author and year filled in: + +``` +licensit show [LICENSE] [--user USER] [--year YEAR] +``` + +- `[LICENSE]`: The ID of the license you want to display (for example, `mit`, `apache-2.0`) +- `--user [USER]`: Specifies the license holder's name. If not provided, `licensit` will use the following sources in order to determine the user name: + - `LICENSE_AUTHOR` environment variable + - `user.name` entry in the `$HOME/.gitconfig` file + - Username associated with the current effective user ID +- `--year [YEAR]`: Sets the year during which the license is effective. Defaults to the current year if not specified + +To display just the template of a license (without any specific user or year information): + +``` +licensit show [LICENSE] --template +``` + +- `[LICENSE]`: The ID of the license whose template you want to display (for example, `mit`, `apache-2.0`) +- `--template`: Displays the license template with placeholders for the user and year. This option cannot be used with `--user` or `--year` + +### Adding a License to Your Project +To add a license file to your current directory: + +``` +licensit add [LICENSE] [--user USER] [--year YEAR] +``` + +Creates a `LICENSE` file in the current directory with the specified details.