lib-modules

This repository is the umbrella catalog for reusable Fortran packages developed under the FortranGoingOnForty umbrella.

It is intentionally not a traditional code monorepo.

The goal is:

• keep shared docs, roadmap, and package discovery in one place
• keep each package in its own repository with its own history, releases, issues, and CI
• collect those package repos here as Git submodules under packages/

That gives us the discoverability and organization benefits of one home page without burying every package inside a giant top-level repo.

Start here if you want the big-picture package map:

• LANDSCAPE.md

Go straight to the first standalone package if you already know what you want:

• fgof-process
• fgof-fs
• fgof-pty
• fgof-lineedit
• fgof-watch
• fgof-termios
• fgof-keys
• fgof-expect
• fgof-proc-test
• fgof-temp
• fgof-cache
• fgof-state
• fgof-clipboard
• fgof-screen
• fgof-jobs
• fgof-devloop

The most recently released library target is fgof-devloop, with fgof-archive and fgof-snapshot close behind in the backlog.

If you want local comparison checkouts for already-served or deferred areas, use ./scripts/sync-refs.sh to populate .refs/ from the curated reference set in docs/REFERENCE-LIBS.md.

Why This Structure

This repo exists to answer two different needs cleanly:

1. People should be able to land on one GitHub repo and understand the whole library family.
2. People should also be able to find, clone, star, release, and depend on one package at a time.

Git submodules are the best fit here because they preserve:

• independent package history
• independent package versioning
• independent package visibility on GitHub
• easy standalone consumption by fpm users

Layout

lib-modules/
  README.md
  LANDSCAPE.md
  docs/
    REPO-STRUCTURE.md
  packages/
    README.md
    fgof-process/     # git submodule
    fgof-fs/          # git submodule
    fgof-pty/         # git submodule
    fgof-lineedit/    # git submodule
    fgof-expect/      # git submodule
    fgof-proc-test/   # git submodule
    fgof-temp/        # git submodule
    fgof-cache/       # git submodule
    fgof-state/       # git submodule
    fgof-clipboard/   # git submodule
    fgof-screen/      # git submodule
    fgof-jobs/        # git submodule
    fgof-devloop/     # git submodule
    ...
  scripts/
    add-package-submodule.sh
    sync-refs.sh

Package Catalog

As packages are created:

• each package gets its own repository
• each package is added here under packages/ as a submodule
• this table should be updated with its repo URL and current status

How To Use This Repo

Clone the umbrella repo when you want the catalog, landscape docs, and package submodules together:

git clone --recurse-submodules git@github.com:FortranGoingOnForty/lib-modules.git

Go directly to an individual package repo when you only want one library.

Working Rules

• Root repo holds docs, shared conventions, and package discovery.
• Package code should live in standalone repos, not directly in the root repo.
• The packages/ directory is reserved for Git submodules and package-specific notes.
• Cross-package dependencies should stay shallow and optional.
• Every package should remain usable as a standalone fpm dependency.

Current Packages

• fgof-process: POSIX-first process and subprocess helpers
• fgof-fs: filesystem and path helpers
• fgof-pty: POSIX-first PTY and terminal session helpers
• fgof-lineedit: Fortran-native line editing helpers for interactive CLIs
• fgof-watch: polling-first watch helpers for tools and dev loops
• fgof-termios: terminal mode helpers for interactive tools
• fgof-keys: terminal key decoding helpers for interactive tools
• fgof-expect: expect-style PTY automation helpers for interactive tools and tests
• fgof-proc-test: process-test fixtures for command-line tools and integration suites
• fgof-temp: temp files, temp directories, and atomic write helpers
• fgof-cache: disk cache helpers for command-line tools and local developer workflows
• fgof-state: persistent app and workspace state helpers
• fgof-clipboard: clipboard text helpers for command-line and interactive tools
• fgof-screen: virtual screen buffer helpers for future TUIs and prompt layers
• fgof-jobs: background job and wait-model helpers for shells, supervisors, and tool hosts
• fgof-devloop: watch-driven development loop helpers for rebuild, restart, and smoke workflows

See LANDSCAPE.md for the broader ecosystem assessment and package backlog.