warpaint 0.0.1

data/spec/warpaint_cli_spec.rb

@@ -0,0 +1,64 @@
+require "warpaint/cli"
+
+describe Warpaint::CLI do
+  before (:each) do
+    @args = ARGV.dup
+  end
+
+  # used to silence warnings when we redefine ARGV
+  module Kernel
+    def silence_warnings
+      original_verbosity = $VERBOSE
+      $VERBOSE = nil
+      result = yield
+      $VERBOSE = original_verbosity
+      return result
+    end
+  end
+
+  it "should optionally write to an output file (with '-o path')" do
+    Kernel.silence_warnings do
+      ARGV = [ '-o', 'output.kml' ]
+    end
+
+    cli = Warpaint::CLI.new
+    cli.parse_options
+    cli.config[:output_file].should == 'output.kml'
+  end
+  
+  it "should optionally display usage info (with '-h or --help')" do
+    Kernel.silence_warnings do
+      ARGV = [ '-h' ]
+    end
+
+    cli = Warpaint::CLI.new
+
+    stdout = $stdout
+    trapped_output = StringIO.new
+    $stdout = trapped_output
+
+    lambda { cli.parse_options }.should raise_error SystemExit
+    trapped_output.string.should match /-o, --out OUTPUT\s+The output file \(\.KML\) to write/
+    trapped_output.string.should match /-h, --help\s+Show this message/
+    trapped_output.string.should match /-n NETXML_TIME_ADJUSTMENT,\s+Adjust the timestamps in NetXML file by seconds \(can be negative\)/
+    trapped_output.string.should match /-g, --gtime GPX_TIME_ADJUSTMENT\s+Adjust the timestamps in GPX file by seconds \(can be negative\)/
+
+    $stdout = stdout
+  end
+  
+  it "should optionally allow specification of time adjustment for network entries" do
+    Kernel.silence_warnings do
+      ARGV = [ '--ntime', '3600' ]
+    end
+
+    cli = Warpaint::CLI.new
+    cli.parse_options
+    cli.config[:adjust_netxml_time].should == "3600"
+  end
+  
+  after(:each) do
+    Kernel.silence_warnings do
+      ARGV = @args
+    end
+  end
+end

data/spec/warpaint_gpx_spec.rb

@@ -0,0 +1,15 @@
+require "warpaint/gpx"
+
+describe Warpaint::GPX do
+  it "should parse a GPS eXchange Format (.GPX) file into a given data stucture" do
+    parser = Warpaint::GPX.new('spec/data/2011-11-23 21-06-20.gpx')
+    struct = double()
+
+    struct.should_receive(:add_track_point).with(:time => Time.parse("2011-11-23T20:54:29Z"), :lat =>"38.97123336791992", :lon => "-92.31622314453125")
+    struct.should_receive(:add_track_point).with(:time => Time.parse("2011-11-23T20:54:30Z"), :lat =>"38.971229553222656", :lon => "-92.31639099121094")
+    struct.should_receive(:add_track_point).with(:time => Time.parse("2011-11-23T20:54:31Z"), :lat =>"38.971229553222656", :lon => "-92.31654357910156")
+    struct.stub!(:add_track_point)
+
+    parser.parse_into(struct)
+  end
+end

data/spec/warpaint_network_collection_spec.rb

@@ -0,0 +1,21 @@
+require "warpaint/network_collection"
+
+describe Warpaint::NetworkCollection do
+  it "should maintain sort order of networks by time (earliest first)" do
+    nc = Warpaint::NetworkCollection.new
+    
+    nc.add_wireless_network(:last_time => Time.parse("Thu Nov 24 02:58:59 2011"), :essid => "HackShack", :encryption => "None")
+    nc.add_wireless_network(:last_time => Time.parse("Thu Nov 24 02:50:00 2011"), :essid => "Thunderdome", :encryption => "None")
+    nc.add_wireless_network(:last_time => Time.parse("Thu Nov 24 02:07:45 2011"), :essid => "NewHackCity", :encryption => "None")
+
+    nc.first.should == [Time.parse("Thu Nov 24 02:07:45 2011"), { :essid => "NewHackCity", :encryption => "None" }]
+    nc.last.should == [Time.parse("Thu Nov 24 02:58:59 2011"), { :essid => "HackShack", :encryption => "None" }]
+  end
+  
+  it "should optionally allow time adjustment in constructor" do
+    nc = Warpaint::NetworkCollection.new(3600)
+    time = Time.now
+    nc.add_wireless_network(:last_time => time, :essid => "HackShack", :encryption => "None")
+    nc.first.should == [time+3600, { :essid => "HackShack", :encryption => "None" }]
+  end
+end

data/spec/warpaint_netxml_spec.rb

@@ -0,0 +1,14 @@
+require "warpaint/netxml"
+
+describe Warpaint::NetXML do
+  it "should parse a Kismet log (.NetXML) file into a given data stucture" do
+    parser = Warpaint::NetXML.new('spec/data/Kismet-20111124-01-56-22-1.netxml')
+    struct = double()
+    
+    struct.should_receive(:add_wireless_network).with(:last_time => Time.parse("Thu Nov 24 02:58:59 2011"), :essid => "HackShack", :encryption => "None")
+    struct.should_receive(:add_wireless_network).with(:last_time => Time.parse("Thu Nov 24 02:50:00 2011"), :essid => "Thunderdome", :encryption => "None")
+    struct.should_receive(:add_wireless_network).with(:last_time => Time.parse("Thu Nov 24 02:07:45 2011"), :essid => "NewHackCity", :encryption => "None")
+
+    parser.parse_into(struct)
+  end
+end

data/spec/warpaint_ordered_collection_spec.rb

@@ -0,0 +1,16 @@
+require "warpaint/ordered_collection"
+require "time"
+
+describe Warpaint::OrderedCollection do
+  it "should return the key-value pair closest to the given key" do
+    oc = Warpaint::OrderedCollection.new
+
+    oc[Time.parse("2011-11-23T20:30:00Z")] = :first
+    oc[Time.parse("2011-11-23T20:45:00Z")] = :second
+    oc[Time.parse("2011-11-23T21:00:00Z")] = :last
+    
+    oc.closest_to(Time.parse("2011-11-23T20:00:00Z")).should == [Time.parse("2011-11-23T20:30:00Z"), :first]
+    oc.closest_to(Time.parse("2011-11-23T20:37:29Z")).should == [Time.parse("2011-11-23T20:30:00Z"), :first]
+    oc.closest_to(Time.parse("2011-11-23T20:37:31Z")).should == [Time.parse("2011-11-23T20:45:00Z"), :second]
+  end
+end

data/spec/warpaint_parser_spec.rb

@@ -0,0 +1,15 @@
+require "warpaint/parser"
+
+describe Warpaint::Parser do
+  DUMMY_INPUT_FILE = "dummy_input.netxml"
+
+  it "should take a path for an input file in its constructor" do
+    input_file = File.open(DUMMY_INPUT_FILE, "w+") { |f| f.write "test" }
+    lambda { Warpaint::Parser.new(DUMMY_INPUT_FILE) }.should_not raise_error
+    File.delete DUMMY_INPUT_FILE
+  end
+  
+  it "should raise an error if no valid file is given" do
+    lambda { Warpaint::Parser.new(DUMMY_INPUT_FILE) }.should raise_error "File not found: dummy_input.netxml"
+  end
+end

data/spec/warpaint_point_collection_spec.rb

@@ -0,0 +1,21 @@
+require "warpaint/point_collection"
+
+describe Warpaint::PointCollection do
+  it "should maintain sort order of track points by time (earliest first)" do
+    pc = Warpaint::PointCollection.new
+    
+    pc.add_track_point(:time => Time.parse("2011-11-23T20:54:29Z"), :lat =>"38.97123336791992", :lon => "-92.31622314453125")
+    pc.add_track_point(:time => Time.parse("2011-11-23T20:54:31Z"), :lat =>"38.971229553222656", :lon => "-92.31654357910156")
+    pc.add_track_point(:time => Time.parse("2011-11-23T20:54:30Z"), :lat =>"38.971229553222656", :lon => "-92.31639099121094")
+
+    pc.first.should == [Time.parse("2011-11-23T20:54:29Z"), { :lat =>"38.97123336791992", :lon => "-92.31622314453125" }]
+    pc.last.should == [Time.parse("2011-11-23T20:54:31Z"), { :lat =>"38.971229553222656", :lon => "-92.31654357910156" }]
+  end
+
+  it "should optionally allow time adjustment in constructor" do
+    pc = Warpaint::PointCollection.new(3600)
+    time = Time.now
+    pc.add_track_point(:time => time, :lat =>"38.97123336791992", :lon => "-92.31622314453125")
+    pc.first.should == [time+3600, { :lat =>"38.97123336791992", :lon => "-92.31622314453125" }]
+  end
+end

data/spec/warpaint_renderer_spec.rb

@@ -0,0 +1,26 @@
+require "warpaint/renderer"
+
+describe Warpaint::Renderer do
+  it "should integrate a collection of networks with a collection of track points and render a KML Placemark for each" do
+    t1 = Time.parse("Thu Nov 24 02:58:59 2011")
+    t2 = Time.parse("Thu Nov 24 02:50:00 2011")
+    t3 = Time.parse("Thu Nov 24 02:07:45 2011")
+
+    networks = double()
+    networks.should_receive(:each).once.and_yield(t1, { :essid => "HackShack", :encryption => "None" }).
+                                        and_yield(t2, { :essid => "Thunderdome", :encryption => "None" }).
+                                        and_yield(t3, { :essid => "NewHackCity", :encryption => "None" })
+
+    track_points = double()
+    track_points.should_receive(:closest_to).with(t1).and_return([Time.parse("2011-11-23T20:54:29Z"), { :lat =>"38.97123336791992", :lon => "-92.31622314453125" }])
+    track_points.should_receive(:closest_to).with(t2).and_return([Time.parse("2011-11-23T20:54:31Z"), { :lat =>"38.971229553222656", :lon => "-92.31654357910156" }])
+    track_points.should_receive(:closest_to).with(t3).and_return([Time.parse("2011-11-23T20:54:30Z"), { :lat =>"38.971229553222656", :lon => "-92.31639099121094" }])
+
+
+    renderer = Warpaint::Renderer.new(networks, track_points)
+    buf = StringIO.new
+    renderer.render_to(buf)
+
+#    buf.string.should match //
+  end
+end

data/warpaint.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "warpaint/version"
+
+Gem::Specification.new do |s|
+  s.name        = "warpaint"
+  s.version     = Warpaint::VERSION
+  s.authors     = ["Robert Boyd"]
+  s.email       = ["robert.boyd@me.com"]
+  s.homepage    = "http://github.com/rboyd"
+  s.summary     = "Kismet + phone GPS = wardrive maps"
+  s.description = "Warpaint is a library and command-line utility for integrating GPS Exchange Format (GPX) files with Kismet logs (NetXML) to produce Google Earth (KML) output."
+
+  s.rubyforge_project = "warpaint"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rake"
+
+  s.add_runtime_dependency "nokogiri"
+  s.add_runtime_dependency "builder"
+  s.add_runtime_dependency "schleyfox-ruby_kml"
+  s.add_runtime_dependency "kamel"
+  s.add_runtime_dependency "mixlib-cli"
+  s.add_runtime_dependency "rbtree"
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification
+name: warpaint
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Robert Boyd
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70313677944520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70313677944520
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70313677943760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70313677943760
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &70313677922960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70313677922960
+- !ruby/object:Gem::Dependency
+  name: builder
+  requirement: &70313677922240 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70313677922240
+- !ruby/object:Gem::Dependency
+  name: schleyfox-ruby_kml
+  requirement: &70313677921520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70313677921520
+- !ruby/object:Gem::Dependency
+  name: kamel
+  requirement: &70313677920800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70313677920800
+- !ruby/object:Gem::Dependency
+  name: mixlib-cli
+  requirement: &70313677919540 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70313677919540
+- !ruby/object:Gem::Dependency
+  name: rbtree
+  requirement: &70313677917780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70313677917780
+description: Warpaint is a library and command-line utility for integrating GPS Exchange
+  Format (GPX) files with Kismet logs (NetXML) to produce Google Earth (KML) output.
+email:
+- robert.boyd@me.com
+executables:
+- warpaint
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- bin/warpaint
+- lib/warpaint.rb
+- lib/warpaint/cli.rb
+- lib/warpaint/gpx.rb
+- lib/warpaint/network_collection.rb
+- lib/warpaint/netxml.rb
+- lib/warpaint/ordered_collection.rb
+- lib/warpaint/parser.rb
+- lib/warpaint/point_collection.rb
+- lib/warpaint/renderer.rb
+- lib/warpaint/version.rb
+- spec/data/2011-11-23 21-06-20.gpx
+- spec/data/Kismet-20111124-01-56-22-1.netxml
+- spec/warpaint_cli_spec.rb
+- spec/warpaint_gpx_spec.rb
+- spec/warpaint_network_collection_spec.rb
+- spec/warpaint_netxml_spec.rb
+- spec/warpaint_ordered_collection_spec.rb
+- spec/warpaint_parser_spec.rb
+- spec/warpaint_point_collection_spec.rb
+- spec/warpaint_renderer_spec.rb
+- warpaint.gemspec
+homepage: http://github.com/rboyd
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3677766930814124799
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3677766930814124799
+requirements: []
+rubyforge_project: warpaint
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Kismet + phone GPS = wardrive maps
+test_files:
+- spec/data/2011-11-23 21-06-20.gpx
+- spec/data/Kismet-20111124-01-56-22-1.netxml
+- spec/warpaint_cli_spec.rb
+- spec/warpaint_gpx_spec.rb
+- spec/warpaint_network_collection_spec.rb
+- spec/warpaint_netxml_spec.rb
+- spec/warpaint_ordered_collection_spec.rb
+- spec/warpaint_parser_spec.rb
+- spec/warpaint_point_collection_spec.rb
+- spec/warpaint_renderer_spec.rb