sadie 0.0.35 → 0.0.39

data/CHANGELOG

@@ -10,4 +10,7 @@
 [0.0.15] actually committed changes to code this time...doh
 [0.0.16] bugfixes, updated tests
 [0.0.17] bugfixes, updated tests
-[0.0.18] initializePrimers is no longer called by constructor...must now call manually before using get method
+[0.0.18...0.0.34] bugfixes, working on more natural integration with olsen
+[0.0.35] initializePrimers is no longer called by constructor...must now call manually before using get method
+[0.0.36] added lots of debugging that's going to need to come out, but also added eachers, a VERY cool
+         enhancement that offers a huge optimization path with very low developer resources

data/README

@@ -12,6 +12,8 @@ Valid primers currently are:
   .res, .res.rb - provides access to general-purpose, programatic manipulation of data (i.e. just use sadie instance for input and output of data)
   .tmpl - simple templating engine for text-based file types
 
+There's also another file type that can be found in the primer directory called "eacher files".  These are simple files which allow for certain tasks to be performed before, after and during the priming of a key/value pair.  Currently, the only plugin that makes effective use of eachers is sql2ar and it provides a way for developers to iterate on the rows of a query result as it is initially processed into the resultant array.
+  
 It's very simple to add new primer types, so it would be simple to create primers for html, xml, csv, xls, pointers to all of the above on remote machines, or any- and everything else.
 
 At Landmetrics, we use a predecessor to Sadie to power perimetercomps[http://perimetercomps.com], producing each 50+ page report with charts, graphs and tables with only 12 queries to the database.

data/lib/sadie/primer_plugins/SQLQueryTo2DArray.plugin.rb

@@ -4,27 +4,28 @@ Sadie::registerPrimerPlugin( { "match" => /\.sql2ar$/,
     primer_file_basename = File.basename( primer_file_filepath )
     sadie_key = key_prefix + '.' + primer_file_basename
     sadie_key = sadie_key.gsub(/^\./,"")
-    
+    puts "DEFINING sql2ar primer for: #{sadie_key}"
     Sadie::prime( { "provides" => [ sadie_key ] }) do |sadie|
-    
+        puts "priming via sql2ar for: #{sadie_key}"
         if ( matches = primer_file_basename.match( /^(.*)\.([^\.]+)\.sql2ar$/ ) )
             dbi_sadie_key = key_prefix + '.' + matches[2] + ".dbi.conx"
-#             puts "dbi_sadie_key: #{dbi_sadie_key}, connecting..."
             dbconx = sadie.get( dbi_sadie_key )
-#             puts "dbconx: #{dbconx}"
             if ( dbconx = sadie.get( dbi_sadie_key ) )
-#                 puts "  connected."
                 if sql_query = Sadie::templatedFileToString( primer_file_filepath )
                     
                     sth = dbconx.prepare(sql_query)
                     sth.execute
                     
+                    
+                    puts "looping thru db query results"
                     result = Array.new
                     while row = sth.fetch
-                        result.push row.to_a
+                        row_as_array = row.to_a
+                        puts "calling eacherFrame each for sadiekey: #{sadie_key}"
+                        Sadie::eacherFrame sadie_key, Sadie::EACH, row_as_array
+                        result.push row_as_array
                     end
                     
-                    
                     sadie.setExpensive( sadie_key, result )
                     
                     # Close the statement handle when done

data/lib/sadie/version.rb

@@ -1,3 +1,3 @@
 class Sadie
-  VERSION = "0.0.35"
+  VERSION = "0.0.39"
 end

data/lib/sadie.rb

@@ -23,6 +23,10 @@ end
 
 class Sadie
     
+    BEFORE      = 1
+    AFTER       = 2
+    EACH        = 3
+    
     # ==method: Sadie::getSadieInstance
     #
     # returns a new Sadie instance.  Options match those of Sadie's constructor method
@@ -58,6 +62,252 @@ class Sadie
         current_sadie_instance.prime( primer_definition, &block )
     end
     
+    def memorizeEacherFileLocation( sadiekey, filepath )
+        
+        # store the file path
+        defined? @eacher_filepaths or @eacher_filepaths = Hash.new
+        if ! @eacher_filepaths.has_key? sadiekey
+            puts "memorizing eacher filepath #{filepath} for sadiekey: #{sadiekey}"
+            @eacher_filepaths[sadiekey] = [filepath]
+        elsif ! @eacher_filepaths[sadiekey].include? filepath
+            puts "memorizing eacher filepath #{filepath} for sadiekey: #{sadiekey}"
+            @eacher_filepaths[sadiekey].push filepath
+        end
+    end
+    
+    def eacherFilepaths( sadiekey )
+        defined? @eacher_filepaths or return nil
+        @eacher_filepaths.has_key? sadiekey or return nil
+        @eacher_filepaths[sadiekey]
+    end
+    
+    def midEacherInit?
+        defined? @eacher_init or return false
+        @eacher_init or return false
+        true
+    end
+    
+    def setEacherInit
+        @eacher_init = true
+    end
+    
+    def clearEacherInit
+        @eacher_init = nil
+    end
+
+    # ==method: Sadie::eacher
+    #
+    # called by eacher files to hook into priming operations
+#     def self.eacher( eacher_params, &block )
+#         puts "HERE!!!"
+#         current_sadie_instance = Sadie::getCurrentSadieInstance
+#         filepath = current_sadie_instance.getCurrentPrimerFilepath
+#         key_prefix = current_sadie_instance.getCurrentPrimerKeyPrefix
+#         
+#         occur_at = eacher_params[:when]
+#         puts "eacher, occur_at: #{occur_at}"
+#         
+#         # gen sadie key
+#         basefilename = filepath.gsub(/^.*\//,"")
+#         sadiekey =  key_prefix + "." + basefilename.gsub(/\.each(?:\..*)$/,"")
+#         if eacher_params.has_key? "sadiekey"
+#             sadiekey = eacher_params["sadiekey"]
+#         end
+#         
+#         if current_sadie_instance.midEacherInit?
+#             memorizeEacherFileLocation( sadiekey, filepath )
+#         elsif current_sadie_instance.whichEacherFrame == occur_at
+#             current_sadie_instance.eacher( eacher_params, &block )
+#         end
+#     end
+    
+    def eacher( params, &block )
+        filepath = getCurrentPrimerFilepath
+        key_prefix = getCurrentPrimerKeyPrefix
+        occur_at = params[:when]
+#         puts "eacher, occur_at: #{occur_at}"
+        
+        # gen sadie key
+        basefilename = filepath.gsub(/^.*\//,"")
+        sadiekey =  key_prefix + "." + basefilename.gsub(/\.each(?:\..*)*$/,"")
+        if params.has_key? "sadiekey"
+            sadiekey = params["sadiekey"]
+        end
+        
+        if midEacherInit?
+            memorizeEacherFileLocation( sadiekey, filepath )
+            
+            if params.has_key? :provides
+                #puts "> got provides!"
+                provide_array = params[:provides]
+                provide_array.respond_to? "each" or provide_array = [provide_array]
+                
+                # tell sadie that the sadiekey primer also provides everything in the provide array
+                setEachersProvidedByPrimer( sadiekey, provide_array )
+                
+                
+            end            
+            
+        elsif whichEacherFrame == occur_at
+            if block.arity == 0
+                yield self
+            else
+                yield self, getEacherParam
+            end
+        end
+    end
+    
+    def setEachersProvidedByPrimer( sadiekey, providers )
+        puts "setting eachers to be provided by #{sadiekey} primer to #{providers}"
+        
+        # record reverse map for use by eacherFrame
+        defined? @eacher_frame_redirect \
+            or @eacher_frame_redirect = Hash.new
+        providers.each do |provider|
+            @eacher_frame_redirect[provider] = sadiekey
+        end
+        
+        defined? @eachers_provided or @eachers_provided = Hash.new
+        if @eachers_provided.has_key? sadiekey
+            @eachers_provided[sadiekey] = @eachers_provided[sadiekey].concat( providers )
+        else
+            @eachers_provided[sadiekey] = providers
+        end
+    end
+    
+    def isEacherKey?( key )
+        defined? @eacher_frame_redirect or return false
+        @eacher_frame_redirect.has_key? key or return false
+        true
+    end
+    
+    def getEacherDependency( key )
+        defined? @eacher_frame_redirect or return nil
+        @eacher_frame_redirect.has_key? key or return nil
+        @eacher_frame_redirect[key]
+    end
+    
+    def getEachersProvidedByPrimer( sadiekey )
+        puts "looking for eachers provided by: #{sadiekey}"
+        defined? @eachers_provided or return nil
+        @eachers_provided.has_key? sadiekey or return nil
+        puts "found eachers for #{sadiekey}"
+        @eachers_provided[sadiekey]
+    end
+    
+    def self.eacher( eacher_params, &block )
+        current_sadie_instance = Sadie::getCurrentSadieInstance
+        current_sadie_instance.eacher( eacher_params, &block )
+    end
+    
+    
+    def self.eacherFrame( sadiekey, occur_at, param=nil )
+        current_sadie_instance = Sadie::getCurrentSadieInstance
+        current_sadie_instance.eacherFrame( sadiekey, occur_at, param )
+    end
+    
+    def eacherFrame( sadiekey, occur_at, param=nil )
+        
+        key = sadiekey
+        if defined? @eacher_frame_redirect
+            if @eacher_frame_redirect.has_key? key
+                key = @eacher_frame_redirect[key]
+            end
+        end
+        
+        puts "eacherFrame (#{key},#{occur_at})"
+        setEacherFrame( occur_at )
+        defined? param and setEacherParam( param )
+        if filepaths = eacherFilepaths( key )
+#             puts "found each file paths for key: #{key}, filepaths: #{filepaths}"
+            filepaths.each do |filepath|
+                load filepath
+            end
+        end
+        unsetEacherParam
+        unsetEacherFrame
+    end
+    
+    def whichEacherFrame
+        @eacher_frame
+    end
+    
+    def setEacherFrame( f )
+        @eacher_frame = f
+    end
+    
+    def unsetEacherFrame
+        @eacher_frame = nil
+    end
+    
+    def setEacherParam( p )
+        @eacher_param = p
+    end
+    
+    def unsetEacherParam
+        @eacher_param = nil
+    end
+    
+    def getEacherParam
+        @eacher_param
+    end
+    # == initialize eachers
+    #
+    # register all the eachers
+    #
+    # called by initializePrimers so it's not necessary to call this separate from that
+    def initializeEachers
+        
+        primers_dirpath = get( "sadie.primers_dirpath" ) \
+            or raise "sadie.primers_dirpath not set"
+
+        puts "Initializing eachers..."
+        setEacherInit
+        initializeEacherDirectory( "", primers_dirpath )
+        clearEacherInit
+        puts "...finished initializing eachers."
+        
+        
+        @@eachers_initialized = true
+    end
+    
+    def initializeEacherDirectory( key_prefix, current_dirpath )
+        
+        puts "initializing eacher directory: #{current_dirpath}"
+        Dir.foreach( current_dirpath ) do |filename|
+            
+           # skip the dit dirs
+            next if filename.eql?(".") || filename.eql?("..") || filename =~ /\~$/
+            
+            
+            filepath = File.expand_path( filename, current_dirpath )
+            
+            if File.directory? filepath
+                new_key_prefix = key_prefix + '.' + filename
+                new_key_prefix = new_key_prefix.gsub(/^\.+/,"")
+                initializeEacherDirectory( new_key_prefix, filepath )
+            else
+                if filename =~ /\.each(?:\..*)*$/
+                    initializeEacherFile( key_prefix, filepath )
+                end
+            end
+        end
+    end
+    
+    def initializeEacherFile( key_prefix, filepath )
+        puts "initializing eacher file (#{key_prefix}): #{filepath}"
+        setCurrentPrimerFilepath filepath
+        setCurrentPrimerKeyPrefix key_prefix
+        load filepath
+    end
+        
+    def eachersInitialized?
+        defined? @@eachers_initialized or return false
+        @@eachers_initialized and return true
+        return false
+    end
+    
+    
     # ==method: Sadie::registerPrimerPlugin
     #
     # this method is called in the .plugin.rb files to register new plugin types
@@ -132,32 +382,15 @@ class Sadie
         
         # internalize defaults to shortterm
         DEFAULTS.each do |key, value|
-#             if key.eql? "sadie.primer_plugins_dirpath"
-#                 addPrimerPluginsDirPath value 
-#             else
                 _set( key, value )
-#             end
         end
         
-        # internalize supplied defaults, postponing a set of sadie.primers_dirpath
-        # until the end if one is supplied.  The reason for this is that the setter
-        # attempts to read the plugins and if the primer plugin dirpath has not
-        # yet been set, then it'll choke if it processes the wrong one first
-#         delay_set_primers_dirpath = nil
-      
         # iterate over constructor args, but do primers_dirpath last since it
         # causes a call to initializePrimers
         options.each do |key, value|
-#             if key.eql? "sadie.primers_dirpath"
-#                 delay_set_primers_dirpath = value
-#             else
                 set( key, value )
-#             end
         end
-        
-#         defined? delay_set_primers_dirpath \
-#             and set( "sadie.primers_dirpath", delay_set_primers_dirpath )
-        
+                
         # if a path to a session is given, init using session file
         if options.has_key?( "sadie.session_filepath" )
             set( "sadie.session_filepath", options["sadie.session_filepath"] )
@@ -170,13 +403,14 @@ class Sadie
         end
         
         # add the default sadie plugins dir
-        plugins_dirpath = File.join(
-            ENV['GEM_HOME'],
-            "gems/sadie-#{Sadie::VERSION}",
-            "lib/sadie/primer_plugins"
-        )
-        if ! File.exists? plugins_dirpath   # for dev
-            plugins_dirpath = "lib/sadie/primer_plugins"
+        plugins_dirpath = "lib/sadie/primer_plugins"   # for dev
+        if ! File.exists? plugins_dirpath
+            plugins_dirpath = File.join(
+                ENV['GEM_HOME'],
+                "gems/sadie-#{Sadie::VERSION}",
+                "lib/sadie/primer_plugins"
+            )
+            
         end        
         addPrimerPluginsDirPath plugins_dirpath
         
@@ -197,6 +431,7 @@ class Sadie
             or @plugins_dir_paths.unshift(exppath)
         
         @@primer_plugins_initialized = nil
+        return self
     end
     
    
@@ -228,8 +463,6 @@ class Sadie
                 # skip blank lines
                 next if key.match /^\s*$/
                 
-                #puts "Prime> providing: #{key}"
-                
                 # key primed or raise error
                 primed? key \
                     or raise "primer definition file: #{current_primer_filepath} was supposed to define #{key}, but did not"
@@ -245,10 +478,6 @@ class Sadie
         accepts_block = arghash.has_key?( "accepts-block" ) && arghash["accepts-block"] ? true : false
         prime_on_init = arghash.has_key?( "prime-on-init" ) && arghash["prime-on-init"] ? true : false
         
-        
-        
-        
-        
         # if mid plugin init, register the plugin params with the match
         if midPluginInit?
             
@@ -257,7 +486,7 @@ class Sadie
         # midplugininit returned false, we're actually in the process of either initializing
         # a primer or actually priming
         else
-            yield( self, getCurrentPrimerKeyPrefix, @@current_primer_filepath ) \
+            yield self, getCurrentPrimerKeyPrefix, @@current_primer_filepath
         end
     end
     
@@ -334,11 +563,6 @@ class Sadie
     # returns true if the destructOnGet flag is set for the key
     def destroyOnGet?( key )
         ( @flag_destroyonget.has_key?( key ) && @flag_destroyonget["#{key}"] )
-#         @flag_destroyonget.has_key?( key ) \
-#             or return _newline( false )
-#         @flag_destroyonget["#{key}"] \
-#             and return _newline( true )
-#         return _newline(false)
     end
     
     # ==method: set
@@ -352,38 +576,13 @@ class Sadie
     # the cheap setter.  key, value pairs stored via this method are kept in memory
     def setCheap( k, v )
         
-#          puts "setCheap( #{k}, #{v} )"
-
-#         if  k.eql? "sadie.primer_plugins_dirpath" 
-#             puts "adding primer plugins dirpath via setCheap"
-#             if v.respond_to? "each"
-#                 v.each do |plugindir|
-#                     addPrimerPluginsDirPath plugindir
-#                 end
-#             else
-#                 addPrimerPluginsDirPath v
-#             end
-#             v = @plugins_dir_paths
-#         end
-        
-        
-        
         # set it, mark not expensive and primed
         _set( k, v )
         _expensive( k, false )
         
-        # if we've reset the primers dirpath, init the primers
-#         if k.eql?( "sadie.primers_dirpath" )
-#             initializePrimers
-#         end
         
        _primed( k, true )
         
-        # if we've reset the primers dirpath, init the primers
-        #if k.eql?( "sadie.primers_dirpath" )
-        #    Sadie::setCurrentSadieInstance( self )
-        #end
-        
     end
     
     def cheap?( k )
@@ -395,7 +594,6 @@ class Sadie
     # the expensive setter.  key, value pairs stored via this method are not kept in memory
     # but are stored to file and recalled as needed
     def setExpensive(k,v)
-#         puts "setting expensive, key: #{k}"
         expensive_filepath              = _computeExpensiveFilepath( k )
         serialized_value                = Marshal::dump( v )
         File.open(expensive_filepath, 'w') { |f|
@@ -452,6 +650,8 @@ class Sadie
         primerPluginsInitialized? \
             or initializePrimerPlugins
         
+        eachersInitialized? \
+            or initializeEachers
         
         primers_dirpath = get( "sadie.primers_dirpath" ) \
             or raise "sadie.primers_dirpath not set"
@@ -602,7 +802,7 @@ class Sadie
         Dir.foreach( current_dirpath ) do |filename|
             
            # skip the dit dirs
-            next if filename.eql?(".") || filename.eql?("..")
+            next if filename.eql?(".") || filename.eql?("..") || filename =~ /\~$/
             
             filepath = File.expand_path( filename, current_dirpath )
             
@@ -706,7 +906,22 @@ class Sadie
         # interate over provides setting primer providers for each
         primer_provides.each do | key |
             setPrimerProvider( key, filepath, plugin_filepath, getCurrentPrimerKeyPrefix )
+            
+#             # handle eachers
+#             if eachers_provided = getEachersProvidedByPrimer( key )
+#                 eachers_provided.each do |eacherkey|
+#                     
+# #                     Sadie::prime( { "provides" => [ eacherkey ] }) do |sadie|
+# #                         puts "calling sadie.get(#{key} to produce #{eacherkey}"
+# #                         sadie.get key
+# #                     end
+#                     
+# #                     puts "setting eacher #{eacherkey} to be provided by file: #{filepath}"
+# #                     setPrimerProvider( eacherkey, filepath, plugin_filepath, getCurrentPrimerKeyPrefix )
+#                 end
+#             end
         end
+        
     end
     
     
@@ -754,19 +969,25 @@ class Sadie
     end
 
     def _prime ( k )
+        puts ">>>priming: #{k}"
         
-        if provider  = getPrimerProvider( k )
-            primer_filepath, plugin_filepath, key_prefix = provider
+        if isEacherKey? k
+            get( getEacherDependency( k ) )
+        else
         
-            setCurrentPrimerFilepath(primer_filepath)
-            setCurrentPrimerKeyPrefix( key_prefix )
-            Sadie::setCurrentSadieInstance( self )
+            Sadie::eacherFrame( k, BEFORE )
+            if provider  = getPrimerProvider( k )
+                puts "got provider for sadiekey: #{k}"
+                primer_filepath, plugin_filepath, key_prefix = provider
             
-#             puts "_prime( #{k} ) loading #{provider}"
-            
-            load plugin_filepath
+                setCurrentPrimerFilepath(primer_filepath)
+                setCurrentPrimerKeyPrefix( key_prefix )
+                Sadie::setCurrentSadieInstance( self )
+                
+                load plugin_filepath
+            end
+            Sadie::eacherFrame( k, AFTER )
         end
-        
     end
     
 
@@ -807,9 +1028,7 @@ class Sadie
     
     # direct access setter for shortterm memory
     def _set( key, value )
-#        puts "_set> key: #{key}, value: #{value}"
             @shortterm["#{key}"]           = value
-       # end
     end
     
     def _unset( key )

data/test/tc_sadie_twodeep.rb

@@ -26,16 +26,25 @@ class TestSadieTwoDeep < Test::Unit::TestCase
             dbconx = sadie.get( "two.deep.test.dbi.conx" )
             assert_not_nil( dbconx )
             
-            # test sql22darray
+            # test eacher
+            puts "!!!"
+            puts "!!!"
+            eachertest = sadie.get("simple.eacher.test")
+            #assert_equal( eachertest, "start12end")
+            
+            # test sqlTo2DArray
             tablearray = sadie.get( "two.deep.testquery.test.sql2ar" )
+            puts "!!!"
+            puts "!!!"
             assert_not_nil( tablearray )
+            puts "tablearray: #{tablearray}"
             assert_equal( tablearray[0][0], 1 )
             assert_equal( tablearray[1][1], "testing456" )
 
             # test templating
             template_text = sadie.get( "two.deep.test_template.txt.tmpl" )
             template_text = template_text.gsub(/\s+/," ").gsub(/^\s*/,"").gsub(/\s*$/,"")
-#             puts "template text\n#{template_text}"
+            puts "template text\n#{template_text}"
             assert( (template_text.match(/later\s+gator/)), "incorrect match on template text" )
             assert( (template_text.match(/test\/test\_primers/)), "incorrect match on template text" )
         end

data/test/test_primers/two/deep/testquery.test.sql2ar.each

@@ -0,0 +1,19 @@
+require 'sadie'
+
+Sadie::eacher( :when => Sadie::BEFORE   ) do |sadie|
+    @testeach = "start"
+    puts "testeach[start]: #{@testeach}"
+end
+
+Sadie::eacher(  :when => Sadie::EACH, :sadiekey => "two.deep.testquery.test.sql2ar"  ) do |sadie,param|
+    @testeach = "#{@testeach}#{param[0]}"
+    puts "testeach[each]: #{@testeach}"
+end
+
+Sadie::eacher( :when => Sadie::AFTER, :provides => ["simple.eacher.test"]   ) do |sadie|
+    @testeach = "#{@testeach}end"
+    sadie.set "simple.eacher.test", @testeach 
+    puts "testeach[end]: #{@testeach}"
+end
+
+#def dsl_correct?; ( bitch_to_wrap_head_around? ) && ( rewritten_atleast_three_times? ) && ( seems_easy_now_that_its_done? ) && ( have_less_hair_now? ); end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sadie
 version: !ruby/object:Gem::Version
-  version: 0.0.35
+  version: 0.0.39
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-18 00:00:00.000000000Z
+date: 2012-04-20 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dbi
-  requirement: &20670980 !ruby/object:Gem::Requirement
+  requirement: &11389960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *20670980
+  version_requirements: *11389960
 - !ruby/object:Gem::Dependency
   name: mysql
-  requirement: &20670560 !ruby/object:Gem::Requirement
+  requirement: &11439500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *20670560
+  version_requirements: *11439500
 - !ruby/object:Gem::Dependency
   name: dbd-mysql
-  requirement: &20670140 !ruby/object:Gem::Requirement
+  requirement: &11439080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +43,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *20670140
+  version_requirements: *11439080
 description: Sadie is a data framework intended to ease the pain of managing related
   data.
 email:
@@ -55,7 +55,6 @@ extra_rdoc_files:
 - CHANGELOG
 - TODO
 files:
-- .README.kate-swp
 - .gitignore
 - CHANGELOG
 - Gemfile
@@ -99,6 +98,7 @@ files:
 - test/test_primers/two/deep/test.dbi.conx
 - test/test_primers/two/deep/test_template.txt.tmpl
 - test/test_primers/two/deep/testquery.test.sql2ar
+- test/test_primers/two/deep/testquery.test.sql2ar.each
 - test/test_primers/two/deep/two_results.res
 homepage: http://www.landmetrics.com/Sadie
 licenses: []