GPS Exchange Format library/CLI in OCaml
trim README
+3
-32
+3
-32
README.md
+3
-32
README.md
···
1
1
# mlgpx - OCaml GPX Library
2
2
3
-
A high-quality OCaml library for parsing and generating GPX (GPS Exchange Format) files, designed with streaming performance and type safety in mind.
3
+
An OCaml library for parsing and generating GPX (GPS Exchange Format) 1.0 and
4
+
1.1 files, and a CLI for common manipulation and query options.
4
5
5
6
## Architecture Overview
6
7
···
32
33
33
34
## Key Features
34
35
35
-
- ✅ **Complete GPX 1.1 support**: Waypoints, routes, tracks, metadata, extensions
36
+
- ✅ **Complete GPX 1.0/1.1 support**: Waypoints, routes, tracks, metadata, extensions
36
37
- ✅ **Streaming parser/writer**: Memory-efficient for large files
37
38
- ✅ **Strong type safety**: Validated coordinates, GPS fix types, etc.
38
39
- ✅ **Comprehensive validation**: Detailed error and warning reporting
···
282
283
mlgpx convert --help
283
284
mlgpx info --help
284
285
```
285
-
286
-
## Dependencies
287
-
288
-
- **xmlm**: Streaming XML parser/writer (core dependency)
289
-
- **ptime**: Time handling for timestamps
290
-
- **unix**: File I/O operations (Unix layer only)
291
-
292
-
## Testing Strategy
293
-
294
-
- Unit tests for coordinate validation
295
-
- Roundtrip tests (parse → write → parse)
296
-
- Validation rule testing
297
-
- Large file streaming tests
298
-
- Cross-platform compatibility tests
299
-
300
-
## Future Considerations
301
-
302
-
### Potential Optimizations
303
-
- Custom coordinate type with packed representation
304
-
- Lazy extension parsing
305
-
- Memory-mapped file reading for very large files
306
-
- Streaming validation (validate while parsing)
307
-
308
-
### API Extensions
309
-
- GPX merging/splitting utilities
310
-
- Coordinate transformation functions
311
-
- Distance/bearing calculations
312
-
- GPX statistics and analysis tools
313
-
314
-
This architecture provides a solid foundation for GPX processing in OCaml with excellent type safety, performance, and extensibility.