https://github.com/brenordv/go-help
https://github.com/brenordv/go-help
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/brenordv/go-help
- Owner: brenordv
- Created: 2024-06-17T00:55:37.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-11-08T01:30:21.000Z (8 months ago)
- Last Synced: 2025-01-20T08:13:03.074Z (5 months ago)
- Language: Go
- Size: 20.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Go Help!
This repo contains a bunch of small apps that I find useful for my day-to-day work. I hope you find them useful too!
Some of them already exists on Linux, but since I'm stuck on Windows, I decided to create my own. :D
# List of utilities
## guid
Generates a GUID and (optionally) copies it to the clipboard.
```text
---------------------------------------------------
Usage: guid [-c]
-c Execute with -c to copy the guid to the clipboard
---------------------------------------------------
Version: 1.0.0
```
## touch
Mimics the functionality of the 'touch' command in Linux.
Good app to have on Windows, if you're used to Linux.
```text
---------------------------------------------------
Usage: touch [-t] ...
-t Execute with -t to display the current time after touching the file
---------------------------------------------------
version: 1.0.0
```
## cat
Mimics the behavior of the Linux 'cat' command.
Probably not really useful if you have the Linux subsystem installed (or if you're actually using linux), but it's a
fun project to work on.
```text
---------------------------------------------------
Usage: gocat [-i] [filename]...
-i Read from stdin if no files are provided
---------------------------------------------------
version: 1.0.0
-i Execute with -i to read from stdin if no files are provided
```
### TODO
1. Add > redirection
2. Add >> redirection
3. Add -n (show line numbers) support
## ts
A simple utility to convert Unix timestamps to date time and vice versa. It also supports the conversion of date time.
```text
---------------------------------------------------
Usage:
no parameters : Prints the current time as a Unix timestamp
: Converts the Unix timestamp to UTC and local date time
: Converts the date time to a Unix timestamp
-h, --help : Prints this help message
---------------------------------------------------
```
## ncsv
CSV file normalizer. This utility reads a CSV file and tries to normalize the data in a shape-wise manner, making the
data columns match the header columns. This normalization is naive, and just considers position and not the actual data.
Any mismatched data will be saved in a separate file.
You can also split the output into multiple files using the `--split` option, and speed up the process by increasing the
concurrency level using the `--concurrency` option.
Why use this?
Maybe you have a huge CSV file with mismatched columns, and you want to import it to a database (like Postgres). With
this tool you don't have to create a script to prepare the data, this app will do a position normalization of the data
so you can import and analyze it later.
(I might create a csv 2 json app later, so you can also import the data to a NoSQL database)
```text
---------------------------------------------------
Usage: ncsv [options]
--header, -e : Use value as the header (columns separated by commas)
--file, -f : Path to the input CSV file (required)
--split, -s : Number of lines per output file
--print-every, -p : Print status every X lines (default: 500)
--concurrency, -c : Concurrency level (buffer sizes) (default: 1000)
---------------------------------------------------
```
## get-lines
Searches for specific text within a file and outputs the lines containing the text. Supports parallel processing for
faster search.
```text
---------------------------------------------------
Usage: get-lines [options]
--search, -s : Comma-separated list of texts to search for (case-insensitive) (required)
--file, -f : Path to the input file (required)
--output, -o : Output folder name (optional)
--workers, -w : Number of workers for parallel processing (default: 1)
--help, -h : Display help information
---------------------------------------------------
```
Example:
```shell
get-lines -s "error,warning" -f "C:\path\to\file.log" -o "C:\path\to\output" -w 4
```
Result: The output folder will contain two files: `error.txt` and `warning.txt` with the lines containing the words