ruby-macrodroid 0.5.1 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c73d4f6bcddec53817e6ae7c59224759e58dd490ab53b2cab91728ceb98961f7
-  data.tar.gz: 37887f1b46a2158d5101b2c51ae444016dcf34606df34f8e6f58aed05482efb9
+  metadata.gz: 70dd1172a7d2ad827ff72771851910b140616b3f41fd7843ef65dc5bdf55fd5e
+  data.tar.gz: d5ef7e748dd16bfbc83e0ca05932a2b7723c61ea2ee2fbc8f69ef1c77c651ef0
 SHA512:
-  metadata.gz: 6bb6b3059e62aa4ce7924207a6fe545bc5b588d4ea4eab315361be595c47f343602a617dc7c2fdbc4701b44456dfcd18b255dc0fccfd904f7b56b5455f6f67a4
-  data.tar.gz: 2b7f77a7b582a0a8d7beda8ba09d10973e06a4844d114398a5bf534e755e66914cede0023693605abe0100f882befe7598271d70aaa5747bde9dac39c04d03d3
+  metadata.gz: 91746fa312b8c1c5069c16f5c7337b1f6f438af8afecedc5e6469f21e00f98108788f3248d8d93284d9829858b0bf11ce5ad1591bba4a7f8f4ed1005a71c111c
+  data.tar.gz: bd1cefc341fd57809b563f1a4f21f013b3fe3e93143cef0c07862bdfe738ca6479e39c86a80355c110bd786da5b63849cc59616c7d67be58750c4ff2c68a47c3

data/lib/ruby-macrodroid.rb

@@ -2,7 +2,117 @@
 
 # file: ruby-macrodroid.rb
 
+# This file contains the following classes:
+#
+#  ## Nlp classes
+#  
+#  TriggersNlp ActionsNlp ConstraintsNlp
+#  
+#  
+#  ## Macro class
+#  
+#  Macro
+#  
+#  
+#  ## Error class
+#  
+#  MacroDroidError
+#  
+#  
+#  ## Droid class
+#  
+#  MacroDroid
+#  
+#  
+#  ## Map class
+#  
+#  GeofenceMap
+#  
+#  
+#  ## Object class
+#  
+#  MacroObject
+#  
+#  
+#  ## Trigger classes
+#  
+#  Trigger WebHookTrigger WifiConnectionTrigger
+#  ApplicationInstalledRemovedTrigger ApplicationLaunchedTrigger
+#  BatteryLevelTrigger BatteryTemperatureTrigger PowerButtonToggleTrigger
+#  ExternalPowerTrigger CallActiveTrigger IncomingCallTrigger
+#  OutgoingCallTrigger CallEndedTrigger CallMissedTrigger IncomingSMSTrigger
+#  WebHookTrigger WifiConnectionTrigger BluetoothTrigger HeadphonesTrigger
+#  SignalOnOffTrigger UsbDeviceConnectionTrigger WifiSSIDTrigger
+#  CalendarTrigger TimerTrigger StopwatchTrigger DayTrigger
+#  RegularIntervalTrigger DeviceEventsTrigger AirplaneModeTrigger
+#  AutoSyncChangeTrigger DayDreamTrigger DockTrigger FailedLoginTrigger
+#  GPSEnabledTrigger MusicPlayingTrigger DeviceUnlockedTrigger
+#  AutoRotateChangeTrigger ClipboardChangeTrigger BootTrigger
+#  IntentReceivedTrigger NotificationTrigger ScreenOnOffTrigger
+#  SilentModeTrigger WeatherTrigger GeofenceTrigger SunriseSunsetTrigger
+#  SensorsTrigger ActivityRecognitionTrigger ProximityTrigger
+#  ShakeDeviceTrigger FlipDeviceTrigger OrientationTrigger
+#  FloatingButtonTrigger ShortcutTrigger VolumeButtonTrigger
+#  MediaButtonPressedTrigger SwipeTrigger
+#  
+#  
+#  ## Action classes
+#  
+#  Action LocationAction ShareLocationAction ApplicationAction
+#  LaunchActivityAction KillBackgroundAppAction OpenWebPageAction CameraAction
+#  UploadPhotoAction TakePictureAction ConnectivityAction SetWifiAction
+#  SetBluetoothAction SetBluetoothAction SendIntentAction DateTimeAction
+#  SetAlarmClockAction StopWatchAction SayTimeAction DeviceAction
+#  AndroidShortcutsAction ClipboardAction PressBackAction SpeakTextAction
+#  UIInteractionAction VoiceSearchAction DeviceSettingsAction
+#  ExpandCollapseStatusBarAction LaunchHomeScreenAction CameraFlashLightAction
+#  VibrateAction SetAutoRotateAction DayDreamAction SetKeyboardAction
+#  SetKeyguardAction CarModeAction ChangeKeyboardAction SetWallpaperAction
+#  FileAction OpenFileAction LocationAction ForceLocationUpdateAction
+#  ShareLocationAction SetLocationUpdateRateAction LoggingAction
+#  AddCalendarEntryAction LogAction ClearLogAction MediaAction
+#  RecordMicrophoneAction PlaySoundAction MessagingAction SendEmailAction
+#  SendSMSAction UDPCommandAction NotificationsAction ClearNotificationsAction
+#  MessageDialogAction AllowLEDNotificationLightAction
+#  SetNotificationSoundAction SetNotificationSoundAction
+#  SetNotificationSoundAction NotificationAction ToastAction PhoneAction
+#  AnswerCallAction ClearCallLogAction OpenCallLogAction RejectCallAction
+#  MakeCallAction SetRingtoneAction ScreenAction SetBrightnessAction
+#  ForceScreenRotationAction ScreenOnAction DimScreenAction KeepAwakeAction
+#  SetScreenTimeoutAction VolumeAction SilentModeVibrateOffAction
+#  SetVibrateAction VolumeIncrementDecrementAction SpeakerPhoneAction
+#  SetVolumeAction
+#  
+#  
+#  ## Constraint classes
+#  
+#  Constraint TimeOfDayConstraint BatteryLevelConstraint
+#  BatterySaverStateConstraint BatteryTemperatureConstraint
+#  ExternalPowerConstraint BluetoothConstraint GPSEnabledConstraint
+#  LocationModeConstraint SignalOnOffConstraint WifiConstraint
+#  CellTowerConstraint IsRoamingConstraint DataOnOffConstraint
+#  WifiHotSpotConstraint CalendarConstraint DayOfWeekConstraint
+#  TimeOfDayConstraint DayOfMonthConstraint MonthOfYearConstraint
+#  SunsetSunriseConstraint AirplaneModeConstraint AutoRotateConstraint
+#  DeviceLockedConstraint RoamingOnOffConstraint TimeSinceBootConstraint
+#  AutoSyncConstraint NFCStateConstraint IsRootedConstraint VpnConstraint
+#  MacroEnabledConstraint ModeConstraint TriggerThatInvokedConstraint
+#  LastRunTimeConstraint HeadphonesConnectionConstraint MusicActiveConstraint
+#  NotificationPresentConstraint PriorityModeConstraint
+#  NotificationVolumeConstraint InCallConstraint PhoneRingingConstraint
+#  BrightnessConstraint VolumeConstraint SpeakerPhoneConstraint
+#  DarkThemeConstraint ScreenOnOffConstraint VolumeLevelConstraint
+#  FaceUpDownConstraint LightLevelConstraint DeviceOrientationConstraint
+#  ProximitySensorConstraint
+
+
+
+require 'yaml'
+require 'rowx'
 require 'uuid'
+#require 'glw'
+#require 'geozone'
+require 'subunit'
 require 'rxfhelper'
 require 'chronic_cron'
 
@@ -30,7 +140,55 @@ class TriggersNlp
       [TimerTrigger, {time: time, days: days}]
     end
 
+    # time.is? 'at 18:30pm on Mon or Tue'
+    get /^time.is\? ['"](?:at )?(\d+:\d+(?:[ap]m)?) (?:on )?(.*)['"]/i do |time, days|      
+      [TimerTrigger, {time: time, days: days.gsub(' or ',', ')}]
+    end
+    
+    get /^shake[ _]device\??$/i do 
+      [ShakeDeviceTrigger, {}]
+    end
+    
+    get /^Flip Device (.*)$/i do |motion|
+       facedown = motion =~ /Face Up (?:->|to) Face Down/i
+      [FlipDeviceTrigger, {face_down: facedown }]
+    end
+    
+    get /^flip_device_down\?$/i do
+      [FlipDeviceTrigger, {face_down: true }]
+    end
+
+    get /^flip_device_up\?$/i do
+      [FlipDeviceTrigger, {face_down: false }]
+    end        
+    
+    get /^Failed Login Attempt$/i do
+      [FailedLoginTrigger, {}]
+    end
+    
+    get /^failed_login?$/i do
+      [FailedLoginTrigger, {}]
+    end         
+
+    get /^Geofence (Entry|Exit) \(([^\)]+)/i do |direction, name|
+      enter_area = direction.downcase.to_sym == :entry
+      [GeofenceTrigger, {name: name, enter_area: enter_area}]
+    end     
+    
+    get /^location (entered|exited) \(([^\)]+)/i do |direction, name|
+      enter_area = direction.downcase.to_sym == :entered
+      [GeofenceTrigger, {name: name, enter_area: enter_area}]
+    end
+    
+    # eg. Proximity Sensor (Near)
+    #
+    get /^Proximity Sensor \(([^\)]+)\)/i do |distance|
+      
+      [ProximityTrigger, {distance: distance}]
+    end    
 
+    
+    
   end
 
   alias find_trigger run_route
@@ -50,13 +208,105 @@ class ActionsNlp
 
   def actions(params) 
 
+    # e.g. message popup: hello world!
     get /^message popup: (.*)/i do |msg|
       [ToastAction, {msg: msg}]
     end
 
-    get /^Popup Message ['"][^'"]+/i do |msg|
+    # e.g. Popup Message 'hello world!'
+    get /^Popup[ _]Message ['"]([^'"]+)/i do |msg|
       [ToastAction, {msg: msg}]
     end
+    
+    # e.g. say current time
+    get /^say current[ _]time/i do
+      [SayTimeAction, {}]
+    end    
+    
+    get /^Torch :?(.*)/i do |onoffstate|
+      state = onoffstate.downcase == 'on' ? 0 : 1
+      [CameraFlashLightAction, {state: state}]
+    end    
+    
+    get /^Take Picture/i do
+      [TakePictureAction, {}]
+    end
+    
+    get /^take_picture/i do
+      [TakePictureAction, {}]
+    end           
+        
+    # e.g. Display Notification: Hi there: This is the body of the message
+    get /^Display Notification: ([^:]+): [^$]+$/i do |subject, text|
+      [NotificationAction, {subject: subject, text: text}]
+    end           
+    
+    
+    # e.g. Enable Wifi
+    get /^(Enable|Disable) Wifi$/i do |raw_state|
+      
+      state = raw_state.downcase.to_sym == :enable ? 0 : 1
+      [SetWifiAction, {state: state}]
+      
+    end    
+    
+    # e.g. Play: Altair
+    get /^Play: (.*)$/i do |name|
+
+      [PlaySoundAction, {file_path: name}]
+      
+    end     
+    
+    # e.g. Launch Settings
+    get /^Launch (.*)$/i do |application|
+
+      h = {
+        application_name: application,
+        package_to_launch: 'com.android.' + application.downcase
+      }
+      [LaunchActivityAction, h]
+      
+    end
+    
+    # e.g. HTTP GET http://someurl.com/something
+    get /^HTTP GET ([^$]+)$/i do |url|
+
+      [OpenWebPageAction, url_to_open: url]
+      
+    end
+    
+    # e.g. webhook entered_kitchen
+    #
+    get /webhook|HTTP GET/i do
+      [OpenWebPageAction, {}]
+    end
+    
+    #a: Keep Device Awake Screen On Until Disabled
+    #
+    get /Keep Device Awake Screen On Until Disabled/i do
+      [KeepAwakeAction, {enabled: true, permanent: true, screen_option: 0}]
+    end
+    
+    
+    #a: Keep Device Awake Screen On 1h 1m 1s
+    #
+    get /Keep Device Awake Screen On ([^$]+)/i do |duration|
+      
+      a = duration.split.map(&:to_i)
+      secs = Subunit.new(units={minutes:60, hours:60, seconds: 60}, a).to_i
+      
+      h = {
+        permanent: true, screen_option: 0, seconds_to_stay_awake_for: secs
+      }
+      [KeepAwakeAction, h]
+    end
+    
+    #a: Disable Keep Awake
+    #
+    get /Disable Keep Awake/i do
+      [KeepAwakeAction, {enabled: false, screen_option: 0}]
+    end    
+
 
   end
 
@@ -145,11 +395,11 @@ class Macro
   using Params
 
   attr_reader :local_variables, :triggers, :actions, :constraints, :guid
-  attr_accessor :title
+  attr_accessor :title, :description
 
-  def initialize(name=nil, debug: false)
+  def initialize(name=nil, geofences: geofences, debug: false)
 
-    @title, @debug = name, debug
+    @title, @geofences, @debug = name, geofences, debug
     
     puts 'inside Macro#initialize' if @debug    
           
@@ -209,6 +459,7 @@ class Macro
     end
     
     @title = h[:name]
+    @description = h[:description]
     
     # fetch the local variables
     @local_variables = h['local_variables']
@@ -239,18 +490,20 @@ class Macro
   end
   
   def import_xml(node)
-    
+
     if @debug then
       puts 'inside Macro#import_xml'
       puts 'node: ' + node.xml.inspect
     end
     
-    @title = node.attributes[:name]
-
     if node.element('triggers') then
-      
+            
       # level 2
       
+      @title = node.attributes[:name]
+      @description = node.attributes[:description]
+      
+      
       # get all the triggers
       @triggers = node.xpath('triggers/*').map do |e|
         
@@ -286,6 +539,12 @@ class Macro
       
       # Level 1
       
+      puts 'import_xml: inside level 1' if @debug
+      
+      @title = node.text('macro') || node.attributes[:name]
+      
+      #@description = node.attributes[:description]      
+      
       tp = TriggersNlp.new      
       
       @triggers = node.xpath('trigger').map do |e|
@@ -295,7 +554,11 @@ class Macro
         puts 'found trigger ' + r.inspect if @debug
         
         if r then
-          r[0].new(r[1])
+          if r[0] == GeofenceTrigger then
+            GeofenceTrigger.new(r[1], geofences: @geofences)
+          else
+            r[0].new(r[1])
+          end
         end
         
       end
@@ -304,11 +567,21 @@ class Macro
       
       @actions = node.xpath('action').map do |e|
         
+        puts 'action e: ' + e.xml.inspect if @debug
         r = ap.find_action e.text
         puts 'found action ' + r.inspect if @debug
         
         if r then
-          r[0].new(r[1])
+          
+          a = e.xpath('item/*')
+          
+          h = if a.any? then
+            a.map {|node| [node.name.to_sym, node.text.to_s]}.to_h
+          else
+            {}
+          end
+          
+          r[0].new(r[1].merge(h))
         end
         
       end      
@@ -355,17 +628,64 @@ class Macro
     
   end
   
+  # invokes the actions
+  #
   def run()
     @actions.map(&:invoke)
-  end  
+  end
+  
+  # prepares the environment in order for triggers to test fire successfully
+  # Used for testing
+  #
+  def set_env()
+    @triggers.each(&:set_env)
+  end
+
+  def to_pc()
+    
+    heading = '# ' + @title
+    heading += '\n# ' + @description if @description
+    condition = @triggers.first.to_pc
+    actions = @actions.map(&:to_pc).join("\n")
+    
+<<EOF
+#{heading}
+
+if #{condition} then
+  #{actions}
+end
+EOF
+  end
     
   def to_s()
-    [
+    
+    a = [
       'm: ' + @title,
       @triggers.map {|x| "t: %s" % x}.join("\n"),
       @actions.map {|x| "a: %s" % x}.join("\n"),
       @constraints.map {|x| "a: %s" % x}.join("\n")
-    ].join("\n")
+    ]
+    
+    if @description and @description.length >= 1 then
+      a.insert(1, 'd: ' + @description)
+    end
+    
+    a.join("\n")
+    
+  end
+  
+  def to_summary()
+    
+    a = [
+      'm: ' + @title,
+      't: ' + @triggers.map(&:to_summary).join(", "),
+      'a: ' + @actions.map(&:to_summary).join(", "),
+    ]
+    
+    a <<  'c: ' + @constraints.map(&:to_summary).join(", ") if @constraints.any?
+    
+    a.join("\n") + "\n"
+    
   end
 
   private
@@ -378,34 +698,86 @@ class Macro
 
     puts ('inside object h:'  + h.inspect).debug if @debug
     klass = Object.const_get h[:class_type]
-    klass.new h
+    puts klass.inspect.highlight if $debug
+    
+    if klass == GeofenceTrigger then
+      puts 'GeofenceTrigger found'.highlight if $debug
+      GeofenceTrigger.new(h, geofences: @geofences)
+    else
+      klass.new h
+    end
+    
   end
 
 end
 
 
+class MacroDroidError < Exception
+end
+
 class MacroDroid
   using ColouredText
   using Params  
 
-  attr_reader :macros
+  attr_reader :macros, :geofences
 
   def initialize(obj=nil, debug: false)
 
     @debug = debug    
     
+    @geofences = {}
+    
     if obj then
       
-      s, _ = RXFHelper.read(obj)    
+      raw_s, _ = RXFHelper.read(obj)    
+      
+      s = raw_s.strip
       
       if s[0] == '{' then
+        
         import_json(s) 
+        
       elsif  s[0] == '<'
+        
         import_xml(s)
         @h = build_h
+        
       else
-        import_xml(text_to_xml(s))
+
+        puts 's: ' + s.inspect if @debug
+        
+        if s =~ /m(?:acro)?:\s/ then
+          
+          puts 'before RowX.new' if @debug
+
+          s2 = s.gsub(/^g:/,'geofence:').gsub(/^m:/,'macro:')\
+              .gsub(/^t:/,'trigger:').gsub(/^a:/,'action:')\
+              .gsub(/^c:/,'constraint:').gsub(/^#.*/,'')
+          
+          raw_macros, raw_geofences = s2.split(/(?=^macro:)/,2).reverse
+          
+          if raw_geofences then
+            
+            geoxml = RowX.new(raw_geofences).to_xml
+            
+            geodoc = Rexle.new(geoxml)  
+            geofences = geodoc.root.xpath('item/geofence')        
+            @geofences = fetch_geofences(geofences) if geofences.any?          
+            
+          end
+          
+          xml = RowX.new(raw_macros).to_xml
+          import_rowxml(xml)
+          
+        elsif s =~ /^# / 
+          xml = pc_to_xml(s)
+          import_xml(xml)
+        else
+          raise MacroDroidError, 'invalid input'
+        end
+        
         @h = build_h
+        
       end
       
     else
@@ -457,15 +829,94 @@ class MacroDroid
 
   alias to_json export_json
 
+
+  def to_h()
+
+    h = {
+      geofence_data: {
+        geofence_map: @geofences.map {|key, value| [key, value.to_h] }.to_h
+      },
+      macro_list:  @macros.map(&:to_h)
+    }
+    @h.merge(h).to_camel_case
+
+  end
+  
+  # returns pseudocode
+  #
+  def to_pc()
+    @macros.map(&:to_pc).join("\n\n")
+  end
+
+  def to_s()
+    
+    lines = []
+    
+    if @geofences.any? then
+      lines << @geofences.map {|_, value| 'g: ' + value.to_s}.join("\n\n") + "\n"
+    end
+    
+    lines << @macros.map(&:to_s).join("\n")
+    lines.join("\n")
+    
+  end
+  
+  def to_summary()
+    @macros.map(&:to_summary).join("\n")
+  end  
+  
+  private
+  
+  def fetch_geofences(nodes)
+    
+    nodes.map do |e|
+
+      name = e.text.to_s.strip
+      item = e.element('item')
+      coordinates = item.text('coordinates')
+      latitude, longitude = coordinates.split(/, */,2)
+      radius = item.text('radius') 
+      
+      id = UUID.new.generate
+
+      h = {
+        name: name, 
+        longitude: longitude, 
+        latitude: latitude, 
+        radius: radius, 
+        id: id
+      }
+      
+      [id.to_sym, GeofenceMap.new(h)]
+      
+    end.to_h
+
+  end
+  
   def import_json(s)
 
-    @h = JSON.parse(s, symbolize_names: true).to_snake_case
+    h = JSON.parse(s, symbolize_names: true)
+    puts 'json_to_yaml: ' + h.to_yaml if @debug
+    
+    @h = h.to_snake_case
     puts ('@h: ' + @h.inspect).debug if @debug
-
+    
+    
+    # fetch the geofence data
+    if @h[:geofence_data] then
+      
+      @geofences = @h[:geofence_data][:geofence_map].map do |id, properties|
+        [id, GeofenceMap.new(properties)]
+      end.to_h
+      
+    end
+    
     @macros = @h[:macro_list].map do |macro|
 
       puts ('macro: ' + macro.inspect).debug if @debug
-      m = Macro.new(debug: @debug)
+#       puts '@geofences: ' + @geofences.inspect if @debug
+      
+      m = Macro.new(geofences: @geofences.map(&:last), debug: @debug )
       m.import_h(macro)
       m
 
@@ -475,59 +926,99 @@ class MacroDroid
     
   end
   
+  def import_rowxml(raws)
+   
+    s = RXFHelper.read(raws).first
+    puts 's: ' + s.inspect if @debug
+    doc = Rexle.new(s)
+    puts 'after doc' if @debug    
+    puts 'import_rowxml: @geofences: ' + @geofences.inspect if @debug
+    geofences = @geofences
+    
+    @macros = doc.root.xpath('item').map do |node|
+      puts ('geofences: ' + geofences.inspect).highlight if @debug
+      Macro.new(geofences: geofences.map(&:last), debug: @debug).import_xml(node)
+      
+    end
+
+  end  
+  
   def import_xml(raws)
     
+    if @debug then
+      puts 'inside import_xml' 
+      
+      puts 'raws: ' + raws.inspect 
+    end
     s = RXFHelper.read(raws).first
     puts 's: ' + s.inspect if @debug
     doc = Rexle.new(s)
-    puts 'after doc' if @debug
     
+    if @debug then
+      puts 'doc: ' + doc.root.xml
+    end
+       
     @macros = doc.root.xpath('macro').map do |node|
           
-      macro = Macro.new @title, debug: @debug
-      macro.import_xml(node)
-      macro
+      Macro.new(geofences: @geofences.map(&:last), debug: @debug).import_xml(node)
       
     end
   end
   
-  def text_to_xml(s)
+  def pc_to_xml(s)
     
-    a = s.split(/.*(?=^m:)/); a.shift
-    a.map!(&:chomp)
-
-    macros = a.map do |x|
-
-      lines = x.lines
-      puts 'lines: ' + lines.inspect if @debug
-      
-      name = lines.shift[/^m: +(.*)/,1]
-      h = {t: [], a: [], c: []}
+    macros = s.strip.split(/(?=#)/).map do |raw_macro|
 
-      lines.each {|line| h[line[0].to_sym] << line[/^\w: +(.*)/,1] }
-      triggers = h[:t].map {|text| [:trigger, {}, text]}
-      actions = h[:a].map {|text| [:action, {}, text]}
-      constraints = h[:c].map {|text| [:constraint, {}, text]}
+      a = raw_macro.lines
+      name = a.shift[/(?<=# ).*/]
+      description = a.shift[/(?<=# ).*/] if a[0][/^# /]
+      body = a.join.strip
 
-      [:macro, {name: name},'', *triggers, *actions, *constraints]
+      a2 = body.lines
+      # get the trigger
+      trigger = [:trigger, {}, a2[0][/^if (.*) then/,1]]
+      action = [:action, {}, a2[1].strip]
+      [:macro, {name: name, description: description}, trigger, action, []]
 
     end
 
     doc = Rexle.new([:macros, {}, '', *macros])
     doc.root.xml pretty: true    
     
-  end
-
-  def to_h()
+  end  
 
-    @h.merge(macro_list:  @macros.map(&:to_h)).to_camel_case
+end
 
+class GeofenceMap
+  
+  attr_accessor :name, :longitude, :latitude, :radius, :id
+  
+  def initialize(id: '', longitude: '', latitude: '', name: '', radius: '')
+    
+    @id, @latitude, @longitude, @name, @radius = id, latitude, \
+        longitude, name, radius    
+    
   end
-
+  
+  def to_h()
+    
+    {
+      id: @id, 
+      longitude: @longitude, 
+      latitude: @latitude, 
+      name: @name, 
+      radius: @radius
+    }
+      
+  end
+  
   def to_s()
-    @macros.map(&:to_s).join("\n\n")
+    
+    coordinates = "%s, %s" % [@longitude, @latitude]
+    "%s\n  coordinates: %s\n  radius: %s" % [@name, coordinates, @radius]
+    
   end
-
+  
 end
 
 class MacroObject
@@ -538,6 +1029,8 @@ class MacroObject
 
   def initialize(h={})
     
+    $env ||= {}
+    
     @h = {constraint_list: [], is_or_condition: false, 
           is_disabled: false}.merge(h)
     @list = []
@@ -566,6 +1059,12 @@ class MacroObject
     h2.merge('m_classType' => self.class.to_s)
 
   end
+  
+  def to_s()
+    "#<%s %s>" % [self.class, @h.inspect]
+  end
+  
+  alias to_summary to_s
 
   protected
   
@@ -1080,29 +1579,26 @@ class TimerTrigger < Trigger
       use_alarm: false
     }
             
-    super(options.merge filter(options,h))
+    super(options.merge filter(options, h))
 
   end
   
   def match?(detail={time: $env[:time]}, model=nil)
-
-    a = @h[:days_of_week]
-    a.unshift a.pop
-
-    dow = a.map.with_index {|x, i| x ? i : nil }.compact.join(',')
-
-    s = "%s %s * * %s" % [@h[:minute], @h[:hour], dow]
-    
-    if $debug then
-      puts 's: ' + s.inspect 
-      puts 'detail: ' + detail.inspect
-      puts '@h: ' + @h.inspect
-    end
     
-    ChronicCron.new(s, detail[:time]).to_time == detail[:time]
+   time() == detail[:time]
 
   end
   
+  # sets the environmental conditions for this trigger to fire
+  #
+  def set_env()
+    $env[:time] = time()
+  end
+  
+  def to_pc()    
+    "time.is? '%s'" % self.to_s.gsub(',', ' or')
+  end
+  
   def to_s()
     
     dow = @h[:days_of_week]
@@ -1114,6 +1610,20 @@ class TimerTrigger < Trigger
     
     "at %s on %s" % [time, days.join(', ')]
   end
+  
+  private
+  
+  def time()
+    
+    a = @h[:days_of_week].clone
+    a.unshift a.pop
+
+    dow = a.map.with_index {|x, i| x ? i : nil }.compact.join(',')
+    s = "%s %s * * %s" % [@h[:minute], @h[:hour], dow]        
+    recent_time = ($env && $env[:time]) ? $env[:time] : Time.now
+    ChronicCron.new(s, recent_time).to_time
+    
+  end
 
 end
 
@@ -1185,6 +1695,15 @@ class RegularIntervalTrigger < Trigger
 
 end
 
+class DeviceEventsTrigger < Trigger
+  
+  def initialize(h={})
+    super(h)
+    @group = 'device_events'
+  end  
+  
+end
+
 # Category: Device Events
 #
 # Airplane Mode Changed
@@ -1196,7 +1715,7 @@ end
 # shorthand example:
 #   airplanemode: enabled
 #
-class AirplaneModeTrigger < Trigger
+class AirplaneModeTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1212,7 +1731,7 @@ end
 
 # Category: Device Events
 #
-class AutoSyncChangeTrigger < Trigger
+class AutoSyncChangeTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1228,7 +1747,7 @@ end
 
 # Category: Device Events
 #
-class DayDreamTrigger < Trigger
+class DayDreamTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1244,7 +1763,7 @@ end
 
 # Category: Device Events
 #
-class DockTrigger < Trigger
+class DockTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1260,7 +1779,30 @@ end
 
 # Category: Device Events
 #
-class GPSEnabledTrigger < Trigger
+class FailedLoginTrigger < DeviceEventsTrigger
+  
+  def initialize(h={})
+
+    options = {
+      num_failures: 1
+    }
+
+    super(options.merge h)
+
+  end
+  
+  def to_pc()
+    'failed_login?'
+  end
+
+  def to_s()
+    'Failed Login Attempt'
+  end
+end
+
+# Category: Device Events
+#
+class GPSEnabledTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1276,7 +1818,7 @@ end
 
 # Category: Device Events
 #
-class MusicPlayingTrigger < Trigger
+class MusicPlayingTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1293,7 +1835,7 @@ end
 
 # Category: Device Events
 #
-class DeviceUnlockedTrigger < Trigger
+class DeviceUnlockedTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1308,7 +1850,7 @@ end
 
 # Category: Device Events
 #
-class AutoRotateChangeTrigger < Trigger
+class AutoRotateChangeTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1324,7 +1866,7 @@ end
 
 # Category: Device Events
 #
-class ClipboardChangeTrigger < Trigger
+class ClipboardChangeTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1341,7 +1883,7 @@ end
 
 # Category: Device Events
 #
-class BootTrigger < Trigger
+class BootTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1356,7 +1898,7 @@ end
 
 # Category: Device Events
 #
-class IntentReceivedTrigger < Trigger
+class IntentReceivedTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1376,7 +1918,7 @@ end
 
 # Category: Device Events
 #
-class NotificationTrigger < Trigger
+class NotificationTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1402,7 +1944,7 @@ end
 
 # Category: Device Events
 #
-class ScreenOnOffTrigger < Trigger
+class ScreenOnOffTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1418,7 +1960,7 @@ end
 
 # Category: Device Events
 #
-class SilentModeTrigger < Trigger
+class SilentModeTrigger < DeviceEventsTrigger
 
   def initialize(h={})
 
@@ -1461,8 +2003,15 @@ end
 #
 class GeofenceTrigger < Trigger
 
-  def initialize(h={})
+  def initialize( h={}, geofences: {})
 
+    if h[:name] then
+      puts ('geofences2: ' + geofences.inspect)
+      found = geofences.find {|x| x.name.downcase == h[:name].downcase}
+      h[:geofence_id] = found.id if found
+      
+    end
+    
     options = {
       update_rate_text: '5 Minutes',
       geofence_id: '',
@@ -1471,9 +2020,28 @@ class GeofenceTrigger < Trigger
       enter_area: true
     }
 
-    super(options.merge h)
+    super(options.merge filter(options, h))
+    @geofences = geofences
 
   end
+  
+  def to_s()
+    
+    if $debug then
+      puts ' @geofences: ' + @geofences.inspect
+      puts '@h: ' + @h.inspect
+      puts '@h[:geofence_id]: ' + @h[:geofence_id].inspect
+    end
+    
+    direction = @h[:enter_area] ? 'Entry' : 'Exit'
+    
+    found = @geofences.find {|x| x.id == @h[:geofence_id]}
+    puts 'found: ' + found.inspect    if @debug 
+    label = found ? found.name : 'error: name not found'
+
+    "Geofence %s (%s)" % [direction, label]
+    
+  end
 
 end
 
@@ -1494,9 +2062,19 @@ class SunriseSunsetTrigger < Trigger
 
 end
 
+
+class SensorsTrigger < Trigger
+  
+  def initialize(h={})
+    super(h)
+    @group = 'sensors'
+  end
+  
+end
+
 # Category: Sensors
 #
-class ActivityRecognitionTrigger < Trigger
+class ActivityRecognitionTrigger < SensorsTrigger
 
   def initialize(h={})
 
@@ -1506,31 +2084,70 @@ class ActivityRecognitionTrigger < Trigger
     }
 
     super(options.merge h)
+    
+    @activity = ['In Vehicle', 'On Bicycle', 'Running', 'Walking', 'Still']    
 
   end
+  
+  def to_s()
+    activity = @activity[@h[:selected_index]]
+    'Activity - ' + activity
+  end
+  
+  def to_summary
+    
+    activity = @activity[@h[:selected_index]]
+    s = if activity.length > 10 then
+      activity[0..7] + '..'
+    else
+      activity
+    end
+    
+    'Activity - ' + s
+    
+  end
 
 end
 
 # Category: Sensors
 #
-class ProximityTrigger < Trigger
+class ProximityTrigger < SensorsTrigger
 
   def initialize(h={})
 
+    if h[:distance] then
+      
+      case h[:distance].to_sym
+      when :near
+        options[:near] = true
+      end
+    end
+    
     options = {
       near: true,
       selected_option: 0
     }
 
-    super(options.merge h)
+    super(options.merge filter(options,h))
 
   end
+  
+  def to_s()
+    
+    distance = if @h[:near] then
+      'Near'
+    else
+      'Far'
+    end
+    
+    "Proximity Sensor (%s)" % distance
+  end
 
 end
 
 # Category: Sensors
 #
-class ShakeDeviceTrigger < Trigger
+class ShakeDeviceTrigger < SensorsTrigger
 
   def initialize(h={})
 
@@ -1540,12 +2157,25 @@ class ShakeDeviceTrigger < Trigger
     super(options.merge h)
 
   end
+  
+  def to_pc()
+    'shake_device?'
+  end
+  
+  def to_s()
+    'Shake Device'
+  end
 
 end
 
 # Category: Sensors
 #
-class FlipDeviceTrigger < Trigger
+# options:
+#   Face Up -> Face Down
+#   Face Down -> Face Up
+#   Any -> Face Down
+#
+class FlipDeviceTrigger < SensorsTrigger
 
   def initialize(h={})
 
@@ -1557,13 +2187,23 @@ class FlipDeviceTrigger < Trigger
 
     super(options.merge h)
 
+  end  
+  
+  def to_pc()
+    @h[:face_down] ? 'flip_device_down?' : 'flip_device_up?'
   end
+  
+  def to_s()
+    
+    action = @h[:face_down] ? 'Face Up -> Face Down' : 'Face Down -> Face Up'
+    'Flip Device ' + action
+  end  
 
 end
 
 # Category: Sensors
 #
-class OrientationTrigger < Trigger
+class OrientationTrigger < SensorsTrigger
 
   def initialize(h={})
 
@@ -1745,6 +2385,10 @@ class LaunchActivityAction < ApplicationAction
     super(options.merge h)
 
   end
+  
+  def to_s()
+    'Launch ' + @h[:application_name]
+  end
 
 end
 
@@ -1770,6 +2414,8 @@ end
 class OpenWebPageAction < ApplicationAction
 
   def initialize(h={})
+    
+    h[:url_to_open] = h[:url] if h[:url]
 
     options = {
       variable_to_save_response: {:m_stringValue=>"", :m_name=>"", :m_decimalValue=>0.0, :isLocal=>true, :m_booleanValue=>false, :excludeFromLog=>false, :m_intValue=>0, :m_type=>2},
@@ -1779,9 +2425,13 @@ class OpenWebPageAction < ApplicationAction
       block_next_action: false
     }
 
-    super(options.merge h)
+    super(options.merge filter(options,h))
 
   end
+  
+  def to_s()
+    "HTTP GET\n  url: " + @h[:url_to_open]
+  end
 
 end
 
@@ -1829,6 +2479,15 @@ class TakePictureAction < CameraAction
     super(options.merge h)
 
   end
+  
+  def to_pc()
+    camera = @h[:use_front_camera] ? :front : :back
+    'take_photo :' + camera.to_s
+  end
+
+  def to_s()
+    'Take Picture'
+  end  
 
 end
 
@@ -1857,6 +2516,11 @@ class SetWifiAction < ConnectivityAction
     super(options.merge h)
 
   end
+  
+  def to_s()
+    action = @h[:state] == 0 ? 'Enable' : 'Disable'
+    action + ' Wifi'
+  end
 
 end
 
@@ -1987,6 +2651,20 @@ class SayTimeAction < DateTimeAction
     super(options.merge h)
 
   end
+  
+  def invoke()
+    time = ($env and $env[:time]) ? $env[:time] : Time.now
+    tformat = @h['12_hour'] ? "%-I:%M%P" : "%H:%M"
+    super(time.strftime(tformat))
+  end
+  
+  def to_pc()
+    'say current_time()'
+  end
+  
+  def to_s()
+    'Say Current Time'
+  end  
 
 end
 
@@ -2067,6 +2745,10 @@ class SpeakTextAction < DeviceAction
     super(options.merge h)
 
   end
+  
+  def to_s()
+    "Speak Text (%s)" % @h[:text_to_say]
+  end
 
 end
 
@@ -2158,6 +2840,14 @@ class CameraFlashLightAction < DeviceSettingsAction
 
   end
 
+  def to_pc()
+    'torch :on'
+  end
+  
+  def to_s()
+    'Torch On'
+  end  
+
 end
 
 # Category: Device Settings
@@ -2495,6 +3185,10 @@ class PlaySoundAction < MediaAction
     super(options.merge h)
 
   end
+  
+  def to_s()
+    'Play: ' + @h[:file_path]
+  end
 
 end
 
@@ -2699,6 +3393,9 @@ end
 class NotificationAction < NotificationsAction
 
   def initialize(h={})
+    
+    h[:notification_subject] = h[:subject] if h[:subject] 
+    h[:notification_text] = h[:text] if h[:text]
 
     options = {
       ringtone_name: 'Default',
@@ -2714,9 +3411,13 @@ class NotificationAction < NotificationsAction
       run_macro_when_pressed: false
     }
 
-    super(options.merge h)
+    super(options.merge filter(options, h))
 
   end
+  
+  def to_s()
+    'Display Notification: ' + "%s: %s" % [@h[:notification_subject], @h[:notification_text]]
+  end
 
 end
 
@@ -2750,6 +3451,10 @@ class ToastAction < NotificationsAction
     super(@h[:message_text])
   end
   
+  def to_pc()
+    "popup_message '%s'" % @h[:message_text]
+  end
+  
   def to_s()
     "Popup Message '%s'" % @h[:message_text]
   end
@@ -2945,6 +3650,10 @@ end
 
 # Category: Screen
 #
+# options:
+#   keep awake, screen on => enabled: true
+#   disable keep awake    => enabled: false
+#
 class KeepAwakeAction < ScreenAction
 
   def initialize(h={})
@@ -2959,7 +3668,30 @@ class KeepAwakeAction < ScreenAction
     super(options.merge h)
 
   end
-
+  
+  def to_s()
+    
+    screen = @h[:screen_option] == 0 ? 'Screen On' : 'Screen Off'
+    
+    if @h[:enabled] then
+    
+      whenx = if @h[:seconds_to_stay_awake_for] == 0 then
+    
+      'Until Disabled'
+      
+      else
+        scnds = @h[:seconds_to_stay_awake_for]
+        Subunit.new(units={minutes:60, hours:60}, seconds: scnds).strfunit("%x")
+      end
+      
+      'Keep Device Awake ' + screen + ' ' + whenx
+      
+    else
+      'Disable Keep Awake'
+    end
+    
+    
+  end
 end
 
 # Category: Screen
@@ -3489,6 +4221,18 @@ class AirplaneModeConstraint < Constraint
     end
     
   end
+  
+  def to_pc()
+    status = @h[:enabled] ? 'enabled?' : 'disabled?'
+    'airplane_mode.' + status
+  end
+  
+  def to_s()
+    
+    status = @h[:enabled] ? 'Enabled' : 'Disabled'
+    'Airplane Mode ' + status
+    
+  end
 
 end