tofulcrum 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZWQ4YWFmZjc0MzJiZGZkMTkyODhlNTc4YjQxZTU2YmZjNDFkZThjMw==
+  data.tar.gz: !binary |-
+    Mzg3ODkxOTU3Yzg2MDYzZWYwZjMwOTVlYzI0NDY0YzhjYWNmODY2NA==
+SHA512:
+  metadata.gz: !binary |-
+    ZjBhNjc5OTdiMWRlNzVjMzU3NjBkNmRkMzlkNzJkMTUxYzAxNmU4NjVkYzFl
+    NmM0MjkwMWRlNTc2YmMyZDE1MjZhMDgyMTRkZDdiYzQ3OTAwMDAzZTM1YzRl
+    YzkxNzY5MThjOTVmMzk5YjBhZDc2YTZkNWRlYmUxMmNkYmFhZDA=
+  data.tar.gz: !binary |-
+    NjQwYjEwMGIzMTQ5MmYzZmRiOGE2YjRkNzUwNTU5NWVhMjA2NjI4MmYzZTZk
+    ZjQ0MjA5YjcxNjc5NTc5Y2E3MDcxMGZiY2E3N2E2ZGY1Yzc5MDg2YTBmODYx
+    ZDY3NjQ1YTdiODMxMWQ1NmI3YjViMDYyY2RkYmEzOTMxODdjMzc=

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Zac McCormick
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,16 @@
+# tofulcrum
+
+Import CSV data into an existing Fulcrum app from the command line.
+
+## Installation
+
+    $ gem install tofulcrum
+
+## Usage
+
+    $ tofulcrum import somefile.csv <form_id> <api_key>
+
+## Notes
+
+It will automatically map the column headers to the data names in the form. If any column is not found, it will fail. So your CSV
+must only contain columns with valid fields in the form. Right now this program only supports text fields and choice fields.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/tofulcrum

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'pathname'
+bin_file = Pathname.new(__FILE__).realpath
+
+$:.unshift File.expand_path("../../lib", bin_file)
+
+require 'tofulcrum'
+
+Tofulcrum::CLI.start(ARGV)

data/lib/tofulcrum.rb

@@ -0,0 +1,111 @@
+require "tofulcrum/version"
+require 'csv'
+require 'fulcrum'
+require 'thor'
+
+module Tofulcrum
+  class CLI < Thor
+    desc "import", "Import a CSV into a Fulcrum app"
+    def import(file, form_id, api_key, mapping=nil)
+
+      Fulcrum::Api.configure do |config|
+        config.uri = 'https://api.fulcrumapp.com/api/v2'
+        config.key = api_key
+      end
+
+      row_index = 0
+
+      lat_index = nil
+      lon_index = nil
+      column_mapping = []
+
+      CSV.foreach(file) do |row|
+        is_header = row_index == 0
+
+        if is_header
+          lat_index, lon_index = *find_geo_columns(row).compact
+          raise 'Unable to find latitude/longitude columns' unless lat_index && lon_index
+
+          lat_name = row[lat_index]
+          lon_name = row[lon_index]
+
+          headers = row.clone
+          headers.delete_if {|v| [lat_name, lon_name].include?(v.downcase)}
+
+          column_mapping = find_mapping_columns(form_id, headers, row, mapping)
+        else
+
+          form_values = {}
+
+          column_mapping.each do |map|
+            value = nil
+
+            case map[:field]['type']
+            when 'ChoiceField'
+              value = { choice_values: row[map[:index]].split(',') }
+            else
+              value = row[map[:index]]
+            end
+
+            form_values[map[:field]['key']] = value
+          end
+
+          record = {
+            record: {
+              form_id: form_id,
+              latitude: row[lat_index].to_f,
+              longitude: row[lon_index].to_f,
+              form_values: form_values
+            }
+          }
+
+          Fulcrum::Record.create(record)
+        end
+
+        row_index += 1
+
+        print "#{row_index.to_s.rjust(10, ' ')} records uploaded\r"
+      end
+    end
+
+    no_tasks do
+      def flatten_elements(elements)
+        [].tap do |all|
+          elements.each do |element|
+            all << element
+            all += flatten_elements(element['elements']) if element['elements']
+          end
+        end
+      end
+
+      def find_mapping_columns(form_id, headers, full_row, mapping)
+        form = Fulcrum::Form.find(form_id, {})['form']
+
+        elements = flatten_elements(form['elements'])
+
+        if mapping.nil?
+          mapping = headers.map {|h| "#{h}=#{h}"}.join(',')
+        end
+
+        [].tap do |map|
+          mapping.split(',').each do |pair|
+            source, dest = *pair.split('=').map(&:strip)
+
+            source_index = full_row.index {|h| h.downcase == source.downcase} rescue nil
+            dest_field = elements.find {|e| e['data_name'].downcase == dest.downcase} rescue nil
+
+            raise "Unable to map column #{source} to form field #{dest}." unless source_index && dest_field
+
+            map << { index: source_index, field: dest_field }
+          end
+        end
+      end
+
+      def find_geo_columns(headers)
+        lat_columns = ['lat', 'latitude', 'y']
+        lon_columns = ['lon', 'long', 'longitude', 'x']
+        [headers.index {|h| lat_columns.include?(h.downcase)}, headers.index {|h| lon_columns.include?(h.downcase)}]
+      end
+    end
+  end
+end

data/lib/tofulcrum/version.rb

@@ -0,0 +1,3 @@
+module Tofulcrum
+  VERSION = "0.0.1"
+end

data/tofulcrum.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tofulcrum/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "tofulcrum"
+  spec.version       = Tofulcrum::VERSION
+  spec.authors       = ["Zac McCormick"]
+  spec.email         = ["zac.mccormick@gmail.com"]
+  spec.description   = %q{Convert data to Fulcrum}
+  spec.summary       = %q{Import data into Fulcrum from a CSV}
+  spec.homepage      = "https://github.com/zhm/tofulcrum"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "thor"
+  spec.add_dependency "fulcrum"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: tofulcrum
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Zac McCormick
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fulcrum
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Convert data to Fulcrum
+email:
+- zac.mccormick@gmail.com
+executables:
+- tofulcrum
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/tofulcrum
+- lib/tofulcrum.rb
+- lib/tofulcrum/version.rb
+- tofulcrum.gemspec
+homepage: https://github.com/zhm/tofulcrum
+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.1.5
+signing_key: 
+specification_version: 4
+summary: Import data into Fulcrum from a CSV
+test_files: []
+has_rdoc: