twb 4.4.4 → 4.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2c59fcc8781f04283fe5fbbdec7804483082a9bfabf792b29846c60ad7fe5b2
-  data.tar.gz: 1567f77448271fde58e8db2e8c49ab6beb6b52c23068ef543d2a3c24ec6aecd0
+  metadata.gz: 99a5530880ab68f71e94e0456ad8367fa00516e7f55e869028eaac3986f17141
+  data.tar.gz: 59a2dfe98f0e177fd7426e70fa9d08659d4748997bd13144784a321de0df2c07
 SHA512:
-  metadata.gz: d96aae6accabaffe7abf3986c2e195b630a0fbd236efd51a7c0b1460c67863e84a3b2c6b657ab7d0b1e723fb51db8df533f5c4619353925a7a9207b3f6fac37b
-  data.tar.gz: 48e7fefd8c1ac5529a7bcae218c735bfb4eb86201014d88463840f045b842c5952cf151f449f0931014f4da304b12f2c878a94fd19b171c3332378e92fcb411f
+  metadata.gz: b9e89a013d3c6888ef1de3acbce3b811b79c56e5d542dd6cfee6b3bebe218455a16a8cc00c60c558dbcc67a07b5087301a27fe746f5133344983452332fe4b39
+  data.tar.gz: 8fc758bae510b0c55ba9b3121c4d845c12e78916cddeb01911bd6bde3e96f6918f6cb2d6c6d5611ca8eca6038a424647b1aa64c801d64eb249355afe26c7fe34

data/lib/twb.rb

@@ -51,6 +51,7 @@ require_relative 'twb/util/fielddomainloader'
 require_relative 'twb/util/docprep'
 require_relative 'twb/analysis/documentedfieldsmarkdownemitter'
 require_relative 'twb/analysis/annotatedfieldsCSVEmitter'
+require_relative 'twb/analysis/WorkbookSummaryAnalyzer'
 require_relative 'twb/analysis/calculatedfields/calculatedfieldsanalyzer'
 require_relative 'twb/analysis/calculatedfields/groupfieldsanalyzer'
 require_relative 'twb/analysis/calculatedfields/markdownemitter'
@@ -70,5 +71,5 @@ require_relative 'twb/analysis/Sheets/dashsheetsanalyzer'
 # Represents Tableau Workbooks, their contents, and classes that analyze and manipulate them.
 #
 module Twb
-  VERSION = '4.4.4'
+  VERSION = '4.4.6'
 end

data/lib/twb/analysis/CalculatedFields/CalculatedFieldsAnalyzer.rb

@@ -35,7 +35,8 @@ module Analysis
 
       @@calcFieldsCSVFileName   = 'CalculatedFields.csv'
       @@calcFieldsCSVFileHeader = ['Record #',
-                                   'Workbook',      'Workbook Dir',
+                                   'Workbook',
+                                   'Workbook Modified',
                                    'Data Source',   'Data Source Caption', 'Data Source Name (tech)',
                                    'Field Name',    'Field Caption',       'Field Name (tech)',
                                    'Data Source + Field Name (tech)',
@@ -49,17 +50,19 @@ module Analysis
                                    'Formula LOD?'
                                   ]
 
-      @@calcLinesCSVFileName    = 'CalculatedFieldFormulaLines.csv'
-      @@calcLinesCSVFileHeader  = ['Calc Field #',
-                                   'Workbook',      'Workbook Dir',
+      @@calcLinesCSVFileName    = 'CalculatedFieldsFormulaLines.csv'
+      @@calcLinesCSVFileHeader  = ['Record #',
+                                   'Workbook',
+                                   'Workbook Modified',
                                    'Data Source',   'Data Source Caption', 'Data Source Name (tech)',
                                    'Field Name',    'Field Caption',       'Field Name (tech)',
                                    'Formula',       'Formula Line #',      'Formula Line'
                                   ]
 
       @@formFieldsCSVFileName   = 'CalculatedFieldsReferenced.csv'
-      @@formFieldsCSVFileHeader = ['Rec #',
-                                   'Workbook',   'Workbook Dir',
+      @@formFieldsCSVFileHeader = ['Record #',
+                                   'Workbook',
+                                   'Workbook Modified',
                                    'Data Source',
                                    'Field - Calculated',
                                    'Formula (tech)',
@@ -82,11 +85,11 @@ module Analysis
 DOTHEADER
 
       def initialize(**args)
-          @args = args
-          @csvAdd  = args[:csvMode] == :add
-          @csvMode = @csvAdd ? 'a' : 'w'
-          # emit true, "@csvAdd : #{@csvAdd}" 
-          # emit true, "@csvMode: #{@csvMode}" 
+          @args      = args
+          @recordDir = !@args.nil? && @args[:recordDir] == true
+          @ttdocdir  = @args[:ttdocdir]
+          @csvAdd    = args[:csvMode] == :add
+          @csvMode   = @csvAdd ? 'a' : 'w'
           init
           @funcdoc = {:class=>self.class, :blurb=>'Analyze Calculated Fields', :description=>'Calculated fields can be complex, this tool provides robust coverage.',}
           #-- CSV records collectors
@@ -95,14 +98,17 @@ DOTHEADER
           @csvFormulaLines     = []
           #-- Counters setup --
           @twbCount              = 0
+          @dataSourcesCount      = 0
           @calculatedFieldsCount = 0
           @referencedFieldsCount = 0
           #--
           @referencedFields     = SortedSet.new
           #--
-          @csvCF   = initCSV(@@calcFieldsCSVFileName, 'Calculated fields and their formulas.',                      @@calcFieldsCSVFileHeader)
-          @csvCFLs = initCSV(@@calcLinesCSVFileName,  "Calculated fields and their formulas' individual lines.",    @@calcLinesCSVFileHeader)
-          @csvFF   = initCSV(@@formFieldsCSVFileName, 'Calculated fields and the fields their formulas reference.', @@formFieldsCSVFileHeader)
+          twbdirLabel = @recordDir.nil? ? nil : 'Workbook Dir'
+          @csvCF   = initCSV(@@calcFieldsCSVFileName, 'Calculated fields and their formulas.',                      @@calcFieldsCSVFileHeader )
+          @csvCFLs = initCSV(@@calcLinesCSVFileName,  "Calculated fields and their formulas' individual lines.",    @@calcLinesCSVFileHeader  )
+          @csvFF   = initCSV(@@formFieldsCSVFileName, 'Calculated fields and the fields their formulas reference.', @@formFieldsCSVFileHeader )
+          # TODO migrate addition of 'Workbook Dir' to CSV header to TabTool
           #--
           @localEmit  = false
           @imageFiles = []
@@ -116,6 +122,7 @@ DOTHEADER
         emit  "- Workbook: #{workbook}"
         emit  "   version: #{@twb.version}"
         @twbDir   = @twb.dir #File.dirname(File.expand_path(workbook))
+        @modTime  = @twb.modtime
         @edges    = Set.new
         #-- processing
         dss = @twb.datasources
@@ -124,6 +131,7 @@ DOTHEADER
         @twbFields = {}
         @nodes     = Set.new
         dss.each do |ds|
+          @dataSourcesCount += 1
           # puts "\t\t - #{ds.uiname}  \t\t #{ds.calculatedFields.length}"
           next if ds.Parameters?  # don't process the Parameters data source - Parameters' fields aren't Calculated fields for our purposes
           # dataSourceNode = Twb::Util::Graphnode.new(name: ds.uiname, id: ds.id, type: ds, properties: {workbook: workbook})
@@ -145,6 +153,7 @@ DOTHEADER
       def loadMetrics
         @metrics = {
                      '# of Workbooks'         => @twbCount,
+                     '# of Data Sources'      => @dataSourcesCount,
                      '# of Calculated Fields' => @calculatedFieldsCount,
                      '# of Referenced Fields' => @referencedFieldsCount,
                    }
@@ -191,8 +200,8 @@ DOTHEADER
                   #-- collect field formulas as single lines
                   @csvCalculatedFields.push [
                                               @calculatedFieldsCount += 1,
-                                              @twb.name,           
-                                              @twbDir,
+                                              @twb.name,
+                                              @modTime,            
                                               ds.uiname,
                                               ds.caption,
                                               ds.name,
@@ -217,8 +226,8 @@ DOTHEADER
                   calculation.formulaResolvedLines.each do |fl|
                     emit "@@ resolved line::   => '#{fl}'"
                     fieldFormulaLines << [ @calculatedFieldsCount,        # 'Calc Field #',
-                                           @twb.name,                     # 'Workbook',      
-                                           @twbDir,                       # 'Workbook Dir',
+                                           @twb.name,                     # 'Workbook',
+                                           @modTime,      
                                            ds.uiname,                     # 'Data Source',   
                                            ds.caption,                    # 'Data Source Caption', 
                                            ds.name,                       # 'Data Source Name (tech)',
@@ -261,8 +270,8 @@ DOTHEADER
                     end
                     @csvFormulaFields <<  [ 
                                             @referencedFieldsCount += 1,
-                                            @twb.name,           
-                                            @twbDir,
+                                            @twb.name,
+                                            @modTime,
                                             ds.uiname,
                                             calcField.uiname,
                                             calculation.formulaFlat,
@@ -284,7 +293,9 @@ DOTHEADER
               cypherPy   @twb.name
             end
             emit "#######################"
-            #-- record calculated fields 
+            #--
+            #-- record calculated fields
+            twbDirCSV = @recordDir.nil? ? nil : @twbDir  
             emit "@@ record calculated fields  ds: #{ds.uiname}"
             @csvCalculatedFields.each do |r| 
               @csvCF << r

data/lib/twb/analysis/CalculatedFields/MarkdownEmitter.rb

@@ -27,8 +27,7 @@ module CalculatedFields
     def initialize(**args)
       @args = args
       init
-      puts "RECORD DOC: "
-      @funcdoc = {:class=>self.class, :blurb=>'Create  Markdown files (one per Workbook) documenting Calculated Fields', :description=>'Create  Markdown files (one per Workbook) documenting Calculated Fields' }
+      @funcdoc = {:class=>self.class, :blurb=>'Create  Markdown files (one per Workbook) documenting Calculated Fields', :description=>'Analyze Calculated Fields - create  Markdown files, one per Workbook' }
       @metrics = {}
     end
 

data/lib/twb/analysis/Sheets/dashsheetsanalyzer.rb

@@ -28,7 +28,8 @@ module Analysis
     def initialize(**args)
       @args      = args
       @recordDir = !@args.nil? && @args[:recordDir] == true
-      @csvAdd    = args[:csvMode] == :add
+      @ttdocdir  = @args[:ttdocdir]
+      @csvAdd    = !@args.nil? && args[:csvMode] == :add
       @csvMode   = @csvAdd ? 'a' : 'w'
       init
       @funcdoc   = {:class=>self.class, :blurb=>'Analyze Dashboard Worksheets', :description=>'Identifies the Worksheets present in Dashboards.',}
@@ -37,9 +38,9 @@ module Analysis
       @dashSheetsCSV  = CSV.open(docFileName,@csvMode)
       unless @csvAdd
         if @recordDir
-          @dashSheetsCSV  << ['Workbook','Modified','Dashboard','Worksheet','Hidden','Visible', 'Workbook Dir']
+          @dashSheetsCSV  << ['Rec #','Workbook','Workbook Modified','Workbook Modified','Dashboard','Worksheet','Hidden','Visible', 'Workbook Dir']
         else
-          @dashSheetsCSV  << ['Workbook','Modified','Dashboard','Worksheet','Hidden','Visible'                ]
+          @dashSheetsCSV  << ['Rec #','Workbook','Workbook Modified','Dashboard','Worksheet','Hidden','Visible'                ]
         end
       end
       addDocFile @dashSheetsCSV, docFileName, "Workbooks, Dashboards, and their Worksheets"
@@ -77,7 +78,7 @@ module Analysis
         dash.worksheets.each do |sheet|
           @sheetCount += 1
           emit "SHEET: #{sheet.name}"
-          recordCSV [@twbName, @twbDir, @modTime, dash.name, sheet.name, sheet.hidden, sheet.visible ]
+          recordCSV [@twbName, @modTime, dash.name, sheet.name, sheet.hidden, sheet.visible ]
         end
       end
     end

data/lib/twb/analysis/Sheets/sheetfieldsanalyzer.rb

@@ -44,6 +44,7 @@ module Analysis
     def initialize(**args)
       @args      = args
       @recordDir = !@args.nil? && @args[:recordDir] == true
+      @ttdocdir  = @args[:ttdocdir]
       @csvAdd    = args[:csvMode] == :add
       @csvMode   = @csvAdd ? 'a' : 'w'
       init
@@ -53,9 +54,9 @@ module Analysis
       @sheetFieldsCSV  = CSV.open(docFileName,@csvMode)
       unless @csvAdd
         if @recordDir
-          @sheetFieldsCSV  << ['Rec #', 'Workbook','Worksheet','Data Source','Data Source (tech)','Field','Field (tech)','Usage','Usage - code','Workbook Dir']
+          @sheetFieldsCSV  << ['Rec #','Workbook','Workbook Modified','Worksheet','Data Source','Data Source (tech)','Field','Field (tech)','Usage','Usage - code','Workbook Dir']
         else
-          @sheetFieldsCSV  << ['Rec #', 'Workbook','Worksheet','Data Source','Data Source (tech)','Field','Field (tech)','Usage','Usage - code'               ]
+          @sheetFieldsCSV  << ['Rec #','Workbook','Workbook Modified','Worksheet','Data Source','Data Source (tech)','Field','Field (tech)','Usage','Usage - code'               ]
         end
       end
       addDocFile @sheetFieldsCSV, docFileName, "Workbooks, Worksheets, and the Sheets' Data Sources and Fields"
@@ -76,6 +77,7 @@ module Analysis
 
     def processTWB twb
        @twb = twb
+       @modTime = @twb.modtime
        emit "   -- twb:: #{@twb.name}"
        @twbCnt += 1
        @twbDomainsLoaded = false
@@ -98,7 +100,7 @@ module Analysis
     def showFields sheet
       @sheetFields = Hash.new { |ds,fields| ds[fields] = Set.new }
       # recordCSV [@twb.name, @sheetName, nil, nil, nil, nil, nil]
-      puts "Sheet: #{@sheetName}"
+      emit "Sheet: #{@sheetName}"
       recordDBFields       sheet
       recordRCFields       sheet.rowFields, :row
       recordRCFields       sheet.colFields, :column
@@ -122,7 +124,7 @@ module Analysis
            emit "       f: #{sheetField}"
            emit "       c: #{sheetField.class}"
            fuiName = ds.fieldUIName sheetField #Fields[sheetField]
-           recordCSV [@twb.name, @sheetName, ds.uiname, dsName, sheetField.uiname, sheetField.name, 'DB ref', ftc('DB ref')]
+           recordCSV [@twb.name, @modTime, @sheetName, ds.uiname, dsName, sheetField.uiname, sheetField.name, 'DB ref', ftc('DB ref')]
         end
       end
     end
@@ -139,7 +141,7 @@ module Analysis
         emit "      ds: #{dsName}"
         emit "        - #{ds.uiname}"
         emit "        : #{ds.class}"
-        recordCSV [@twb.name, @sheetName, ds.uiname, dsName, fuiName, fldName, usage, ftc(usage)]
+        recordCSV [@twb.name, @modTime, @sheetName, ds.uiname, dsName, fuiName, fldName, usage, ftc(usage)]
       end
     end
 
@@ -150,7 +152,7 @@ module Analysis
             dsName  = field.dataSource
             ds      = @twb.datasource dsName
             fuiName = ds.fieldUIName field.name
-            recordCSV [@twb.name, @sheetName, ds.uiname, dsName, fuiName, field.name, type, ftc(type)]
+            recordCSV [@twb.name, @modTime, @sheetName, ds.uiname, dsName, fuiName, field.name, type, ftc(type)]
           end
         end
       end
@@ -161,7 +163,7 @@ module Analysis
       filters.each do |filter|
         dsName   = filter.dataSource.name
         dsUIName = filter.dataSource.uiname
-        recordCSV [@twb.name, @sheetName, dsUIName, dsName, filter.uiname, filter.name, 'filter', ftc('filter')]
+        recordCSV [@twb.name, @modTime, @sheetName, dsUIName, dsName, filter.uiname, filter.name, 'filter', ftc('filter')]
       end
     end
 
@@ -169,7 +171,7 @@ module Analysis
       sheet.pageFields.each do |pfield|
         ds = @twb.datasource pfield.dataSource
         fuiname = ds.fieldUIName pfield.name
-        recordCSV [@twb.name, @sheetName, ds.uiname, ds.name, fuiname, pfield.name, 'page', ftc('page')]
+        recordCSV [@twb.name, @modTime, @sheetName, ds.uiname, ds.name, fuiname, pfield.name, 'page', ftc('page')]
       end
     end
 
@@ -179,7 +181,7 @@ module Analysis
           ds       = @twb.datasource dsName
           dsUIName = ds.uiname
           ds.filters.each do |filter|
-            recordCSV [@twb.name, @sheetName, dsUIName, dsName, filter.uiname, filter.name, 'dsfilter', ftc('dsfilter')]
+            recordCSV [@twb.name, @modTime, @sheetName, dsUIName, dsName, filter.uiname, filter.name, 'dsfilter', ftc('dsfilter')]
           end
       end
     end
@@ -191,15 +193,15 @@ module Analysis
         dsuiname = ds.uiname
         fuiName  = ds.fieldUIName field.name
         recorded = @sheetFields.key?(dsuiname) && @sheetFields[dsuiname].include?(fuiName)
-        puts "      # #{@sheetFields.inspect}"
-        puts "      - %-6s  %-25s  -> %-s" % [recorded, dsuiname, fuiName]
+        emit "      # #{@sheetFields.inspect}"
+        emit "      - %-6s  %-25s  -> %-s" % [recorded, dsuiname, fuiName]
         unless recorded
-          recordCSV [@twb.name, @sheetName, dsuiname, dsName, fuiName, field.name, 'slice', ftc('slice')]
-          puts "      - recorded"
+          recordCSV [@twb.name, @modTime, @sheetName, dsuiname, dsName, fuiName, field.name, 'slice', ftc('slice')]
+          emit "      - recorded"
         end
-        puts "--"
+        emit "--"
       end
-      puts "\n "
+      emit "\n "
     end
 
     def recordCSV record

data/lib/twb/analysis/Sheets/sheetfiltersanalyzer.rb

@@ -27,7 +27,9 @@ module Analysis
 
     def initialize(**args)
       @args      = args
+      # puts "@args: #{@args}"
       @recordDir = !@args.nil? && @args[:recordDir] == true
+      @ttdocdir  = @args[:ttdocdir]
       @csvAdd    = args[:csvMode] == :add
       @csvMode   = @csvAdd ? 'a' : 'w'
       init
@@ -37,9 +39,9 @@ module Analysis
       @sheetFieldsCSV  = CSV.open( docFileName,@csvMode)
       unless @csvAdd
         if @recordDir
-          @sheetFieldsCSV  << ['Rec #','Workbook','Worksheet','Filter Type','Operation','Data Source','Field','Value','Alias', 'Alias?','Operation Mode','Include Null?','Kind','Workbook Dir']
+          @sheetFieldsCSV  << ['Rec #','Workbook','Workbook Modified','Worksheet','Filter Type','Operation','Data Source','Field','Value','Alias', 'Alias?','Operation Mode','Include Null?','Kind','Workbook Dir']
         else
-          @sheetFieldsCSV  << ['Rec #','Workbook','Worksheet','Filter Type','Operation','Data Source','Field','Value','Alias', 'Alias?','Operation Mode','Include Null?','Kind']
+          @sheetFieldsCSV  << ['Rec #','Workbook','Workbook Modified','Worksheet','Filter Type','Operation','Data Source','Field','Value','Alias', 'Alias?','Operation Mode','Include Null?','Kind']
         end
       end
       addDocFile @sheetFieldsCSV, docFileName, "Workbooks, Worksheets and the sheets' Quick Filters"
@@ -60,6 +62,7 @@ module Analysis
        @twb     = twb
        @twbName = @twb.name
        @twbDir  = @twb.dir
+       @modTime = @twb.modtime
        emit "   -- #{@twbName}"
        @twbDomainsLoaded = false
        parseFilters
@@ -74,14 +77,14 @@ module Analysis
           filter.emit "-----------------------------\nWORKSHEET:: #{sheet.name}\n-----------------------------"
           if filter.values.empty?
           # @sheetFieldsCSV  << ['Workbook','Worksheet','Filter Type','Operation'     ,'Data Source','Field','Value','Alias', 'Alias?']
-            recordCSV [@twbName, sheet.name, filter.type, filter.inexclude, filter.dataSource.uiname, filter.uiname, nil,   nil,    nil,  filter.inexMode, filter.includeNull, filter.kind]
+            recordCSV [@twbName, @modTime, sheet.name, filter.type, filter.inexclude, filter.dataSource.uiname, filter.uiname, nil,   nil,    nil,  filter.inexMode, filter.includeNull, filter.kind]
           end
           filter.values.each do |valueMap|
             value  = valueMap[:value]
             valias = valueMap[:alias]
             same   = value.eql? valias
             emit "RECORDING FILTER VALUES:  %-35s  --  %-25s  same? %s " % [value,valias,same]
-            recordCSV [@twbName, sheet.name, filter.type, filter.inexclude, filter.dataSource.uiname, filter.uiname, value, valias, same, filter.inexMode, filter.includeNull, filter.kind]
+            recordCSV [@twbName, @modTime, sheet.name, filter.type, filter.inexclude, filter.dataSource.uiname, filter.uiname, value, valias, same, filter.inexMode, filter.includeNull, filter.kind]
           end
         end
       end

data/lib/twb/analysis/WorkbookSummaryAnalyzer.rb

@@ -0,0 +1,97 @@
+#  sheetfieldsanalyzer.rb Copyright (C) 2018  Chris Gerrard
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU General Public License as published by
+#  the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.  
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License
+#  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'twb'
+require 'csv'
+
+module Twb
+module Analysis
+
+  class WorkbookSummaryAnalyzer
+
+    include TabTool
+
+    attr_accessor :localEmit
+
+    def initialize(**args)
+      @args      = args
+      @recordDir = !@args.nil? && @args[:recordDir] == true
+      @ttdocdir  = @args[:ttdocdir]
+      @csvAdd    = !@args.nil? && args[:csvMode] == :add
+      @csvMode   = @csvAdd ? 'a' : 'w'
+      init
+      @funcdoc   = {:class=>self.class, :blurb=>'Analyze Workbooks', :description=>'Workbook summary data: # Data Sources; Dashboards; Sheets; etc.'}
+      #--
+      docFileName     = docFile('WorkbookSummary.csv')
+      addDocFile @dashSheetsCSV, docFileName, "Workbook summary data."
+      @dashSheetsCSV  = CSV.open(docFileName,@csvMode)
+      unless @csvAdd
+        csvHeader       = ['Rec #', 'Workbook','Type','Version','Build','Modified','# Data Sources','# Dashboards','# Worksheets']
+        if @recordDir
+          csvHeader.push('Workbook Directory')
+        end
+        @dashSheetsCSV  << csvHeader 
+      end
+      #--
+      @twbCount    = 0
+      @dashCount   = 0
+      @dsCount     = 0
+      @sheetCount  = 0
+      @recNum      = 0
+    end
+
+    def metrics
+      {
+        '# of Workbooks'    => @twbCount,
+        '# of Data Sources' => @dsCount,
+        '# of Dashboards'   => @dashCount,
+        '# of Worksheets'   => @sheetCount
+      }
+    end
+
+    def processTWB twb
+       @twb     = twb
+       emit "   -- #{@twbName}"
+       recordCSV [ @twb.name,
+                   @twb.type, 
+                   @twb.version, 
+                   @twb.build, 
+                   @twb.modtime, 
+                   @twb.datasources.length,
+                   @twb.dashboards.length,
+                   @twb.worksheets.length
+                 ]
+       @twbCount   += 1
+       @dsCount    += @twb.datasources.length
+       @dashCount  += @twb.dashboards.length
+       @sheetCount += @twb.worksheets.length
+       finis
+    end
+
+    private
+
+      def recordCSV record
+        numberedRec = [@recNum+=1] + record
+        if @recordDir
+          @dashSheetsCSV  << numberedRec.push(@twb.dir)
+        else
+          @dashSheetsCSV  << numberedRec
+        end
+      end
+
+  end #class SheetFieldsAnalyzer
+
+end # module Analysis
+end # module Twb

data/lib/twb/tabtool.rb

@@ -25,9 +25,10 @@ module TabTool
   @@TTDOCDIR    = './ttdoc'
   @configFile = './ttconfig.yml'
 
-  attr_accessor :ttdocdir, :logger,   :loglevel, :logfilename
-  attr_accessor :uuid,     :type,     :id,       :properties
-  attr_reader   :licensed, :funcdoc,  :docfiles, :metrics,    :alerts 
+  attr_accessor :ttdocdir,  :docDir,   :docfiles
+  attr_accessor :ttdocdir,  :logger,   :loglevel,  :logfilename
+  attr_accessor :uuid,      :type,     :id,        :properties
+  attr_reader   :licensed,  :funcdoc,  :metrics,   :alerts 
 
   @funcdoc     = {:class=>nil, :blurb=>nil, :description=>nil,}
   @docfiles    = []  # should be of form [{:name=>'docFileName',:description=>'doc file description'}]
@@ -43,12 +44,23 @@ module TabTool
     initLogger
   end
 
+  def ttdocdir= docdir
+    # puts "def ttdocdir= #{docdir}" 
+    @ttdocdir = docdir
+    init
+  end
+
   def initDocDir
+    # puts "def initDocDir" 
     # return if @@TTDOCDIR.nil?
     # return if ''.eql?($ttdocdir) && ''.eql?(@@TTDOCDIR)
-    @docDir = @@TTDOCDIR
+    @docDir = @ttdocdir.nil? ? @@TTDOCDIR : @ttdocdir
+    # puts "   @@TTDOCDIR: #{@@TTDOCDIR}"
+    # puts "    @ttdocdir: #{@ttdocdir}"
+    # puts "    @docDir  : #{@docDir}"
+    # puts ""
     return if Dir.exists?(@docDir)
-    if File.exists? @docDir
+    if File.exists? @docDir  # on the off chance that the doc dir is already present as a file
       @docDir = ''
     else
       Dir.mkdir @docDir
@@ -154,10 +166,19 @@ module TabTool
   # end
 
   def initCSV(fileName, desc=nil, header=nil)
+    emit "def initCSV"
     csvName =  docFile(fileName)
-    emit "init CSV #{csvName}"
+    emit "     @recordDir: #{@recordDir.nil?} \t :: #{@recordDir}"
+    emit "         header: #{@header.nil?} \t :: #{header}"
+    emit "        csvName: #{csvName.nil?} :: #{csvName}"
     csvFile = CSV.open(csvName, 'w')
-    csvFile << header unless header.nil?
+    unless header.nil?
+      if @recordDir
+        csvFile << header.push('Workbook Directory')
+      else
+        csvFile << header
+      end
+    end
     addDocFile csvFile, csvName, desc
     return csvFile
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twb
 version: !ruby/object:Gem::Version
-  version: 4.4.4
+  version: 4.4.6
 platform: ruby
 authors:
 - Chris Gerrard
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-14 00:00:00.000000000 Z
+date: 2019-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: creek
@@ -81,6 +81,7 @@ files:
 - lib/twb/analysis/Sheets/sheetfiltersanalyzer.rb
 - lib/twb/analysis/Sheets/sheetfiltersanalyzerA.rb
 - lib/twb/analysis/Sheets/sheetsourcesanalyzer.rb
+- lib/twb/analysis/WorkbookSummaryAnalyzer.rb
 - lib/twb/calculatedfield.rb
 - lib/twb/codedfield.rb
 - lib/twb/columnfield.rb