evva 0.1.4.1 → 0.2.0

data/lib/evva/swift_generator.rb

@@ -1,72 +1,50 @@
 module Evva
   class SwiftGenerator
-    SWIFT_EVENT_HEADER =
-      "import CoreLocation\n"\
-      "import Foundation\n"\
-      "import SharedCode\n\n"\
-      "@objc class MixpanelHelper: NSObject {\n\n"\
-      "\tprivate struct EventData {\n"\
-      "\t\tlet name: String\n"\
-      "\t\tlet properties: [String: Any]?\n"\
-      "\t\tlet timeEvent: Bool\n\n"\
-      "\t\tinit(name: String, properties: [String: Any]? = nil, timeEvent: Bool = false) {\n"\
-      "\t\t\tself.name = name\n"\
-      "\t\t\tself.properties = properties\n"\
-      "\t\t\tself.timeEvent = timeEvent\n"\
-      "\t\t}\n"\
-      "\t}\n\n"\
-      "\tenum Event {\n".freeze
-
-    SWIFT_EVENT_DATA_HEADER =
-      "\t\tprivate var data: EventData {\n"\
-      "\t\t\tswitch self {\n".freeze
-
-    SWIFT_PEOPLE_HEADER = "fileprivate enum Counter: String {\n".freeze
-
-    SWIFT_INCREMENT_FUNCTION =
-      "\tfunc increment(times: Int = 1) {\n"\
-      "\t\tMixpanelAPI.instance.incrementCounter(rawValue, times: times)\n"\
-      "\t}".freeze
+    EXTENSION_HEADER =
+      "\nimport Foundation\n\n"\
+      "extension Analytics {\n\n".freeze
+
+    EXTENSION_FOOTER =
+      "\n\n}\n"
 
     NATIVE_TYPES = %w[Int String Double Float Bool].freeze
 
     def events(bundle, file_name)
-      event_file = SWIFT_EVENT_HEADER
-      bundle.each do |event|
-        event_file += swift_case(event)
-      end
-      event_file += SWIFT_EVENT_DATA_HEADER
-      bundle.each do |event|
-        event_file += swift_event_data(event)
+      header_footer_wrapper do
+"""\tenum Event {
+#{bundle.map { |e| event_case(e) }.join("\n")}
+
+\t\tvar data: EventData {
+\t\t\tswitch self {
+#{bundle.map { |e| event_data(e) }.join("\n\n")}
+\t\t\t}
+\t\t}
+\t}"""
       end
-      event_file += "\t\t\t}\n"
-      event_file += "\t\t}\n"
-      event_file += "\t}\n"
-      event_file += "}\n"
     end
 
-    def swift_case(event_data)
-      function_name = 'track' + titleize(event_data.event_name)
+    def event_case(event_data)
+      function_name = camelize(event_data.event_name)
       if event_data.properties.empty?
-        "\t\tcase #{function_name}\n"
+        "\t\tcase #{function_name}"
       else
         trimmed_properties = event_data.properties.map { |k, v| k.to_s + ': ' + native_type(v) }.join(", ")
-        "\t\tcase #{function_name}(#{trimmed_properties})\n"
+        "\t\tcase #{function_name}(#{trimmed_properties})"
       end
     end
 
-    def swift_event_data(event_data)
-      function_name = 'track' + titleize(event_data.event_name)
+    def event_data(event_data)
+      function_name = camelize(event_data.event_name)
       if event_data.properties.empty?
         function_body = "\t\t\tcase .#{function_name}:\n" \
-                        "\t\t\t\treturn EventData(name: \"#{event_data.event_name}\")\n\n"
+                        "\t\t\t\treturn EventData(name: \"#{event_data.event_name}\")"
       else
         function_header = prepend_let(event_data.properties)
         function_arguments = dictionary_pairs(event_data.properties)
         function_body = "\t\t\tcase .#{function_name}(#{function_header}):\n"\
                         "\t\t\t\treturn EventData(name: \"#{event_data.event_name}\", properties: [\n"\
                         "\t\t\t\t\t#{function_arguments.join(",\n\t\t\t\t\t")} ]\n"\
-                        "\t\t\t\t)\n\n"
+                        "\t\t\t\t)"
       end
       function_body
     end
@@ -76,16 +54,39 @@ module Evva
     end
 
     def people_properties(people_bundle, file_name)
-      properties = SWIFT_PEOPLE_HEADER
-      properties += people_bundle.map { |prop| swift_people_const(prop) }.join('')
-      properties + "\n" + SWIFT_INCREMENT_FUNCTION + "\n}\n"
+      header_footer_wrapper do
+        props = "\tenum Property: String {\n"
+        people_bundle.each do |prop|
+          props << "\t\tcase #{camelize(prop)} = \"#{prop}\"\n"
+        end
+        props << "\t}"
+      end
+    end
+
+    def special_property_enums(enums)
+      header_footer_wrapper do
+        enums.map do |enum|
+          body = "\tenum #{enum.enum_name}: String {\n"
+          enum.values.each do |value|
+            body << "\t\tcase #{camelize(value)} = \"#{value}\"\n"
+          end
+          body << "\t}"
+        end.join("\n\n")
+      end
     end
 
-    def special_property_enum(enum)
-      enum_body = "import Foundation\n\n"
-      enum_body += "enum #{enum.enum_name}: String {\n"
-      enum_body += enum.values.map { |vals| "\tcase #{vals.tr(' ', '_')} = \"#{vals}\"\n" }.join('')
-      enum_body + "} \n"
+    private
+
+    def header_footer_wrapper
+"""// This file was automatically generated by evva: https://github.com/hole19/evva
+
+import Foundation
+
+extension Analytics {
+
+#{yield.gsub("\t", "    ")}
+}
+"""
     end
 
     def dictionary_pairs(props)
@@ -101,8 +102,6 @@ module Evva
       end
     end
 
-    private
-
     def is_raw_representable_property?(type)
       !NATIVE_TYPES.include?(native_type(type).chomp('?'))
     end
@@ -119,12 +118,13 @@ module Evva
       props.map { |k, v| "let #{k}" }.join(', ')
     end
 
-    def swift_people_const(prop)
-      "\tcase #{titleize(prop)} = \"#{prop}\"\n"
+    def camelize(term)
+      string = term.to_s.tr(' ', '_').downcase
+      string = string.sub(/^(?:#{@acronym_regex}(?=\b|[A-Z_])|\w)/) { |match| match.downcase }
+      string.gsub!(/(?:_|(\/))([a-z\d]*)/i) { "#{$1}#{$2.capitalize}" }
+      string.gsub!("/".freeze, "::".freeze)
+      string
     end
 
-    def titleize(str)
-      str.split('_').collect(&:capitalize).join
-    end
   end
 end

data/lib/evva/version.rb

@@ -1,4 +1,4 @@
 module Evva
-  VERSION = '0.1.4.1'.freeze
-  VERSION_UPDATED_AT = '2018-02-08'.freeze
+  VERSION = '0.2.0'.freeze
+  VERSION_UPDATED_AT = '2021-08-30'.freeze
 end

data/lib/evva.rb

@@ -5,7 +5,6 @@ require 'evva/logger'
 require 'evva/google_sheet'
 require 'evva/config'
 require 'evva/file_reader'
-require 'evva/data_source'
 require 'evva/mixpanel_event'
 require 'evva/mixpanel_enum'
 require 'evva/object_extension'
@@ -27,7 +26,7 @@ module Evva
     bundle = analytics_data(config: config.data_source)
     case config.type.downcase
     when 'android'
-      generator = Evva::AndroidGenerator.new
+      generator = Evva::AndroidGenerator.new(config.package_name)
       evva_write(bundle, generator, config, 'kt')
     when 'ios'
       generator = Evva::SwiftGenerator.new
@@ -44,20 +43,19 @@ module Evva
       path = "#{configuration.out_path}/#{configuration.event_enum_file_name}.#{extension}"
       write_to_file(path, generator.event_enum(bundle[:events], configuration.event_enum_file_name))
     end
+
     path = "#{configuration.out_path}/#{configuration.people_file_name}.#{extension}"
     write_to_file(path, generator.people_properties(bundle[:people], configuration.people_file_name))
 
-    bundle[:enums].each do |enum|
-      path = "#{configuration.out_path}/#{enum.enum_name}.#{extension}"
-      write_to_file(path, generator.special_property_enum(enum))
-    end
+    path = "#{configuration.out_path}/#{configuration.special_enum_file_name}.#{extension}"
+    write_to_file(path, generator.special_property_enums(bundle[:enums]))
   end
 
   def analytics_data(config:)
     source =
       case config[:type]
       when 'google_sheet'
-        Evva::GoogleSheet.new(config[:sheet_id])
+        Evva::GoogleSheet.new(config[:events_url], config[:people_properties_url], config[:enum_classes_url])
       end
     events_bundle = {}
     events_bundle[:events] = source.events

data/spec/fixtures/sample_public_enums.csv

@@ -0,0 +1,3 @@
+Enum Name,Possible Values
+PageViewSourceScreen,"course_discovery,synced_courses,nearby,deal"
+PremiumClickBuy,"notes,hi_res_maps,whatever"

data/spec/fixtures/sample_public_events.csv

@@ -0,0 +1,4 @@
+Event Name,Event Properties
+cp_page_view,"course_id:Long,course_name:String"
+nav_feed_tap,
+cp_view_scorecard,"course_id:Long,course_name:String"

data/spec/fixtures/sample_public_people_properties.csv

@@ -0,0 +1,3 @@
+Property Name,Comments
+rounds_with_wear,asldkaslkdlaksd
+total_friends,

data/spec/fixtures/test.yml

@@ -2,9 +2,12 @@ type: Android
 
 data_source:
   type: google_sheet
-  sheet_id: 1LaJd68os3g_GFlerogC64grNIlXb2iukMznOvdml7A4
+  events_url: https://path-to-csv
+  people_properties_url: https://path-to-csv
+  enum_classes_url: https://path-to-csv
 
 out_path: analytics
 event_file_name: MixpanelAnalytics
 event_enum_file_name: MixpanelEvent
-people_file_name: MixpanelProperties
+people_file_name: MixpanelProperties
+package_name: com.package.name.analytics

data/spec/lib/evva/android_generator_spec.rb

@@ -1,135 +1,153 @@
 describe Evva::AndroidGenerator do
-  let(:generator) { described_class.new }
+  let(:generator) { described_class.new("com.hole19golf.hole19.analytics") }
 
-  def trim_spaces(str)
-      str.gsub(/^[ \t]+/, '')
-         .gsub(/[ \t]+$/, '')
-  end
+  describe '#events' do
+    subject { generator.events(events, "MixpanelAnalytics") }
 
-  describe '#kotlin_function' do
-    subject { trim_spaces(generator.kotlin_function(event)) }
+    let(:events) { [
+      Evva::MixpanelEvent.new('cp_page_view'),
+      Evva::MixpanelEvent.new('cp_page_view_a', { course_id: 'Long', course_name: 'String' }),
+      Evva::MixpanelEvent.new('cp_page_view_b', { course_id: 'Long', course_name: 'String', from_screen: 'CourseProfileSource' }),
+      Evva::MixpanelEvent.new('cp_page_view_c', { course_id: 'Long', course_name: 'String', from_screen: 'CourseProfileSource?' }),
+      Evva::MixpanelEvent.new('cp_page_view_d', { course_id: 'Long?', course_name: 'String' })
+    ] }
 
-    context 'when the event has no properties' do
-      let(:event) { Evva::MixpanelEvent.new('nav_feed_tap') }
-      let(:expected) { <<-Kotlin
-        open fun trackNavFeedTap() {
-          mixpanelMask.trackEvent(MixpanelEvent.NAV_FEED_TAP)
-        }
-        Kotlin
-      }
-      it { should eq trim_spaces(expected) }
-    end
-
-    context 'event has properties' do
-      let(:event) { Evva::MixpanelEvent.new('cp_page_view', { course_id: 'Long', course_name: 'String' }) }
-      let(:expected) { <<-Kotlin
-        open fun trackCpPageView(course_id: Long, course_name: String) {
-          val properties = JSONObject().apply {
+    let(:expected) {
+<<-Kotlin
+package com.hole19golf.hole19.analytics
+
+import com.hole19golf.hole19.analytics.Event
+import com.hole19golf.hole19.analytics.MixpanelAnalyticsMask
+import org.json.JSONObject
+
+/**
+ * This file was automatically generated by evva: https://github.com/hole19/evva
+ */
+
+open class MixpanelAnalytics(private val mask: MixpanelAnalyticsMask) {
+
+    open fun trackCpPageView() {
+        mask.trackEvent(MixpanelEvent.CP_PAGE_VIEW)
+    }
+
+    open fun trackCpPageViewA(course_id: Long, course_name: String) {
+        val properties = JSONObject().apply {
             put("course_id", course_id)
             put("course_name", course_name)
-          }
-          mixpanelMask.trackEvent(MixpanelEvent.CP_PAGE_VIEW, properties)
         }
-        Kotlin
-      }
-      it { should eq trim_spaces(expected) }
-    end
-
-    context 'event has special properties' do
-      let(:event) { Evva::MixpanelEvent.new('cp_page_view', { course_id: 'Long', course_name: 'String', from_screen: 'CourseProfileSource' }) }
-      let(:expected) { <<-Kotlin
-        open fun trackCpPageView(course_id: Long, course_name: String, from_screen: CourseProfileSource) {
-          val properties = JSONObject().apply {
+        mask.trackEvent(MixpanelEvent.CP_PAGE_VIEW_A, properties)
+    }
+
+    open fun trackCpPageViewB(course_id: Long, course_name: String, from_screen: CourseProfileSource) {
+        val properties = JSONObject().apply {
             put("course_id", course_id)
             put("course_name", course_name)
             put("from_screen", from_screen.key)
-          }
-          mixpanelMask.trackEvent(MixpanelEvent.CP_PAGE_VIEW, properties)
         }
-        Kotlin
-      }
-      it { should eq trim_spaces(expected) }
-    end
-
-    context 'event has optional properties' do
-      let(:event) { Evva::MixpanelEvent.new('cp_page_view', { course_id: 'Long', course_name: 'String', from_screen: 'CourseProfileSource?' }) }
-      let(:expected) { <<-Kotlin
-        open fun trackCpPageView(course_id: Long, course_name: String, from_screen: CourseProfileSource?) {
-          val properties = JSONObject().apply {
+        mask.trackEvent(MixpanelEvent.CP_PAGE_VIEW_B, properties)
+    }
+
+    open fun trackCpPageViewC(course_id: Long, course_name: String, from_screen: CourseProfileSource?) {
+        val properties = JSONObject().apply {
             put("course_id", course_id)
             put("course_name", course_name)
             from_screen?.let { put("from_screen", it.key) }
-          }
-          mixpanelMask.trackEvent(MixpanelEvent.CP_PAGE_VIEW, properties)
         }
-        Kotlin
-      }
-      it { should eq trim_spaces(expected) }
-    end
-
-    context 'event has optional but not special properties' do
-      let(:event) { Evva::MixpanelEvent.new('cp_page_view', { course_id: 'Long?', course_name: 'String' }) }
-      let(:expected) { <<-Kotlin
-        open fun trackCpPageView(course_id: Long?, course_name: String) {
-          val properties = JSONObject().apply {
+        mask.trackEvent(MixpanelEvent.CP_PAGE_VIEW_C, properties)
+    }
+
+    open fun trackCpPageViewD(course_id: Long?, course_name: String) {
+        val properties = JSONObject().apply {
             course_id?.let { put("course_id", it) }
             put("course_name", course_name)
-          }
-          mixpanelMask.trackEvent(MixpanelEvent.CP_PAGE_VIEW, properties)
         }
-        Kotlin
-      }
-      it { should eq trim_spaces(expected) }
-    end
+        mask.trackEvent(MixpanelEvent.CP_PAGE_VIEW_D, properties)
+    }
+
+    open fun updateProperties(property: MixpanelProperties, value: Any) {
+        mask.updateProperties(property.key, value)
+    }
+
+    open fun incrementCounter(property: MixpanelProperties) {
+        mask.incrementCounter(property.key)
+    }
+}
+Kotlin
+    }
+
+    it { should eq expected }
   end
 
-  describe '#special_property_enum' do
-    subject { trim_spaces(generator.special_property_enum(enum)) }
-    let(:enum) { Evva::MixpanelEnum.new('CourseProfileSource', ['course_discovery','synced_courses']) }
-    let(:expected) { <<-Kotlin
-      package com.hole19golf.hole19.analytics
-
-      enum class CourseProfileSource(val key: String) {
-        COURSE_DISCOVERY("course_discovery"),
-        SYNCED_COURSES("synced_courses")
-      }
-      Kotlin
+  describe '#special_property_enums' do
+    subject { generator.special_property_enums(enums) }
+    let(:enums) { [
+      Evva::MixpanelEnum.new('CourseProfileSource', ['course_discovery', 'synced_courses']),
+      Evva::MixpanelEnum.new('PremiumFrom', ['Course Profile', 'Round Setup'])
+    ] }
+    let(:expected) {
+<<-Kotlin
+package com.hole19golf.hole19.analytics
+
+/**
+ * This file was automatically generated by evva: https://github.com/hole19/evva
+ */
+
+enum class CourseProfileSource(val key: String) {
+    COURSE_DISCOVERY("course_discovery"),
+    SYNCED_COURSES("synced_courses");
+}
+
+enum class PremiumFrom(val key: String) {
+    COURSE_PROFILE("Course Profile"),
+    ROUND_SETUP("Round Setup");
+}
+Kotlin
      }
-    it { should eq trim_spaces(expected) }
+    it { should eq expected }
   end
 
   describe '#event_enum' do
-    subject { trim_spaces(generator.event_enum(event_bundle, 'MixpanelEvent')) }
+    subject { generator.event_enum(event_bundle, 'MixpanelEvent') }
     let(:event_bundle) { [
       Evva::MixpanelEvent.new('nav_feed_tap', {}),
       Evva::MixpanelEvent.new('nav_performance_tap', {})
       ] }
-    let(:expected) { <<-Kotlin
-      package com.hole19golf.hole19.analytics
-      import com.hole19golf.hole19.analytics.Event
-
-      enum class MixpanelEvent(override val key: String) : Event {
-        NAV_FEED_TAP("nav_feed_tap"),
-        NAV_PERFORMANCE_TAP("nav_performance_tap")
-      }
-      Kotlin
+    let(:expected) {
+<<-Kotlin
+package com.hole19golf.hole19.analytics
+
+import com.hole19golf.hole19.analytics.Event
+
+/**
+ * This file was automatically generated by evva: https://github.com/hole19/evva
+ */
+
+enum class MixpanelEvent(override val key: String) : Event {
+    NAV_FEED_TAP("nav_feed_tap"),
+    NAV_PERFORMANCE_TAP("nav_performance_tap");
+}
+Kotlin
      }
-    it { should eq trim_spaces(expected) }
+    it { should eq expected }
   end
 
   describe '#people_properties' do
-    subject { trim_spaces(generator.people_properties(people_bundle, 'MixpanelProperties')) }
+    subject { generator.people_properties(people_bundle, 'MixpanelProperties') }
     let(:people_bundle) { ['rounds_with_wear', 'friends_from_facebook'] }
-    let(:expected) { <<-Kotlin
-      package com.hole19golf.hole19.analytics
-      import com.hole19golf.hole19.analytics.Event
-
-      enum class MixpanelProperties(val key: String) {
-        ROUNDS_WITH_WEAR("rounds_with_wear"),
-        FRIENDS_FROM_FACEBOOK("friends_from_facebook");
-      }
-      Kotlin
+    let(:expected) {
+<<-Kotlin
+package com.hole19golf.hole19.analytics
+
+/**
+ * This file was automatically generated by evva: https://github.com/hole19/evva
+ */
+
+enum class MixpanelProperties(val key: String) {
+    ROUNDS_WITH_WEAR("rounds_with_wear"),
+    FRIENDS_FROM_FACEBOOK("friends_from_facebook");
+}
+Kotlin
     }
-    it { should eq trim_spaces(expected) }
+    it { should eq expected }
   end
 end