fgof-watch Public

Notifications Fork 0 Star 0
3e11d13
Branches trunk Tags v0.1.0
1 Branches 1 Tags
Go to file T
Code
espadonne Polish watch readme
3e11d13 4 Commits
.github Add watch CI
src Scaffold watch package
test Scaffold watch package
.gitignore Ignore local docs
README.md Polish watch readme
fpm.toml Scaffold watch package

fgof-watch

CI

Portable file watching helpers for modern Fortran tools.

fgof-watch is intended to be a small, standalone library for directory and file watching in shells, editors, live-reload tools, sync utilities, and developer loops.

It is part of the FortranGoingOnForty lib-modules catalog, but it is intended to stand on its own as a normal fpm package.

Current v1 target:

  • high-level watch-session API
  • portable polling backend as a dependable baseline
  • normalized events for create, modify, remove, and move
  • debounce and filtering hooks that app authors can actually use
  • clean boundaries with fgof-process and future fgof-devloop

Future scope:

  • native backends once the public API is stable
  • richer event coalescing and ignore-rule helpers
  • higher-level dev-loop orchestration in companion packages

Status

Initial scaffold is in place.

Implemented today:

  • public fgof_watch and fgof_watch_types modules
  • baseline watch_session, watch_options, and watch_event types
  • minimal initialization, reset, and polling helpers
  • smoke-test coverage and CI wiring

Still to implement:

  • real directory snapshots and change detection
  • recursive traversal and filtering
  • event shaping, debounce, and native backend strategy

Why Use It

  • file watching is still one of the biggest remaining tooling gaps in Fortran
  • app authors want a reusable library surface, not only standalone watcher tools
  • it should compose naturally with fgof-process, future fgof-devloop, editors, and live-reload workflows

Public API Shape

Primary modules:

  • fgof_watch
  • fgof_watch_types

Public types:

  • watch_event
  • watch_options
  • watch_session

Current public procedures:

  • init_watch
  • poll_watch
  • reset_watch

Quick Start

program demo_watch
  use fgof_watch, only : init_watch, poll_watch
  use fgof_watch_types, only : watch_event, watch_session
  implicit none

  type(watch_event) :: event
  type(watch_session) :: session

  call init_watch(session, "src")
  event = poll_watch(session)
  print "(A)", event%path
end program demo_watch

Build And Test

fpm test

That is the baseline verification command locally and in CI.

Supported Platforms

  • macOS
  • Linux

Boundaries

  • intended to stay independently versioned and releasable
  • focused on reusable watch primitives, not a full dev-loop tool
  • polling will be the first dependable backend; native backends can come later without changing the high-level surface

License

MIT