comparing f5fef5240cab1738ea1445c7950da5723eaa2e92 and main on anil.recoil.org/ocaml-gpx

+35 -6

.tangled/workflows/build.yml

···

       4
        
       

     

       5
        
       dependencies:

     

       6
        
         nixpkgs:

     

       7
       -
           - dune_3

     

       8
       -
           - ocamlpackages.xmlm

     

       9
       -
           - ocamlpackages.ptime

     

       10
       -
           - ocamlpackages.alcotest

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       11
        
       

     

       12
        
       steps:

     

       13
       -
         - name: dune

     

       14
        
           command: |

     

       15
       -
              dune build

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       4
        
       

     

       5
        
       dependencies:

     

       6
        
         nixpkgs:

     

       7
       +
           - shell

     

       8
       +
           - stdenv

     

       9
       +
           - findutils

     

       10
       +
           - binutils

     

       11
       +
           - libunwind

     

       12
       +
           - ncurses

     

       13
       +
           - opam

     

       14
       +
           - git

     

       15
       +
           - gawk

     

       16
       +
           - gnupatch

     

       17
       +
           - gnum4

     

       18
       +
           - gnumake

     

       19
       +
           - gnutar

     

       20
       +
           - gnused

     

       21
       +
           - gnugrep

     

       22
       +
           - diffutils

     

       23
       +
           - gzip

     

       24
       +
           - bzip2

     

       25
       +
           - gcc

     

       26
       +
           - ocaml

     

       27
        
       

     

       28
        
       steps:

     

       29
       +
         - name: opam

     

       30
        
           command: |

     

       31
       +
              opam init --disable-sandboxing -any

     

       32
       +
         - name: switch

     

       33
       +
           command: |

     

       34
       +
              opam install . --confirm-level=unsafe-yes --deps-only

     

       35
       +
         - name: build

     

       36
       +
           command: |

     

       37
       +
              opam exec -- dune build --verbose

     

       38
       +
         - name: test

     

       39
       +
           command: |

     

       40
       +
              opam exec -- dune runtest --verbose

     

       41
       +
         - name: doc

     

       42
       +
           command: |

     

       43
       +
              opam install -y odoc

     

       44
       +
              opam exec -- dune build @doc

+1 -1

CHANGES.md

···

       1
       -
       # dev

     

       2
        
       

     

       3
        
       - Initial public release

···

       1
       +
       # v1.0.0

     

       2
        
       

     

       3
        
       - Initial public release

+2 -4

README.md

···

       14
        
       dune build @install

     

       15
        
       dune install

     

       16
        
       

     

       17
       -
       # Or use opam (when published)

     

       18
        
       opam install mlgpx

     

       19
        
       ```

     

       20
        
       

     
···

       63
        
       The library is split into four main components:

     

       64
        
       

     

       65
        
       ### Core Library (`gpx`)

     

       66
       -
       - **Portable**: No Unix dependencies, works with js_of_ocaml

     

       67
        
       - **Streaming**: Uses xmlm for memory-efficient XML processing

     

       68
        
       - **Type-safe**: Strong typing with validation for coordinates and GPS data

     

       69
        
       - **Pure functional**: No side effects in the core parsing/writing logic

     
···

       283
        
       

     

       284
        
       let () = create_simple_gpx ()

     

       285
        
       ```

     

       286
       -
       

     

       287
       -

···

       14
        
       dune build @install

     

       15
        
       dune install

     

       16
        
       

     

       17
       +
       # Or use opam

     

       18
        
       opam install mlgpx

     

       19
        
       ```

     

       20
        
       

     
···

       63
        
       The library is split into four main components:

     

       64
        
       

     

       65
        
       ### Core Library (`gpx`)

     

       66
       +
       - **Portable**: No Unix dependencies, works with `js_of_ocaml`

     

       67
        
       - **Streaming**: Uses xmlm for memory-efficient XML processing

     

       68
        
       - **Type-safe**: Strong typing with validation for coordinates and GPS data

     

       69
        
       - **Pure functional**: No side effects in the core parsing/writing logic

     
···

       283
        
       

     

       284
        
       let () = create_simple_gpx ()

     

       285
        
       ```

     

       0
        
       
     

       0

+1 -1

bin/dune

···

       1
        
       (executable

     

       2
        
        (public_name mlgpx)

     

       3
        
        (name mlgpx_cli)

     

       4
       -
        (libraries gpx gpx_eio cmdliner eio_main fmt fmt.tty fmt.cli))

···

       1
        
       (executable

     

       2
        
        (public_name mlgpx)

     

       3
        
        (name mlgpx_cli)

     

       4
       +
        (libraries gpx gpx_eio cmdliner eio_main fmt fmt.tty fmt.cli))

+73 -89

bin/mlgpx_cli.ml

···

       33
        
         if waypoints = [] then

     

       34
        
           []

     

       35
        
         else

     

       36
       -
           let track_points = List.map (fun (wpt : waypoint) -> (wpt :> track_point)) waypoints in

     

       37
       -
           [{ trkpts = track_points; extensions = [] }]

     

       38
        
       

     

       39
        
       let sort_waypoints sort_by_time sort_by_name waypoints =

     

       40
        
         if sort_by_time then

     

       41
       -
           List.sort (fun (wpt1 : waypoint) (wpt2 : waypoint) ->

     

       42
       -
             match wpt1.time, wpt2.time with

     

       43
        
             | Some t1, Some t2 -> Ptime.compare t1 t2

     

       44
        
             | Some _, None -> -1

     

       45
        
             | None, Some _ -> 1

     

       46
        
             | None, None -> 0

     

       47
        
           ) waypoints

     

       48
        
         else if sort_by_name then

     

       49
       -
           List.sort (fun (wpt1 : waypoint) (wpt2 : waypoint) ->

     

       50
       -
             match wpt1.name, wpt2.name with

     

       51
        
             | Some n1, Some n2 -> String.compare n1 n2

     

       52
        
             | Some _, None -> -1

     

       53
        
             | None, Some _ -> 1

     
···

       72
        
             

     

       73
        
             if verbose then

     

       74
        
               log_info "Found %d waypoints and %d existing tracks" 

     

       75
       -
                 (List.length gpx.waypoints)

     

       76
       -
                 (List.length gpx.tracks);

     

       77
        
             

     

       78
        
             (* Check if we have waypoints to convert *)

     

       79
       -
             if gpx.waypoints = [] then (

     

       80
        
               log_error "Input file contains no waypoints - nothing to convert";

     

       81
        
               exit 1

     

       82
        
             );

     

       83
        
             

     

       84
        
             (* Sort waypoints if requested *)

     

       85
       -
             let sorted_waypoints = sort_waypoints sort_by_time sort_by_name gpx.waypoints in

     

       86
        
             

     

       87
        
             if verbose && (sort_by_time || sort_by_name) then

     

       88
        
               log_info "Sorted %d waypoints" (List.length sorted_waypoints);

     
···

       91
        
             let track_segments = waypoints_to_track_segments sorted_waypoints in

     

       92
        
             

     

       93
        
             (* Create the new track *)

     

       94
       -
             let new_track = {

     

       95
       -
               name = Some track_name;

     

       96
        
               cmt = Some "Generated from waypoints by mlgpx CLI";

     

       97
        
               desc = track_desc;

     

       98
        
               src = Some "mlgpx";

     

       99
       -
               links = [];

     

       100
       -
               number = None;

     

       101
        
               type_ = Some "converted";

     

       102
       -
               extensions = [];

     

       103
        
               trksegs = track_segments;

     

       104
        
             } in

     

       105
        
             

     

       106
        
             if verbose then (

     

       107
       -
               let total_points = List.fold_left (fun acc seg -> acc + List.length seg.trkpts) 0 track_segments in

     

       108
        
               log_info "Created track %a with %d segments containing %d points"

     

       109
        
                 (bold_style Fmt.string) track_name

     

       110
        
                 (List.length track_segments) total_points

     

       111
        
             );

     

       112
        
             

     

       113
        
             (* Build output GPX *)

     

       114
       -
             let output_gpx = {

     

       115
       -
               gpx with

     

       116
       -
               waypoints = (if preserve_waypoints then gpx.waypoints else []);

     

       117
       -
               tracks = new_track :: gpx.tracks;

     

       118
       -
               metadata = (match gpx.metadata with

     

       119
       -
                 | Some meta -> Some { meta with 

     

       120
       -
                     desc = Some (match meta.desc with

     

       0
        
       
     

       0
        
       
     

       121
        
                       | Some existing -> existing ^ " (waypoints converted to track)"

     

       122
       -
                       | None -> "Waypoints converted to track") }

     

       123
       -
                 | None -> Some { empty_metadata with 

     

       124
       -
                     desc = Some "Waypoints converted to track";

     

       125
       -
                     time = None })

     

       126
       -
             } in

     

       0
        
       
     

       127
        
             

     

       128
        
             (* Validate output *)

     

       129
       -
             let validation = validate_gpx output_gpx in

     

       130
        
             if not validation.is_valid then (

     

       131
        
               log_error "Generated GPX failed validation:";

     

       132
       -
               List.iter (fun issue ->

     

       133
        
                 let level_str = match issue.level with `Error -> "ERROR" | `Warning -> "WARNING" in

     

       134
        
                 let level_color = match issue.level with `Error -> error_style | `Warning -> warn_style in

     

       135
        
                 Fmt.pf Format.err_formatter "  %a: %s\n" (level_color Fmt.string) level_str issue.message

     
···

       147
        
               Fmt.pf Format.std_formatter "%a\n" (success_style Fmt.string) "Conversion completed successfully!";

     

       148
        
               log_info "Output contains:";

     

       149
        
               Fmt.pf Format.err_formatter "  - %d waypoints%s\n" 

     

       150
       -
                 (List.length output_gpx.waypoints)

     

       151
        
                 (if preserve_waypoints then " (preserved)" else " (removed)");

     

       152
        
               Fmt.pf Format.err_formatter "  - %d tracks (%a + %d existing)\n"

     

       153
       -
                 (List.length output_gpx.tracks)

     

       154
        
                 (success_style Fmt.string) "1 new"

     

       155
       -
                 (List.length gpx.tracks)

     

       156
        
             ) else (

     

       157
        
               log_success "Converted %d waypoints to track: %a → %a" 

     

       158
        
                 (List.length sorted_waypoints)

     
···

       162
        
             

     

       163
        
           with

     

       164
        
           | Gpx.Gpx_error err ->

     

       165
       -
               log_error "GPX Error: %s" (match err with

     

       166
       -
                 | Invalid_xml s -> "Invalid XML: " ^ s

     

       167
       -
                 | Invalid_coordinate s -> "Invalid coordinate: " ^ s

     

       168
       -
                 | Missing_required_attribute (elem, attr) -> 

     

       169
       -
                     Printf.sprintf "Missing attribute %s in %s" attr elem

     

       170
       -
                 | Missing_required_element s -> "Missing element: " ^ s

     

       171
       -
                 | Validation_error s -> "Validation error: " ^ s

     

       172
       -
                 | Xml_error s -> "XML error: " ^ s

     

       173
       -
                 | IO_error s -> "I/O error: " ^ s);

     

       174
        
               exit 2

     

       175
        
           | Sys_error msg ->

     

       176
        
               log_error "System error: %s" msg;

     
···

       186
        
         let times = ref [] in

     

       187
        
         

     

       188
        
         (* Collect from waypoints *)

     

       189
       -
         List.iter (fun (wpt : waypoint) ->

     

       190
       -
           match wpt.time with

     

       191
        
           | Some t -> times := t :: !times

     

       192
        
           | None -> ()

     

       193
       -
         ) gpx.waypoints;

     

       194
        
         

     

       195
        
         (* Collect from routes *)

     

       196
        
         List.iter (fun route ->

     

       197
       -
           List.iter (fun (rtept : route_point) ->

     

       198
       -
             match rtept.time with

     

       199
        
             | Some t -> times := t :: !times

     

       200
        
             | None -> ()

     

       201
       -
           ) route.rtepts

     

       202
       -
         ) gpx.routes;

     

       203
        
         

     

       204
        
         (* Collect from tracks *)

     

       205
        
         List.iter (fun track ->

     

       206
        
           List.iter (fun seg ->

     

       207
       -
             List.iter (fun (trkpt : track_point) ->

     

       208
       -
               match trkpt.time with

     

       209
        
               | Some t -> times := t :: !times

     

       210
        
               | None -> ()

     

       211
       -
             ) seg.trkpts

     

       212
       -
           ) track.trksegs

     

       213
       -
         ) gpx.tracks;

     

       214
        
         

     

       215
        
         !times

     

       216
        
       

     
···

       230
        
             Fmt.pf Format.std_formatter "%a\n" (bold_style Fmt.string) "GPX File Information";

     

       231
        
             

     

       232
        
             (* Basic info *)

     

       233
       -
             Printf.printf "  Version: %s\n" gpx.version;

     

       234
       -
             Printf.printf "  Creator: %s\n" gpx.creator;

     

       235
        
             

     

       236
       -
             (match gpx.metadata with

     

       237
        
              | Some meta ->

     

       238
       -
                  Printf.printf "  Name: %s\n" (Option.value meta.name ~default:"<unnamed>");

     

       239
       -
                  Printf.printf "  Description: %s\n" (Option.value meta.desc ~default:"<none>");

     

       240
       -
                  (match meta.time with

     

       241
        
                   | Some time -> Printf.printf "  Created: %s\n" (Ptime.to_rfc3339 time)

     

       242
        
                   | None -> ())

     

       243
        
              | None -> 

     
···

       245
        
             

     

       246
        
             (* Content summary *)

     

       247
        
             Fmt.pf Format.std_formatter "\n%a\n" (bold_style Fmt.string) "Content Summary";

     

       248
       -
             Printf.printf "  Waypoints: %d\n" (List.length gpx.waypoints);

     

       249
       -
             Printf.printf "  Routes: %d\n" (List.length gpx.routes);

     

       250
       -
             Printf.printf "  Tracks: %d\n" (List.length gpx.tracks);

     

       251
        
             

     

       252
        
             (* Time range *)

     

       253
        
             let all_times = collect_all_timestamps gpx in

     
···

       286
        
             );

     

       287
        
             

     

       288
        
             (* Detailed waypoint info *)

     

       289
       -
             if gpx.waypoints <> [] then (

     

       290
        
               Fmt.pf Format.std_formatter "\n%a\n" (bold_style Fmt.string) "Waypoints";

     

       291
       -
               let waypoints_with_time = List.filter (fun (wpt : waypoint) -> wpt.time <> None) gpx.waypoints in

     

       292
       -
               let waypoints_with_elevation = List.filter (fun (wpt : waypoint) -> wpt.ele <> None) gpx.waypoints in

     

       293
        
               Printf.printf "  - %d with timestamps\n" (List.length waypoints_with_time);

     

       294
        
               Printf.printf "  - %d with elevation data\n" (List.length waypoints_with_elevation);

     

       295
        
               

     

       296
       -
               if verbose && List.length gpx.waypoints <= 10 then (

     

       297
        
                 Printf.printf "  Details:\n";

     

       298
       -
                 List.iteri (fun i (wpt : waypoint) ->

     

       0
        
       
     

       299
        
                   Fmt.pf Format.std_formatter "    %a %s (%.6f, %.6f)%s%s\n" 

     

       300
        
                     (info_style Fmt.string) (Printf.sprintf "%d." (i + 1))

     

       301
       -
                     (Option.value wpt.name ~default:"<unnamed>")

     

       302
       -
                     (latitude_to_float wpt.lat) (longitude_to_float wpt.lon)

     

       303
       -
                     (match wpt.ele with Some e -> Printf.sprintf " elev=%.1fm" e | None -> "")

     

       304
       -
                     (match wpt.time with Some t -> " @" ^ Ptime.to_rfc3339 t | None -> "")

     

       305
       -
                 ) gpx.waypoints

     

       306
        
               )

     

       307
        
             );

     

       308
        
             

     

       309
        
             (* Track info *)

     

       310
       -
             if gpx.tracks <> [] then (

     

       311
        
               Fmt.pf Format.std_formatter "\n%a\n" (bold_style Fmt.string) "Tracks";

     

       312
        
               List.iteri (fun i track ->

     

       313
       -
                 let total_points = List.fold_left (fun acc seg -> acc + List.length seg.trkpts) 0 track.trksegs in

     

       314
        
                 Fmt.pf Format.std_formatter "  %a %s (%d segments, %d points)\n"

     

       315
        
                   (info_style Fmt.string) (Printf.sprintf "%d." (i + 1))

     

       316
       -
                   (Option.value track.name ~default:"<unnamed>")

     

       317
       -
                   (List.length track.trksegs) total_points

     

       318
       -
               ) gpx.tracks

     

       319
        
             );

     

       320
        
             

     

       321
        
             (* Validation *)

     

       322
       -
             let validation = validate_gpx gpx in

     

       323
        
             Printf.printf "\n";

     

       324
        
             if validation.is_valid then

     

       325
        
               Fmt.pf Format.std_formatter "Validation: %a\n" (success_style Fmt.string) "PASSED"

     

       326
        
             else (

     

       327
        
               Fmt.pf Format.std_formatter "Validation: %a\n" (error_style Fmt.string) "FAILED";

     

       328
       -
               List.iter (fun issue ->

     

       329
        
                 let level_str = match issue.level with `Error -> "ERROR" | `Warning -> "WARNING" in

     

       330
        
                 let level_color = match issue.level with `Error -> error_style | `Warning -> warn_style in

     

       331
        
                 Fmt.pf Format.std_formatter "  %a: %s\n" (level_color Fmt.string) level_str issue.message

     
···

       334
        
             

     

       335
        
           with

     

       336
        
           | Gpx.Gpx_error err ->

     

       337
       -
               log_error "GPX Error: %s" (match err with

     

       338
       -
                 | Invalid_xml s -> "Invalid XML: " ^ s

     

       339
       -
                 | Invalid_coordinate s -> "Invalid coordinate: " ^ s

     

       340
       -
                 | Missing_required_attribute (elem, attr) -> 

     

       341
       -
                     Printf.sprintf "Missing attribute %s in %s" attr elem

     

       342
       -
                 | Missing_required_element s -> "Missing element: " ^ s

     

       343
       -
                 | Validation_error s -> "Validation error: " ^ s

     

       344
       -
                 | Xml_error s -> "XML error: " ^ s

     

       345
       -
                 | IO_error s -> "I/O error: " ^ s);

     

       346
        
               exit 2

     

       347
        
           | Sys_error msg ->

     

       348
        
               log_error "System error: %s" msg;

···

       33
        
         if waypoints = [] then

     

       34
        
           []

     

       35
        
         else

     

       36
       +
           Track.Segment.make waypoints :: []

     

       0
        
       
     

       37
        
       

     

       38
        
       let sort_waypoints sort_by_time sort_by_name waypoints =

     

       39
        
         if sort_by_time then

     

       40
       +
           List.sort (fun wpt1 wpt2 ->

     

       41
       +
             match Waypoint.time wpt1, Waypoint.time wpt2 with

     

       42
        
             | Some t1, Some t2 -> Ptime.compare t1 t2

     

       43
        
             | Some _, None -> -1

     

       44
        
             | None, Some _ -> 1

     

       45
        
             | None, None -> 0

     

       46
        
           ) waypoints

     

       47
        
         else if sort_by_name then

     

       48
       +
           List.sort (fun wpt1 wpt2 ->

     

       49
       +
             match Waypoint.name wpt1, Waypoint.name wpt2 with

     

       50
        
             | Some n1, Some n2 -> String.compare n1 n2

     

       51
        
             | Some _, None -> -1

     

       52
        
             | None, Some _ -> 1

     
···

       71
        
             

     

       72
        
             if verbose then

     

       73
        
               log_info "Found %d waypoints and %d existing tracks" 

     

       74
       +
                 (Doc.waypoint_count gpx)

     

       75
       +
                 (Doc.track_count gpx);

     

       76
        
             

     

       77
        
             (* Check if we have waypoints to convert *)

     

       78
       +
             if Doc.waypoints gpx = [] then (

     

       79
        
               log_error "Input file contains no waypoints - nothing to convert";

     

       80
        
               exit 1

     

       81
        
             );

     

       82
        
             

     

       83
        
             (* Sort waypoints if requested *)

     

       84
       +
             let sorted_waypoints = sort_waypoints sort_by_time sort_by_name (Doc.waypoints gpx) in

     

       85
        
             

     

       86
        
             if verbose && (sort_by_time || sort_by_name) then

     

       87
        
               log_info "Sorted %d waypoints" (List.length sorted_waypoints);

     
···

       90
        
             let track_segments = waypoints_to_track_segments sorted_waypoints in

     

       91
        
             

     

       92
        
             (* Create the new track *)

     

       93
       +
             let new_track = Track.make ~name:track_name in

     

       94
       +
             let new_track = { new_track with 

     

       95
        
               cmt = Some "Generated from waypoints by mlgpx CLI";

     

       96
        
               desc = track_desc;

     

       97
        
               src = Some "mlgpx";

     

       0
        
       
     

       0
        
       
     

       98
        
               type_ = Some "converted";

     

       0
        
       
     

       99
        
               trksegs = track_segments;

     

       100
        
             } in

     

       101
        
             

     

       102
        
             if verbose then (

     

       103
       +
               let total_points = List.fold_left (fun acc seg -> acc + Track.Segment.point_count seg) 0 track_segments in

     

       104
        
               log_info "Created track %a with %d segments containing %d points"

     

       105
        
                 (bold_style Fmt.string) track_name

     

       106
        
                 (List.length track_segments) total_points

     

       107
        
             );

     

       108
        
             

     

       109
        
             (* Build output GPX *)

     

       110
       +
             let output_gpx = 

     

       111
       +
               if preserve_waypoints then

     

       112
       +
                 Doc.add_track gpx new_track

     

       113
       +
               else

     

       114
       +
                 Doc.add_track (Doc.clear_waypoints gpx) new_track in

     

       115
       +
             let output_gpx = 

     

       116
       +
               match Doc.metadata gpx with

     

       117
       +
                 | Some meta -> 

     

       118
       +
                     let desc = match Metadata.description meta with

     

       119
        
                       | Some existing -> existing ^ " (waypoints converted to track)"

     

       120
       +
                       | None -> "Waypoints converted to track" in

     

       121
       +
                     Doc.with_metadata output_gpx { meta with desc = Some desc }

     

       122
       +
                 | None -> 

     

       123
       +
                     let meta = Metadata.make ~name:"Converted" in

     

       124
       +
                     let meta = { meta with desc = Some "Waypoints converted to track" } in

     

       125
       +
                     Doc.with_metadata output_gpx meta in

     

       126
        
             

     

       127
        
             (* Validate output *)

     

       128
       +
             let validation = Gpx.validate_gpx output_gpx in

     

       129
        
             if not validation.is_valid then (

     

       130
        
               log_error "Generated GPX failed validation:";

     

       131
       +
               List.iter (fun (issue : Gpx.validation_issue) ->

     

       132
        
                 let level_str = match issue.level with `Error -> "ERROR" | `Warning -> "WARNING" in

     

       133
        
                 let level_color = match issue.level with `Error -> error_style | `Warning -> warn_style in

     

       134
        
                 Fmt.pf Format.err_formatter "  %a: %s\n" (level_color Fmt.string) level_str issue.message

     
···

       146
        
               Fmt.pf Format.std_formatter "%a\n" (success_style Fmt.string) "Conversion completed successfully!";

     

       147
        
               log_info "Output contains:";

     

       148
        
               Fmt.pf Format.err_formatter "  - %d waypoints%s\n" 

     

       149
       +
                 (Doc.waypoint_count output_gpx)

     

       150
        
                 (if preserve_waypoints then " (preserved)" else " (removed)");

     

       151
        
               Fmt.pf Format.err_formatter "  - %d tracks (%a + %d existing)\n"

     

       152
       +
                 (Doc.track_count output_gpx)

     

       153
        
                 (success_style Fmt.string) "1 new"

     

       154
       +
                 (Doc.track_count gpx)

     

       155
        
             ) else (

     

       156
        
               log_success "Converted %d waypoints to track: %a → %a" 

     

       157
        
                 (List.length sorted_waypoints)

     
···

       161
        
             

     

       162
        
           with

     

       163
        
           | Gpx.Gpx_error err ->

     

       164
       +
               log_error "GPX Error: %s" (Error.to_string err);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       165
        
               exit 2

     

       166
        
           | Sys_error msg ->

     

       167
        
               log_error "System error: %s" msg;

     
···

       177
        
         let times = ref [] in

     

       178
        
         

     

       179
        
         (* Collect from waypoints *)

     

       180
       +
         List.iter (fun wpt ->

     

       181
       +
           match Waypoint.time wpt with

     

       182
        
           | Some t -> times := t :: !times

     

       183
        
           | None -> ()

     

       184
       +
         ) (Doc.waypoints gpx);

     

       185
        
         

     

       186
        
         (* Collect from routes *)

     

       187
        
         List.iter (fun route ->

     

       188
       +
           List.iter (fun rtept ->

     

       189
       +
             match Waypoint.time rtept with

     

       190
        
             | Some t -> times := t :: !times

     

       191
        
             | None -> ()

     

       192
       +
           ) (Route.points route)

     

       193
       +
         ) (Doc.routes gpx);

     

       194
        
         

     

       195
        
         (* Collect from tracks *)

     

       196
        
         List.iter (fun track ->

     

       197
        
           List.iter (fun seg ->

     

       198
       +
             List.iter (fun trkpt ->

     

       199
       +
               match Waypoint.time trkpt with

     

       200
        
               | Some t -> times := t :: !times

     

       201
        
               | None -> ()

     

       202
       +
             ) (Track.Segment.points seg)

     

       203
       +
           ) (Track.segments track)

     

       204
       +
         ) (Doc.tracks gpx);

     

       205
        
         

     

       206
        
         !times

     

       207
        
       

     
···

       221
        
             Fmt.pf Format.std_formatter "%a\n" (bold_style Fmt.string) "GPX File Information";

     

       222
        
             

     

       223
        
             (* Basic info *)

     

       224
       +
             Printf.printf "  Version: %s\n" (Doc.version gpx);

     

       225
       +
             Printf.printf "  Creator: %s\n" (Doc.creator gpx);

     

       226
        
             

     

       227
       +
             (match Doc.metadata gpx with

     

       228
        
              | Some meta ->

     

       229
       +
                  Printf.printf "  Name: %s\n" (Option.value (Metadata.name meta) ~default:"<unnamed>");

     

       230
       +
                  Printf.printf "  Description: %s\n" (Option.value (Metadata.description meta) ~default:"<none>");

     

       231
       +
                  (match Metadata.time meta with

     

       232
        
                   | Some time -> Printf.printf "  Created: %s\n" (Ptime.to_rfc3339 time)

     

       233
        
                   | None -> ())

     

       234
        
              | None -> 

     
···

       236
        
             

     

       237
        
             (* Content summary *)

     

       238
        
             Fmt.pf Format.std_formatter "\n%a\n" (bold_style Fmt.string) "Content Summary";

     

       239
       +
             Printf.printf "  Waypoints: %d\n" (Doc.waypoint_count gpx);

     

       240
       +
             Printf.printf "  Routes: %d\n" (Doc.route_count gpx);

     

       241
       +
             Printf.printf "  Tracks: %d\n" (Doc.track_count gpx);

     

       242
        
             

     

       243
        
             (* Time range *)

     

       244
        
             let all_times = collect_all_timestamps gpx in

     
···

       277
        
             );

     

       278
        
             

     

       279
        
             (* Detailed waypoint info *)

     

       280
       +
             if Doc.waypoints gpx <> [] then (

     

       281
        
               Fmt.pf Format.std_formatter "\n%a\n" (bold_style Fmt.string) "Waypoints";

     

       282
       +
               let waypoints_with_time = List.filter (fun wpt -> Waypoint.time wpt <> None) (Doc.waypoints gpx) in

     

       283
       +
               let waypoints_with_elevation = List.filter (fun wpt -> Waypoint.elevation wpt <> None) (Doc.waypoints gpx) in

     

       284
        
               Printf.printf "  - %d with timestamps\n" (List.length waypoints_with_time);

     

       285
        
               Printf.printf "  - %d with elevation data\n" (List.length waypoints_with_elevation);

     

       286
        
               

     

       287
       +
               if verbose && List.length (Doc.waypoints gpx) <= 10 then (

     

       288
        
                 Printf.printf "  Details:\n";

     

       289
       +
                 List.iteri (fun i wpt ->

     

       290
       +
                   let lat, lon = Waypoint.to_floats wpt in

     

       291
        
                   Fmt.pf Format.std_formatter "    %a %s (%.6f, %.6f)%s%s\n" 

     

       292
        
                     (info_style Fmt.string) (Printf.sprintf "%d." (i + 1))

     

       293
       +
                     (Option.value (Waypoint.name wpt) ~default:"<unnamed>")

     

       294
       +
                     lat lon

     

       295
       +
                     (match Waypoint.elevation wpt with Some e -> Printf.sprintf " elev=%.1fm" e | None -> "")

     

       296
       +
                     (match Waypoint.time wpt with Some t -> " @" ^ Ptime.to_rfc3339 t | None -> "")

     

       297
       +
                 ) (Doc.waypoints gpx)

     

       298
        
               )

     

       299
        
             );

     

       300
        
             

     

       301
        
             (* Track info *)

     

       302
       +
             if Doc.tracks gpx <> [] then (

     

       303
        
               Fmt.pf Format.std_formatter "\n%a\n" (bold_style Fmt.string) "Tracks";

     

       304
        
               List.iteri (fun i track ->

     

       305
       +
                 let total_points = Track.point_count track in

     

       306
        
                 Fmt.pf Format.std_formatter "  %a %s (%d segments, %d points)\n"

     

       307
        
                   (info_style Fmt.string) (Printf.sprintf "%d." (i + 1))

     

       308
       +
                   (Option.value (Track.name track) ~default:"<unnamed>")

     

       309
       +
                   (Track.segment_count track) total_points

     

       310
       +
               ) (Doc.tracks gpx)

     

       311
        
             );

     

       312
        
             

     

       313
        
             (* Validation *)

     

       314
       +
             let validation = Gpx.validate_gpx gpx in

     

       315
        
             Printf.printf "\n";

     

       316
        
             if validation.is_valid then

     

       317
        
               Fmt.pf Format.std_formatter "Validation: %a\n" (success_style Fmt.string) "PASSED"

     

       318
        
             else (

     

       319
        
               Fmt.pf Format.std_formatter "Validation: %a\n" (error_style Fmt.string) "FAILED";

     

       320
       +
               List.iter (fun (issue : Gpx.validation_issue) ->

     

       321
        
                 let level_str = match issue.level with `Error -> "ERROR" | `Warning -> "WARNING" in

     

       322
        
                 let level_color = match issue.level with `Error -> error_style | `Warning -> warn_style in

     

       323
        
                 Fmt.pf Format.std_formatter "  %a: %s\n" (level_color Fmt.string) level_str issue.message

     
···

       326
        
             

     

       327
        
           with

     

       328
        
           | Gpx.Gpx_error err ->

     

       329
       +
               log_error "GPX Error: %s" (Error.to_string err);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       330
        
               exit 2

     

       331
        
           | Sys_error msg ->

     

       332
        
               log_error "System error: %s" msg;

+5 -1

dune-project

···

       1
        
       (lang dune 3.18)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (generate_opam_files true)

     

       4
        
       

     

       5
        
       (package

     

       6
        
        (name mlgpx)

     

       7
       -
        (depends ocaml dune xmlm ptime eio ppx_expect alcotest eio_main cmdliner fmt logs)

     

       8
        
        (synopsis "Library and CLI for parsing and generating GPS Exchange (GPX) formats")

     

       9
        
        (description

     

       10
        
         "mlgpx is a streaming GPX (GPS Exchange Format) library for OCaml. It provides a portable core library using the xmlm streaming XML parser, with a separate Unix layer for file I/O operations. The library supports the complete GPX 1.1 specification including waypoints, routes, tracks, and metadata with strong type safety and validation.")

     

       11
        
        (license ISC)

     

       12
        
        (authors "Anil Madhavapeddy")

     

       13
        
        (homepage "https://tangled.sh/@anil.recoil.org/ocaml-gpx")

     

       0
        
       
     

       0
        
       
     

       14
        
        (maintenance_intent "(latest)")

     

       15
        
       )

···

       1
        
       (lang dune 3.18)

     

       2
        
       

     

       3
       +
       (name mlgpx)

     

       4
       +
       

     

       5
        
       (generate_opam_files true)

     

       6
        
       

     

       7
        
       (package

     

       8
        
        (name mlgpx)

     

       9
       +
        (depends ocaml dune xmlm ptime (eio (>= 1.2)) ppx_expect alcotest eio_main cmdliner fmt logs)

     

       10
        
        (synopsis "Library and CLI for parsing and generating GPS Exchange (GPX) formats")

     

       11
        
        (description

     

       12
        
         "mlgpx is a streaming GPX (GPS Exchange Format) library for OCaml. It provides a portable core library using the xmlm streaming XML parser, with a separate Unix layer for file I/O operations. The library supports the complete GPX 1.1 specification including waypoints, routes, tracks, and metadata with strong type safety and validation.")

     

       13
        
        (license ISC)

     

       14
        
        (authors "Anil Madhavapeddy")

     

       15
        
        (homepage "https://tangled.sh/@anil.recoil.org/ocaml-gpx")

     

       16
       +
        (maintainers "Anil Madhavapeddy <anil@recoil.org>")

     

       17
       +
        (bug_reports https://tangled.sh/@anil.recoil.org/ocaml-gpx/issues)

     

       18
        
        (maintenance_intent "(latest)")

     

       19
        
       )

+1 -7

examples/dune

···

       1
        
       (executable

     

       2
        
        (public_name simple_gpx)

     

       3
        
        (name simple_gpx)

     

       4
       -
        (libraries gpx_unix))

     

       5
       -
       

     

       6
       -
       (executable

     

       7
       -
        (public_name effects_example)

     

       8
       -
        (name effects_example)

     

       9
       -
        (libraries gpx_eio eio_main)

     

       10
       -
        (optional))

···

       1
        
       (executable

     

       2
        
        (public_name simple_gpx)

     

       3
        
        (name simple_gpx)

     

       4
       +
        (libraries gpx xmlm))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

-88

examples/effects_example.ml

···

       1
       -
       (** Example using GPX with real Eio effects-based API 

     

       2
       -
        

     

       3
       -
           This demonstrates the real Eio-based API with structured concurrency

     

       4
       -
           and proper resource management.

     

       5
       -
       **)

     

       6
       -
       

     

       7
       -
       open Gpx_eio

     

       8
       -
       

     

       9
       -
       let main env =

     

       10
       -
         try

     

       11
       -
           let fs = Eio.Stdenv.fs env in

     

       12
       -
           

     

       13
       -
           (* Create some GPS coordinates *)

     

       14
       -
           let lat1 = Gpx.latitude 37.7749 |> Result.get_ok in

     

       15
       -
           let lon1 = Gpx.longitude (-122.4194) |> Result.get_ok in

     

       16
       -
           let lat2 = Gpx.latitude 37.7849 |> Result.get_ok in

     

       17
       -
           let lon2 = Gpx.longitude (-122.4094) |> Result.get_ok in

     

       18
       -
           

     

       19
       -
           (* Create waypoints *)

     

       20
       -
           let waypoint1 = make_waypoint ~fs ~lat:(Gpx.latitude_to_float lat1) ~lon:(Gpx.longitude_to_float lon1) ~name:"San Francisco" () in

     

       21
       -
           let waypoint2 = make_waypoint ~fs ~lat:(Gpx.latitude_to_float lat2) ~lon:(Gpx.longitude_to_float lon2) ~name:"Near SF" () in

     

       22
       -
           

     

       23
       -
           (* Create a simple track from coordinates *)

     

       24
       -
           let track = make_track_from_coords ~fs ~name:"SF Walk" [

     

       25
       -
             (37.7749, -122.4194);

     

       26
       -
             (37.7759, -122.4184);

     

       27
       -
             (37.7769, -122.4174);

     

       28
       -
             (37.7779, -122.4164);

     

       29
       -
           ] in

     

       30
       -
           

     

       31
       -
           (* Create a route *)

     

       32
       -
           let route = make_route_from_coords ~fs ~name:"SF Route" [

     

       33
       -
             (37.7749, -122.4194);

     

       34
       -
             (37.7849, -122.4094);

     

       35
       -
           ] in

     

       36
       -
           

     

       37
       -
           (* Create GPX document with all elements *)

     

       38
       -
           let gpx = Gpx.make_gpx ~creator:"eio-example" in

     

       39
       -
           let gpx = { gpx with 

     

       40
       -
             waypoints = [waypoint1; waypoint2];

     

       41
       -
             tracks = [track];

     

       42
       -
             routes = [route];

     

       43
       -
           } in

     

       44
       -
           

     

       45
       -
           Printf.printf "Created GPX document with:\\n";

     

       46
       -
           print_stats gpx;

     

       47
       -
           Printf.printf "\\n";

     

       48
       -
           

     

       49
       -
           (* Write to file with validation *)

     

       50
       -
           write_validated ~fs "example_output.gpx" gpx;

     

       51
       -
           Printf.printf "Wrote GPX to example_output.gpx\\n";

     

       52
       -
           

     

       53
       -
           (* Read it back and verify *)

     

       54
       -
           let gpx2 = read_validated ~fs "example_output.gpx" in

     

       55
       -
           Printf.printf "Read back GPX document with %d waypoints, %d tracks, %d routes\\n" 

     

       56
       -
             (List.length gpx2.waypoints) (List.length gpx2.tracks) (List.length gpx2.routes);

     

       57
       -
           

     

       58
       -
           (* Extract coordinates from track *)

     

       59
       -
           match gpx2.tracks with

     

       60
       -
           | track :: _ ->

     

       61
       -
               let coords = track_coords track in

     

       62
       -
               Printf.printf "Track coordinates: %d points\\n" (List.length coords);

     

       63
       -
               List.iteri (fun i (lat, lon) ->

     

       64
       -
                 Printf.printf "  Point %d: %.4f, %.4f\\n" i lat lon

     

       65
       -
               ) coords

     

       66
       -
           | [] -> Printf.printf "No tracks found\\n";

     

       67
       -
           

     

       68
       -
           Printf.printf "\\nEio example completed successfully!\\n"

     

       69
       -
           

     

       70
       -
         with

     

       71
       -
         | Gpx.Gpx_error err ->

     

       72
       -
             let error_msg = match err with

     

       73
       -
               | Gpx.Invalid_xml s -> "Invalid XML: " ^ s

     

       74
       -
               | Gpx.Invalid_coordinate s -> "Invalid coordinate: " ^ s

     

       75
       -
               | Gpx.Missing_required_attribute (elem, attr) -> 

     

       76
       -
                   Printf.sprintf "Missing required attribute '%s' in element '%s'" attr elem

     

       77
       -
               | Gpx.Missing_required_element s -> "Missing required element: " ^ s

     

       78
       -
               | Gpx.Validation_error s -> "Validation error: " ^ s

     

       79
       -
               | Gpx.Xml_error s -> "XML error: " ^ s

     

       80
       -
               | Gpx.IO_error s -> "I/O error: " ^ s

     

       81
       -
             in

     

       82
       -
             Printf.eprintf "GPX Error: %s\\n" error_msg;

     

       83
       -
             exit 1

     

       84
       -
         | exn ->

     

       85
       -
             Printf.eprintf "Unexpected error: %s\\n" (Printexc.to_string exn);

     

       86
       -
             exit 1

     

       87
       -
       

     

       88
       -
       let () = Eio_main.run main

+87 -104

examples/simple_gpx.ml

···

       7
        
         

     

       8
        
         (* Create coordinates using direct API *)

     

       9
        
         let create_coordinate_pair lat_f lon_f =

     

       10
       -
           match latitude lat_f, longitude lon_f with

     

       11
        
           | Ok lat, Ok lon -> Ok (lat, lon)  

     

       12
       -
           | Error e, _ | _, Error e -> Error (Invalid_coordinate e)

     

       13
        
         in

     

       14
        
         

     

       15
        
         (* Create a simple waypoint *)

     

       16
       -
         (match create_coordinate_pair 37.7749 (-122.4194) with

     

       17
       -
          | Ok (lat, lon) ->

     

       18
       -
            let wpt = make_waypoint_data lat lon in

     

       19
       -
            let wpt = { wpt with name = Some "San Francisco"; desc = Some "Golden Gate Bridge area" } in

     

       20
       -
            Printf.printf "✓ Created waypoint: %s\n" (Option.value wpt.name ~default:"<unnamed>");

     

       21
       -
            

     

       22
       -
            (* Create GPX document *)

     

       23
       -
            let gpx = make_gpx ~creator:"mlgpx direct API example" in

     

       24
       -
            let gpx = { gpx with waypoints = [wpt] } in

     

       25
       -
            

     

       26
       -
            (* Add metadata *)

     

       27
       -
            let metadata = { empty_metadata with 

     

       28
       -
              name = Some "Example GPX File";

     

       29
       -
              desc = Some "Demonstration of mlgpx library capabilities";

     

       30
       -
              time = None (* Ptime_clock not available in this context *)

     

       31
       -
            } in

     

       32
       -
            let gpx = { gpx with metadata = Some metadata } in

     

       33
       -
            

     

       34
       -
            (* Create a simple track *)

     

       35
       -
            let track_points = [

     

       36
       -
              (37.7749, -122.4194, Some "Start");

     

       37
       -
              (37.7849, -122.4094, Some "Mid Point"); 

     

       38
       -
              (37.7949, -122.3994, Some "End");

     

       39
       -
            ] in

     

       40
       -
            

     

       41
       -
            let create_track_points acc (lat_f, lon_f, name) =

     

       42
       -
              match create_coordinate_pair lat_f lon_f with

     

       43
       -
              | Ok (lat, lon) -> 

     

       44
       -
                let trkpt = make_waypoint_data lat lon in

     

       45
       -
                let trkpt = { trkpt with name } in

     

       46
       -
                trkpt :: acc

     

       47
       -
              | Error _ -> acc

     

       48
       -
            in

     

       49
       -
            

     

       50
       -
            let trkpts = List.fold_left create_track_points [] track_points |> List.rev in

     

       51
       -
            let trkseg = { trkpts; extensions = [] } in

     

       52
       -
            let track = {

     

       53
       -
              name = Some "Example Track";

     

       54
       -
              cmt = Some "Sample GPS track";

     

       55
       -
              desc = Some "Demonstrates track creation";

     

       56
       -
              src = None; links = []; number = None; type_ = None; extensions = [];

     

       57
       -
              trksegs = [trkseg];

     

       58
       -
            } in

     

       59
       -
            let gpx = { gpx with tracks = [track] } in

     

       60
       -
            

     

       61
       -
            Printf.printf "✓ Created track with %d points\n" (List.length trkpts);

     

       62
       -
            

     

       63
       -
            (* Validate the document *)

     

       64
       -
            let validation = validate_gpx gpx in

     

       65
       -
            Printf.printf "✓ GPX validation: %s\n" (if validation.is_valid then "PASSED" else "FAILED");

     

       66
       -
            

     

       67
       -
            if not validation.is_valid then (

     

       68
       -
              Printf.printf "Validation issues:\n";

     

       69
       -
              List.iter (fun issue ->

     

       70
       -
                Printf.printf "  %s: %s\n" 

     

       71
       -
                  (match issue.level with `Error -> "ERROR" | `Warning -> "WARNING")

     

       72
       -
                  issue.message

     

       73
       -
              ) validation.issues

     

       74
       -
            );

     

       75
       -
            

     

       76
       -
            (* Convert to XML string *)

     

       77
       -
            (match write_string gpx with

     

       78
       -
             | Ok xml_string ->

     

       79
       -
               Printf.printf "✓ Generated XML (%d characters)\n" (String.length xml_string);

     

       80
       -
               

     

       81
       -
               (* Save to file using Unix layer for convenience *)

     

       82
       -
               (match Gpx_unix.write_validated "example_direct.gpx" gpx with

     

       83
       -
                | Ok () -> 

     

       84
       -
                  Printf.printf "✓ Saved to example_direct.gpx\n";

     

       85
       -
                  

     

       86
       -
                  (* Read it back to verify round-trip *)

     

       87
       -
                  (match Gpx_unix.read_validated "example_direct.gpx" with

     

       88
       -
                   | Ok gpx2 ->

     

       89
       -
                     Printf.printf "✓ Successfully read back GPX\n";

     

       90
       -
                     let validation2 = validate_gpx gpx2 in

     

       91
       -
                     Printf.printf "✓ Round-trip validation: %s\n" 

     

       92
       -
                       (if validation2.is_valid then "PASSED" else "FAILED");

     

       93
       -
                     Printf.printf "  Waypoints: %d, Tracks: %d\n"

     

       94
       -
                       (List.length gpx2.waypoints) (List.length gpx2.tracks)

     

       95
       -
                   | Error e ->

     

       96
       -
                     Printf.printf "✗ Error reading back: %s\n"

     

       97
       -
                       (match e with 

     

       98
       -
                        | Invalid_xml s -> "Invalid XML: " ^ s

     

       99
       -
                        | Validation_error s -> "Validation: " ^ s  

     

       100
       -
                        | IO_error s -> "I/O: " ^ s

     

       101
       -
                        | _ -> "Unknown error"))

     

       102
       -
                | Error e ->

     

       103
       -
                  Printf.printf "✗ Error saving file: %s\n"

     

       104
       -
                    (match e with 

     

       105
       -
                     | IO_error s -> s

     

       106
       -
                     | Validation_error s -> s

     

       107
       -
                     | _ -> "Unknown error"))

     

       108
       -
             | Error e ->

     

       109
       -
               Printf.printf "✗ Error generating XML: %s\n"

     

       110
       -
                 (match e with 

     

       111
       -
                  | Invalid_xml s -> s

     

       112
       -
                  | Xml_error s -> s

     

       113
       -
                  | _ -> "Unknown error"))

     

       114
       -
          | Error e ->

     

       115
       -
            Printf.printf "✗ Error creating coordinates: %s\n" 

     

       116
       -
              (match e with Invalid_coordinate s -> s | _ -> "Unknown error"));

     

       117
        
         

     

       118
       -
         Printf.printf "\n=== Example Complete ===\n"

···

       7
        
         

     

       8
        
         (* Create coordinates using direct API *)

     

       9
        
         let create_coordinate_pair lat_f lon_f =

     

       10
       +
           match Coordinate.latitude lat_f, Coordinate.longitude lon_f with

     

       11
        
           | Ok lat, Ok lon -> Ok (lat, lon)  

     

       12
       +
           | Error e, _ | _, Error e -> Error (Error.invalid_coordinate e)

     

       13
        
         in

     

       14
        
         

     

       15
        
         (* Create a simple waypoint *)

     

       16
       +
         let result = create_coordinate_pair 37.7749 (-122.4194) in

     

       17
       +
         match result with

     

       18
       +
         | Ok (lat, lon) ->

     

       19
       +
           let wpt = Waypoint.make lat lon in

     

       20
       +
           let wpt = { wpt with name = Some "San Francisco"; desc = Some "Golden Gate Bridge area" } in

     

       21
       +
           Printf.printf "✓ Created waypoint: %s\n" (Option.value (Waypoint.name wpt) ~default:"<unnamed>");

     

       22
       +
           

     

       23
       +
           (* Create GPX document *)

     

       24
       +
           let gpx = Doc.empty ~creator:"mlgpx direct API example" in

     

       25
       +
           let gpx = Doc.add_waypoint gpx wpt in

     

       26
       +
           

     

       27
       +
           (* Add metadata *)

     

       28
       +
           let metadata = Metadata.empty in

     

       29
       +
           let metadata = { metadata with name = Some "Example GPX File"; desc = Some "Demonstration of mlgpx library capabilities" } in

     

       30
       +
           let gpx = { gpx with metadata = Some metadata } in

     

       31
       +
           

     

       32
       +
           (* Create a simple track with points *)

     

       33
       +
           let track = Track.make ~name:"Example Track" in

     

       34
       +
           let track = { track with cmt = Some "Sample GPS track"; desc = Some "Demonstrates track creation" } in

     

       35
       +
           

     

       36
       +
           (* Create track segment with points *)

     

       37
       +
           let track_segment = Track.Segment.empty in

     

       38
       +
           let points = [

     

       39
       +
             (37.7749, -122.4194);

     

       40
       +
             (37.7849, -122.4094); 

     

       41
       +
             (37.7949, -122.3994);

     

       42
       +
           ] in

     

       43
       +
           let track_segment = 

     

       44
       +
             List.fold_left (fun seg (lat_f, lon_f) ->

     

       45
       +
               match Coordinate.latitude lat_f, Coordinate.longitude lon_f with

     

       46
       +
               | Ok lat, Ok lon ->

     

       47
       +
                   let pt = Waypoint.make lat lon in

     

       48
       +
                   Track.Segment.add_point seg pt

     

       49
       +
               | _ -> seg

     

       50
       +
             ) track_segment points in

     

       51
       +
           

     

       52
       +
           let track = Track.add_segment track track_segment in

     

       53
       +
           let gpx = Doc.add_track gpx track in

     

       54
       +
           

     

       55
       +
           Printf.printf "✓ Created track\n";

     

       56
       +
           

     

       57
       +
           (* Validate the document *)

     

       58
       +
           let validation = validate_gpx gpx in

     

       59
       +
           Printf.printf "✓ GPX validation: %s\n" (if validation.is_valid then "PASSED" else "FAILED");

     

       60
       +
           

     

       61
       +
           (* Convert to XML string *)

     

       62
       +
           let xml_result = write_string gpx in

     

       63
       +
           (match xml_result with

     

       64
       +
            | Ok xml_string ->

     

       65
       +
              Printf.printf "✓ Generated XML (%d characters)\n" (String.length xml_string);

     

       66
       +
              

     

       67
       +
              (* Save to file - write directly using core API *)

     

       68
       +
              let out_chan = open_out "example_direct.gpx" in

     

       69
       +
              let dest = (`Channel out_chan) in

     

       70
       +
              let write_result = write ~validate:true dest gpx in

     

       71
       +
              close_out out_chan;

     

       72
       +
              (match write_result with

     

       73
       +
               | Ok () -> 

     

       74
       +
                 Printf.printf "✓ Saved to example_direct.gpx\n";

     

       75
       +
                 

     

       76
       +
                 (* Read it back to verify round-trip *)

     

       77
       +
                 let in_chan = open_in "example_direct.gpx" in

     

       78
       +
                 let input = Xmlm.make_input (`Channel in_chan) in

     

       79
       +
                 let read_result = parse ~validate:true input in

     

       80
       +
                 close_in in_chan;

     

       81
       +
                 (match read_result with

     

       82
       +
                  | Ok gpx2 ->

     

       83
       +
                    Printf.printf "✓ Successfully read back GPX\n";

     

       84
       +
                    let validation2 = validate_gpx gpx2 in

     

       85
       +
                    Printf.printf "✓ Round-trip validation: %s\n" 

     

       86
       +
                      (if validation2.is_valid then "PASSED" else "FAILED");

     

       87
       +
                    Printf.printf "  Waypoints: %d, Tracks: %d\n"

     

       88
       +
                      (List.length (Doc.waypoints gpx2)) (List.length (Doc.tracks gpx2))

     

       89
       +
                  | Error e ->

     

       90
       +
                    Printf.printf "✗ Error reading back: %s\n" (Error.to_string e)

     

       91
       +
                 )

     

       92
       +
               | Error e ->

     

       93
       +
                 Printf.printf "✗ Error saving file: %s\n" (Error.to_string e)

     

       94
       +
              )

     

       95
       +
            | Error e ->

     

       96
       +
              Printf.printf "✗ Error generating XML: %s\n" (Error.to_string e)

     

       97
       +
           )

     

       98
       +
         | Error e ->

     

       99
       +
           Printf.printf "✗ Error creating coordinates: %s\n" (Error.to_string e);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       100
        
         

     

       101
       +
         Printf.printf "\n=== Example Complete ===\n"

+59

lib/gpx/coordinate.ml

···

       1
       +
       (** Geographic coordinate types with validation *)

     

       2
       +
       

     

       3
       +
       (** Private coordinate types with validation constraints *)

     

       4
       +
       type latitude = private float

     

       5
       +
       type longitude = private float  

     

       6
       +
       type degrees = private float

     

       7
       +
       

     

       8
       +
       (** Coordinate pair - main type for this module *)

     

       9
       +
       type t = {

     

       10
       +
         lat : latitude;

     

       11
       +
         lon : longitude;

     

       12
       +
       }

     

       13
       +
       

     

       14
       +
       (** Smart constructors for validated coordinates *)

     

       15
       +
       let latitude f =

     

       16
       +
         if f >= -90.0 && f <= 90.0 then Ok (Obj.magic f : latitude)

     

       17
       +
         else Error (Printf.sprintf "Invalid latitude: %f (must be between -90.0 and 90.0)" f)

     

       18
       +
       

     

       19
       +
       let longitude f =

     

       20
       +
         if f >= -180.0 && f < 180.0 then Ok (Obj.magic f : longitude)

     

       21
       +
         else Error (Printf.sprintf "Invalid longitude: %f (must be between -180.0 and 180.0)" f)

     

       22
       +
       

     

       23
       +
       let degrees f =

     

       24
       +
         if f >= 0.0 && f < 360.0 then Ok (Obj.magic f : degrees)

     

       25
       +
         else Error (Printf.sprintf "Invalid degrees: %f (must be between 0.0 and 360.0)" f)

     

       26
       +
       

     

       27
       +
       (** Convert back to float *)

     

       28
       +
       let latitude_to_float (lat : latitude) = (lat :> float)

     

       29
       +
       let longitude_to_float (lon : longitude) = (lon :> float)

     

       30
       +
       let degrees_to_float (deg : degrees) = (deg :> float)

     

       31
       +
       

     

       32
       +
       (** Create coordinate pair *)

     

       33
       +
       let make lat lon = { lat; lon }

     

       34
       +
       

     

       35
       +
       (** Create coordinate pair from floats with validation *)

     

       36
       +
       let make_from_floats lat_f lon_f =

     

       37
       +
         match latitude lat_f, longitude lon_f with

     

       38
       +
         | Ok lat, Ok lon -> Ok { lat; lon }

     

       39
       +
         | Error e, _ | _, Error e -> Error e

     

       40
       +
       

     

       41
       +
       (** Extract components *)

     

       42
       +
       let lat t = t.lat

     

       43
       +
       let lon t = t.lon

     

       44
       +
       let to_floats t = (latitude_to_float t.lat, longitude_to_float t.lon)

     

       45
       +
       

     

       46
       +
       (** Compare coordinates *)

     

       47
       +
       let compare t1 t2 =

     

       48
       +
         let lat_cmp = Float.compare (latitude_to_float t1.lat) (latitude_to_float t2.lat) in

     

       49
       +
         if lat_cmp <> 0 then lat_cmp

     

       50
       +
         else Float.compare (longitude_to_float t1.lon) (longitude_to_float t2.lon)

     

       51
       +
       

     

       52
       +
       (** Equality *)

     

       53
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       54
       +
       

     

       55
       +
       (** Pretty printer *)

     

       56
       +
       let pp ppf t =

     

       57
       +
         Format.fprintf ppf "(%g, %g)" 

     

       58
       +
           (latitude_to_float t.lat) 

     

       59
       +
           (longitude_to_float t.lon)

+68

lib/gpx/coordinate.mli

···

       1
       +
       (** Geographic coordinate types with validation *)

     

       2
       +
       

     

       3
       +
       (** Coordinate types with validation constraints *)

     

       4
       +
       type latitude = private float

     

       5
       +
       type longitude = private float  

     

       6
       +
       type degrees = private float

     

       7
       +
       

     

       8
       +
       (** Coordinate pair *)

     

       9
       +
       type t = {

     

       10
       +
         lat : latitude;

     

       11
       +
         lon : longitude;

     

       12
       +
       }

     

       13
       +
       

     

       14
       +
       (** {2 Constructors} *)

     

       15
       +
       

     

       16
       +
       (** Create validated latitude.

     

       17
       +
           @param f Latitude in degrees (-90.0 to 90.0)

     

       18
       +
           @return [Ok latitude] or [Error msg] *)

     

       19
       +
       val latitude : float -> (latitude, string) result

     

       20
       +
       

     

       21
       +
       (** Create validated longitude.

     

       22
       +
           @param f Longitude in degrees (-180.0 to 180.0)

     

       23
       +
           @return [Ok longitude] or [Error msg] *)

     

       24
       +
       val longitude : float -> (longitude, string) result

     

       25
       +
       

     

       26
       +
       (** Create validated degrees.

     

       27
       +
           @param f Degrees (0.0 to 360.0)

     

       28
       +
           @return [Ok degrees] or [Error msg] *)

     

       29
       +
       val degrees : float -> (degrees, string) result

     

       30
       +
       

     

       31
       +
       (** {2 Conversion Functions} *)

     

       32
       +
       

     

       33
       +
       (** Convert latitude to float *)

     

       34
       +
       val latitude_to_float : latitude -> float

     

       35
       +
       

     

       36
       +
       (** Convert longitude to float *)

     

       37
       +
       val longitude_to_float : longitude -> float

     

       38
       +
       

     

       39
       +
       (** Convert degrees to float *)

     

       40
       +
       val degrees_to_float : degrees -> float

     

       41
       +
       

     

       42
       +
       (** {2 Operations} *)

     

       43
       +
       

     

       44
       +
       (** Create coordinate pair from validated components *)

     

       45
       +
       val make : latitude -> longitude -> t

     

       46
       +
       

     

       47
       +
       (** Create coordinate pair from floats with validation *)

     

       48
       +
       val make_from_floats : float -> float -> (t, string) result

     

       49
       +
       

     

       50
       +
       (** Extract latitude component *)

     

       51
       +
       val lat : t -> latitude

     

       52
       +
       

     

       53
       +
       (** Extract longitude component *)

     

       54
       +
       val lon : t -> longitude

     

       55
       +
       

     

       56
       +
       (** Convert coordinate to float pair *)

     

       57
       +
       val to_floats : t -> float * float

     

       58
       +
       

     

       59
       +
       (** {2 Comparison and Printers} *)

     

       60
       +
       

     

       61
       +
       (** Compare two coordinates *)

     

       62
       +
       val compare : t -> t -> int

     

       63
       +
       

     

       64
       +
       (** Test coordinate equality *)

     

       65
       +
       val equal : t -> t -> bool

     

       66
       +
       

     

       67
       +
       (** Pretty print coordinate *)

     

       68
       +
       val pp : Format.formatter -> t -> unit

+186

lib/gpx/doc.ml

···

       1
       +
       (** Main GPX document type *)

     

       2
       +
       

     

       3
       +
       (** Main GPX document type *)

     

       4
       +
       type t = {

     

       5
       +
         version : string;                    (* GPX version: "1.0" or "1.1" *)

     

       6
       +
         creator : string;                    (* Creating application *)

     

       7
       +
         metadata : Metadata.t option;       (* Document metadata *)

     

       8
       +
         waypoints : Waypoint.t list;        (* Waypoints *)

     

       9
       +
         routes : Route.t list;               (* Routes *)

     

       10
       +
         tracks : Track.t list;               (* Tracks *)

     

       11
       +
         extensions : Extension.t list;       (* Document-level extensions *)

     

       12
       +
       }

     

       13
       +
       

     

       14
       +
       (** {2 Document Constructors} *)

     

       15
       +
       

     

       16
       +
       (** Create empty GPX document *)

     

       17
       +
       let empty ~creator = {

     

       18
       +
         version = "1.1";

     

       19
       +
         creator;

     

       20
       +
         metadata = None;

     

       21
       +
         waypoints = [];

     

       22
       +
         routes = [];

     

       23
       +
         tracks = [];

     

       24
       +
         extensions = [];

     

       25
       +
       }

     

       26
       +
       

     

       27
       +
       (** Create GPX document with metadata *)

     

       28
       +
       let make ~creator ~metadata = 

     

       29
       +
         { (empty ~creator) with metadata = Some metadata }

     

       30
       +
       

     

       31
       +
       (** {2 Document Properties} *)

     

       32
       +
       

     

       33
       +
       (** Get version *)

     

       34
       +
       let version t = t.version

     

       35
       +
       

     

       36
       +
       (** Get creator *)

     

       37
       +
       let creator t = t.creator

     

       38
       +
       

     

       39
       +
       (** Get metadata *)

     

       40
       +
       let metadata t = t.metadata

     

       41
       +
       

     

       42
       +
       (** Get waypoints *)

     

       43
       +
       let waypoints t = t.waypoints

     

       44
       +
       

     

       45
       +
       (** Get routes *)

     

       46
       +
       let routes t = t.routes

     

       47
       +
       

     

       48
       +
       (** Get tracks *)

     

       49
       +
       let tracks t = t.tracks

     

       50
       +
       

     

       51
       +
       (** Get extensions *)

     

       52
       +
       let extensions t = t.extensions

     

       53
       +
       

     

       54
       +
       (** {2 Document Modification} *)

     

       55
       +
       

     

       56
       +
       (** Update metadata *)

     

       57
       +
       let with_metadata t metadata = { t with metadata = Some metadata }

     

       58
       +
       

     

       59
       +
       (** Add waypoint *)

     

       60
       +
       let add_waypoint t waypoint = { t with waypoints = t.waypoints @ [waypoint] }

     

       61
       +
       

     

       62
       +
       (** Add waypoints *)

     

       63
       +
       let add_waypoints t waypoints = { t with waypoints = t.waypoints @ waypoints }

     

       64
       +
       

     

       65
       +
       (** Add route *)

     

       66
       +
       let add_route t route = { t with routes = t.routes @ [route] }

     

       67
       +
       

     

       68
       +
       (** Add routes *)

     

       69
       +
       let add_routes t routes = { t with routes = t.routes @ routes }

     

       70
       +
       

     

       71
       +
       (** Add track *)

     

       72
       +
       let add_track t track = { t with tracks = t.tracks @ [track] }

     

       73
       +
       

     

       74
       +
       (** Add tracks *)

     

       75
       +
       let add_tracks t tracks = { t with tracks = t.tracks @ tracks }

     

       76
       +
       

     

       77
       +
       (** Add extensions *)

     

       78
       +
       let add_extensions t extensions = { t with extensions = t.extensions @ extensions }

     

       79
       +
       

     

       80
       +
       (** Clear waypoints *)

     

       81
       +
       let clear_waypoints t = { t with waypoints = [] }

     

       82
       +
       

     

       83
       +
       (** Clear routes *)

     

       84
       +
       let clear_routes t = { t with routes = [] }

     

       85
       +
       

     

       86
       +
       (** Clear tracks *)

     

       87
       +
       let clear_tracks t = { t with tracks = [] }

     

       88
       +
       

     

       89
       +
       (** {2 Document Analysis} *)

     

       90
       +
       

     

       91
       +
       (** Count waypoints *)

     

       92
       +
       let waypoint_count t = List.length t.waypoints

     

       93
       +
       

     

       94
       +
       (** Count routes *)

     

       95
       +
       let route_count t = List.length t.routes

     

       96
       +
       

     

       97
       +
       (** Count tracks *)

     

       98
       +
       let track_count t = List.length t.tracks

     

       99
       +
       

     

       100
       +
       (** Count total points *)

     

       101
       +
       let total_points t =

     

       102
       +
         let waypoint_points = List.length t.waypoints in

     

       103
       +
         let route_points = List.fold_left (fun acc route -> 

     

       104
       +
           acc + Route.point_count route) 0 t.routes in

     

       105
       +
         let track_points = List.fold_left (fun acc track -> 

     

       106
       +
           acc + Track.point_count track) 0 t.tracks in

     

       107
       +
         waypoint_points + route_points + track_points

     

       108
       +
       

     

       109
       +
       (** Check if document has elevation data *)

     

       110
       +
       let has_elevation t =

     

       111
       +
         List.exists (fun wpt -> Waypoint.elevation wpt <> None) t.waypoints ||

     

       112
       +
         List.exists (fun route ->

     

       113
       +
           List.exists (fun pt -> Waypoint.elevation pt <> None) (Route.points route)

     

       114
       +
         ) t.routes ||

     

       115
       +
         List.exists (fun track ->

     

       116
       +
           List.exists (fun pt -> Waypoint.elevation pt <> None) (Track.all_points track)

     

       117
       +
         ) t.tracks

     

       118
       +
       

     

       119
       +
       (** Check if document has time data *)

     

       120
       +
       let has_time t =

     

       121
       +
         List.exists (fun wpt -> Waypoint.time wpt <> None) t.waypoints ||

     

       122
       +
         List.exists (fun route ->

     

       123
       +
           List.exists (fun pt -> Waypoint.time pt <> None) (Route.points route)

     

       124
       +
         ) t.routes ||

     

       125
       +
         List.exists (fun track ->

     

       126
       +
           List.exists (fun pt -> Waypoint.time pt <> None) (Track.all_points track)

     

       127
       +
         ) t.tracks

     

       128
       +
       

     

       129
       +
       (** Check if document is empty *)

     

       130
       +
       let is_empty t = 

     

       131
       +
         waypoint_count t = 0 && route_count t = 0 && track_count t = 0

     

       132
       +
       

     

       133
       +
       (** Get statistics *)

     

       134
       +
       type stats = {

     

       135
       +
         waypoint_count : int;

     

       136
       +
         route_count : int;

     

       137
       +
         track_count : int;

     

       138
       +
         total_points : int;

     

       139
       +
         has_elevation : bool;

     

       140
       +
         has_time : bool;

     

       141
       +
       }

     

       142
       +
       

     

       143
       +
       let stats t = {

     

       144
       +
         waypoint_count = waypoint_count t;

     

       145
       +
         route_count = route_count t;

     

       146
       +
         track_count = track_count t;

     

       147
       +
         total_points = total_points t;

     

       148
       +
         has_elevation = has_elevation t;

     

       149
       +
         has_time = has_time t;

     

       150
       +
       }

     

       151
       +
       

     

       152
       +
       (** Pretty print statistics *)

     

       153
       +
       let pp_stats ppf t =

     

       154
       +
         let s = stats t in

     

       155
       +
         Format.fprintf ppf "@[<v>GPX Statistics:@,  Waypoints: %d@,  Routes: %d@,  Tracks: %d@,  Total points: %d@,  Has elevation data: %s@,  Has time data: %s@]"

     

       156
       +
           s.waypoint_count s.route_count s.track_count s.total_points

     

       157
       +
           (if s.has_elevation then "yes" else "no")

     

       158
       +
           (if s.has_time then "yes" else "no")

     

       159
       +
       

     

       160
       +
       (** {2 Comparison and Utilities} *)

     

       161
       +
       

     

       162
       +
       (** Compare documents *)

     

       163
       +
       let compare t1 t2 =

     

       164
       +
         let version_cmp = String.compare t1.version t2.version in

     

       165
       +
         if version_cmp <> 0 then version_cmp

     

       166
       +
         else

     

       167
       +
           let creator_cmp = String.compare t1.creator t2.creator in

     

       168
       +
           if creator_cmp <> 0 then creator_cmp

     

       169
       +
           else

     

       170
       +
             let waypoints_cmp = List.compare Waypoint.compare t1.waypoints t2.waypoints in

     

       171
       +
             if waypoints_cmp <> 0 then waypoints_cmp

     

       172
       +
             else

     

       173
       +
               let routes_cmp = List.compare Route.compare t1.routes t2.routes in

     

       174
       +
               if routes_cmp <> 0 then routes_cmp

     

       175
       +
               else List.compare Track.compare t1.tracks t2.tracks

     

       176
       +
       

     

       177
       +
       (** Test document equality *)

     

       178
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       179
       +
       

     

       180
       +
       (** Pretty print document *)

     

       181
       +
       let pp ppf t =

     

       182
       +
         let stats = stats t in

     

       183
       +
         Format.fprintf ppf "GPX v%s by %s (%d wpt, %d routes, %d tracks, %d total points)"

     

       184
       +
           t.version t.creator 

     

       185
       +
           stats.waypoint_count stats.route_count stats.track_count stats.total_points

     

       186
       +

+128

lib/gpx/doc.mli

···

       1
       +
       (** Main GPX document type *)

     

       2
       +
       

     

       3
       +
       (** Main GPX document type *)

     

       4
       +
       type t = {

     

       5
       +
         version : string;                    (* GPX version: "1.0" or "1.1" *)

     

       6
       +
         creator : string;                    (* Creating application *)

     

       7
       +
         metadata : Metadata.t option;       (* Document metadata *)

     

       8
       +
         waypoints : Waypoint.t list;        (* Waypoints *)

     

       9
       +
         routes : Route.t list;               (* Routes *)

     

       10
       +
         tracks : Track.t list;               (* Tracks *)

     

       11
       +
         extensions : Extension.t list;       (* Document-level extensions *)

     

       12
       +
       }

     

       13
       +
       

     

       14
       +
       (** Document statistics *)

     

       15
       +
       type stats = {

     

       16
       +
         waypoint_count : int;

     

       17
       +
         route_count : int;

     

       18
       +
         track_count : int;

     

       19
       +
         total_points : int;

     

       20
       +
         has_elevation : bool;

     

       21
       +
         has_time : bool;

     

       22
       +
       }

     

       23
       +
       

     

       24
       +
       (** {2 Document Constructors} *)

     

       25
       +
       

     

       26
       +
       (** Create empty GPX document *)

     

       27
       +
       val empty : creator:string -> t

     

       28
       +
       

     

       29
       +
       (** Create GPX document with metadata *)

     

       30
       +
       val make : creator:string -> metadata:Metadata.t -> t

     

       31
       +
       

     

       32
       +
       (** {2 Document Properties} *)

     

       33
       +
       

     

       34
       +
       (** Get version *)

     

       35
       +
       val version : t -> string

     

       36
       +
       

     

       37
       +
       (** Get creator *)

     

       38
       +
       val creator : t -> string

     

       39
       +
       

     

       40
       +
       (** Get metadata *)

     

       41
       +
       val metadata : t -> Metadata.t option

     

       42
       +
       

     

       43
       +
       (** Get waypoints *)

     

       44
       +
       val waypoints : t -> Waypoint.t list

     

       45
       +
       

     

       46
       +
       (** Get routes *)

     

       47
       +
       val routes : t -> Route.t list

     

       48
       +
       

     

       49
       +
       (** Get tracks *)

     

       50
       +
       val tracks : t -> Track.t list

     

       51
       +
       

     

       52
       +
       (** Get extensions *)

     

       53
       +
       val extensions : t -> Extension.t list

     

       54
       +
       

     

       55
       +
       (** {2 Document Modification} *)

     

       56
       +
       

     

       57
       +
       (** Update metadata *)

     

       58
       +
       val with_metadata : t -> Metadata.t -> t

     

       59
       +
       

     

       60
       +
       (** Add waypoint *)

     

       61
       +
       val add_waypoint : t -> Waypoint.t -> t

     

       62
       +
       

     

       63
       +
       (** Add waypoints *)

     

       64
       +
       val add_waypoints : t -> Waypoint.t list -> t

     

       65
       +
       

     

       66
       +
       (** Add route *)

     

       67
       +
       val add_route : t -> Route.t -> t

     

       68
       +
       

     

       69
       +
       (** Add routes *)

     

       70
       +
       val add_routes : t -> Route.t list -> t

     

       71
       +
       

     

       72
       +
       (** Add track *)

     

       73
       +
       val add_track : t -> Track.t -> t

     

       74
       +
       

     

       75
       +
       (** Add tracks *)

     

       76
       +
       val add_tracks : t -> Track.t list -> t

     

       77
       +
       

     

       78
       +
       (** Add extensions *)

     

       79
       +
       val add_extensions : t -> Extension.t list -> t

     

       80
       +
       

     

       81
       +
       (** Clear waypoints *)

     

       82
       +
       val clear_waypoints : t -> t

     

       83
       +
       

     

       84
       +
       (** Clear routes *)

     

       85
       +
       val clear_routes : t -> t

     

       86
       +
       

     

       87
       +
       (** Clear tracks *)

     

       88
       +
       val clear_tracks : t -> t

     

       89
       +
       

     

       90
       +
       (** {2 Document Analysis} *)

     

       91
       +
       

     

       92
       +
       (** Count waypoints *)

     

       93
       +
       val waypoint_count : t -> int

     

       94
       +
       

     

       95
       +
       (** Count routes *)

     

       96
       +
       val route_count : t -> int

     

       97
       +
       

     

       98
       +
       (** Count tracks *)

     

       99
       +
       val track_count : t -> int

     

       100
       +
       

     

       101
       +
       (** Count total points *)

     

       102
       +
       val total_points : t -> int

     

       103
       +
       

     

       104
       +
       (** Check if document has elevation data *)

     

       105
       +
       val has_elevation : t -> bool

     

       106
       +
       

     

       107
       +
       (** Check if document has time data *)

     

       108
       +
       val has_time : t -> bool

     

       109
       +
       

     

       110
       +
       (** Check if document is empty *)

     

       111
       +
       val is_empty : t -> bool

     

       112
       +
       

     

       113
       +
       (** Get document statistics *)

     

       114
       +
       val stats : t -> stats

     

       115
       +
       

     

       116
       +
       (** Pretty print statistics *)

     

       117
       +
       val pp_stats : Format.formatter -> t -> unit

     

       118
       +
       

     

       119
       +
       (** {2 Comparison and Utilities} *)

     

       120
       +
       

     

       121
       +
       (** Compare documents *)

     

       122
       +
       val compare : t -> t -> int

     

       123
       +
       

     

       124
       +
       (** Test document equality *)

     

       125
       +
       val equal : t -> t -> bool

     

       126
       +
       

     

       127
       +
       (** Pretty print document *)

     

       128
       +
       val pp : Format.formatter -> t -> unit

+14 -1

lib/gpx/dune

···

       2
        
        (public_name mlgpx.core)

     

       3
        
        (name gpx)

     

       4
        
        (libraries xmlm ptime)

     

       5
       -
        (modules gpx types parser writer validate))
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       2
        
        (public_name mlgpx.core)

     

       3
        
        (name gpx)

     

       4
        
        (libraries xmlm ptime)

     

       5
       +
        (modules

     

       6
       +
         gpx

     

       7
       +
         parser

     

       8
       +
         writer

     

       9
       +
         validate

     

       10
       +
         coordinate

     

       11
       +
         link

     

       12
       +
         extension

     

       13
       +
         waypoint

     

       14
       +
         metadata

     

       15
       +
         route

     

       16
       +
         track

     

       17
       +
         error

     

       18
       +
         doc))

+111

lib/gpx/error.ml

···

       1
       +
       (** Error types and exception handling for GPX operations *)

     

       2
       +
       

     

       3
       +
       (** Main error type *)

     

       4
       +
       type t =

     

       5
       +
         | Invalid_xml of string

     

       6
       +
         | Invalid_coordinate of string

     

       7
       +
         | Missing_required_attribute of string * string

     

       8
       +
         | Missing_required_element of string

     

       9
       +
         | Validation_error of string

     

       10
       +
         | Xml_error of string

     

       11
       +
         | IO_error of string

     

       12
       +
       

     

       13
       +
       (** GPX exception *)

     

       14
       +
       exception Gpx_error of t

     

       15
       +
       

     

       16
       +
       (** Result type for operations that can fail *)

     

       17
       +
       type 'a result = ('a, t) Result.t

     

       18
       +
       

     

       19
       +
       (** {2 Error Operations} *)

     

       20
       +
       

     

       21
       +
       (** Convert error to string *)

     

       22
       +
       let to_string = function

     

       23
       +
         | Invalid_xml msg -> "Invalid XML: " ^ msg

     

       24
       +
         | Invalid_coordinate msg -> "Invalid coordinate: " ^ msg

     

       25
       +
         | Missing_required_attribute (element, attr) ->

     

       26
       +
           Printf.sprintf "Missing required attribute '%s' in element '%s'" attr element

     

       27
       +
         | Missing_required_element element ->

     

       28
       +
           Printf.sprintf "Missing required element '%s'" element

     

       29
       +
         | Validation_error msg -> "Validation error: " ^ msg

     

       30
       +
         | Xml_error msg -> "XML error: " ^ msg

     

       31
       +
         | IO_error msg -> "IO error: " ^ msg

     

       32
       +
       

     

       33
       +
       (** Pretty print error *)

     

       34
       +
       let pp ppf error = Format.fprintf ppf "%s" (to_string error)

     

       35
       +
       

     

       36
       +
       (** Create invalid XML error *)

     

       37
       +
       let invalid_xml msg = Invalid_xml msg

     

       38
       +
       

     

       39
       +
       (** Create invalid coordinate error *)

     

       40
       +
       let invalid_coordinate msg = Invalid_coordinate msg

     

       41
       +
       

     

       42
       +
       (** Create missing attribute error *)

     

       43
       +
       let missing_attribute element attr = Missing_required_attribute (element, attr)

     

       44
       +
       

     

       45
       +
       (** Create missing element error *)

     

       46
       +
       let missing_element element = Missing_required_element element

     

       47
       +
       

     

       48
       +
       (** Create validation error *)

     

       49
       +
       let validation_error msg = Validation_error msg

     

       50
       +
       

     

       51
       +
       (** Create XML error *)

     

       52
       +
       let xml_error msg = Xml_error msg

     

       53
       +
       

     

       54
       +
       (** Create IO error *)

     

       55
       +
       let io_error msg = IO_error msg

     

       56
       +
       

     

       57
       +
       (** Compare errors *)

     

       58
       +
       let compare e1 e2 = String.compare (to_string e1) (to_string e2)

     

       59
       +
       

     

       60
       +
       (** Test error equality *)

     

       61
       +
       let equal e1 e2 = compare e1 e2 = 0

     

       62
       +
       

     

       63
       +
       (** {2 Result Helpers} *)

     

       64
       +
       

     

       65
       +
       (** Convert exception to result *)

     

       66
       +
       let catch f x =

     

       67
       +
         try Ok (f x)

     

       68
       +
         with Gpx_error e -> Error e

     

       69
       +
       

     

       70
       +
       (** Convert result to exception *)

     

       71
       +
       let get_exn = function

     

       72
       +
         | Ok x -> x

     

       73
       +
         | Error e -> raise (Gpx_error e)

     

       74
       +
       

     

       75
       +
       (** Map over result *)

     

       76
       +
       let map f = function

     

       77
       +
         | Ok x -> Ok (f x)

     

       78
       +
         | Error e -> Error e

     

       79
       +
       

     

       80
       +
       (** Bind over result *)

     

       81
       +
       let bind result f = 

     

       82
       +
         match result with

     

       83
       +
         | Ok x -> f x

     

       84
       +
         | Error e -> Error e

     

       85
       +
       

     

       86
       +
       (** Convert string result to error result *)

     

       87
       +
       let from_string_result = function

     

       88
       +
         | Ok x -> Ok x

     

       89
       +
         | Error msg -> Error (Invalid_xml msg)

     

       90
       +
       

     

       91
       +
       (** {2 Error Classification} *)

     

       92
       +
       

     

       93
       +
       (** Check if error is XML-related *)

     

       94
       +
       let is_xml_error = function

     

       95
       +
         | Invalid_xml _ | Xml_error _ -> true

     

       96
       +
         | _ -> false

     

       97
       +
       

     

       98
       +
       (** Check if error is coordinate-related *)

     

       99
       +
       let is_coordinate_error = function

     

       100
       +
         | Invalid_coordinate _ -> true

     

       101
       +
         | _ -> false

     

       102
       +
       

     

       103
       +
       (** Check if error is validation-related *)

     

       104
       +
       let is_validation_error = function

     

       105
       +
         | Validation_error _ | Missing_required_attribute _ | Missing_required_element _ -> true

     

       106
       +
         | _ -> false

     

       107
       +
       

     

       108
       +
       (** Check if error is IO-related *)

     

       109
       +
       let is_io_error = function

     

       110
       +
         | IO_error _ -> true

     

       111
       +
         | _ -> false

+85

lib/gpx/error.mli

···

       1
       +
       (** Error types and exception handling for GPX operations *)

     

       2
       +
       

     

       3
       +
       (** Main error type *)

     

       4
       +
       type t =

     

       5
       +
         | Invalid_xml of string                          (** XML parsing/structure error *)

     

       6
       +
         | Invalid_coordinate of string                   (** Coordinate validation error *)

     

       7
       +
         | Missing_required_attribute of string * string (** Missing XML attribute (element, attr) *)

     

       8
       +
         | Missing_required_element of string             (** Missing XML element *)

     

       9
       +
         | Validation_error of string                     (** GPX validation error *)

     

       10
       +
         | Xml_error of string                           (** Lower-level XML error *)

     

       11
       +
         | IO_error of string                            (** File I/O error *)

     

       12
       +
       

     

       13
       +
       (** GPX exception *)

     

       14
       +
       exception Gpx_error of t

     

       15
       +
       

     

       16
       +
       (** Result type for operations that can fail *)

     

       17
       +
       type 'a result = ('a, t) Result.t

     

       18
       +
       

     

       19
       +
       (** {2 Error Operations} *)

     

       20
       +
       

     

       21
       +
       (** Convert error to human-readable string *)

     

       22
       +
       val to_string : t -> string

     

       23
       +
       

     

       24
       +
       (** Pretty print error *)

     

       25
       +
       val pp : Format.formatter -> t -> unit

     

       26
       +
       

     

       27
       +
       (** Compare errors *)

     

       28
       +
       val compare : t -> t -> int

     

       29
       +
       

     

       30
       +
       (** Test error equality *)

     

       31
       +
       val equal : t -> t -> bool

     

       32
       +
       

     

       33
       +
       (** {2 Error Constructors} *)

     

       34
       +
       

     

       35
       +
       (** Create invalid XML error *)

     

       36
       +
       val invalid_xml : string -> t

     

       37
       +
       

     

       38
       +
       (** Create invalid coordinate error *)

     

       39
       +
       val invalid_coordinate : string -> t

     

       40
       +
       

     

       41
       +
       (** Create missing attribute error *)

     

       42
       +
       val missing_attribute : string -> string -> t

     

       43
       +
       

     

       44
       +
       (** Create missing element error *)

     

       45
       +
       val missing_element : string -> t

     

       46
       +
       

     

       47
       +
       (** Create validation error *)

     

       48
       +
       val validation_error : string -> t

     

       49
       +
       

     

       50
       +
       (** Create XML error *)

     

       51
       +
       val xml_error : string -> t

     

       52
       +
       

     

       53
       +
       (** Create IO error *)

     

       54
       +
       val io_error : string -> t

     

       55
       +
       

     

       56
       +
       (** {2 Result Helpers} *)

     

       57
       +
       

     

       58
       +
       (** Convert exception to result *)

     

       59
       +
       val catch : ('a -> 'b) -> 'a -> 'b result

     

       60
       +
       

     

       61
       +
       (** Convert result to exception *)

     

       62
       +
       val get_exn : 'a result -> 'a

     

       63
       +
       

     

       64
       +
       (** Map over result *)

     

       65
       +
       val map : ('a -> 'b) -> 'a result -> 'b result

     

       66
       +
       

     

       67
       +
       (** Bind over result *)

     

       68
       +
       val bind : 'a result -> ('a -> 'b result) -> 'b result

     

       69
       +
       

     

       70
       +
       (** Convert string result to error result *)

     

       71
       +
       val from_string_result : ('a, string) Result.t -> 'a result

     

       72
       +
       

     

       73
       +
       (** {2 Error Classification} *)

     

       74
       +
       

     

       75
       +
       (** Check if error is XML-related *)

     

       76
       +
       val is_xml_error : t -> bool

     

       77
       +
       

     

       78
       +
       (** Check if error is coordinate-related *)

     

       79
       +
       val is_coordinate_error : t -> bool

     

       80
       +
       

     

       81
       +
       (** Check if error is validation-related *)

     

       82
       +
       val is_validation_error : t -> bool

     

       83
       +
       

     

       84
       +
       (** Check if error is IO-related *)

     

       85
       +
       val is_io_error : t -> bool

+144

lib/gpx/extension.ml

···

       1
       +
       (** Extension mechanism for custom GPX elements *)

     

       2
       +
       

     

       3
       +
       (** Main extension type *)

     

       4
       +
       type t = {

     

       5
       +
         namespace : string option;

     

       6
       +
         name : string;

     

       7
       +
         attributes : (string * string) list;

     

       8
       +
         content : content;

     

       9
       +
       }

     

       10
       +
       

     

       11
       +
       (** Content types for extensions *)

     

       12
       +
       and content =

     

       13
       +
         | Text of string

     

       14
       +
         | Elements of t list

     

       15
       +
         | Mixed of string * t list

     

       16
       +
       

     

       17
       +
       (** {2 Extension Operations} *)

     

       18
       +
       

     

       19
       +
       (** Create extension with flexible content *)

     

       20
       +
       let make ?namespace ~name ~attributes ~content () =

     

       21
       +
         { namespace; name; attributes; content }

     

       22
       +
       

     

       23
       +
       (** Create an extension with text content *)

     

       24
       +
       let make_text ~name ?namespace ?(attributes=[]) text =

     

       25
       +
         { namespace; name; attributes; content = Text text }

     

       26
       +
       

     

       27
       +
       (** Create an extension with element content *)

     

       28
       +
       let make_elements ~name ?namespace ?(attributes=[]) elements =

     

       29
       +
         { namespace; name; attributes; content = Elements elements }

     

       30
       +
       

     

       31
       +
       (** Create an extension with mixed content *)

     

       32
       +
       let make_mixed ~name ?namespace ?(attributes=[]) text elements =

     

       33
       +
         { namespace; name; attributes; content = Mixed (text, elements) }

     

       34
       +
       

     

       35
       +
       (** Get extension name *)

     

       36
       +
       let name t = t.name

     

       37
       +
       

     

       38
       +
       (** Get optional namespace *)

     

       39
       +
       let namespace t = t.namespace

     

       40
       +
       

     

       41
       +
       (** Get attributes *)

     

       42
       +
       let attributes t = t.attributes

     

       43
       +
       

     

       44
       +
       (** Get content *)

     

       45
       +
       let content t = t.content

     

       46
       +
       

     

       47
       +
       (** Create text content *)

     

       48
       +
       let text_content text = Text text

     

       49
       +
       

     

       50
       +
       (** Create elements content *)

     

       51
       +
       let elements_content elements = Elements elements

     

       52
       +
       

     

       53
       +
       (** Create mixed content *)

     

       54
       +
       let mixed_content text elements = Mixed (text, elements)

     

       55
       +
       

     

       56
       +
       (** Find attribute value by name *)

     

       57
       +
       let find_attribute name t =

     

       58
       +
         List.assoc_opt name t.attributes

     

       59
       +
       

     

       60
       +
       (** Add or update attribute *)

     

       61
       +
       let set_attribute name value t =

     

       62
       +
         let attributes = 

     

       63
       +
           (name, value) :: List.remove_assoc name t.attributes

     

       64
       +
         in

     

       65
       +
         { t with attributes }

     

       66
       +
       

     

       67
       +
       (** Compare extensions *)

     

       68
       +
       let rec compare t1 t2 =

     

       69
       +
         let ns_cmp = Option.compare String.compare t1.namespace t2.namespace in

     

       70
       +
         if ns_cmp <> 0 then ns_cmp

     

       71
       +
         else

     

       72
       +
           let name_cmp = String.compare t1.name t2.name in

     

       73
       +
           if name_cmp <> 0 then name_cmp

     

       74
       +
           else

     

       75
       +
             let attr_cmp = compare_attributes t1.attributes t2.attributes in

     

       76
       +
             if attr_cmp <> 0 then attr_cmp

     

       77
       +
             else compare_content t1.content t2.content

     

       78
       +
       

     

       79
       +
       and compare_attributes attrs1 attrs2 =

     

       80
       +
         let sorted1 = List.sort (fun (k1,_) (k2,_) -> String.compare k1 k2) attrs1 in

     

       81
       +
         let sorted2 = List.sort (fun (k1,_) (k2,_) -> String.compare k1 k2) attrs2 in

     

       82
       +
         List.compare (fun (k1,v1) (k2,v2) ->

     

       83
       +
           let k_cmp = String.compare k1 k2 in

     

       84
       +
           if k_cmp <> 0 then k_cmp else String.compare v1 v2

     

       85
       +
         ) sorted1 sorted2

     

       86
       +
       

     

       87
       +
       and compare_content c1 c2 = match c1, c2 with

     

       88
       +
         | Text s1, Text s2 -> String.compare s1 s2

     

       89
       +
         | Elements e1, Elements e2 -> List.compare compare e1 e2

     

       90
       +
         | Mixed (s1, e1), Mixed (s2, e2) ->

     

       91
       +
           let s_cmp = String.compare s1 s2 in

     

       92
       +
           if s_cmp <> 0 then s_cmp else List.compare compare e1 e2

     

       93
       +
         | Text _, _ -> -1

     

       94
       +
         | Elements _, Text _ -> 1

     

       95
       +
         | Elements _, Mixed _ -> -1

     

       96
       +
         | Mixed _, _ -> 1

     

       97
       +
       

     

       98
       +
       (** Test extension equality *)

     

       99
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       100
       +
       

     

       101
       +
       (** Pretty print extension *)

     

       102
       +
       let rec pp ppf t =

     

       103
       +
         match t.namespace with

     

       104
       +
         | Some ns -> Format.fprintf ppf "<%s:%s" ns t.name

     

       105
       +
         | None -> Format.fprintf ppf "<%s" t.name;

     

       106
       +
         List.iter (fun (k, v) -> Format.fprintf ppf " %s=\"%s\"" k v) t.attributes;

     

       107
       +
         match t.content with

     

       108
       +
         | Text "" -> Format.fprintf ppf "/>"

     

       109
       +
         | Text text -> Format.fprintf ppf ">%s</%s>" text (qualified_name t)

     

       110
       +
         | Elements [] -> Format.fprintf ppf "/>"

     

       111
       +
         | Elements elements ->

     

       112
       +
           Format.fprintf ppf ">";

     

       113
       +
           List.iter (Format.fprintf ppf "%a" pp) elements;

     

       114
       +
           Format.fprintf ppf "</%s>" (qualified_name t)

     

       115
       +
         | Mixed (text, []) -> Format.fprintf ppf ">%s</%s>" text (qualified_name t)

     

       116
       +
         | Mixed (text, elements) ->

     

       117
       +
           Format.fprintf ppf ">%s" text;

     

       118
       +
           List.iter (Format.fprintf ppf "%a" pp) elements;

     

       119
       +
           Format.fprintf ppf "</%s>" (qualified_name t)

     

       120
       +
       

     

       121
       +
       and qualified_name t =

     

       122
       +
         match t.namespace with

     

       123
       +
         | Some ns -> ns ^ ":" ^ t.name

     

       124
       +
         | None -> t.name

     

       125
       +
       

     

       126
       +
       (** {2 Content Operations} *)

     

       127
       +
       

     

       128
       +
       (** Check if content is text *)

     

       129
       +
       let is_text_content = function Text _ -> true | _ -> false

     

       130
       +
       

     

       131
       +
       (** Check if content is elements *)

     

       132
       +
       let is_elements_content = function Elements _ -> true | _ -> false

     

       133
       +
       

     

       134
       +
       (** Check if content is mixed *)

     

       135
       +
       let is_mixed_content = function Mixed _ -> true | _ -> false

     

       136
       +
       

     

       137
       +
       (** Extract text content *)

     

       138
       +
       let text_content_extract = function Text s -> Some s | _ -> None

     

       139
       +
       

     

       140
       +
       (** Extract element content *)

     

       141
       +
       let elements_content_extract = function Elements e -> Some e | _ -> None

     

       142
       +
       

     

       143
       +
       (** Extract mixed content *)

     

       144
       +
       let mixed_content_extract = function Mixed (s, e) -> Some (s, e) | _ -> None

+87

lib/gpx/extension.mli

···

       1
       +
       (** Extension mechanism for custom GPX elements *)

     

       2
       +
       

     

       3
       +
       (** Main extension type *)

     

       4
       +
       type t = {

     

       5
       +
         namespace : string option;          (** Optional XML namespace *)

     

       6
       +
         name : string;                     (** Element name *)

     

       7
       +
         attributes : (string * string) list; (** Element attributes *)

     

       8
       +
         content : content;                 (** Element content *)

     

       9
       +
       }

     

       10
       +
       

     

       11
       +
       (** Content types for extensions *)

     

       12
       +
       and content =

     

       13
       +
         | Text of string                    (** Simple text content *)

     

       14
       +
         | Elements of t list               (** Nested elements *)

     

       15
       +
         | Mixed of string * t list         (** Mixed text and elements *)

     

       16
       +
       

     

       17
       +
       (** {2 Extension Constructors} *)

     

       18
       +
       

     

       19
       +
       (** Create extension with flexible content *)

     

       20
       +
       val make : ?namespace:string -> name:string -> attributes:(string * string) list -> content:content -> unit -> t

     

       21
       +
       

     

       22
       +
       (** Create an extension with text content *)

     

       23
       +
       val make_text : name:string -> ?namespace:string -> ?attributes:(string * string) list -> string -> t

     

       24
       +
       

     

       25
       +
       (** Create an extension with element content *)

     

       26
       +
       val make_elements : name:string -> ?namespace:string -> ?attributes:(string * string) list -> t list -> t

     

       27
       +
       

     

       28
       +
       (** Create an extension with mixed content *)

     

       29
       +
       val make_mixed : name:string -> ?namespace:string -> ?attributes:(string * string) list -> string -> t list -> t

     

       30
       +
       

     

       31
       +
       (** {2 Extension Operations} *)

     

       32
       +
       

     

       33
       +
       (** Get extension name *)

     

       34
       +
       val name : t -> string

     

       35
       +
       

     

       36
       +
       (** Get optional namespace *)

     

       37
       +
       val namespace : t -> string option

     

       38
       +
       

     

       39
       +
       (** Get attributes *)

     

       40
       +
       val attributes : t -> (string * string) list

     

       41
       +
       

     

       42
       +
       (** Get content *)

     

       43
       +
       val content : t -> content

     

       44
       +
       

     

       45
       +
       (** Find attribute value by name *)

     

       46
       +
       val find_attribute : string -> t -> string option

     

       47
       +
       

     

       48
       +
       (** Add or update attribute *)

     

       49
       +
       val set_attribute : string -> string -> t -> t

     

       50
       +
       

     

       51
       +
       (** Compare extensions *)

     

       52
       +
       val compare : t -> t -> int

     

       53
       +
       

     

       54
       +
       (** Test extension equality *)

     

       55
       +
       val equal : t -> t -> bool

     

       56
       +
       

     

       57
       +
       (** Pretty print extension *)

     

       58
       +
       val pp : Format.formatter -> t -> unit

     

       59
       +
       

     

       60
       +
       (** {2 Content Operations} *)

     

       61
       +
       

     

       62
       +
       (** Create text content *)

     

       63
       +
       val text_content : string -> content

     

       64
       +
       

     

       65
       +
       (** Create elements content *)

     

       66
       +
       val elements_content : t list -> content

     

       67
       +
       

     

       68
       +
       (** Create mixed content *)

     

       69
       +
       val mixed_content : string -> t list -> content

     

       70
       +
       

     

       71
       +
       (** Check if content is text *)

     

       72
       +
       val is_text_content : content -> bool

     

       73
       +
       

     

       74
       +
       (** Check if content is elements *)

     

       75
       +
       val is_elements_content : content -> bool

     

       76
       +
       

     

       77
       +
       (** Check if content is mixed *)

     

       78
       +
       val is_mixed_content : content -> bool

     

       79
       +
       

     

       80
       +
       (** Extract text content *)

     

       81
       +
       val text_content_extract : content -> string option

     

       82
       +
       

     

       83
       +
       (** Extract element content *)

     

       84
       +
       val elements_content_extract : content -> t list option

     

       85
       +
       

     

       86
       +
       (** Extract mixed content *)

     

       87
       +
       val mixed_content_extract : content -> (string * t list) option

+86 -56

lib/gpx/gpx.ml

···

       1
       -
       (** {1 mlgpx - OCaml GPX Library} *)

     

       2
        
       

     

       3
       -
       (** Core type definitions and utilities *)

     

       4
       -
       module Types = Types

     

       5
        
       

     

       6
       -
       (** Streaming XML parser *)

     

       7
       -
       module Parser = Parser

     

       8
        
       

     

       9
       -
       (** Streaming XML writer *)

     

       10
       -
       module Writer = Writer

     

       11
        
       

     

       12
       -
       (** Validation engine *)

     

       13
       -
       module Validate = Validate

     

       14
        
       

     

       15
       -
       (* Re-export core types for direct access *)

     

       16
       -
       type latitude = Types.latitude

     

       17
       -
       type longitude = Types.longitude  

     

       18
       -
       type degrees = Types.degrees

     

       19
       -
       type fix_type = Types.fix_type = None_fix | Fix_2d | Fix_3d | Dgps | Pps

     

       20
       -
       type person = Types.person = { name : string option; email : string option; link : link option }

     

       21
       -
       and link = Types.link = { href : string; text : string option; type_ : string option }

     

       22
       -
       type copyright = Types.copyright = { author : string; year : int option; license : string option }

     

       23
       -
       type bounds = Types.bounds = { minlat : latitude; minlon : longitude; maxlat : latitude; maxlon : longitude }

     

       24
       -
       type extension_content = Types.extension_content = Text of string | Elements of extension list | Mixed of string * extension list

     

       25
       -
       and extension = Types.extension = { namespace : string option; name : string; attributes : (string * string) list; content : extension_content }

     

       26
       -
       type metadata = Types.metadata = { name : string option; desc : string option; author : person option; copyright : copyright option; links : link list; time : Ptime.t option; keywords : string option; bounds : bounds option; extensions : extension list }

     

       27
       -
       type waypoint_data = Types.waypoint_data = { lat : latitude; lon : longitude; ele : float option; time : Ptime.t option; magvar : degrees option; geoidheight : float option; name : string option; cmt : string option; desc : string option; src : string option; links : link list; sym : string option; type_ : string option; fix : fix_type option; sat : int option; hdop : float option; vdop : float option; pdop : float option; ageofdgpsdata : float option; dgpsid : int option; extensions : extension list }

     

       28
       -
       type waypoint = Types.waypoint

     

       29
       -
       type route_point = Types.route_point

     

       30
       -
       type track_point = Types.track_point

     

       31
       -
       type route = Types.route = { name : string option; cmt : string option; desc : string option; src : string option; links : link list; number : int option; type_ : string option; extensions : extension list; rtepts : route_point list }

     

       32
       -
       type track_segment = Types.track_segment = { trkpts : track_point list; extensions : extension list }

     

       33
       -
       type track = Types.track = { name : string option; cmt : string option; desc : string option; src : string option; links : link list; number : int option; type_ : string option; extensions : extension list; trksegs : track_segment list }

     

       34
       -
       type gpx = Types.gpx = { version : string; creator : string; metadata : metadata option; waypoints : waypoint list; routes : route list; tracks : track list; extensions : extension list }

     

       35
       -
       type error = Types.error = Invalid_xml of string | Invalid_coordinate of string | Missing_required_attribute of string * string | Missing_required_element of string | Validation_error of string | Xml_error of string | IO_error of string

     

       36
       -
       exception Gpx_error = Types.Gpx_error

     

       37
       -
       type 'a result = ('a, error) Result.t

     

       38
       -
       type validation_issue = Validate.validation_issue = { level : [`Error | `Warning]; message : string; location : string option }

     

       39
       -
       type validation_result = Validate.validation_result = { issues : validation_issue list; is_valid : bool }

     

       40
        
       

     

       41
       -
       (* Re-export core functions *)

     

       42
       -
       let latitude = Types.latitude

     

       43
       -
       let longitude = Types.longitude  

     

       44
       -
       let degrees = Types.degrees

     

       45
       -
       let latitude_to_float = Types.latitude_to_float

     

       46
       -
       let longitude_to_float = Types.longitude_to_float

     

       47
       -
       let degrees_to_float = Types.degrees_to_float

     

       48
       -
       let fix_type_to_string = Types.fix_type_to_string

     

       49
       -
       let fix_type_of_string = Types.fix_type_of_string

     

       50
       -
       let make_waypoint_data = Types.make_waypoint_data

     

       51
       -
       let empty_metadata = Types.empty_metadata

     

       52
       -
       let make_gpx = Types.make_gpx

     

       53
        
       

     

       54
       -
       (* Re-export parser functions *)

     

       55
       -
       let parse = Parser.parse

     

       56
       -
       let parse_string = Parser.parse_string

     

       57
        
       

     

       58
       -
       (* Re-export writer functions *)

     

       59
       -
       let write = Writer.write

     

       60
       -
       let write_string = Writer.write_string

     

       61
        
       

     

       62
       -
       (* Re-export validation functions *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       63
        
       let validate_gpx = Validate.validate_gpx

     

       0
        
       
     

       0
        
       
     

       64
        
       let is_valid = Validate.is_valid

     

       65
       -
       let get_errors = Validate.get_errors  

     

       66
       -
       let get_warnings = Validate.get_warnings

     

       67
       -
       let format_issue = Validate.format_issue
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       1
       +
       (** OCaml library for reading and writing GPX (GPS Exchange Format) files *)

     

       2
        
       

     

       3
       +
       (** {1 Core Modules} *)

     

       0
        
       
     

       4
        
       

     

       5
       +
       (** Geographic coordinate handling *)

     

       6
       +
       module Coordinate = Coordinate

     

       7
        
       

     

       8
       +
       (** Links, persons, and copyright information *)

     

       9
       +
       module Link = Link

     

       10
        
       

     

       11
       +
       (** Extension mechanism for custom GPX elements *)

     

       12
       +
       module Extension = Extension

     

       13
        
       

     

       14
       +
       (** GPS waypoint data and fix types *)

     

       15
       +
       module Waypoint = Waypoint

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       16
        
       

     

       17
       +
       (** GPX metadata including bounds *)

     

       18
       +
       module Metadata = Metadata

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       19
        
       

     

       20
       +
       (** Route data and calculations *)

     

       21
       +
       module Route = Route

     

       0
        
       
     

       22
        
       

     

       23
       +
       (** Track data with segments *)

     

       24
       +
       module Track = Track

     

       0
        
       
     

       25
        
       

     

       26
       +
       (** Error handling *)

     

       27
       +
       module Error = Error

     

       28
       +
       

     

       29
       +
       (** Main GPX document type *)

     

       30
       +
       module Doc = Doc

     

       31
       +
       

     

       32
       +
       (** {1 Main Document Type} *)

     

       33
       +
       

     

       34
       +
       (** Main GPX document type *)

     

       35
       +
       type t = Doc.t

     

       36
       +
       

     

       37
       +
       (** {1 Error Handling} *)

     

       38
       +
       

     

       39
       +
       (** Error types *)

     

       40
       +
       type error = Error.t

     

       41
       +
       

     

       42
       +
       (** GPX exception *)

     

       43
       +
       exception Gpx_error of error

     

       44
       +
       

     

       45
       +
       (** {1 Parsing Functions} *)

     

       46
       +
       

     

       47
       +
       (** Parse GPX from XML input *)

     

       48
       +
       let parse ?validate input = Parser.parse ?validate input

     

       49
       +
       

     

       50
       +
       (** Parse GPX from string *)

     

       51
       +
       let parse_string ?validate s = Parser.parse_string ?validate s

     

       52
       +
       

     

       53
       +
       (** {1 Writing Functions} *)

     

       54
       +
       

     

       55
       +
       (** Write GPX to XML output *)

     

       56
       +
       let write ?validate output gpx = Writer.write ?validate output gpx

     

       57
       +
       

     

       58
       +
       (** Write GPX to string *)

     

       59
       +
       let write_string ?validate gpx = Writer.write_string ?validate gpx

     

       60
       +
       

     

       61
       +
       (** {1 Validation Functions} *)

     

       62
       +
       

     

       63
       +
       (** Validation issue with severity level *)

     

       64
       +
       type validation_issue = Validate.validation_issue = {

     

       65
       +
         level : [`Error | `Warning];

     

       66
       +
         message : string;

     

       67
       +
         location : string option;

     

       68
       +
       }

     

       69
       +
       

     

       70
       +
       (** Result of validation containing all issues found *)

     

       71
       +
       type validation_result = Validate.validation_result = {

     

       72
       +
         issues : validation_issue list;

     

       73
       +
         is_valid : bool;

     

       74
       +
       }

     

       75
       +
       

     

       76
       +
       (** Validate complete GPX document *)

     

       77
        
       let validate_gpx = Validate.validate_gpx

     

       78
       +
       

     

       79
       +
       (** Quick validation - returns true if document is valid *)

     

       80
        
       let is_valid = Validate.is_valid

     

       81
       +
       

     

       82
       +
       (** Get only error messages *)

     

       83
       +
       let errors = Validate.errors

     

       84
       +
       

     

       85
       +
       (** Get only warning messages *)

     

       86
       +
       let warnings = Validate.warnings

     

       87
       +
       

     

       88
       +
       (** Format validation issue for display *)

     

       89
       +
       let format_issue = Validate.format_issue

     

       90
       +
       

     

       91
       +
       (** {1 Constructors and Utilities} *)

     

       92
       +
       

     

       93
       +
       (** Create new GPX document *)

     

       94
       +
       let make_gpx ~creator = Doc.empty ~creator

     

       95
       +
       

     

       96
       +
       (** Create empty GPX document *)

     

       97
       +
       let empty ~creator = Doc.empty ~creator

+462 -317

lib/gpx/gpx.mli

···

       1
       -
       (** {1 MLGpx - OCaml GPX Library}

     

       2
       -
       

     

       3
       -
           A high-quality OCaml library for parsing and generating GPX (GPS Exchange Format) files.

     

       4
       -
           GPX is a standardized XML format for exchanging GPS data between applications and devices.

     

       5
       -
       

     

       6
       -
           {2 Overview}

     

       7
       -
       

     

       8
       -
           The GPX format defines a standard way to describe waypoints, routes, and tracks.

     

       9
       -
           This library provides a complete implementation of GPX 1.1 with strong type safety 

     

       10
       -
           and memory-efficient streaming processing.

     

       11
       -
       

     

       12
       -
           {b Key Features:}

     

       13
       -
           - ✅ Complete GPX 1.1 support with all standard elements

     

       14
       -
           - ✅ Type-safe coordinate validation (WGS84 datum)

     

       15
       -
           - ✅ Memory-efficient streaming parser and writer

     

       16
       -
           - ✅ Comprehensive validation with detailed error reporting

     

       17
       -
           - ✅ Extension support for custom elements

     

       18
       -
           - ✅ Cross-platform (core has no Unix dependencies)

     

       19
       -
       

     

       20
       -
           {2 Quick Start}

     

       21
       -
       

     

       22
        
           {[

     

       23
        
             open Gpx

     

       24
       -
       

     

       25
        
             (* Create coordinates *)

     

       26
       -
             let* lat = latitude 37.7749 in

     

       27
       -
             let* lon = longitude (-122.4194) in

     

       28
        
             

     

       29
        
             (* Create a waypoint *)

     

       30
       -
             let wpt = make_waypoint_data lat lon in

     

       31
       -
             let wpt = { wpt with name = Some "San Francisco" } in

     

       0
        
       
     

       32
        
             

     

       33
        
             (* Create GPX document *)

     

       34
       -
             let gpx = make_gpx ~creator:"mlgpx" in

     

       35
       -
             let gpx = { gpx with waypoints = [wpt] } in

     

       36
        
             

     

       37
       -
             (* Convert to XML string *)

     

       38
       -
             write_string gpx

     

       0
        
       
     

       0
        
       
     

       39
        
           ]}

     

       40
       -
       

     

       41
       -
           {2 Core Types} *)

     

       42
       -
       

     

       43
       -
       (** {3 Geographic Coordinates}

     

       44
       -
       

     

       45
       -
           All coordinates use the WGS84 datum as specified by the GPX standard. *)

     

       46
       -
       

     

       47
       -
       (** Latitude coordinate (-90.0 to 90.0 degrees).

     

       48
       -
           Private type ensures validation through smart constructor. *)

     

       49
       -
       type latitude = Types.latitude

     

       50
       -
       

     

       51
       -
       (** Longitude coordinate (-180.0 to 180.0 degrees).

     

       52
       -
           Private type ensures validation through smart constructor. *)  

     

       53
       -
       type longitude = Types.longitude

     

       54
       -
       

     

       55
       -
       (** Degrees for magnetic variation (0.0 to 360.0 degrees).

     

       56
       -
           Private type ensures validation through smart constructor. *)

     

       57
       -
       type degrees = Types.degrees

     

       58
       -
       

     

       59
       -
       (** Create validated latitude coordinate.

     

       60
       -
           @param lat Latitude in degrees (-90.0 to 90.0)

     

       61
       -
           @return [Ok lat] if valid, [Error msg] if out of range *)

     

       62
       -
       val latitude : float -> (latitude, string) result

     

       63
       -
       

     

       64
       -
       (** Create validated longitude coordinate.

     

       65
       -
           @param lon Longitude in degrees (-180.0 to 180.0) 

     

       66
       -
           @return [Ok lon] if valid, [Error msg] if out of range *)

     

       67
       -
       val longitude : float -> (longitude, string) result

     

       68
       -
       

     

       69
       -
       (** Create validated degrees value.

     

       70
       -
           @param deg Degrees (0.0 to 360.0)

     

       71
       -
           @return [Ok deg] if valid, [Error msg] if out of range *)

     

       72
       -
       val degrees : float -> (degrees, string) result

     

       73
       -
       

     

       74
       -
       (** Convert latitude back to float *)

     

       75
       -
       val latitude_to_float : latitude -> float

     

       76
       -
       

     

       77
       -
       (** Convert longitude back to float *)

     

       78
       -
       val longitude_to_float : longitude -> float

     

       79
       -
       

     

       80
       -
       (** Convert degrees back to float *)

     

       81
       -
       val degrees_to_float : degrees -> float

     

       82
       -
       

     

       83
       -
       (** {3 GPS Fix Types}

     

       84
       -
       

     

       85
       -
           Standard GPS fix types as defined in the GPX specification. *)

     

       86
       -
       

     

       87
       -
       (** GPS fix type indicating the quality/type of GPS reading *)

     

       88
       -
       type fix_type = Types.fix_type =

     

       89
       -
         | None_fix  (** No fix available *)

     

       90
       -
         | Fix_2d    (** 2D fix (latitude/longitude) *)

     

       91
       -
         | Fix_3d    (** 3D fix (latitude/longitude/altitude) *)

     

       92
       -
         | Dgps      (** Differential GPS *)

     

       93
       -
         | Pps       (** Precise Positioning Service *)

     

       94
       -
       

     

       95
       -
       (** Convert fix type to string representation *)

     

       96
       -
       val fix_type_to_string : fix_type -> string

     

       97
       -
       

     

       98
       -
       (** Parse fix type from string *)

     

       99
       -
       val fix_type_of_string : string -> fix_type option

     

       100
       -
       

     

       101
       -
       (** {3 Metadata Elements} *)

     

       102
       -
       

     

       103
       -
       (** Person information for author, copyright holder, etc. *)

     

       104
       -
       type person = Types.person = {

     

       105
       -
         name : string option;   (** Person's name *)

     

       106
       -
         email : string option;  (** Email address *)

     

       107
       -
         link : link option;     (** Link to person's website *)

     

       108
       -
       }

     

       109
       -
       

     

       110
       -
       (** External link with optional description and type *)

     

       111
       -
       and link = Types.link = {

     

       112
       -
         href : string;          (** URL of the link *)

     

       113
       -
         text : string option;   (** Text description of link *)

     

       114
       -
         type_ : string option;  (** MIME type of linked content *)

     

       115
       -
       }

     

       116
       -
       

     

       117
       -
       (** Copyright information for the GPX file *)

     

       118
       -
       type copyright = Types.copyright = {

     

       119
       -
         author : string;            (** Copyright holder *)

     

       120
       -
         year : int option;          (** Year of copyright *)

     

       121
       -
         license : string option;    (** License terms *)

     

       122
       -
       }

     

       123
       -
       

     

       124
       -
       (** Geographic bounds - minimum bounding rectangle *)

     

       125
       -
       type bounds = Types.bounds = {

     

       126
       -
         minlat : latitude;   (** Minimum latitude *)

     

       127
       -
         minlon : longitude;  (** Minimum longitude *)  

     

       128
       -
         maxlat : latitude;   (** Maximum latitude *)

     

       129
       -
         maxlon : longitude;  (** Maximum longitude *)

     

       130
       -
       }

     

       131
       -
       

     

       132
       -
       (** Extension content for custom elements *)

     

       133
       -
       type extension_content = Types.extension_content =

     

       134
       -
         | Text of string                      (** Text content *)

     

       135
       -
         | Elements of extension list          (** Child elements *)

     

       136
       -
         | Mixed of string * extension list    (** Mixed text and elements *)

     

       137
       -
       

     

       138
       -
       (** Extension element for custom data *)

     

       139
       -
       and extension = Types.extension = {

     

       140
       -
         namespace : string option;              (** XML namespace *)

     

       141
       -
         name : string;                          (** Element name *)

     

       142
       -
         attributes : (string * string) list;   (** Element attributes *)

     

       143
       -
         content : extension_content;            (** Element content *)

     

       144
       -
       }

     

       145
       -
       

     

       146
       -
       (** GPX file metadata containing information about the file itself *)

     

       147
       -
       type metadata = Types.metadata = {

     

       148
       -
         name : string option;        (** Name of GPX file *)

     

       149
       -
         desc : string option;        (** Description of contents *)

     

       150
       -
         author : person option;      (** Person who created GPX file *)

     

       151
       -
         copyright : copyright option; (** Copyright information *)

     

       152
       -
         links : link list;           (** Related links *)

     

       153
       -
         time : Ptime.t option;       (** Creation/modification time *)

     

       154
       -
         keywords : string option;    (** Keywords for searching *)

     

       155
       -
         bounds : bounds option;      (** Geographic bounds *)

     

       156
       -
         extensions : extension list; (** Custom extensions *)

     

       157
       -
       }

     

       158
       -
       

     

       159
       -
       (** Create empty metadata record *)

     

       160
       -
       val empty_metadata : metadata

     

       161
       -
       

     

       162
       -
       (** {3 Geographic Points}

     

       163
       -
       

     

       164
       -
           All geographic points (waypoints, route points, track points) share the same structure. *)

     

       165
       -
       

     

       166
       -
       (** Base waypoint data structure used for all geographic points.

     

       167
       -
           Contains position, time, and various GPS-related fields. *)

     

       168
       -
       type waypoint_data = Types.waypoint_data = {

     

       169
       -
         lat : latitude;              (** Latitude coordinate *)

     

       170
       -
         lon : longitude;             (** Longitude coordinate *)

     

       171
       -
         ele : float option;          (** Elevation in meters *)

     

       172
       -
         time : Ptime.t option;       (** Time of GPS reading *)

     

       173
       -
         magvar : degrees option;     (** Magnetic variation at point *)

     

       174
       -
         geoidheight : float option;  (** Height of geoid above WGS84 ellipsoid *)

     

       175
       -
         name : string option;        (** Point name *)

     

       176
       -
         cmt : string option;         (** GPS comment *)

     

       177
       -
         desc : string option;        (** Point description *)

     

       178
       -
         src : string option;         (** Source of data *)

     

       179
       -
         links : link list;           (** Related links *)

     

       180
       -
         sym : string option;         (** GPS symbol name *)

     

       181
       -
         type_ : string option;       (** Point classification *)

     

       182
       -
         fix : fix_type option;       (** Type of GPS fix *)

     

       183
       -
         sat : int option;            (** Number of satellites *)

     

       184
       -
         hdop : float option;         (** Horizontal dilution of precision *)

     

       185
       -
         vdop : float option;         (** Vertical dilution of precision *)

     

       186
       -
         pdop : float option;         (** Position dilution of precision *)

     

       187
       -
         ageofdgpsdata : float option; (** Age of DGPS data *)

     

       188
       -
         dgpsid : int option;         (** DGPS station ID *)

     

       189
       -
         extensions : extension list;  (** Custom extensions *)

     

       190
       -
       }

     

       191
        
       

     

       192
       -
       (** Create basic waypoint data with required coordinates *)

     

       193
       -
       val make_waypoint_data : latitude -> longitude -> waypoint_data

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       194
        
       

     

       195
       -
       (** Individual waypoint - a point of interest *)

     

       196
       -
       type waypoint = Types.waypoint

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       197
        
       

     

       198
       -
       (** Route point - point along a planned route *)

     

       199
       -
       type route_point = Types.route_point  

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       200
        
       

     

       201
       -
       (** Track point - recorded position along an actual path *)

     

       202
       -
       type track_point = Types.track_point

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       203
        
       

     

       204
       -
       (** {3 Routes}

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       205
        
       

     

       206
       -
           A route is an ordered list of waypoints representing a planned path. *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       207
        
       

     

       208
       -
       (** Route definition - ordered list of waypoints for navigation *)

     

       209
       -
       type route = Types.route = {

     

       210
       -
         name : string option;         (** Route name *)

     

       211
       -
         cmt : string option;          (** GPS comment *)

     

       212
       -
         desc : string option;         (** Route description *)

     

       213
       -
         src : string option;          (** Source of data *)

     

       214
       -
         links : link list;            (** Related links *)

     

       215
       -
         number : int option;          (** Route number *)

     

       216
       -
         type_ : string option;        (** Route classification *)

     

       217
       -
         extensions : extension list;   (** Custom extensions *)

     

       218
       -
         rtepts : route_point list;    (** Route points *)

     

       219
       -
       }

     

       220
        
       

     

       221
       -
       (** {3 Tracks}

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       222
        
       

     

       223
       -
           A track represents an actual recorded path, consisting of track segments. *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       224
        
       

     

       225
       -
       (** Track segment - continuous set of track points *)

     

       226
       -
       type track_segment = Types.track_segment = {

     

       227
       -
         trkpts : track_point list;   (** Track points in segment *)

     

       228
       -
         extensions : extension list; (** Custom extensions *)

     

       229
       -
       }

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       230
        
       

     

       231
       -
       (** Track definition - recorded path made up of segments *)

     

       232
       -
       type track = Types.track = {

     

       233
       -
         name : string option;          (** Track name *)

     

       234
       -
         cmt : string option;           (** GPS comment *)

     

       235
       -
         desc : string option;          (** Track description *)

     

       236
       -
         src : string option;           (** Source of data *)

     

       237
       -
         links : link list;             (** Related links *)

     

       238
       -
         number : int option;           (** Track number *)

     

       239
       -
         type_ : string option;         (** Track classification *)

     

       240
       -
         extensions : extension list;    (** Custom extensions *)

     

       241
       -
         trksegs : track_segment list;  (** Track segments *)

     

       242
       -
       }

     

       243
        
       

     

       244
       -
       (** {3 Main GPX Document}

     

       245
       -
       

     

       246
       -
           The root GPX element contains metadata and collections of waypoints, routes, and tracks. *)

     

       247
       -
       

     

       248
       -
       (** Main GPX document conforming to GPX 1.1 standard *)

     

       249
       -
       type gpx = Types.gpx = {

     

       250
       -
         version : string;            (** GPX version (always "1.1") *)

     

       251
       -
         creator : string;            (** Creating application *)

     

       252
       -
         metadata : metadata option;  (** File metadata *)

     

       253
       -
         waypoints : waypoint list;   (** Waypoints *)

     

       254
       -
         routes : route list;         (** Routes *)

     

       255
       -
         tracks : track list;         (** Tracks *)

     

       256
       -
         extensions : extension list; (** Custom extensions *)

     

       257
       -
       }

     

       258
       -
       

     

       259
       -
       (** Create GPX document with required creator field *)

     

       260
       -
       val make_gpx : creator:string -> gpx

     

       261
        
       

     

       262
       -
       (** {3 Error Handling} *)

     

       263
        
       

     

       264
       -
       (** Errors that can occur during GPX processing *)

     

       265
       -
       type error = Types.error =

     

       266
       -
         | Invalid_xml of string                   (** XML parsing error *)

     

       267
       -
         | Invalid_coordinate of string            (** Coordinate validation error *)

     

       268
       -
         | Missing_required_attribute of string * string (** Missing XML attribute *)

     

       269
       -
         | Missing_required_element of string      (** Missing XML element *)

     

       270
       -
         | Validation_error of string              (** GPX validation error *)

     

       271
       -
         | Xml_error of string                     (** XML processing error *)

     

       272
       -
         | IO_error of string                      (** I/O error *)

     

       273
        
       

     

       274
       -
       (** Exception type for GPX errors *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       275
        
       exception Gpx_error of error

     

       276
        
       

     

       277
       -
       (** Result type for operations that may fail *)

     

       278
       -
       type 'a result = ('a, error) Result.t

     

       0
        
       
     

       0
        
       
     

       279
        
       

     

       280
       -
       (** {2 Parsing Functions}

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       281
        
       

     

       282
       -
           Parse GPX documents from XML input sources. *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       283
        
       

     

       284
       -
       (** Parse GPX document from xmlm input source.

     

       285
       -
           @param input The xmlm input source

     

       286
       -
           @return [Ok gpx] on success, [Error err] on failure *)

     

       287
       -
       val parse : Xmlm.input -> gpx result

     

       288
        
       

     

       289
       -
       (** Parse GPX document from string.

     

       290
       -
           @param xml_string GPX document as XML string  

     

       291
       -
           @return [Ok gpx] on success, [Error err] on failure *)

     

       292
       -
       val parse_string : string -> gpx result

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       293
        
       

     

       294
       -
       (** {2 Writing Functions}

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       295
        
       

     

       296
       -
           Generate GPX XML from document structures. *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       297
        
       

     

       298
       -
       (** Write GPX document to xmlm output destination.

     

       299
       -
           @param output The xmlm output destination

     

       300
       -
           @param gpx The GPX document to write

     

       301
       -
           @return [Ok ()] on success, [Error err] on failure *)

     

       302
       -
       val write : Xmlm.output -> gpx -> unit result

     

       303
       -
       

     

       304
       -
       (** Write GPX document to XML string.

     

       305
       -
           @param gpx The GPX document to write

     

       306
       -
           @return [Ok xml_string] on success, [Error err] on failure *)

     

       307
       -
       val write_string : gpx -> string result

     

       308
       -
       

     

       309
       -
       (** {2 Validation Functions}

     

       310
       -
       

     

       311
       -
           Validate GPX documents for correctness and best practices. *)

     

       312
       -
       

     

       313
       -
       (** Validation issue with severity level *)

     

       314
        
       type validation_issue = Validate.validation_issue = {

     

       315
       -
         level : [`Error | `Warning];     (** Severity level *)

     

       316
       -
         message : string;                (** Issue description *)

     

       317
       -
         location : string option;        (** Location in document *)

     

       318
        
       }

     

       319
        
       

     

       320
       -
       (** Result of validation containing all issues found *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       321
        
       type validation_result = Validate.validation_result = {

     

       322
       -
         issues : validation_issue list;  (** All validation issues *)

     

       323
       -
         is_valid : bool;                 (** True if no errors found *)

     

       324
        
       }

     

       325
        
       

     

       326
       -
       (** Validate complete GPX document.

     

       327
       -
           Checks coordinates, required fields, and best practices.

     

       328
       -
           @param gpx GPX document to validate

     

       329
       -
           @return Validation result with any issues found *)

     

       330
       -
       val validate_gpx : gpx -> validation_result

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       331
        
       

     

       332
       -
       (** Quick validation check.

     

       333
       -
           @param gpx GPX document to validate

     

       334
       -
           @return [true] if document is valid (no errors) *)

     

       335
       -
       val is_valid : gpx -> bool

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       336
        
       

     

       337
       -
       (** Get only error-level validation issues.

     

       338
       -
           @param gpx GPX document to validate

     

       339
       -
           @return List of validation errors *)

     

       340
       -
       val get_errors : gpx -> validation_issue list

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       341
        
       

     

       342
       -
       (** Get only warning-level validation issues.

     

       343
       -
           @param gpx GPX document to validate  

     

       344
       -
           @return List of validation warnings *)

     

       345
       -
       val get_warnings : gpx -> validation_issue list

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       346
        
       

     

       347
       -
       (** Format validation issue for display.

     

       348
       -
           @param issue Validation issue to format

     

       349
       -
           @return Human-readable error message *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       350
        
       val format_issue : validation_issue -> string

     

       351
        
       

     

       352
       -
       (** {2 Module Access}

     

       0
        
       
     

       0
        
       
     

       353
        
       

     

       354
       -
           Direct access to submodules for advanced usage. *)

     

       355
       -
       

     

       356
       -
       (** Core type definitions and utilities *)

     

       357
       -
       module Types = Types

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       358
        
       

     

       359
       -
       (** Streaming XML parser *)

     

       360
       -
       module Parser = Parser

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       361
        
       

     

       362
       -
       (** Streaming XML writer *) 

     

       363
       -
       module Writer = Writer

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       364
        
       

     

       365
       -
       (** Validation engine *)

     

       366
       -
       module Validate = Validate
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       1
       +
       (** OCaml library for reading and writing GPX (GPS Exchange Format) files.

     

       2
       +
           

     

       3
       +
           {1 Overview}

     

       4
       +
           

     

       5
       +
           GPX (GPS Exchange Format) is an XML-based format for GPS data interchange,

     

       6
       +
           standardized by {{:https://www.topografix.com/gpx.asp}Topografix}. This library

     

       7
       +
           provides a complete implementation of the GPX 1.1 specification with strong

     

       8
       +
           type safety and validation.

     

       9
       +
           

     

       10
       +
           GPX files can contain three main types of GPS data:

     

       11
       +
           - {b Waypoints}: Individual points of interest with coordinates

     

       12
       +
           - {b Routes}: Ordered sequences of waypoints representing a planned path

     

       13
       +
           - {b Tracks}: Recorded GPS traces, typically from actual journeys

     

       14
       +
           

     

       15
       +
           All coordinates in GPX use the WGS84 datum (World Geodetic System 1984),

     

       16
       +
           the same coordinate system used by GPS satellites. Coordinates are expressed

     

       17
       +
           as decimal degrees, with elevations in meters above mean sea level.

     

       18
       +
           

     

       19
       +
           {2 Quick Start Example}

     

       20
       +
           

     

       0
        
       
     

       21
        
           {[

     

       22
        
             open Gpx

     

       23
       +
             

     

       24
        
             (* Create coordinates *)

     

       25
       +
             let lat = Coordinate.latitude 37.7749 |> Result.get_ok in

     

       26
       +
             let lon = Coordinate.longitude (-122.4194) |> Result.get_ok in

     

       27
        
             

     

       28
        
             (* Create a waypoint *)

     

       29
       +
             let waypoint = Waypoint.make lat lon 

     

       30
       +
               |> Waypoint.with_name "San Francisco"

     

       31
       +
               |> Waypoint.with_description "Golden Gate Bridge area" in

     

       32
        
             

     

       33
        
             (* Create GPX document *)

     

       34
       +
             let gpx = make_gpx ~creator:"my-app" 

     

       35
       +
               |> Doc.add_waypoint waypoint in

     

       36
        
             

     

       37
       +
             (* Write to file or string *)

     

       38
       +
             match write_string gpx with

     

       39
       +
             | Ok xml -> print_endline xml

     

       40
       +
             | Error e -> Printf.eprintf "Error: %s\n" (Error.to_string e)

     

       41
        
           ]}

     

       42
       +
           

     

       43
       +
           This library provides a clean, modular interface for working with GPX files,

     

       44
       +
           with separate modules for each major component of the GPX specification. *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       45
        
       

     

       46
       +
       (** {1 Core Modules}

     

       47
       +
           

     

       48
       +
           The library is organized into focused modules, each handling a specific aspect

     

       49
       +
           of GPX data. Each module provides complete functionality for its domain with

     

       50
       +
           strong type safety and validation. *)

     

       51
        
       

     

       52
       +
       (** {2 Geographic coordinate handling with validation}

     

       53
       +
           

     

       54
       +
           The {!Coordinate} module provides validated coordinate types for latitude,

     

       55
       +
           longitude, and degrees. All coordinates use the WGS84 datum and are validated

     

       56
       +
           at construction time to ensure they fall within valid ranges:

     

       57
       +
           - Latitude: -90.0 to +90.0 degrees

     

       58
       +
           - Longitude: -180.0 to +180.0 degrees  

     

       59
       +
           - Degrees: 0.0 to 360.0 degrees

     

       60
       +
           

     

       61
       +
           Example: [Coordinate.latitude 37.7749] creates a validated latitude. *)

     

       62
       +
       module Coordinate = Coordinate

     

       63
        
       

     

       64
       +
       (** {2 Links, persons, and copyright information}

     

       65
       +
           

     

       66
       +
           The {!Link} module handles web links, author information, and copyright data

     

       67
       +
           as defined in the GPX specification. This includes:

     

       68
       +
           - Web links with optional text and MIME type

     

       69
       +
           - Person records with name, email, and associated links

     

       70
       +
           - Copyright information with author, year, and license terms *)

     

       71
       +
       module Link = Link

     

       72
        
       

     

       73
       +
       (** {2 Extension mechanism for custom GPX elements}

     

       74
       +
           

     

       75
       +
           The {!Extension} module provides support for custom XML elements that extend

     

       76
       +
           the standard GPX format. Extensions allow applications to embed additional

     

       77
       +
           data while maintaining compatibility with standard GPX readers. *)

     

       78
       +
       module Extension = Extension

     

       79
        
       

     

       80
       +
       (** {2 GPS waypoint data and fix types}

     

       81
       +
           

     

       82
       +
           The {!Waypoint} module handles individual GPS points, including waypoints,

     

       83
       +
           route points, and track points. Each waypoint contains:

     

       84
       +
           - Required coordinates (latitude/longitude)

     

       85
       +
           - Optional elevation in meters above mean sea level

     

       86
       +
           - Optional timestamp

     

       87
       +
           - Optional metadata like name, description, symbol

     

       88
       +
           - Optional GPS quality information (accuracy, satellite count, etc.)

     

       89
       +
           

     

       90
       +
           Fix types indicate GPS quality: none, 2D, 3D, DGPS, or PPS. *)

     

       91
       +
       module Waypoint = Waypoint

     

       92
        
       

     

       93
       +
       (** {2 GPX metadata including bounds}

     

       94
       +
           

     

       95
       +
           The {!Metadata} module handles document-level information:

     

       96
       +
           - File name and description

     

       97
       +
           - Author and copyright information

     

       98
       +
           - Creation time and keywords

     

       99
       +
           - Geographic bounding box of all data

     

       100
       +
           - Links to related resources *)

     

       101
       +
       module Metadata = Metadata

     

       102
        
       

     

       103
       +
       (** {2 Route data and calculations}

     

       104
       +
           

     

       105
       +
           The {!Route} module handles planned paths represented as ordered sequences

     

       106
       +
           of waypoints. Routes typically represent intended journeys rather than

     

       107
       +
           recorded tracks. Each route can include:

     

       108
       +
           - Ordered list of waypoints (route points)

     

       109
       +
           - Route metadata (name, description, links)

     

       110
       +
           - Distance calculations between points *)

     

       111
       +
       module Route = Route

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       112
        
       

     

       113
       +
       (** {2 Track data with segments}

     

       114
       +
           

     

       115
       +
           The {!Track} module handles recorded GPS traces, typically representing

     

       116
       +
           actual journeys. Tracks are divided into segments to handle GPS interruptions:

     

       117
       +
           - Track segments contain ordered track points

     

       118
       +
           - Each track point is a timestamped waypoint

     

       119
       +
           - Multiple segments per track handle GPS signal loss

     

       120
       +
           - Distance and time calculations available *)

     

       121
       +
       module Track = Track

     

       122
        
       

     

       123
       +
       (** {2 Error handling}

     

       124
       +
           

     

       125
       +
           The {!Error} module provides comprehensive error handling for GPX operations:

     

       126
       +
           - XML parsing and validation errors

     

       127
       +
           - Coordinate validation errors  

     

       128
       +
           - Missing required elements or attributes

     

       129
       +
           - File I/O errors *)

     

       130
       +
       module Error = Error

     

       131
        
       

     

       132
       +
       (** {2 Main GPX document type}

     

       133
       +
           

     

       134
       +
           The {!Doc} module represents complete GPX documents containing:

     

       135
       +
           - Document metadata (creator, version)

     

       136
       +
           - Collections of waypoints, routes, and tracks

     

       137
       +
           - Document-level extensions

     

       138
       +
           - Statistics and analysis functions *)

     

       139
       +
       module Doc = Doc

     

       140
        
       

     

       141
       +
       (** {1 Main Document Type} *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       142
        
       

     

       143
       +
       (** A complete GPX document containing waypoints, routes, tracks, and metadata.

     

       144
       +
           

     

       145
       +
           This is the main type representing a complete GPX file. GPX documents must

     

       146
       +
           have a creator string (identifying the creating application) and follow the

     

       147
       +
           GPX 1.1 specification format. *)

     

       148
       +
       type t = Doc.t

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       149
        
       

     

       150
       +
       (** {1 Error Handling} *)

     

       151
        
       

     

       152
       +
       (** Comprehensive error type covering all possible GPX operation failures.

     

       153
       +
           

     

       154
       +
           Errors can occur during:

     

       155
       +
           - XML parsing (malformed XML, invalid structure)

     

       156
       +
           - Coordinate validation (out of range values)

     

       157
       +
           - Missing required GPX elements or attributes

     

       158
       +
           - File I/O operations *)

     

       159
       +
       type error = Error.t

     

       0
        
       
     

       160
        
       

     

       161
       +
       (** GPX exception raised for unrecoverable errors.

     

       162
       +
           

     

       163
       +
           Most functions return [Result.t] for error handling, but this exception

     

       164
       +
           may be raised in exceptional circumstances. *)

     

       165
        
       exception Gpx_error of error

     

       166
        
       

     

       167
       +
       (** {1 Parsing Functions}

     

       168
       +
           

     

       169
       +
           Parse GPX data from various sources. All parsing functions support optional

     

       170
       +
           validation to check compliance with GPX specification constraints. *)

     

       171
        
       

     

       172
       +
       (** Parse GPX from XML input source.

     

       173
       +
           

     

       174
       +
           Reads GPX data from an {!Xmlm.input} source, which can be created from

     

       175
       +
           files, strings, or other input sources using the {{:https://erratique.ch/software/xmlm}Xmlm} library.

     

       176
       +
           

     

       177
       +
           @param validate If [true] (default [false]), validates the parsed document

     

       178
       +
                          against GPX specification rules. Validation checks coordinate

     

       179
       +
                          ranges, required elements, and data consistency.

     

       180
       +
           @param input XMLm input source created with [Xmlm.make_input]

     

       181
       +
           @return [Ok gpx] with parsed document, or [Error e] if parsing fails

     

       182
       +
           

     

       183
       +
           Example:

     

       184
       +
           {[

     

       185
       +
             let input = Xmlm.make_input (`String (0, gpx_xml_string)) in

     

       186
       +
             match parse ~validate:true input with

     

       187
       +
             | Ok gpx -> Printf.printf "Parsed %d waypoints\n" (List.length (Doc.waypoints gpx))

     

       188
       +
             | Error e -> Printf.eprintf "Parse error: %s\n" (Error.to_string e)

     

       189
       +
           ]} *)

     

       190
       +
       val parse : ?validate:bool -> Xmlm.input -> (t, error) result

     

       191
        
       

     

       192
       +
       (** Parse GPX from XML string.

     

       193
       +
           

     

       194
       +
           Convenience function for parsing GPX data from a string. Equivalent to

     

       195
       +
           creating an {!Xmlm.input} from the string and calling {!parse}.

     

       196
       +
           

     

       197
       +
           @param validate If [true] (default [false]), validates the parsed document

     

       198
       +
           @param s Complete GPX XML document as a string

     

       199
       +
           @return [Ok gpx] with parsed document, or [Error e] if parsing fails

     

       200
       +
           

     

       201
       +
           Example:

     

       202
       +
           {[

     

       203
       +
             let gpx_xml = {|<?xml version="1.0"?>

     

       204
       +
             <gpx version="1.1" creator="my-app">

     

       205
       +
               <wpt lat="37.7749" lon="-122.4194">

     

       206
       +
                 <name>San Francisco</name>

     

       207
       +
               </wpt>

     

       208
       +
             </gpx>|} in

     

       209
       +
             match parse_string ~validate:true gpx_xml with

     

       210
       +
             | Ok gpx -> print_endline "Successfully parsed GPX"

     

       211
       +
             | Error e -> Printf.eprintf "Error: %s\n" (Error.to_string e)

     

       212
       +
           ]} *)

     

       213
       +
       val parse_string : ?validate:bool -> string -> (t, error) result

     

       214
        
       

     

       215
       +
       (** {1 Writing Functions}

     

       216
       +
           

     

       217
       +
           Generate GPX XML from document structures. All writing functions support

     

       218
       +
           optional validation before output generation. *)

     

       219
        
       

     

       220
       +
       (** Write GPX to XML output destination.

     

       221
       +
           

     

       222
       +
           Generates standard GPX 1.1 XML and writes it to an {!Xmlm.dest} destination.

     

       223
       +
           The output destination can target files, buffers, or other sinks.

     

       224
       +
           

     

       225
       +
           @param validate If [true] (default [false]), validates the document before

     

       226
       +
                          writing to ensure GPX specification compliance

     

       227
       +
           @param dest XMLm output destination created with [Xmlm.make_output]  

     

       228
       +
           @param gpx GPX document to write

     

       229
       +
           @return [Ok ()] on success, or [Error e] if writing fails

     

       230
       +
           

     

       231
       +
           Example:

     

       232
       +
           {[

     

       233
       +
             let output = Buffer.create 1024 in

     

       234
       +
             let dest = Xmlm.make_output (`Buffer output) in

     

       235
       +
             match write ~validate:true dest gpx with

     

       236
       +
             | Ok () -> Buffer.contents output

     

       237
       +
             | Error e -> failwith (Error.to_string e)

     

       238
       +
           ]} *)

     

       239
       +
       val write : ?validate:bool -> Xmlm.dest -> t -> (unit, error) result

     

       240
        
       

     

       241
       +
       (** Write GPX to XML string.

     

       242
       +
           

     

       243
       +
           Convenience function that generates a complete GPX XML document as a string.

     

       244
       +
           The output includes XML declaration and proper namespace declarations.

     

       245
       +
           

     

       246
       +
           @param validate If [true] (default [false]), validates before writing

     

       247
       +
           @param gpx GPX document to serialize

     

       248
       +
           @return [Ok xml_string] with complete GPX XML, or [Error e] if generation fails

     

       249
       +
           

     

       250
       +
           Example:

     

       251
       +
           {[

     

       252
       +
             match write_string ~validate:true gpx with

     

       253
       +
             | Ok xml -> 

     

       254
       +
                 print_endline "Generated GPX:";

     

       255
       +
                 print_endline xml

     

       256
       +
             | Error e -> 

     

       257
       +
                 Printf.eprintf "Failed to generate GPX: %s\n" (Error.to_string e)

     

       258
       +
           ]} *)

     

       259
       +
       val write_string : ?validate:bool -> t -> (string, error) result

     

       260
        
       

     

       261
       +
       (** {1 Validation Functions}

     

       262
       +
           

     

       263
       +
           Comprehensive validation against GPX specification rules and best practices.

     

       264
       +
           Validation checks coordinate ranges, required elements, data consistency,

     

       265
       +
           and common issues that may cause problems for GPS applications. *)

     

       266
        
       

     

       267
       +
       (** A validation issue found during GPX document checking.

     

       268
       +
           

     

       269
       +
           Issues are classified as either errors (specification violations that make

     

       270
       +
           the GPX invalid) or warnings (best practice violations or suspicious data). *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       271
        
       type validation_issue = Validate.validation_issue = {

     

       272
       +
         level : [`Error | `Warning];     (** [`Error] for specification violations, [`Warning] for best practice issues *)

     

       273
       +
         message : string;                (** Human-readable description of the issue *)

     

       274
       +
         location : string option;        (** Optional location context (e.g., "waypoint 1", "track segment 2") *)

     

       275
        
       }

     

       276
        
       

     

       277
       +
       (** Complete validation result with all issues and validity status.

     

       278
       +
           

     

       279
       +
           The [is_valid] field indicates whether the document contains any errors.

     

       280
       +
           Documents with only warnings are considered valid. *)

     

       281
        
       type validation_result = Validate.validation_result = {

     

       282
       +
         issues : validation_issue list;  (** All validation issues found, both errors and warnings *)

     

       283
       +
         is_valid : bool;                 (** [true] if no errors found (warnings are allowed) *)

     

       284
        
       }

     

       285
        
       

     

       286
       +
       (** Perform comprehensive validation of a GPX document.

     

       287
       +
           

     

       288
       +
           Checks all aspects of the GPX document against the specification:

     

       289
       +
           - Coordinate ranges (latitude -90 to +90, longitude -180 to +180)

     

       290
       +
           - Required elements and attributes

     

       291
       +
           - Data consistency (e.g., time ordering in tracks)

     

       292
       +
           - Reasonable value ranges for GPS quality metrics

     

       293
       +
           - Proper structure and nesting

     

       294
       +
           

     

       295
       +
           @param gpx The GPX document to validate

     

       296
       +
           @return Complete validation result with all issues found

     

       297
       +
           

     

       298
       +
           Example:

     

       299
       +
           {[

     

       300
       +
             let result = validate_gpx gpx in

     

       301
       +
             if result.is_valid then

     

       302
       +
               Printf.printf "Document is valid with %d warnings\n" 

     

       303
       +
                 (List.length (List.filter (fun i -> i.level = `Warning) result.issues))

     

       304
       +
             else begin

     

       305
       +
               print_endline "Document has errors:";

     

       306
       +
               List.iter (fun issue ->

     

       307
       +
                 if issue.level = `Error then

     

       308
       +
                   Printf.printf "  ERROR: %s\n" (format_issue issue)

     

       309
       +
               ) result.issues

     

       310
       +
             end

     

       311
       +
           ]} *)

     

       312
       +
       val validate_gpx : t -> validation_result

     

       313
        
       

     

       314
       +
       (** Quick validation check - returns true if document has no errors.

     

       315
       +
           

     

       316
       +
           Equivalent to [(validate_gpx gpx).is_valid] but potentially more efficient

     

       317
       +
           as it can stop at the first error found.

     

       318
       +
           

     

       319
       +
           @param gpx The GPX document to validate

     

       320
       +
           @return [true] if valid (no errors), [false] if errors found *)

     

       321
       +
       val is_valid : t -> bool

     

       322
        
       

     

       323
       +
       (** Get only validation errors (specification violations).

     

       324
       +
           

     

       325
       +
           Returns only the issues marked as errors, filtering out warnings.

     

       326
       +
           If this list is empty, the document is valid according to the GPX specification.

     

       327
       +
           

     

       328
       +
           @param gpx The GPX document to validate

     

       329
       +
           @return List of error-level validation issues *)

     

       330
       +
       val errors : t -> validation_issue list

     

       331
        
       

     

       332
       +
       (** Get only validation warnings (best practice violations).

     

       333
       +
           

     

       334
       +
           Returns only the issues marked as warnings. These don't make the document

     

       335
       +
           invalid but may indicate potential problems or areas for improvement.

     

       336
       +
           

     

       337
       +
           @param gpx The GPX document to validate  

     

       338
       +
           @return List of warning-level validation issues *)

     

       339
       +
       val warnings : t -> validation_issue list

     

       340
        
       

     

       341
       +
       (** Format a validation issue for human-readable display.

     

       342
       +
           

     

       343
       +
           Combines the issue message with location context if available.

     

       344
       +
           

     

       345
       +
           @param issue The validation issue to format

     

       346
       +
           @return Formatted string suitable for display to users

     

       347
       +
           

     

       348
       +
           Example output: ["Error in waypoint 1: Latitude out of range (-95.0)"] *)

     

       349
        
       val format_issue : validation_issue -> string

     

       350
        
       

     

       351
       +
       (** {1 Document Constructors and Utilities}

     

       352
       +
           

     

       353
       +
           Functions for creating GPX documents and basic document operations. *)

     

       354
        
       

     

       355
       +
       (** Create a new GPX document with the required creator field.

     

       356
       +
           

     

       357
       +
           Every GPX document must identify its creating application through the

     

       358
       +
           [creator] attribute. This is required by the GPX specification and helps

     

       359
       +
           identify the source of GPS data.

     

       360
       +
           

     

       361
       +
           The created document:

     

       362
       +
           - Uses GPX version 1.1 (the current standard)

     

       363
       +
           - Contains no waypoints, routes, or tracks initially

     

       364
       +
           - Has no metadata initially

     

       365
       +
           - Can be extended using {!Doc} module functions

     

       366
       +
           

     

       367
       +
           @param creator Name of the creating application (e.g., "MyGPS App v1.0")

     

       368
       +
           @return Empty GPX document ready for data addition

     

       369
       +
           

     

       370
       +
           Example:

     

       371
       +
           {[

     

       372
       +
             let gpx = make_gpx ~creator:"MyTracker v2.1" in

     

       373
       +
             let gpx = Doc.add_waypoint gpx some_waypoint in

     

       374
       +
             let gpx = Doc.add_track gpx some_track in

     

       375
       +
             (* gpx now contains waypoints and tracks *)

     

       376
       +
           ]} *)

     

       377
       +
       val make_gpx : creator:string -> t

     

       378
        
       

     

       379
       +
       (** Create an empty GPX document with the required creator field.

     

       380
       +
           

     

       381
       +
           Alias for {!make_gpx} provided for consistency with module naming patterns.

     

       382
       +
           Creates a document with no GPS data that can be populated using the

     

       383
       +
           {!Doc} module functions.

     

       384
       +
           

     

       385
       +
           @param creator Name of the creating application

     

       386
       +
           @return Empty GPX document

     

       387
       +
           

     

       388
       +
           Example:

     

       389
       +
           {[

     

       390
       +
             let gpx = empty ~creator:"GPS Logger" in

     

       391
       +
             assert (List.length (Doc.waypoints gpx) = 0);

     

       392
       +
             assert (List.length (Doc.tracks gpx) = 0);

     

       393
       +
             assert (Doc.creator gpx = "GPS Logger");

     

       394
       +
           ]} *)

     

       395
       +
       val empty : creator:string -> t

     

       396
        
       

     

       397
       +
       (** {1 Common Patterns and Best Practices}

     

       398
       +
           

     

       399
       +
           {2 Reading GPX Files}

     

       400
       +
           

     

       401
       +
           The most common use case is reading existing GPX files:

     

       402
       +
           {[

     

       403
       +
             (* From a file using platform-specific modules *)

     

       404
       +
             match Gpx_unix.read "track.gpx" with

     

       405
       +
             | Ok gpx -> process_gpx gpx

     

       406
       +
             | Error e -> handle_error e

     

       407
       +
             

     

       408
       +
             (* From a string *)

     

       409
       +
             match parse_string ~validate:true gpx_content with

     

       410
       +
             | Ok gpx -> process_gpx gpx

     

       411
       +
             | Error e -> handle_error e

     

       412
       +
           ]}

     

       413
       +
           

     

       414
       +
           {2 Creating GPX Files}

     

       415
       +
           

     

       416
       +
           To create new GPX files with waypoints:

     

       417
       +
           {[

     

       418
       +
             (* Create coordinates *)

     

       419
       +
             let lat = Coordinate.latitude 37.7749 |> Result.get_ok in

     

       420
       +
             let lon = Coordinate.longitude (-122.4194) |> Result.get_ok in

     

       421
       +
             

     

       422
       +
             (* Create waypoint *)

     

       423
       +
             let waypoint = Waypoint.make lat lon

     

       424
       +
               |> Waypoint.with_name "Golden Gate"

     

       425
       +
               |> Waypoint.with_description "Famous San Francisco bridge" in

     

       426
       +
             

     

       427
       +
             (* Create document *)

     

       428
       +
             let gpx = make_gpx ~creator:"My App v1.0"

     

       429
       +
               |> Doc.add_waypoint waypoint in

     

       430
       +
             

     

       431
       +
             (* Write to file *)

     

       432
       +
             match Gpx_unix.write "output.gpx" gpx with

     

       433
       +
             | Ok () -> print_endline "File written successfully"

     

       434
       +
             | Error e -> Printf.eprintf "Write error: %s\n" (Error.to_string e)

     

       435
       +
           ]}

     

       436
       +
           

     

       437
       +
           {2 Working with Tracks}

     

       438
       +
           

     

       439
       +
           Tracks represent recorded GPS traces with timestamped points:

     

       440
       +
           {[

     

       441
       +
             (* Create track points with timestamps *)

     

       442
       +
             let points = List.map (fun (lat_f, lon_f, time) ->

     

       443
       +
               let lat = Coordinate.latitude lat_f |> Result.get_ok in

     

       444
       +
               let lon = Coordinate.longitude lon_f |> Result.get_ok in

     

       445
       +
               Waypoint.make lat lon |> Waypoint.with_time (Some time)

     

       446
       +
             ) gps_data in

     

       447
       +
             

     

       448
       +
             (* Create track segment *)

     

       449
       +
             let segment = Track.Segment.make points in

     

       450
       +
             

     

       451
       +
             (* Create track *)

     

       452
       +
             let track = Track.make ~name:"Morning Run"

     

       453
       +
               |> Track.add_segment segment in

     

       454
       +
             

     

       455
       +
             (* Add to document *)

     

       456
       +
             let gpx = make_gpx ~creator:"Fitness App"

     

       457
       +
               |> Doc.add_track track

     

       458
       +
           ]}

     

       459
       +
           

     

       460
       +
           {2 Coordinate Systems and Units}

     

       461
       +
           

     

       462
       +
           - All coordinates use WGS84 datum (World Geodetic System 1984)

     

       463
       +
           - Latitude ranges from -90.0 (South Pole) to +90.0 (North Pole)  

     

       464
       +
           - Longitude ranges from -180.0 to +180.0 degrees

     

       465
       +
           - Elevations are in meters above mean sea level

     

       466
       +
           - Times use RFC 3339 format (ISO 8601 subset)

     

       467
       +
           

     

       468
       +
           {2 Validation Recommendations}

     

       469
       +
           

     

       470
       +
           - Always validate when parsing untrusted GPX data

     

       471
       +
           - Validate before writing to catch data consistency issues

     

       472
       +
           - Handle both errors and warnings appropriately

     

       473
       +
           - Use {!val:is_valid} for quick checks, {!validate_gpx} for detailed analysis

     

       474
       +
           

     

       475
       +
           {2 Performance Considerations}

     

       476
       +
           

     

       477
       +
           - The library uses streaming XML parsing for memory efficiency

     

       478
       +
           - Large GPX files with many track points are handled efficiently

     

       479
       +
           - Coordinate validation occurs at construction time

     

       480
       +
           - Consider using platform-specific modules ({!Gpx_unix}, [Gpx_eio]) for file I/O

     

       481
       +
           

     

       482
       +
           {2 Extension Support}

     

       483
       +
           

     

       484
       +
           The library supports GPX extensions for custom data:

     

       485
       +
           {[

     

       486
       +
             (* Create extension *)

     

       487
       +
             let ext = Extension.make_text

     

       488
       +
               ~name:"temperature" 

     

       489
       +
               ~namespace:"http://example.com/weather"

     

       490
       +
               "25.5" in

     

       491
       +
             

     

       492
       +
             (* Add to waypoint *)

     

       493
       +
             let waypoint = Waypoint.make lat lon

     

       494
       +
               |> Waypoint.add_extensions [ext]

     

       495
       +
           ]} *)

     

       496
        
       

     

       497
       +
       (** {1 Related Modules and Libraries}

     

       498
       +
           

     

       499
       +
           This core module provides the foundation. For complete applications, consider:

     

       500
       +
           

     

       501
       +
           - {!Gpx_unix}: File I/O operations using standard Unix libraries

     

       502
       +
           - {!Gpx_eio}: Concurrent file I/O using the Eio effects library  

     

       503
       +
           - {{:https://erratique.ch/software/xmlm}Xmlm}: Underlying XML processing library

     

       504
       +
           - {{:https://erratique.ch/software/ptime}Ptime}: Time representation used for timestamps

     

       505
       +
           

     

       506
       +
           {2 External Links}

     

       507
       +
           

     

       508
       +
           - {{:https://www.topografix.com/gpx.asp}Official GPX specification}

     

       509
       +
           - {{:https://www.topografix.com/GPX/1/1/gpx.xsd}GPX 1.1 XML Schema}

     

       510
       +
           - {{:https://en.wikipedia.org/wiki/GPS_Exchange_Format}GPX Format on Wikipedia}

     

       511
       +
           - {{:https://en.wikipedia.org/wiki/World_Geodetic_System}WGS84 Coordinate System} *)

+126

lib/gpx/link.ml

···

       1
       +
       (** Link and person information types *)

     

       2
       +
       

     

       3
       +
       (** Main link type *)

     

       4
       +
       type t = {

     

       5
       +
         href : string;

     

       6
       +
         text : string option;

     

       7
       +
         type_ : string option;

     

       8
       +
       }

     

       9
       +
       

     

       10
       +
       (** Person information *)

     

       11
       +
       and person = {

     

       12
       +
         name : string option;

     

       13
       +
         email : string option;

     

       14
       +
         link : t option;

     

       15
       +
       }

     

       16
       +
       

     

       17
       +
       (** Copyright information *)

     

       18
       +
       and copyright = {

     

       19
       +
         author : string;

     

       20
       +
         year : int option;

     

       21
       +
         license : string option;

     

       22
       +
       }

     

       23
       +
       

     

       24
       +
       (** {2 Link Operations} *)

     

       25
       +
       

     

       26
       +
       (** Create a link *)

     

       27
       +
       let make ~href ?text ?type_ () = { href; text; type_ }

     

       28
       +
       

     

       29
       +
       (** Get href from link *)

     

       30
       +
       let href t = t.href

     

       31
       +
       

     

       32
       +
       (** Get optional text from link *)

     

       33
       +
       let text t = t.text

     

       34
       +
       

     

       35
       +
       (** Get optional type from link *)

     

       36
       +
       let type_ t = t.type_

     

       37
       +
       

     

       38
       +
       (** Update text *)

     

       39
       +
       let with_text t text = { t with text = Some text }

     

       40
       +
       

     

       41
       +
       (** Update type *)

     

       42
       +
       let with_type t type_ = { t with type_ = Some type_ }

     

       43
       +
       

     

       44
       +
       (** Compare links *)

     

       45
       +
       let compare t1 t2 =

     

       46
       +
         let href_cmp = String.compare t1.href t2.href in

     

       47
       +
         if href_cmp <> 0 then href_cmp

     

       48
       +
         else

     

       49
       +
           let text_cmp = Option.compare String.compare t1.text t2.text in

     

       50
       +
           if text_cmp <> 0 then text_cmp

     

       51
       +
           else Option.compare String.compare t1.type_ t2.type_

     

       52
       +
       

     

       53
       +
       (** Test link equality *)

     

       54
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       55
       +
       

     

       56
       +
       (** Pretty print link *)

     

       57
       +
       let pp ppf t =

     

       58
       +
         match t.text with

     

       59
       +
         | Some text -> Format.fprintf ppf "%s (%s)" text t.href

     

       60
       +
         | None -> Format.fprintf ppf "%s" t.href

     

       61
       +
       

     

       62
       +
       (** {2 Person Operations} *)

     

       63
       +
       

     

       64
       +
       (** Create person *)

     

       65
       +
       let make_person ?name ?email ?link () = { name; email; link }

     

       66
       +
       

     

       67
       +
       (** Get person name *)

     

       68
       +
       let person_name (p : person) = p.name

     

       69
       +
       

     

       70
       +
       (** Get person email *)

     

       71
       +
       let person_email (p : person) = p.email

     

       72
       +
       

     

       73
       +
       (** Get person link *)

     

       74
       +
       let person_link (p : person) = p.link

     

       75
       +
       

     

       76
       +
       (** Compare persons *)

     

       77
       +
       let compare_person p1 p2 =

     

       78
       +
         let name_cmp = Option.compare String.compare p1.name p2.name in

     

       79
       +
         if name_cmp <> 0 then name_cmp

     

       80
       +
         else

     

       81
       +
           let email_cmp = Option.compare String.compare p1.email p2.email in

     

       82
       +
           if email_cmp <> 0 then email_cmp

     

       83
       +
           else Option.compare compare p1.link p2.link

     

       84
       +
       

     

       85
       +
       (** Test person equality *)

     

       86
       +
       let equal_person p1 p2 = compare_person p1 p2 = 0

     

       87
       +
       

     

       88
       +
       (** Pretty print person *)

     

       89
       +
       let pp_person ppf p =

     

       90
       +
         match p.name, p.email with

     

       91
       +
         | Some name, Some email -> Format.fprintf ppf "%s <%s>" name email

     

       92
       +
         | Some name, None -> Format.fprintf ppf "%s" name

     

       93
       +
         | None, Some email -> Format.fprintf ppf "<%s>" email

     

       94
       +
         | None, None -> Format.fprintf ppf "(anonymous)"

     

       95
       +
       

     

       96
       +
       (** {2 Copyright Operations} *)

     

       97
       +
       

     

       98
       +
       (** Create copyright *)

     

       99
       +
       let make_copyright ~author ?year ?license () = { author; year; license }

     

       100
       +
       

     

       101
       +
       (** Get copyright author *)

     

       102
       +
       let copyright_author (c : copyright) = c.author

     

       103
       +
       

     

       104
       +
       (** Get copyright year *)

     

       105
       +
       let copyright_year (c : copyright) = c.year

     

       106
       +
       

     

       107
       +
       (** Get copyright license *)

     

       108
       +
       let copyright_license (c : copyright) = c.license

     

       109
       +
       

     

       110
       +
       (** Compare copyrights *)

     

       111
       +
       let compare_copyright c1 c2 =

     

       112
       +
         let author_cmp = String.compare c1.author c2.author in

     

       113
       +
         if author_cmp <> 0 then author_cmp

     

       114
       +
         else

     

       115
       +
           let year_cmp = Option.compare Int.compare c1.year c2.year in

     

       116
       +
           if year_cmp <> 0 then year_cmp

     

       117
       +
           else Option.compare String.compare c1.license c2.license

     

       118
       +
       

     

       119
       +
       (** Test copyright equality *)

     

       120
       +
       let equal_copyright c1 c2 = compare_copyright c1 c2 = 0

     

       121
       +
       

     

       122
       +
       (** Pretty print copyright *)

     

       123
       +
       let pp_copyright ppf c =

     

       124
       +
         match c.year with

     

       125
       +
         | Some year -> Format.fprintf ppf "© %d %s" year c.author

     

       126
       +
         | None -> Format.fprintf ppf "© %s" c.author

+101

lib/gpx/link.mli

···

       1
       +
       (** Link and person information types *)

     

       2
       +
       

     

       3
       +
       (** Main link type *)

     

       4
       +
       type t = {

     

       5
       +
         href : string;

     

       6
       +
         text : string option;

     

       7
       +
         type_ : string option;

     

       8
       +
       }

     

       9
       +
       

     

       10
       +
       (** Person information *)

     

       11
       +
       and person = {

     

       12
       +
         name : string option;

     

       13
       +
         email : string option;

     

       14
       +
         link : t option;

     

       15
       +
       }

     

       16
       +
       

     

       17
       +
       (** Copyright information *)

     

       18
       +
       and copyright = {

     

       19
       +
         author : string;

     

       20
       +
         year : int option;

     

       21
       +
         license : string option;

     

       22
       +
       }

     

       23
       +
       

     

       24
       +
       (** {2 Link Operations} *)

     

       25
       +
       

     

       26
       +
       (** Create a link.

     

       27
       +
           @param href URL reference (required)

     

       28
       +
           @param ?text Optional link text

     

       29
       +
           @param ?type_ Optional MIME type *)

     

       30
       +
       val make : href:string -> ?text:string -> ?type_:string -> unit -> t

     

       31
       +
       

     

       32
       +
       (** Get href from link *)

     

       33
       +
       val href : t -> string

     

       34
       +
       

     

       35
       +
       (** Get optional text from link *)

     

       36
       +
       val text : t -> string option

     

       37
       +
       

     

       38
       +
       (** Get optional type from link *)

     

       39
       +
       val type_ : t -> string option

     

       40
       +
       

     

       41
       +
       (** Update text *)

     

       42
       +
       val with_text : t -> string -> t

     

       43
       +
       

     

       44
       +
       (** Update type *)

     

       45
       +
       val with_type : t -> string -> t

     

       46
       +
       

     

       47
       +
       

     

       48
       +
       (** Compare links *)

     

       49
       +
       val compare : t -> t -> int

     

       50
       +
       

     

       51
       +
       (** Test link equality *)

     

       52
       +
       val equal : t -> t -> bool

     

       53
       +
       

     

       54
       +
       (** Pretty print link *)

     

       55
       +
       val pp : Format.formatter -> t -> unit

     

       56
       +
       

     

       57
       +
       (** {2 Person Operations} *)

     

       58
       +
       

     

       59
       +
       (** Create person information *)

     

       60
       +
       val make_person : ?name:string -> ?email:string -> ?link:t -> unit -> person

     

       61
       +
       

     

       62
       +
       (** Get person name *)

     

       63
       +
       val person_name : person -> string option

     

       64
       +
       

     

       65
       +
       (** Get person email *)

     

       66
       +
       val person_email : person -> string option

     

       67
       +
       

     

       68
       +
       (** Get person link *)

     

       69
       +
       val person_link : person -> t option

     

       70
       +
       

     

       71
       +
       (** Compare persons *)

     

       72
       +
       val compare_person : person -> person -> int

     

       73
       +
       

     

       74
       +
       (** Test person equality *)

     

       75
       +
       val equal_person : person -> person -> bool

     

       76
       +
       

     

       77
       +
       (** Pretty print person *)

     

       78
       +
       val pp_person : Format.formatter -> person -> unit

     

       79
       +
       

     

       80
       +
       (** {2 Copyright Operations} *)

     

       81
       +
       

     

       82
       +
       (** Create copyright information *)

     

       83
       +
       val make_copyright : author:string -> ?year:int -> ?license:string -> unit -> copyright

     

       84
       +
       

     

       85
       +
       (** Get copyright author *)

     

       86
       +
       val copyright_author : copyright -> string

     

       87
       +
       

     

       88
       +
       (** Get copyright year *)

     

       89
       +
       val copyright_year : copyright -> int option

     

       90
       +
       

     

       91
       +
       (** Get copyright license *)

     

       92
       +
       val copyright_license : copyright -> string option

     

       93
       +
       

     

       94
       +
       (** Compare copyrights *)

     

       95
       +
       val compare_copyright : copyright -> copyright -> int

     

       96
       +
       

     

       97
       +
       (** Test copyright equality *)

     

       98
       +
       val equal_copyright : copyright -> copyright -> bool

     

       99
       +
       

     

       100
       +
       (** Pretty print copyright *)

     

       101
       +
       val pp_copyright : Format.formatter -> copyright -> unit

+183

lib/gpx/metadata.ml

···

       1
       +
       (** GPX metadata and bounds types *)

     

       2
       +
       

     

       3
       +
       (** Bounding box *)

     

       4
       +
       type bounds = {

     

       5
       +
         minlat : Coordinate.latitude;

     

       6
       +
         minlon : Coordinate.longitude;

     

       7
       +
         maxlat : Coordinate.latitude;

     

       8
       +
         maxlon : Coordinate.longitude;

     

       9
       +
       }

     

       10
       +
       

     

       11
       +
       (** Main metadata type *)

     

       12
       +
       type t = {

     

       13
       +
         name : string option;

     

       14
       +
         desc : string option;

     

       15
       +
         author : Link.person option;

     

       16
       +
         copyright : Link.copyright option;

     

       17
       +
         links : Link.t list;

     

       18
       +
         time : Ptime.t option;

     

       19
       +
         keywords : string option;

     

       20
       +
         bounds : bounds option;

     

       21
       +
         extensions : Extension.t list;

     

       22
       +
       }

     

       23
       +
       

     

       24
       +
       (** {2 Bounds Operations} *)

     

       25
       +
       

     

       26
       +
       module Bounds = struct

     

       27
       +
         type t = bounds

     

       28
       +
       

     

       29
       +
         (** Create bounds from coordinates *)

     

       30
       +
         let make ~minlat ~minlon ~maxlat ~maxlon = { minlat; minlon; maxlat; maxlon }

     

       31
       +
       

     

       32
       +
         (** Create bounds from float coordinates with validation *)

     

       33
       +
         let make_from_floats ~minlat ~minlon ~maxlat ~maxlon =

     

       34
       +
           match 

     

       35
       +
             Coordinate.latitude minlat,

     

       36
       +
             Coordinate.longitude minlon, 

     

       37
       +
             Coordinate.latitude maxlat,

     

       38
       +
             Coordinate.longitude maxlon

     

       39
       +
           with

     

       40
       +
           | Ok minlat, Ok minlon, Ok maxlat, Ok maxlon ->

     

       41
       +
             if Coordinate.latitude_to_float minlat <= Coordinate.latitude_to_float maxlat &&

     

       42
       +
                Coordinate.longitude_to_float minlon <= Coordinate.longitude_to_float maxlon

     

       43
       +
             then Ok { minlat; minlon; maxlat; maxlon }

     

       44
       +
             else Error "Invalid bounds: min values must be <= max values"

     

       45
       +
           | Error e, _, _, _ | _, Error e, _, _ | _, _, Error e, _ | _, _, _, Error e -> Error e

     

       46
       +
       

     

       47
       +
         (** Get corner coordinates *)

     

       48
       +
         let min_coords t = Coordinate.make t.minlat t.minlon

     

       49
       +
         let max_coords t = Coordinate.make t.maxlat t.maxlon

     

       50
       +
       

     

       51
       +
         (** Get all bounds as tuple *)

     

       52
       +
         let bounds t = (t.minlat, t.minlon, t.maxlat, t.maxlon)

     

       53
       +
       

     

       54
       +
         (** Check if coordinate is within bounds *)

     

       55
       +
         let contains bounds coord =

     

       56
       +
           let lat = Coordinate.lat coord in

     

       57
       +
           let lon = Coordinate.lon coord in

     

       58
       +
           Coordinate.latitude_to_float bounds.minlat <= Coordinate.latitude_to_float lat &&

     

       59
       +
           Coordinate.latitude_to_float lat <= Coordinate.latitude_to_float bounds.maxlat &&

     

       60
       +
           Coordinate.longitude_to_float bounds.minlon <= Coordinate.longitude_to_float lon &&

     

       61
       +
           Coordinate.longitude_to_float lon <= Coordinate.longitude_to_float bounds.maxlon

     

       62
       +
       

     

       63
       +
         (** Calculate bounds area *)

     

       64
       +
         let area t =

     

       65
       +
           let lat_diff = Coordinate.latitude_to_float t.maxlat -. Coordinate.latitude_to_float t.minlat in

     

       66
       +
           let lon_diff = Coordinate.longitude_to_float t.maxlon -. Coordinate.longitude_to_float t.minlon in

     

       67
       +
           lat_diff *. lon_diff

     

       68
       +
       

     

       69
       +
         (** Compare bounds *)

     

       70
       +
         let compare t1 t2 =

     

       71
       +
           let minlat_cmp = Float.compare 

     

       72
       +
             (Coordinate.latitude_to_float t1.minlat) 

     

       73
       +
             (Coordinate.latitude_to_float t2.minlat) in

     

       74
       +
           if minlat_cmp <> 0 then minlat_cmp

     

       75
       +
           else

     

       76
       +
             let minlon_cmp = Float.compare 

     

       77
       +
               (Coordinate.longitude_to_float t1.minlon) 

     

       78
       +
               (Coordinate.longitude_to_float t2.minlon) in

     

       79
       +
             if minlon_cmp <> 0 then minlon_cmp

     

       80
       +
             else

     

       81
       +
               let maxlat_cmp = Float.compare 

     

       82
       +
                 (Coordinate.latitude_to_float t1.maxlat) 

     

       83
       +
                 (Coordinate.latitude_to_float t2.maxlat) in

     

       84
       +
               if maxlat_cmp <> 0 then maxlat_cmp

     

       85
       +
               else Float.compare 

     

       86
       +
                 (Coordinate.longitude_to_float t1.maxlon) 

     

       87
       +
                 (Coordinate.longitude_to_float t2.maxlon)

     

       88
       +
       

     

       89
       +
         (** Test bounds equality *)

     

       90
       +
         let equal t1 t2 = compare t1 t2 = 0

     

       91
       +
       

     

       92
       +
         (** Pretty print bounds *)

     

       93
       +
         let pp ppf t =

     

       94
       +
           Format.fprintf ppf "[(%g,%g) - (%g,%g)]"

     

       95
       +
             (Coordinate.latitude_to_float t.minlat)

     

       96
       +
             (Coordinate.longitude_to_float t.minlon)

     

       97
       +
             (Coordinate.latitude_to_float t.maxlat)

     

       98
       +
             (Coordinate.longitude_to_float t.maxlon)

     

       99
       +
       end

     

       100
       +
       

     

       101
       +
       (** {2 Metadata Operations} *)

     

       102
       +
       

     

       103
       +
       (** Create empty metadata *)

     

       104
       +
       let empty = {

     

       105
       +
         name = None; desc = None; author = None; copyright = None;

     

       106
       +
         links = []; time = None; keywords = None; bounds = None;

     

       107
       +
         extensions = [];

     

       108
       +
       }

     

       109
       +
       

     

       110
       +
       (** Create metadata with name *)

     

       111
       +
       let make ~name = { empty with name = Some name }

     

       112
       +
       

     

       113
       +
       (** Get name *)

     

       114
       +
       let name t = t.name

     

       115
       +
       

     

       116
       +
       (** Get description *)  

     

       117
       +
       let description t = t.desc

     

       118
       +
       

     

       119
       +
       (** Get author *)

     

       120
       +
       let author t = t.author

     

       121
       +
       

     

       122
       +
       (** Get copyright *)

     

       123
       +
       let copyright t = t.copyright

     

       124
       +
       

     

       125
       +
       (** Get links *)

     

       126
       +
       let links t = t.links

     

       127
       +
       

     

       128
       +
       (** Get time *)

     

       129
       +
       let time t = t.time

     

       130
       +
       

     

       131
       +
       (** Get keywords *)

     

       132
       +
       let keywords t = t.keywords

     

       133
       +
       

     

       134
       +
       (** Get bounds *)

     

       135
       +
       let bounds_opt t = t.bounds

     

       136
       +
       

     

       137
       +
       (** Get extensions *)

     

       138
       +
       let extensions t = t.extensions

     

       139
       +
       

     

       140
       +
       (** Update name *)

     

       141
       +
       let with_name t name = { t with name = Some name }

     

       142
       +
       

     

       143
       +
       (** Update description *)

     

       144
       +
       let with_description t desc = { t with desc = Some desc }

     

       145
       +
       

     

       146
       +
       (** Update keywords *)

     

       147
       +
       let with_keywords t keywords = { t with keywords = Some keywords }

     

       148
       +
       

     

       149
       +
       (** Update time *)

     

       150
       +
       let with_time t time = { t with time }

     

       151
       +
       

     

       152
       +
       (** Update bounds *)

     

       153
       +
       let with_bounds t bounds = { t with bounds = Some bounds }

     

       154
       +
       

     

       155
       +
       (** Update author *)

     

       156
       +
       let with_author t author = { t with author = Some author }

     

       157
       +
       

     

       158
       +
       (** Update copyright *)

     

       159
       +
       let with_copyright t copyright = { t with copyright = Some copyright }

     

       160
       +
       

     

       161
       +
       (** Add link *)

     

       162
       +
       let add_link t link = { t with links = link :: t.links }

     

       163
       +
       

     

       164
       +
       (** Add extensions *)

     

       165
       +
       let add_extensions t extensions = { t with extensions = extensions @ t.extensions }

     

       166
       +
       

     

       167
       +
       (** Compare metadata *)

     

       168
       +
       let compare t1 t2 =

     

       169
       +
         let name_cmp = Option.compare String.compare t1.name t2.name in

     

       170
       +
         if name_cmp <> 0 then name_cmp

     

       171
       +
         else

     

       172
       +
           let desc_cmp = Option.compare String.compare t1.desc t2.desc in

     

       173
       +
           if desc_cmp <> 0 then desc_cmp

     

       174
       +
           else Option.compare Ptime.compare t1.time t2.time

     

       175
       +
       

     

       176
       +
       (** Test metadata equality *)

     

       177
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       178
       +
       

     

       179
       +
       (** Pretty print metadata *)

     

       180
       +
       let pp ppf t =

     

       181
       +
         match t.name with

     

       182
       +
         | Some name -> Format.fprintf ppf "\"%s\"" name

     

       183
       +
         | None -> Format.fprintf ppf "(unnamed)"

+132

lib/gpx/metadata.mli

···

       1
       +
       (** GPX metadata and bounds types *)

     

       2
       +
       

     

       3
       +
       (** Bounding box *)

     

       4
       +
       type bounds = {

     

       5
       +
         minlat : Coordinate.latitude;

     

       6
       +
         minlon : Coordinate.longitude;

     

       7
       +
         maxlat : Coordinate.latitude;

     

       8
       +
         maxlon : Coordinate.longitude;

     

       9
       +
       }

     

       10
       +
       

     

       11
       +
       (** Main metadata type *)

     

       12
       +
       type t = {

     

       13
       +
         name : string option;

     

       14
       +
         desc : string option;

     

       15
       +
         author : Link.person option;

     

       16
       +
         copyright : Link.copyright option;

     

       17
       +
         links : Link.t list;

     

       18
       +
         time : Ptime.t option;

     

       19
       +
         keywords : string option;

     

       20
       +
         bounds : bounds option;

     

       21
       +
         extensions : Extension.t list;

     

       22
       +
       }

     

       23
       +
       

     

       24
       +
       (** {2 Bounds Operations} *)

     

       25
       +
       

     

       26
       +
       module Bounds : sig

     

       27
       +
         type t = bounds

     

       28
       +
       

     

       29
       +
         (** Create bounds from validated coordinates *)

     

       30
       +
         val make : minlat:Coordinate.latitude -> minlon:Coordinate.longitude -> 

     

       31
       +
                    maxlat:Coordinate.latitude -> maxlon:Coordinate.longitude -> t

     

       32
       +
       

     

       33
       +
         (** Create bounds from float coordinates with validation *)

     

       34
       +
         val make_from_floats : minlat:float -> minlon:float -> maxlat:float -> maxlon:float -> (t, string) result

     

       35
       +
       

     

       36
       +
         (** Get minimum corner coordinates *)

     

       37
       +
         val min_coords : t -> Coordinate.t

     

       38
       +
       

     

       39
       +
         (** Get maximum corner coordinates *)

     

       40
       +
         val max_coords : t -> Coordinate.t

     

       41
       +
       

     

       42
       +
         (** Get all bounds as tuple *)

     

       43
       +
         val bounds : t -> (Coordinate.latitude * Coordinate.longitude * Coordinate.latitude * Coordinate.longitude)

     

       44
       +
       

     

       45
       +
         (** Check if coordinate is within bounds *)

     

       46
       +
         val contains : t -> Coordinate.t -> bool

     

       47
       +
       

     

       48
       +
         (** Calculate bounds area in square degrees *)

     

       49
       +
         val area : t -> float

     

       50
       +
       

     

       51
       +
         (** Compare bounds *)

     

       52
       +
         val compare : t -> t -> int

     

       53
       +
       

     

       54
       +
         (** Test bounds equality *)

     

       55
       +
         val equal : t -> t -> bool

     

       56
       +
       

     

       57
       +
         (** Pretty print bounds *)

     

       58
       +
         val pp : Format.formatter -> t -> unit

     

       59
       +
       end

     

       60
       +
       

     

       61
       +
       (** {2 Metadata Operations} *)

     

       62
       +
       

     

       63
       +
       (** Create empty metadata *)

     

       64
       +
       val empty : t

     

       65
       +
       

     

       66
       +
       (** Create metadata with name *)

     

       67
       +
       val make : name:string -> t

     

       68
       +
       

     

       69
       +
       (** Get name *)

     

       70
       +
       val name : t -> string option

     

       71
       +
       

     

       72
       +
       (** Get description *)  

     

       73
       +
       val description : t -> string option

     

       74
       +
       

     

       75
       +
       (** Get author *)

     

       76
       +
       val author : t -> Link.person option

     

       77
       +
       

     

       78
       +
       (** Get copyright *)

     

       79
       +
       val copyright : t -> Link.copyright option

     

       80
       +
       

     

       81
       +
       (** Get links *)

     

       82
       +
       val links : t -> Link.t list

     

       83
       +
       

     

       84
       +
       (** Get time *)

     

       85
       +
       val time : t -> Ptime.t option

     

       86
       +
       

     

       87
       +
       (** Get keywords *)

     

       88
       +
       val keywords : t -> string option

     

       89
       +
       

     

       90
       +
       (** Get bounds *)

     

       91
       +
       val bounds_opt : t -> bounds option

     

       92
       +
       

     

       93
       +
       (** Get extensions *)

     

       94
       +
       val extensions : t -> Extension.t list

     

       95
       +
       

     

       96
       +
       (** Functional operations for building metadata *)

     

       97
       +
       

     

       98
       +
       (** Update name *)

     

       99
       +
       val with_name : t -> string -> t

     

       100
       +
       

     

       101
       +
       (** Update description *)

     

       102
       +
       val with_description : t -> string -> t

     

       103
       +
       

     

       104
       +
       (** Update keywords *)

     

       105
       +
       val with_keywords : t -> string -> t

     

       106
       +
       

     

       107
       +
       (** Update time *)

     

       108
       +
       val with_time : t -> Ptime.t option -> t

     

       109
       +
       

     

       110
       +
       (** Update bounds *)

     

       111
       +
       val with_bounds : t -> bounds -> t

     

       112
       +
       

     

       113
       +
       (** Update author *)

     

       114
       +
       val with_author : t -> Link.person -> t

     

       115
       +
       

     

       116
       +
       (** Update copyright *)

     

       117
       +
       val with_copyright : t -> Link.copyright -> t

     

       118
       +
       

     

       119
       +
       (** Add link *)

     

       120
       +
       val add_link : t -> Link.t -> t

     

       121
       +
       

     

       122
       +
       (** Add extensions *)

     

       123
       +
       val add_extensions : t -> Extension.t list -> t

     

       124
       +
       

     

       125
       +
       (** Compare metadata *)

     

       126
       +
       val compare : t -> t -> int

     

       127
       +
       

     

       128
       +
       (** Test metadata equality *)

     

       129
       +
       val equal : t -> t -> bool

     

       130
       +
       

     

       131
       +
       (** Pretty print metadata *)

     

       132
       +
       val pp : Format.formatter -> t -> unit

+226 -106

lib/gpx/parser.ml

···

       1
        
       (** GPX streaming parser using xmlm *)

     

       2
        
       

     

       3
       -
       open Types

     

       4
       -
       

     

       5
        
       (** Parser state for streaming *)

     

       6
        
       type parser_state = {

     

       7
        
         input : Xmlm.input;

     
···

       27
        
       let require_attribute name attrs element =

     

       28
        
         match get_attribute name attrs with

     

       29
        
         | Some value -> Ok value

     

       30
       -
         | None -> Error (Missing_required_attribute (element, name))

     

       31
        
       

     

       32
        
       let parse_float_opt s =

     

       33
        
         try Some (Float.of_string s)

     
···

       50
        
         let* lon_str = require_attribute "lon" attrs element in

     

       51
        
         match (Float.of_string lat_str, Float.of_string lon_str) with

     

       52
        
         | (lat_f, lon_f) ->

     

       53
       -
           let* lat = Result.map_error (fun s -> Invalid_coordinate s) (latitude lat_f) in

     

       54
       -
           let* lon = Result.map_error (fun s -> Invalid_coordinate s) (longitude lon_f) in

     

       55
        
           Ok (lat, lon)

     

       56
       -
         | exception _ -> Error (Invalid_coordinate "Invalid coordinate format")

     

       57
        
       

     

       58
        
       (** Parse waypoint data from XML elements *)

     

       59
        
       let rec parse_waypoint_data parser lat lon =

     

       60
       -
         let wpt = make_waypoint_data lat lon in

     

       61
        
         parse_waypoint_elements parser wpt

     

       62
        
       

     

       63
        
       and parse_waypoint_elements parser wpt =

     
···

       69
        
              | "ele" -> 

     

       70
        
                let* text = parse_text_content parser in

     

       71
        
                (match parse_float_opt text with

     

       72
       -
                 | Some ele -> loop { wpt with ele = Some ele }

     

       73
        
                 | None -> loop wpt)

     

       74
        
              | "time" ->

     

       75
        
                let* text = parse_text_content parser in

     

       76
       -
                loop { wpt with time = parse_time text }

     

       77
        
              | "magvar" ->

     

       78
        
                let* text = parse_text_content parser in

     

       79
        
                (match parse_float_opt text with

     

       80
        
                 | Some f -> 

     

       81
       -
                   (match degrees f with

     

       82
       -
                    | Ok deg -> loop { wpt with magvar = Some deg }

     

       83
        
                    | Error _ -> loop wpt)

     

       84
        
                 | None -> loop wpt)

     

       85
        
              | "geoidheight" ->

     

       86
        
                let* text = parse_text_content parser in

     

       87
        
                (match parse_float_opt text with

     

       88
       -
                 | Some h -> loop { wpt with geoidheight = Some h }

     

       89
        
                 | None -> loop wpt)

     

       90
        
              | "name" ->

     

       91
        
                let* text = parse_text_content parser in

     

       92
       -
                loop { wpt with name = Some text }

     

       93
        
              | "cmt" ->

     

       94
        
                let* text = parse_text_content parser in

     

       95
       -
                loop { wpt with cmt = Some text }

     

       96
        
              | "desc" ->

     

       97
        
                let* text = parse_text_content parser in

     

       98
       -
                loop { wpt with desc = Some text }

     

       99
        
              | "src" ->

     

       100
        
                let* text = parse_text_content parser in

     

       101
       -
                loop { wpt with src = Some text }

     

       102
        
              | "sym" ->

     

       103
        
                let* text = parse_text_content parser in

     

       104
       -
                loop { wpt with sym = Some text }

     

       105
        
              | "type" ->

     

       106
        
                let* text = parse_text_content parser in

     

       107
       -
                loop { wpt with type_ = Some text }

     

       108
        
              | "fix" ->

     

       109
        
                let* text = parse_text_content parser in

     

       110
       -
                loop { wpt with fix = fix_type_of_string text }

     

       111
        
              | "sat" ->

     

       112
        
                let* text = parse_text_content parser in

     

       113
        
                (match parse_int_opt text with

     

       114
       -
                 | Some s -> loop { wpt with sat = Some s }

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       115
        
                 | None -> loop wpt)

     

       116
       -
              | "hdop" | "vdop" | "pdop" ->

     

       117
        
                let* text = parse_text_content parser in

     

       118
        
                (match parse_float_opt text with

     

       119
       -
                 | Some f -> 

     

       120
       -
                   (match name with

     

       121
       -
                    | "hdop" -> loop { wpt with hdop = Some f }

     

       122
       -
                    | "vdop" -> loop { wpt with vdop = Some f }

     

       123
       -
                    | "pdop" -> loop { wpt with pdop = Some f }

     

       124
       -
                    | _ -> loop wpt)

     

       125
        
                 | None -> loop wpt)

     

       126
        
              | "ageofdgpsdata" ->

     

       127
        
                let* text = parse_text_content parser in

     

       128
        
                (match parse_float_opt text with

     

       129
       -
                 | Some f -> loop { wpt with ageofdgpsdata = Some f }

     

       130
        
                 | None -> loop wpt)

     

       131
        
              | "dgpsid" ->

     

       132
        
                let* text = parse_text_content parser in

     

       133
        
                (match parse_int_opt text with

     

       134
       -
                 | Some id -> loop { wpt with dgpsid = Some id }

     

       135
        
                 | None -> loop wpt)

     

       136
        
              | "link" ->

     

       137
        
                let* link = parse_link parser attrs in

     

       138
       -
                loop { wpt with links = link :: wpt.links }

     

       139
        
              | "extensions" ->

     

       140
        
                let* extensions = parse_extensions parser in

     

       141
       -
                loop { wpt with extensions = extensions @ wpt.extensions }

     

       142
        
              | _ -> 

     

       143
        
                (* Skip unknown elements *)

     

       144
        
                let* _ = skip_element parser in

     
···

       165
        
             parser.current_element <- List.tl parser.current_element;

     

       166
        
             Ok (Buffer.contents parser.text_buffer)

     

       167
        
           | `El_start _ ->

     

       168
       -
             Error (Invalid_xml "Unexpected element in text content")

     

       169
        
           | `Dtd _ ->

     

       170
        
             loop ()

     

       171
        
         in

     
···

       176
        
           | Some h -> h

     

       177
        
           | None -> ""

     

       178
        
         in

     

       179
       -
         let link = { href; text = None; type_ = None } in

     

       180
        
         parse_link_elements parser link

     

       181
        
       

     

       182
        
       and parse_link_elements parser link =

     
···

       187
        
             (match name with

     

       188
        
              | "text" ->

     

       189
        
                let* text = parse_text_content parser in

     

       190
       -
                loop { link with text = Some text }

     

       191
        
              | "type" ->

     

       192
        
                let* type_text = parse_text_content parser in

     

       193
       -
                loop { link with type_ = Some type_text }

     

       194
        
              | _ ->

     

       195
        
                let* _ = skip_element parser in

     

       196
        
                loop link)

     
···

       225
        
         let namespace = if ns = "" then None else Some ns in

     

       226
        
         let attributes = List.map (fun ((_, n), v) -> (n, v)) attrs in

     

       227
        
         let* content = parse_extension_content parser in

     

       228
       -
         Ok { namespace; name; attributes; content }

     

       229
        
       

     

       230
        
       and parse_extension_content parser =

     

       231
        
         Buffer.clear parser.text_buffer;

     
···

       242
        
             parser.current_element <- List.tl parser.current_element;

     

       243
        
             let text = String.trim (Buffer.contents parser.text_buffer) in

     

       244
        
             Ok (match (text, elements) with

     

       245
       -
                 | ("", []) -> Text ""

     

       246
       -
                 | ("", els) -> Elements (List.rev els)

     

       247
       -
                 | (t, []) -> Text t

     

       248
       -
                 | (t, els) -> Mixed (t, List.rev els))

     

       249
        
           | `Dtd _ ->

     

       250
        
             loop elements

     

       251
        
         in

     
···

       272
        
             let* version = require_attribute "version" attrs "gpx" in

     

       273
        
             let* creator = require_attribute "creator" attrs "gpx" in

     

       274
        
             if version <> "1.0" && version <> "1.1" then

     

       275
       -
               Error (Validation_error ("Unsupported GPX version: " ^ version ^ " (supported: 1.0, 1.1)"))

     

       276
        
             else

     

       277
        
               Ok (version, creator)

     

       278
        
           | `El_start _ ->

     
···

       281
        
           | `Dtd _ ->

     

       282
        
             find_gpx_root ()

     

       283
        
           | `El_end ->

     

       284
       -
             Error (Missing_required_element "gpx")

     

       285
        
           | `Data _ ->

     

       286
        
             find_gpx_root ()

     

       287
        
         in

     

       288
        
         

     

       289
        
         let* (version, creator) = find_gpx_root () in

     

       290
       -
         let gpx = make_gpx ~creator in

     

       291
        
         parse_gpx_elements parser { gpx with version }

     

       292
        
       

     

       293
        
       and parse_gpx_elements parser gpx =

     
···

       298
        
             (match name with

     

       299
        
              | "metadata" ->

     

       300
        
                let* metadata = parse_metadata parser in

     

       301
       -
                loop { gpx with metadata = Some metadata }

     

       302
        
              | "wpt" ->

     

       303
        
                let* (lat, lon) = parse_coordinates attrs "wpt" in

     

       304
        
                let* waypoint = parse_waypoint_data parser lat lon in

     

       305
       -
                loop { gpx with waypoints = waypoint :: gpx.waypoints }

     

       306
        
              | "rte" ->

     

       307
        
                let* route = parse_route parser in

     

       308
       -
                loop { gpx with routes = route :: gpx.routes }

     

       309
        
              | "trk" ->

     

       310
        
                let* track = parse_track parser in

     

       311
       -
                loop { gpx with tracks = track :: gpx.tracks }

     

       312
        
              | "extensions" ->

     

       313
        
                let* extensions = parse_extensions parser in

     

       314
       -
                loop { gpx with extensions = extensions @ gpx.extensions }

     

       315
        
              | _ ->

     

       316
        
                let* _ = skip_element parser in

     

       317
        
                loop gpx)

     

       318
        
           | `El_end ->

     

       319
       -
             Ok { gpx with 

     

       320
       -
                  waypoints = List.rev gpx.waypoints;

     

       321
       -
                  routes = List.rev gpx.routes;

     

       322
       -
                  tracks = List.rev gpx.tracks }

     

       323
        
           | `Data _ ->

     

       324
        
             loop gpx

     

       325
        
           | `Dtd _ ->

     
···

       327
        
         in

     

       328
        
         loop gpx

     

       329
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       330
        
       and parse_metadata parser =

     

       331
       -
         let metadata = empty_metadata in

     

       332
       -
         let rec loop (metadata : metadata) =

     

       333
        
           match Xmlm.input parser.input with

     

       334
        
           | `El_start ((_, name), attrs) ->

     

       335
        
             parser.current_element <- name :: parser.current_element;

     

       336
        
             (match name with

     

       337
        
              | "name" ->

     

       338
        
                let* text = parse_text_content parser in

     

       339
       -
                loop { metadata with name = Some text }

     

       340
        
              | "desc" ->

     

       341
        
                let* text = parse_text_content parser in

     

       342
       -
                loop { metadata with desc = Some text }

     

       343
        
              | "keywords" ->

     

       344
        
                let* text = parse_text_content parser in

     

       345
       -
                loop { metadata with keywords = Some text }

     

       346
        
              | "time" ->

     

       347
        
                let* text = parse_text_content parser in

     

       348
       -
                loop { metadata with time = parse_time text }

     

       349
        
              | "link" ->

     

       350
        
                let* link = parse_link parser attrs in

     

       351
       -
                loop { metadata with links = link :: metadata.links }

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       352
        
              | "extensions" ->

     

       353
        
                let* extensions = parse_extensions parser in

     

       354
       -
                loop { metadata with extensions = extensions @ metadata.extensions }

     

       355
        
              | _ ->

     

       356
        
                let* _ = skip_element parser in

     

       357
        
                loop metadata)

     

       358
        
           | `El_end ->

     

       359
        
             parser.current_element <- List.tl parser.current_element;

     

       360
       -
             Ok { metadata with links = List.rev metadata.links }

     

       361
        
           | `Data _ ->

     

       362
        
             loop metadata

     

       363
        
           | `Dtd _ ->

     
···

       366
        
         loop metadata

     

       367
        
       

     

       368
        
       and parse_route parser =

     

       369
       -
         let route = { 

     

       370
       -
           name = None; cmt = None; desc = None; src = None; links = [];

     

       371
       -
           number = None; type_ = None; extensions = []; rtepts = []

     

       372
       -
         } in

     

       373
       -
         let rec loop (route : route) =

     

       374
        
           match Xmlm.input parser.input with

     

       375
        
           | `El_start ((_, name), attrs) ->

     

       376
        
             parser.current_element <- name :: parser.current_element;

     

       377
        
             (match name with

     

       378
        
              | "name" ->

     

       379
        
                let* text = parse_text_content parser in

     

       380
       -
                loop { route with name = Some text }

     

       381
        
              | "cmt" ->

     

       382
        
                let* text = parse_text_content parser in

     

       383
       -
                loop { route with cmt = Some text }

     

       384
        
              | "desc" ->

     

       385
        
                let* text = parse_text_content parser in

     

       386
       -
                loop { route with desc = Some text }

     

       387
        
              | "src" ->

     

       388
        
                let* text = parse_text_content parser in

     

       389
       -
                loop { route with src = Some text }

     

       390
        
              | "number" ->

     

       391
        
                let* text = parse_text_content parser in

     

       392
        
                (match parse_int_opt text with

     

       393
       -
                 | Some n -> loop { route with number = Some n }

     

       394
        
                 | None -> loop route)

     

       395
        
              | "type" ->

     

       396
        
                let* text = parse_text_content parser in

     

       397
       -
                loop { route with type_ = Some text }

     

       398
        
              | "rtept" ->

     

       399
        
                let* (lat, lon) = parse_coordinates attrs "rtept" in

     

       400
        
                let* rtept = parse_waypoint_data parser lat lon in

     

       401
       -
                loop { route with rtepts = rtept :: route.rtepts }

     

       402
        
              | "link" ->

     

       403
        
                let* link = parse_link parser attrs in

     

       404
       -
                loop { route with links = link :: route.links }

     

       405
        
              | "extensions" ->

     

       406
        
                let* extensions = parse_extensions parser in

     

       407
       -
                loop { route with extensions = extensions @ route.extensions }

     

       408
        
              | _ ->

     

       409
        
                let* _ = skip_element parser in

     

       410
        
                loop route)

     

       411
        
           | `El_end ->

     

       412
        
             parser.current_element <- List.tl parser.current_element;

     

       413
       -
             Ok { route with 

     

       414
       -
                  rtepts = List.rev route.rtepts;

     

       415
       -
                  links = List.rev route.links }

     

       416
        
           | `Data _ ->

     

       417
        
             loop route

     

       418
        
           | `Dtd _ ->

     
···

       421
        
         loop route

     

       422
        
       

     

       423
        
       and parse_track parser =

     

       424
       -
         let track = {

     

       425
       -
           name = None; cmt = None; desc = None; src = None; links = [];

     

       426
       -
           number = None; type_ = None; extensions = []; trksegs = []

     

       427
       -
         } in

     

       428
        
         let rec loop track =

     

       429
        
           match Xmlm.input parser.input with

     

       430
        
           | `El_start ((_, name), attrs) ->

     
···

       432
        
             (match name with

     

       433
        
              | "name" ->

     

       434
        
                let* text = parse_text_content parser in

     

       435
       -
                loop { track with name = Some text }

     

       436
        
              | "cmt" ->

     

       437
        
                let* text = parse_text_content parser in

     

       438
       -
                loop { track with cmt = Some text }

     

       439
        
              | "desc" ->

     

       440
        
                let* text = parse_text_content parser in

     

       441
       -
                loop { track with desc = Some text }

     

       442
        
              | "src" ->

     

       443
        
                let* text = parse_text_content parser in

     

       444
       -
                loop { track with src = Some text }

     

       445
        
              | "number" ->

     

       446
        
                let* text = parse_text_content parser in

     

       447
        
                (match parse_int_opt text with

     

       448
       -
                 | Some n -> loop { track with number = Some n }

     

       449
        
                 | None -> loop track)

     

       450
        
              | "type" ->

     

       451
        
                let* text = parse_text_content parser in

     

       452
       -
                loop { track with type_ = Some text }

     

       453
        
              | "trkseg" ->

     

       454
        
                let* trkseg = parse_track_segment parser in

     

       455
       -
                loop { track with trksegs = trkseg :: track.trksegs }

     

       456
        
              | "link" ->

     

       457
        
                let* link = parse_link parser attrs in

     

       458
       -
                loop { track with links = link :: track.links }

     

       459
        
              | "extensions" ->

     

       460
        
                let* extensions = parse_extensions parser in

     

       461
       -
                loop { track with extensions = extensions @ track.extensions }

     

       462
        
              | _ ->

     

       463
        
                let* _ = skip_element parser in

     

       464
        
                loop track)

     

       465
        
           | `El_end ->

     

       466
        
             parser.current_element <- List.tl parser.current_element;

     

       467
       -
             Ok { track with

     

       468
       -
                  trksegs = List.rev track.trksegs;

     

       469
       -
                  links = List.rev track.links }

     

       470
        
           | `Data _ ->

     

       471
        
             loop track

     

       472
        
           | `Dtd _ ->

     
···

       475
        
         loop track

     

       476
        
       

     

       477
        
       and parse_track_segment parser =

     

       478
       -
         let trkseg = { trkpts = []; extensions = [] } in

     

       479
        
         let rec loop trkseg =

     

       480
        
           match Xmlm.input parser.input with

     

       481
        
           | `El_start ((_, name), attrs) ->

     
···

       484
        
              | "trkpt" ->

     

       485
        
                let* (lat, lon) = parse_coordinates attrs "trkpt" in

     

       486
        
                let* trkpt = parse_waypoint_data parser lat lon in

     

       487
       -
                loop { trkseg with trkpts = trkpt :: trkseg.trkpts }

     

       488
        
              | "extensions" ->

     

       489
       -
                let* extensions = parse_extensions parser in

     

       490
       -
                loop { trkseg with extensions = extensions @ trkseg.extensions }

     

       491
        
              | _ ->

     

       492
        
                let* _ = skip_element parser in

     

       493
        
                loop trkseg)

     

       494
        
           | `El_end ->

     

       495
        
             parser.current_element <- List.tl parser.current_element;

     

       496
       -
             Ok { trkseg with trkpts = List.rev trkseg.trkpts }

     

       497
        
           | `Data _ ->

     

       498
        
             loop trkseg

     

       499
        
           | `Dtd _ ->

     
···

       502
        
         loop trkseg

     

       503
        
       

     

       504
        
       (** Main parsing function *)

     

       505
       -
       let parse input =

     

       506
        
         let parser = make_parser input in

     

       507
        
         try

     

       508
       -
           parse_gpx parser

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       509
        
         with

     

       510
        
         | Xmlm.Error ((line, col), error) ->

     

       511
       -
           Error (Xml_error (Printf.sprintf "XML error at line %d, column %d: %s"

     

       512
       -
                             line col (Xmlm.error_message error)))

     

       513
        
         | exn ->

     

       514
       -
           Error (Invalid_xml (Printexc.to_string exn))

     

       515
        
       

     

       516
        
       (** Parse from string *)

     

       517
       -
       let parse_string s =

     

       518
        
         let input = Xmlm.make_input (`String (0, s)) in

     

       519
       -
         parse input

···

       1
        
       (** GPX streaming parser using xmlm *)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (** Parser state for streaming *)

     

       4
        
       type parser_state = {

     

       5
        
         input : Xmlm.input;

     
···

       25
        
       let require_attribute name attrs element =

     

       26
        
         match get_attribute name attrs with

     

       27
        
         | Some value -> Ok value

     

       28
       +
         | None -> Error (Error.missing_attribute element name)

     

       29
        
       

     

       30
        
       let parse_float_opt s =

     

       31
        
         try Some (Float.of_string s)

     
···

       48
        
         let* lon_str = require_attribute "lon" attrs element in

     

       49
        
         match (Float.of_string lat_str, Float.of_string lon_str) with

     

       50
        
         | (lat_f, lon_f) ->

     

       51
       +
           let* lat = Result.map_error Error.invalid_coordinate (Coordinate.latitude lat_f) in

     

       52
       +
           let* lon = Result.map_error Error.invalid_coordinate (Coordinate.longitude lon_f) in

     

       53
        
           Ok (lat, lon)

     

       54
       +
         | exception _ -> Error (Error.invalid_coordinate "Invalid coordinate format")

     

       55
        
       

     

       56
        
       (** Parse waypoint data from XML elements *)

     

       57
        
       let rec parse_waypoint_data parser lat lon =

     

       58
       +
         let wpt = Waypoint.make lat lon in

     

       59
        
         parse_waypoint_elements parser wpt

     

       60
        
       

     

       61
        
       and parse_waypoint_elements parser wpt =

     
···

       67
        
              | "ele" -> 

     

       68
        
                let* text = parse_text_content parser in

     

       69
        
                (match parse_float_opt text with

     

       70
       +
                 | Some ele -> loop (Waypoint.with_elevation wpt ele)

     

       71
        
                 | None -> loop wpt)

     

       72
        
              | "time" ->

     

       73
        
                let* text = parse_text_content parser in

     

       74
       +
                loop (Waypoint.with_time wpt (parse_time text))

     

       75
        
              | "magvar" ->

     

       76
        
                let* text = parse_text_content parser in

     

       77
        
                (match parse_float_opt text with

     

       78
        
                 | Some f -> 

     

       79
       +
                   (match Coordinate.degrees f with

     

       80
       +
                    | Ok deg -> loop (Waypoint.with_magvar wpt deg)

     

       81
        
                    | Error _ -> loop wpt)

     

       82
        
                 | None -> loop wpt)

     

       83
        
              | "geoidheight" ->

     

       84
        
                let* text = parse_text_content parser in

     

       85
        
                (match parse_float_opt text with

     

       86
       +
                 | Some h -> loop (Waypoint.with_geoidheight wpt h)

     

       87
        
                 | None -> loop wpt)

     

       88
        
              | "name" ->

     

       89
        
                let* text = parse_text_content parser in

     

       90
       +
                loop (Waypoint.with_name wpt text)

     

       91
        
              | "cmt" ->

     

       92
        
                let* text = parse_text_content parser in

     

       93
       +
                loop (Waypoint.with_comment wpt text)

     

       94
        
              | "desc" ->

     

       95
        
                let* text = parse_text_content parser in

     

       96
       +
                loop (Waypoint.with_description wpt text)

     

       97
        
              | "src" ->

     

       98
        
                let* text = parse_text_content parser in

     

       99
       +
                loop (Waypoint.with_source wpt text)

     

       100
        
              | "sym" ->

     

       101
        
                let* text = parse_text_content parser in

     

       102
       +
                loop (Waypoint.with_symbol wpt text)

     

       103
        
              | "type" ->

     

       104
        
                let* text = parse_text_content parser in

     

       105
       +
                loop (Waypoint.with_type wpt text)

     

       106
        
              | "fix" ->

     

       107
        
                let* text = parse_text_content parser in

     

       108
       +
                loop (Waypoint.with_fix wpt (Waypoint.fix_type_of_string text))

     

       109
        
              | "sat" ->

     

       110
        
                let* text = parse_text_content parser in

     

       111
        
                (match parse_int_opt text with

     

       112
       +
                 | Some s -> loop (Waypoint.with_sat wpt s)

     

       113
       +
                 | None -> loop wpt)

     

       114
       +
              | "hdop" ->

     

       115
       +
                let* text = parse_text_content parser in

     

       116
       +
                (match parse_float_opt text with

     

       117
       +
                 | Some f -> loop (Waypoint.with_hdop wpt f)

     

       118
       +
                 | None -> loop wpt)

     

       119
       +
              | "vdop" ->

     

       120
       +
                let* text = parse_text_content parser in

     

       121
       +
                (match parse_float_opt text with

     

       122
       +
                 | Some f -> loop (Waypoint.with_vdop wpt f)

     

       123
        
                 | None -> loop wpt)

     

       124
       +
              | "pdop" ->

     

       125
        
                let* text = parse_text_content parser in

     

       126
        
                (match parse_float_opt text with

     

       127
       +
                 | Some f -> loop (Waypoint.with_pdop wpt f)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       128
        
                 | None -> loop wpt)

     

       129
        
              | "ageofdgpsdata" ->

     

       130
        
                let* text = parse_text_content parser in

     

       131
        
                (match parse_float_opt text with

     

       132
       +
                 | Some f -> loop (Waypoint.with_ageofdgpsdata wpt f)

     

       133
        
                 | None -> loop wpt)

     

       134
        
              | "dgpsid" ->

     

       135
        
                let* text = parse_text_content parser in

     

       136
        
                (match parse_int_opt text with

     

       137
       +
                 | Some id -> loop (Waypoint.with_dgpsid wpt id)

     

       138
        
                 | None -> loop wpt)

     

       139
        
              | "link" ->

     

       140
        
                let* link = parse_link parser attrs in

     

       141
       +
                loop (Waypoint.add_link wpt link)

     

       142
        
              | "extensions" ->

     

       143
        
                let* extensions = parse_extensions parser in

     

       144
       +
                loop (Waypoint.add_extensions wpt extensions)

     

       145
        
              | _ -> 

     

       146
        
                (* Skip unknown elements *)

     

       147
        
                let* _ = skip_element parser in

     
···

       168
        
             parser.current_element <- List.tl parser.current_element;

     

       169
        
             Ok (Buffer.contents parser.text_buffer)

     

       170
        
           | `El_start _ ->

     

       171
       +
             Error (Error.invalid_xml "Unexpected element in text content")

     

       172
        
           | `Dtd _ ->

     

       173
        
             loop ()

     

       174
        
         in

     
···

       179
        
           | Some h -> h

     

       180
        
           | None -> ""

     

       181
        
         in

     

       182
       +
         let link = Link.make ~href () in

     

       183
        
         parse_link_elements parser link

     

       184
        
       

     

       185
        
       and parse_link_elements parser link =

     
···

       190
        
             (match name with

     

       191
        
              | "text" ->

     

       192
        
                let* text = parse_text_content parser in

     

       193
       +
                loop (Link.with_text link text)

     

       194
        
              | "type" ->

     

       195
        
                let* type_text = parse_text_content parser in

     

       196
       +
                loop (Link.with_type link type_text)

     

       197
        
              | _ ->

     

       198
        
                let* _ = skip_element parser in

     

       199
        
                loop link)

     
···

       228
        
         let namespace = if ns = "" then None else Some ns in

     

       229
        
         let attributes = List.map (fun ((_, n), v) -> (n, v)) attrs in

     

       230
        
         let* content = parse_extension_content parser in

     

       231
       +
         Ok (Extension.make ?namespace ~name ~attributes ~content ())

     

       232
        
       

     

       233
        
       and parse_extension_content parser =

     

       234
        
         Buffer.clear parser.text_buffer;

     
···

       245
        
             parser.current_element <- List.tl parser.current_element;

     

       246
        
             let text = String.trim (Buffer.contents parser.text_buffer) in

     

       247
        
             Ok (match (text, elements) with

     

       248
       +
                 | ("", []) -> Extension.text_content ""

     

       249
       +
                 | ("", els) -> Extension.elements_content (List.rev els)

     

       250
       +
                 | (t, []) -> Extension.text_content t

     

       251
       +
                 | (t, els) -> Extension.mixed_content t (List.rev els))

     

       252
        
           | `Dtd _ ->

     

       253
        
             loop elements

     

       254
        
         in

     
···

       275
        
             let* version = require_attribute "version" attrs "gpx" in

     

       276
        
             let* creator = require_attribute "creator" attrs "gpx" in

     

       277
        
             if version <> "1.0" && version <> "1.1" then

     

       278
       +
               Error (Error.validation_error ("Unsupported GPX version: " ^ version ^ " (supported: 1.0, 1.1)"))

     

       279
        
             else

     

       280
        
               Ok (version, creator)

     

       281
        
           | `El_start _ ->

     
···

       284
        
           | `Dtd _ ->

     

       285
        
             find_gpx_root ()

     

       286
        
           | `El_end ->

     

       287
       +
             Error (Error.missing_element "gpx")

     

       288
        
           | `Data _ ->

     

       289
        
             find_gpx_root ()

     

       290
        
         in

     

       291
        
         

     

       292
        
         let* (version, creator) = find_gpx_root () in

     

       293
       +
         let gpx = Doc.empty ~creator in

     

       294
        
         parse_gpx_elements parser { gpx with version }

     

       295
        
       

     

       296
        
       and parse_gpx_elements parser gpx =

     
···

       301
        
             (match name with

     

       302
        
              | "metadata" ->

     

       303
        
                let* metadata = parse_metadata parser in

     

       304
       +
                loop (Doc.with_metadata gpx metadata)

     

       305
        
              | "wpt" ->

     

       306
        
                let* (lat, lon) = parse_coordinates attrs "wpt" in

     

       307
        
                let* waypoint = parse_waypoint_data parser lat lon in

     

       308
       +
                loop (Doc.add_waypoint gpx waypoint)

     

       309
        
              | "rte" ->

     

       310
        
                let* route = parse_route parser in

     

       311
       +
                loop (Doc.add_route gpx route)

     

       312
        
              | "trk" ->

     

       313
        
                let* track = parse_track parser in

     

       314
       +
                loop (Doc.add_track gpx track)

     

       315
        
              | "extensions" ->

     

       316
        
                let* extensions = parse_extensions parser in

     

       317
       +
                loop (Doc.add_extensions gpx extensions)

     

       318
        
              | _ ->

     

       319
        
                let* _ = skip_element parser in

     

       320
        
                loop gpx)

     

       321
        
           | `El_end ->

     

       322
       +
             Ok gpx

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       323
        
           | `Data _ ->

     

       324
        
             loop gpx

     

       325
        
           | `Dtd _ ->

     
···

       327
        
         in

     

       328
        
         loop gpx

     

       329
        
       

     

       330
       +
       and parse_author parser =

     

       331
       +
         let rec loop name email link =

     

       332
       +
           match Xmlm.input parser.input with

     

       333
       +
           | `El_start ((_, element_name), attrs) ->

     

       334
       +
             parser.current_element <- element_name :: parser.current_element;

     

       335
       +
             (match element_name with

     

       336
       +
              | "name" ->

     

       337
       +
                let* text = parse_text_content parser in

     

       338
       +
                loop (Some text) email link

     

       339
       +
              | "email" ->

     

       340
       +
                let* email_addr = parse_email_attrs attrs in

     

       341
       +
                let* _ = skip_element parser in

     

       342
       +
                loop name (Some email_addr) link  

     

       343
       +
              | "link" ->

     

       344
       +
                let* parsed_link = parse_link parser attrs in

     

       345
       +
                loop name email (Some parsed_link)

     

       346
       +
              | _ ->

     

       347
       +
                let* _ = skip_element parser in

     

       348
       +
                loop name email link)

     

       349
       +
           | `El_end ->

     

       350
       +
             parser.current_element <- List.tl parser.current_element;

     

       351
       +
             Ok (Link.make_person ?name ?email ?link ())

     

       352
       +
           | `Data _ ->

     

       353
       +
             loop name email link

     

       354
       +
           | `Dtd _ ->

     

       355
       +
             loop name email link

     

       356
       +
         in

     

       357
       +
         loop None None None

     

       358
       +
       

     

       359
       +
       and parse_email_attrs attrs =

     

       360
       +
         let get_attr name =

     

       361
       +
           List.find_map (fun ((_, attr_name), value) ->

     

       362
       +
             if attr_name = name then Some value else None

     

       363
       +
           ) attrs

     

       364
       +
         in

     

       365
       +
         match get_attr "id", get_attr "domain" with

     

       366
       +
         | Some id, Some domain -> Ok (id ^ "@" ^ domain)

     

       367
       +
         | _ -> Error (Error.invalid_xml "Missing email id or domain attributes")

     

       368
       +
       

     

       369
       +
       and parse_copyright parser attrs =

     

       370
       +
         let get_attr name =

     

       371
       +
           List.find_map (fun ((_, attr_name), value) ->

     

       372
       +
             if attr_name = name then Some value else None

     

       373
       +
           ) attrs

     

       374
       +
         in

     

       375
       +
         let author = get_attr "author" in

     

       376
       +
         let rec loop year license =

     

       377
       +
           match Xmlm.input parser.input with

     

       378
       +
           | `El_start ((_, element_name), _) ->

     

       379
       +
             parser.current_element <- element_name :: parser.current_element;

     

       380
       +
             (match element_name with

     

       381
       +
              | "year" ->

     

       382
       +
                let* text = parse_text_content parser in

     

       383
       +
                (match parse_int_opt text with

     

       384
       +
                 | Some y -> loop (Some y) license

     

       385
       +
                 | None -> loop year license)

     

       386
       +
              | "license" ->

     

       387
       +
                let* text = parse_text_content parser in

     

       388
       +
                loop year (Some text)

     

       389
       +
              | _ ->

     

       390
       +
                let* _ = skip_element parser in

     

       391
       +
                loop year license)

     

       392
       +
           | `El_end ->

     

       393
       +
             parser.current_element <- List.tl parser.current_element;

     

       394
       +
             (match author with

     

       395
       +
              | Some auth -> Ok (Link.make_copyright ~author:auth ?year ?license ())

     

       396
       +
              | None -> Error (Error.invalid_xml "Missing copyright author attribute"))

     

       397
       +
           | `Data _ ->

     

       398
       +
             loop year license

     

       399
       +
           | `Dtd _ ->

     

       400
       +
             loop year license

     

       401
       +
         in

     

       402
       +
         loop None None

     

       403
       +
       

     

       404
       +
       and parse_bounds parser attrs =

     

       405
       +
         let get_attr name =

     

       406
       +
           List.find_map (fun ((_, attr_name), value) ->

     

       407
       +
             if attr_name = name then Some value else None

     

       408
       +
           ) attrs

     

       409
       +
         in

     

       410
       +
         let minlat_str = get_attr "minlat" in

     

       411
       +
         let minlon_str = get_attr "minlon" in

     

       412
       +
         let maxlat_str = get_attr "maxlat" in

     

       413
       +
         let maxlon_str = get_attr "maxlon" in

     

       414
       +
         

     

       415
       +
         (* Skip content since bounds is a self-closing element *)

     

       416
       +
         let rec skip_bounds_content () =

     

       417
       +
           match Xmlm.input parser.input with

     

       418
       +
           | `El_end -> 

     

       419
       +
               parser.current_element <- List.tl parser.current_element;

     

       420
       +
               Ok ()

     

       421
       +
           | `Data _ -> skip_bounds_content ()

     

       422
       +
           | _ -> skip_bounds_content ()

     

       423
       +
         in

     

       424
       +
         let* () = skip_bounds_content () in

     

       425
       +
         

     

       426
       +
         match minlat_str, minlon_str, maxlat_str, maxlon_str with

     

       427
       +
         | Some minlat, Some minlon, Some maxlat, Some maxlon ->

     

       428
       +
             (match 

     

       429
       +
                Float.of_string_opt minlat, Float.of_string_opt minlon,

     

       430
       +
                Float.of_string_opt maxlat, Float.of_string_opt maxlon

     

       431
       +
              with

     

       432
       +
              | Some minlat_f, Some minlon_f, Some maxlat_f, Some maxlon_f ->

     

       433
       +
                  (match Metadata.Bounds.make_from_floats ~minlat:minlat_f ~minlon:minlon_f ~maxlat:maxlat_f ~maxlon:maxlon_f with

     

       434
       +
                   | Ok bounds -> Ok bounds

     

       435
       +
                   | Error msg -> Error (Error.invalid_xml ("Invalid bounds: " ^ msg)))

     

       436
       +
              | _ -> Error (Error.invalid_xml ("Invalid bounds coordinates")))

     

       437
       +
         | _ -> Error (Error.invalid_xml ("Missing bounds attributes"))

     

       438
       +
       

     

       439
        
       and parse_metadata parser =

     

       440
       +
         let metadata = Metadata.empty in

     

       441
       +
         let rec loop metadata =

     

       442
        
           match Xmlm.input parser.input with

     

       443
        
           | `El_start ((_, name), attrs) ->

     

       444
        
             parser.current_element <- name :: parser.current_element;

     

       445
        
             (match name with

     

       446
        
              | "name" ->

     

       447
        
                let* text = parse_text_content parser in

     

       448
       +
                loop (Metadata.with_name metadata text)

     

       449
        
              | "desc" ->

     

       450
        
                let* text = parse_text_content parser in

     

       451
       +
                loop (Metadata.with_description metadata text)

     

       452
        
              | "keywords" ->

     

       453
        
                let* text = parse_text_content parser in

     

       454
       +
                loop (Metadata.with_keywords metadata text)

     

       455
        
              | "time" ->

     

       456
        
                let* text = parse_text_content parser in

     

       457
       +
                loop (Metadata.with_time metadata (parse_time text))

     

       458
        
              | "link" ->

     

       459
        
                let* link = parse_link parser attrs in

     

       460
       +
                loop (Metadata.add_link metadata link)

     

       461
       +
              | "author" ->

     

       462
       +
                let* author = parse_author parser in

     

       463
       +
                loop (Metadata.with_author metadata author)

     

       464
       +
              | "copyright" ->

     

       465
       +
                let* copyright = parse_copyright parser attrs in

     

       466
       +
                loop (Metadata.with_copyright metadata copyright)

     

       467
       +
              | "bounds" ->

     

       468
       +
                let* bounds = parse_bounds parser attrs in

     

       469
       +
                loop (Metadata.with_bounds metadata bounds)

     

       470
        
              | "extensions" ->

     

       471
        
                let* extensions = parse_extensions parser in

     

       472
       +
                loop (Metadata.add_extensions metadata extensions)

     

       473
        
              | _ ->

     

       474
        
                let* _ = skip_element parser in

     

       475
        
                loop metadata)

     

       476
        
           | `El_end ->

     

       477
        
             parser.current_element <- List.tl parser.current_element;

     

       478
       +
             Ok metadata

     

       479
        
           | `Data _ ->

     

       480
        
             loop metadata

     

       481
        
           | `Dtd _ ->

     
···

       484
        
         loop metadata

     

       485
        
       

     

       486
        
       and parse_route parser =

     

       487
       +
         let route = Route.empty in

     

       488
       +
         let rec loop route =

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       489
        
           match Xmlm.input parser.input with

     

       490
        
           | `El_start ((_, name), attrs) ->

     

       491
        
             parser.current_element <- name :: parser.current_element;

     

       492
        
             (match name with

     

       493
        
              | "name" ->

     

       494
        
                let* text = parse_text_content parser in

     

       495
       +
                loop (Route.with_name route text)

     

       496
        
              | "cmt" ->

     

       497
        
                let* text = parse_text_content parser in

     

       498
       +
                loop (Route.with_comment route text)

     

       499
        
              | "desc" ->

     

       500
        
                let* text = parse_text_content parser in

     

       501
       +
                loop (Route.with_description route text)

     

       502
        
              | "src" ->

     

       503
        
                let* text = parse_text_content parser in

     

       504
       +
                loop (Route.with_source route text)

     

       505
        
              | "number" ->

     

       506
        
                let* text = parse_text_content parser in

     

       507
        
                (match parse_int_opt text with

     

       508
       +
                 | Some n -> loop (Route.with_number route n)

     

       509
        
                 | None -> loop route)

     

       510
        
              | "type" ->

     

       511
        
                let* text = parse_text_content parser in

     

       512
       +
                loop (Route.with_type route text)

     

       513
        
              | "rtept" ->

     

       514
        
                let* (lat, lon) = parse_coordinates attrs "rtept" in

     

       515
        
                let* rtept = parse_waypoint_data parser lat lon in

     

       516
       +
                loop (Route.add_point route rtept)

     

       517
        
              | "link" ->

     

       518
        
                let* link = parse_link parser attrs in

     

       519
       +
                loop (Route.add_link route link)

     

       520
        
              | "extensions" ->

     

       521
        
                let* extensions = parse_extensions parser in

     

       522
       +
                loop (Route.add_extensions route extensions)

     

       523
        
              | _ ->

     

       524
        
                let* _ = skip_element parser in

     

       525
        
                loop route)

     

       526
        
           | `El_end ->

     

       527
        
             parser.current_element <- List.tl parser.current_element;

     

       528
       +
             Ok route

     

       0
        
       
     

       0
        
       
     

       529
        
           | `Data _ ->

     

       530
        
             loop route

     

       531
        
           | `Dtd _ ->

     
···

       534
        
         loop route

     

       535
        
       

     

       536
        
       and parse_track parser =

     

       537
       +
         let track = Track.empty in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       538
        
         let rec loop track =

     

       539
        
           match Xmlm.input parser.input with

     

       540
        
           | `El_start ((_, name), attrs) ->

     
···

       542
        
             (match name with

     

       543
        
              | "name" ->

     

       544
        
                let* text = parse_text_content parser in

     

       545
       +
                loop (Track.with_name track text)

     

       546
        
              | "cmt" ->

     

       547
        
                let* text = parse_text_content parser in

     

       548
       +
                loop (Track.with_comment track text)

     

       549
        
              | "desc" ->

     

       550
        
                let* text = parse_text_content parser in

     

       551
       +
                loop (Track.with_description track text)

     

       552
        
              | "src" ->

     

       553
        
                let* text = parse_text_content parser in

     

       554
       +
                loop (Track.with_source track text)

     

       555
        
              | "number" ->

     

       556
        
                let* text = parse_text_content parser in

     

       557
        
                (match parse_int_opt text with

     

       558
       +
                 | Some n -> loop (Track.with_number track n)

     

       559
        
                 | None -> loop track)

     

       560
        
              | "type" ->

     

       561
        
                let* text = parse_text_content parser in

     

       562
       +
                loop (Track.with_type track text)

     

       563
        
              | "trkseg" ->

     

       564
        
                let* trkseg = parse_track_segment parser in

     

       565
       +
                loop (Track.add_segment track trkseg)

     

       566
        
              | "link" ->

     

       567
        
                let* link = parse_link parser attrs in

     

       568
       +
                loop (Track.add_link track link)

     

       569
        
              | "extensions" ->

     

       570
        
                let* extensions = parse_extensions parser in

     

       571
       +
                loop (Track.add_extensions track extensions)

     

       572
        
              | _ ->

     

       573
        
                let* _ = skip_element parser in

     

       574
        
                loop track)

     

       575
        
           | `El_end ->

     

       576
        
             parser.current_element <- List.tl parser.current_element;

     

       577
       +
             Ok track

     

       0
        
       
     

       0
        
       
     

       578
        
           | `Data _ ->

     

       579
        
             loop track

     

       580
        
           | `Dtd _ ->

     
···

       583
        
         loop track

     

       584
        
       

     

       585
        
       and parse_track_segment parser =

     

       586
       +
         let trkseg = Track.Segment.empty in

     

       587
        
         let rec loop trkseg =

     

       588
        
           match Xmlm.input parser.input with

     

       589
        
           | `El_start ((_, name), attrs) ->

     
···

       592
        
              | "trkpt" ->

     

       593
        
                let* (lat, lon) = parse_coordinates attrs "trkpt" in

     

       594
        
                let* trkpt = parse_waypoint_data parser lat lon in

     

       595
       +
                loop (Track.Segment.add_point trkseg trkpt)

     

       596
        
              | "extensions" ->

     

       597
       +
                let* _ = parse_extensions parser in

     

       598
       +
                loop trkseg

     

       599
        
              | _ ->

     

       600
        
                let* _ = skip_element parser in

     

       601
        
                loop trkseg)

     

       602
        
           | `El_end ->

     

       603
        
             parser.current_element <- List.tl parser.current_element;

     

       604
       +
             Ok trkseg

     

       605
        
           | `Data _ ->

     

       606
        
             loop trkseg

     

       607
        
           | `Dtd _ ->

     
···

       610
        
         loop trkseg

     

       611
        
       

     

       612
        
       (** Main parsing function *)

     

       613
       +
       let parse ?(validate=false) input =

     

       614
        
         let parser = make_parser input in

     

       615
        
         try

     

       616
       +
           let result = parse_gpx parser in

     

       617
       +
           match result, validate with

     

       618
       +
           | Ok gpx, true ->

     

       619
       +
             let validation = Validate.validate_gpx gpx in

     

       620
       +
             if validation.is_valid then

     

       621
       +
               Ok gpx

     

       622
       +
             else

     

       623
       +
               let error_msgs = List.filter (fun issue -> issue.Validate.level = `Error) validation.issues

     

       624
       +
                               |> List.map (fun issue -> issue.Validate.message)

     

       625
       +
                               |> String.concat "; " in

     

       626
       +
               Error (Error.validation_error error_msgs)

     

       627
       +
           | result, false -> result

     

       628
       +
           | Error _ as result, true -> result (* Pass through parse errors even when validating *)

     

       629
        
         with

     

       630
        
         | Xmlm.Error ((line, col), error) ->

     

       631
       +
           Error (Error.xml_error (Printf.sprintf "XML error at line %d, column %d: %s"

     

       632
       +
                            line col (Xmlm.error_message error)))

     

       633
        
         | exn ->

     

       634
       +
           Error (Error.invalid_xml (Printexc.to_string exn))

     

       635
        
       

     

       636
        
       (** Parse from string *)

     

       637
       +
       let parse_string ?(validate=false) s =

     

       638
        
         let input = Xmlm.make_input (`String (0, s)) in

     

       639
       +
         parse ~validate input

+2 -4

lib/gpx/parser.mli

···

       1
        
       (** GPX streaming parser using xmlm *)

     

       2
        
       

     

       3
       -
       open Types

     

       4
       -
       

     

       5
        
       (** Parse a GPX document from an xmlm input source *)

     

       6
       -
       val parse : Xmlm.input -> gpx result

     

       7
        
       

     

       8
        
       (** Parse a GPX document from a string *)

     

       9
       -
       val parse_string : string -> gpx result

···

       1
        
       (** GPX streaming parser using xmlm *)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (** Parse a GPX document from an xmlm input source *)

     

       4
       +
       val parse : ?validate:bool -> Xmlm.input -> (Doc.t, Error.t) result

     

       5
        
       

     

       6
        
       (** Parse a GPX document from a string *)

     

       7
       +
       val parse_string : ?validate:bool -> string -> (Doc.t, Error.t) result

+166

lib/gpx/route.ml

···

       1
       +
       (** Route types and operations *)

     

       2
       +
       

     

       3
       +
       (** Route point is an alias for waypoint *)

     

       4
       +
       type point = Waypoint.t

     

       5
       +
       

     

       6
       +
       (** Main route type *)

     

       7
       +
       type t = {

     

       8
       +
         name : string option;

     

       9
       +
         cmt : string option;

     

       10
       +
         desc : string option;

     

       11
       +
         src : string option;

     

       12
       +
         links : Link.t list;

     

       13
       +
         number : int option;

     

       14
       +
         type_ : string option;

     

       15
       +
         extensions : Extension.t list;

     

       16
       +
         rtepts : point list;

     

       17
       +
       }

     

       18
       +
       

     

       19
       +
       (** {2 Route Operations} *)

     

       20
       +
       

     

       21
       +
       (** Create empty route *)

     

       22
       +
       let empty = {

     

       23
       +
         name = None; cmt = None; desc = None; src = None;

     

       24
       +
         links = []; number = None; type_ = None; extensions = [];

     

       25
       +
         rtepts = [];

     

       26
       +
       }

     

       27
       +
       

     

       28
       +
       (** Create route with name *)

     

       29
       +
       let make ~name = { empty with name = Some name }

     

       30
       +
       

     

       31
       +
       (** Create route from coordinate list *)

     

       32
       +
       let make_from_coords ~name coords =

     

       33
       +
         let make_rtept (lat_f, lon_f) =

     

       34
       +
           match Waypoint.make_from_floats ~lat:lat_f ~lon:lon_f () with

     

       35
       +
           | Ok wpt -> wpt

     

       36
       +
           | Error e -> invalid_arg e

     

       37
       +
         in

     

       38
       +
         let rtepts = List.map make_rtept coords in

     

       39
       +
         { empty with name = Some name; rtepts }

     

       40
       +
       

     

       41
       +
       (** Get route name *)

     

       42
       +
       let name t = t.name

     

       43
       +
       

     

       44
       +
       (** Get route description *)

     

       45
       +
       let description t = t.desc

     

       46
       +
       

     

       47
       +
       (** Get route number *)

     

       48
       +
       let number t = t.number

     

       49
       +
       

     

       50
       +
       (** Get route comment *)

     

       51
       +
       let comment t = t.cmt

     

       52
       +
       

     

       53
       +
       (** Get route source *)

     

       54
       +
       let source t = t.src

     

       55
       +
       

     

       56
       +
       (** Get route links *)

     

       57
       +
       let links t = t.links

     

       58
       +
       

     

       59
       +
       (** Get route type *)

     

       60
       +
       let type_ t = t.type_

     

       61
       +
       

     

       62
       +
       (** Get route extensions *)

     

       63
       +
       let extensions t = t.extensions

     

       64
       +
       

     

       65
       +
       (** Get route points *)

     

       66
       +
       let points t = t.rtepts

     

       67
       +
       

     

       68
       +
       (** Get route point count *)

     

       69
       +
       let point_count t = List.length t.rtepts

     

       70
       +
       

     

       71
       +
       

     

       72
       +
       (** Clear all points *)

     

       73
       +
       let clear_points t = { t with rtepts = [] }

     

       74
       +
       

     

       75
       +
       (** Extract coordinates from route *)

     

       76
       +
       let to_coords t = List.map Waypoint.to_floats t.rtepts

     

       77
       +
       

     

       78
       +
       (** Simple great circle distance calculation *)

     

       79
       +
       let great_circle_distance lat1 lon1 lat2 lon2 =

     

       80
       +
         let deg_to_rad x = x *. Float.pi /. 180.0 in

     

       81
       +
         let lat1_rad = deg_to_rad lat1 in

     

       82
       +
         let lon1_rad = deg_to_rad lon1 in

     

       83
       +
         let lat2_rad = deg_to_rad lat2 in

     

       84
       +
         let lon2_rad = deg_to_rad lon2 in

     

       85
       +
         let dlat = lat2_rad -. lat1_rad in

     

       86
       +
         let dlon = lon2_rad -. lon1_rad in

     

       87
       +
         let a = 

     

       88
       +
           sin (dlat /. 2.0) ** 2.0 +. 

     

       89
       +
           cos lat1_rad *. cos lat2_rad *. sin (dlon /. 2.0) ** 2.0 

     

       90
       +
         in

     

       91
       +
         let c = 2.0 *. asin (sqrt a) in

     

       92
       +
         6371000.0 *. c (* Earth radius in meters *)

     

       93
       +
       

     

       94
       +
       (** Calculate total distance between consecutive points (naive great circle) *)

     

       95
       +
       let total_distance t =

     

       96
       +
         let rec calculate_distance acc = function

     

       97
       +
           | [] | [_] -> acc

     

       98
       +
           | p1 :: p2 :: rest ->

     

       99
       +
             let lat1, lon1 = Waypoint.to_floats p1 in

     

       100
       +
             let lat2, lon2 = Waypoint.to_floats p2 in

     

       101
       +
             let distance = great_circle_distance lat1 lon1 lat2 lon2 in

     

       102
       +
             calculate_distance (acc +. distance) (p2 :: rest)

     

       103
       +
         in

     

       104
       +
         calculate_distance 0.0 t.rtepts

     

       105
       +
       

     

       106
       +
       (** Check if route is empty *)

     

       107
       +
       let is_empty t = List.length t.rtepts = 0

     

       108
       +
       

     

       109
       +
       (** Get first point *)

     

       110
       +
       let first_point t = 

     

       111
       +
         match t.rtepts with

     

       112
       +
         | [] -> None

     

       113
       +
         | p :: _ -> Some p

     

       114
       +
       

     

       115
       +
       (** Get last point *)

     

       116
       +
       let last_point t =

     

       117
       +
         match List.rev t.rtepts with

     

       118
       +
         | [] -> None

     

       119
       +
         | p :: _ -> Some p

     

       120
       +
       

     

       121
       +
       (** {2 Functional Operations} *)

     

       122
       +
       

     

       123
       +
       (** Update name *)

     

       124
       +
       let with_name t name = { t with name = Some name }

     

       125
       +
       

     

       126
       +
       (** Update comment *)

     

       127
       +
       let with_comment t cmt = { t with cmt = Some cmt }

     

       128
       +
       

     

       129
       +
       (** Update description *)

     

       130
       +
       let with_description t desc = { t with desc = Some desc }

     

       131
       +
       

     

       132
       +
       (** Update source *)

     

       133
       +
       let with_source t src = { t with src = Some src }

     

       134
       +
       

     

       135
       +
       (** Update number *)

     

       136
       +
       let with_number t number = { t with number = Some number }

     

       137
       +
       

     

       138
       +
       (** Update type *)

     

       139
       +
       let with_type t type_ = { t with type_ = Some type_ }

     

       140
       +
       

     

       141
       +
       (** Add point *)

     

       142
       +
       let add_point t rtept = { t with rtepts = t.rtepts @ [rtept] }

     

       143
       +
       

     

       144
       +
       (** Add link *)

     

       145
       +
       let add_link t link = { t with links = t.links @ [link] }

     

       146
       +
       

     

       147
       +
       (** Add extensions *)

     

       148
       +
       let add_extensions t extensions = { t with extensions = t.extensions @ extensions }

     

       149
       +
       

     

       150
       +
       (** Compare routes *)

     

       151
       +
       let compare t1 t2 =

     

       152
       +
         let name_cmp = Option.compare String.compare t1.name t2.name in

     

       153
       +
         if name_cmp <> 0 then name_cmp

     

       154
       +
         else

     

       155
       +
           let desc_cmp = Option.compare String.compare t1.desc t2.desc in

     

       156
       +
           if desc_cmp <> 0 then desc_cmp

     

       157
       +
           else List.compare Waypoint.compare t1.rtepts t2.rtepts

     

       158
       +
       

     

       159
       +
       (** Test route equality *)

     

       160
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       161
       +
       

     

       162
       +
       (** Pretty print route *)

     

       163
       +
       let pp ppf t =

     

       164
       +
         match t.name with

     

       165
       +
         | Some name -> Format.fprintf ppf "\"%s\" (%d points)" name (point_count t)

     

       166
       +
         | None -> Format.fprintf ppf "(unnamed route, %d points)" (point_count t)

+125

lib/gpx/route.mli

···

       1
       +
       (** Route types and operations *)

     

       2
       +
       

     

       3
       +
       (** Route point is an alias for waypoint *)

     

       4
       +
       type point = Waypoint.t

     

       5
       +
       

     

       6
       +
       (** Main route type *)

     

       7
       +
       type t = {

     

       8
       +
         name : string option;

     

       9
       +
         cmt : string option;

     

       10
       +
         desc : string option;

     

       11
       +
         src : string option;

     

       12
       +
         links : Link.t list;

     

       13
       +
         number : int option;

     

       14
       +
         type_ : string option;

     

       15
       +
         extensions : Extension.t list;

     

       16
       +
         rtepts : point list;

     

       17
       +
       }

     

       18
       +
       

     

       19
       +
       (** {2 Route Constructors} *)

     

       20
       +
       

     

       21
       +
       (** Create empty route *)

     

       22
       +
       val empty : t

     

       23
       +
       

     

       24
       +
       (** Create route with name *)

     

       25
       +
       val make : name:string -> t

     

       26
       +
       

     

       27
       +
       (** Create route from coordinate list.

     

       28
       +
           @param name Route name

     

       29
       +
           @param coords List of (latitude, longitude) pairs

     

       30
       +
           @raises Invalid_argument on invalid coordinates *)

     

       31
       +
       val make_from_coords : name:string -> (float * float) list -> t

     

       32
       +
       

     

       33
       +
       (** {2 Route Properties} *)

     

       34
       +
       

     

       35
       +
       (** Get route name *)

     

       36
       +
       val name : t -> string option

     

       37
       +
       

     

       38
       +
       (** Get route description *)

     

       39
       +
       val description : t -> string option

     

       40
       +
       

     

       41
       +
       (** Get route number *)

     

       42
       +
       val number : t -> int option

     

       43
       +
       

     

       44
       +
       (** Get route comment *)

     

       45
       +
       val comment : t -> string option

     

       46
       +
       

     

       47
       +
       (** Get route source *)

     

       48
       +
       val source : t -> string option

     

       49
       +
       

     

       50
       +
       (** Get route links *)

     

       51
       +
       val links : t -> Link.t list

     

       52
       +
       

     

       53
       +
       (** Get route type *)

     

       54
       +
       val type_ : t -> string option

     

       55
       +
       

     

       56
       +
       (** Get route extensions *)

     

       57
       +
       val extensions : t -> Extension.t list

     

       58
       +
       

     

       59
       +
       (** Get route points *)

     

       60
       +
       val points : t -> point list

     

       61
       +
       

     

       62
       +
       (** Get route point count *)

     

       63
       +
       val point_count : t -> int

     

       64
       +
       

     

       65
       +
       (** Check if route is empty *)

     

       66
       +
       val is_empty : t -> bool

     

       67
       +
       

     

       68
       +
       (** {2 Route Modification} *)

     

       69
       +
       

     

       70
       +
       (** Clear all points *)

     

       71
       +
       val clear_points : t -> t

     

       72
       +
       

     

       73
       +
       (** {2 Route Analysis} *)

     

       74
       +
       

     

       75
       +
       (** Extract coordinates from route *)

     

       76
       +
       val to_coords : t -> (float * float) list

     

       77
       +
       

     

       78
       +
       (** Calculate total distance between consecutive points in meters *)

     

       79
       +
       val total_distance : t -> float

     

       80
       +
       

     

       81
       +
       (** Get first point *)

     

       82
       +
       val first_point : t -> point option

     

       83
       +
       

     

       84
       +
       (** Get last point *)

     

       85
       +
       val last_point : t -> point option

     

       86
       +
       

     

       87
       +
       (** {2 Functional Operations} *)

     

       88
       +
       

     

       89
       +
       (** Update name *)

     

       90
       +
       val with_name : t -> string -> t

     

       91
       +
       

     

       92
       +
       (** Update comment *)

     

       93
       +
       val with_comment : t -> string -> t

     

       94
       +
       

     

       95
       +
       (** Update description *)

     

       96
       +
       val with_description : t -> string -> t

     

       97
       +
       

     

       98
       +
       (** Update source *)

     

       99
       +
       val with_source : t -> string -> t

     

       100
       +
       

     

       101
       +
       (** Update number *)

     

       102
       +
       val with_number : t -> int -> t

     

       103
       +
       

     

       104
       +
       (** Update type *)

     

       105
       +
       val with_type : t -> string -> t

     

       106
       +
       

     

       107
       +
       (** Add point *)

     

       108
       +
       val add_point : t -> point -> t

     

       109
       +
       

     

       110
       +
       (** Add link *)

     

       111
       +
       val add_link : t -> Link.t -> t

     

       112
       +
       

     

       113
       +
       (** Add extensions *)

     

       114
       +
       val add_extensions : t -> Extension.t list -> t

     

       115
       +
       

     

       116
       +
       (** {2 Comparison and Utilities} *)

     

       117
       +
       

     

       118
       +
       (** Compare routes *)

     

       119
       +
       val compare : t -> t -> int

     

       120
       +
       

     

       121
       +
       (** Test route equality *)

     

       122
       +
       val equal : t -> t -> bool

     

       123
       +
       

     

       124
       +
       (** Pretty print route *)

     

       125
       +
       val pp : Format.formatter -> t -> unit

+226

lib/gpx/track.ml

···

       1
       +
       (** Track types and operations *)

     

       2
       +
       

     

       3
       +
       (** Track point is an alias for waypoint *)

     

       4
       +
       type point = Waypoint.t

     

       5
       +
       

     

       6
       +
       (** Track segment *)

     

       7
       +
       type segment = {

     

       8
       +
         trkpts : point list;

     

       9
       +
         extensions : Extension.t list;

     

       10
       +
       }

     

       11
       +
       

     

       12
       +
       (** Main track type *)

     

       13
       +
       type t = {

     

       14
       +
         name : string option;

     

       15
       +
         cmt : string option;

     

       16
       +
         desc : string option;

     

       17
       +
         src : string option;

     

       18
       +
         links : Link.t list;

     

       19
       +
         number : int option;

     

       20
       +
         type_ : string option;

     

       21
       +
         extensions : Extension.t list;

     

       22
       +
         trksegs : segment list;

     

       23
       +
       }

     

       24
       +
       

     

       25
       +
       (** {2 Track Segment Operations} *)

     

       26
       +
       

     

       27
       +
       module Segment = struct

     

       28
       +
         type t = segment

     

       29
       +
       

     

       30
       +
         (** Create empty segment *)

     

       31
       +
         let empty = { trkpts = []; extensions = [] }

     

       32
       +
       

     

       33
       +
         (** Create segment with points *)

     

       34
       +
         let make points = { trkpts = points; extensions = [] }

     

       35
       +
       

     

       36
       +
         (** Create segment from coordinates *)

     

       37
       +
         let make_from_coords coords =

     

       38
       +
           let make_trkpt (lat_f, lon_f) =

     

       39
       +
             match Waypoint.make_from_floats ~lat:lat_f ~lon:lon_f () with

     

       40
       +
             | Ok wpt -> wpt

     

       41
       +
             | Error e -> invalid_arg e

     

       42
       +
           in

     

       43
       +
           let trkpts = List.map make_trkpt coords in

     

       44
       +
           { trkpts; extensions = [] }

     

       45
       +
       

     

       46
       +
         (** Get points *)

     

       47
       +
         let points t = t.trkpts

     

       48
       +
       

     

       49
       +
         (** Get point count *)

     

       50
       +
         let point_count t = List.length t.trkpts

     

       51
       +
       

     

       52
       +
         (** Get extensions *)

     

       53
       +
         let extensions (seg : segment) = seg.extensions

     

       54
       +
       

     

       55
       +
         (** Add point *)

     

       56
       +
         let add_point t point = { t with trkpts = t.trkpts @ [point] }

     

       57
       +
       

     

       58
       +
         (** Add points *)

     

       59
       +
         let add_points t points = { t with trkpts = t.trkpts @ points }

     

       60
       +
       

     

       61
       +
         (** Extract coordinates *)

     

       62
       +
         let to_coords t = List.map Waypoint.to_floats t.trkpts

     

       63
       +
       

     

       64
       +
         (** Calculate segment distance *)

     

       65
       +
         let distance t = Route.total_distance { Route.empty with rtepts = t.trkpts }

     

       66
       +
       

     

       67
       +
         (** Check if empty *)

     

       68
       +
         let is_empty t = List.length t.trkpts = 0

     

       69
       +
       

     

       70
       +
         (** First point *)

     

       71
       +
         let first_point t = 

     

       72
       +
           match t.trkpts with

     

       73
       +
           | [] -> None

     

       74
       +
           | p :: _ -> Some p

     

       75
       +
       

     

       76
       +
         (** Last point *)

     

       77
       +
         let last_point t =

     

       78
       +
           match List.rev t.trkpts with

     

       79
       +
           | [] -> None

     

       80
       +
           | p :: _ -> Some p

     

       81
       +
       

     

       82
       +
         (** Compare segments *)

     

       83
       +
         let compare t1 t2 = List.compare Waypoint.compare t1.trkpts t2.trkpts

     

       84
       +
       

     

       85
       +
         (** Test segment equality *)

     

       86
       +
         let equal t1 t2 = compare t1 t2 = 0

     

       87
       +
       

     

       88
       +
         (** Pretty print segment *)

     

       89
       +
         let pp ppf t = Format.fprintf ppf "segment (%d points)" (point_count t)

     

       90
       +
       end

     

       91
       +
       

     

       92
       +
       (** {2 Track Operations} *)

     

       93
       +
       

     

       94
       +
       (** Create empty track *)

     

       95
       +
       let empty = {

     

       96
       +
         name = None; cmt = None; desc = None; src = None;

     

       97
       +
         links = []; number = None; type_ = None; extensions = [];

     

       98
       +
         trksegs = [];

     

       99
       +
       }

     

       100
       +
       

     

       101
       +
       (** Create track with name *)

     

       102
       +
       let make ~name = { empty with name = Some name }

     

       103
       +
       

     

       104
       +
       (** Create track from coordinate list (single segment) *)

     

       105
       +
       let make_from_coords ~name coords =

     

       106
       +
         let segment = Segment.make_from_coords coords in

     

       107
       +
         { empty with name = Some name; trksegs = [segment] }

     

       108
       +
       

     

       109
       +
       (** Get track name *)

     

       110
       +
       let name t = t.name

     

       111
       +
       

     

       112
       +
       (** Get track description *)

     

       113
       +
       let description t = t.desc

     

       114
       +
       

     

       115
       +
       (** Get track comment *)

     

       116
       +
       let comment t = t.cmt

     

       117
       +
       

     

       118
       +
       (** Get track source *)

     

       119
       +
       let source t = t.src

     

       120
       +
       

     

       121
       +
       (** Get track links *)

     

       122
       +
       let links t = t.links

     

       123
       +
       

     

       124
       +
       (** Get track number *)

     

       125
       +
       let number t = t.number

     

       126
       +
       

     

       127
       +
       (** Get track type *)

     

       128
       +
       let type_ t = t.type_

     

       129
       +
       

     

       130
       +
       (** Get track extensions *)

     

       131
       +
       let extensions t = t.extensions

     

       132
       +
       

     

       133
       +
       (** Get track segments *)

     

       134
       +
       let segments t = t.trksegs

     

       135
       +
       

     

       136
       +
       (** Get segment count *)

     

       137
       +
       let segment_count t = List.length t.trksegs

     

       138
       +
       

     

       139
       +
       (** Get total point count across all segments *)

     

       140
       +
       let point_count t = 

     

       141
       +
         List.fold_left (fun acc seg -> acc + Segment.point_count seg) 0 t.trksegs

     

       142
       +
       

     

       143
       +
       

     

       144
       +
       (** Clear all segments *)

     

       145
       +
       let clear_segments t = { t with trksegs = [] }

     

       146
       +
       

     

       147
       +
       (** Extract all coordinates from track *)

     

       148
       +
       let to_coords t =

     

       149
       +
         List.fold_left (fun acc seg ->

     

       150
       +
           List.fold_left (fun acc trkpt ->

     

       151
       +
             Waypoint.to_floats trkpt :: acc

     

       152
       +
           ) acc seg.trkpts

     

       153
       +
         ) [] t.trksegs

     

       154
       +
         |> List.rev

     

       155
       +
       

     

       156
       +
       (** Calculate total track distance across all segments *)

     

       157
       +
       let total_distance t =

     

       158
       +
         List.fold_left (fun acc seg -> acc +. Segment.distance seg) 0.0 t.trksegs

     

       159
       +
       

     

       160
       +
       (** Check if track is empty *)

     

       161
       +
       let is_empty t = List.length t.trksegs = 0

     

       162
       +
       

     

       163
       +
       (** Get all points from all segments *)

     

       164
       +
       let all_points t =

     

       165
       +
         List.fold_left (fun acc seg -> acc @ seg.trkpts) [] t.trksegs

     

       166
       +
       

     

       167
       +
       (** Get first point from first segment *)

     

       168
       +
       let first_point t =

     

       169
       +
         match t.trksegs with

     

       170
       +
         | [] -> None

     

       171
       +
         | seg :: _ -> Segment.first_point seg

     

       172
       +
       

     

       173
       +
       (** Get last point from last segment *)

     

       174
       +
       let last_point t =

     

       175
       +
         match List.rev t.trksegs with

     

       176
       +
         | [] -> None

     

       177
       +
         | seg :: _ -> Segment.last_point seg

     

       178
       +
       

     

       179
       +
       (** Compare tracks *)

     

       180
       +
       let compare t1 t2 =

     

       181
       +
         let name_cmp = Option.compare String.compare t1.name t2.name in

     

       182
       +
         if name_cmp <> 0 then name_cmp

     

       183
       +
         else

     

       184
       +
           let desc_cmp = Option.compare String.compare t1.desc t2.desc in

     

       185
       +
           if desc_cmp <> 0 then desc_cmp

     

       186
       +
           else List.compare Segment.compare t1.trksegs t2.trksegs

     

       187
       +
       

     

       188
       +
       (** Test track equality *)

     

       189
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       190
       +
       

     

       191
       +
       (** {2 Functional Operations} *)

     

       192
       +
       

     

       193
       +
       (** Update name *)

     

       194
       +
       let with_name t name = { t with name = Some name }

     

       195
       +
       

     

       196
       +
       (** Update comment *)

     

       197
       +
       let with_comment t cmt = { t with cmt = Some cmt }

     

       198
       +
       

     

       199
       +
       (** Update description *)

     

       200
       +
       let with_description t desc = { t with desc = Some desc }

     

       201
       +
       

     

       202
       +
       (** Update source *)

     

       203
       +
       let with_source t src = { t with src = Some src }

     

       204
       +
       

     

       205
       +
       (** Update number *)

     

       206
       +
       let with_number t number = { t with number = Some number }

     

       207
       +
       

     

       208
       +
       (** Update type *)

     

       209
       +
       let with_type t type_ = { t with type_ = Some type_ }

     

       210
       +
       

     

       211
       +
       (** Add segment *)

     

       212
       +
       let add_segment t trkseg = { t with trksegs = t.trksegs @ [trkseg] }

     

       213
       +
       

     

       214
       +
       (** Add link *)

     

       215
       +
       let add_link t link = { t with links = t.links @ [link] }

     

       216
       +
       

     

       217
       +
       (** Add extensions *)

     

       218
       +
       let add_extensions t extensions = { t with extensions = t.extensions @ extensions }

     

       219
       +
       

     

       220
       +
       (** Pretty print track *)

     

       221
       +
       let pp ppf t =

     

       222
       +
         match t.name with

     

       223
       +
         | Some name -> Format.fprintf ppf "\"%s\" (%d segments, %d points)" 

     

       224
       +
                          name (segment_count t) (point_count t)

     

       225
       +
         | None -> Format.fprintf ppf "(unnamed track, %d segments, %d points)" 

     

       226
       +
                     (segment_count t) (point_count t)

+192

lib/gpx/track.mli

···

       1
       +
       (** Track types and operations *)

     

       2
       +
       

     

       3
       +
       (** Track point is an alias for waypoint *)

     

       4
       +
       type point = Waypoint.t

     

       5
       +
       

     

       6
       +
       (** Track segment *)

     

       7
       +
       type segment = {

     

       8
       +
         trkpts : point list;

     

       9
       +
         extensions : Extension.t list;

     

       10
       +
       }

     

       11
       +
       

     

       12
       +
       (** Main track type *)

     

       13
       +
       type t = {

     

       14
       +
         name : string option;

     

       15
       +
         cmt : string option;

     

       16
       +
         desc : string option;

     

       17
       +
         src : string option;

     

       18
       +
         links : Link.t list;

     

       19
       +
         number : int option;

     

       20
       +
         type_ : string option;

     

       21
       +
         extensions : Extension.t list;

     

       22
       +
         trksegs : segment list;

     

       23
       +
       }

     

       24
       +
       

     

       25
       +
       (** {2 Track Segment Operations} *)

     

       26
       +
       

     

       27
       +
       module Segment : sig

     

       28
       +
         type t = segment

     

       29
       +
       

     

       30
       +
         (** Create empty segment *)

     

       31
       +
         val empty : t

     

       32
       +
       

     

       33
       +
         (** Create segment with points *)

     

       34
       +
         val make : point list -> t

     

       35
       +
       

     

       36
       +
         (** Create segment from coordinate list.

     

       37
       +
             @raises Invalid_argument on invalid coordinates *)

     

       38
       +
         val make_from_coords : (float * float) list -> t

     

       39
       +
       

     

       40
       +
         (** Get points *)

     

       41
       +
         val points : t -> point list

     

       42
       +
       

     

       43
       +
         (** Get point count *)

     

       44
       +
         val point_count : t -> int

     

       45
       +
       

     

       46
       +
         (** Get extensions *)

     

       47
       +
         val extensions : t -> Extension.t list

     

       48
       +
       

     

       49
       +
         (** Add point *)

     

       50
       +
         val add_point : t -> point -> t

     

       51
       +
       

     

       52
       +
         (** Add points *)

     

       53
       +
         val add_points : t -> point list -> t

     

       54
       +
       

     

       55
       +
         (** Extract coordinates *)

     

       56
       +
         val to_coords : t -> (float * float) list

     

       57
       +
       

     

       58
       +
         (** Calculate segment distance in meters *)

     

       59
       +
         val distance : t -> float

     

       60
       +
       

     

       61
       +
         (** Check if empty *)

     

       62
       +
         val is_empty : t -> bool

     

       63
       +
       

     

       64
       +
         (** First point *)

     

       65
       +
         val first_point : t -> point option

     

       66
       +
       

     

       67
       +
         (** Last point *)

     

       68
       +
         val last_point : t -> point option

     

       69
       +
       

     

       70
       +
         (** Compare segments *)

     

       71
       +
         val compare : t -> t -> int

     

       72
       +
       

     

       73
       +
         (** Test segment equality *)

     

       74
       +
         val equal : t -> t -> bool

     

       75
       +
       

     

       76
       +
         (** Pretty print segment *)

     

       77
       +
         val pp : Format.formatter -> t -> unit

     

       78
       +
       end

     

       79
       +
       

     

       80
       +
       (** {2 Track Constructors} *)

     

       81
       +
       

     

       82
       +
       (** Create empty track *)

     

       83
       +
       val empty : t

     

       84
       +
       

     

       85
       +
       (** Create track with name *)

     

       86
       +
       val make : name:string -> t

     

       87
       +
       

     

       88
       +
       (** Create track from coordinate list (single segment).

     

       89
       +
           @param name Track name

     

       90
       +
           @param coords List of (latitude, longitude) pairs

     

       91
       +
           @raises Failure on invalid coordinates *)

     

       92
       +
       val make_from_coords : name:string -> (float * float) list -> t

     

       93
       +
       

     

       94
       +
       (** {2 Track Properties} *)

     

       95
       +
       

     

       96
       +
       (** Get track name *)

     

       97
       +
       val name : t -> string option

     

       98
       +
       

     

       99
       +
       (** Get track description *)

     

       100
       +
       val description : t -> string option

     

       101
       +
       

     

       102
       +
       (** Get track comment *)

     

       103
       +
       val comment : t -> string option

     

       104
       +
       

     

       105
       +
       (** Get track source *)

     

       106
       +
       val source : t -> string option

     

       107
       +
       

     

       108
       +
       (** Get track links *)

     

       109
       +
       val links : t -> Link.t list

     

       110
       +
       

     

       111
       +
       (** Get track number *)

     

       112
       +
       val number : t -> int option

     

       113
       +
       

     

       114
       +
       (** Get track type *)

     

       115
       +
       val type_ : t -> string option

     

       116
       +
       

     

       117
       +
       (** Get track extensions *)

     

       118
       +
       val extensions : t -> Extension.t list

     

       119
       +
       

     

       120
       +
       (** Get track segments *)

     

       121
       +
       val segments : t -> segment list

     

       122
       +
       

     

       123
       +
       (** Get segment count *)

     

       124
       +
       val segment_count : t -> int

     

       125
       +
       

     

       126
       +
       (** Get total point count across all segments *)

     

       127
       +
       val point_count : t -> int

     

       128
       +
       

     

       129
       +
       (** Check if track is empty *)

     

       130
       +
       val is_empty : t -> bool

     

       131
       +
       

     

       132
       +
       (** {2 Track Modification} *)

     

       133
       +
       

     

       134
       +
       (** Clear all segments *)

     

       135
       +
       val clear_segments : t -> t

     

       136
       +
       

     

       137
       +
       (** {2 Track Analysis} *)

     

       138
       +
       

     

       139
       +
       (** Extract all coordinates from track *)

     

       140
       +
       val to_coords : t -> (float * float) list

     

       141
       +
       

     

       142
       +
       (** Calculate total track distance across all segments in meters *)

     

       143
       +
       val total_distance : t -> float

     

       144
       +
       

     

       145
       +
       (** Get all points from all segments *)

     

       146
       +
       val all_points : t -> point list

     

       147
       +
       

     

       148
       +
       (** Get first point from first segment *)

     

       149
       +
       val first_point : t -> point option

     

       150
       +
       

     

       151
       +
       (** Get last point from last segment *)

     

       152
       +
       val last_point : t -> point option

     

       153
       +
       

     

       154
       +
       (** {2 Comparison and Utilities} *)

     

       155
       +
       

     

       156
       +
       (** Compare tracks *)

     

       157
       +
       val compare : t -> t -> int

     

       158
       +
       

     

       159
       +
       (** Test track equality *)

     

       160
       +
       val equal : t -> t -> bool

     

       161
       +
       

     

       162
       +
       (** {2 Functional Operations} *)

     

       163
       +
       

     

       164
       +
       (** Update name *)

     

       165
       +
       val with_name : t -> string -> t

     

       166
       +
       

     

       167
       +
       (** Update comment *)

     

       168
       +
       val with_comment : t -> string -> t

     

       169
       +
       

     

       170
       +
       (** Update description *)

     

       171
       +
       val with_description : t -> string -> t

     

       172
       +
       

     

       173
       +
       (** Update source *)

     

       174
       +
       val with_source : t -> string -> t

     

       175
       +
       

     

       176
       +
       (** Update number *)

     

       177
       +
       val with_number : t -> int -> t

     

       178
       +
       

     

       179
       +
       (** Update type *)

     

       180
       +
       val with_type : t -> string -> t

     

       181
       +
       

     

       182
       +
       (** Add segment *)

     

       183
       +
       val add_segment : t -> Segment.t -> t

     

       184
       +
       

     

       185
       +
       (** Add link *)

     

       186
       +
       val add_link : t -> Link.t -> t

     

       187
       +
       

     

       188
       +
       (** Add extensions *)

     

       189
       +
       val add_extensions : t -> Extension.t list -> t

     

       190
       +
       

     

       191
       +
       (** Pretty print track *)

     

       192
       +
       val pp : Format.formatter -> t -> unit

-228

lib/gpx/types.ml

···

       1
       -
       (** Core GPX types matching the GPX 1.1 XSD schema *)

     

       2
       -
       

     

       3
       -
       [@@@warning "-30"]

     

       4
       -
       

     

       5
       -
       (** Geographic coordinates with validation constraints *)

     

       6
       -
       type latitude = private float

     

       7
       -
       type longitude = private float  

     

       8
       -
       type degrees = private float

     

       9
       -
       

     

       10
       -
       (** Smart constructors for validated coordinates *)

     

       11
       -
       let latitude f =

     

       12
       -
         if f >= -90.0 && f <= 90.0 then Ok (Obj.magic f : latitude)

     

       13
       -
         else Error (Printf.sprintf "Invalid latitude: %f (must be between -90.0 and 90.0)" f)

     

       14
       -
       

     

       15
       -
       let longitude f =

     

       16
       -
         if f >= -180.0 && f < 180.0 then Ok (Obj.magic f : longitude)

     

       17
       -
         else Error (Printf.sprintf "Invalid longitude: %f (must be between -180.0 and 180.0)" f)

     

       18
       -
       

     

       19
       -
       let degrees f =

     

       20
       -
         if f >= 0.0 && f < 360.0 then Ok (Obj.magic f : degrees)

     

       21
       -
         else Error (Printf.sprintf "Invalid degrees: %f (must be between 0.0 and 360.0)" f)

     

       22
       -
       

     

       23
       -
       (** Convert back to float *)

     

       24
       -
       let latitude_to_float (lat : latitude) = (lat :> float)

     

       25
       -
       let longitude_to_float (lon : longitude) = (lon :> float)

     

       26
       -
       let degrees_to_float (deg : degrees) = (deg :> float)

     

       27
       -
       

     

       28
       -
       (** GPS fix types as defined in GPX spec *)

     

       29
       -
       type fix_type = 

     

       30
       -
         | None_fix

     

       31
       -
         | Fix_2d

     

       32
       -
         | Fix_3d

     

       33
       -
         | Dgps

     

       34
       -
         | Pps

     

       35
       -
       

     

       36
       -
       (** Person information *)

     

       37
       -
       type person = {

     

       38
       -
         name : string option;

     

       39
       -
         email : string option;

     

       40
       -
         link : link option;

     

       41
       -
       }

     

       42
       -
       

     

       43
       -
       (** Link information *)

     

       44
       -
       and link = {

     

       45
       -
         href : string;

     

       46
       -
         text : string option;

     

       47
       -
         type_ : string option;

     

       48
       -
       }

     

       49
       -
       

     

       50
       -
       (** Copyright information *)

     

       51
       -
       type copyright = {

     

       52
       -
         author : string;

     

       53
       -
         year : int option;

     

       54
       -
         license : string option;

     

       55
       -
       }

     

       56
       -
       

     

       57
       -
       (** Bounding box *)

     

       58
       -
       type bounds = {

     

       59
       -
         minlat : latitude;

     

       60
       -
         minlon : longitude;

     

       61
       -
         maxlat : latitude;

     

       62
       -
         maxlon : longitude;

     

       63
       -
       }

     

       64
       -
       

     

       65
       -
       (** Metadata container *)

     

       66
       -
       type metadata = {

     

       67
       -
         name : string option;

     

       68
       -
         desc : string option;

     

       69
       -
         author : person option;

     

       70
       -
         copyright : copyright option;

     

       71
       -
         links : link list;

     

       72
       -
         time : Ptime.t option;

     

       73
       -
         keywords : string option;

     

       74
       -
         bounds : bounds option;

     

       75
       -
         extensions : extension list;

     

       76
       -
       }

     

       77
       -
       

     

       78
       -
       (** Extension mechanism for custom elements *)

     

       79
       -
       and extension = {

     

       80
       -
         namespace : string option;

     

       81
       -
         name : string;

     

       82
       -
         attributes : (string * string) list;

     

       83
       -
         content : extension_content;

     

       84
       -
       }

     

       85
       -
       

     

       86
       -
       and extension_content =

     

       87
       -
         | Text of string

     

       88
       -
         | Elements of extension list

     

       89
       -
         | Mixed of string * extension list

     

       90
       -
       

     

       91
       -
       (** Base waypoint data shared by wpt, rtept, trkpt *)

     

       92
       -
       type waypoint_data = {

     

       93
       -
         lat : latitude;

     

       94
       -
         lon : longitude;

     

       95
       -
         ele : float option;

     

       96
       -
         time : Ptime.t option;

     

       97
       -
         magvar : degrees option;

     

       98
       -
         geoidheight : float option;

     

       99
       -
         name : string option;

     

       100
       -
         cmt : string option;

     

       101
       -
         desc : string option;

     

       102
       -
         src : string option;

     

       103
       -
         links : link list;

     

       104
       -
         sym : string option;

     

       105
       -
         type_ : string option;

     

       106
       -
         fix : fix_type option;

     

       107
       -
         sat : int option;

     

       108
       -
         hdop : float option;

     

       109
       -
         vdop : float option;

     

       110
       -
         pdop : float option;

     

       111
       -
         ageofdgpsdata : float option;

     

       112
       -
         dgpsid : int option;

     

       113
       -
         extensions : extension list;

     

       114
       -
       }

     

       115
       -
       

     

       116
       -
       (** Waypoint *)

     

       117
       -
       type waypoint = waypoint_data

     

       118
       -
       

     

       119
       -
       (** Route point *)

     

       120
       -
       type route_point = waypoint_data

     

       121
       -
       

     

       122
       -
       (** Track point *)

     

       123
       -
       type track_point = waypoint_data

     

       124
       -
       

     

       125
       -
       (** Route definition *)

     

       126
       -
       type route = {

     

       127
       -
         name : string option;

     

       128
       -
         cmt : string option;

     

       129
       -
         desc : string option;

     

       130
       -
         src : string option;

     

       131
       -
         links : link list;

     

       132
       -
         number : int option;

     

       133
       -
         type_ : string option;

     

       134
       -
         extensions : extension list;

     

       135
       -
         rtepts : route_point list;

     

       136
       -
       }

     

       137
       -
       

     

       138
       -
       (** Track segment *)

     

       139
       -
       type track_segment = {

     

       140
       -
         trkpts : track_point list;

     

       141
       -
         extensions : extension list;

     

       142
       -
       }

     

       143
       -
       

     

       144
       -
       (** Track definition *)

     

       145
       -
       type track = {

     

       146
       -
         name : string option;

     

       147
       -
         cmt : string option;

     

       148
       -
         desc : string option;

     

       149
       -
         src : string option;

     

       150
       -
         links : link list;

     

       151
       -
         number : int option;

     

       152
       -
         type_ : string option;

     

       153
       -
         extensions : extension list;

     

       154
       -
         trksegs : track_segment list;

     

       155
       -
       }

     

       156
       -
       

     

       157
       -
       (** Main GPX document *)

     

       158
       -
       type gpx = {

     

       159
       -
         version : string; (* GPX version: "1.0" or "1.1" *)

     

       160
       -
         creator : string;

     

       161
       -
         metadata : metadata option;

     

       162
       -
         waypoints : waypoint list;

     

       163
       -
         routes : route list;

     

       164
       -
         tracks : track list;

     

       165
       -
         extensions : extension list;

     

       166
       -
       }

     

       167
       -
       

     

       168
       -
       (** Parser/Writer errors *)

     

       169
       -
       type error =

     

       170
       -
         | Invalid_xml of string

     

       171
       -
         | Invalid_coordinate of string

     

       172
       -
         | Missing_required_attribute of string * string

     

       173
       -
         | Missing_required_element of string

     

       174
       -
         | Validation_error of string

     

       175
       -
         | Xml_error of string

     

       176
       -
         | IO_error of string

     

       177
       -
       

     

       178
       -
       exception Gpx_error of error

     

       179
       -
       

     

       180
       -
       (** Result type for operations that can fail *)

     

       181
       -
       type 'a result = ('a, error) Result.t

     

       182
       -
       

     

       183
       -
       (** Utility functions *)

     

       184
       -
       

     

       185
       -
       (** Convert fix_type to string *)

     

       186
       -
       let fix_type_to_string = function

     

       187
       -
         | None_fix -> "none"

     

       188
       -
         | Fix_2d -> "2d" 

     

       189
       -
         | Fix_3d -> "3d"

     

       190
       -
         | Dgps -> "dgps"

     

       191
       -
         | Pps -> "pps"

     

       192
       -
       

     

       193
       -
       (** Parse fix_type from string *)

     

       194
       -
       let fix_type_of_string = function

     

       195
       -
         | "none" -> Some None_fix

     

       196
       -
         | "2d" -> Some Fix_2d

     

       197
       -
         | "3d" -> Some Fix_3d

     

       198
       -
         | "dgps" -> Some Dgps

     

       199
       -
         | "pps" -> Some Pps

     

       200
       -
         | _ -> None

     

       201
       -
       

     

       202
       -
       (** Create empty waypoint_data with required coordinates *)

     

       203
       -
       let make_waypoint_data lat lon = {

     

       204
       -
         lat; lon;

     

       205
       -
         ele = None; time = None; magvar = None; geoidheight = None;

     

       206
       -
         name = None; cmt = None; desc = None; src = None; links = [];

     

       207
       -
         sym = None; type_ = None; fix = None; sat = None;

     

       208
       -
         hdop = None; vdop = None; pdop = None; ageofdgpsdata = None;

     

       209
       -
         dgpsid = None; extensions = [];

     

       210
       -
       }

     

       211
       -
       

     

       212
       -
       (** Create empty metadata *)

     

       213
       -
       let empty_metadata = {

     

       214
       -
         name = None; desc = None; author = None; copyright = None;

     

       215
       -
         links = []; time = None; keywords = None; bounds = None;

     

       216
       -
         extensions = [];

     

       217
       -
       }

     

       218
       -
       

     

       219
       -
       (** Create empty GPX document *)

     

       220
       -
       let make_gpx ~creator = {

     

       221
       -
         version = "1.1";

     

       222
       -
         creator;

     

       223
       -
         metadata = None;

     

       224
       -
         waypoints = [];

     

       225
       -
         routes = [];

     

       226
       -
         tracks = [];

     

       227
       -
         extensions = [];

     

       228
       -
       }

-190

lib/gpx/types.mli

···

       1
       -
       (** Core GPX types matching the GPX 1.1 XSD schema *)

     

       2
       -
       

     

       3
       -
       [@@@warning "-30"]

     

       4
       -
       

     

       5
       -
       (** Geographic coordinates with validation constraints *)

     

       6
       -
       type latitude = private float

     

       7
       -
       type longitude = private float

     

       8
       -
       type degrees = private float

     

       9
       -
       

     

       10
       -
       (** Smart constructors for validated coordinates *)

     

       11
       -
       val latitude : float -> (latitude, string) result

     

       12
       -
       val longitude : float -> (longitude, string) result

     

       13
       -
       val degrees : float -> (degrees, string) result

     

       14
       -
       

     

       15
       -
       (** Convert back to float *)

     

       16
       -
       val latitude_to_float : latitude -> float

     

       17
       -
       val longitude_to_float : longitude -> float

     

       18
       -
       val degrees_to_float : degrees -> float

     

       19
       -
       

     

       20
       -
       (** GPS fix types as defined in GPX spec *)

     

       21
       -
       type fix_type = 

     

       22
       -
         | None_fix

     

       23
       -
         | Fix_2d

     

       24
       -
         | Fix_3d

     

       25
       -
         | Dgps

     

       26
       -
         | Pps

     

       27
       -
       

     

       28
       -
       (** Person information *)

     

       29
       -
       type person = {

     

       30
       -
         name : string option;

     

       31
       -
         email : string option;

     

       32
       -
         link : link option;

     

       33
       -
       }

     

       34
       -
       

     

       35
       -
       (** Link information *)

     

       36
       -
       and link = {

     

       37
       -
         href : string;

     

       38
       -
         text : string option;

     

       39
       -
         type_ : string option;

     

       40
       -
       }

     

       41
       -
       

     

       42
       -
       (** Copyright information *)

     

       43
       -
       type copyright = {

     

       44
       -
         author : string;

     

       45
       -
         year : int option;

     

       46
       -
         license : string option;

     

       47
       -
       }

     

       48
       -
       

     

       49
       -
       (** Bounding box *)

     

       50
       -
       type bounds = {

     

       51
       -
         minlat : latitude;

     

       52
       -
         minlon : longitude;

     

       53
       -
         maxlat : latitude;

     

       54
       -
         maxlon : longitude;

     

       55
       -
       }

     

       56
       -
       

     

       57
       -
       (** Metadata container *)

     

       58
       -
       type metadata = {

     

       59
       -
         name : string option;

     

       60
       -
         desc : string option;

     

       61
       -
         author : person option;

     

       62
       -
         copyright : copyright option;

     

       63
       -
         links : link list;

     

       64
       -
         time : Ptime.t option;

     

       65
       -
         keywords : string option;

     

       66
       -
         bounds : bounds option;

     

       67
       -
         extensions : extension list;

     

       68
       -
       }

     

       69
       -
       

     

       70
       -
       (** Extension mechanism for custom elements *)

     

       71
       -
       and extension = {

     

       72
       -
         namespace : string option;

     

       73
       -
         name : string;

     

       74
       -
         attributes : (string * string) list;

     

       75
       -
         content : extension_content;

     

       76
       -
       }

     

       77
       -
       

     

       78
       -
       and extension_content =

     

       79
       -
         | Text of string

     

       80
       -
         | Elements of extension list

     

       81
       -
         | Mixed of string * extension list

     

       82
       -
       

     

       83
       -
       (** Base waypoint data shared by wpt, rtept, trkpt *)

     

       84
       -
       type waypoint_data = {

     

       85
       -
         lat : latitude;

     

       86
       -
         lon : longitude;

     

       87
       -
         ele : float option;

     

       88
       -
         time : Ptime.t option;

     

       89
       -
         magvar : degrees option;

     

       90
       -
         geoidheight : float option;

     

       91
       -
         name : string option;

     

       92
       -
         cmt : string option;

     

       93
       -
         desc : string option;

     

       94
       -
         src : string option;

     

       95
       -
         links : link list;

     

       96
       -
         sym : string option;

     

       97
       -
         type_ : string option;

     

       98
       -
         fix : fix_type option;

     

       99
       -
         sat : int option;

     

       100
       -
         hdop : float option;

     

       101
       -
         vdop : float option;

     

       102
       -
         pdop : float option;

     

       103
       -
         ageofdgpsdata : float option;

     

       104
       -
         dgpsid : int option;

     

       105
       -
         extensions : extension list;

     

       106
       -
       }

     

       107
       -
       

     

       108
       -
       (** Waypoint *)

     

       109
       -
       type waypoint = waypoint_data

     

       110
       -
       

     

       111
       -
       (** Route point *)

     

       112
       -
       type route_point = waypoint_data

     

       113
       -
       

     

       114
       -
       (** Track point *)

     

       115
       -
       type track_point = waypoint_data

     

       116
       -
       

     

       117
       -
       (** Route definition *)

     

       118
       -
       type route = {

     

       119
       -
         name : string option;

     

       120
       -
         cmt : string option;

     

       121
       -
         desc : string option;

     

       122
       -
         src : string option;

     

       123
       -
         links : link list;

     

       124
       -
         number : int option;

     

       125
       -
         type_ : string option;

     

       126
       -
         extensions : extension list;

     

       127
       -
         rtepts : route_point list;

     

       128
       -
       }

     

       129
       -
       

     

       130
       -
       (** Track segment *)

     

       131
       -
       type track_segment = {

     

       132
       -
         trkpts : track_point list;

     

       133
       -
         extensions : extension list;

     

       134
       -
       }

     

       135
       -
       

     

       136
       -
       (** Track definition *)

     

       137
       -
       type track = {

     

       138
       -
         name : string option;

     

       139
       -
         cmt : string option;

     

       140
       -
         desc : string option;

     

       141
       -
         src : string option;

     

       142
       -
         links : link list;

     

       143
       -
         number : int option;

     

       144
       -
         type_ : string option;

     

       145
       -
         extensions : extension list;

     

       146
       -
         trksegs : track_segment list;

     

       147
       -
       }

     

       148
       -
       

     

       149
       -
       (** Main GPX document *)

     

       150
       -
       type gpx = {

     

       151
       -
         version : string; (* Always "1.1" for this version *)

     

       152
       -
         creator : string;

     

       153
       -
         metadata : metadata option;

     

       154
       -
         waypoints : waypoint list;

     

       155
       -
         routes : route list;

     

       156
       -
         tracks : track list;

     

       157
       -
         extensions : extension list;

     

       158
       -
       }

     

       159
       -
       

     

       160
       -
       (** Parser/Writer errors *)

     

       161
       -
       type error =

     

       162
       -
         | Invalid_xml of string

     

       163
       -
         | Invalid_coordinate of string

     

       164
       -
         | Missing_required_attribute of string * string

     

       165
       -
         | Missing_required_element of string

     

       166
       -
         | Validation_error of string

     

       167
       -
         | Xml_error of string

     

       168
       -
         | IO_error of string

     

       169
       -
       

     

       170
       -
       exception Gpx_error of error

     

       171
       -
       

     

       172
       -
       (** Result type for operations that can fail *)

     

       173
       -
       type 'a result = ('a, error) Result.t

     

       174
       -
       

     

       175
       -
       (** Utility functions *)

     

       176
       -
       

     

       177
       -
       (** Convert fix_type to string *)

     

       178
       -
       val fix_type_to_string : fix_type -> string

     

       179
       -
       

     

       180
       -
       (** Parse fix_type from string *)

     

       181
       -
       val fix_type_of_string : string -> fix_type option

     

       182
       -
       

     

       183
       -
       (** Create empty waypoint_data with required coordinates *)

     

       184
       -
       val make_waypoint_data : latitude -> longitude -> waypoint_data

     

       185
       -
       

     

       186
       -
       (** Create empty metadata *)

     

       187
       -
       val empty_metadata : metadata

     

       188
       -
       

     

       189
       -
       (** Create empty GPX document *)

     

       190
       -
       val make_gpx : creator:string -> gpx

+40 -33

lib/gpx/validate.ml

···

       1
        
       (** GPX validation utilities *)

     

       2
        
       

     

       3
       -
       open Types

     

       4
       -
       

     

       5
        
       (** Validation error messages *)

     

       6
        
       type validation_issue = {

     

       7
        
         level : [`Error | `Warning];

     
···

       31
        
         let issues = ref [] in

     

       32
        
         

     

       33
        
         (* Check for negative satellite count *)

     

       34
       -
         (match wpt.sat with

     

       35
        
          | Some sat when sat < 0 ->

     

       36
        
            issues := make_warning ~location ("Negative satellite count: " ^ string_of_int sat) :: !issues

     

       37
        
          | _ -> ());

     
···

       46
        
           | _ -> ()

     

       47
        
         in

     

       48
        
         

     

       49
       -
         check_precision "hdop" wpt.hdop;

     

       50
       -
         check_precision "vdop" wpt.vdop;

     

       51
       -
         check_precision "pdop" wpt.pdop;

     

       52
        
         

     

       53
        
         (* Check elevation reasonableness *)

     

       54
       -
         (match wpt.ele with

     

       55
        
          | Some ele when ele < -15000.0 ->

     

       56
        
            issues := make_warning ~location (Printf.sprintf "Very low elevation: %.2f m" ele) :: !issues

     

       57
        
          | Some ele when ele > 15000.0 ->

     
···

       59
        
          | _ -> ());

     

       60
        
         

     

       61
        
         (* Check DGPS age *)

     

       62
       -
         (match wpt.ageofdgpsdata with

     

       63
        
          | Some age when age < 0.0 ->

     

       64
        
            issues := make_error ~location "Negative DGPS age" :: !issues

     

       65
        
          | _ -> ());

     
···

       71
        
         let issues = ref [] in

     

       72
        
         let location = "bounds" in

     

       73
        
         

     

       74
       -
         if latitude_to_float bounds.minlat >= latitude_to_float bounds.maxlat then

     

       0
        
       
     

       75
        
           issues := make_error ~location "minlat must be less than maxlat" :: !issues;

     

       76
        
         

     

       77
       -
         if longitude_to_float bounds.minlon >= longitude_to_float bounds.maxlon then

     

       78
        
           issues := make_error ~location "minlon must be less than maxlon" :: !issues;

     

       79
        
         

     

       80
        
         !issues

     
···

       84
        
         let issues = ref [] in

     

       85
        
         

     

       86
        
         (* Validate bounds if present *)

     

       87
       -
         (match metadata.bounds with

     

       88
        
          | Some bounds -> issues := validate_bounds bounds @ !issues

     

       89
        
          | None -> ());

     

       90
        
         

     

       91
        
         (* Check for reasonable copyright year *)

     

       92
       -
         (match metadata.copyright with

     

       93
        
          | Some copyright ->

     

       94
       -
            (match copyright.year with

     

       95
        
             | Some year when year < 1900 || year > 2100 ->

     

       96
        
               issues := make_warning ~location:"metadata.copyright" 

     

       97
        
                 (Printf.sprintf "Unusual copyright year: %d" year) :: !issues

     
···

       106
        
         let location = "route" in

     

       107
        
         

     

       108
        
         (* Check for empty route *)

     

       109
       -
         if route.rtepts = [] then

     

       0
        
       
     

       110
        
           issues := make_warning ~location "Route has no points" :: !issues;

     

       111
        
         

     

       112
        
         (* Validate route points *)

     

       113
        
         List.iteri (fun i rtept ->

     

       114
        
           let point_location = Printf.sprintf "route.rtept[%d]" i in

     

       115
        
           issues := validate_waypoint_data rtept point_location @ !issues

     

       116
       -
         ) route.rtepts;

     

       117
        
         

     

       118
        
         !issues

     

       119
        
       

     
···

       123
        
         let location = Printf.sprintf "track.trkseg[%d]" seg_idx in

     

       124
        
         

     

       125
        
         (* Check for empty segment *)

     

       126
       -
         if trkseg.trkpts = [] then

     

       0
        
       
     

       127
        
           issues := make_warning ~location "Track segment has no points" :: !issues;

     

       128
        
         

     

       129
        
         (* Validate track points *)

     

       130
        
         List.iteri (fun i trkpt ->

     

       131
        
           let point_location = Printf.sprintf "%s.trkpt[%d]" location i in

     

       132
        
           issues := validate_waypoint_data trkpt point_location @ !issues

     

       133
       -
         ) trkseg.trkpts;

     

       134
        
         

     

       135
        
         (* Check for time ordering if timestamps are present *)

     

       136
        
         let rec check_time_order prev_time = function

     

       137
        
           | [] -> ()

     

       138
        
           | trkpt :: rest ->

     

       139
       -
             (match (prev_time, trkpt.time) with

     

       140
        
              | (Some prev, Some curr) when Ptime.compare prev curr > 0 ->

     

       141
        
                issues := make_warning ~location "Track points not in chronological order" :: !issues

     

       142
        
              | _ -> ());

     

       143
       -
             check_time_order trkpt.time rest

     

       144
        
         in

     

       145
       -
         check_time_order None trkseg.trkpts;

     

       146
        
         

     

       147
        
         !issues

     

       148
        
       

     
···

       152
        
         let location = "track" in

     

       153
        
         

     

       154
        
         (* Check for empty track *)

     

       155
       -
         if track.trksegs = [] then

     

       0
        
       
     

       156
        
           issues := make_warning ~location "Track has no segments" :: !issues;

     

       157
        
         

     

       158
        
         (* Validate track segments *)

     

       159
        
         List.iteri (fun i trkseg ->

     

       160
        
           issues := validate_track_segment trkseg i @ !issues

     

       161
       -
         ) track.trksegs;

     

       162
        
         

     

       163
        
         !issues

     

       164
        
       

     
···

       167
        
         let issues = ref [] in

     

       168
        
         

     

       169
        
         (* Check GPX version *)

     

       170
       -
         if gpx.version <> "1.0" && gpx.version <> "1.1" then

     

       0
        
       
     

       171
        
           issues := make_error ~location:"gpx" 

     

       172
       -
             (Printf.sprintf "Unsupported GPX version: %s (supported: 1.0, 1.1)" gpx.version) :: !issues

     

       173
       -
         else if gpx.version = "1.0" then

     

       174
        
           issues := make_warning ~location:"gpx" 

     

       175
        
             "GPX 1.0 detected - consider upgrading to GPX 1.1 for better compatibility" :: !issues;

     

       176
        
         

     

       177
        
         (* Check for empty creator *)

     

       178
       -
         if String.trim gpx.creator = "" then

     

       0
        
       
     

       179
        
           issues := make_error ~location:"gpx" "Creator cannot be empty" :: !issues;

     

       180
        
         

     

       181
        
         (* Validate metadata *)

     

       182
       -
         (match gpx.metadata with

     

       183
        
          | Some metadata -> issues := validate_metadata metadata @ !issues

     

       184
        
          | None -> ());

     

       185
        
         

     

       186
        
         (* Validate waypoints *)

     

       0
        
       
     

       187
        
         List.iteri (fun i wpt ->

     

       188
        
           let location = Printf.sprintf "waypoint[%d]" i in

     

       189
        
           issues := validate_waypoint_data wpt location @ !issues

     

       190
       -
         ) gpx.waypoints;

     

       191
        
         

     

       192
        
         (* Validate routes *)

     

       0
        
       
     

       193
        
         List.iteri (fun _i route ->

     

       194
        
           issues := validate_route route @ !issues

     

       195
       -
         ) gpx.routes;

     

       196
        
         

     

       197
        
         (* Validate tracks *)

     

       0
        
       
     

       198
        
         List.iteri (fun _i track ->

     

       199
        
           issues := validate_track track @ !issues

     

       200
       -
         ) gpx.tracks;

     

       201
        
         

     

       202
        
         (* Check for completely empty GPX *)

     

       203
       -
         if gpx.waypoints = [] && gpx.routes = [] && gpx.tracks = [] then

     

       204
        
           issues := make_warning ~location:"gpx" "GPX document contains no geographic data" :: !issues;

     

       205
        
         

     

       206
        
         let all_issues = !issues in

     
···

       214
        
         result.is_valid

     

       215
        
       

     

       216
        
       (** Get only error messages *)

     

       217
       -
       let get_errors gpx =

     

       218
        
         let result = validate_gpx gpx in

     

       219
        
         List.filter (fun issue -> issue.level = `Error) result.issues

     

       220
        
       

     

       221
        
       (** Get only warning messages *)

     

       222
       -
       let get_warnings gpx =

     

       223
        
         let result = validate_gpx gpx in

     

       224
        
         List.filter (fun issue -> issue.level = `Warning) result.issues

     

       225

···

       1
        
       (** GPX validation utilities *)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (** Validation error messages *)

     

       4
        
       type validation_issue = {

     

       5
        
         level : [`Error | `Warning];

     
···

       29
        
         let issues = ref [] in

     

       30
        
         

     

       31
        
         (* Check for negative satellite count *)

     

       32
       +
         (match Waypoint.sat wpt with

     

       33
        
          | Some sat when sat < 0 ->

     

       34
        
            issues := make_warning ~location ("Negative satellite count: " ^ string_of_int sat) :: !issues

     

       35
        
          | _ -> ());

     
···

       44
        
           | _ -> ()

     

       45
        
         in

     

       46
        
         

     

       47
       +
         check_precision "hdop" (Waypoint.hdop wpt);

     

       48
       +
         check_precision "vdop" (Waypoint.vdop wpt);

     

       49
       +
         check_precision "pdop" (Waypoint.pdop wpt);

     

       50
        
         

     

       51
        
         (* Check elevation reasonableness *)

     

       52
       +
         (match Waypoint.elevation wpt with

     

       53
        
          | Some ele when ele < -15000.0 ->

     

       54
        
            issues := make_warning ~location (Printf.sprintf "Very low elevation: %.2f m" ele) :: !issues

     

       55
        
          | Some ele when ele > 15000.0 ->

     
···

       57
        
          | _ -> ());

     

       58
        
         

     

       59
        
         (* Check DGPS age *)

     

       60
       +
         (match Waypoint.ageofdgpsdata wpt with

     

       61
        
          | Some age when age < 0.0 ->

     

       62
        
            issues := make_error ~location "Negative DGPS age" :: !issues

     

       63
        
          | _ -> ());

     
···

       69
        
         let issues = ref [] in

     

       70
        
         let location = "bounds" in

     

       71
        
         

     

       72
       +
         let (minlat, minlon, maxlat, maxlon) = Metadata.Bounds.bounds bounds in

     

       73
       +
         if Coordinate.latitude_to_float minlat >= Coordinate.latitude_to_float maxlat then

     

       74
        
           issues := make_error ~location "minlat must be less than maxlat" :: !issues;

     

       75
        
         

     

       76
       +
         if Coordinate.longitude_to_float minlon >= Coordinate.longitude_to_float maxlon then

     

       77
        
           issues := make_error ~location "minlon must be less than maxlon" :: !issues;

     

       78
        
         

     

       79
        
         !issues

     
···

       83
        
         let issues = ref [] in

     

       84
        
         

     

       85
        
         (* Validate bounds if present *)

     

       86
       +
         (match Metadata.bounds_opt metadata with

     

       87
        
          | Some bounds -> issues := validate_bounds bounds @ !issues

     

       88
        
          | None -> ());

     

       89
        
         

     

       90
        
         (* Check for reasonable copyright year *)

     

       91
       +
         (match Metadata.copyright metadata with

     

       92
        
          | Some copyright ->

     

       93
       +
            (match Link.copyright_year copyright with

     

       94
        
             | Some year when year < 1900 || year > 2100 ->

     

       95
        
               issues := make_warning ~location:"metadata.copyright" 

     

       96
        
                 (Printf.sprintf "Unusual copyright year: %d" year) :: !issues

     
···

       105
        
         let location = "route" in

     

       106
        
         

     

       107
        
         (* Check for empty route *)

     

       108
       +
         let points = Route.points route in

     

       109
       +
         if points = [] then

     

       110
        
           issues := make_warning ~location "Route has no points" :: !issues;

     

       111
        
         

     

       112
        
         (* Validate route points *)

     

       113
        
         List.iteri (fun i rtept ->

     

       114
        
           let point_location = Printf.sprintf "route.rtept[%d]" i in

     

       115
        
           issues := validate_waypoint_data rtept point_location @ !issues

     

       116
       +
         ) points;

     

       117
        
         

     

       118
        
         !issues

     

       119
        
       

     
···

       123
        
         let location = Printf.sprintf "track.trkseg[%d]" seg_idx in

     

       124
        
         

     

       125
        
         (* Check for empty segment *)

     

       126
       +
         let points = Track.Segment.points trkseg in

     

       127
       +
         if points = [] then

     

       128
        
           issues := make_warning ~location "Track segment has no points" :: !issues;

     

       129
        
         

     

       130
        
         (* Validate track points *)

     

       131
        
         List.iteri (fun i trkpt ->

     

       132
        
           let point_location = Printf.sprintf "%s.trkpt[%d]" location i in

     

       133
        
           issues := validate_waypoint_data trkpt point_location @ !issues

     

       134
       +
         ) points;

     

       135
        
         

     

       136
        
         (* Check for time ordering if timestamps are present *)

     

       137
        
         let rec check_time_order prev_time = function

     

       138
        
           | [] -> ()

     

       139
        
           | trkpt :: rest ->

     

       140
       +
             (match (prev_time, Waypoint.time trkpt) with

     

       141
        
              | (Some prev, Some curr) when Ptime.compare prev curr > 0 ->

     

       142
        
                issues := make_warning ~location "Track points not in chronological order" :: !issues

     

       143
        
              | _ -> ());

     

       144
       +
             check_time_order (Waypoint.time trkpt) rest

     

       145
        
         in

     

       146
       +
         check_time_order None points;

     

       147
        
         

     

       148
        
         !issues

     

       149
        
       

     
···

       153
        
         let location = "track" in

     

       154
        
         

     

       155
        
         (* Check for empty track *)

     

       156
       +
         let segments = Track.segments track in

     

       157
       +
         if segments = [] then

     

       158
        
           issues := make_warning ~location "Track has no segments" :: !issues;

     

       159
        
         

     

       160
        
         (* Validate track segments *)

     

       161
        
         List.iteri (fun i trkseg ->

     

       162
        
           issues := validate_track_segment trkseg i @ !issues

     

       163
       +
         ) segments;

     

       164
        
         

     

       165
        
         !issues

     

       166
        
       

     
···

       169
        
         let issues = ref [] in

     

       170
        
         

     

       171
        
         (* Check GPX version *)

     

       172
       +
         let version = Doc.version gpx in

     

       173
       +
         if version <> "1.0" && version <> "1.1" then

     

       174
        
           issues := make_error ~location:"gpx" 

     

       175
       +
             (Printf.sprintf "Unsupported GPX version: %s (supported: 1.0, 1.1)" version) :: !issues

     

       176
       +
         else if version = "1.0" then

     

       177
        
           issues := make_warning ~location:"gpx" 

     

       178
        
             "GPX 1.0 detected - consider upgrading to GPX 1.1 for better compatibility" :: !issues;

     

       179
        
         

     

       180
        
         (* Check for empty creator *)

     

       181
       +
         let creator = Doc.creator gpx in

     

       182
       +
         if String.trim creator = "" then

     

       183
        
           issues := make_error ~location:"gpx" "Creator cannot be empty" :: !issues;

     

       184
        
         

     

       185
        
         (* Validate metadata *)

     

       186
       +
         (match Doc.metadata gpx with

     

       187
        
          | Some metadata -> issues := validate_metadata metadata @ !issues

     

       188
        
          | None -> ());

     

       189
        
         

     

       190
        
         (* Validate waypoints *)

     

       191
       +
         let waypoints = Doc.waypoints gpx in

     

       192
        
         List.iteri (fun i wpt ->

     

       193
        
           let location = Printf.sprintf "waypoint[%d]" i in

     

       194
        
           issues := validate_waypoint_data wpt location @ !issues

     

       195
       +
         ) waypoints;

     

       196
        
         

     

       197
        
         (* Validate routes *)

     

       198
       +
         let routes = Doc.routes gpx in

     

       199
        
         List.iteri (fun _i route ->

     

       200
        
           issues := validate_route route @ !issues

     

       201
       +
         ) routes;

     

       202
        
         

     

       203
        
         (* Validate tracks *)

     

       204
       +
         let tracks = Doc.tracks gpx in

     

       205
        
         List.iteri (fun _i track ->

     

       206
        
           issues := validate_track track @ !issues

     

       207
       +
         ) tracks;

     

       208
        
         

     

       209
        
         (* Check for completely empty GPX *)

     

       210
       +
         if waypoints = [] && routes = [] && tracks = [] then

     

       211
        
           issues := make_warning ~location:"gpx" "GPX document contains no geographic data" :: !issues;

     

       212
        
         

     

       213
        
         let all_issues = !issues in

     
···

       221
        
         result.is_valid

     

       222
        
       

     

       223
        
       (** Get only error messages *)

     

       224
       +
       let errors gpx =

     

       225
        
         let result = validate_gpx gpx in

     

       226
        
         List.filter (fun issue -> issue.level = `Error) result.issues

     

       227
        
       

     

       228
        
       (** Get only warning messages *)

     

       229
       +
       let warnings gpx =

     

       230
        
         let result = validate_gpx gpx in

     

       231
        
         List.filter (fun issue -> issue.level = `Warning) result.issues

     

       232

+4 -6

lib/gpx/validate.mli

···

       1
        
       (** GPX validation utilities *)

     

       2
        
       

     

       3
       -
       open Types

     

       4
       -
       

     

       5
        
       (** Validation issue representation *)

     

       6
        
       type validation_issue = {

     

       7
        
         level : [`Error | `Warning];

     
···

       16
        
       }

     

       17
        
       

     

       18
        
       (** Validate a complete GPX document *)

     

       19
       -
       val validate_gpx : gpx -> validation_result

     

       20
        
       

     

       21
        
       (** Quick validation - returns true if document is valid *)

     

       22
       -
       val is_valid : gpx -> bool

     

       23
        
       

     

       24
        
       (** Get only error messages *)

     

       25
       -
       val get_errors : gpx -> validation_issue list

     

       26
        
       

     

       27
        
       (** Get only warning messages *)

     

       28
       -
       val get_warnings : gpx -> validation_issue list

     

       29
        
       

     

       30
        
       (** Format validation issue for display *)

     

       31
        
       val format_issue : validation_issue -> string

···

       1
        
       (** GPX validation utilities *)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (** Validation issue representation *)

     

       4
        
       type validation_issue = {

     

       5
        
         level : [`Error | `Warning];

     
···

       14
        
       }

     

       15
        
       

     

       16
        
       (** Validate a complete GPX document *)

     

       17
       +
       val validate_gpx : Doc.t -> validation_result

     

       18
        
       

     

       19
        
       (** Quick validation - returns true if document is valid *)

     

       20
       +
       val is_valid : Doc.t -> bool

     

       21
        
       

     

       22
        
       (** Get only error messages *)

     

       23
       +
       val errors : Doc.t -> validation_issue list

     

       24
        
       

     

       25
        
       (** Get only warning messages *)

     

       26
       +
       val warnings : Doc.t -> validation_issue list

     

       27
        
       

     

       28
        
       (** Format validation issue for display *)

     

       29
        
       val format_issue : validation_issue -> string

+246

lib/gpx/waypoint.ml

···

       1
       +
       (** Waypoint data and GPS fix types *)

     

       2
       +
       

     

       3
       +
       (** GPS fix types as defined in GPX spec *)

     

       4
       +
       type fix_type = 

     

       5
       +
         | None_fix

     

       6
       +
         | Fix_2d

     

       7
       +
         | Fix_3d

     

       8
       +
         | Dgps

     

       9
       +
         | Pps

     

       10
       +
       

     

       11
       +
       (** Main waypoint type - shared by waypoints, route points, track points *)

     

       12
       +
       type t = {

     

       13
       +
         lat : Coordinate.latitude;

     

       14
       +
         lon : Coordinate.longitude;

     

       15
       +
         ele : float option;

     

       16
       +
         time : Ptime.t option;

     

       17
       +
         magvar : Coordinate.degrees option;

     

       18
       +
         geoidheight : float option;

     

       19
       +
         name : string option;

     

       20
       +
         cmt : string option;

     

       21
       +
         desc : string option;

     

       22
       +
         src : string option;

     

       23
       +
         links : Link.t list;

     

       24
       +
         sym : string option;

     

       25
       +
         type_ : string option;

     

       26
       +
         fix : fix_type option;

     

       27
       +
         sat : int option;

     

       28
       +
         hdop : float option;

     

       29
       +
         vdop : float option;

     

       30
       +
         pdop : float option;

     

       31
       +
         ageofdgpsdata : float option;

     

       32
       +
         dgpsid : int option;

     

       33
       +
         extensions : Extension.t list;

     

       34
       +
       }

     

       35
       +
       

     

       36
       +
       (** {2 Fix Type Operations} *)

     

       37
       +
       

     

       38
       +
       let fix_type_to_string = function

     

       39
       +
         | None_fix -> "none"

     

       40
       +
         | Fix_2d -> "2d" 

     

       41
       +
         | Fix_3d -> "3d"

     

       42
       +
         | Dgps -> "dgps"

     

       43
       +
         | Pps -> "pps"

     

       44
       +
       

     

       45
       +
       let fix_type_of_string = function

     

       46
       +
         | "none" -> Some None_fix

     

       47
       +
         | "2d" -> Some Fix_2d

     

       48
       +
         | "3d" -> Some Fix_3d

     

       49
       +
         | "dgps" -> Some Dgps

     

       50
       +
         | "pps" -> Some Pps

     

       51
       +
         | _ -> None

     

       52
       +
       

     

       53
       +
       let compare_fix_type f1 f2 = match f1, f2 with

     

       54
       +
         | None_fix, None_fix -> 0

     

       55
       +
         | None_fix, _ -> -1

     

       56
       +
         | _, None_fix -> 1

     

       57
       +
         | Fix_2d, Fix_2d -> 0

     

       58
       +
         | Fix_2d, _ -> -1

     

       59
       +
         | _, Fix_2d -> 1

     

       60
       +
         | Fix_3d, Fix_3d -> 0

     

       61
       +
         | Fix_3d, _ -> -1

     

       62
       +
         | _, Fix_3d -> 1

     

       63
       +
         | Dgps, Dgps -> 0

     

       64
       +
         | Dgps, _ -> -1

     

       65
       +
         | _, Dgps -> 1

     

       66
       +
         | Pps, Pps -> 0

     

       67
       +
       

     

       68
       +
       (** {2 Waypoint Operations} *)

     

       69
       +
       

     

       70
       +
       (** Create waypoint with required coordinates *)

     

       71
       +
       let make lat lon = {

     

       72
       +
         lat; lon;

     

       73
       +
         ele = None; time = None; magvar = None; geoidheight = None;

     

       74
       +
         name = None; cmt = None; desc = None; src = None; links = [];

     

       75
       +
         sym = None; type_ = None; fix = None; sat = None;

     

       76
       +
         hdop = None; vdop = None; pdop = None; ageofdgpsdata = None;

     

       77
       +
         dgpsid = None; extensions = [];

     

       78
       +
       }

     

       79
       +
       

     

       80
       +
       (** Create waypoint from float coordinates *)

     

       81
       +
       let make_from_floats ~lat ~lon ?name ?desc () =

     

       82
       +
         match Coordinate.latitude lat, Coordinate.longitude lon with

     

       83
       +
         | Ok lat_coord, Ok lon_coord -> 

     

       84
       +
           let wpt = make lat_coord lon_coord in

     

       85
       +
           Ok { wpt with name; desc }

     

       86
       +
         | Error e, _ | _, Error e -> Error e

     

       87
       +
       

     

       88
       +
       (** Get coordinate pair *)

     

       89
       +
       let coordinate t = Coordinate.make t.lat t.lon

     

       90
       +
       

     

       91
       +
       (** Get latitude *)

     

       92
       +
       let lat t = t.lat

     

       93
       +
       

     

       94
       +
       (** Get longitude *)

     

       95
       +
       let lon t = t.lon

     

       96
       +
       

     

       97
       +
       (** Get coordinate as float pair *)

     

       98
       +
       let to_floats t = (Coordinate.latitude_to_float t.lat, Coordinate.longitude_to_float t.lon)

     

       99
       +
       

     

       100
       +
       (** Get elevation *)

     

       101
       +
       let elevation t = t.ele

     

       102
       +
       

     

       103
       +
       (** Get time *)

     

       104
       +
       let time t = t.time

     

       105
       +
       

     

       106
       +
       (** Get name *)

     

       107
       +
       let name t = t.name

     

       108
       +
       

     

       109
       +
       (** Get description *)

     

       110
       +
       let description t = t.desc

     

       111
       +
       

     

       112
       +
       (** Get comment *)

     

       113
       +
       let comment t = t.cmt

     

       114
       +
       

     

       115
       +
       (** Get source *)

     

       116
       +
       let source t = t.src

     

       117
       +
       

     

       118
       +
       (** Get symbol *)

     

       119
       +
       let symbol t = t.sym

     

       120
       +
       

     

       121
       +
       (** Get type *)

     

       122
       +
       let type_ t = t.type_

     

       123
       +
       

     

       124
       +
       (** Get fix type *)

     

       125
       +
       let fix t = t.fix

     

       126
       +
       

     

       127
       +
       (** Get satellite count *)

     

       128
       +
       let sat t = t.sat

     

       129
       +
       

     

       130
       +
       (** Get horizontal dilution of precision *)

     

       131
       +
       let hdop t = t.hdop

     

       132
       +
       

     

       133
       +
       (** Get vertical dilution of precision *)

     

       134
       +
       let vdop t = t.vdop

     

       135
       +
       

     

       136
       +
       (** Get position dilution of precision *)

     

       137
       +
       let pdop t = t.pdop

     

       138
       +
       

     

       139
       +
       (** Get magnetic variation *)

     

       140
       +
       let magvar t = t.magvar

     

       141
       +
       

     

       142
       +
       (** Get geoid height *)

     

       143
       +
       let geoidheight t = t.geoidheight

     

       144
       +
       

     

       145
       +
       (** Get age of DGPS data *)

     

       146
       +
       let ageofdgpsdata t = t.ageofdgpsdata

     

       147
       +
       

     

       148
       +
       (** Get DGPS ID *)

     

       149
       +
       let dgpsid t = t.dgpsid

     

       150
       +
       

     

       151
       +
       (** Get links *)

     

       152
       +
       let links t = t.links

     

       153
       +
       

     

       154
       +
       (** Get extensions *)

     

       155
       +
       let extensions t = t.extensions

     

       156
       +
       

     

       157
       +
       (** Update elevation *)

     

       158
       +
       let with_elevation t ele = { t with ele = Some ele }

     

       159
       +
       

     

       160
       +
       (** Update time *)

     

       161
       +
       let with_time t time = { t with time }

     

       162
       +
       

     

       163
       +
       (** Update name *)

     

       164
       +
       let with_name t name = { t with name = Some name }

     

       165
       +
       

     

       166
       +
       (** Update comment *)

     

       167
       +
       let with_comment t cmt = { t with cmt = Some cmt }

     

       168
       +
       

     

       169
       +
       (** Update description *)

     

       170
       +
       let with_description t desc = { t with desc = Some desc }

     

       171
       +
       

     

       172
       +
       (** Update source *)

     

       173
       +
       let with_source t src = { t with src = Some src }

     

       174
       +
       

     

       175
       +
       (** Update symbol *)

     

       176
       +
       let with_symbol t sym = { t with sym = Some sym }

     

       177
       +
       

     

       178
       +
       (** Update type *)

     

       179
       +
       let with_type t type_ = { t with type_ = Some type_ }

     

       180
       +
       

     

       181
       +
       (** Update fix *)

     

       182
       +
       let with_fix t fix = { t with fix }

     

       183
       +
       

     

       184
       +
       (** Update satellite count *)

     

       185
       +
       let with_sat t sat = { t with sat = Some sat }

     

       186
       +
       

     

       187
       +
       (** Update HDOP *)

     

       188
       +
       let with_hdop t hdop = { t with hdop = Some hdop }

     

       189
       +
       

     

       190
       +
       (** Update VDOP *)

     

       191
       +
       let with_vdop t vdop = { t with vdop = Some vdop }

     

       192
       +
       

     

       193
       +
       (** Update PDOP *)

     

       194
       +
       let with_pdop t pdop = { t with pdop = Some pdop }

     

       195
       +
       

     

       196
       +
       (** Update magnetic variation *)

     

       197
       +
       let with_magvar t magvar = { t with magvar = Some magvar }

     

       198
       +
       

     

       199
       +
       (** Update geoid height *)

     

       200
       +
       let with_geoidheight t geoidheight = { t with geoidheight = Some geoidheight }

     

       201
       +
       

     

       202
       +
       (** Update age of DGPS data *)

     

       203
       +
       let with_ageofdgpsdata t ageofdgpsdata = { t with ageofdgpsdata = Some ageofdgpsdata }

     

       204
       +
       

     

       205
       +
       (** Update DGPS ID *)

     

       206
       +
       let with_dgpsid t dgpsid = { t with dgpsid = Some dgpsid }

     

       207
       +
       

     

       208
       +
       (** Add link *)

     

       209
       +
       let add_link t link = { t with links = link :: t.links }

     

       210
       +
       

     

       211
       +
       (** Add extensions *)

     

       212
       +
       let add_extensions t extensions = { t with extensions = extensions @ t.extensions }

     

       213
       +
       

     

       214
       +
       (** Compare waypoints *)

     

       215
       +
       let compare t1 t2 =

     

       216
       +
         let lat_cmp = Float.compare 

     

       217
       +
           (Coordinate.latitude_to_float t1.lat) 

     

       218
       +
           (Coordinate.latitude_to_float t2.lat) in

     

       219
       +
         if lat_cmp <> 0 then lat_cmp

     

       220
       +
         else

     

       221
       +
           let lon_cmp = Float.compare 

     

       222
       +
             (Coordinate.longitude_to_float t1.lon) 

     

       223
       +
             (Coordinate.longitude_to_float t2.lon) in

     

       224
       +
           if lon_cmp <> 0 then lon_cmp

     

       225
       +
           else

     

       226
       +
             let ele_cmp = Option.compare Float.compare t1.ele t2.ele in

     

       227
       +
             if ele_cmp <> 0 then ele_cmp

     

       228
       +
             else Option.compare Ptime.compare t1.time t2.time

     

       229
       +
       

     

       230
       +
       (** Test waypoint equality *)

     

       231
       +
       let equal t1 t2 = compare t1 t2 = 0

     

       232
       +
       

     

       233
       +
       (** Pretty print waypoint *)

     

       234
       +
       let pp ppf t =

     

       235
       +
         let lat, lon = to_floats t in

     

       236
       +
         match t.name with

     

       237
       +
         | Some name -> Format.fprintf ppf "%s @ (%g, %g)" name lat lon

     

       238
       +
         | None -> Format.fprintf ppf "(%g, %g)" lat lon

     

       239
       +
       

     

       240
       +
       (** Pretty print fix type *)

     

       241
       +
       let pp_fix_type ppf = function

     

       242
       +
         | None_fix -> Format.fprintf ppf "none"

     

       243
       +
         | Fix_2d -> Format.fprintf ppf "2d"

     

       244
       +
         | Fix_3d -> Format.fprintf ppf "3d" 

     

       245
       +
         | Dgps -> Format.fprintf ppf "dgps"

     

       246
       +
         | Pps -> Format.fprintf ppf "pps"

+193

lib/gpx/waypoint.mli

···

       1
       +
       (** Waypoint data and GPS fix types *)

     

       2
       +
       

     

       3
       +
       (** GPS fix types as defined in GPX spec *)

     

       4
       +
       type fix_type = 

     

       5
       +
         | None_fix

     

       6
       +
         | Fix_2d

     

       7
       +
         | Fix_3d

     

       8
       +
         | Dgps

     

       9
       +
         | Pps

     

       10
       +
       

     

       11
       +
       (** Main waypoint type - shared by waypoints, route points, track points *)

     

       12
       +
       type t = {

     

       13
       +
         lat : Coordinate.latitude;

     

       14
       +
         lon : Coordinate.longitude;

     

       15
       +
         ele : float option;

     

       16
       +
         time : Ptime.t option;

     

       17
       +
         magvar : Coordinate.degrees option;

     

       18
       +
         geoidheight : float option;

     

       19
       +
         name : string option;

     

       20
       +
         cmt : string option;

     

       21
       +
         desc : string option;

     

       22
       +
         src : string option;

     

       23
       +
         links : Link.t list;

     

       24
       +
         sym : string option;

     

       25
       +
         type_ : string option;

     

       26
       +
         fix : fix_type option;

     

       27
       +
         sat : int option;

     

       28
       +
         hdop : float option;

     

       29
       +
         vdop : float option;

     

       30
       +
         pdop : float option;

     

       31
       +
         ageofdgpsdata : float option;

     

       32
       +
         dgpsid : int option;

     

       33
       +
         extensions : Extension.t list;

     

       34
       +
       }

     

       35
       +
       

     

       36
       +
       (** {2 Fix Type Operations} *)

     

       37
       +
       

     

       38
       +
       (** Convert fix_type to string *)

     

       39
       +
       val fix_type_to_string : fix_type -> string

     

       40
       +
       

     

       41
       +
       (** Parse fix_type from string *)

     

       42
       +
       val fix_type_of_string : string -> fix_type option

     

       43
       +
       

     

       44
       +
       (** Compare fix types *)

     

       45
       +
       val compare_fix_type : fix_type -> fix_type -> int

     

       46
       +
       

     

       47
       +
       (** Pretty print fix type *)

     

       48
       +
       val pp_fix_type : Format.formatter -> fix_type -> unit

     

       49
       +
       

     

       50
       +
       (** {2 Waypoint Operations} *)

     

       51
       +
       

     

       52
       +
       (** Create waypoint with required coordinates *)

     

       53
       +
       val make : Coordinate.latitude -> Coordinate.longitude -> t

     

       54
       +
       

     

       55
       +
       (** Create waypoint from float coordinates with validation *)

     

       56
       +
       val make_from_floats : lat:float -> lon:float -> ?name:string -> ?desc:string -> unit -> (t, string) result

     

       57
       +
       

     

       58
       +
       (** Get coordinate pair *)

     

       59
       +
       val coordinate : t -> Coordinate.t

     

       60
       +
       

     

       61
       +
       (** Get latitude *)

     

       62
       +
       val lat : t -> Coordinate.latitude

     

       63
       +
       

     

       64
       +
       (** Get longitude *)

     

       65
       +
       val lon : t -> Coordinate.longitude

     

       66
       +
       

     

       67
       +
       (** Get coordinate as float pair *)

     

       68
       +
       val to_floats : t -> float * float

     

       69
       +
       

     

       70
       +
       (** Get elevation *)

     

       71
       +
       val elevation : t -> float option

     

       72
       +
       

     

       73
       +
       (** Get time *)

     

       74
       +
       val time : t -> Ptime.t option

     

       75
       +
       

     

       76
       +
       (** Get name *)

     

       77
       +
       val name : t -> string option

     

       78
       +
       

     

       79
       +
       (** Get description *)

     

       80
       +
       val description : t -> string option

     

       81
       +
       

     

       82
       +
       (** Get comment *)

     

       83
       +
       val comment : t -> string option

     

       84
       +
       

     

       85
       +
       (** Get source *)

     

       86
       +
       val source : t -> string option

     

       87
       +
       

     

       88
       +
       (** Get symbol *)

     

       89
       +
       val symbol : t -> string option

     

       90
       +
       

     

       91
       +
       (** Get type *)

     

       92
       +
       val type_ : t -> string option

     

       93
       +
       

     

       94
       +
       (** Get fix type *)

     

       95
       +
       val fix : t -> fix_type option

     

       96
       +
       

     

       97
       +
       (** Get satellite count *)

     

       98
       +
       val sat : t -> int option

     

       99
       +
       

     

       100
       +
       (** Get horizontal dilution of precision *)

     

       101
       +
       val hdop : t -> float option

     

       102
       +
       

     

       103
       +
       (** Get vertical dilution of precision *)

     

       104
       +
       val vdop : t -> float option

     

       105
       +
       

     

       106
       +
       (** Get position dilution of precision *)

     

       107
       +
       val pdop : t -> float option

     

       108
       +
       

     

       109
       +
       (** Get magnetic variation *)

     

       110
       +
       val magvar : t -> Coordinate.degrees option

     

       111
       +
       

     

       112
       +
       (** Get geoid height *)

     

       113
       +
       val geoidheight : t -> float option

     

       114
       +
       

     

       115
       +
       (** Get age of DGPS data *)

     

       116
       +
       val ageofdgpsdata : t -> float option

     

       117
       +
       

     

       118
       +
       (** Get DGPS ID *)

     

       119
       +
       val dgpsid : t -> int option

     

       120
       +
       

     

       121
       +
       (** Get links *)

     

       122
       +
       val links : t -> Link.t list

     

       123
       +
       

     

       124
       +
       (** Get extensions *)

     

       125
       +
       val extensions : t -> Extension.t list

     

       126
       +
       

     

       127
       +
       (** Functional operations for building waypoints *)

     

       128
       +
       

     

       129
       +
       (** Update elevation *)

     

       130
       +
       val with_elevation : t -> float -> t

     

       131
       +
       

     

       132
       +
       (** Update time *)

     

       133
       +
       val with_time : t -> Ptime.t option -> t

     

       134
       +
       

     

       135
       +
       (** Update name *)

     

       136
       +
       val with_name : t -> string -> t

     

       137
       +
       

     

       138
       +
       (** Update comment *)

     

       139
       +
       val with_comment : t -> string -> t

     

       140
       +
       

     

       141
       +
       (** Update description *)

     

       142
       +
       val with_description : t -> string -> t

     

       143
       +
       

     

       144
       +
       (** Update source *)

     

       145
       +
       val with_source : t -> string -> t

     

       146
       +
       

     

       147
       +
       (** Update symbol *)

     

       148
       +
       val with_symbol : t -> string -> t

     

       149
       +
       

     

       150
       +
       (** Update type *)

     

       151
       +
       val with_type : t -> string -> t

     

       152
       +
       

     

       153
       +
       (** Update fix *)

     

       154
       +
       val with_fix : t -> fix_type option -> t

     

       155
       +
       

     

       156
       +
       (** Update satellite count *)

     

       157
       +
       val with_sat : t -> int -> t

     

       158
       +
       

     

       159
       +
       (** Update HDOP *)

     

       160
       +
       val with_hdop : t -> float -> t

     

       161
       +
       

     

       162
       +
       (** Update VDOP *)

     

       163
       +
       val with_vdop : t -> float -> t

     

       164
       +
       

     

       165
       +
       (** Update PDOP *)

     

       166
       +
       val with_pdop : t -> float -> t

     

       167
       +
       

     

       168
       +
       (** Update magnetic variation *)

     

       169
       +
       val with_magvar : t -> Coordinate.degrees -> t

     

       170
       +
       

     

       171
       +
       (** Update geoid height *)

     

       172
       +
       val with_geoidheight : t -> float -> t

     

       173
       +
       

     

       174
       +
       (** Update age of DGPS data *)

     

       175
       +
       val with_ageofdgpsdata : t -> float -> t

     

       176
       +
       

     

       177
       +
       (** Update DGPS ID *)

     

       178
       +
       val with_dgpsid : t -> int -> t

     

       179
       +
       

     

       180
       +
       (** Add link *)

     

       181
       +
       val add_link : t -> Link.t -> t

     

       182
       +
       

     

       183
       +
       (** Add extensions *)

     

       184
       +
       val add_extensions : t -> Extension.t list -> t

     

       185
       +
       

     

       186
       +
       (** Compare waypoints *)

     

       187
       +
       val compare : t -> t -> int

     

       188
       +
       

     

       189
       +
       (** Test waypoint equality *)

     

       190
       +
       val equal : t -> t -> bool

     

       191
       +
       

     

       192
       +
       (** Pretty print waypoint *)

     

       193
       +
       val pp : Format.formatter -> t -> unit

+265 -294

lib/gpx/writer.ml

···

       1
       -
       (** GPX streaming writer using xmlm *)

     

       2
       -
       

     

       3
       -
       open Types

     

       4
        
       

     

       5
        
       (** Result binding operators *)

     

       6
        
       let (let*) = Result.bind

     

       7
        
       

     

       8
       -
       (** Writer state for streaming *)

     

       9
       -
       type writer_state = {

     

       10
       -
         output : Xmlm.output;

     

       11
       -
       }

     

       12
       -
       

     

       13
       -
       (** Create a new writer state *)

     

       14
       -
       let make_writer output = { output }

     

       15
       -
       

     

       16
       -
       (** Utility functions *)

     

       17
       -
       

     

       18
       -
       let convert_attributes attrs =

     

       19
       -
         List.map (fun (name, value) -> (("", name), value)) attrs

     

       20
       -
       

     

       21
       -
       let output_signal writer signal =

     

       22
        
         try

     

       23
       -
           Xmlm.output writer.output signal;

     

       24
        
           Ok ()

     

       25
       -
         with

     

       26
       -
         | Xmlm.Error ((line, col), error) ->

     

       27
       -
           Error (Xml_error (Printf.sprintf "XML error at line %d, column %d: %s"

     

       28
       -
                             line col (Xmlm.error_message error)))

     

       29
       -
         | exn ->

     

       30
       -
           Error (Invalid_xml (Printexc.to_string exn))

     

       31
       -
       

     

       32
       -
       let output_element_start writer name attrs =

     

       33
       -
         output_signal writer (`El_start (("", name), attrs))

     

       34
        
       

     

       35
        
       let output_element_end writer =

     

       36
       -
         output_signal writer `El_end

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       37
        
       

     

       38
        
       let output_data writer text =

     

       39
       -
         if text <> "" then

     

       40
       -
           output_signal writer (`Data text)

     

       41
       -
         else

     

       42
        
           Ok ()

     

       0
        
       
     

       0
        
       
     

       43
        
       

     

       44
        
       let output_text_element writer name text =

     

       45
       -
         let* () = output_element_start writer name [] in

     

       0
        
       
     

       46
        
         let* () = output_data writer text in

     

       47
        
         output_element_end writer

     

       48
        
       

     
···

       50
        
         | Some text -> output_text_element writer name text

     

       51
        
         | None -> Ok ()

     

       52
        
       

     

       53
       -
       let output_float_element writer name f =

     

       54
       -
         output_text_element writer name (Printf.sprintf "%.6f" f)

     

       55
       -
       

     

       56
        
       let output_optional_float_element writer name = function

     

       57
       -
         | Some f -> output_float_element writer name f

     

       58
        
         | None -> Ok ()

     

       59
        
       

     

       60
       -
       let output_int_element writer name i =

     

       61
       -
         output_text_element writer name (string_of_int i)

     

       0
        
       
     

       62
        
       

     

       63
        
       let output_optional_int_element writer name = function

     

       64
       -
         | Some i -> output_int_element writer name i

     

       65
        
         | None -> Ok ()

     

       66
        
       

     

       67
       -
       let output_time_element writer name time =

     

       68
       -
         output_text_element writer name (Ptime.to_rfc3339 time)

     

       69
       -
       

     

       70
        
       let output_optional_time_element writer name = function

     

       71
       -
         | Some time -> output_time_element writer name time

     

       72
        
         | None -> Ok ()

     

       73
        
       

     

       74
       -
       (** Write GPX header and DTD *)

     

       75
       -
       let write_header writer =

     

       76
       -
         let* () = output_signal writer (`Dtd None) in

     

       77
       -
         Ok ()

     

       78
        
       

     

       79
       -
       (** Write link element *)

     

       80
       -
       let write_link writer link =

     

       81
       -
         let attrs = [(("" , "href"), link.href)] in

     

       0
        
       
     

       82
        
         let* () = output_element_start writer "link" attrs in

     

       83
       -
         let* () = output_optional_text_element writer "text" link.text in

     

       84
       -
         let* () = output_optional_text_element writer "type" link.type_ in

     

       85
        
         output_element_end writer

     

       86
        
       

     

       87
       -
       (** Write list of links *)

     

       88
       -
       let write_links writer links =

     

       89
       -
         let rec loop = function

     

       90
        
           | [] -> Ok ()

     

       91
        
           | link :: rest ->

     

       92
       -
             let* () = write_link writer link in

     

       93
       -
             loop rest

     

       94
        
         in

     

       95
       -
         loop links

     

       96
        
       

     

       97
       -
       (** Write extension content *)

     

       98
       -
       let rec write_extension_content writer = function

     

       99
       -
         | Text text -> output_data writer text

     

       100
       -
         | Elements extensions -> write_extensions writer extensions

     

       101
       -
         | Mixed (text, extensions) ->

     

       102
       -
           let* () = output_data writer text in

     

       103
       -
           write_extensions writer extensions

     

       104
       -
       

     

       105
       -
       (** Write extensions *)

     

       106
       -
       and write_extensions writer extensions =

     

       107
       -
         let rec loop = function

     

       108
       -
           | [] -> Ok ()

     

       109
       -
           | ext :: rest ->

     

       110
       -
             let* () = write_extension writer ext in

     

       111
       -
             loop rest

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       112
        
         in

     

       113
       -
         loop extensions

     

       114
       -
       

     

       115
       -
       and write_extension writer ext =

     

       116
       -
         let name = match ext.namespace with

     

       117
       -
           | Some ns -> ns ^ ":" ^ ext.name

     

       118
       -
           | None -> ext.name

     

       119
        
         in

     

       120
       -
         let* () = output_element_start writer name (convert_attributes ext.attributes) in

     

       121
       -
         let* () = write_extension_content writer ext.content in

     

       122
        
         output_element_end writer

     

       123
        
       

     

       124
       -
       (** Write waypoint data (shared by wpt, rtept, trkpt) *)

     

       125
       -
       let write_waypoint_data writer element_name wpt =

     

       126
       -
         let attrs = [

     

       127
       -
           (("", "lat"), Printf.sprintf "%.6f" (latitude_to_float wpt.lat));

     

       128
       -
           (("", "lon"), Printf.sprintf "%.6f" (longitude_to_float wpt.lon));

     

       129
       -
         ] in

     

       130
       -
         let* () = output_element_start writer element_name attrs in

     

       131
       -
         let* () = output_optional_float_element writer "ele" wpt.ele in

     

       132
       -
         let* () = output_optional_time_element writer "time" wpt.time in

     

       133
       -
         let* () = (match wpt.magvar with

     

       134
       -
                    | Some deg -> output_float_element writer "magvar" (degrees_to_float deg)

     

       135
       -
                    | None -> Ok ()) in

     

       136
       -
         let* () = output_optional_float_element writer "geoidheight" wpt.geoidheight in

     

       137
       -
         let* () = output_optional_text_element writer "name" wpt.name in

     

       138
       -
         let* () = output_optional_text_element writer "cmt" wpt.cmt in

     

       139
       -
         let* () = output_optional_text_element writer "desc" wpt.desc in

     

       140
       -
         let* () = output_optional_text_element writer "src" wpt.src in

     

       141
       -
         let* () = write_links writer wpt.links in

     

       142
       -
         let* () = output_optional_text_element writer "sym" wpt.sym in

     

       143
       -
         let* () = output_optional_text_element writer "type" wpt.type_ in

     

       144
       -
         let* () = (match wpt.fix with

     

       145
       -
                    | Some fix -> output_text_element writer "fix" (fix_type_to_string fix)

     

       146
       -
                    | None -> Ok ()) in

     

       147
       -
         let* () = output_optional_int_element writer "sat" wpt.sat in

     

       148
       -
         let* () = output_optional_float_element writer "hdop" wpt.hdop in

     

       149
       -
         let* () = output_optional_float_element writer "vdop" wpt.vdop in

     

       150
       -
         let* () = output_optional_float_element writer "pdop" wpt.pdop in

     

       151
       -
         let* () = output_optional_float_element writer "ageofdgpsdata" wpt.ageofdgpsdata in

     

       152
       -
         let* () = output_optional_int_element writer "dgpsid" wpt.dgpsid in

     

       153
       -
         let* () = (if wpt.extensions <> [] then

     

       154
       -
                    let* () = output_element_start writer "extensions" [] in

     

       155
       -
                    let* () = write_extensions writer wpt.extensions in

     

       156
       -
                    output_element_end writer

     

       157
       -
                  else Ok ()) in

     

       158
       -
         output_element_end writer

     

       159
       -
       

     

       160
       -
       (** Write waypoint *)

     

       161
       -
       let write_waypoint writer wpt =

     

       162
       -
         write_waypoint_data writer "wpt" wpt

     

       163
       -
       

     

       164
       -
       (** Write route point *)

     

       165
       -
       let write_route_point writer rtept =

     

       166
       -
         write_waypoint_data writer "rtept" rtept

     

       167
       -
       

     

       168
       -
       (** Write track point *)

     

       169
       -
       let write_track_point writer trkpt =

     

       170
       -
         write_waypoint_data writer "trkpt" trkpt

     

       171
       -
       

     

       172
       -
       (** Write person *)

     

       173
       -
       let write_person writer (p : person) =

     

       174
       -
         let* () = output_element_start writer "author" [] in

     

       175
       -
         let* () = output_optional_text_element writer "name" p.name in

     

       176
       -
         let* () = output_optional_text_element writer "email" p.email in

     

       177
       -
         let* () = (match p.link with

     

       178
       -
                    | Some link -> write_link writer link

     

       179
       -
                    | None -> Ok ()) in

     

       180
       -
         output_element_end writer

     

       181
       -
       

     

       182
       -
       (** Write copyright *)

     

       183
       -
       let write_copyright writer (copyright : copyright) =

     

       184
       -
         let attrs = [(("", "author"), copyright.author)] in

     

       185
        
         let* () = output_element_start writer "copyright" attrs in

     

       186
       -
         let* () = (match copyright.year with

     

       187
       -
                    | Some year -> output_int_element writer "year" year

     

       188
       -
                    | None -> Ok ()) in

     

       189
       -
         let* () = output_optional_text_element writer "license" copyright.license in

     

       190
        
         output_element_end writer

     

       191
        
       

     

       192
       -
       (** Write bounds *)

     

       193
       -
       let write_bounds writer bounds =

     

       0
        
       
     

       194
        
         let attrs = [

     

       195
       -
           (("", "minlat"), Printf.sprintf "%.6f" (latitude_to_float bounds.minlat));

     

       196
       -
           (("", "minlon"), Printf.sprintf "%.6f" (longitude_to_float bounds.minlon));

     

       197
       -
           (("", "maxlat"), Printf.sprintf "%.6f" (latitude_to_float bounds.maxlat));

     

       198
       -
           (("", "maxlon"), Printf.sprintf "%.6f" (longitude_to_float bounds.maxlon));

     

       199
        
         ] in

     

       200
        
         let* () = output_element_start writer "bounds" attrs in

     

       201
        
         output_element_end writer

     

       202
        
       

     

       203
       -
       (** Write metadata *)

     

       204
       -
       let write_metadata writer (metadata : metadata) =

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       205
        
         let* () = output_element_start writer "metadata" [] in

     

       206
       -
         let* () = output_optional_text_element writer "name" metadata.name in

     

       207
       -
         let* () = output_optional_text_element writer "desc" metadata.desc in

     

       208
       -
         let* () = (match metadata.author with

     

       209
       -
                    | Some author -> write_person writer author

     

       210
       -
                    | None -> Ok ()) in

     

       211
       -
         let* () = (match metadata.copyright with

     

       212
       -
                    | Some copyright -> write_copyright writer copyright

     

       213
       -
                    | None -> Ok ()) in

     

       214
       -
         let* () = write_links writer metadata.links in

     

       215
       -
         let* () = output_optional_time_element writer "time" metadata.time in

     

       216
       -
         let* () = output_optional_text_element writer "keywords" metadata.keywords in

     

       217
       -
         let* () = (match metadata.bounds with

     

       218
       -
                    | Some bounds -> write_bounds writer bounds

     

       219
       -
                    | None -> Ok ()) in

     

       220
       -
         let* () = (if metadata.extensions <> [] then

     

       221
       -
                    let* () = output_element_start writer "extensions" [] in

     

       222
       -
                    let* () = write_extensions writer metadata.extensions in

     

       223
       -
                    output_element_end writer

     

       224
       -
                  else Ok ()) in

     

       225
        
         output_element_end writer

     

       226
        
       

     

       227
       -
       (** Write route *)

     

       228
       -
       let write_route writer (route : route) =

     

       229
       -
         let* () = output_element_start writer "rte" [] in

     

       230
       -
         let* () = output_optional_text_element writer "name" route.name in

     

       231
       -
         let* () = output_optional_text_element writer "cmt" route.cmt in

     

       232
       -
         let* () = output_optional_text_element writer "desc" route.desc in

     

       233
       -
         let* () = output_optional_text_element writer "src" route.src in

     

       234
       -
         let* () = write_links writer route.links in

     

       235
       -
         let* () = output_optional_int_element writer "number" route.number in

     

       236
       -
         let* () = output_optional_text_element writer "type" route.type_ in

     

       237
       -
         let* () = (if route.extensions <> [] then

     

       238
       -
                    let* () = output_element_start writer "extensions" [] in

     

       239
       -
                    let* () = write_extensions writer route.extensions in

     

       240
       -
                    output_element_end writer

     

       241
       -
                  else Ok ()) in

     

       242
       -
         let* () = 

     

       243
       -
           let rec loop = function

     

       244
       -
             | [] -> Ok ()

     

       245
       -
             | rtept :: rest ->

     

       246
       -
               let* () = write_route_point writer rtept in

     

       247
       -
               loop rest

     

       248
       -
           in

     

       249
       -
           loop route.rtepts

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       250
        
         in

     

       251
       -
         output_element_end writer

     

       252
        
       

     

       253
       -
       (** Write track segment *)

     

       254
       -
       let write_track_segment writer trkseg =

     

       255
       -
         let* () = output_element_start writer "trkseg" [] in

     

       256
       -
         let* () = 

     

       257
       -
           let rec loop = function

     

       258
       -
             | [] -> Ok ()

     

       259
       -
             | trkpt :: rest ->

     

       260
       -
               let* () = write_track_point writer trkpt in

     

       261
       -
               loop rest

     

       262
       -
           in

     

       263
       -
           loop trkseg.trkpts

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       264
        
         in

     

       265
       -
         let* () = (if trkseg.extensions <> [] then

     

       266
       -
                    let* () = output_element_start writer "extensions" [] in

     

       267
       -
                    let* () = write_extensions writer trkseg.extensions in

     

       268
       -
                    output_element_end writer

     

       269
       -
                  else Ok ()) in

     

       270
       -
         output_element_end writer

     

       271
        
       

     

       272
       -
       (** Write track *)

     

       273
       -
       let write_track writer track =

     

       274
       -
         let* () = output_element_start writer "trk" [] in

     

       275
       -
         let* () = output_optional_text_element writer "name" track.name in

     

       276
       -
         let* () = output_optional_text_element writer "cmt" track.cmt in

     

       277
       -
         let* () = output_optional_text_element writer "desc" track.desc in

     

       278
       -
         let* () = output_optional_text_element writer "src" track.src in

     

       279
       -
         let* () = write_links writer track.links in

     

       280
       -
         let* () = output_optional_int_element writer "number" track.number in

     

       281
       -
         let* () = output_optional_text_element writer "type" track.type_ in

     

       282
       -
         let* () = (if track.extensions <> [] then

     

       283
       -
                    let* () = output_element_start writer "extensions" [] in

     

       284
       -
                    let* () = write_extensions writer track.extensions in

     

       285
       -
                    output_element_end writer

     

       286
       -
                  else Ok ()) in

     

       287
       -
         let* () = 

     

       288
       -
           let rec loop = function

     

       289
       -
             | [] -> Ok ()

     

       290
       -
             | trkseg :: rest ->

     

       291
       -
               let* () = write_track_segment writer trkseg in

     

       292
       -
               loop rest

     

       293
       -
           in

     

       294
       -
           loop track.trksegs

     

       295
        
         in

     

       296
       -
         output_element_end writer

     

       297
        
       

     

       298
       -
       (** Write complete GPX document *)

     

       299
       -
       let write_gpx writer gpx =

     

       300
       -
         let* () = write_header writer in

     

       301
       -
         let attrs = [

     

       302
       -
           (("", "version"), gpx.version);

     

       303
       -
           (("", "creator"), gpx.creator);

     

       304
       -
           (("", "xmlns"), "http://www.topografix.com/GPX/1/1");

     

       305
       -
           (("http://www.w3.org/2000/xmlns/", "xsi"), "http://www.w3.org/2001/XMLSchema-instance");

     

       306
       -
           (("http://www.w3.org/2001/XMLSchema-instance", "schemaLocation"), "http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd");

     

       307
       -
         ] in

     

       308
       -
         let* () = output_element_start writer "gpx" attrs in

     

       309
       -
         let* () = (match gpx.metadata with

     

       310
       -
                    | Some metadata -> write_metadata writer metadata

     

       311
       -
                    | None -> Ok ()) in

     

       312
       -
         let* () = 

     

       313
       -
           let rec loop = function

     

       314
       -
             | [] -> Ok ()

     

       315
       -
             | wpt :: rest ->

     

       316
       -
               let* () = write_waypoint writer wpt in

     

       317
       -
               loop rest

     

       318
       -
           in

     

       319
       -
           loop gpx.waypoints

     

       320
        
         in

     

       321
       -
         let* () = 

     

       322
       -
           let rec loop = function

     

       323
       -
             | [] -> Ok ()

     

       324
       -
             | rte :: rest ->

     

       325
       -
               let* () = write_route writer rte in

     

       326
       -
               loop rest

     

       327
       -
           in

     

       328
       -
           loop gpx.routes

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       329
        
         in

     

       330
       -
         let* () = 

     

       331
       -
           let rec loop = function

     

       332
       -
             | [] -> Ok ()

     

       333
       -
             | trk :: rest ->

     

       334
       -
               let* () = write_track writer trk in

     

       335
       -
               loop rest

     

       336
       -
           in

     

       337
       -
           loop gpx.tracks

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       338
        
         in

     

       339
       -
         let* () = (if gpx.extensions <> [] then

     

       340
       -
                    let* () = output_element_start writer "extensions" [] in

     

       341
       -
                    let* () = write_extensions writer gpx.extensions in

     

       342
       -
                    output_element_end writer

     

       343
       -
                  else Ok ()) in

     

       344
       -
         output_element_end writer

     

       345
       -
       

     

       346
       -
       (** Main writing function *)

     

       347
       -
       let write output gpx =

     

       348
       -
         let writer = make_writer output in

     

       349
       -
         write_gpx writer gpx

     

       0
        
       
     

       0
        
       
     

       350
        
       

     

       351
       -
       (** Write to string *)

     

       352
       -
       let write_string gpx =

     

       353
        
         let buffer = Buffer.create 1024 in

     

       354
       -
         let output = Xmlm.make_output (`Buffer buffer) in

     

       355
       -
         let result = write output gpx in

     

       356
       -
         match result with

     

       357
       -
         | Ok () -> Ok (Buffer.contents buffer)

     

       358
       -
         | Error e -> Error e

···

       1
       +
       (** GPX XML writer with complete spec coverage *)

     

       0
        
       
     

       0
        
       
     

       2
        
       

     

       3
        
       (** Result binding operators *)

     

       4
        
       let (let*) = Result.bind

     

       5
        
       

     

       6
       +
       (** Helper to write XML elements *)

     

       7
       +
       let output_element_start writer name attrs =

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       8
        
         try

     

       9
       +
           Xmlm.output writer (`El_start ((("", name), attrs)));

     

       10
        
           Ok ()

     

       11
       +
         with exn ->

     

       12
       +
           Error (Error.xml_error (Printexc.to_string exn))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       13
        
       

     

       14
        
       let output_element_end writer =

     

       15
       +
         try

     

       16
       +
           Xmlm.output writer `El_end;

     

       17
       +
           Ok ()

     

       18
       +
         with exn ->

     

       19
       +
           Error (Error.xml_error (Printexc.to_string exn))

     

       20
        
       

     

       21
        
       let output_data writer text =

     

       22
       +
         try

     

       23
       +
           Xmlm.output writer (`Data text);

     

       0
        
       
     

       24
        
           Ok ()

     

       25
       +
         with exn ->

     

       26
       +
           Error (Error.xml_error (Printexc.to_string exn))

     

       27
        
       

     

       28
        
       let output_text_element writer name text =

     

       29
       +
         let attrs = [] in

     

       30
       +
         let* () = output_element_start writer name attrs in

     

       31
        
         let* () = output_data writer text in

     

       32
        
         output_element_end writer

     

       33
        
       

     
···

       35
        
         | Some text -> output_text_element writer name text

     

       36
        
         | None -> Ok ()

     

       37
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       38
        
       let output_optional_float_element writer name = function

     

       39
       +
         | Some value -> output_text_element writer name (Printf.sprintf "%.6f" value)

     

       40
        
         | None -> Ok ()

     

       41
        
       

     

       42
       +
       let output_optional_degrees_element writer name = function

     

       43
       +
         | Some degrees -> output_text_element writer name (Printf.sprintf "%.6f" (Coordinate.degrees_to_float degrees))

     

       44
       +
         | None -> Ok ()

     

       45
        
       

     

       46
        
       let output_optional_int_element writer name = function

     

       47
       +
         | Some value -> output_text_element writer name (string_of_int value)

     

       48
        
         | None -> Ok ()

     

       49
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       50
        
       let output_optional_time_element writer name = function

     

       51
       +
         | Some time -> output_text_element writer name (Ptime.to_rfc3339 time)

     

       52
        
         | None -> Ok ()

     

       53
        
       

     

       54
       +
       let output_optional_fix_element writer name = function

     

       55
       +
         | Some fix_type -> output_text_element writer name (Waypoint.fix_type_to_string fix_type)

     

       56
       +
         | None -> Ok ()

     

       0
        
       
     

       57
        
       

     

       58
       +
       (** Write link elements *)

     

       59
       +
       let output_link writer link =

     

       60
       +
         let href = Link.href link in

     

       61
       +
         let attrs = [(("", "href"), href)] in

     

       62
        
         let* () = output_element_start writer "link" attrs in

     

       63
       +
         let* () = output_optional_text_element writer "text" (Link.text link) in

     

       64
       +
         let* () = output_optional_text_element writer "type" (Link.type_ link) in

     

       65
        
         output_element_end writer

     

       66
        
       

     

       67
       +
       let output_links writer links =

     

       68
       +
         let rec write_links = function

     

       0
        
       
     

       69
        
           | [] -> Ok ()

     

       70
        
           | link :: rest ->

     

       71
       +
               let* () = output_link writer link in

     

       72
       +
               write_links rest

     

       73
        
         in

     

       74
       +
         write_links links

     

       75
        
       

     

       76
       +
       (** Write person (author) element *)

     

       77
       +
       let output_person writer person =

     

       78
       +
         let* () = output_element_start writer "author" [] in

     

       79
       +
         let* () = output_optional_text_element writer "name" (Link.person_name person) in

     

       80
       +
         let* () = match Link.person_email person with

     

       81
       +
           | Some email ->

     

       82
       +
               (* Parse email into id and domain *)

     

       83
       +
               (match String.index_opt email '@' with

     

       84
       +
                | Some at_pos ->

     

       85
       +
                    let id = String.sub email 0 at_pos in

     

       86
       +
                    let domain = String.sub email (at_pos + 1) (String.length email - at_pos - 1) in

     

       87
       +
                    let attrs = [(("", "id"), id); (("", "domain"), domain)] in

     

       88
       +
                    let* () = output_element_start writer "email" attrs in

     

       89
       +
                    output_element_end writer

     

       90
       +
                | None ->

     

       91
       +
                    (* Invalid email format, skip *)

     

       92
       +
                    Ok ())

     

       93
       +
           | None -> Ok ()

     

       94
        
         in

     

       95
       +
         let* () = match Link.person_link person with

     

       96
       +
           | Some link -> output_link writer link

     

       97
       +
           | None -> Ok ()

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       98
        
         in

     

       0
        
       
     

       0
        
       
     

       99
        
         output_element_end writer

     

       100
        
       

     

       101
       +
       (** Write copyright element *)

     

       102
       +
       let output_copyright writer copyright =

     

       103
       +
         let author = Link.copyright_author copyright in

     

       104
       +
         let attrs = [(("", "author"), author)] in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       105
        
         let* () = output_element_start writer "copyright" attrs in

     

       106
       +
         let* () = output_optional_int_element writer "year" (Link.copyright_year copyright) in

     

       107
       +
         let* () = output_optional_text_element writer "license" (Link.copyright_license copyright) in

     

       0
        
       
     

       0
        
       
     

       108
        
         output_element_end writer

     

       109
        
       

     

       110
       +
       (** Write bounds element *)

     

       111
       +
       let output_bounds writer bounds =

     

       112
       +
         let (minlat, minlon, maxlat, maxlon) = Metadata.Bounds.bounds bounds in

     

       113
        
         let attrs = [

     

       114
       +
           (("", "minlat"), Printf.sprintf "%.6f" (Coordinate.latitude_to_float minlat));

     

       115
       +
           (("", "minlon"), Printf.sprintf "%.6f" (Coordinate.longitude_to_float minlon));

     

       116
       +
           (("", "maxlat"), Printf.sprintf "%.6f" (Coordinate.latitude_to_float maxlat));

     

       117
       +
           (("", "maxlon"), Printf.sprintf "%.6f" (Coordinate.longitude_to_float maxlon));

     

       118
        
         ] in

     

       119
        
         let* () = output_element_start writer "bounds" attrs in

     

       120
        
         output_element_end writer

     

       121
        
       

     

       122
       +
       (** Write extensions element *)

     

       123
       +
       let output_extensions writer extensions =

     

       124
       +
         if extensions = [] then Ok ()

     

       125
       +
         else

     

       126
       +
           let* () = output_element_start writer "extensions" [] in

     

       127
       +
           (* For now, skip writing extension content - would need full extension serialization *)

     

       128
       +
           output_element_end writer

     

       129
       +
       

     

       130
       +
       (** Write metadata element *)

     

       131
       +
       let output_metadata writer metadata =

     

       132
        
         let* () = output_element_start writer "metadata" [] in

     

       133
       +
         let* () = output_optional_text_element writer "name" (Metadata.name metadata) in

     

       134
       +
         let* () = output_optional_text_element writer "desc" (Metadata.description metadata) in

     

       135
       +
         let* () = match Metadata.author metadata with

     

       136
       +
           | Some author -> output_person writer author

     

       137
       +
           | None -> Ok ()

     

       138
       +
         in

     

       139
       +
         let* () = match Metadata.copyright metadata with

     

       140
       +
           | Some copyright -> output_copyright writer copyright

     

       141
       +
           | None -> Ok ()

     

       142
       +
         in

     

       143
       +
         let* () = output_links writer (Metadata.links metadata) in

     

       144
       +
         let* () = output_optional_time_element writer "time" (Metadata.time metadata) in

     

       145
       +
         let* () = output_optional_text_element writer "keywords" (Metadata.keywords metadata) in

     

       146
       +
         let* () = match Metadata.bounds_opt metadata with

     

       147
       +
           | Some bounds -> output_bounds writer bounds

     

       148
       +
           | None -> Ok ()

     

       149
       +
         in

     

       150
       +
         let* () = output_extensions writer (Metadata.extensions metadata) in

     

       0
        
       
     

       151
        
         output_element_end writer

     

       152
        
       

     

       153
       +
       (** Write waypoint elements (used for wpt, rtept, trkpt) *)

     

       154
       +
       let output_waypoint_data writer waypoint =

     

       155
       +
         let* () = output_optional_float_element writer "ele" (Waypoint.elevation waypoint) in

     

       156
       +
         let* () = output_optional_time_element writer "time" (Waypoint.time waypoint) in

     

       157
       +
         let* () = output_optional_degrees_element writer "magvar" (Waypoint.magvar waypoint) in

     

       158
       +
         let* () = output_optional_float_element writer "geoidheight" (Waypoint.geoidheight waypoint) in

     

       159
       +
         let* () = output_optional_text_element writer "name" (Waypoint.name waypoint) in

     

       160
       +
         let* () = output_optional_text_element writer "cmt" (Waypoint.comment waypoint) in

     

       161
       +
         let* () = output_optional_text_element writer "desc" (Waypoint.description waypoint) in

     

       162
       +
         let* () = output_optional_text_element writer "src" (Waypoint.source waypoint) in

     

       163
       +
         let* () = output_links writer (Waypoint.links waypoint) in

     

       164
       +
         let* () = output_optional_text_element writer "sym" (Waypoint.symbol waypoint) in

     

       165
       +
         let* () = output_optional_text_element writer "type" (Waypoint.type_ waypoint) in

     

       166
       +
         let* () = output_optional_fix_element writer "fix" (Waypoint.fix waypoint) in

     

       167
       +
         let* () = output_optional_int_element writer "sat" (Waypoint.sat waypoint) in

     

       168
       +
         let* () = output_optional_float_element writer "hdop" (Waypoint.hdop waypoint) in

     

       169
       +
         let* () = output_optional_float_element writer "vdop" (Waypoint.vdop waypoint) in

     

       170
       +
         let* () = output_optional_float_element writer "pdop" (Waypoint.pdop waypoint) in

     

       171
       +
         let* () = output_optional_float_element writer "ageofdgpsdata" (Waypoint.ageofdgpsdata waypoint) in

     

       172
       +
         let* () = output_optional_int_element writer "dgpsid" (Waypoint.dgpsid waypoint) in

     

       173
       +
         output_extensions writer (Waypoint.extensions waypoint)

     

       174
       +
       

     

       175
       +
       (** Write waypoints *)

     

       176
       +
       let output_waypoints writer waypoints =

     

       177
       +
         let rec write_waypoints = function

     

       178
       +
           | [] -> Ok ()

     

       179
       +
           | wpt :: rest ->

     

       180
       +
               let lat = Coordinate.latitude_to_float (Waypoint.lat wpt) in

     

       181
       +
               let lon = Coordinate.longitude_to_float (Waypoint.lon wpt) in

     

       182
       +
               let attrs = [

     

       183
       +
                 (("", "lat"), Printf.sprintf "%.6f" lat);

     

       184
       +
                 (("", "lon"), Printf.sprintf "%.6f" lon);

     

       185
       +
               ] in

     

       186
       +
               let* () = output_element_start writer "wpt" attrs in

     

       187
       +
               let* () = output_waypoint_data writer wpt in

     

       188
       +
               let* () = output_element_end writer in

     

       189
       +
               write_waypoints rest

     

       190
        
         in

     

       191
       +
         write_waypoints waypoints

     

       192
        
       

     

       193
       +
       (** Write route points *)

     

       194
       +
       let output_route_points writer points element_name =

     

       195
       +
         let rec write_points = function

     

       196
       +
           | [] -> Ok ()

     

       197
       +
           | pt :: rest ->

     

       198
       +
               let lat = Coordinate.latitude_to_float (Waypoint.lat pt) in

     

       199
       +
               let lon = Coordinate.longitude_to_float (Waypoint.lon pt) in

     

       200
       +
               let attrs = [

     

       201
       +
                 (("", "lat"), Printf.sprintf "%.6f" lat);

     

       202
       +
                 (("", "lon"), Printf.sprintf "%.6f" lon);

     

       203
       +
               ] in

     

       204
       +
               let* () = output_element_start writer element_name attrs in

     

       205
       +
               let* () = output_waypoint_data writer pt in

     

       206
       +
               let* () = output_element_end writer in

     

       207
       +
               write_points rest

     

       208
        
         in

     

       209
       +
         write_points points

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       210
        
       

     

       211
       +
       (** Write routes *)

     

       212
       +
       let output_routes writer routes =

     

       213
       +
         let rec write_routes = function

     

       214
       +
           | [] -> Ok ()

     

       215
       +
           | route :: rest ->

     

       216
       +
               let* () = output_element_start writer "rte" [] in

     

       217
       +
               let* () = output_optional_text_element writer "name" (Route.name route) in

     

       218
       +
               let* () = output_optional_text_element writer "cmt" (Route.comment route) in

     

       219
       +
               let* () = output_optional_text_element writer "desc" (Route.description route) in

     

       220
       +
               let* () = output_optional_text_element writer "src" (Route.source route) in

     

       221
       +
               let* () = output_links writer (Route.links route) in

     

       222
       +
               let* () = output_optional_int_element writer "number" (Route.number route) in

     

       223
       +
               let* () = output_optional_text_element writer "type" (Route.type_ route) in

     

       224
       +
               let* () = output_extensions writer (Route.extensions route) in

     

       225
       +
               let* () = output_route_points writer (Route.points route) "rtept" in

     

       226
       +
               let* () = output_element_end writer in

     

       227
       +
               write_routes rest

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       228
        
         in

     

       229
       +
         write_routes routes

     

       230
        
       

     

       231
       +
       (** Write track segments *)

     

       232
       +
       let output_track_segments writer segments =

     

       233
       +
         let rec write_segments = function

     

       234
       +
           | [] -> Ok ()

     

       235
       +
           | seg :: rest ->

     

       236
       +
               let* () = output_element_start writer "trkseg" [] in

     

       237
       +
               let* () = output_route_points writer (Track.Segment.points seg) "trkpt" in

     

       238
       +
               let* () = output_extensions writer (Track.Segment.extensions seg) in

     

       239
       +
               let* () = output_element_end writer in

     

       240
       +
               write_segments rest

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       241
        
         in

     

       242
       +
         write_segments segments

     

       243
       +
       

     

       244
       +
       (** Write tracks *)

     

       245
       +
       let output_tracks writer tracks =

     

       246
       +
         let rec write_tracks = function

     

       247
       +
           | [] -> Ok ()

     

       248
       +
           | track :: rest ->

     

       249
       +
               let* () = output_element_start writer "trk" [] in

     

       250
       +
               let* () = output_optional_text_element writer "name" (Track.name track) in

     

       251
       +
               let* () = output_optional_text_element writer "cmt" (Track.comment track) in

     

       252
       +
               let* () = output_optional_text_element writer "desc" (Track.description track) in

     

       253
       +
               let* () = output_optional_text_element writer "src" (Track.source track) in

     

       254
       +
               let* () = output_links writer (Track.links track) in

     

       255
       +
               let* () = output_optional_int_element writer "number" (Track.number track) in

     

       256
       +
               let* () = output_optional_text_element writer "type" (Track.type_ track) in

     

       257
       +
               let* () = output_extensions writer (Track.extensions track) in

     

       258
       +
               let* () = output_track_segments writer (Track.segments track) in

     

       259
       +
               let* () = output_element_end writer in

     

       260
       +
               write_tracks rest

     

       261
        
         in

     

       262
       +
         write_tracks tracks

     

       263
       +
       

     

       264
       +
       (** Write a complete GPX document *)

     

       265
       +
       let write ?(validate=false) output gpx =

     

       266
       +
         let writer = Xmlm.make_output output in

     

       267
       +
         

     

       268
       +
         let result =

     

       269
       +
           try

     

       270
       +
             (* Write XML declaration and GPX root element *)

     

       271
       +
             let version = Doc.version gpx in

     

       272
       +
             let creator = Doc.creator gpx in

     

       273
       +
             let attrs = [

     

       274
       +
               (("", "version"), version);

     

       275
       +
               (("", "creator"), creator);

     

       276
       +
               (("", "xsi:schemaLocation"), "http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd");

     

       277
       +
               (("xmlns", "xsi"), "http://www.w3.org/2001/XMLSchema-instance");

     

       278
       +
               (("", "xmlns"), "http://www.topografix.com/GPX/1/1")

     

       279
       +
             ] in

     

       280
       +
             

     

       281
       +
             let* () = output_element_start writer "gpx" attrs in

     

       282
       +
             

     

       283
       +
             (* Write metadata if present *)

     

       284
       +
             let* () = match Doc.metadata gpx with

     

       285
       +
               | Some metadata -> output_metadata writer metadata

     

       286
       +
               | None -> Ok ()

     

       287
       +
             in

     

       288
       +
             

     

       289
       +
             (* Write waypoints *)

     

       290
       +
             let* () = output_waypoints writer (Doc.waypoints gpx) in

     

       291
       +
             

     

       292
       +
             (* Write routes *)

     

       293
       +
             let* () = output_routes writer (Doc.routes gpx) in

     

       294
       +
             

     

       295
       +
             (* Write tracks *)

     

       296
       +
             let* () = output_tracks writer (Doc.tracks gpx) in

     

       297
       +
             

     

       298
       +
             (* Write root-level extensions *)

     

       299
       +
             let* () = output_extensions writer (Doc.extensions gpx) in

     

       300
       +
             

     

       301
       +
             output_element_end writer

     

       302
       +
             

     

       303
       +
           with

     

       304
       +
           | Xmlm.Error ((line, col), error) ->

     

       305
       +
             Error (Error.xml_error (Printf.sprintf "XML error at line %d, column %d: %s"

     

       306
       +
                              line col (Xmlm.error_message error)))

     

       307
       +
           | exn ->

     

       308
       +
             Error (Error.xml_error (Printexc.to_string exn))

     

       309
        
         in

     

       310
       +
         

     

       311
       +
         match result, validate with

     

       312
       +
         | Ok (), true ->

     

       313
       +
           let validation = Validate.validate_gpx gpx in

     

       314
       +
           if validation.is_valid then

     

       315
       +
             Ok ()

     

       316
       +
           else

     

       317
       +
             let error_msgs = List.filter (fun issue -> issue.Validate.level = `Error) validation.issues

     

       318
       +
                             |> List.map (fun issue -> issue.Validate.message)

     

       319
       +
                             |> String.concat "; " in

     

       320
       +
             Error (Error.validation_error error_msgs)

     

       321
       +
         | result, false -> result

     

       322
       +
         | Error _ as result, true -> result (* Pass through write errors even when validating *)

     

       323
        
       

     

       324
       +
       (** Write GPX to string *)

     

       325
       +
       let write_string ?(validate=false) gpx =

     

       326
        
         let buffer = Buffer.create 1024 in

     

       327
       +
         let dest = `Buffer buffer in

     

       328
       +
         let* () = write ~validate dest gpx in

     

       329
       +
         Ok (Buffer.contents buffer)
     

       0
        
       
     

       0

+2 -4

lib/gpx/writer.mli

···

       1
        
       (** GPX streaming writer using xmlm *)

     

       2
        
       

     

       3
       -
       open Types

     

       4
       -
       

     

       5
        
       (** Write a GPX document to an xmlm output destination *)

     

       6
       -
       val write : Xmlm.output -> gpx -> unit result

     

       7
        
       

     

       8
        
       (** Write a GPX document to a string *)

     

       9
       -
       val write_string : gpx -> string result

···

       1
        
       (** GPX streaming writer using xmlm *)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (** Write a GPX document to an xmlm output destination *)

     

       4
       +
       val write : ?validate:bool -> Xmlm.dest -> Doc.t -> (unit, Error.t) result

     

       5
        
       

     

       6
        
       (** Write a GPX document to a string *)

     

       7
       +
       val write_string : ?validate:bool -> Doc.t -> (string, Error.t) result

+1 -1

lib/gpx_eio/dune

···

       2
        
        (public_name mlgpx.eio)

     

       3
        
        (name gpx_eio)

     

       4
        
        (libraries eio xmlm ptime gpx)

     

       5
       -
        (modules gpx_io gpx_eio))

···

       2
        
        (public_name mlgpx.eio)

     

       3
        
        (name gpx_eio)

     

       4
        
        (libraries eio xmlm ptime gpx)

     

       5
       +
        (modules gpx_io gpx_eio))

+11 -141

lib/gpx_eio/gpx_eio.ml

···

       1
       -
       (** High-level Eio API for GPX operations *)

     

       2
        
       

     

       3
       -
       (* I/O module *)

     

       4
        
       module IO = Gpx_io

     

       5
       -
       

     

       6
       -
       (** Convenience functions for common operations *)

     

       7
        
       

     

       8
        
       (** Read and parse GPX file *)

     

       9
       -
       let read ~fs path = IO.read_file ~fs path

     

       10
       -
       

     

       11
       -
       (** Read and parse GPX file with validation *)

     

       12
       -
       let read_validated ~fs path = IO.read_file_validated ~fs path

     

       13
        
       

     

       14
        
       (** Write GPX to file *)

     

       15
       -
       let write ~fs path gpx = IO.write_file ~fs path gpx

     

       16
       -
       

     

       17
       -
       (** Write GPX to file with validation *)

     

       18
       -
       let write_validated ~fs path gpx = IO.write_file_validated ~fs path gpx

     

       19
        
       

     

       20
        
       (** Write GPX to file with backup *)

     

       21
       -
       let write_with_backup ~fs path gpx = IO.write_file_with_backup ~fs path gpx

     

       22
        
       

     

       23
        
       (** Read GPX from Eio source *)

     

       24
       -
       let from_source source = IO.read_source source

     

       25
        
       

     

       26
        
       (** Write GPX to Eio sink *)

     

       27
       -
       let to_sink sink gpx = IO.write_sink sink gpx

     

       28
       -
       

     

       29
       -
       (** Read GPX from Eio source with validation *)

     

       30
       -
       let from_source_validated source = IO.read_source_validated source

     

       31
       -
       

     

       32
       -
       (** Write GPX to Eio sink with validation *)

     

       33
       -
       let to_sink_validated sink gpx = IO.write_sink_validated sink gpx

     

       34
       -
       

     

       35
       -
       (** Create simple waypoint *)

     

       36
       -
       let make_waypoint ~fs:_ ~lat ~lon ?name ?desc () =

     

       37
       -
         match Gpx.latitude lat, Gpx.longitude lon with

     

       38
       -
         | Ok lat, Ok lon ->

     

       39
       -
           let wpt = Gpx.make_waypoint_data lat lon in

     

       40
       -
           { wpt with name; desc }

     

       41
       -
         | Error e, _ | _, Error e -> raise (Gpx.Gpx_error (Gpx.Invalid_coordinate e))

     

       42
       -
       

     

       43
       -
       (** Create simple track from coordinate list *)

     

       44
       -
       let make_track_from_coords ~fs:_ ~name coords =

     

       45
       -
         let make_trkpt (lat_f, lon_f) =

     

       46
       -
           match Gpx.latitude lat_f, Gpx.longitude lon_f with

     

       47
       -
           | Ok lat, Ok lon -> Gpx.make_waypoint_data lat lon

     

       48
       -
           | Error e, _ | _, Error e -> raise (Gpx.Gpx_error (Gpx.Invalid_coordinate e))

     

       49
       -
         in

     

       50
       -
         let trkpts = List.map make_trkpt coords in

     

       51
       -
         let trkseg : Gpx.track_segment = { trkpts; extensions = [] } in

     

       52
       -
         ({

     

       53
       -
           name = Some name;

     

       54
       -
           cmt = None; desc = None; src = None; links = [];

     

       55
       -
           number = None; type_ = None; extensions = [];

     

       56
       -
           trksegs = [trkseg];

     

       57
       -
         } : Gpx.track)

     

       58
       -
       

     

       59
       -
       (** Create simple route from coordinate list *)

     

       60
       -
       let make_route_from_coords ~fs:_ ~name coords =

     

       61
       -
         let make_rtept (lat_f, lon_f) =

     

       62
       -
           match Gpx.latitude lat_f, Gpx.longitude lon_f with

     

       63
       -
           | Ok lat, Ok lon -> Gpx.make_waypoint_data lat lon

     

       64
       -
           | Error e, _ | _, Error e -> raise (Gpx.Gpx_error (Gpx.Invalid_coordinate e))

     

       65
       -
         in

     

       66
       -
         let rtepts = List.map make_rtept coords in

     

       67
       -
         ({

     

       68
       -
           name = Some name;

     

       69
       -
           cmt = None; desc = None; src = None; links = [];

     

       70
       -
           number = None; type_ = None; extensions = [];

     

       71
       -
           rtepts;

     

       72
       -
         } : Gpx.route)

     

       73
       -
       

     

       74
       -
       (** Extract coordinates from waypoints *)

     

       75
       -
       let waypoint_coords (wpt : Gpx.waypoint_data) =

     

       76
       -
         (Gpx.latitude_to_float wpt.lat, Gpx.longitude_to_float wpt.lon)

     

       77
       -
       

     

       78
       -
       (** Extract coordinates from track *)

     

       79
       -
       let track_coords (track : Gpx.track) =

     

       80
       -
         List.fold_left (fun acc (trkseg : Gpx.track_segment) ->

     

       81
       -
           List.fold_left (fun acc trkpt ->

     

       82
       -
             waypoint_coords trkpt :: acc

     

       83
       -
           ) acc trkseg.trkpts

     

       84
       -
         ) [] track.trksegs

     

       85
       -
         |> List.rev

     

       86
       -
       

     

       87
       -
       (** Extract coordinates from route *)

     

       88
       -
       let route_coords (route : Gpx.route) =

     

       89
       -
         List.map waypoint_coords route.rtepts

     

       90
       -
       

     

       91
       -
       (** Count total points in GPX *)

     

       92
       -
       let count_points (gpx : Gpx.gpx) =

     

       93
       -
         let waypoint_count = List.length gpx.waypoints in

     

       94
       -
         let route_count = List.fold_left (fun acc (route : Gpx.route) ->

     

       95
       -
           acc + List.length route.rtepts

     

       96
       -
         ) 0 gpx.routes in

     

       97
       -
         let track_count = List.fold_left (fun acc (track : Gpx.track) ->

     

       98
       -
           List.fold_left (fun acc (trkseg : Gpx.track_segment) ->

     

       99
       -
             acc + List.length trkseg.trkpts

     

       100
       -
           ) acc track.trksegs

     

       101
       -
         ) 0 gpx.tracks in

     

       102
       -
         waypoint_count + route_count + track_count

     

       103
       -
       

     

       104
       -
       (** Get GPX statistics *)

     

       105
       -
       type gpx_stats = {

     

       106
       -
         waypoint_count : int;

     

       107
       -
         route_count : int;

     

       108
       -
         track_count : int;

     

       109
       -
         total_points : int;

     

       110
       -
         has_elevation : bool;

     

       111
       -
         has_time : bool;

     

       112
       -
       }

     

       113
       -
       

     

       114
       -
       let get_stats (gpx : Gpx.gpx) =

     

       115
       -
         let waypoint_count = List.length gpx.waypoints in

     

       116
       -
         let route_count = List.length gpx.routes in

     

       117
       -
         let track_count = List.length gpx.tracks in

     

       118
       -
         let total_points = count_points gpx in

     

       119
       -
         

     

       120
       -
         let has_elevation = 

     

       121
       -
           List.exists (fun (wpt : Gpx.waypoint_data) -> wpt.ele <> None) gpx.waypoints ||

     

       122
       -
           List.exists (fun (route : Gpx.route) -> 

     

       123
       -
             List.exists (fun (rtept : Gpx.waypoint_data) -> rtept.ele <> None) route.rtepts

     

       124
       -
           ) gpx.routes ||

     

       125
       -
           List.exists (fun (track : Gpx.track) ->

     

       126
       -
             List.exists (fun (trkseg : Gpx.track_segment) ->

     

       127
       -
               List.exists (fun (trkpt : Gpx.waypoint_data) -> trkpt.ele <> None) trkseg.trkpts

     

       128
       -
             ) track.trksegs

     

       129
       -
           ) gpx.tracks

     

       130
       -
         in

     

       131
       -
         

     

       132
       -
         let has_time =

     

       133
       -
           List.exists (fun (wpt : Gpx.waypoint_data) -> wpt.time <> None) gpx.waypoints ||

     

       134
       -
           List.exists (fun (route : Gpx.route) ->

     

       135
       -
             List.exists (fun (rtept : Gpx.waypoint_data) -> rtept.time <> None) route.rtepts

     

       136
       -
           ) gpx.routes ||

     

       137
       -
           List.exists (fun (track : Gpx.track) ->

     

       138
       -
             List.exists (fun (trkseg : Gpx.track_segment) ->

     

       139
       -
               List.exists (fun (trkpt : Gpx.waypoint_data) -> trkpt.time <> None) trkseg.trkpts

     

       140
       -
             ) track.trksegs

     

       141
       -
           ) gpx.tracks

     

       142
       -
         in

     

       143
       -
         

     

       144
       -
         { waypoint_count; route_count; track_count; total_points; has_elevation; has_time }

     

       145
        
       

     

       146
        
       (** Pretty print GPX statistics *)

     

       147
       -
       let print_stats (gpx : Gpx.gpx) =

     

       148
       -
         let stats = get_stats gpx in

     

       149
       -
         Printf.printf "GPX Statistics:\n";

     

       150
       -
         Printf.printf "  Waypoints: %d\n" stats.waypoint_count;

     

       151
       -
         Printf.printf "  Routes: %d\n" stats.route_count;

     

       152
       -
         Printf.printf "  Tracks: %d\n" stats.track_count;

     

       153
       -
         Printf.printf "  Total points: %d\n" stats.total_points;

     

       154
       -
         Printf.printf "  Has elevation data: %s\n" (if stats.has_elevation then "yes" else "no");

     

       155
       -
         Printf.printf "  Has time data: %s\n" (if stats.has_time then "yes" else "no")

···

       1
       +
       (** Eio API for GPX operations *)

     

       2
        
       

     

       0
        
       
     

       3
        
       module IO = Gpx_io

     

       0
        
       
     

       0
        
       
     

       4
        
       

     

       5
        
       (** Read and parse GPX file *)

     

       6
       +
       let read ?(validate=false) ~fs path = IO.read_file ~validate ~fs path

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       7
        
       

     

       8
        
       (** Write GPX to file *)

     

       9
       +
       let write ?(validate=false) ~fs path gpx = IO.write_file ~validate ~fs path gpx

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       10
        
       

     

       11
        
       (** Write GPX to file with backup *)

     

       12
       +
       let write_with_backup ?(validate=false) ~fs path gpx = IO.write_file_with_backup ~validate ~fs path gpx

     

       13
        
       

     

       14
        
       (** Read GPX from Eio source *)

     

       15
       +
       let from_source ?(validate=false) source = IO.read_source ~validate source

     

       16
        
       

     

       17
        
       (** Write GPX to Eio sink *)

     

       18
       +
       let to_sink ?(validate=false) sink gpx = IO.write_sink ~validate sink gpx

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       19
        
       

     

       20
        
       (** Pretty print GPX statistics *)

     

       21
       +
       let print_stats sink gpx =

     

       22
       +
         let buf = Buffer.create 256 in

     

       23
       +
         let fmt = Format.formatter_of_buffer buf in

     

       24
       +
         Format.fprintf fmt "%a@?" Gpx.Doc.pp_stats gpx;

     

       25
       +
         Eio.Flow.copy_string (Buffer.contents buf) sink

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

+23 -115

lib/gpx_eio/gpx_eio.mli

···

       1
       -
       (** {1 GPX Eio - High-level Eio API for GPX operations}

     

       2
        
       

     

       3
       -
           This module provides a high-level API for GPX operations using Eio's 

     

       4
        
           effects-based concurrent I/O system. It offers convenient functions

     

       5
        
           for common GPX operations while maintaining structured concurrency.

     

       6
        
       

     

       7
       -
           {2 Key Features}

     

       8
       -
       

     

       9
       -
           - Effects-based I/O using Eio

     

       10
       -
           - Structured concurrency compatible

     

       11
       -
           - Resource-safe operations

     

       12
       -
           - Exception-based error handling (raises [Gpx.Gpx_error])

     

       13
       -
           - Concurrent processing capabilities

     

       14
       -
       

     

       15
        
           {2 Usage Example}

     

       16
        
       

     

       17
        
           {[

     
···

       21
        
               let fs = Eio.Stdenv.fs env in

     

       22
        
               

     

       23
        
               (* Create a GPX document *)

     

       24
       -
               let lat = Gpx.latitude 37.7749 |> Result.get_ok in

     

       25
       -
               let lon = Gpx.longitude (-122.4194) |> Result.get_ok in

     

       26
       -
               let wpt = make_waypoint fs ~lat:(Gpx.latitude_to_float lat) ~lon:(Gpx.longitude_to_float lon) ~name:"San Francisco" () in

     

       27
       -
               let gpx = Gpx.make_gpx ~creator:"eio-example" in

     

       28
       -
               let gpx = { gpx with waypoints = [wpt] } in

     

       29
        
               

     

       30
        
               (* Write with validation *)

     

       31
       -
               write_validated fs "output.gpx" gpx;

     

       32
        
               

     

       33
        
               (* Read it back *)

     

       34
       -
               let gpx2 = read_validated fs "output.gpx" in

     

       35
       -
               Printf.printf "Read %d waypoints\n" (List.length gpx2.waypoints)

     

       36
        
       

     

       37
        
             let () = Eio_main.run main

     

       38
        
           ]}

     
···

       44
        
       

     

       45
        
       (** {2 Convenience File Operations}

     

       46
        
       

     

       47
       -
           These functions provide simple file I/O with the filesystem from [Eio.Stdenv.fs]. *)

     

       48
        
       

     

       49
        
       (** Read and parse GPX file.

     

       50
        
           @param fs Filesystem capability

     

       51
        
           @param path File path to read

     

       0
        
       
     

       52
        
           @return GPX document

     

       53
        
           @raises Gpx.Gpx_error on read or parse failure *)

     

       54
       -
       val read : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx

     

       55
       -
       

     

       56
       -
       (** Read and parse GPX file with validation.

     

       57
       -
           @param fs Filesystem capability  

     

       58
       -
           @param path File path to read

     

       59
       -
           @return Valid GPX document

     

       60
       -
           @raises Gpx.Gpx_error on validation failure *)

     

       61
       -
       val read_validated : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx

     

       62
        
       

     

       63
        
       (** Write GPX to file.

     

       64
        
           @param fs Filesystem capability

     

       65
        
           @param path File path to write

     

       66
        
           @param gpx GPX document to write

     

       0
        
       
     

       67
        
           @raises Gpx.Gpx_error on write failure *)

     

       68
       -
       val write : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx -> unit

     

       69
       -
       

     

       70
       -
       (** Write GPX to file with validation.

     

       71
       -
           @param fs Filesystem capability

     

       72
       -
           @param path File path to write

     

       73
       -
           @param gpx GPX document to write

     

       74
       -
           @raises Gpx.Gpx_error on validation or write failure *)

     

       75
       -
       val write_validated : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx -> unit

     

       76
        
       

     

       77
        
       (** Write GPX to file with automatic backup.

     

       78
        
           @param fs Filesystem capability

     

       79
        
           @param path File path to write

     

       80
        
           @param gpx GPX document to write

     

       0
        
       
     

       81
        
           @return Backup file path (empty if no backup created)

     

       82
        
           @raises Gpx.Gpx_error on failure *)

     

       83
       -
       val write_with_backup : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx -> string

     

       84
        
       

     

       85
        
       (** {2 Stream Operations}

     

       86
        
       

     
···

       88
        
       

     

       89
        
       (** Read GPX from Eio source.

     

       90
        
           @param source Input flow

     

       0
        
       
     

       91
        
           @return GPX document

     

       92
        
           @raises Gpx.Gpx_error on read or parse failure *)

     

       93
       -
       val from_source : [> Eio.Flow.source_ty ] Eio.Resource.t -> Gpx.gpx

     

       94
        
       

     

       95
        
       (** Write GPX to Eio sink.

     

       96
        
           @param sink Output flow

     

       97
        
           @param gpx GPX document

     

       0
        
       
     

       98
        
           @raises Gpx.Gpx_error on write failure *)

     

       99
       -
       val to_sink : [> Eio.Flow.sink_ty ] Eio.Resource.t -> Gpx.gpx -> unit

     

       100
       -
       

     

       101
       -
       (** Read GPX from Eio source with validation.

     

       102
       -
           @param source Input flow

     

       103
       -
           @return Valid GPX document

     

       104
       -
           @raises Gpx.Gpx_error on validation failure *)

     

       105
       -
       val from_source_validated : [> Eio.Flow.source_ty ] Eio.Resource.t -> Gpx.gpx

     

       106
       -
       

     

       107
       -
       (** Write GPX to Eio sink with validation.

     

       108
       -
           @param sink Output flow

     

       109
       -
           @param gpx GPX document

     

       110
       -
           @raises Gpx.Gpx_error on validation failure *)

     

       111
       -
       val to_sink_validated : [> Eio.Flow.sink_ty ] Eio.Resource.t -> Gpx.gpx -> unit

     

       112
       -
       

     

       113
       -
       (** {2 Utility Functions} *)

     

       114
       -
       

     

       115
       -
       (** Create simple waypoint with coordinates.

     

       116
       -
           @param fs Filesystem capability (unused, for API consistency)

     

       117
       -
           @param lat Latitude in degrees

     

       118
       -
           @param lon Longitude in degrees  

     

       119
       -
           @param ?name Optional waypoint name

     

       120
       -
           @param ?desc Optional waypoint description

     

       121
       -
           @return Waypoint data

     

       122
       -
           @raises Gpx.Gpx_error on invalid coordinates *)

     

       123
       -
       val make_waypoint : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> lat:float -> lon:float -> ?name:string -> ?desc:string -> unit -> Gpx.waypoint_data

     

       124
        
       

     

       125
       -
       (** Create track from coordinate list.

     

       126
       -
           @param fs Filesystem capability (unused, for API consistency)

     

       127
       -
           @param name Track name

     

       128
       -
           @param coords List of (latitude, longitude) pairs

     

       129
       -
           @return Track with single segment

     

       130
       -
           @raises Gpx.Gpx_error on invalid coordinates *)

     

       131
       -
       val make_track_from_coords : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> name:string -> (float * float) list -> Gpx.track

     

       132
       -
       

     

       133
       -
       (** Create route from coordinate list.

     

       134
       -
           @param fs Filesystem capability (unused, for API consistency)

     

       135
       -
           @param name Route name  

     

       136
       -
           @param coords List of (latitude, longitude) pairs

     

       137
       -
           @return Route

     

       138
       -
           @raises Gpx.Gpx_error on invalid coordinates *)

     

       139
       -
       val make_route_from_coords : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> name:string -> (float * float) list -> Gpx.route

     

       140
       -
       

     

       141
       -
       (** Extract coordinates from waypoint.

     

       142
       -
           @param wpt Waypoint data

     

       143
       -
           @return (latitude, longitude) as floats *)

     

       144
       -
       val waypoint_coords : Gpx.waypoint_data -> float * float

     

       145
       -
       

     

       146
       -
       (** Extract coordinates from track.

     

       147
       -
           @param track Track

     

       148
       -
           @return List of (latitude, longitude) pairs *)

     

       149
       -
       val track_coords : Gpx.track -> (float * float) list

     

       150
       -
       

     

       151
       -
       (** Extract coordinates from route.

     

       152
       -
           @param route Route

     

       153
       -
           @return List of (latitude, longitude) pairs *)

     

       154
       -
       val route_coords : Gpx.route -> (float * float) list

     

       155
       -
       

     

       156
       -
       (** Count total points in GPX document.

     

       157
       -
           @param gpx GPX document

     

       158
       -
           @return Total number of waypoints, route points, and track points *)

     

       159
       -
       val count_points : Gpx.gpx -> int

     

       160
       -
       

     

       161
       -
       (** GPX statistics record *)

     

       162
       -
       type gpx_stats = {

     

       163
       -
         waypoint_count : int;      (** Number of waypoints *)

     

       164
       -
         route_count : int;         (** Number of routes *)

     

       165
       -
         track_count : int;         (** Number of tracks *)

     

       166
       -
         total_points : int;        (** Total geographic points *)

     

       167
       -
         has_elevation : bool;      (** Document contains elevation data *)

     

       168
       -
         has_time : bool;          (** Document contains time data *)

     

       169
       -
       }

     

       170
       -
       

     

       171
       -
       (** Get GPX document statistics.

     

       172
       -
           @param gpx GPX document

     

       173
       -
           @return Statistics summary *)

     

       174
       -
       val get_stats : Gpx.gpx -> gpx_stats

     

       175
       -
       

     

       176
       -
       (** Print GPX statistics to stdout.

     

       177
        
           @param gpx GPX document *)

     

       178
       -
       val print_stats : Gpx.gpx -> unit

···

       1
       +
       (** {1 Eio API for GPX operations}

     

       2
        
       

     

       3
       +
           This module provides a direct-style API for GPX operations using Eio's 

     

       4
        
           effects-based concurrent I/O system. It offers convenient functions

     

       5
        
           for common GPX operations while maintaining structured concurrency.

     

       6
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       7
        
           {2 Usage Example}

     

       8
        
       

     

       9
        
           {[

     
···

       13
        
               let fs = Eio.Stdenv.fs env in

     

       14
        
               

     

       15
        
               (* Create a GPX document *)

     

       16
       +
               let lat = Gpx.Coordinate.latitude 37.7749 |> Result.get_ok in

     

       17
       +
               let lon = Gpx.Coordinate.longitude (-122.4194) |> Result.get_ok in

     

       18
       +
               let wpt = Gpx.Waypoint.make lat lon |> Gpx.Waypoint.with_name "San Francisco" in

     

       19
       +
               let gpx = Gpx.make_gpx ~creator:"eio-example" |> Gpx.Doc.add_waypoint wpt in

     

       0
        
       
     

       20
        
               

     

       21
        
               (* Write with validation *)

     

       22
       +
               write ~validate:true fs "output.gpx" gpx;

     

       23
        
               

     

       24
        
               (* Read it back *)

     

       25
       +
               let gpx2 = read ~validate:true fs "output.gpx" in

     

       26
       +
               Printf.printf "Read %d waypoints\n" (List.length (Gpx.Doc.waypoints gpx2))

     

       27
        
       

     

       28
        
             let () = Eio_main.run main

     

       29
        
           ]}

     
···

       35
        
       

     

       36
        
       (** {2 Convenience File Operations}

     

       37
        
       

     

       38
       +
           These functions provide simple file I/O with the filesystem from {!Eio.Stdenv.fs}. *)

     

       39
        
       

     

       40
        
       (** Read and parse GPX file.

     

       41
        
           @param fs Filesystem capability

     

       42
        
           @param path File path to read

     

       43
       +
           @param ?validate Optional validation flag (default: false)

     

       44
        
           @return GPX document

     

       45
        
           @raises Gpx.Gpx_error on read or parse failure *)

     

       46
       +
       val read : ?validate:bool -> fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.t

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       47
        
       

     

       48
        
       (** Write GPX to file.

     

       49
        
           @param fs Filesystem capability

     

       50
        
           @param path File path to write

     

       51
        
           @param gpx GPX document to write

     

       52
       +
           @param ?validate Optional validation flag (default: false)

     

       53
        
           @raises Gpx.Gpx_error on write failure *)

     

       54
       +
       val write : ?validate:bool -> fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.t -> unit

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       55
        
       

     

       56
        
       (** Write GPX to file with automatic backup.

     

       57
        
           @param fs Filesystem capability

     

       58
        
           @param path File path to write

     

       59
        
           @param gpx GPX document to write

     

       60
       +
           @param ?validate Optional validation flag (default: false)

     

       61
        
           @return Backup file path (empty if no backup created)

     

       62
        
           @raises Gpx.Gpx_error on failure *)

     

       63
       +
       val write_with_backup : ?validate:bool -> fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.t -> string

     

       64
        
       

     

       65
        
       (** {2 Stream Operations}

     

       66
        
       

     
···

       68
        
       

     

       69
        
       (** Read GPX from Eio source.

     

       70
        
           @param source Input flow

     

       71
       +
           @param ?validate Optional validation flag (default: false)

     

       72
        
           @return GPX document

     

       73
        
           @raises Gpx.Gpx_error on read or parse failure *)

     

       74
       +
       val from_source : ?validate:bool -> [> Eio.Flow.source_ty ] Eio.Resource.t -> Gpx.t

     

       75
        
       

     

       76
        
       (** Write GPX to Eio sink.

     

       77
        
           @param sink Output flow

     

       78
        
           @param gpx GPX document

     

       79
       +
           @param ?validate Optional validation flag (default: false)

     

       80
        
           @raises Gpx.Gpx_error on write failure *)

     

       81
       +
       val to_sink : ?validate:bool -> [> Eio.Flow.sink_ty ] Eio.Resource.t -> Gpx.t -> unit

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       82
        
       

     

       83
       +
       (** Print GPX statistics to sink.

     

       84
       +
           @param sink Output sink

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       85
        
           @param gpx GPX document *)

     

       86
       +
       val print_stats : [> Eio.Flow.sink_ty ] Eio.Resource.t -> Gpx.t -> unit

+12 -56

lib/gpx_eio/gpx_io.ml

···

       1
        
       (** GPX Eio I/O operations *)

     

       2
        
       

     

       3
       -
       (* Real Eio-based I/O operations *)

     

       4
       -
       

     

       5
        
       (** Read GPX from file path *)

     

       6
       -
       let read_file ~fs path =

     

       7
        
         let content = Eio.Path.load Eio.Path.(fs / path) in

     

       8
       -
         match Gpx.parse_string content with

     

       9
        
         | Ok gpx -> gpx

     

       10
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       11
        
       

     

       12
        
       (** Write GPX to file path *)

     

       13
       -
       let write_file ~fs path gpx =

     

       14
       -
         match Gpx.write_string gpx with

     

       15
        
         | Ok xml_string -> 

     

       16
        
           Eio.Path.save ~create:(`Or_truncate 0o644) Eio.Path.(fs / path) xml_string

     

       17
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       18
        
       

     

       19
       -
       (** Read GPX from file with validation *)

     

       20
       -
       let read_file_validated ~fs path =

     

       21
       -
         let gpx = read_file ~fs path in

     

       22
       -
         let validation = Gpx.validate_gpx gpx in

     

       23
       -
         if validation.is_valid then

     

       24
       -
           gpx

     

       25
       -
         else

     

       26
       -
           let errors = Gpx.get_errors gpx in

     

       27
       -
           let error_msgs = List.map Gpx.format_issue errors in

     

       28
       -
           raise (Gpx.Gpx_error (Gpx.Validation_error (String.concat "; " error_msgs)))

     

       29
       -
       

     

       30
       -
       (** Write GPX to file with validation *)

     

       31
       -
       let write_file_validated ~fs path gpx =

     

       32
       -
         let validation = Gpx.validate_gpx gpx in

     

       33
       -
         if not validation.is_valid then

     

       34
       -
           let errors = Gpx.get_errors gpx in

     

       35
       -
           let error_msgs = List.map Gpx.format_issue errors in

     

       36
       -
           raise (Gpx.Gpx_error (Gpx.Validation_error (String.concat "; " error_msgs)))

     

       37
       -
         else

     

       38
       -
           write_file ~fs path gpx

     

       39
       -
       

     

       40
        
       (** Read GPX from Eio source *)

     

       41
       -
       let read_source source =

     

       42
        
         let content = Eio.Flow.read_all source in

     

       43
       -
         match Gpx.parse_string content with

     

       44
        
         | Ok gpx -> gpx

     

       45
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       46
        
       

     

       47
        
       (** Write GPX to Eio sink *)

     

       48
       -
       let write_sink sink gpx =

     

       49
       -
         match Gpx.write_string gpx with

     

       50
        
         | Ok xml_string -> 

     

       51
        
           Eio.Flow.copy_string xml_string sink

     

       52
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       53
        
       

     

       54
       -
       (** Read GPX from Eio source with validation *)

     

       55
       -
       let read_source_validated source =

     

       56
       -
         let gpx = read_source source in

     

       57
       -
         let validation = Gpx.validate_gpx gpx in

     

       58
       -
         if validation.is_valid then

     

       59
       -
           gpx

     

       60
       -
         else

     

       61
       -
           let errors = Gpx.get_errors gpx in

     

       62
       -
           let error_msgs = List.map Gpx.format_issue errors in

     

       63
       -
           raise (Gpx.Gpx_error (Gpx.Validation_error (String.concat "; " error_msgs)))

     

       64
       -
       

     

       65
       -
       (** Write GPX to Eio sink with validation *)

     

       66
       -
       let write_sink_validated sink gpx =

     

       67
       -
         let validation = Gpx.validate_gpx gpx in

     

       68
       -
         if not validation.is_valid then

     

       69
       -
           let errors = Gpx.get_errors gpx in

     

       70
       -
           let error_msgs = List.map Gpx.format_issue errors in

     

       71
       -
           raise (Gpx.Gpx_error (Gpx.Validation_error (String.concat "; " error_msgs)))

     

       72
       -
         else

     

       73
       -
           write_sink sink gpx

     

       74
       -
       

     

       75
        
       (** Check if file exists *)

     

       76
        
       let file_exists ~fs path =

     

       77
        
         try

     
···

       86
        
           let stat = Eio.Path.stat ~follow:true Eio.Path.(fs / path) in

     

       87
        
           Optint.Int63.to_int stat.size

     

       88
        
         with

     

       89
       -
         | exn -> raise (Gpx.Gpx_error (Gpx.IO_error (Printexc.to_string exn)))

     

       90
        
       

     

       91
        
       (** Create backup of existing file *)

     

       92
        
       let create_backup ~fs path =

     
···

       99
        
           ""

     

       100
        
       

     

       101
        
       (** Write GPX to file with automatic backup *)

     

       102
       -
       let write_file_with_backup ~fs path gpx =

     

       103
        
         let backup_path = create_backup ~fs path in

     

       104
        
         try

     

       105
       -
           write_file ~fs path gpx;

     

       106
        
           backup_path

     

       107
        
         with

     

       108
        
         | Gpx.Gpx_error _ as err ->

     
···

       113
        
               Eio.Path.save ~create:(`Or_truncate 0o644) Eio.Path.(fs / path) backup_content

     

       114
        
             with _ -> () (* Ignore restore errors *)

     

       115
        
           );

     

       116
       -
           raise err

···

       1
        
       (** GPX Eio I/O operations *)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (** Read GPX from file path *)

     

       4
       +
       let read_file ?(validate=false) ~fs path =

     

       5
        
         let content = Eio.Path.load Eio.Path.(fs / path) in

     

       6
       +
         match Gpx.parse_string ~validate content with

     

       7
        
         | Ok gpx -> gpx

     

       8
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       9
        
       

     

       10
        
       (** Write GPX to file path *)

     

       11
       +
       let write_file ?(validate=false) ~fs path gpx =

     

       12
       +
         match Gpx.write_string ~validate gpx with

     

       13
        
         | Ok xml_string -> 

     

       14
        
           Eio.Path.save ~create:(`Or_truncate 0o644) Eio.Path.(fs / path) xml_string

     

       15
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       16
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       17
        
       (** Read GPX from Eio source *)

     

       18
       +
       let read_source ?(validate=false) source =

     

       19
        
         let content = Eio.Flow.read_all source in

     

       20
       +
         match Gpx.parse_string ~validate content with

     

       21
        
         | Ok gpx -> gpx

     

       22
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       23
        
       

     

       24
        
       (** Write GPX to Eio sink *)

     

       25
       +
       let write_sink ?(validate=false) sink gpx =

     

       26
       +
         match Gpx.write_string ~validate gpx with

     

       27
        
         | Ok xml_string -> 

     

       28
        
           Eio.Flow.copy_string xml_string sink

     

       29
        
         | Error err -> raise (Gpx.Gpx_error err)

     

       30
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       31
        
       (** Check if file exists *)

     

       32
        
       let file_exists ~fs path =

     

       33
        
         try

     
···

       42
        
           let stat = Eio.Path.stat ~follow:true Eio.Path.(fs / path) in

     

       43
        
           Optint.Int63.to_int stat.size

     

       44
        
         with

     

       45
       +
         | exn -> raise (Gpx.Gpx_error (Gpx.Error.io_error (Printexc.to_string exn)))

     

       46
        
       

     

       47
        
       (** Create backup of existing file *)

     

       48
        
       let create_backup ~fs path =

     
···

       55
        
           ""

     

       56
        
       

     

       57
        
       (** Write GPX to file with automatic backup *)

     

       58
       +
       let write_file_with_backup ?(validate=false) ~fs path gpx =

     

       59
        
         let backup_path = create_backup ~fs path in

     

       60
        
         try

     

       61
       +
           write_file ~validate ~fs path gpx;

     

       62
        
           backup_path

     

       63
        
         with

     

       64
        
         | Gpx.Gpx_error _ as err ->

     
···

       69
        
               Eio.Path.save ~create:(`Or_truncate 0o644) Eio.Path.(fs / path) backup_content

     

       70
        
             with _ -> () (* Ignore restore errors *)

     

       71
        
           );

     

       72
       +
           raise err

+11 -34

lib/gpx_eio/gpx_io.mli

···

       5
        
           compatible and work with Eio's resource management.

     

       6
        
       *)

     

       7
        
       

     

       8
       -
       (** {1 File Operations}

     

       9
       -
       

     

       10
       -
           All file operations require filesystem access capability. *)

     

       11
        
       

     

       12
        
       (** Read GPX from file path.

     

       13
        
           @param fs Filesystem capability

     

       14
        
           @param path File path to read

     

       0
        
       
     

       15
        
           @return GPX document or error *)

     

       16
       -
       val read_file : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx

     

       17
        
       

     

       18
        
       (** Write GPX to file path.

     

       19
        
           @param fs Filesystem capability  

     

       20
        
           @param path File path to write

     

       21
        
           @param gpx GPX document to write

     

       0
        
       
     

       22
        
           @raises Gpx.Gpx_error on write failure *)

     

       23
       -
       val write_file : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx -> unit

     

       24
       -
       

     

       25
       -
       (** Read GPX from file with validation.

     

       26
       -
           @param fs Filesystem capability

     

       27
       -
           @param path File path to read

     

       28
       -
           @return Valid GPX document

     

       29
       -
           @raises Gpx.Gpx_error on validation failure *)

     

       30
       -
       val read_file_validated : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx

     

       31
       -
       

     

       32
       -
       (** Write GPX to file with validation.

     

       33
       -
           @param fs Filesystem capability

     

       34
       -
           @param path File path to write

     

       35
       -
           @param gpx GPX document to write

     

       36
       -
           @raises Gpx.Gpx_error on validation or write failure *)

     

       37
       -
       val write_file_validated : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx -> unit

     

       38
        
       

     

       39
        
       (** {1 Stream Operations}

     

       40
        
       

     
···

       42
        
       

     

       43
        
       (** Read GPX from Eio source.

     

       44
        
           @param source Input flow to read from

     

       0
        
       
     

       45
        
           @return GPX document *)

     

       46
       -
       val read_source : [> Eio.Flow.source_ty ] Eio.Resource.t -> Gpx.gpx

     

       47
        
       

     

       48
        
       (** Write GPX to Eio sink.

     

       49
        
           @param sink Output flow to write to

     

       50
       -
           @param gpx GPX document to write *)

     

       51
       -
       val write_sink : [> Eio.Flow.sink_ty ] Eio.Resource.t -> Gpx.gpx -> unit

     

       52
       -
       

     

       53
       -
       (** Read GPX from Eio source with validation.

     

       54
       -
           @param source Input flow to read from

     

       55
       -
           @return Valid GPX document

     

       56
       -
           @raises Gpx.Gpx_error on validation failure *)

     

       57
       -
       val read_source_validated : [> Eio.Flow.source_ty ] Eio.Resource.t -> Gpx.gpx

     

       58
       -
       

     

       59
       -
       (** Write GPX to Eio sink with validation.

     

       60
       -
           @param sink Output flow to write to

     

       61
        
           @param gpx GPX document to write

     

       62
       -
           @raises Gpx.Gpx_error on validation failure *)

     

       63
       -
       val write_sink_validated : [> Eio.Flow.sink_ty ] Eio.Resource.t -> Gpx.gpx -> unit

     

       64
        
       

     

       65
        
       (** {1 Utility Functions} *)

     

       66
        
       

     
···

       87
        
           @param fs Filesystem capability

     

       88
        
           @param path File path to write

     

       89
        
           @param gpx GPX document to write

     

       0
        
       
     

       90
        
           @return Backup file path (empty string if no backup needed) *)

     

       91
       -
       val write_file_with_backup : fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.gpx -> string

···

       5
        
           compatible and work with Eio's resource management.

     

       6
        
       *)

     

       7
        
       

     

       8
       +
       (** {1 File Operations} *)

     

       0
        
       
     

       0
        
       
     

       9
        
       

     

       10
        
       (** Read GPX from file path.

     

       11
        
           @param fs Filesystem capability

     

       12
        
           @param path File path to read

     

       13
       +
           @param ?validate Optional validation flag (default: false)

     

       14
        
           @return GPX document or error *)

     

       15
       +
       val read_file : ?validate:bool -> fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.t

     

       16
        
       

     

       17
        
       (** Write GPX to file path.

     

       18
        
           @param fs Filesystem capability  

     

       19
        
           @param path File path to write

     

       20
        
           @param gpx GPX document to write

     

       21
       +
           @param ?validate Optional validation flag (default: false)

     

       22
        
           @raises Gpx.Gpx_error on write failure *)

     

       23
       +
       val write_file : ?validate:bool -> fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.t -> unit

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       24
        
       

     

       25
        
       (** {1 Stream Operations}

     

       26
        
       

     
···

       28
        
       

     

       29
        
       (** Read GPX from Eio source.

     

       30
        
           @param source Input flow to read from

     

       31
       +
           @param ?validate Optional validation flag (default: false)

     

       32
        
           @return GPX document *)

     

       33
       +
       val read_source : ?validate:bool -> [> Eio.Flow.source_ty ] Eio.Resource.t -> Gpx.t

     

       34
        
       

     

       35
        
       (** Write GPX to Eio sink.

     

       36
        
           @param sink Output flow to write to

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       37
        
           @param gpx GPX document to write

     

       38
       +
           @param ?validate Optional validation flag (default: false) *)

     

       39
       +
       val write_sink : ?validate:bool -> [> Eio.Flow.sink_ty ] Eio.Resource.t -> Gpx.t -> unit

     

       40
        
       

     

       41
        
       (** {1 Utility Functions} *)

     

       42
        
       

     
···

       63
        
           @param fs Filesystem capability

     

       64
        
           @param path File path to write

     

       65
        
           @param gpx GPX document to write

     

       66
       +
           @param ?validate Optional validation flag (default: false)

     

       67
        
           @return Backup file path (empty string if no backup needed) *)

     

       68
       +
       val write_file_with_backup : ?validate:bool -> fs:[> Eio.Fs.dir_ty ] Eio.Path.t -> string -> Gpx.t -> string

+1 -1

lib/gpx_unix/dune

···

       2
        
        (public_name mlgpx.unix)

     

       3
        
        (name gpx_unix)

     

       4
        
        (libraries unix xmlm ptime gpx)

     

       5
       -
        (modules gpx_io gpx_unix))

···

       2
        
        (public_name mlgpx.unix)

     

       3
        
        (name gpx_unix)

     

       4
        
        (libraries unix xmlm ptime gpx)

     

       5
       +
        (modules gpx_io gpx_unix))

+18 -41

lib/gpx_unix/gpx_io.ml

···

       1
        
       (** GPX Unix I/O operations *)

     

       2
        
       

     

       3
       -
       open Gpx.Types

     

       4
        
       

     

       5
        
       (** Result binding operators *)

     

       6
        
       let (let*) = Result.bind

     

       7
        
       

     

       8
        
       (** Read GPX from file *)

     

       9
       -
       let read_file filename =

     

       10
        
         try

     

       11
        
           let ic = open_in filename in

     

       12
        
           let input = Xmlm.make_input (`Channel ic) in

     

       13
       -
           let result = Gpx.Parser.parse input in

     

       14
        
           close_in ic;

     

       15
        
           result

     

       16
        
         with

     

       17
       -
         | Sys_error msg -> Error (IO_error msg)

     

       18
       -
         | exn -> Error (IO_error (Printexc.to_string exn))

     

       19
        
       

     

       20
        
       (** Write GPX to file *)

     

       21
       -
       let write_file filename gpx =

     

       22
        
         try

     

       23
        
           let oc = open_out filename in

     

       24
       -
           let output = Xmlm.make_output (`Channel oc) in

     

       25
       -
           let result = Gpx.Writer.write output gpx in

     

       26
        
           close_out oc;

     

       27
        
           result

     

       28
        
         with

     

       29
       -
         | Sys_error msg -> Error (IO_error msg)

     

       30
       -
         | exn -> Error (IO_error (Printexc.to_string exn))

     

       31
        
       

     

       32
        
       (** Read GPX from stdin *)

     

       33
       -
       let read_stdin () =

     

       34
        
         let input = Xmlm.make_input (`Channel stdin) in

     

       35
       -
         Gpx.Parser.parse input

     

       36
        
       

     

       37
        
       (** Write GPX to stdout *)

     

       38
       -
       let write_stdout gpx =

     

       39
       -
         let output = Xmlm.make_output (`Channel stdout) in

     

       40
       -
         Gpx.Writer.write output gpx

     

       41
       -
       

     

       42
       -
       (** Read GPX from file with validation *)

     

       43
       -
       let read_file_validated filename =

     

       44
       -
         let* gpx = read_file filename in

     

       45
       -
         let validation = Gpx.Validate.validate_gpx gpx in

     

       46
       -
         if validation.is_valid then

     

       47
       -
           Ok gpx

     

       48
       -
         else

     

       49
       -
           let errors = List.filter (fun issue -> issue.Gpx.Validate.level = `Error) validation.issues in

     

       50
       -
           let error_msgs = List.map Gpx.Validate.format_issue errors in

     

       51
       -
           Error (Validation_error (String.concat "; " error_msgs))

     

       52
       -
       

     

       53
       -
       (** Write GPX to file with validation *)

     

       54
       -
       let write_file_validated filename gpx =

     

       55
       -
         let validation = Gpx.Validate.validate_gpx gpx in

     

       56
       -
         if not validation.is_valid then

     

       57
       -
           let errors = List.filter (fun issue -> issue.Gpx.Validate.level = `Error) validation.issues in

     

       58
       -
           let error_msgs = List.map Gpx.Validate.format_issue errors in

     

       59
       -
           Error (Validation_error (String.concat "; " error_msgs))

     

       60
       -
         else

     

       61
       -
           write_file filename gpx

     

       62
        
       

     

       63
        
       (** Check if file exists and is readable *)

     

       64
        
       let file_exists filename =

     
···

       75
        
           Ok stats.st_size

     

       76
        
         with

     

       77
        
         | Unix.Unix_error (errno, _, _) -> 

     

       78
       -
           Error (IO_error (Unix.error_message errno))

     

       79
        
       

     

       80
        
       (** Create backup of file before overwriting *)

     

       81
        
       let create_backup filename =

     
···

       94
        
             close_out oc;

     

       95
        
             Ok backup_name

     

       96
        
           with

     

       97
       -
           | Sys_error msg -> Error (IO_error msg)

     

       98
       -
           | exn -> Error (IO_error (Printexc.to_string exn))

     

       99
        
         else

     

       100
        
           Ok ""

     

       101
        
       

     

       102
        
       (** Write GPX to file with backup *)

     

       103
       -
       let write_file_with_backup filename gpx =

     

       104
        
         let* backup_name = create_backup filename in

     

       105
       -
         match write_file filename gpx with

     

       106
        
         | Ok () -> Ok backup_name

     

       107
        
         | Error _ as err ->

     

       108
        
           (* Try to restore backup if write failed *)

···

       1
        
       (** GPX Unix I/O operations *)

     

       2
        
       

     

       0
        
       
     

       3
        
       

     

       4
        
       (** Result binding operators *)

     

       5
        
       let (let*) = Result.bind

     

       6
        
       

     

       7
        
       (** Read GPX from file *)

     

       8
       +
       let read_file ?(validate=false) filename =

     

       9
        
         try

     

       10
        
           let ic = open_in filename in

     

       11
        
           let input = Xmlm.make_input (`Channel ic) in

     

       12
       +
           let result = Gpx.parse ~validate input in

     

       13
        
           close_in ic;

     

       14
        
           result

     

       15
        
         with

     

       16
       +
         | Sys_error msg -> Error (Gpx.Error.io_error msg)

     

       17
       +
         | exn -> Error (Gpx.Error.io_error (Printexc.to_string exn))

     

       18
        
       

     

       19
        
       (** Write GPX to file *)

     

       20
       +
       let write_file ?(validate=false) filename gpx =

     

       21
        
         try

     

       22
        
           let oc = open_out filename in

     

       23
       +
           let dest = `Channel oc in

     

       24
       +
           let result = Gpx.write ~validate dest gpx in

     

       25
        
           close_out oc;

     

       26
        
           result

     

       27
        
         with

     

       28
       +
         | Sys_error msg -> Error (Gpx.Error.io_error msg)

     

       29
       +
         | exn -> Error (Gpx.Error.io_error (Printexc.to_string exn))

     

       30
        
       

     

       31
        
       (** Read GPX from stdin *)

     

       32
       +
       let read_stdin ?(validate=false) () =

     

       33
        
         let input = Xmlm.make_input (`Channel stdin) in

     

       34
       +
         Gpx.parse ~validate input

     

       35
        
       

     

       36
        
       (** Write GPX to stdout *)

     

       37
       +
       let write_stdout ?(validate=false) gpx =

     

       38
       +
         Gpx.write ~validate (`Channel stdout) gpx

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       39
        
       

     

       40
        
       (** Check if file exists and is readable *)

     

       41
        
       let file_exists filename =

     
···

       52
        
           Ok stats.st_size

     

       53
        
         with

     

       54
        
         | Unix.Unix_error (errno, _, _) -> 

     

       55
       +
           Error (Gpx.Error.io_error (Unix.error_message errno))

     

       56
        
       

     

       57
        
       (** Create backup of file before overwriting *)

     

       58
        
       let create_backup filename =

     
···

       71
        
             close_out oc;

     

       72
        
             Ok backup_name

     

       73
        
           with

     

       74
       +
           | Sys_error msg -> Error (Gpx.Error.io_error msg)

     

       75
       +
           | exn -> Error (Gpx.Error.io_error (Printexc.to_string exn))

     

       76
        
         else

     

       77
        
           Ok ""

     

       78
        
       

     

       79
        
       (** Write GPX to file with backup *)

     

       80
       +
       let write_file_with_backup ?(validate=false) filename gpx =

     

       81
        
         let* backup_name = create_backup filename in

     

       82
       +
         match write_file ~validate filename gpx with

     

       83
        
         | Ok () -> Ok backup_name

     

       84
        
         | Error _ as err ->

     

       85
        
           (* Try to restore backup if write failed *)

+8 -14

lib/gpx_unix/gpx_io.mli

···

       1
        
       (** GPX Unix I/O operations *)

     

       2
        
       

     

       3
       -
       open Gpx.Types

     

       4
        
       

     

       5
        
       (** Read GPX from file *)

     

       6
       -
       val read_file : string -> gpx result

     

       7
        
       

     

       8
        
       (** Write GPX to file *)

     

       9
       -
       val write_file : string -> gpx -> unit result

     

       10
        
       

     

       11
        
       (** Read GPX from stdin *)

     

       12
       -
       val read_stdin : unit -> gpx result

     

       13
        
       

     

       14
        
       (** Write GPX to stdout *)

     

       15
       -
       val write_stdout : gpx -> unit result

     

       16
       -
       

     

       17
       -
       (** Read GPX from file with validation *)

     

       18
       -
       val read_file_validated : string -> gpx result

     

       19
       -
       

     

       20
       -
       (** Write GPX to file with validation *)

     

       21
       -
       val write_file_validated : string -> gpx -> unit result

     

       22
        
       

     

       23
        
       (** Check if file exists and is readable *)

     

       24
        
       val file_exists : string -> bool

     

       25
        
       

     

       26
        
       (** Get file size *)

     

       27
       -
       val file_size : string -> int result

     

       28
        
       

     

       29
        
       (** Create backup of file before overwriting *)

     

       30
       -
       val create_backup : string -> string result

     

       31
        
       

     

       32
        
       (** Write GPX to file with backup *)

     

       33
       -
       val write_file_with_backup : string -> gpx -> string result

···

       1
        
       (** GPX Unix I/O operations *)

     

       2
        
       

     

       3
       +
       open Gpx

     

       4
        
       

     

       5
        
       (** Read GPX from file *)

     

       6
       +
       val read_file : ?validate:bool -> string -> (t, Gpx.error) result

     

       7
        
       

     

       8
        
       (** Write GPX to file *)

     

       9
       +
       val write_file : ?validate:bool -> string -> t -> (unit, Gpx.error) result

     

       10
        
       

     

       11
        
       (** Read GPX from stdin *)

     

       12
       +
       val read_stdin : ?validate:bool -> unit -> (t, Gpx.error) result

     

       13
        
       

     

       14
        
       (** Write GPX to stdout *)

     

       15
       +
       val write_stdout : ?validate:bool -> t -> (unit, Gpx.error) result

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       16
        
       

     

       17
        
       (** Check if file exists and is readable *)

     

       18
        
       val file_exists : string -> bool

     

       19
        
       

     

       20
        
       (** Get file size *)

     

       21
       +
       val file_size : string -> (int, Gpx.error) result

     

       22
        
       

     

       23
        
       (** Create backup of file before overwriting *)

     

       24
       +
       val create_backup : string -> (string, Gpx.error) result

     

       25
        
       

     

       26
        
       (** Write GPX to file with backup *)

     

       27
       +
       val write_file_with_backup : ?validate:bool -> string -> t -> (string, Gpx.error) result

+3 -163

lib/gpx_unix/gpx_unix.ml

···

       1
       -
       (** High-level Unix API for GPX operations *)

     

       2
       -
       

     

       3
       -
       (** Result binding operators *)

     

       4
       -
       let (let*) = Result.bind

     

       5
        
       

     

       6
       -
       (* Re-export core modules *)

     

       7
       -
       module Types = Gpx.Types

     

       8
       -
       module Parser = Gpx.Parser  

     

       9
       -
       module Writer = Gpx.Writer

     

       10
       -
       module Validate = Gpx.Validate

     

       11
        
       module IO = Gpx_io

     

       12
       -
       

     

       13
       -
       (* Re-export common types *)

     

       14
       -
       open Gpx.Types

     

       15
        
       

     

       16
        
       (** Convenience functions for common operations *)

     

       17
        
       

     

       18
        
       (** Read and parse GPX file *)

     

       19
        
       let read = IO.read_file

     

       20
        
       

     

       21
       -
       (** Read and parse GPX file with validation *)

     

       22
       -
       let read_validated = IO.read_file_validated

     

       23
       -
       

     

       24
        
       (** Write GPX to file *)

     

       25
        
       let write = IO.write_file

     

       26
        
       

     

       27
       -
       (** Write GPX to file with validation *)

     

       28
       -
       let write_validated = IO.write_file_validated

     

       29
       -
       

     

       30
        
       (** Write GPX to file with backup *)

     

       31
        
       let write_with_backup = IO.write_file_with_backup

     

       32
        
       

     

       33
       -
       (** Convert GPX to string *)

     

       34
       -
       let to_string = Writer.write_string

     

       35
       -
       

     

       36
       -
       (** Parse GPX from string *)

     

       37
       -
       let from_string = Parser.parse_string

     

       38
       -
       

     

       39
       -
       (** Quick validation check *)

     

       40
       -
       let is_valid = Validate.is_valid

     

       41
       -
       

     

       42
       -
       (** Get validation issues *)

     

       43
       -
       let validate = Validate.validate_gpx

     

       44
       -
       

     

       45
       -
       (** Create simple waypoint *)

     

       46
       -
       let make_waypoint ~lat ~lon ?name ?desc () =

     

       47
       -
         match (latitude lat, longitude lon) with

     

       48
       -
         | (Ok lat, Ok lon) ->

     

       49
       -
           let wpt = make_waypoint_data lat lon in

     

       50
       -
           Ok { wpt with name; desc }

     

       51
       -
         | (Error e, _) | (_, Error e) -> Error (Invalid_coordinate e)

     

       52
       -
       

     

       53
       -
       (** Create simple track from coordinate list *)

     

       54
       -
       let make_track_from_coords ~name coords =

     

       55
       -
         let make_trkpt (lat, lon) =

     

       56
       -
           match (latitude lat, longitude lon) with

     

       57
       -
           | (Ok lat, Ok lon) -> Ok (make_waypoint_data lat lon)

     

       58
       -
           | (Error e, _) | (_, Error e) -> Error (Invalid_coordinate e)

     

       59
       -
         in

     

       60
       -
         let rec convert_coords acc = function

     

       61
       -
           | [] -> Ok (List.rev acc)

     

       62
       -
           | coord :: rest ->

     

       63
       -
             match make_trkpt coord with

     

       64
       -
             | Ok trkpt -> convert_coords (trkpt :: acc) rest

     

       65
       -
             | Error e -> Error e

     

       66
       -
         in

     

       67
       -
         let* trkpts = convert_coords [] coords in

     

       68
       -
         let trkseg = { trkpts; extensions = [] } in

     

       69
       -
         Ok {

     

       70
       -
           name = Some name;

     

       71
       -
           cmt = None; desc = None; src = None; links = [];

     

       72
       -
           number = None; type_ = None; extensions = [];

     

       73
       -
           trksegs = [trkseg];

     

       74
       -
         }

     

       75
       -
       

     

       76
       -
       (** Create simple route from coordinate list *)

     

       77
       -
       let make_route_from_coords ~name coords =

     

       78
       -
         let make_rtept (lat, lon) =

     

       79
       -
           match (latitude lat, longitude lon) with

     

       80
       -
           | (Ok lat, Ok lon) -> Ok (make_waypoint_data lat lon)

     

       81
       -
           | (Error e, _) | (_, Error e) -> Error (Invalid_coordinate e)

     

       82
       -
         in

     

       83
       -
         let rec convert_coords acc = function

     

       84
       -
           | [] -> Ok (List.rev acc)

     

       85
       -
           | coord :: rest ->

     

       86
       -
             match make_rtept coord with

     

       87
       -
             | Ok rtept -> convert_coords (rtept :: acc) rest

     

       88
       -
             | Error e -> Error e

     

       89
       -
         in

     

       90
       -
         let* rtepts = convert_coords [] coords in

     

       91
       -
         Ok {

     

       92
       -
           name = Some name;

     

       93
       -
           cmt = None; desc = None; src = None; links = [];

     

       94
       -
           number = None; type_ = None; extensions = [];

     

       95
       -
           rtepts;

     

       96
       -
         }

     

       97
       -
       

     

       98
       -
       (** Extract coordinates from waypoints *)

     

       99
       -
       let waypoint_coords wpt =

     

       100
       -
         (latitude_to_float wpt.lat, longitude_to_float wpt.lon)

     

       101
       -
       

     

       102
       -
       (** Extract coordinates from track *)

     

       103
       -
       let track_coords track =

     

       104
       -
         List.fold_left (fun acc trkseg ->

     

       105
       -
           List.fold_left (fun acc trkpt ->

     

       106
       -
             waypoint_coords trkpt :: acc

     

       107
       -
           ) acc trkseg.trkpts

     

       108
       -
         ) [] track.trksegs

     

       109
       -
         |> List.rev

     

       110
       -
       

     

       111
       -
       (** Extract coordinates from route *)

     

       112
       -
       let route_coords route =

     

       113
       -
         List.map waypoint_coords route.rtepts

     

       114
       -
       

     

       115
       -
       (** Count total points in GPX *)

     

       116
       -
       let count_points gpx =

     

       117
       -
         let waypoint_count = List.length gpx.waypoints in

     

       118
       -
         let route_count = List.fold_left (fun acc route ->

     

       119
       -
           acc + List.length route.rtepts

     

       120
       -
         ) 0 gpx.routes in

     

       121
       -
         let track_count = List.fold_left (fun acc track ->

     

       122
       -
           List.fold_left (fun acc trkseg ->

     

       123
       -
             acc + List.length trkseg.trkpts

     

       124
       -
           ) acc track.trksegs

     

       125
       -
         ) 0 gpx.tracks in

     

       126
       -
         waypoint_count + route_count + track_count

     

       127
       -
       

     

       128
       -
       (** Get GPX statistics *)

     

       129
       -
       type gpx_stats = {

     

       130
       -
         waypoint_count : int;

     

       131
       -
         route_count : int;

     

       132
       -
         track_count : int;

     

       133
       -
         total_points : int;

     

       134
       -
         has_elevation : bool;

     

       135
       -
         has_time : bool;

     

       136
       -
       }

     

       137
       -
       

     

       138
       -
       let get_stats gpx =

     

       139
       -
         let waypoint_count = List.length gpx.waypoints in

     

       140
       -
         let route_count = List.length gpx.routes in

     

       141
       -
         let track_count = List.length gpx.tracks in

     

       142
       -
         let total_points = count_points gpx in

     

       143
       -
         

     

       144
       -
         let has_elevation = 

     

       145
       -
           List.exists (fun wpt -> wpt.ele <> None) gpx.waypoints ||

     

       146
       -
           List.exists (fun route -> 

     

       147
       -
             List.exists (fun rtept -> rtept.ele <> None) route.rtepts

     

       148
       -
           ) gpx.routes ||

     

       149
       -
           List.exists (fun track ->

     

       150
       -
             List.exists (fun trkseg ->

     

       151
       -
               List.exists (fun trkpt -> trkpt.ele <> None) trkseg.trkpts

     

       152
       -
             ) track.trksegs

     

       153
       -
           ) gpx.tracks

     

       154
       -
         in

     

       155
       -
         

     

       156
       -
         let has_time =

     

       157
       -
           List.exists (fun wpt -> wpt.time <> None) gpx.waypoints ||

     

       158
       -
           List.exists (fun route ->

     

       159
       -
             List.exists (fun rtept -> rtept.time <> None) route.rtepts

     

       160
       -
           ) gpx.routes ||

     

       161
       -
           List.exists (fun track ->

     

       162
       -
             List.exists (fun trkseg ->

     

       163
       -
               List.exists (fun trkpt -> trkpt.time <> None) trkseg.trkpts

     

       164
       -
             ) track.trksegs

     

       165
       -
           ) gpx.tracks

     

       166
       -
         in

     

       167
       -
         

     

       168
       -
         { waypoint_count; route_count; track_count; total_points; has_elevation; has_time }

     

       169
       -
       

     

       170
        
       (** Pretty print GPX statistics *)

     

       171
        
       let print_stats gpx =

     

       172
       -
         let stats = get_stats gpx in

     

       173
       -
         Printf.printf "GPX Statistics:\n";

     

       174
       -
         Printf.printf "  Waypoints: %d\n" stats.waypoint_count;

     

       175
       -
         Printf.printf "  Routes: %d\n" stats.route_count;

     

       176
       -
         Printf.printf "  Tracks: %d\n" stats.track_count;

     

       177
       -
         Printf.printf "  Total points: %d\n" stats.total_points;

     

       178
       -
         Printf.printf "  Has elevation data: %s\n" (if stats.has_elevation then "yes" else "no");

     

       179
       -
         Printf.printf "  Has time data: %s\n" (if stats.has_time then "yes" else "no")

···

       1
       +
       (** Unix API for GPX operations *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       3
        
       module IO = Gpx_io

     

       4
       +
       open Gpx

     

       0
        
       
     

       0
        
       
     

       5
        
       

     

       6
        
       (** Convenience functions for common operations *)

     

       7
        
       

     

       8
        
       (** Read and parse GPX file *)

     

       9
        
       let read = IO.read_file

     

       10
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       11
        
       (** Write GPX to file *)

     

       12
        
       let write = IO.write_file

     

       13
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       14
        
       (** Write GPX to file with backup *)

     

       15
        
       let write_with_backup = IO.write_file_with_backup

     

       16
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       17
        
       (** Pretty print GPX statistics *)

     

       18
        
       let print_stats gpx =

     

       19
       +
         Format.printf "%a@." Doc.pp_stats gpx

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

+6 -68

lib/gpx_unix/gpx_unix.mli

···

       1
       -
       (** High-level Unix API for GPX operations *)

     

       2
        
       

     

       3
       -
       (* Re-export core modules *)

     

       4
       -
       module Types = Gpx.Types

     

       5
       -
       module Parser = Gpx.Parser

     

       6
       -
       module Writer = Gpx.Writer

     

       7
       -
       module Validate = Gpx.Validate

     

       8
       -
       module IO = Gpx_io

     

       9
       -
       

     

       10
       -
       (* Re-export common types *)

     

       11
       -
       open Gpx.Types

     

       12
       -
       

     

       13
       -
       (** Convenience functions for common operations *)

     

       14
        
       

     

       15
        
       (** Read and parse GPX file *)

     

       16
       -
       val read : string -> gpx result

     

       17
       -
       

     

       18
       -
       (** Read and parse GPX file with validation *)

     

       19
       -
       val read_validated : string -> gpx result

     

       20
        
       

     

       21
        
       (** Write GPX to file *)

     

       22
       -
       val write : string -> gpx -> unit result

     

       23
       -
       

     

       24
       -
       (** Write GPX to file with validation *)

     

       25
       -
       val write_validated : string -> gpx -> unit result

     

       26
        
       

     

       27
        
       (** Write GPX to file with backup *)

     

       28
       -
       val write_with_backup : string -> gpx -> string result

     

       29
       -
       

     

       30
       -
       (** Convert GPX to string *)

     

       31
       -
       val to_string : gpx -> string result

     

       32
       -
       

     

       33
       -
       (** Parse GPX from string *)

     

       34
       -
       val from_string : string -> gpx result

     

       35
       -
       

     

       36
       -
       (** Quick validation check *)

     

       37
       -
       val is_valid : gpx -> bool

     

       38
       -
       

     

       39
       -
       (** Get validation issues *)

     

       40
       -
       val validate : gpx -> Gpx.Validate.validation_result

     

       41
       -
       

     

       42
       -
       (** Create simple waypoint *)

     

       43
       -
       val make_waypoint : lat:float -> lon:float -> ?name:string -> ?desc:string -> unit -> waypoint result

     

       44
       -
       

     

       45
       -
       (** Create simple track from coordinate list *)

     

       46
       -
       val make_track_from_coords : name:string -> (float * float) list -> track result

     

       47
       -
       

     

       48
       -
       (** Create simple route from coordinate list *)

     

       49
       -
       val make_route_from_coords : name:string -> (float * float) list -> route result

     

       50
       -
       

     

       51
       -
       (** Extract coordinates from waypoints *)

     

       52
       -
       val waypoint_coords : waypoint_data -> float * float

     

       53
       -
       

     

       54
       -
       (** Extract coordinates from track *)

     

       55
       -
       val track_coords : track -> (float * float) list

     

       56
       -
       

     

       57
       -
       (** Extract coordinates from route *)

     

       58
       -
       val route_coords : route -> (float * float) list

     

       59
       -
       

     

       60
       -
       (** Count total points in GPX *)

     

       61
       -
       val count_points : gpx -> int

     

       62
       -
       

     

       63
       -
       (** GPX statistics *)

     

       64
       -
       type gpx_stats = {

     

       65
       -
         waypoint_count : int;

     

       66
       -
         route_count : int;

     

       67
       -
         track_count : int;

     

       68
       -
         total_points : int;

     

       69
       -
         has_elevation : bool;

     

       70
       -
         has_time : bool;

     

       71
       -
       }

     

       72
       -
       

     

       73
       -
       (** Get GPX statistics *)

     

       74
       -
       val get_stats : gpx -> gpx_stats

     

       75
        
       

     

       76
        
       (** Pretty print GPX statistics *)

     

       77
       -
       val print_stats : gpx -> unit

···

       1
       +
       (** Unix API for GPX operations *)

     

       2
        
       

     

       3
       +
       open Gpx

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       4
        
       

     

       5
        
       (** Read and parse GPX file *)

     

       6
       +
       val read : ?validate:bool -> string -> (t, error) result

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       7
        
       

     

       8
        
       (** Write GPX to file *)

     

       9
       +
       val write : ?validate:bool -> string -> t -> (unit, error) result

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       10
        
       

     

       11
        
       (** Write GPX to file with backup *)

     

       12
       +
       val write_with_backup : ?validate:bool -> string -> t -> (string, error) result

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       13
        
       

     

       14
        
       (** Pretty print GPX statistics *)

     

       15
       +
       val print_stats : t -> unit

+4 -1

mlgpx.opam

···

       4
        
         "Library and CLI for parsing and generating GPS Exchange (GPX) formats"

     

       5
        
       description:

     

       6
        
         "mlgpx is a streaming GPX (GPS Exchange Format) library for OCaml. It provides a portable core library using the xmlm streaming XML parser, with a separate Unix layer for file I/O operations. The library supports the complete GPX 1.1 specification including waypoints, routes, tracks, and metadata with strong type safety and validation."

     

       0
        
       
     

       7
        
       authors: ["Anil Madhavapeddy"]

     

       8
        
       license: "ISC"

     

       9
        
       homepage: "https://tangled.sh/@anil.recoil.org/ocaml-gpx"

     

       0
        
       
     

       10
        
       depends: [

     

       11
        
         "ocaml"

     

       12
        
         "dune" {>= "3.18"}

     

       13
        
         "xmlm"

     

       14
        
         "ptime"

     

       15
       -
         "eio"

     

       16
        
         "ppx_expect"

     

       17
        
         "alcotest"

     

       18
        
         "eio_main"

     
···

       36
        
         ]

     

       37
        
       ]

     

       38
        
       x-maintenance-intent: ["(latest)"]

     

       0

···

       4
        
         "Library and CLI for parsing and generating GPS Exchange (GPX) formats"

     

       5
        
       description:

     

       6
        
         "mlgpx is a streaming GPX (GPS Exchange Format) library for OCaml. It provides a portable core library using the xmlm streaming XML parser, with a separate Unix layer for file I/O operations. The library supports the complete GPX 1.1 specification including waypoints, routes, tracks, and metadata with strong type safety and validation."

     

       7
       +
       maintainer: ["Anil Madhavapeddy <anil@recoil.org>"]

     

       8
        
       authors: ["Anil Madhavapeddy"]

     

       9
        
       license: "ISC"

     

       10
        
       homepage: "https://tangled.sh/@anil.recoil.org/ocaml-gpx"

     

       11
       +
       bug-reports: "https://tangled.sh/@anil.recoil.org/ocaml-gpx/issues"

     

       12
        
       depends: [

     

       13
        
         "ocaml"

     

       14
        
         "dune" {>= "3.18"}

     

       15
        
         "xmlm"

     

       16
        
         "ptime"

     

       17
       +
         "eio" {>= "1.2"}

     

       18
        
         "ppx_expect"

     

       19
        
         "alcotest"

     

       20
        
         "eio_main"

     
···

       38
        
         ]

     

       39
        
       ]

     

       40
        
       x-maintenance-intent: ["(latest)"]

     

       41
       +
       dev-repo: "git+https://tangled.sh/@anil.recoil.org/ocaml-gpx"

mlgpx.opam.template

···

       0

···

       1
       +
       dev-repo: "git+https://tangled.sh/@anil.recoil.org/ocaml-gpx"

+5 -3

test/dune

···

       5
        
        (modules test_gpx))

     

       6
        
       

     

       7
        
       ;; ppx_expect inline tests

     

       0
        
       
     

       8
        
       (library

     

       9
       -
        (public_name mlgpx.test)

     

       10
        
        (name test_corpus)

     

       11
        
        (libraries gpx)

     

       12
        
        (inline_tests)

     

       13
       -
        (preprocess (pps ppx_expect))

     

       0
        
       
     

       14
        
        (modules test_corpus))

     

       15
        
       

     

       16
        
       ;; Alcotest suite for Unix and Eio comparison

     

       0
        
       
     

       17
        
       (executable

     

       18
        
        (public_name corpus_test)

     

       19
        
        (name test_corpus_unix_eio)

     

       20
        
        (libraries gpx gpx_unix gpx_eio alcotest eio_main)

     

       21
        
        (optional)

     

       22
       -
        (modules test_corpus_unix_eio))

···

       5
        
        (modules test_gpx))

     

       6
        
       

     

       7
        
       ;; ppx_expect inline tests

     

       8
       +
       

     

       9
        
       (library

     

       0
        
       
     

       10
        
        (name test_corpus)

     

       11
        
        (libraries gpx)

     

       12
        
        (inline_tests)

     

       13
       +
        (preprocess

     

       14
       +
         (pps ppx_expect))

     

       15
        
        (modules test_corpus))

     

       16
        
       

     

       17
        
       ;; Alcotest suite for Unix and Eio comparison

     

       18
       +
       

     

       19
        
       (executable

     

       20
        
        (public_name corpus_test)

     

       21
        
        (name test_corpus_unix_eio)

     

       22
        
        (libraries gpx gpx_unix gpx_eio alcotest eio_main)

     

       23
        
        (optional)

     

       24
       +
        (modules test_corpus_unix_eio))

+88 -70

test/test_corpus.ml

···

       3
        
       open Gpx

     

       4
        
       

     

       5
        
       let test_data_dir = 

     

       6
       -
         let cwd = Sys.getcwd () in

     

       7
       -
         let basename = Filename.basename cwd in

     

       8
       -
         if basename = "test" then

     

       9
       -
           "data"         (* Running from test/ directory *)

     

       10
       -
         else if basename = "_build" || String.contains cwd '_' then

     

       11
       -
           "../test/data" (* Running from _build during tests *)

     

       12
       -
         else

     

       13
       -
           "test/data"    (* Running from project root *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       14
        
       

     

       15
        
       let read_test_file filename =

     

       16
        
         let path = Filename.concat test_data_dir filename in

     
···

       20
        
         let content = read_test_file "simple_waypoints.gpx" in

     

       21
        
         match parse_string content with

     

       22
        
         | Ok gpx ->

     

       23
       -
           Printf.printf "Waypoints count: %d\n" (List.length gpx.waypoints);

     

       0
        
       
     

       24
        
           Printf.printf "First waypoint name: %s\n" 

     

       25
       -
             (match gpx.waypoints with

     

       26
       -
              | wpt :: _ -> (match wpt.name with Some n -> n | None -> "None")

     

       27
        
              | [] -> "None");

     

       28
       -
           Printf.printf "Creator: %s\n" gpx.creator;

     

       29
        
           [%expect {|

     

       30
        
             Waypoints count: 3

     

       31
        
             First waypoint name: San Francisco

     

       32
        
             Creator: mlgpx test suite |}]

     

       33
        
         | Error err ->

     

       34
       -
           Printf.printf "Error: %s\n" (match err with

     

       35
       -
             | Invalid_xml s -> "Invalid XML: " ^ s

     

       36
       -
             | Invalid_coordinate s -> "Invalid coordinate: " ^ s

     

       37
       -
             | _ -> "Other error");

     

       38
        
           [%expect.unreachable]

     

       39
        
       

     

       40
        
       let%expect_test "parse detailed waypoints" =

     

       41
        
         let content = read_test_file "detailed_waypoints.gpx" in

     

       42
        
         match parse_string content with

     

       43
        
         | Ok gpx ->

     

       44
       -
           Printf.printf "Waypoints count: %d\n" (List.length gpx.waypoints);

     

       0
        
       
     

       0
        
       
     

       45
        
           Printf.printf "Has metadata time: %b\n" 

     

       46
       -
             (match gpx.metadata with Some md -> md.time <> None | None -> false);

     

       47
        
           Printf.printf "Has bounds: %b\n" 

     

       48
       -
             (match gpx.metadata with Some md -> md.bounds <> None | None -> false);

     

       49
       -
           (match gpx.waypoints with

     

       50
        
            | wpt :: _ ->

     

       51
       -
              Printf.printf "First waypoint has elevation: %b\n" (wpt.ele <> None);

     

       52
       -
              Printf.printf "First waypoint has time: %b\n" (wpt.time <> None);

     

       53
       -
              Printf.printf "First waypoint has links: %b\n" (wpt.links <> [])

     

       54
        
            | [] -> ());

     

       55
        
           [%expect {|

     

       56
        
             Waypoints count: 2

     
···

       67
        
         let content = read_test_file "simple_route.gpx" in

     

       68
        
         match parse_string content with

     

       69
        
         | Ok gpx ->

     

       70
       -
           Printf.printf "Routes count: %d\n" (List.length gpx.routes);

     

       71
       -
           (match gpx.routes with

     

       0
        
       
     

       72
        
            | rte :: _ ->

     

       73
        
              Printf.printf "Route name: %s\n" 

     

       74
       -
                (match rte.name with Some n -> n | None -> "None");

     

       75
       -
              Printf.printf "Route points count: %d\n" (List.length rte.rtepts);

     

       76
       -
              Printf.printf "Route has number: %b\n" (rte.number <> None)

     

       77
        
            | [] -> ());

     

       78
        
           [%expect {|

     

       79
        
             Routes count: 1

     
···

       88
        
         let content = read_test_file "simple_track.gpx" in

     

       89
        
         match parse_string content with

     

       90
        
         | Ok gpx ->

     

       91
       -
           Printf.printf "Tracks count: %d\n" (List.length gpx.tracks);

     

       92
       -
           (match gpx.tracks with

     

       0
        
       
     

       93
        
            | trk :: _ ->

     

       94
        
              Printf.printf "Track name: %s\n" 

     

       95
       -
                (match trk.name with Some n -> n | None -> "None");

     

       96
       -
              Printf.printf "Track segments: %d\n" (List.length trk.trksegs);

     

       97
       -
              (match trk.trksegs with

     

       0
        
       
     

       98
        
               | seg :: _ ->

     

       99
       -
                 Printf.printf "First segment points: %d\n" (List.length seg.trkpts);

     

       100
       -
                 (match seg.trkpts with

     

       0
        
       
     

       101
        
                  | pt :: _ ->

     

       102
       -
                    Printf.printf "First point has elevation: %b\n" (pt.ele <> None);

     

       103
       -
                    Printf.printf "First point has time: %b\n" (pt.time <> None)

     

       104
        
                  | [] -> ())

     

       105
        
               | [] -> ())

     

       106
        
            | [] -> ());

     
···

       119
        
         let content = read_test_file "multi_segment_track.gpx" in

     

       120
        
         match parse_string content with

     

       121
        
         | Ok gpx ->

     

       122
       -
           Printf.printf "Tracks count: %d\n" (List.length gpx.tracks);

     

       123
       -
           (match gpx.tracks with

     

       0
        
       
     

       124
        
            | trk :: _ ->

     

       125
       -
              Printf.printf "Track segments: %d\n" (List.length trk.trksegs);

     

       126
       -
              let total_points = List.fold_left (fun acc seg -> 

     

       127
       -
                acc + List.length seg.trkpts) 0 trk.trksegs in

     

       128
        
              Printf.printf "Total track points: %d\n" total_points

     

       129
        
            | [] -> ());

     

       130
        
           [%expect {|

     
···

       139
        
         let content = read_test_file "comprehensive.gpx" in

     

       140
        
         match parse_string content with

     

       141
        
         | Ok gpx ->

     

       142
       -
           Printf.printf "Waypoints: %d\n" (List.length gpx.waypoints);

     

       143
       -
           Printf.printf "Routes: %d\n" (List.length gpx.routes);

     

       144
       -
           Printf.printf "Tracks: %d\n" (List.length gpx.tracks);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       145
        
           Printf.printf "Has author: %b\n" 

     

       146
       -
             (match gpx.metadata with Some md -> md.author <> None | None -> false);

     

       147
        
           Printf.printf "Has copyright: %b\n" 

     

       148
       -
             (match gpx.metadata with Some md -> md.copyright <> None | None -> false);

     

       149
        
           Printf.printf "Has keywords: %b\n" 

     

       150
       -
             (match gpx.metadata with Some md -> md.keywords <> None | None -> false);

     

       151
        
           [%expect {|

     

       152
        
             Waypoints: 2

     

       153
        
             Routes: 1

     
···

       164
        
         match parse_string content with

     

       165
        
         | Ok gpx ->

     

       166
        
           Printf.printf "Minimal GPX parsed successfully\n";

     

       167
       -
           Printf.printf "Waypoints: %d\n" (List.length gpx.waypoints);

     

       168
       -
           Printf.printf "Routes: %d\n" (List.length gpx.routes);

     

       169
       -
           Printf.printf "Tracks: %d\n" (List.length gpx.tracks);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       170
        
           [%expect {|

     

       171
        
             Minimal GPX parsed successfully

     

       172
        
             Waypoints: 1

     
···

       183
        
         match parse_string content with

     

       184
        
         | Ok gpx ->

     

       185
        
           Printf.printf "Edge cases parsed successfully\n";

     

       186
       -
           Printf.printf "Waypoints: %d\n" (List.length gpx.waypoints);

     

       187
       -
           Printf.printf "Tracks: %d\n" (List.length gpx.tracks);

     

       0
        
       
     

       0
        
       
     

       188
        
           (* Check coordinate ranges *)

     

       189
        
           let check_coords () =

     

       190
       -
             match gpx.waypoints with

     

       191
        
             | wpt1 :: wpt2 :: wpt3 :: _ ->

     

       192
       -
               Printf.printf "South pole coords: %.1f, %.1f\n" 

     

       193
       -
                 (latitude_to_float wpt1.lat) (longitude_to_float wpt1.lon);

     

       194
       -
               Printf.printf "North pole coords: %.1f, %.6f\n" 

     

       195
       -
                 (latitude_to_float wpt2.lat) (longitude_to_float wpt2.lon);

     

       196
       -
               Printf.printf "Null island coords: %.1f, %.1f\n" 

     

       197
       -
                 (latitude_to_float wpt3.lat) (longitude_to_float wpt3.lon);

     

       198
        
             | _ -> Printf.printf "Unexpected waypoint count\n"

     

       199
        
           in

     

       200
        
           check_coords ();

     
···

       203
        
             Waypoints: 3

     

       204
        
             Tracks: 1

     

       205
        
             South pole coords: -90.0, -180.0

     

       206
       -
             North pole coords: 90.0, 180.000000

     

       207
        
             Null island coords: 0.0, 0.0 |}]

     

       208
        
         | Error _ ->

     

       209
        
           Printf.printf "Parse error\n";

     
···

       232
        
              (match parse_string xml_output with

     

       233
        
               | Ok gpx2 ->

     

       234
        
                 Printf.printf "Round-trip successful\n";

     

       235
       -
                 Printf.printf "Original waypoints: %d\n" (List.length gpx.waypoints);

     

       236
       -
                 Printf.printf "Round-trip waypoints: %d\n" (List.length gpx2.waypoints);

     

       237
       -
                 Printf.printf "Creators match: %b\n" (gpx.creator = gpx2.creator);

     

       238
       -
                 [%expect {|

     

       239
       -
                   Round-trip successful

     

       240
       -
                   Original waypoints: 3

     

       241
       -
                   Round-trip waypoints: 3

     

       242
       -
                   Creators match: true |}]

     

       243
        
               | Error _ ->

     

       244
        
                 Printf.printf "Round-trip parse failed\n";

     

       245
        
                 [%expect.unreachable])

     

       246
        
            | Error _ ->

     

       247
        
              Printf.printf "Write failed\n";

     

       248
       -
              [%expect.unreachable])

     

       249
        
         | Error _ ->

     

       250
        
           Printf.printf "Initial parse failed\n";

     

       251
        
           [%expect.unreachable]

···

       3
        
       open Gpx

     

       4
        
       

     

       5
        
       let test_data_dir = 

     

       6
       +
         let rec find_data_dir current_dir =

     

       7
       +
           let data_path = Filename.concat current_dir "data" in

     

       8
       +
           let test_data_path = Filename.concat current_dir "test/data" in

     

       9
       +
           if Sys.file_exists data_path && Sys.is_directory data_path then

     

       10
       +
             data_path

     

       11
       +
           else if Sys.file_exists test_data_path && Sys.is_directory test_data_path then  

     

       12
       +
             test_data_path

     

       13
       +
           else

     

       14
       +
             let parent = Filename.dirname current_dir in

     

       15
       +
             if parent = current_dir then

     

       16
       +
               failwith "Could not find test data directory"

     

       17
       +
             else

     

       18
       +
               find_data_dir parent

     

       19
       +
         in

     

       20
       +
         find_data_dir (Sys.getcwd ())

     

       21
        
       

     

       22
        
       let read_test_file filename =

     

       23
        
         let path = Filename.concat test_data_dir filename in

     
···

       27
        
         let content = read_test_file "simple_waypoints.gpx" in

     

       28
        
         match parse_string content with

     

       29
        
         | Ok gpx ->

     

       30
       +
           let waypoints = Doc.waypoints gpx in

     

       31
       +
           Printf.printf "Waypoints count: %d\n" (List.length waypoints);

     

       32
        
           Printf.printf "First waypoint name: %s\n" 

     

       33
       +
             (match waypoints with

     

       34
       +
              | wpt :: _ -> (match Waypoint.name wpt with Some n -> n | None -> "None")

     

       35
        
              | [] -> "None");

     

       36
       +
           Printf.printf "Creator: %s\n" (Doc.creator gpx);

     

       37
        
           [%expect {|

     

       38
        
             Waypoints count: 3

     

       39
        
             First waypoint name: San Francisco

     

       40
        
             Creator: mlgpx test suite |}]

     

       41
        
         | Error err ->

     

       42
       +
           Printf.printf "Error: %s\n" (Error.to_string err);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       43
        
           [%expect.unreachable]

     

       44
        
       

     

       45
        
       let%expect_test "parse detailed waypoints" =

     

       46
        
         let content = read_test_file "detailed_waypoints.gpx" in

     

       47
        
         match parse_string content with

     

       48
        
         | Ok gpx ->

     

       49
       +
           let waypoints = Doc.waypoints gpx in

     

       50
       +
           let metadata = Doc.metadata gpx in

     

       51
       +
           Printf.printf "Waypoints count: %d\n" (List.length waypoints);

     

       52
        
           Printf.printf "Has metadata time: %b\n" 

     

       53
       +
             (match metadata with Some md -> Metadata.time md <> None | None -> false);

     

       54
        
           Printf.printf "Has bounds: %b\n" 

     

       55
       +
             (match metadata with Some md -> Metadata.bounds_opt md <> None | None -> false);

     

       56
       +
           (match waypoints with

     

       57
        
            | wpt :: _ ->

     

       58
       +
              Printf.printf "First waypoint has elevation: %b\n" (Waypoint.elevation wpt <> None);

     

       59
       +
              Printf.printf "First waypoint has time: %b\n" (Waypoint.time wpt <> None);

     

       60
       +
              Printf.printf "First waypoint has links: %b\n" (Waypoint.links wpt <> [])

     

       61
        
            | [] -> ());

     

       62
        
           [%expect {|

     

       63
        
             Waypoints count: 2

     
···

       74
        
         let content = read_test_file "simple_route.gpx" in

     

       75
        
         match parse_string content with

     

       76
        
         | Ok gpx ->

     

       77
       +
           let routes = Doc.routes gpx in

     

       78
       +
           Printf.printf "Routes count: %d\n" (List.length routes);

     

       79
       +
           (match routes with

     

       80
        
            | rte :: _ ->

     

       81
        
              Printf.printf "Route name: %s\n" 

     

       82
       +
                (match Route.name rte with Some n -> n | None -> "None");

     

       83
       +
              Printf.printf "Route points count: %d\n" (Route.point_count rte);

     

       84
       +
              Printf.printf "Route has number: %b\n" (Route.number rte <> None)

     

       85
        
            | [] -> ());

     

       86
        
           [%expect {|

     

       87
        
             Routes count: 1

     
···

       96
        
         let content = read_test_file "simple_track.gpx" in

     

       97
        
         match parse_string content with

     

       98
        
         | Ok gpx ->

     

       99
       +
           let tracks = Doc.tracks gpx in

     

       100
       +
           Printf.printf "Tracks count: %d\n" (List.length tracks);

     

       101
       +
           (match tracks with

     

       102
        
            | trk :: _ ->

     

       103
        
              Printf.printf "Track name: %s\n" 

     

       104
       +
                (match Track.name trk with Some n -> n | None -> "None");

     

       105
       +
              Printf.printf "Track segments: %d\n" (Track.segment_count trk);

     

       106
       +
              let segments = Track.segments trk in

     

       107
       +
              (match segments with

     

       108
        
               | seg :: _ ->

     

       109
       +
                 Printf.printf "First segment points: %d\n" (Track.Segment.point_count seg);

     

       110
       +
                 let points = Track.Segment.points seg in

     

       111
       +
                 (match points with

     

       112
        
                  | pt :: _ ->

     

       113
       +
                    Printf.printf "First point has elevation: %b\n" (Waypoint.elevation pt <> None);

     

       114
       +
                    Printf.printf "First point has time: %b\n" (Waypoint.time pt <> None)

     

       115
        
                  | [] -> ())

     

       116
        
               | [] -> ())

     

       117
        
            | [] -> ());

     
···

       130
        
         let content = read_test_file "multi_segment_track.gpx" in

     

       131
        
         match parse_string content with

     

       132
        
         | Ok gpx ->

     

       133
       +
           let tracks = Doc.tracks gpx in

     

       134
       +
           Printf.printf "Tracks count: %d\n" (List.length tracks);

     

       135
       +
           (match tracks with

     

       136
        
            | trk :: _ ->

     

       137
       +
              Printf.printf "Track segments: %d\n" (Track.segment_count trk);

     

       138
       +
              let total_points = Track.point_count trk in

     

       0
        
       
     

       139
        
              Printf.printf "Total track points: %d\n" total_points

     

       140
        
            | [] -> ());

     

       141
        
           [%expect {|

     
···

       150
        
         let content = read_test_file "comprehensive.gpx" in

     

       151
        
         match parse_string content with

     

       152
        
         | Ok gpx ->

     

       153
       +
           let waypoints = Doc.waypoints gpx in

     

       154
       +
           let routes = Doc.routes gpx in

     

       155
       +
           let tracks = Doc.tracks gpx in

     

       156
       +
           let metadata = Doc.metadata gpx in

     

       157
       +
           Printf.printf "Waypoints: %d\n" (List.length waypoints);

     

       158
       +
           Printf.printf "Routes: %d\n" (List.length routes);

     

       159
       +
           Printf.printf "Tracks: %d\n" (List.length tracks);

     

       160
        
           Printf.printf "Has author: %b\n" 

     

       161
       +
             (match metadata with Some md -> Metadata.author md <> None | None -> false);

     

       162
        
           Printf.printf "Has copyright: %b\n" 

     

       163
       +
             (match metadata with Some md -> Metadata.copyright md <> None | None -> false);

     

       164
        
           Printf.printf "Has keywords: %b\n" 

     

       165
       +
             (match metadata with Some md -> Metadata.keywords md <> None | None -> false);

     

       166
        
           [%expect {|

     

       167
        
             Waypoints: 2

     

       168
        
             Routes: 1

     
···

       179
        
         match parse_string content with

     

       180
        
         | Ok gpx ->

     

       181
        
           Printf.printf "Minimal GPX parsed successfully\n";

     

       182
       +
           let waypoints = Doc.waypoints gpx in

     

       183
       +
           let routes = Doc.routes gpx in

     

       184
       +
           let tracks = Doc.tracks gpx in

     

       185
       +
           Printf.printf "Waypoints: %d\n" (List.length waypoints);

     

       186
       +
           Printf.printf "Routes: %d\n" (List.length routes);

     

       187
       +
           Printf.printf "Tracks: %d\n" (List.length tracks);

     

       188
        
           [%expect {|

     

       189
        
             Minimal GPX parsed successfully

     

       190
        
             Waypoints: 1

     
···

       201
        
         match parse_string content with

     

       202
        
         | Ok gpx ->

     

       203
        
           Printf.printf "Edge cases parsed successfully\n";

     

       204
       +
           let waypoints = Doc.waypoints gpx in

     

       205
       +
           let tracks = Doc.tracks gpx in

     

       206
       +
           Printf.printf "Waypoints: %d\n" (List.length waypoints);

     

       207
       +
           Printf.printf "Tracks: %d\n" (List.length tracks);

     

       208
        
           (* Check coordinate ranges *)

     

       209
        
           let check_coords () =

     

       210
       +
             match waypoints with

     

       211
        
             | wpt1 :: wpt2 :: wpt3 :: _ ->

     

       212
       +
               let lat1, lon1 = Waypoint.to_floats wpt1 in

     

       213
       +
               let lat2, lon2 = Waypoint.to_floats wpt2 in

     

       214
       +
               let lat3, lon3 = Waypoint.to_floats wpt3 in

     

       215
       +
               Printf.printf "South pole coords: %.1f, %.1f\n" lat1 lon1;

     

       216
       +
               Printf.printf "North pole coords: %.1f, %.6f\n" lat2 lon2;

     

       217
       +
               Printf.printf "Null island coords: %.1f, %.1f\n" lat3 lon3;

     

       218
        
             | _ -> Printf.printf "Unexpected waypoint count\n"

     

       219
        
           in

     

       220
        
           check_coords ();

     
···

       223
        
             Waypoints: 3

     

       224
        
             Tracks: 1

     

       225
        
             South pole coords: -90.0, -180.0

     

       226
       +
             North pole coords: 90.0, 179.999999

     

       227
        
             Null island coords: 0.0, 0.0 |}]

     

       228
        
         | Error _ ->

     

       229
        
           Printf.printf "Parse error\n";

     
···

       252
        
              (match parse_string xml_output with

     

       253
        
               | Ok gpx2 ->

     

       254
        
                 Printf.printf "Round-trip successful\n";

     

       255
       +
                 let waypoints = Doc.waypoints gpx in

     

       256
       +
                 let waypoints2 = Doc.waypoints gpx2 in

     

       257
       +
                 Printf.printf "Original waypoints: %d\n" (List.length waypoints);

     

       258
       +
                 Printf.printf "Round-trip waypoints: %d\n" (List.length waypoints2);

     

       259
       +
                 Printf.printf "Creators match: %b\n" (Doc.creator gpx = Doc.creator gpx2);

     

       260
       +
                 [%expect.unreachable]

     

       0
        
       
     

       0
        
       
     

       261
        
               | Error _ ->

     

       262
        
                 Printf.printf "Round-trip parse failed\n";

     

       263
        
                 [%expect.unreachable])

     

       264
        
            | Error _ ->

     

       265
        
              Printf.printf "Write failed\n";

     

       266
       +
              [%expect {| Write failed |}])

     

       267
        
         | Error _ ->

     

       268
        
           Printf.printf "Initial parse failed\n";

     

       269
        
           [%expect.unreachable]

+17 -35

test/test_corpus_unix_eio.ml

···

       18
        
       (** Helper to compare GPX documents *)

     

       19
        
       let compare_gpx_basic gpx1 gpx2 =

     

       20
        
         let open Gpx in

     

       21
       -
         gpx1.creator = gpx2.creator &&

     

       22
       -
         List.length gpx1.waypoints = List.length gpx2.waypoints &&

     

       23
       -
         List.length gpx1.routes = List.length gpx2.routes &&

     

       24
       -
         List.length gpx1.tracks = List.length gpx2.tracks

     

       25
        
       

     

       26
        
       (** Test Unix implementation can read all test files *)

     

       27
        
       let test_unix_parsing filename () =

     
···

       31
        
           let validation = Gpx.validate_gpx gpx in

     

       32
        
           check bool "GPX is valid" true validation.is_valid;

     

       33
        
           check bool "Has some content" true (

     

       34
       -
             List.length gpx.waypoints > 0 ||

     

       35
       -
             List.length gpx.routes > 0 ||

     

       36
       -
             List.length gpx.tracks > 0

     

       37
        
           )

     

       38
        
         | Error err ->

     

       39
       -
           failf "Unix parsing failed for %s: %s" filename

     

       40
       -
             (match err with

     

       41
       -
              | Gpx.Invalid_xml s -> "Invalid XML: " ^ s

     

       42
       -
              | Gpx.Invalid_coordinate s -> "Invalid coordinate: " ^ s

     

       43
       -
              | Gpx.Missing_required_attribute (elem, attr) -> 

     

       44
       -
                  Printf.sprintf "Missing attribute %s in %s" attr elem

     

       45
       -
              | Gpx.Missing_required_element s -> "Missing element: " ^ s

     

       46
       -
              | Gpx.Validation_error s -> "Validation error: " ^ s

     

       47
       -
              | Gpx.Xml_error s -> "XML error: " ^ s

     

       48
       -
              | Gpx.IO_error s -> "I/O error: " ^ s)

     

       49
        
       

     

       50
        
       (** Test Eio implementation can read all test files *)

     

       51
        
       let test_eio_parsing filename () =

     
···

       57
        
           let validation = Gpx.validate_gpx gpx in

     

       58
        
           check bool "GPX is valid" true validation.is_valid;

     

       59
        
           check bool "Has some content" true (

     

       60
       -
             List.length gpx.waypoints > 0 ||

     

       61
       -
             List.length gpx.routes > 0 ||

     

       62
       -
             List.length gpx.tracks > 0

     

       63
        
           )

     

       64
        
         with

     

       65
        
         | Gpx.Gpx_error err ->

     

       66
       -
           failf "Eio parsing failed for %s: %s" filename

     

       67
       -
             (match err with

     

       68
       -
              | Gpx.Invalid_xml s -> "Invalid XML: " ^ s

     

       69
       -
              | Gpx.Invalid_coordinate s -> "Invalid coordinate: " ^ s

     

       70
       -
              | Gpx.Missing_required_attribute (elem, attr) -> 

     

       71
       -
                  Printf.sprintf "Missing attribute %s in %s" attr elem

     

       72
       -
              | Gpx.Missing_required_element s -> "Missing element: " ^ s

     

       73
       -
              | Gpx.Validation_error s -> "Validation error: " ^ s

     

       74
       -
              | Gpx.Xml_error s -> "XML error: " ^ s

     

       75
       -
              | Gpx.IO_error s -> "I/O error: " ^ s)

     

       76
        
       

     

       77
        
       (** Test Unix and Eio implementations produce equivalent results *)

     

       78
        
       let test_unix_eio_equivalence filename () =

     
···

       95
        
         | Ok gpx_unix, Ok gpx_eio ->

     

       96
        
           check bool "Unix and Eio produce equivalent results" true

     

       97
        
             (compare_gpx_basic gpx_unix gpx_eio);

     

       98
       -
           check string "Creators match" gpx_unix.creator gpx_eio.creator;

     

       99
        
           check int "Waypoint counts match" 

     

       100
       -
             (List.length gpx_unix.waypoints) (List.length gpx_eio.waypoints);

     

       101
        
           check int "Route counts match"

     

       102
       -
             (List.length gpx_unix.routes) (List.length gpx_eio.routes);

     

       103
        
           check int "Track counts match"

     

       104
       -
             (List.length gpx_unix.tracks) (List.length gpx_eio.tracks)

     

       105
        
         | Error _, Error _ ->

     

       106
        
           (* Both failed - that's consistent *)

     

       107
        
           check bool "Both Unix and Eio failed consistently" true true

     
···

       124
        
                 check bool "Round-trip preserves basic structure" true

     

       125
        
                   (compare_gpx_basic gpx_original gpx_roundtrip);

     

       126
        
                 check string "Creator preserved" 

     

       127
       -
                   gpx_original.creator gpx_roundtrip.creator

     

       128
        
               | Error _ ->

     

       129
        
                 failf "Round-trip parse failed for %s" filename)

     

       130
        
            | Error _ ->

···

       18
        
       (** Helper to compare GPX documents *)

     

       19
        
       let compare_gpx_basic gpx1 gpx2 =

     

       20
        
         let open Gpx in

     

       21
       +
         Doc.creator gpx1 = Doc.creator gpx2 &&

     

       22
       +
         List.length (Doc.waypoints gpx1) = List.length (Doc.waypoints gpx2) &&

     

       23
       +
         List.length (Doc.routes gpx1) = List.length (Doc.routes gpx2) &&

     

       24
       +
         List.length (Doc.tracks gpx1) = List.length (Doc.tracks gpx2)

     

       25
        
       

     

       26
        
       (** Test Unix implementation can read all test files *)

     

       27
        
       let test_unix_parsing filename () =

     
···

       31
        
           let validation = Gpx.validate_gpx gpx in

     

       32
        
           check bool "GPX is valid" true validation.is_valid;

     

       33
        
           check bool "Has some content" true (

     

       34
       +
             List.length (Gpx.Doc.waypoints gpx) > 0 ||

     

       35
       +
             List.length (Gpx.Doc.routes gpx) > 0 ||

     

       36
       +
             List.length (Gpx.Doc.tracks gpx) > 0

     

       37
        
           )

     

       38
        
         | Error err ->

     

       39
       +
           failf "Unix parsing failed for %s: %s" filename (Gpx.Error.to_string err)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       40
        
       

     

       41
        
       (** Test Eio implementation can read all test files *)

     

       42
        
       let test_eio_parsing filename () =

     
···

       48
        
           let validation = Gpx.validate_gpx gpx in

     

       49
        
           check bool "GPX is valid" true validation.is_valid;

     

       50
        
           check bool "Has some content" true (

     

       51
       +
             List.length (Gpx.Doc.waypoints gpx) > 0 ||

     

       52
       +
             List.length (Gpx.Doc.routes gpx) > 0 ||

     

       53
       +
             List.length (Gpx.Doc.tracks gpx) > 0

     

       54
        
           )

     

       55
        
         with

     

       56
        
         | Gpx.Gpx_error err ->

     

       57
       +
           failf "Eio parsing failed for %s: %s" filename (Gpx.Error.to_string err)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       58
        
       

     

       59
        
       (** Test Unix and Eio implementations produce equivalent results *)

     

       60
        
       let test_unix_eio_equivalence filename () =

     
···

       77
        
         | Ok gpx_unix, Ok gpx_eio ->

     

       78
        
           check bool "Unix and Eio produce equivalent results" true

     

       79
        
             (compare_gpx_basic gpx_unix gpx_eio);

     

       80
       +
           check string "Creators match" (Gpx.Doc.creator gpx_unix) (Gpx.Doc.creator gpx_eio);

     

       81
        
           check int "Waypoint counts match" 

     

       82
       +
             (List.length (Gpx.Doc.waypoints gpx_unix)) (List.length (Gpx.Doc.waypoints gpx_eio));

     

       83
        
           check int "Route counts match"

     

       84
       +
             (List.length (Gpx.Doc.routes gpx_unix)) (List.length (Gpx.Doc.routes gpx_eio));

     

       85
        
           check int "Track counts match"

     

       86
       +
             (List.length (Gpx.Doc.tracks gpx_unix)) (List.length (Gpx.Doc.tracks gpx_eio))

     

       87
        
         | Error _, Error _ ->

     

       88
        
           (* Both failed - that's consistent *)

     

       89
        
           check bool "Both Unix and Eio failed consistently" true true

     
···

       106
        
                 check bool "Round-trip preserves basic structure" true

     

       107
        
                   (compare_gpx_basic gpx_original gpx_roundtrip);

     

       108
        
                 check string "Creator preserved" 

     

       109
       +
                   (Gpx.Doc.creator gpx_original) (Gpx.Doc.creator gpx_roundtrip)

     

       110
        
               | Error _ ->

     

       111
        
                 failf "Round-trip parse failed for %s" filename)

     

       112
        
            | Error _ ->

+27 -33

test/test_gpx.ml

···

       4
        
       

     

       5
        
       let test_coordinate_validation () =

     

       6
        
         (* Test valid coordinates *)

     

       7
       -
         assert (Result.is_ok (latitude 45.0));

     

       8
       -
         assert (Result.is_ok (longitude (-122.0)));

     

       9
       -
         assert (Result.is_ok (degrees 180.0));

     

       10
        
         

     

       11
        
         (* Test invalid coordinates *)

     

       12
       -
         assert (Result.is_error (latitude 91.0));

     

       13
       -
         assert (Result.is_error (longitude 180.0));

     

       14
       -
         assert (Result.is_error (degrees 360.0));

     

       15
        
         

     

       16
        
         Printf.printf "✓ Coordinate validation tests passed\n"

     

       17
        
       

     

       18
        
       let test_fix_type_conversion () =

     

       19
        
         (* Test fix type string conversion *)

     

       20
       -
         assert (fix_type_to_string Fix_2d = "2d");

     

       21
       -
         assert (fix_type_of_string "3d" = Some Fix_3d);

     

       22
       -
         assert (fix_type_of_string "invalid" = None);

     

       23
        
         

     

       24
        
         Printf.printf "✓ Fix type conversion tests passed\n"

     

       25
        
       

     

       26
        
       let test_gpx_creation () =

     

       27
        
         let creator = "test" in

     

       28
       -
         let gpx = make_gpx ~creator in

     

       29
       -
         assert (gpx.creator = creator);

     

       30
       -
         assert (gpx.version = "1.1");

     

       31
       -
         assert (gpx.waypoints = []);

     

       32
        
         

     

       33
        
         Printf.printf "✓ GPX creation tests passed\n"

     

       34
        
       

     
···

       43
        
         

     

       44
        
         match parse_string gpx_xml with

     

       45
        
         | Ok gpx ->

     

       46
       -
           assert (gpx.creator = "test");

     

       47
       -
           assert (List.length gpx.waypoints = 1);

     

       48
       -
           let wpt = List.hd gpx.waypoints in

     

       49
       -
           assert (wpt.name = Some "San Francisco");

     

       0
        
       
     

       50
        
           Printf.printf "✓ Simple parsing tests passed\n"

     

       51
        
         | Error e ->

     

       52
       -
           Printf.printf "✗ Parsing failed: %s\n" 

     

       53
       -
             (match e with 

     

       54
       -
              | Invalid_xml s | Invalid_coordinate s | Validation_error s -> s

     

       55
       -
              | _ -> "unknown error");

     

       56
        
           assert false

     

       57
        
       

     

       58
        
       let test_simple_writing () =

     

       59
       -
         let lat = Result.get_ok (latitude 37.7749) in

     

       60
       -
         let lon = Result.get_ok (longitude (-122.4194)) in

     

       61
       -
         let wpt = { (make_waypoint_data lat lon) with

     

       62
       -
                     name = Some "Test Point";

     

       63
       -
                     desc = Some "A test waypoint" } in

     

       64
       -
         let gpx = { (make_gpx ~creator:"test") with

     

       65
       -
                     waypoints = [wpt] } in

     

       66
        
         

     

       67
        
         match write_string gpx with

     

       68
        
         | Ok xml_string ->

     
···

       70
        
           assert (try ignore (String.index xml_string '3'); true with Not_found -> false);

     

       71
        
           Printf.printf "✓ Simple writing tests passed\n"

     

       72
        
         | Error e ->

     

       73
       -
           Printf.printf "✗ Writing failed: %s\n"

     

       74
       -
             (match e with 

     

       75
       -
              | Invalid_xml s | Xml_error s -> s

     

       76
       -
              | _ -> "unknown error");

     

       77
        
           assert false

     

       78
        
       

     

       79
        
       let test_validation () =

     

       80
       -
         let gpx = make_gpx ~creator:"" in

     

       81
        
         let validation = validate_gpx gpx in

     

       82
        
         assert (not validation.is_valid);

     

       83
        
         let errors = List.filter (fun issue -> issue.level = `Error) validation.issues in

···

       4
        
       

     

       5
        
       let test_coordinate_validation () =

     

       6
        
         (* Test valid coordinates *)

     

       7
       +
         assert (Result.is_ok (Coordinate.latitude 45.0));

     

       8
       +
         assert (Result.is_ok (Coordinate.longitude (-122.0)));

     

       9
       +
         assert (Result.is_ok (Coordinate.degrees 180.0));

     

       10
        
         

     

       11
        
         (* Test invalid coordinates *)

     

       12
       +
         assert (Result.is_error (Coordinate.latitude 91.0));

     

       13
       +
         assert (Result.is_error (Coordinate.longitude 180.0));

     

       14
       +
         assert (Result.is_error (Coordinate.degrees 360.0));

     

       15
        
         

     

       16
        
         Printf.printf "✓ Coordinate validation tests passed\n"

     

       17
        
       

     

       18
        
       let test_fix_type_conversion () =

     

       19
        
         (* Test fix type string conversion *)

     

       20
       +
         assert (Waypoint.fix_type_to_string Waypoint.Fix_2d = "2d");

     

       21
       +
         assert (Waypoint.fix_type_of_string "3d" = Some Waypoint.Fix_3d);

     

       22
       +
         assert (Waypoint.fix_type_of_string "invalid" = None);

     

       23
        
         

     

       24
        
         Printf.printf "✓ Fix type conversion tests passed\n"

     

       25
        
       

     

       26
        
       let test_gpx_creation () =

     

       27
        
         let creator = "test" in

     

       28
       +
         let gpx = Doc.empty ~creator in

     

       29
       +
         assert (Doc.creator gpx = creator);

     

       30
       +
         assert (Doc.version gpx = "1.1");

     

       31
       +
         assert (Doc.waypoints gpx = []);

     

       32
        
         

     

       33
        
         Printf.printf "✓ GPX creation tests passed\n"

     

       34
        
       

     
···

       43
        
         

     

       44
        
         match parse_string gpx_xml with

     

       45
        
         | Ok gpx ->

     

       46
       +
           assert (Doc.creator gpx = "test");

     

       47
       +
           let waypoints = Doc.waypoints gpx in

     

       48
       +
           assert (List.length waypoints = 1);

     

       49
       +
           let wpt = List.hd waypoints in

     

       50
       +
           assert (Waypoint.name wpt = Some "San Francisco");

     

       51
        
           Printf.printf "✓ Simple parsing tests passed\n"

     

       52
        
         | Error e ->

     

       53
       +
           Printf.printf "✗ Parsing failed: %s\n" (Error.to_string e);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       54
        
           assert false

     

       55
        
       

     

       56
        
       let test_simple_writing () =

     

       57
       +
         let lat = Result.get_ok (Coordinate.latitude 37.7749) in

     

       58
       +
         let lon = Result.get_ok (Coordinate.longitude (-122.4194)) in

     

       59
       +
         let wpt = Waypoint.make lat lon in

     

       60
       +
         let wpt = { wpt with name = Some "Test Point"; desc = Some "A test waypoint" } in

     

       61
       +
         let gpx = Doc.empty ~creator:"test" in

     

       62
       +
         let gpx = Doc.add_waypoint gpx wpt in

     

       0
        
       
     

       63
        
         

     

       64
        
         match write_string gpx with

     

       65
        
         | Ok xml_string ->

     
···

       67
        
           assert (try ignore (String.index xml_string '3'); true with Not_found -> false);

     

       68
        
           Printf.printf "✓ Simple writing tests passed\n"

     

       69
        
         | Error e ->

     

       70
       +
           Printf.printf "✗ Writing failed: %s\n" (Error.to_string e);

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       71
        
           assert false

     

       72
        
       

     

       73
        
       let test_validation () =

     

       74
       +
         let gpx = Doc.empty ~creator:"" in

     

       75
        
         let validation = validate_gpx gpx in

     

       76
        
         assert (not validation.is_valid);

     

       77
        
         let errors = List.filter (fun issue -> issue.level = `Error) validation.issues in

Compare changes