| The following is the cucumber feature for testing Gooby functionality. The test is invoked with command: cucumber features/gooby.feature The matcher steps are implemented in ruby code. |
Feature: Using Gooby
In order to generate maps with Gooby
From data recorded on a Garmin GPS device, or the MotionX app on an iPhone
We get the raw GPS data recorded from the device
then parse the raw GPS data into a "gooby standard" CSV format
then generate Google HTML maps from the CSV files
then generate Google Earth KML maps from the same CSV files
then enjoy viewing the maps and seeing where we've been.
Scenario: Setup the environment and directories for the scenarios that follow
Given GOOBY_HOME is set to '/Users/cjoakim/projects/github/cjoakim/gooby2'
And an empty csv directory within GOOBY_HOME
And an empty out directory within GOOBY_HOME
And an empty tmp directory within GOOBY_HOME
And an empty splits directory within GOOBY_HOME
And file 'gooby_davidson1.kmz' does not exist within GOOBY_HOME
Scenario: Generate the Gooby help content
When rake task 'gooby:help' is executed
Then the output contains 126 lines, within a tolerance of 2
And the following lines are expected
And line: Gooby = Google APIs + Ruby. Copyright 2009 by Chris Joakim.
And line: Gooby is available under GNU General Public License (GPL) license.
And line: Version 2.0.0
And line: Directory Structure:
And line: {GOOBY_HOME} Your chosen directory on your computer in which to store Gooby files.
And line: You must set the "GOOBY_HOME" environment variable on your computer to this
And line: chosen directory name.
And line: {GOOBY_HOME}/config Contains configuration files in yaml format.
And line: File /config/gooby_config.yaml is the "base" configuration file, and is read first.
And line: This file typically remains unchanged after your intial edits to it. Be sure to
And line: set "gmap_key" to your Google Maps key, and "gmap_icon_url_base" to the URL on
And line: your site where the map icon images are located.
And line: You should create one "map-specific" yaml file for each map you wish to create.
And line: It "inherits" all entries from the base configuration file, gooby_config.yaml.
And line: So just specify the additions or overrides in your map-specific yaml files.
And line: This design allows you generate your various maps, without having to frequently
And line: reset the values the the base configuration file.
And line: {GOOBY_HOME}/csv Gooby places CSV data files in this directory. All Gooby parsers create a
And line: standard CSV format that you can use to generate either Google maps or Google Earth
And line: maps with.
And line: {GOOBY_HOME}/data You place data files from your desktop GPS software here.
And line: {GOOBY_HOME}/out Gooby places generated Google Map html files and Google Earth kml files here.
And line: {GOOBY_HOME}/out/images Standard set of images here which are used in the generated html & kml files.
And line: Add your own images here, or replace the existing ones, as necessary.
And line: {GOOBY_HOME}/samples Contains a set of sample files for your reference.
And line: {GOOBY_HOME}/splits Gooby places individual 'activity xml files' here, split-out from a large tcx file.
And line: {GOOBY_HOME}/tmp Temporary files.
And line: List of Gooby commands (in order of typical usage):
And line: rake # Default task; same as 'rake gooby:help'.
And line: rake gooby:help # Display Gooby usage instructions.
And line: rake gooby:extract_activities_from_tcx # Extract individual Activity xml files from a Garmin tcx file
And line: rake gooby:parse_activity_xml_to_csv # Parse an extracted Activity xml file to a corresponding csv file.
And line: rake gooby:parse_track_log_to_csv # Parse a GPS Track Log file a corresponding csv file.
And line: rake gooby:parse_gpx_to_csv # Parse a *.gpx file into a corresponding csv file.
And line: rake gooby:generate_google_map # Generate a Google Map from a csv file.
And line: rake gooby:generate_google_earth_map # Generate a Google Earth kml file from a csv file, with optional
And line: kmz file generation.
And line: Gooby Command Detail:
And line: command: rake gooby:help
And line: description: Displays help information for each Gooby command.
And line: command: rake gooby:extract_activities_from_tcx
And line: description: Splits the potentially huge Garmin Training Center tcx file into individual
And line: Activity xml files, and places these in the /splits directory. Each has a filename
And line: based on the starting date/time of the activity.
And line: parameters: tcx_file - The input file, created by exporting from Garmin Training Center.
And line: Defaults to 'data/current.tcx' in your GOOBY_HOME directory.
And line: command: rake gooby:parse_activity_xml_to_csv
And line: description: Parse an extracted Activity xml 'split' file to a corresponding csv file.
And line: example: rake gooby:parse_activity_xml_to_csv config_file=config/big_sur_marathon.yaml
And line: command: rake gooby:parse_gpx_to_csv
And line: description: Parse a *.gpx file into a corresponding csv file.
And line: example: rake gooby:parse_gpx_to_csv config_file=config/ballantyne.yaml
And line: command: rake gooby:parse_track_log_to_csv
And line: description: Parse an extracted 'GPS Tracks Log' file from MacGpsPro into csv format.
And line: note 2: It is strongly recommended that you manually copy the 'GPS Tracks Log' file
And line: from your MacGpsPro installation to the GOOBY_HOME/data directory, and rename it to
And line: 'gps_track_logs.txt', before running this command. Then manually edit out the lines
And line: not pertinent to the map you want to generate.
And line: note 3: I use MacGpsPro to read the GPS data from my Garmin eTrex Venture device, since the
And line: Garmin Training Center software does not support this device.
And line: example: rake gooby:parse_track_log_to_csv config_file=config/crowders_mtn_hike.yaml
And line: command: rake gooby:generate_google_map
And line: description: Generate a Google Map html file from a csv file.
And line: example: rake gooby:generate_google_map config_file=config/big_sur_marathon.yaml
And line: command: rake gooby:generate_google_earth_map
And line: description: Generate a Google Earth kml file from a csv file.
And line: note 2: Gooby will optionally create a kmz file for you. A kmz file is essentially a
And line: zip file, which contains your kml file(s), as well as any associated files such
And line: as images. Two parameters are required in your yaml config file for kmz generation:
And line: 'kmz_build' must be set to true, and 'kmz_build_command' must be the appropriate
And line: zip-creating command for your operating system and set of installed software.
And line: A Mac OS/X example command is: zip -r gooby_big_sur.kmz .
And line: example: rake gooby:generate_google_earth_map config_file=config/big_sur_marathon.yaml
And line: Your GOOBY_HOME directory is currently set to
And the output contains the expected lines
Scenario: Split a large TCX file exported from Garmin Training Center
Given we imported the data from our Garmin GPS device model 305 into Garmin Training Center
And exported the data from Garmin Training Center to a TCX file
And the TCX file is named 'data/current.tcx'
When rake task 'gooby:extract_activities_from_tcx' is executed
Then the splits directory contains at least 15 files matching name '2009'
And the splits directory contains at least 90 files matching name '2008'
And the splits directory contains at least 100 files matching name '2007'
And these activity xml files exist:
| file | lines |
| splits/2008_04_27_13_49_50_tcx.xml | 24560 |
| splits/2009_01_01_14_45_00_tcx.xml | 10630 |
Scenario: Parse an activity xml file to csv
Given the config file we use is 'config/big_sur_marathon.yaml'
When rake task 'gooby:parse_activity_xml_to_csv' is executed
Then the CSV file 'csv/2008_04_27_13_49_50_tcx.csv' is created
And the CSV file contains 2449 trackpoints
And the CSV file contains these trackpoints:
| seq | time | latitude | longitude | distance | elapsed | mph | pace |
| 1 | 2008-04-27T13:49:50Z | 36.247196 | -121.781665 | 0.0 | 0:00:00 | 0.00 | 0:00 |
| 1800 | 2008-04-27T15:50:22Z | 36.460703 | -121.924925 | 20.0004984569685 | 3:03:46 | 6.530 | 9:11.29 |
| 2449 | 2008-04-27T17:09:28Z | 36.538656 | -121.91085 | 26.3666472682879 | 4:05:34 | 6.442 | 9:18.81 |
Scenario: Parse a track log file to csv
Given the config file we use is 'config/crowders_mtn_hike.yaml'
When rake task 'gooby:parse_track_log_to_csv' is executed
Then the CSV file 'csv/crowders_mtn_hike.csv' is created
And the CSV file contains 1065 trackpoints
And the CSV file contains these trackpoints:
| seq | time | latitude | longitude | distance | elapsed | mph | pace |
| 1 | 2008-11-16T08:43:06Z | 35.21357 | -81.29359 | 0.0 | 0:00:00 | 0.00 | 0:00 |
| 1065 | 2008-11-16T14:46:11Z | 35.26834 | -81.25154 | 15.0878648193097 | 6:03:05 | 2.493 | 24:03.88 |
Scenario: Parse a gpx file to csv
Given the config file we use is 'config/ballantyne.yaml'
When rake task 'gooby:parse_gpx_to_csv' is executed
Then the CSV file 'csv/ballantyne.csv' is created
And the CSV file contains 27 trackpoints
And the CSV file contains these trackpoints:
| seq | time | latitude | longitude | distance | elapsed | mph | pace |
| 1 | 2009-05-14T22:08:50Z | 35.062748 | -80.85562 | 0.0 | 0:00:00 | 0.00 | 0:00 |
| 27 | 2009-05-14T22:10:43Z | 35.062613 | -80.855448 | 0.0783970446562321 | 0:01:53 | 2.498 | 24:01.38 |
Scenario: Generate a Big Sur Marathon Google map in html format
Given the config file we use is 'config/big_sur_marathon.yaml'
When rake task 'gooby:generate_google_map' is executed
Then the HTML file 'out/big_sur_marathon.html' is created
And the HTML file contains 2766 lines
And the following lines are expected
And line: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
And line: "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
And line: <html xmlns="http://www.w3.org/1999/xhtml">
And line: <head>
And line: <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
And line: <meta name="description" content="Google Map generated by Gooby version 2.0.0">
And line: <meta name="keywords" content="Google Map Generated by Gooby version 2.0.0">
And line: <title> Big Sur Marathon </title>
And line: <script src='http://maps.google.com/maps?file=api&v=2&key=ABQIAAAA
And line: <script type="text/javascript">
And line: //< |
||
Cucumber - Gooby Functional Tests