https://github.com/roguh/fix_fish_history
Fix a fish_history file or merge many fish_history files
https://github.com/roguh/fix_fish_history
Last synced: 25 days ago
JSON representation
Fix a fish_history file or merge many fish_history files
- Host: GitHub
- URL: https://github.com/roguh/fix_fish_history
- Owner: roguh
- License: unlicense
- Created: 2023-12-10T02:01:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-10T04:40:26.000Z (over 2 years ago)
- Last Synced: 2026-04-07T06:36:27.794Z (2 months ago)
- Language: Python
- Size: 9.77 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fix_fish_history.py
Running this fixer on a fish_history file converts it into valid YAML.
This makes it easy to run any standard YAML parser on the output.
For example, this allows easily querying or sorting the YAML output.
No guarantee that fish can read the transformed YAML.
(TODO) In this case, this script should log and remove the unparseable lines instead of attempting to fix them.
(TODO) Does not work with DOS `\r\n` newlines yet.
## Fix some unparseable YAML lines and sort history
```bash
$ ./fix_fish_history.py file1 -o outputfile
```
## Merge N fish history files
They need to be sorted so that fish will parse the output correctly.
```bash
$ ./fix_fish_history.py file1 file2 file3 -o outputfile
```
## Usage
```bash
$ fix_fish_history --help
usage: fix_fish_history.py [-h] [--run-pytests] [--lint] [--verbose]
[--nosort] [--noparsefix] [--append]
[--out-fname OUT_FNAME]
fish_history_files [fish_history_files ...]
Fix or lint a fish_history file in various ways. Unparseable YAML and unsorted
history is detected and fixed. The output should be a valid YAML file.
positional arguments:
fish_history_files The fish_history file to fix
options:
-h, --help show this help message and exit
--run-pytests Just run the unit tests for this script if pytest is
installed.
--lint Just count the number of fixes, do not actually fix
them. This includes number of unsorted history entries
and number of YAML parse errors found.
--verbose Enable debug logging. This shows YAML parse error
details.
--nosort Do not sort lines in the history file
--noparsefix Do not try to fix parse errors
--append, -a Append to the output filename --out-fname do not
overwrite
--out-fname OUT_FNAME, -o OUT_FNAME
Write fixed output to this file. Incompatible with
--lint
```
## Related
This fixes some bad YAML output in the fish_history file, which prevented me from sorting multiple fish_history files easily to merge them into one.
See this issue related to some old fish yaml syntax errors: https://github.com/fish-shell/fish-shell/issues/2759