fgof-process Public

Notifications Fork 0 Star 0
e93f727
Branches trunk Tags v0.1.0 v0.1.1
1 Branches 2 Tags
Go to file T
Code
espadonne Add sync runner
e93f727 3 Commits
docs Stabilize process API
src Add sync runner
test Add sync runner
.gitignore Stabilize process API
LICENSE Initial fgof-process scaffold
README.md Add sync runner
fpm.toml Initial fgof-process scaffold

fgof-process

POSIX-first process and subprocess helpers for modern Fortran applications.

fgof-process is intended to be a small, standalone library that gives Fortran tools a more ergonomic process API than raw execute_command_line, thin POSIX wrappers, or experimental process surfaces that still feel too low-level for real tooling.

Current v1 target:

  • argv-first command construction
  • synchronous process execution on macOS and Linux
  • explicit shell-command convenience through /bin/sh -c
  • environment overrides
  • working-directory overrides
  • stdin support
  • stdout and stderr capture
  • exit-status reporting
  • timeout-aware execution
  • structured, result-first errors

Future scope:

  • streaming process handles
  • async spawn and wait
  • signal helpers
  • PTY-friendly integration points for a future fgof-pty
  • a dedicated fgof-proc-test companion package

Status

Early sync-runner milestone.

This repository is the first package in the FortranGoingOnForty reusable library family and is intended to be consumed standalone or via the umbrella catalog repo at lib-modules.

Implemented today:

  • public fgof_process and fgof_process_types modules
  • command() and shell() constructors
  • synchronous argv and shell execution
  • child-only cwd override
  • child-only env set and unset behavior
  • result-first error codes for invalid commands, spawn failures, exec failures, and pipe setup failures

Still deferred:

  • stdout capture
  • stderr capture
  • stdin piping
  • timeout enforcement
  • async process handles

Package Goals

  • keep the API small and predictable
  • prefer argv-based execution over shell-string execution
  • make tests easy to write
  • stay useful for shells, editors, TUI apps, and developer tooling
  • close a real ecosystem gap rather than mirroring stdlib_system

Public API Shape

Primary module:

  • fgof_process

Public types:

  • process_command
  • process_options
  • process_result

Public procedures:

  • command
  • shell
  • run

Current Boundaries

  • Direct POSIX backend is planned for v1.
  • stdlib_system can inform behavior, but is not a required backend.
  • Async process handles are explicitly deferred until after the sync-first release.

Development Notes

  • POSIX first: macOS and Linux
  • standalone fpm package
  • intended to remain independently versioned and releasable

License

MIT