How bhangun/coto works
Coto is a Go CLI for combining files, renaming paths, and extracting code blocks. The main user workflow runs through the CLI entry point: combination filters and processes files before writing text/JSON/XML/Markdown output, while subcommands dispatch to rename or extraction. Extraction selects language plugins through a registry, extracts blocks, and optionally writes results/reports. README documents configuration, compression, parallel processing, and progress; unsampled implementation details are represented conservatively.
Main entry points: registry.go Extractor registry · types.go Code block model · main.go Combine workflow · extract.go Extract command
Components 21
CLI workflows
- Command entry
cmd/main/main.go - Rename paths
cmd/rename/rename.go
File combination
- Combine workflow
cmd/main/main.go - JSON configuration
cmd/main/main.go - File discovery
cmd/main/main.go - File processing
cmd/main/main.go - Format and compression
cmd/main/main.go - Output file
Code extraction
- Extract command
cmd/extract/extract.go - Extractor registry
cmd/extract/registry.go - Extraction engine
cmd/extract/extractors.go - Code block model
pkg/extractor/types.go - Extracted files and report
cmd/extract/extract.go
Extraction plugins
- Go extractor
pkg/plugins/golang.go - JavaScript extractor
pkg/plugins/javascript.go - Python extractor
pkg/plugins/python.go - Java extractor
pkg/plugins/java.go - Dart extractor
pkg/plugins/dart.go - Rust extractor
pkg/plugins/rust.go - Generic extractor
cmd/extract/extractors.go
Other components
- CLI user
Connections 29
- CLI user → Command entry: invokes
README.md - Command entry → Combine workflow: runs default
cmd/main/main.go - Command entry → Extract command: dispatches extract
cmd/main/main.go - Command entry → Rename paths: dispatches rename
cmd/main/main.go - CLI user → Rename paths: requests rename
README.md - Combine workflow → JSON configuration: loads optionally
cmd/main/main.go - Combine workflow → File discovery: discovers files
cmd/main/main.go - Combine workflow → File processing: processes files
cmd/main/main.go - Combine workflow → Format and compression: writes output
cmd/main/main.go - Format and compression → Output file: writes
README.md - CLI user → Extract command: requests extraction
README.md - Extract command → Extractor registry: registers plugins
cmd/extract/extract.go - Extract command → Extraction engine: processes files
cmd/extract/extract.go - Extract command → Extracted files and report: writes and reports
cmd/extract/extract.go - Extraction engine → Code block model: produces blocks
cmd/extract/extractors.go - Extractor registry → Go extractor: registers
cmd/extract/registry.go - Extractor registry → JavaScript extractor: registers
cmd/extract/registry.go - Extractor registry → Python extractor: registers
cmd/extract/registry.go - Extractor registry → Java extractor: registers
cmd/extract/registry.go - Extractor registry → Dart extractor: registers
cmd/extract/registry.go - Extractor registry → Rust extractor: registers
cmd/extract/registry.go - Extractor registry → Generic extractor: registers fallback
cmd/extract/registry.go - Extraction engine → Extractor registry: selects extractor
- Go extractor → Code block model: emits blocks
pkg/plugins/golang.go - JavaScript extractor → Code block model: emits blocks
pkg/plugins/javascript.go - Python extractor → Code block model: emits blocks
pkg/plugins/python.go - Java extractor → Code block model: emits blocks
pkg/plugins/java.go - Dart extractor → Code block model: emits blocks
pkg/plugins/dart.go - Rust extractor → Code block model: emits blocks
pkg/plugins/rust.go