motion-concierge 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b738d849121e554e915fc5e5d6adb4e3ee4b0fb9
+  data.tar.gz: 0a40da8bfc156eec878d0cf5457f04f68ccabf98
+SHA512:
+  metadata.gz: 5a67521c2cdb83d0e5c3ab5376dde515ffb2ade39114a97886b7d25bfb7e469eaeabaf0947d629afaf487e37d866537e4472069ead22d984648d6ca37559753a
+  data.tar.gz: 572585c2295fac564b6c60f7290ae5913e04a7b9ee9a9b565c8dbf12d0dee23c15e9c4122f20ece825bf26de3e8facf8ef28a31ce87b6b97652f97773a8b292c

data/README.md

@@ -0,0 +1,78 @@
+# motion-concierge
+
+[![Build Status](https://travis-ci.org/OTGApps/motion-concierge.svg)](https://travis-ci.org/OTGApps/motion-concierge)
+
+motion-concierge is your personal data concierge! Just provide a file name, and network url, and set up some basic rules regarding when to download the data and the concierge will automatically fetch your data for you from the web!
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'motion-concierge'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install motion-concierge
+
+After installing, you'll need to install the needed pods:
+
+    $ [bundle exec] rake pod:install
+
+## Usage
+
+```ruby
+# You configure motion-concierge when the app first launches:
+def application(application, didFinishLaunchingWithOptions:launchOptions)
+    # Something here
+
+    # Set up motion-concierge
+    MotionConcierge.local_file_name = 'my_data_file.json'
+    MotionConcierge.remote_file_url = 'http://whatever.com/my_data_file.json'
+    MotionConcierge.fetch_interval = 86400 # Once a day
+    # You can put it in debug mode too!
+    MotionConcierge.debug = true
+    MotionConcierge.debug_fetch_interval = 30 # Every 30 seconds
+
+
+    # Something else here
+end
+
+# Then make sure to check for the data each time the app is launched
+def applicationDidBecomeActive(application)
+    # Check for new data is necessary
+    MotionConcierge.fetch
+end
+
+```
+
+That's it! From now on, every day (86400 seconds) when the app is launched, or comes back into the foreground, motion-concierge will check to see if it should download new data and then fire off a notification once it's recieved the data and saved it to disk so that you can listen for the event and refresh your interface as necessary.
+
+Here's how you'd listen for the event:
+
+```ruby
+def listen_for_new_data
+    NSNotificationCenter.defaultCenter.addObserver(self, selector:"reload_data", name:"MotionConciergeNewDataReceived", object:nil)
+end
+
+def reload_data(notification)
+    puts "Got new data!"
+end
+```
+
+You can use the local file easily!
+```ruby
+puts 'The file is located here: ' + MotionConcierge.local_file_path
+puts 'The file contents are: ' + MotionConcierge.local_file_string
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/lib/motion-concierge.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+require 'motion-cocoapods'
+require 'afmotion'
+
+lib_dir_path = File.dirname(File.expand_path(__FILE__))
+Motion::Project::App.setup do |app|
+  app.files.unshift(Dir.glob(File.join(lib_dir_path, "project/**/*.rb")))
+end

data/lib/project/motion-concierge.rb

@@ -0,0 +1,108 @@
+class MotionConcierge
+  class << self
+
+    def local_file_name=(file_name)
+      @_local_file_name = file_name
+    end
+
+    def local_file_name
+      @_local_file_name || @_remote_file_url.split("/").last
+    end
+
+    def remote_file_url=(url)
+      @_remote_file_url = url
+    end
+
+    def remote_file_url
+      @_remote_file_url
+    end
+
+    def fetch_interval=(interval)
+      @_fetch_interval = interval
+    end
+
+    def fetch_interval
+      @_fetch_interval || 86400
+    end
+
+    def debug_fetch_interval=(interval)
+      @_debug_fetch_interval = interval
+    end
+
+    def debug_fetch_interval
+      @_debug_fetch_interval || 30
+    end
+
+    def local_file_path
+      local_file_name.document_path
+    end
+
+    def local_file_string
+      NSString.stringWithContentsOfFile(local_file_path)
+    end
+
+    def downloaded_file_exists?
+      local_file_path.file_exists?
+    end
+
+    def check_interval
+      debug? ? debug_fetch_interval : fetch_interval
+    end
+
+    def time_offset
+      Time.now.to_i - check_interval
+    end
+
+    def should_fetch?
+      last_fetch < time_offset
+    end
+
+    def fetch
+      if debug?
+        puts "Fetching data from: #{@_remote_file_url}"
+        puts " Saving it to: #{local_file_name}"
+        puts " Every #{check_interval} seconds"
+      end
+
+      if should_fetch?
+        puts "Data is #{time_offset} seconds old.\nDownloading new data file." if debug?
+        AFMotion::HTTP.get(@_remote_file_url) do |result|
+          if result.success?
+            puts 'Got successful result from server.' if debug?
+            result.object.write_to(local_file_path)
+            last_fetch = Time.now.to_i
+            NSNotificationCenter.defaultCenter.postNotificationName("MotionConciergeNewDataReceived", object:self)
+          else
+            if debug?
+              puts "There was an error downloading the data from the server:"
+              puts result.error.localizedDescription
+            end
+          end
+        end
+      else
+        puts "Data is not stale. Not fetching." if debug?
+      end
+    end
+
+    def last_fetch=(last)
+      NSUserDefaults.standardUserDefaults.tap do |defaults|
+        defaults.setInteger(last, forKey:"motion_concierge_last_data_check")
+        defaults.synchronize
+      end
+    end
+
+    def last_fetch
+      NSUserDefaults.standardUserDefaults.integerForKey("motion_concierge_last_data_check") || 0
+    end
+
+    # Debugging
+
+    def debug=(debug)
+      @_debug = !!debug
+    end
+
+    def debug?
+      @_debug || false
+    end
+  end
+end

data/lib/project/ns_data.rb

@@ -0,0 +1,31 @@
+# Shamelessly extracted from sugarcube
+# https://github.com/rubymotion/sugarcube/blob/master/lib/cocoa/sugarcube-files/nsdata.rb
+class NSData
+
+  class << self
+
+    def read_from(path_or_url)
+      case path_or_url
+      when NSURL
+        self.dataWithContentsOfURL(path_or_url)
+      when NSString
+        self.dataWithContentsOfFile(path_or_url)
+      else
+        false
+      end
+    end
+
+  end
+
+  def write_to(path_or_url, atomically=true)
+    case path_or_url
+    when NSURL
+      self.writeToURL(path_or_url, atomically: atomically)
+    when NSString
+      self.writeToFile(path_or_url, atomically: atomically)
+    else
+      false
+    end
+  end
+
+end

data/lib/project/ns_string.rb

@@ -0,0 +1,35 @@
+# Shamelessly extracted from sugarcube
+# https://github.com/rubymotion/sugarcube/blob/master/lib/cocoa/sugarcube-files/nsstring.rb
+class NSString
+
+  def document_path
+    @@motionconcierge_docs ||= NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true)[0]
+    return self if self.hasPrefix(@@motionconcierge_docs)
+
+    @@motionconcierge_docs.stringByAppendingPathComponent(self)
+  end
+
+  def resource_path
+    @@motionconcierge_resources ||= NSBundle.mainBundle.resourcePath
+    return self if self.hasPrefix(@@motionconcierge_resources)
+
+    @@motionconcierge_resources.stringByAppendingPathComponent(self)
+  end
+
+  def file_exists?
+    path = self.hasPrefix('/') ? self : self.document_path
+    NSFileManager.defaultManager.fileExistsAtPath(path)
+  end
+
+  def remove_file!
+    ptr = Pointer.new(:id)
+    path = self.hasPrefix('/') ? self : self.document_path
+    NSFileManager.defaultManager.removeItemAtPath(path, error:ptr)
+    ptr[0]
+  end
+
+  def resource_exists?
+    self.resource_path.file_exists?
+  end
+
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: motion-concierge
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mark Rickert
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: motion-cocoapods
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: afmotion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: motion_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: motion-concierge is your personal data concierge!. Just provide a file
+  name, and network url, and set up some basic rules regarding when to download the
+  data and the concierge will automatically fetch your data for you from the web!
+email:
+- mjar81@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/motion-concierge.rb
+- lib/project/motion-concierge.rb
+- lib/project/ns_data.rb
+- lib/project/ns_string.rb
+homepage: https://github.com/OTGApps/motion-concierge
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: motion-concierge is your personal data concierge!
+test_files: []