Format .proto files with clang-format 19, add check to CI

.clang-format

@@ -286,4 +286,8 @@ WhitespaceSensitiveMacros:
   - NS_SWIFT_NAME
   - PP_STRINGIZE
   - STRINGIZE
+---
+Language: Proto
+BasedOnStyle: Google
+ColumnLimit: 0
 ...

.github/workflows/main.yml

@@ -119,6 +119,7 @@ jobs:
           - 'src'
           - 'tests'
           - 'utils'
+          - 'docs'
     steps:
       - uses: actions/checkout@v4
       - name: run clang-format
@@ -126,7 +127,7 @@ jobs:
         with:
           clang-format-version: "19"
           check-path: ${{ matrix.path }}
-          exclude-regex: '(libs\/gsl\/)|(tmpl)|(cpu_features)|^.*\.(cu|proto)$'
+          exclude-regex: '(libs\/gsl\/)|(tmpl)|(cpu_features)|^.*\.(cu)$'
 
   clang-tidy:
     runs-on: macos-latest

docs/CHANGELOG.md

@@ -19,6 +19,7 @@ All notable changes to GNSS-SDR will be documented in this file.
 - Added a CI job to detect lines longer than 512 characters (avoid this
   [lintian tag](https://lintian.debian.org/tags/very-long-line-length-in-source-file.html)
   warning).
+- Added formatting of `.proto` files with clang-format. Added check in CI job.
 
 ## [GNSS-SDR v0.0.20](https://github.com/gnss-sdr/gnss-sdr/releases/tag/v0.0.20) - 2025-04-01
 

docs/protobuf/galileo_ephemeris.proto

@@ -24,10 +24,10 @@ message GalileoEphemeris {
   int32 toe = 17;       // Ephemeris reference time [s]
 
   // Clock correction parameters
-  int32 toc = 18;    // Clock correction data reference Time of Week [sec]
+  int32 toc = 18;   // Clock correction data reference Time of Week [sec]
-  double af0 = 19;   // SV clock bias correction coefficient [s]
+  double af0 = 19;  // SV clock bias correction coefficient [s]
-  double af1 = 20;   // SV clock drift correction coefficient [s/s]
+  double af1 = 20;  // SV clock drift correction coefficient [s/s]
-  double af2 = 21;   // SV clock drift rate correction coefficient [s/s^2]
+  double af2 = 21;  // SV clock drift rate correction coefficient [s/s^2]
 
   double satClkDrift = 22;  // SV clock drift
   double dtr = 23;          // Relativistic clock correction term

docs/protobuf/gnss_synchro.proto

@@ -6,37 +6,37 @@ package gnss_sdr;
 
 /* GnssSynchro represents the processing measurements at a given time taken by a given processing channel */
 message GnssSynchro {
-   string system = 1;  // GNSS constellation: "G" for GPS, "R" for Glonass, "S" for SBAS, "E" for Galileo and "C" for Beidou.
+  string system = 1;  // GNSS constellation: "G" for GPS, "R" for Glonass, "S" for SBAS, "E" for Galileo and "C" for Beidou.
-   string signal = 2;  // GNSS signal: "1C" for GPS L1 C/A, "1B" for Galileo E1b/c, "1G" for Glonass L1 C/A, "2S" for GPS L2 L2C(M), "2G" for Glonass L2 C/A, "L5" for GPS L5 and "5X" for Galileo E5a
+  string signal = 2;  // GNSS signal: "1C" for GPS L1 C/A, "1B" for Galileo E1b/c, "1G" for Glonass L1 C/A, "2S" for GPS L2 L2C(M), "2G" for Glonass L2 C/A, "L5" for GPS L5 and "5X" for Galileo E5a
 
-   uint32 prn = 3;  // PRN number
+  uint32 prn = 3;        // PRN number
-   int32 channel_id = 4;  // Channel number
+  int32 channel_id = 4;  // Channel number
 
-   double acq_delay_samples = 5;  // Coarse code delay estimation, in samples
+  double acq_delay_samples = 5;        // Coarse code delay estimation, in samples
-   double acq_doppler_hz = 6;  // Coarse Doppler estimation in each channel, in Hz
+  double acq_doppler_hz = 6;           // Coarse Doppler estimation in each channel, in Hz
-   uint64 acq_samplestamp_samples = 7;  // Number of samples at signal SampleStamp
+  uint64 acq_samplestamp_samples = 7;  // Number of samples at signal SampleStamp
-   uint32 acq_doppler_step = 8;  // Step of the frequency bin in the search grid, in Hz
+  uint32 acq_doppler_step = 8;         // Step of the frequency bin in the search grid, in Hz
-   bool flag_valid_acquisition = 9;  // Acquisition status
+  bool flag_valid_acquisition = 9;     // Acquisition status
 
-   int64 fs = 10;  // Sampling frequency, in samples per second
+  int64 fs = 10;                        // Sampling frequency, in samples per second
-   double prompt_i = 11;  // In-phase (real) component of the prompt correlator output
+  double prompt_i = 11;                 // In-phase (real) component of the prompt correlator output
-   double prompt_q = 12;  // Quadrature (imaginary) component of the prompt correlator output
+  double prompt_q = 12;                 // Quadrature (imaginary) component of the prompt correlator output
-   double cn0_db_hz = 13;  // Carrier-to-Noise density ratio, in dB-Hz
+  double cn0_db_hz = 13;                // Carrier-to-Noise density ratio, in dB-Hz
-   double carrier_doppler_hz = 14;  // Doppler estimation, in [Hz].
+  double carrier_doppler_hz = 14;       // Doppler estimation, in [Hz].
-   double carrier_phase_rads = 15;  // Carrier phase estimation, in rad
+  double carrier_phase_rads = 15;       // Carrier phase estimation, in rad
-   double code_phase_samples = 16;  // Code phase in samples
+  double code_phase_samples = 16;       // Code phase in samples
-   uint64 tracking_sample_counter = 17;  // Sample counter indicating the number of processed samples
+  uint64 tracking_sample_counter = 17;  // Sample counter indicating the number of processed samples
-   bool flag_valid_symbol_output = 18;  // Indicates the validity of signal tracking
+  bool flag_valid_symbol_output = 18;   // Indicates the validity of signal tracking
-   int32 correlation_length_ms = 19;  // Time duration of coherent correlation integration, in ms
+  int32 correlation_length_ms = 19;     // Time duration of coherent correlation integration, in ms
 
-   bool flag_valid_word = 20;  // Indicates the validity of the decoded navigation message word
+  bool flag_valid_word = 20;             // Indicates the validity of the decoded navigation message word
-   uint32 tow_at_current_symbol_ms = 21;  // Time of week of the current symbol, in ms
+  uint32 tow_at_current_symbol_ms = 21;  // Time of week of the current symbol, in ms
 
-   double pseudorange_m = 22;  // Pseudorange computation, in m
+  double pseudorange_m = 22;                // Pseudorange computation, in m
-   double rx_time = 23;  // Receiving time after the start of the week, in s
+  double rx_time = 23;                      // Receiving time after the start of the week, in s
-   bool flag_valid_pseudorange = 24;  // Pseudorange computation status
+  bool flag_valid_pseudorange = 24;         // Pseudorange computation status
-   double interp_tow_ms = 25;  // Interpolated time of week, in ms
+  double interp_tow_ms = 25;                // Interpolated time of week, in ms
-   bool flag_PLL_180_deg_phase_locked = 26; // PLL lock at 180º
+  bool flag_PLL_180_deg_phase_locked = 26;  // PLL lock at 180º
 }
 
 /* Observables represents a collection of GnssSynchro annotations */

docs/protobuf/gps_ephemeris.proto

@@ -24,10 +24,10 @@ message GpsEphemeris {
   int32 toe = 17;       // Ephemeris reference time [s]
 
   // Clock correction parameters
-  int32 toc = 18;    // Clock correction data reference Time of Week [sec]
+  int32 toc = 18;   // Clock correction data reference Time of Week [sec]
-  double af0 = 19;   // SV clock bias correction coefficient [s]
+  double af0 = 19;  // SV clock bias correction coefficient [s]
-  double af1 = 20;   // SV clock drift correction coefficient [s/s]
+  double af1 = 20;  // SV clock drift correction coefficient [s/s]
-  double af2 = 21;   // SV clock drift rate correction coefficient [s/s^2]
+  double af2 = 21;  // SV clock drift rate correction coefficient [s/s^2]
 
   double satClkDrift = 22;  // SV clock drift
   double dtr = 23;          // Relativistic clock correction term

docs/protobuf/monitor_pvt.proto

@@ -12,11 +12,11 @@ message MonitorPvt {
   double rx_time = 3;                   // PVT GPS time
   double user_clk_offset = 4;           // User clock offset, in s
 
-  double pos_x = 5;  // Position X component in ECEF, expressed in m
+  double pos_x = 5;   // Position X component in ECEF, expressed in m
-  double pos_y = 6;  // Position Y component in ECEF, expressed in m
+  double pos_y = 6;   // Position Y component in ECEF, expressed in m
-  double pos_z = 7;  // Position Z component in ECEF, expressed in m
+  double pos_z = 7;   // Position Z component in ECEF, expressed in m
-  double vel_x = 8;  // Velocity X component in ECEF, in m/s
+  double vel_x = 8;   // Velocity X component in ECEF, in m/s
-  double vel_y = 9;  // Velocity Y component in ECEF, in m/s
+  double vel_y = 9;   // Velocity Y component in ECEF, in m/s
   double vel_z = 10;  // Velocity Z component in ECEF, in m/s
 
   double cov_xx = 11;  // Position variance in the Y component, in m2

docs/protobuf/nav_message.proto

@@ -5,13 +5,13 @@ syntax = "proto3";
 package gnss_sdr;
 
 message navMsg {
-  string system = 1;  // GNSS constellation: "G" for GPS, "R" for Glonass, "E" for Galileo, and "C" for Beidou.
+  string system = 1;                   // GNSS constellation: "G" for GPS, "R" for Glonass, "E" for Galileo, and "C" for Beidou.
-  string signal = 2;  // GNSS signal: "1C" for GPS L1 C/A, "1B" for Galileo E1b/c, "1G" for Glonass L1 C/A, "2S" for GPS L2 L2C(M), "2G" for Glonass L2 C/A, "L5" for GPS L5, "5X" for Galileo E5a, and "E6" for Galileo E6B.
+  string signal = 2;                   // GNSS signal: "1C" for GPS L1 C/A, "1B" for Galileo E1b/c, "1G" for Glonass L1 C/A, "2S" for GPS L2 L2C(M), "2G" for Glonass L2 C/A, "L5" for GPS L5, "5X" for Galileo E5a, and "E6" for Galileo E6B.
-  int32 prn = 3;      // SV ID.
+  int32 prn = 3;                       // SV ID.
   int32 tow_at_current_symbol_ms = 4;  // Time of week of the last symbol received, in ms
-  string nav_message = 5;  // for Galileo I/NAV: decoded half page (even or odd), 120 bits, as described in OS SIS ICD 2.0, paragraph 4.3.2.3. I/NAV Page Part.
+  string nav_message = 5;              // for Galileo I/NAV: decoded half page (even or odd), 120 bits, as described in OS SIS ICD 2.0, paragraph 4.3.2.3. I/NAV Page Part.
-                           // for Galileo F/NAV: decoded word, 244 bits, as described in OS SIS ICD 2.0, paragraph 4.2.2. F/NAV Page Layout.
+                                       // for Galileo F/NAV: decoded word, 244 bits, as described in OS SIS ICD 2.0, paragraph 4.2.2. F/NAV Page Layout.
-                           // for Galileo HAS: decoded full HAS message (header + body), variable length, as described in Galileo HAS SIS ICD.
+                                       // for Galileo HAS: decoded full HAS message (header + body), variable length, as described in Galileo HAS SIS ICD.
-                           // For GPS LNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 20.3.2 Message Structure.
+                                       // For GPS LNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 20.3.2 Message Structure.
-                           // For GPS CNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 30.3.3 Message Content.
+                                       // For GPS CNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 30.3.3 Message Content.
 }

utils/nav-listener/nav_message.proto

@@ -5,13 +5,13 @@ syntax = "proto3";
 package gnss_sdr;
 
 message navMsg {
-  string system = 1;  // GNSS constellation: "G" for GPS, "R" for Glonass, "E" for Galileo, and "C" for Beidou.
+  string system = 1;                   // GNSS constellation: "G" for GPS, "R" for Glonass, "E" for Galileo, and "C" for Beidou.
-  string signal = 2;  // GNSS signal: "1C" for GPS L1 C/A, "1B" for Galileo E1b/c, "1G" for Glonass L1 C/A, "2S" for GPS L2 L2C(M), "2G" for Glonass L2 C/A, "L5" for GPS L5, "5X" for Galileo E5a, and "E6" for Galileo E6B.
+  string signal = 2;                   // GNSS signal: "1C" for GPS L1 C/A, "1B" for Galileo E1b/c, "1G" for Glonass L1 C/A, "2S" for GPS L2 L2C(M), "2G" for Glonass L2 C/A, "L5" for GPS L5, "5X" for Galileo E5a, and "E6" for Galileo E6B.
-  int32 prn = 3;      // SV ID.
+  int32 prn = 3;                       // SV ID.
   int32 tow_at_current_symbol_ms = 4;  // Time of week of the last symbol received, in ms
-  string nav_message = 5;  // for Galileo I/NAV: decoded half page (even or odd), 120 bits, as described in OS SIS ICD 2.0, paragraph 4.3.2.3. I/NAV Page Part.
+  string nav_message = 5;              // for Galileo I/NAV: decoded half page (even or odd), 120 bits, as described in OS SIS ICD 2.0, paragraph 4.3.2.3. I/NAV Page Part.
-                           // for Galileo F/NAV: decoded word, 244 bits, as described in OS SIS ICD 2.0, paragraph 4.2.2. F/NAV Page Layout.
+                                       // for Galileo F/NAV: decoded word, 244 bits, as described in OS SIS ICD 2.0, paragraph 4.2.2. F/NAV Page Layout.
-                           // for Galileo HAS: decoded full HAS message (header + body), variable length, as described in Galileo HAS SIS ICD.
+                                       // for Galileo HAS: decoded full HAS message (header + body), variable length, as described in Galileo HAS SIS ICD.
-                           // For GPS LNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 20.3.2 Message Structure.
+                                       // For GPS LNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 20.3.2 Message Structure.
-                           // For GPS CNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 30.3.3 Message Content.
+                                       // For GPS CNAV: decoded subframe, 300 bits, as described in IS-GPS-200M paragraph 30.3.3 Message Content.
 }