How oktaybobus/laytime works
laytime is a dependency-free Python calculator for GENCON-style voyage-charter laytime, demurrage and despatch. Callers provide a replayable JSON basis; either the public Python API or CLI passes it to the pure calculation engine and receives a result mapping or JSON. The engine handles port timing, calendar exceptions, interruptions, reversible allowances and monetary settlement. The CLI also reads files or stdin and reports invalid or incomplete bases. Internal calculation detail is grouped under the engine because the excerpts do not establish separate runtime modules for those stages.
Main entry points: cli.py JSON CLI · engine.py Laytime engine · __init__.py Python API · __main__.py Module entry
Components 7
User interfaces
- JSON CLI
src/laytime/cli.py - Module entry
src/laytime/__main__.py - Python API
src/laytime/__init__.py
Calculation
- Laytime engine
src/laytime/engine.py
Other components
- Basis provider
- Charter basis
- Calculation result
Connections 8
- Basis provider → Python API: provides basis
src/laytime/__init__.py - Python API → Laytime engine: exports calculation
src/laytime/__init__.py - Basis provider → Charter basis: supplies JSON
README.md - Charter basis → JSON CLI: read from input
src/laytime/cli.py - Module entry → JSON CLI: calls main
src/laytime/__main__.py - JSON CLI → Laytime engine: calls compute
src/laytime/cli.py - Laytime engine → Calculation result: returns calculation
src/laytime/engine.py - JSON CLI → Calculation result: writes JSON
src/laytime/cli.py