columbus3 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 20d8bb20cc305bf99ef9859d3b01835079b058c3fe9a16cc02c1a51a0f95d68f
-  data.tar.gz: c267002099bf400d4a6391c2e5a1442af09293b356875bb622b0346ad66b9b15
+SHA1:
+  metadata.gz: 7cc5864ef1e5f14f52939520fa0a1bc7e2506a45
+  data.tar.gz: b95abe7c54af522d1a747e25d1dd647585fa5e22
 SHA512:
-  metadata.gz: bf0a4000b8f5a97700dca556efc87ecb5096474b89eee17fb8222e6996488f5d050eda691101ab17c494a779d937365273d4930b5bb872497297dbd31957fff0
-  data.tar.gz: b5b65c76736b6b83d0350f33b0a5988ade2a186f84dc49d24b4c159d306403c865c9f22893e43e069106b20f145b8602402965d72c114a9d646584d5d6c9f087
+  metadata.gz: 96aa4ef40cd7bd9cdf16764839cf9fc38c00494ae698bf7242aa0cb808983b25d2cbf05f1c903a56c2773d6e708f3256313d9750cc78348e20a727d925e6f1df
+  data.tar.gz: 54db9fe50f38f4e405b9fd94c1dbba2655d57509dd6d0422ae1be196753ad2a094f6a1ca496eac0e225d90ddfc03e566d4003a4505894891d42ad4c3144aa798

data/README.md

@@ -1,18 +1,22 @@
 Columbus3
 =========
 
-A gem to manage GPS tracks generated by the Columbus V900 and V990 GPS trackers.
+A ruby gem to show, organize, and search GPS tracks generated by the
+Columbus V900 and V990 GPS trackers.
 
-This gem:
+The gem works by allowing you to associate a "sidecar" file to each
+Columbus track.  The sidecar file, in YAML fromat, contains
+information such as the start and end location, the maximum speed, the
+maximum elevation of the track.
 
-- generates a sidecar file for each columbus track you process.  The
-  sidecar file contains information about date, start location, end
-  location, max speed, etc.
-- allows to search tracks using complex queries.  For instance, "get
-  me all tracks with max speed less than 10 kilometers per hours"
-- allows to show one or more tracks on a map, using leaflet.js
-- it is "pipe friendly", so that you can search for all track matching
-  a given criteria and show them on a map
+The information stored in the sidecar files can then be used to search
+tracks.  Them gem allows you, for instance, to perform complex queries
+such as: "get the tracks whose max speed less than 10 kilometers per
+hours and whose start location is in the USA".
+
+Tracks can be shown on a map.  The application is pipe "friendly", so
+that, for instance, you can pipe the output of a search to the show
+command to view all the tracks matching your search.
 
 Installation
 ------------
@@ -32,16 +36,77 @@ Or install it yourself as:
 
 Usage
 -----
+Generate the sidecar files for your tracks with the `process` command:
+
+    columbus3 process 11010101.CSV # generate the sidecar file for 11010101.CSV 
+
+notice that you can pass `*` as argument to process all your tracks at
+once.  The process command reverse geocodes the first and last point
+of the track and stores other information about the track.
+
+    cat 11010101.CSV
+    ---
+    :start_date: 2011-01-01 22:15:58.000000000 Z
+    :end_date: 2011-01-02 03:06:57.000000000 Z
+    :duration: 17459.0
+    :size: 17440
+    :start_location: University of California, Santa Barbara, Ocean Road, Isla Vista, CA 93117, USA
+    :end_location: 500-524 Matadero Avenue, Palo Alto, CA 94306, USA
+    :min_speed: 0
+    :max_speed: 138
+    :min_height: -9
+    :max_height: 432
+    :bearing: NW
+    :distance: 885.6399415490763
+    :distance_aerial: 392.2223148453187
+    :filename: 11010101.CSV
+
+Once you have the sidecar files, you can search, show, and display
+detailed information about your tracks.
+
+For instance:
+
+    columbus3 search 'location ~ "USA"'
+    
+returns all tracks in the current directory, whose start or end location has "USA" in the address
+field.  Notice the usage of the single quote to protect the `~` from expansion.
 
-Get detailed instructions with:
+The command:
 
-    columbus3 man
+    columbus3 show 11010101.CSV 11010201.CSV
+    
+shows tracks on a map (you need to open `_show.html` in a browser to view the map), while 
+
+    columbus3 graph 11010101.CSV 
+    
+shows info about a single track (you need to open `_graph.html` in a browser to view the info).
+
+Piping also works. For instance:
+
+    columbus3 search 'location ~ "USA"' --fields path | colmumbus3 show
+
+gets all tracks whose start or end location has "USA" in the address field and diplays them on a map.
+
+GPX files can also be managed, although it is first necessary to
+convert them to V900 tracks with the following command:
+
+    columbus3 convert file.gpx
     
-You can also view the manual online: [manual](doc/manual.txt).
+makes `file.gpx` into a V900 CSV track.
 
-A console is also available for simplifying interaction.  Invoke it with:
+If you do not want to type `columbus3` every time, you can invoke a console:
 
     columbus3 console
+    columbus3:000> process 11010101.CSV
+    columbus3:001> show 11010101.CSV
+    columbus3:002>
+
+More information with:
+
+    columbus3 help                          # get list of available commands
+    columbus3 help process                  # get help about the process command    
+    columbus3 man
+
 
 Development
 -----------
@@ -60,11 +125,55 @@ Contributing
 ------------
 
 Bug reports and pull requests are welcome on GitHub at
-https://github.com/\[USERNAME\]/columbus3.
+https://github.com/avillafiorita/columbus3.
+
+License
+-------
+
+The original code of this gem is available as open source under the
+terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+The gem ships wih the following Javascript libraries, which are
+distributed according to their licenses:
+
+-   [Leaflet](http://leafletjs.com/)
+    ([License](https://github.com/Leaflet/Leaflet/blob/master/LICENSE))
+-   [Flot](http://www.flotcharts.org/)
+    ([License](https://github.com/flot/flot/blob/master/LICENSE.txt))
+-   [jQuery](http://jquery.com/)
+    ([License](https://github.com/jquery/jquery/blob/master/LICENSE.txt))
+
+See Also
+--------
+
+If you are looking for a full graphical client and work on MacOS, you
+might want to download Columbus from http://www.minimalbit.com
 
 Version History
 ---------------
 
+**0.6.0**
+- More informative output from commands
+- The `help` command is now more informative
+- The `path` field in the search command now returns the path of the
+  CSV file (and not that of the YAML sidecar file), simplifying piping
+  searches to the show command
+- When searching, a new field `yaml` returns the name of the sidecar
+  file associated to a track
+- New behaviour of `show` and `graph` commands: the `_show.html` and
+  `_graph.html` are always created, even if a file with the same name
+  already exists in the current directory (previous versions required
+  to specify the `--force` option to achieve the same behaviour); a
+  backup copy of the files which are overwritten is always created.
+  The `--force` option forces rewriting of the javascript files;
+  backup copies of existing files are created.
+- The number of tile providers has been significantly reduced
+- Some code has been refactored to improve readability
+- Added `-h` and `--help` (in addition to the `help` command)
+- Updates to the documentation
+- Bumped version of gems used in production
+- Bumped version of gems used for development
+
 **0.5.0**
 
 - Fixed a bug with searches on dates
@@ -73,14 +182,14 @@ Version History
 - More informative messages when running commands
 - Added a console: launch it with `columbus3 console`
 - Fixed a bug with graph (call to sanitize failed)
-- Added [Changelog File](doc/ChangeLog.org), which I am using to help mantaining
+- Added [Changelog File](doc/ChangeLog.org), which I am using to help maintaning
   this list of changes
 
 **0.4.0**
 
 - Improved syntax for search:
     -   new option -r searches in sub-directories
-    -   new option --fields allows to specify the fields to look for
+    -   new option --fields allows to specify the  to look for
 
 **0.3.0**
 
@@ -104,19 +213,3 @@ Version History
 
 - Initial release
 
-License
--------
-
-The original code of this gem is available as open source under the
-terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-The gem ships wih the following javascript libraries, which are
-distributed according to their licenses:
-
--   [Leaflet](http://leafletjs.com/)
-    ([License](https://github.com/Leaflet/Leaflet/blob/master/LICENSE))
--   [Flot](http://www.flotcharts.org/)
-    ([License](https://github.com/flot/flot/blob/master/LICENSE.txt))
--   [jQuery](http://jquery.com/)
-    ([License](https://github.com/jquery/jquery/blob/master/LICENSE.txt))
-

data/columbus3.gemspec

@@ -7,11 +7,11 @@ Gem::Specification.new do |spec|
   spec.name          = "columbus3"
   spec.version       = Columbus3::VERSION
   spec.authors       = ["Adolfo Villafiorita"]
-  spec.email         = ["adolfo.villafiorita@ict4g.net"]
+  spec.email         = ["adolfo.villafiorita@me.com"]
 
-  spec.summary       = %q{Manage V900 and V990 GPS tracks from the command line.}
-  spec.description   = %q{Some simple command line commands to manage tracks generated by the V900 family of GPS loggers (CSV format).}
-  spec.homepage      = "https://www.ict4g.net/gitea/adolfo/columbus3"
+  spec.summary       = %q{Manage Columbus V900 and V990 GPS tracks from the command line.}
+  spec.description   = %q{Some simple command line commands to manage tracks generated by the Columbus family of GPS loggers (CSV format).}
+  spec.homepage      = "http://www.github.com/avillafiorita/columbus3"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
@@ -19,10 +19,10 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.10"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
   spec.add_development_dependency "minitest"
 
-  spec.add_dependency "slop", "~> 4.3.0"
+  spec.add_dependency "slop", "~> 4.5.0"
   spec.add_dependency "geocoder"
 end

data/doc/ChangeLog.org

@@ -8,3 +8,50 @@ Archived entries from file /home/adolfo/Documents/Sources/ruby/columbus3/doc/tod
   :ARCHIVE_CATEGORY: todo
   :ARCHIVE_TODO: DONE
   :END:
+
+* REJECTED fix filename standards in a specific class (or one method per class)
+  :PROPERTIES:
+  :ARCHIVE_TIME: 2017-08-10 Thu 14:29
+  :ARCHIVE_FILE: ~/Documents/Sources/ruby/columbus3/doc/todo.org
+  :ARCHIVE_OLPATH: Rails: columbus3
+  :ARCHIVE_CATEGORY: todo
+  :ARCHIVE_TODO: REJECTED
+  :ARCHIVE_ITAGS: columbus3
+  :END:
+  .yaml extension
+  .js extension
+  _show.html
+  _graph.html
+  ... there should be one place only where filename.csv is tranformed
+  appropriately
+
+
+* DONE new policy for --force
+  :PROPERTIES:
+  :ARCHIVE_TIME: 2017-08-10 Thu 14:30
+  :ARCHIVE_FILE: ~/Documents/Sources/ruby/columbus3/doc/todo.org
+  :ARCHIVE_OLPATH: Rails: columbus3
+  :ARCHIVE_CATEGORY: todo
+  :ARCHIVE_TODO: DONE
+  :ARCHIVE_ITAGS: columbus3
+  :END:
+  backup are always created, if the files exist
+  --force rewrites yaml, js, or graph_js files (they shouldn't be changed
+  once generated)
+
+  _show.html, _graph.html are expendable and can be written and rewritten
+  every time
+
+
+* DONE be more informative about what is going on
+  :PROPERTIES:
+  :ARCHIVE_TIME: 2017-08-10 Thu 15:21
+  :ARCHIVE_FILE: ~/Documents/Sources/ruby/columbus3/doc/todo.org
+  :ARCHIVE_OLPATH: Rails: columbus3
+  :ARCHIVE_CATEGORY: todo
+  :ARCHIVE_TODO: DONE
+  :ARCHIVE_ITAGS: columbus3
+  :END:
+  Many commands succeed silently.  They could probably print some
+  informative messages
+

data/doc/todo.org

@@ -4,10 +4,27 @@
 #+STARTUP: showall
 
 * Rails: columbus3
-** TODO integrate manual generation (manual.txt) in the deployment process
-** FEATURE be more informative about what is going on
-   Many commands succeed silently.  They could probably print some
-   informative messages
+** FEATURE Add a web interface with sinatra
+   The web interface does three things:
+   - show the list of tracks
+   - filter tracks using search
+   - show/graph tracks
+
+** FEATURE support for tags
+   columbus3 tag -a TAG_NAME track1...trackN
+   columbus3 tag -d TAG_NAME track1...trackN
+
+** FEATURE As a user I want to split a track at a given point
+   Pass the index as argument and generate two files out of the existing one
+   Give the option to delete the old file and to process the new files
+
+** FEATURE As a user I want to merge to different tracks
+   Main motivation for this feature is that the CSV files have an index
+   column, which needs to be properly updated.
+   
+** FEATURE GPX export (for DarkTable and GoogleEarth)
+   This is covered by GPS Babel, but it is also very simple to implement
+
 ** FEATURE As a user I want to be able to view the individual points
    Performance is an issue, here.  Maybe activate the layer on a need-basis.
    Also: it would be nice to produce a single GeoJSON set of data (e.g., the
@@ -47,17 +64,13 @@
 
 ** FEATURE As a user I want to identify the time/index of individual points
    This is useful for track splitting
+
 ** FEATURE As a user I want to have an idea of the direction and other info such as speed and height
    Some possible solutions include: color dots, put height and speed plot on the same page)
-** FEATURE As a user I want to split a track at point
-   Pass the index as argument and generate two files out of the existing one
-   Give the option to delete the old file and to process the new files
-** FEATURE GPX export for DarkTable and GoogleEarth
-** FEATURE As a user I want to be able to add custom fields
-   Allow users to specify custom fields in the sidecar file
+
 ** FEATURE As a user I want to filter values with wrong precision
+
 ** FEATURE As a user I do not want to view data only in ZULU time
    - get the local timezone (or let the user specify a timezone)
    - use the timezone of the starting point
-** FEATURE Make it into a sinatra app?
 

data/lib/columbus3/cli/command_semantics.rb

@@ -1,135 +1,12 @@
 require 'columbus3/version'
 require 'find'
 require 'readline'
+require 'fileutils'
 
 module Columbus3
   module CommandSemantics
     APPNAME = 'columbus3'
     VERSION = Columbus3::VERSION
-    MAN = <<EOS
-NAME
-  #{APPNAME} -- manage Columbus V900 and V990 tracks from the command line
-
-SYNOPSYS
-  #{APPNAME} [-h|-v]
-  #{APPNAME} command [options] [args]
-
-DESCRIPTION
-
-columbus3 manages Columbus V900 and V990 tracks from the command line,
-allowing a user to associate a sidecar file with the main information
-about a track, searching tracks (through sidecar files), displaying
-tracks on a map. 
-
-EXAMPLES
-
-    #{APPNAME} -h                            # get syntax of each command
-    columbus3 process 11010101.CSV           # generate a sidecar file
-    columbus3 search 'location ~ "USA"'      # get tracks in the USA
-    columbus3 show 11010101.CSV 11010201.CSV # show tracks on a map (_show.html)
-    columbus3 graph 11010101.CSV             # show info about a track (_graph.html)
-
-if you do not want to type columbus3 each type, you can invoke a console:
-
-    columbus3 console
-    columbus3:000> process 11010101.CSV
-    columbus3:001> show 11010101.CSV
-    columbus3:002>
-
-columbus3 also has a function to convert a GPX into a bunch of CSV
-files (which you can then process with the other commands), with some
-limitations (see below).
-
-The command is useful if you are using different loggers for generating your
-tracks:
-
-    columbus3 convert file.gpx
-
-will generate
-
-     file-1.csv
-     file-2.csv
-     ...
-
-one per track in the GPX file.
-
-**CSV export limitations** The Columbus V900 format has fields with fixed width,
-and uses ^@ as a filler.  The CSV file generated by the convert command generates fields
-of variable width (standard CSV files, I dare say).  The heading field is not computed
-and the field is filled with -1.
-
-Piping commands. You can pipe the output of a search command to show, using
-the following syntax:
-
-  columbus3 search 'location ~ "USA"' --fields path | columbus3 show --sidecar
-
-The option --fields shows only the pathname of the files found; the option
---sidecar removes the .yaml extension from the list of files found.
-
-SEARCH SYNTAX
-
-  >>> DON'T FORGET TO EMBED YOUR QUERY IN SINGLE QUOTES <<<
-
-Terms you can search for:
-
-  location, start_location, end_location
-  date, start_date, end_date
-  year
-  duration
-  max_speed
-  min_height
-  max_height
-
-Numerical operators:  
-  <, <=, ==, >=, >
-
-String operators (locations):
-  ~ (contains), == (is exactly)
-
-Complex Terms:
-  Use "and" and "or" to build complex queries
-
-Examples of simple searches
-  'location ~ "USA"'     any track whose start or end location contains USA
-  'date > 2015-02-14'    any track whose start or end date is after Feb 14, 2015
-  'year == 2015'         any track whose start or end date is in 2015
-  'duration <= 01:02:03' any track with a duration of less than 1h, 2min, and 3secs
-  'max_speed > 120'      any track with a max speed greater than 120 km/h
-  'min_height == 10'     any track with a min height lower than 10 meters
-
-Examples of complex searches
-  'location ~ "USA" and start_date >= 2015-01-01' tracks in the USA after or on Jan 1, 2015
-  'start_location ~ "Trenton" and end_location ~ "New York"'  trips from Trenton to New York
-
-List of supported fields in output
-  path           -> relative path of the CSV file
-  filename       -> basename of the CSV file
-  start_location -> start location
-  end_location   -> end location
-  start_date     -> start date (and time)
-  end_date       -> end date (and time)
-  duration       -> duration in seconds
-  min_speed      -> minimum speed in km/h
-  max_speed      -> maximum speed in km/h
-  min_height     -> minimum height in meters
-  max_height     -> maximum height in meters
-
-VERSION
-  This is version #{VERSION}
-
-LICENSE
-  MIT
-
-  Columbus3 uses leaflet, leafleft-providers, flot, and jquery.  They
-  are distributed under a different license: see their websites for more
-  details (or have a look at the license file shipped with the Gem)
-
-SEE ALSO
-  If you are looking for a full graphical client, you might want to
-  download Columbus from http://www.minimalbit.com
-
-  https://github.com/avillafiorita/columbus3
-EOS
 
     #
     # Main App Starts Here!
@@ -139,14 +16,17 @@ EOS
     end
 
     def self.man opts = nil, argv = []
-      puts MAN
+      path = File.join(File.dirname(__FILE__), "/../../../README.md")
+      file = File.open(path, "r")
+      contents = file.read
+      puts contents
     end
 
     def self.help opts = nil, argv = []
       all_commands = CommandSyntax.commands
       
       if argv != []
-        argv.map { |x| puts all_commands[x.to_sym][0] }
+        argv.map { |x| puts all_commands[x.to_sym][2] }
       else
         puts "#{APPNAME} command [options] [args]"
         puts ""
@@ -187,6 +67,7 @@ EOS
         if sidecar.exist? and not force
           puts "Sidecar file for #{track.filename} already exists. Use --force if you want to overwrite it."
         else
+          backup(sidecar.filename) if sidecar.exist?
           printf "Processing %s ...", track.filename
           sidecar.metadata = track.metadata
           sidecar.save
@@ -199,7 +80,7 @@ EOS
       debug = opts[:debug]
       directory = opts[:dir] || "."
       recurse = opts[:recurse]
-      fields = opts[:fields].any? ? opts[:fields].map { |x| x.to_sym } : [:path, :filename, :start_location, :end_location, :start_date, :end_date, :duration, :min_speed, :max_speed, :min_height, :max_height] 
+      output_fields = opts[:fields].any? ? opts[:fields].map { |x| x.to_sym } : [:path, :filename, :start_location, :end_location, :start_date, :end_date, :duration, :min_speed, :max_speed, :min_height, :max_height] 
 
       if recurse then
         files = Find.find(directory).select { |e| File.extname(e) == ".yaml" }
@@ -212,84 +93,24 @@ EOS
         puts "Searched files: #{files.join(",")}"
         puts "Searched files count: #{files.size}"
         puts "Processed query: #{query}"
-        puts "Fields: #{fields}"
+        puts "Output Fields: #{fields}"
       else
         sidecar_search = Columbus3::SidecarSearch.new
         sidecar_search.load files
         match = sidecar_search.search query
         match.each do |m|
-          string = fields.map { |x| "#{m[x]}" }.join("\t")
+          string = output_fields.map { |x| "#{m[x]}" }.join("\t")
           printf "%s\n", string
         end
       end
     end
 
     def self.show opts, args
-      filename = opts[:filename] || "_show.html"
-      force = opts[:force]
-      sidecar = opts[:sidecar]
-
-      # build the argument list, which are either provided from the command line
-      # or, if args, is empty, from the standard input
-      files = args == [] ? STDIN.read.split("\n") : args
-
-      # remove .yaml from files, if required to do so
-      pruned_args = sidecar ? files.map { |x| x.gsub(/\.(YAML|yaml)$/, '') } : files
-
-      pruned_args.each do |arg|
-        # generate the js file(s), if not already existing or forced to
-        # do so by the force directive
-        if force or not File.exist? arg
-          printf "Creating json file for #{arg} ..."
-          complete = true
-        else
-          puts "Json file for #{arg} already exists (--force to force updating)"
-          complete = false
-        end
-        Columbus3::LeafletRenderer::to_leaflet arg, force
-        puts "done!" if complete
-      end
-      if force or not File.exist? filename
-        printf "Creating #{filename} ..."
-        complete = true
-      else
-        puts "#{filename} already exists (--force to force updating)"
-        complete = false
-      end
-      Columbus3::LeafletRenderer::show(filename, pruned_args) if args
-      puts "done!" if complete
-      puts "You might now want to open #{filename}."
+      show_machinery opts, args, Columbus3::LeafletRenderer
     end
 
     def self.graph opts, args
-      filename = opts[:filename] || "_graph.html"
-      force = opts[:force]
-
-      input_filename = args[0]
-      if input_filename
-        if force or not File.exist? input_filename
-          printf "Creating javascript graph data for #{input_filename} ..."
-          complete = true
-        else
-          puts "Javascript graph data for #{input_filename} already exists (--force to force updating)"
-          complete = false
-        end
-        Columbus3::FlotRenderer::to_graph_data input_filename, force
-        puts "done!" if complete
-
-        if force or not File.exist? arg
-          printf "Creating #{filename} ..."
-          complete = true
-        else
-          puts "#{filename} already exists (--force to force updating)"
-          complete = false
-        end
-        Columbus3::FlotRenderer::show filename, input_filename
-        puts "done!" if complete
-        puts "You might now want to open #{filename}."
-      else
-        puts "Error: please specify a track file"
-      end
+      show_machinery opts, args, Columbus3::FlotRenderer
     end
 
     def self.convert opts, args
@@ -320,7 +141,7 @@ EOS
     
     # read-eval-print step
     def self.reps all_commands, argv
-      if argv == []
+      if argv == [] or argv[0] == "--help" or argv[0] == "-h"
         CommandSemantics.help
         exit 0
       else
@@ -348,5 +169,63 @@ EOS
         end
       end
     end
+
+    private
+
+    def self.backup filename
+      FileUtils::cp filename, filename + "~"
+      puts "Backup copy #{filename} created in #{filename}~."
+    end
+
+   def self.backup_and_write filename, content
+      backup(filename) if File.exist?(filename)
+      File.open(filename, "w") { |f| f.puts content }
+    end
+
+   # low level machinery for all renderers
+   # - opts list of options (filename and force)
+   # - args: CSV files to process
+   # - renderer, the renderer module to use, which has to expose the following
+   #   calls: OUTPUT_FILENAME, to_javascript_filename, to_javascript_file, 
+   def self.show_machinery opts, args, renderer
+      filename = opts[:filename] || renderer::OUTPUT_FILENAME
+      force = opts[:force]
+
+      # build the argument list, which is either provided from the
+      # command line or, if args is empty, from the standard input
+      files = (args == [] ? STDIN.read.split("\n") : args)
+
+      if files.empty?
+        puts "Error! Please pipe or pass as argument the list of files to show on the map."
+        exit 1
+      end
+
+      files.each do |file|
+        javascript_filename = renderer::to_javascript_filename file
+                             
+        # backup if the geojson file exists and we are forcing writing
+        backup(javascript_filename) if File.exist?(javascript_filename) and force
+
+        # print some messages
+        if force or not File.exist?(javascript_filename)
+          printf "Creating javascript file for #{file} ..."
+          print_done = true
+        else
+          puts "Javascript file for #{file} already exists (--force to force updating)"
+          print_done = false
+        end
+        # create the geojson file (if necessary or required to do so)
+        renderer::to_javascript_file file, force
+        # print some messages
+        puts "done!" if print_done
+      end
+      
+      backup(filename) if File.exist? filename
+      printf "Writing #{filename}... "
+      renderer::show filename: filename, files: files
+      puts "done!"
+      puts "You might now want to open #{filename}."
+    end
+   
   end
 end