Skip to content

TODO.md

Latest commit

 

History

History
359 lines (317 loc) · 17.1 KB

TODO.md

File metadata and controls

359 lines (317 loc) · 17.1 KB

High Priority

Bugs

  • make analyse does not exit with non-zero code even if some analyses fail.
  • Analyse target on GitHub does not work correctly.

Features

New Scripts

  • Write a C program that takes in argv through argv and parsing configuration through stdin and outputs shell evalable code, then replace all applicable existing argument parsing in shell scripts with this program.
  • Merge *maps into a single C/C++ program.
  • Write an audio waveform visualisation extension (in Lua) for mpv.
  • Write a script similar to getpath, but interactive.
    • fzf could probably work well here.
    • Should support early-out, similar to most LaTeX compilers.
      • If the only key starting with abc is abcd, abc should be enough to select abcd.
    • Should support filter & select without confirmation, similar to lf's mapping system.
  • Other std utilities:
    • std::unordered_set
    • std::map
    • std::set
  • Create two logging libraries that support colors (with automatic isatty detection) for C and C++ separately, using C and C++ streams respectively.
  • Create a shell header, that, if included, makes the current script reload if the script file is touched.
    • Similar to polybar, picom, etc.
    • Use this header in daemons like headsetcontrol2mpris.
  • Write a script that is key based like tglapp that caches the output of a command with the given key and re-uses the output.
    • Support output invalidation after a set (per key or global default) amount of time.
    • Maybe add implicit support for caching in tglapp or with pads (weather, etc.)?

Refactoring / Rewriting / Reworking

  • Rewrite ffmw.
  • Optimise breadth-find to not search the same initial depths multiple times.
  • Rewrite the pathfinding suite with std::unordered_map, or with the to-be-implemented C/C++ std base library.
  • Create a base C (or C++, depending on what features are required or heavily used (though C is preferred for future-compatibility)) library for creating other std utilities such as std::vector and std::unordered_map, then refactor std::vector and std::unordered_map using that library.
  • Rewrite tglapp in C++, Go or Rust.
    • Much easier to support the other to-dos regarding tglapp in one of these languages rather than in shell.
  • Export align() from std::string to strutil.h and use it from the header.
  • prefix.sh: don't query paths at runtime, make .make insert them in via m4 during installation instead.
  • Consider porting all execline scripts to shell for less dependencies.

Other

  • Add support for installing single programs, plugins, etc.
  • Add documentation:
    • Online documentation via github.io & codeberg.page.
    • Offline documentation via man pages.
    • -h and/or --help flags.
    • For interpreted stuff and config files, brief explanation as comment at the beginning of the file.
    • Install man pages as compressed with gzip.
  • At this point perhaps rename the repository from scripts to utils?
  • Consider changing the extension of shell headers from .sh to .shh, .hsh or something similar.
  • Consider integrating cpplint.

Normal Priority

Bugs

  • ffmw decat does not work as expected. When the time is in format HH:MM:SS, it seems to work. Maybe it requires this format? If so, add it in the help menu.
  • In tglapp, --list=compact prints stdout and stderr.
  • .make: .installed grows indefinitely unless uninstall is issued, fix.
  • std::string segfaults if given alignment is not contained in the input.

Features

  • In contexec, show the execution count in the header.
  • In steammgr, keep a database of application IDs scraped from steamdb and present the user with relevant options. This could be done in two ways: either show the relevant options by being command-aware, or first show a meta prompt for all, installed and in-library games, and then show the IDs (or show the meta options in the installed prompt, and show another prompt with the selected if all or in-library is selected).
  • Integrate fzfp of stpv into f and _fd.
  • In C get*, add diagnostic error messages.
  • In fmaps, implement options similar to that of afgrep's -aexbi.
    • Maybe make these options specific to each given mapping? If so, also have the ability to globally define these options.
  • In stdutil.h, min/max/minmax clamped versions add astrto* functions.
  • In sandwichline, add -s, --same-dough option to make the top and bottom of the sandwich the same when randomised.
  • Alternative to make stats that lists individual file statistics.

Refactoring / Rewriting / Reworking

  • Rewrite eln using mapexec. This will allow the name to be arbitrary (except containing a newline).
  • Rewrite kasel using pgrep and kill --timeout.
  • Use inotifywait in waitfl.
  • Merge repeat{line,null,str} into repeatstr.

Other

  • Rename ffmw subcommands to more sensible ones. For instance, the current name of the crop subcommand is very counter-intuitive.
  • In scripts that acquire locks, release them with a trap in case the script is interrupted, killed, etc.
  • Use basename and dirname instead of parameter expansions as they correctly deal with edge cases. If these edge cases are known not to be present, do use parameter expansions.
  • Replace applicable printf invocations with printf --.
  • In all scripts that parse arguments, ensure that help printing and other actions are done after validating the arguments. If the arguments could not be validated, exit with a non-zero code (after printing help if it is given). This way, the scripts can be integrated more easily with or within other scripts by allowing the arguments to be immediately validated without executing the script (like kdialog, which wraps the real kdialog, validating the arguments without doing the action).
  • Scripts that do not require parameters from the invoking user should not use sudo and should require the script to be run as root (by asserting it actively if necessary).
  • Scripts that use sudo should use sudo/sudo -A if it has a CLI/GUI.
  • Register a tray icon using yad in applicable scripts.
    • Daemons could benefit well from this.
    • tglapp could benefit from this. A single tray icon when right clicked should show all tglapp applications. For this, a subscription and a server (like lf's) system should be implemented.

Low Priority

Bugs

  • The following stest usages yield different results. They should not. The second one yields the correct results. There might be some cache corruption or clean-up issue related to the libmagic or file (via fork/execlp) usages.
    1. find . -print0 | sort -z | xargs -r0 stest -z -m video -- | sort -z
    2. find . -print0 | sort -z | xargs -r0 -n 1 stest -z -m video -- | sort -z
    • Update: They now yield the same result. Maybe there is some sort of race condition in the first case?

Features

  • Implement for/while-else construct of Python in C++. This could be used as a starting point.
  • Integrate synctex in latexd. See this and this.

Refactoring / Rewriting / Reworking

  • In all C files (except, perhaps, those under */include/*), move variable declarations as close as possible to the first usage, i.e. reduce their scope as much as possible. Still use C89 style declarations.
  • Optimise database.h to do less allocations.
    • Reuse built paths.

New Scripts

Archive

Security

  • Do not eval the output of headsetcontrol in polybar-headsetcontrol in case the interface changes.
    • Maybe send a PR for an -e (for eval) flag to headsetcontrol?
  • evaling getpath, xdotool and other programs can lead to security problems if the scripts are run with elevated permissions. Warn the user and, for programs local to this repository, always install the evaled programs as root to prevent tinkering.

Bugs

  • acpihandler does not handle already-off keyboard/touchpad correctly on PROG1 event.
  • latexd does not work with files containing ', fix.

Features

  • In bspwmpad, if a slot is requested and the requested slot is occupied, check if the occupier is alive. If a slot is not requested and all slots are occupied, check all of the slots for whether each occupier is alive.
  • In bspwmpad, add an option to start in some desktop.
  • In bspwmpad, support non-automated non-incrementing keycodes in addition to numbers.
  • Support anonymous (non-numbered) pads in bspwmpad.
    • In latexd, if $TABBED_XID is set and non-empty, use request an anonymous pad.
  • In bspwmpad, allow setting the font size (not the whole font). This would be useful in scripts/programs like weather, neomutt, etc.
  • Add options in latexd to not open the source/output files.
  • Add an option in bspwmpad that would skip the acquisition of a lock if all locks are occupied. This could have two behaviours: open up a normal st session or execute the command without st. This could be made into two more options that would determine the behaviour.
  • In bspwmpad, add an option to use tglapp.
  • In tglapp, add an option to use bspwmpad. If this option is given, when toggling the application, toggle the hidden status of the pad if it is on.
  • In latexd, allow passing arguments to bspwmpad.
  • In bspwmpad, support killing the command running in the given pad number.
  • In bspwmpad, support killing the command running in the given pad number and replacing it. This function should require a valid and non-zero -n to be passed.
  • In bright*, fade the brightness.
  • Make the kdialog wrapper cross-compatible with other dialogue applications such as Zenity. Create wrappers for these newly supported applications that exec the kdialog wrapper.
    • Or, create a generic base file dialogue application that uses lf and create wrappers for other file dialogue applications that exec this generic base application.
  • Support fzf in selfl.
    • By default, automatically determine whether to use fzf or $MENU depending on [ -t 0 ].
  • Add adequate padding in genrc. (GNU?) printf has a padding parameter.
  • In pathfinding/v, if the file is not found, try finding the file in a few depths.
  • Show errors with rofi -e "$message" in applicable headless scripts.
    • Maybe create a helper script for this?
  • In contexec, show the output in a $PAD and open the editor in the initialised terminal.
  • In tglapp, support terminating the X window instead of the run process.
  • Currently, if fillline is included in an on-terminal-initialisation pipeline, the line might not be filled fully. This is not per se a bug on the fillline end, but it would be nice to mitigate it. Add an option to wait a tiny bit to allow for the terminal window to initialise and settle to its permanent/semi-permanent row/column configuration. Add another option to wait for the terminal row/column values to change. Add another option to limit the waiting time of the previous action, so it does not end up waiting indefinitely.
  • Add an option to override or append to the default clean-up process on toggling off in tglapp.
    • This would be useful for double-forking programs and or those that have weird process trees like Steam.
  • Add the ability to have default arguments via environment variables in tglapp.
  • Support custom lock directory prefix in dbutil.h.
  • Support custom lock directory prefix in lck.
  • tglapp: run applications in a tmux session.
    • Still capture stdout/stderr to temporary files.
      • Or, don't capture them, but query them from tmux if it is supported.
  • In tglapp, add support for different commands depending on whether the application is open or not. This would be useful in many scenarios, including toggling an application wrapped with screen.
  • In tglapp, add support for force restarting applications via only a keycode. To do this, read the command to start from */cmd.
  • In tglapp, add by-cmd, by-kc (by-keycode), by-hash and by-pid sub-directories like /dev/*/by-*.
  • In tglapp add an option to auto-restart the application when it exits. Make this behaviour togglable between only non-zero codes and all codes.
  • In bspwm-show, show thumbnails. To do this, use rofi instead of execmenu.
  • Do not assume a font size in rofifit. The new calculation should still be generous such that it would not make the same mistake as rofi trimming very short.
  • In tglapp, add an option that disables auto-unlocking, allowing the user to review the stdout/stderr of the command.
  • In polybar-headsetcontrol, keep track of the last known battery percentage. If battery is charging, show that it is charging, but also estimate a battery percentage.
  • In polybar-headsetcontrol, make the battery icon's fill follow the percentage.
  • Generalise vector:
    • From 1D->1D to ND->MD.
      • Maybe even support variadic vectors like: {{1, 2}, {3}, {4, 5, 6}}. Values can remain as strings.
    • Support key->value and index->value at the same time. Key can just be strings.

Refactoring / Rewriting / Reworking

  • Optimise kmcycle and setxkb.
  • Use xsel instead of xclip.
  • Consider scrot in cpscr.

New Scripts

  • Migrate dotfilesbak{,-sensitive} into this repository, and simply symlink them to the original locations.
    • Support multiple systems:
      • Support non-shared and shared files.
      • Support "static" files, where those files are owned by a system and may not be shared.
      • If we do not support static files, or more than two systems with partial sharing, these should be easily achievable with git branches. Otherwise, possible implementations could be:
        • A directory structure with a flags hashmap,
        • A directory structure with the shared files being symlinked,
        • Etc.
      • Easiest solution that would support multiple systems, synchronous usage across multiple systems and static & shared files is most likely either multiple repositories or multiple copies of the same repository with distinct branches checked-out.
        • Have a root directory with necessary configuration files.
          • This would also make it easy to support public/private dotfiles more easily.
  • Create a script for enabling/disabling/toggling/querying xinput devices. Use this script in acpihandler, maptouch, tpcycle, and other applicable scripts.
  • Write a script that converts CBR to PDF and uses a PDF viewer to open the temporary file.