fit4ruby 3.5.0 → 3.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3c3c8eeb82d8dcde4114e43cc7e99882c61eef8cbf204bff47abe8658523dbe
-  data.tar.gz: 02aa11ffebeabab221d493199e402a51ffe3bcbf88d023ca2734c05b22e64362
+  metadata.gz: 1f0a74c755c07cbbcfd9b17b9efeb16a62696fd9076c9ece178e00e51b3ce075
+  data.tar.gz: 81ee48cea068828a6ad08c5f4f274270ec96179159e585ecc9068eccbf1be3a4
 SHA512:
-  metadata.gz: 209b75663bb89a9a52185c632971039651cf71a0ee9758a56b4accfa1559f360123beaa4f055b0d50f064adc43ca0c951050806aeed38d21b7db5a014b597288
-  data.tar.gz: ac995d33edeb4c6c35bb808896933f5f76795efaeb500e73b95d9b270afcc68ff3eca04c1ddd95ae7367c27b6f531576c65d9407271277cadbc732cf5a457aa8
+  metadata.gz: 0f140497b1f269075e912da5988238db3a279ef5baf20e4ce29f3b960307c3b87a4ada116283f17f5965a7e0e25e9b3e5bcdce7306b14ae49cb16d837692b239
+  data.tar.gz: 829a3ff7cee37f26218915d8370a0dd44fe6c24152c634f073fb0d25a543c3e50783188fe81f6d5cbbb00af42974eba1aed51f59ee25a108718773b7a65f8ad8

data/Gemfile.lock

@@ -37,7 +37,7 @@ DEPENDENCIES
   bundler (>= 1.6.4)
   fit4ruby!
   pry (>= 0.12)
-  rake (~> 0.9.6)
+  rake (~> 12.0.0)
   rspec (>= 3.8)
   yard (~> 0.9.20)
 

data/fit4ruby.gemspec

@@ -24,9 +24,9 @@ EOT
   spec.require_paths = ["lib"]
   spec.required_ruby_version = '>=2.0'
 
-  spec.add_dependency('bindata', '=2.3.0')
+  spec.add_dependency('bindata', '~>2.4.8')
   spec.add_development_dependency('yard', '~>0.9.20')
-  spec.add_development_dependency('rake', '~>0.9.6')
+  spec.add_development_dependency('rake', '~>13.0.3')
   spec.add_development_dependency('bundler', '>=1.6.4')
   spec.add_development_dependency('rspec', '>=3.8')
   spec.add_development_dependency('pry', '>=0.12')

data/lib/fit4ruby/Activity.rb

@@ -3,7 +3,7 @@
 #
 # = Activity.rb -- Fit4Ruby - FIT file processing library for Ruby
 #
-# Copyright (c) 2014, 2015 by Chris Schlaeger <cs@taskjuggler.org>
+# Copyright (c) 2014, 2015, 2020 by Chris Schlaeger <cs@taskjuggler.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of version 2 of the GNU General Public License as
@@ -33,45 +33,65 @@ require 'fit4ruby/PersonalRecords'
 
 module Fit4Ruby
 
-  # This is the most important class of this library. It holds references to
-  # all other data structures. Each of the objects it references are direct
-  # equivalents of the message record structures used in the FIT file.
+  # Activity files are arguably the most common type of FIT file. The Activity
+  # class represents the top-level structure of an activity FIT file.
+  # It holds references to all other data structures. Each of the objects it
+  # references are direct equivalents of the message record structures used in
+  # the FIT file.
   class Activity < FitDataRecord
 
-    attr_accessor :file_id, :field_descriptions, :developer_data_ids, :epo_data,
-                  :file_creator, :device_infos, :sensor_settings, :data_sources,
-                  :user_data, :user_profiles, :physiological_metrics,
-                  :sessions, :laps, :records, :lengths, :hrv,
-                  :heart_rate_zones, :events, :personal_records
+    # These symbols are a complete list of all the sub-sections that an
+    # activity FIT file may contain. This list is used to generate accessors,
+    # instance variables and other sections of code. Some are just simple
+    # instance variables, but the majority can appear multiple times and hence
+    # are stored in an Array.
+    FILE_SECTIONS = [
+      :file_id,
+      :file_creator,
+      :events,
+      :device_infos,
+      :data_sources,
+      :epo_data,
+      :user_profiles,
+      :user_data,
+      :sensor_settings,
+      :developer_data_ids,
+      :field_descriptions,
+      :records,
+      :hrv,
+      :laps,
+      :lengths,
+      :heart_rate_zones,
+      :physiological_metrics,
+      :sessions,
+      :personal_records
+    ]
+
+    attr_accessor *FILE_SECTIONS
 
     # Create a new Activity object.
     # @param field_values [Hash] A Hash that provides initial values for
     #        certain fields of the FitDataRecord.
     def initialize(field_values = {})
       super('activity')
-      @meta_field_units['total_gps_distance'] = 'm'
-      @num_sessions = 0
 
-      @file_id = FileId.new
-      @field_descriptions = []
-      @developer_data_ids = []
+      # The variables hold references to other parts of the FIT file. These
+      # can either be direct references to a certain FIT file section or an
+      # Array in case the section can appear multiple times in the FIT file.
+      @file_id = new_file_id()
+      @file_creator = new_file_creator()
       @epo_data = nil
-      @file_creator = FileCreator.new
-      @device_infos = []
-      @sensor_settings = []
-      @data_sources = []
-      @user_data = []
-      @user_profiles = []
-      @physiological_metrics = []
-      @events = []
-      @sessions = []
-      @laps = []
-      @lengths = []
-      @records = []
-      @hrv = []
-      @heart_rate_zones = []
-      @personal_records = []
+      # Initialize the remaining variables as empty Array.
+      FILE_SECTIONS.each do |fs|
+        ivar_name = '@' + fs.to_s
+        unless instance_variable_defined?(ivar_name)
+          instance_variable_set(ivar_name, [])
+        end
+      end
 
+      # The following variables hold derived or auxilliary information that
+      # are not directly part of the FIT file.
+      @meta_field_units['total_gps_distance'] = 'm'
       @cur_session_laps = []
 
       @cur_lap_records = []
@@ -99,11 +119,6 @@ module Fit4Ruby
       end
       @device_infos.each.with_index { |d, index| d.check(index) }
       @sensor_settings.each.with_index { |s, index| s.check(index) }
-      unless @num_sessions == @sessions.count
-        Log.fatal "Activity record requires #{@num_sessions}, but "
-                  "#{@sessions.length} session records were found in the "
-                  "FIT file."
-      end
 
       # Records must have consecutively growing timestamps and distances.
       ts = Time.parse('1989-12-31')
@@ -308,13 +323,17 @@ module Fit4Ruby
     def write(io, id_mapper)
       @file_id.write(io, id_mapper)
       @file_creator.write(io, id_mapper)
+      @epo_data.write(io, id_mapper) if @epo_data
 
-      (@field_descriptions + @developer_data_ids +
-       @device_infos + @sensor_settings +
-       @data_sources + @user_profiles +
-       @physiological_metrics + @events +
-       @sessions + @laps + @records + @lengths +
-       @heart_rate_zones + @personal_records).sort.each do |s|
+      ary_ivars = []
+      FILE_SECTIONS.each do |fs|
+        ivar_name = '@' + fs.to_s
+        if (ivar = instance_variable_get(ivar_name)) && ivar.respond_to?(:sort)
+          ary_ivars += ivar
+        end
+      end
+
+      ary_ivars.sort.each do |s|
         s.write(io, id_mapper)
       end
       super
@@ -464,18 +483,17 @@ module Fit4Ruby
     # @return [TrueClass/FalseClass] true if both Activities are equal,
     # otherwise false.
     def ==(a)
-      super(a) && @file_id == a.file_id &&
-        @file_creator == a.file_creator &&
-        @field_descriptions == a.field_descriptions &&
-        @developer_data_ids == a.developer_data_ids &&
-        @device_infos == a.device_infos &&
-        @sensor_settings == a.sensor_settings &&
-        @data_sources == a.data_sources &&
-        @physiological_metrics == a.physiological_metrics &&
-        @user_profiles == a.user_profiles &&
-        @heart_rate_zones == a.heart_rate_zones &&
-        @events == a.events &&
-        @sessions == a.sessions && personal_records == a.personal_records
+      return false unless super(a)
+
+      FILE_SECTIONS.each do |fs|
+        ivar_name = '@' + fs.to_s
+        ivar = instance_variable_get(ivar_name)
+        a_ivar = a.instance_variable_get(ivar_name)
+
+        return false unless ivar == a_ivar
+      end
+
+      true
     end
 
     # Create a new FitDataRecord.
@@ -521,7 +539,6 @@ module Fit4Ruby
           # Ensure that all previous records have been assigned to a lap.
           record = create_new_lap(lap_field_values)
         end
-        @num_sessions += 1
         @sessions << (record = Session.new(@cur_session_laps, @lap_counter,
                                            field_values))
         @cur_session_laps = []
@@ -530,7 +547,7 @@ module Fit4Ruby
       when 'length'
         record = create_new_length(field_values)
       when 'record'
-        record = Record.new(field_values)
+        record = Record.new(self, field_values)
         @cur_lap_records << record
         @cur_length_records << record
         @records << record
@@ -547,10 +564,31 @@ module Fit4Ruby
       record
     end
 
+    def export
+      # Collect all records in a consistent order.
+      records = []
+      FILE_SECTIONS.each do |fs|
+        ivar_name = '@' + fs.to_s
+        ivar = instance_variable_get(ivar_name)
+
+        next unless ivar
+
+        if ivar.respond_to?(:sort) and ivar.respond_to?(:empty?)
+          records += ivar.sort unless ivar.empty?
+        else
+          records << ivar if ivar
+        end
+      end
+
+      records.map do |record|
+        record.export
+      end
+    end
+
     private
 
     def create_new_lap(field_values)
-      lap = Lap.new(@cur_lap_records, @laps.last,
+      lap = Lap.new(self, @cur_lap_records, @laps.last,
                     field_values,
                     @length_counter, @cur_lap_lengths)
       lap.message_index = @lap_counter - 1
@@ -573,6 +611,7 @@ module Fit4Ruby
 
       length
     end
+
   end
 
 end

data/lib/fit4ruby/BDFieldNameTranslator.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = FitDataRecord.rb -- Fit4Ruby - FIT file processing library for Ruby
+#
+# Copyright (c) 2020 by Chris Schlaeger <cs@taskjuggler.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+module Fit4Ruby
+
+  # Some FIT message field names conflict with BinData reserved names. We use
+  # this translation method to map the conflicting names to BinData compatible
+  # names.
+  module BDFieldNameTranslator
+
+    BD_DICT =  {
+      'array' => '_array',
+      'type' => '_type'
+    }
+
+    def to_bd_field_name(name)
+      if (bd_name = BD_DICT[name])
+        return bd_name
+      end
+
+      name
+    end
+
+  end
+
+end
+

data/lib/fit4ruby/DeviceInfo.rb

@@ -32,6 +32,43 @@ module Fit4Ruby
         @timestamp <=> fdr.timestamp
     end
 
+    def numeric_manufacturer
+      if @manufacturer && @manufacturer.is_a?(String)
+        if @manufacturer[0..17] == 'Undocumented value'
+          return @manufacturer[18..-1].to_i
+        else
+          return GlobalFitDictionaries['manufacturer'].
+            value_by_name(@manufacturer)
+        end
+      end
+
+      Log.fatal "Unexpected @manufacturer (#{@manufacturer}) value"
+    end
+
+    def numeric_product
+      # The numeric product ID must be an integer or nil. In case the
+      # dictionary did not contain an entry for the numeric ID in the fit file
+      # the @garmin_product or @product variables contain a String starting
+      # with 'Undocumented value ' followed by the ID.
+      if @garmin_product && @garmin_product.is_a?(String)
+        if @garmin_product[0..17] == 'Undocumented value'
+          return @garmin_product[18..-1].to_i
+        else
+          return GlobalFitDictionaries['garmin_product'].
+            value_by_name(@garmin_product)
+        end
+      elsif @product && @product.is_a?(String)
+        if @product[0..17] == 'Undocumented value'
+          return @product[18..-1].to_i
+        else
+          return GlobalFitDictionaries['product'].value_by_name(@product)
+        end
+      end
+
+      Log.fatal "Unexpected @product (#{@product}) or " +
+        "@garmin_product (#{@garmin_product}) values"
+    end
+
     def check(index)
       unless @device_index
         Log.fatal 'device info record must have a device_index'

data/lib/fit4ruby/FDR_DevField_Extension.rb

@@ -0,0 +1,81 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = FDR_DevField_Extension.rb -- Fit4Ruby - FIT file processing library for Ruby
+#
+# Copyright (c) 2020 by Chris Schlaeger <cs@taskjuggler.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+module Fit4Ruby
+
+  # This module extends FitDataRecord derived classes in case they have
+  # developer fields.
+  module FDR_DevField_Extension
+
+    def create_dev_field_instance_variables
+      # Create instance variables for developer fields
+      @dev_field_descriptions = {}
+      @top_level_record.field_descriptions.each do |field_description|
+        # Only create instance variables if the FieldDescription is for this
+        # message number.
+        if field_description.native_mesg_num == @message.number
+          name = field_description.full_field_name(@top_level_record.
+                                                   developer_data_ids)
+          create_instance_variable(name)
+          @dev_field_descriptions[name] = field_description
+        end
+      end
+    end
+
+    def each_developer_field
+      @top_level_record.field_descriptions.each do |field_description|
+        # Only create instance variables if the FieldDescription is for this
+        # message number.
+        if field_description.native_mesg_num == @message.number
+          name = field_description.full_field_name(@top_level_record.
+                                                   developer_data_ids)
+          yield(field_description, instance_variable_get('@' + name))
+        end
+      end
+    end
+
+    def get_unit_by_name(name)
+      if /[A-Za-z_]+_[A-F0-9]{16}/ =~ name
+        @dev_field_descriptions[name].units
+      else
+        super
+      end
+    end
+
+    def export
+      message = super
+
+      each_developer_field do |field_description, ivar|
+        field = field_description.message.fields_by_number[
+          field_description.native_field_num]
+        fit_value = field.native_to_fit(ivar)
+        unless field.is_undefined?(fit_value)
+          fld = {
+            'number' => field_description.native_field_num | 128,
+            'value' => field.fit_to_native(fit_value),
+            #'human' => field.to_human(fit_value),
+            'type' => field.type
+          }
+          fld['unit'] = field.opts[:unit] if field.opts[:unit]
+          fld['scale'] = field.opts[:scale] if field.opts[:scale]
+
+          message['fields'][field.name] = fld
+        end
+      end
+
+      message
+    end
+
+  end
+
+end
+

data/lib/fit4ruby/FieldDescription.rb

@@ -3,7 +3,7 @@
 #
 # = FieldDescription.rb -- Fit4Ruby - FIT file processing library for Ruby
 #
-# Copyright (c) 2017, 2018, 2019 by Chris Schlaeger <cs@taskjuggler.org>
+# Copyright (c) 2017, 2018, 2019, 2020 by Chris Schlaeger <cs@taskjuggler.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of version 2 of the GNU General Public License as
@@ -25,6 +25,24 @@ module Fit4Ruby
     def initialize(field_values = {})
       super('field_description')
       set_field_values(field_values)
+
+      @full_field_name = nil
+    end
+
+    def full_field_name(developer_data_ids)
+      return @full_field_name if @full_field_name
+
+      if @developer_data_index >=
+           developer_data_ids.size
+         Log.error "Developer data index #{@developer_data_index} is too large"
+         return
+      end
+
+      app_id = developer_data_ids[@developer_data_index].application_id
+      # Convert the byte array with the app ID into a 16 character hex string.
+      app_id_str = app_id.map { |i| '%02X' % i }.join('')
+      @full_field_name =
+        "#{@field_name.gsub(/[^A-Za-z0-9_]/, '_')}_#{app_id_str}"
     end
 
     def create_global_definition(fit_entity)
@@ -35,18 +53,18 @@ module Fit4Ruby
         return
       end
 
-      if @developer_data_index >=
-           fit_entity.top_level_record.developer_data_ids.size
-         Log.error "Developer data index #{@developer_data_index} is too large"
-         return
-      end
-
       msg = messages[@native_mesg_num] ||
         messages.message(@native_mesg_num, gfm.name)
       unless (@fit_base_type_id & 0x7F) < FIT_TYPE_DEFS.size
         Log.error "fit_base_type_id #{@fit_base_type_id} is too large"
         return
       end
+
+      # A fit file may include multiple definitions of the same field. We
+      # ignore all subsequent definitions.
+      return if msg.has_field?(full_field_name(fit_entity.top_level_record.
+                                               developer_data_ids))
+
       options = {}
       options[:scale] = @scale if @scale
       options[:offset] = @offset if @offset
@@ -54,7 +72,7 @@ module Fit4Ruby
       options[:unit] = @units
       msg.field(@field_definition_number,
                 FIT_TYPE_DEFS[@fit_base_type_id & 0x7F][1],
-                "_#{@developer_data_index}_#{@field_name}", options)
+                @full_field_name, options)
     end
 
   end

data/lib/fit4ruby/FileId.rb

@@ -3,7 +3,7 @@
 #
 # = FileId.rb -- Fit4Ruby - FIT file processing library for Ruby
 #
-# Copyright (c) 2014 by Chris Schlaeger <cs@taskjuggler.org>
+# Copyright (c) 2014, 2020 by Chris Schlaeger <cs@taskjuggler.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of version 2 of the GNU General Public License as
@@ -23,6 +23,7 @@ module Fit4Ruby
       @time_created = Time.at(Time.now.to_i)
       @manufacturer = 'development'
       @type = 'activity'
+      @product = 0
 
       set_field_values(field_values)
     end