* Baltakatei Executables Development
#+TITLE: Baltakatei Executables Development
#+AUTHOR: Steven Baltakatei Sandoval
#+DATE:2023-03-19
#+EMAIL:baltakatei@gmail.com
#+LANGUAGE: en
#+OPTIONS: toc:nil

** Summary
This repository contains publicly-sharable executables produced by
Steven Baltakatei Sandoval.

** Directory Structure
*** ~archive~
This directory contains files not actively used but useful for
understanding long-term history of this project.

*** ~doc~
This directory contains documentation about files in this project.

*** ~sysutils~
This directory contains executable utilities meant to change operating
system settings.

An example executable to be stored here may include:

- A bash script that runs ~apt~ to configure a Debian GNU/Linux
  machine to compile executable binaries from source.

*** ~unitproc~
This directory contains executables meant to process data produced by
other executables for processing by other executables. It does NOT
contain executables meant to change operating system settings.

Example executables to be stored here may include:

- A file that belongs here is a python script containing a generally
  useful function definition meant to be inserted into various larger
  python scripts.
- A bash script meant to be regularly run by ~cron~ to perform an
  ~rsync~ backup of the user's home directory, using option arguments
  to specify a custom output directory to hold the backup files.
- A bash script that uses ~inotifywait~ to hash files immediately
  after they are modified and log the hashes to an option-specified
  path on disk.

*** ~user~
This directory contains executables meant to be regularly called
directly by the user to perform one-off tasks.

Examples may include:

- A bash script that appends the last modification date to a file name
  would go here.
- A bash script that compresses a file with custom compression
  settings.
- A bash script that generates a random passphrase with a custom
  alphabet and adjustable entropy.
- A bash script that initializes a multiwindow terminal emulator
  (i.e. ~tilix~) with custom initial working directories.

** Metadata
- Baltakatei Project No. ~BK-2020-03~

** See Also
- [[https://reboil.com/mediawiki/BK-2020-03:_Baltakatei_Executables_Development][Reboil.com wiki page]]