tableautools 0.0.1

data/README.md

@@ -0,0 +1,39 @@
+# TWB - The Tableau Tools Ruby gem.
+
+This gem provides a collection of classes to manage Tableau workbooks and their major components.
+It's the result of years of writing similar code.
+
+## Philosophy
+
+Tableau Workbook governance should be:
+- simple and straightforward in the way that basic data analysis is simple and straightforward in Tableau,
+- free, as in beer and speech, and
+- constantly evolving to incorporate new and interesting things people can think of to see about do with their Workbooks.
+
+Tableau Tools are designed in the model of mini-tools, small independent tools that are individually useful and can be
+used together to accomplish broader tasks.
+
+The gem is released to the Tableau community in the hope that it will prove to be useful and valuable,
+that people will build useful things with it, and that they will offer improvements and extensions to it.
+
+## History and rationale
+
+A number of Ruby scripts that parse Workbooks and emit a variety of their contents/properties have been published at Tableau Friction, including a couple that identify Calculated fields and the fields they reference:
+http://tableaufriction.blogspot.ca/2015/02/more-calculated-field-analysis-fields.html
+http://tableaufriction.blogspot.ca/2014/09/do-you-know-what-your-calculated-fields.html
+
+Other scripts find and record other useful information, still others enable Workbook management, e.g. unhiding worksheets and making field comments consistent across workbook.
+One of them produces HTML pages with dynamic dashboard wire frames, making it easy to see what's in the dashboards and their properties
+
+
+## Historical: TWIS - The Tableau Workbook Inventory System
+There's also TWIS - the Tableau Workbook Inventory System, an application that parses workbooks and extracts most of their
+important elements into CSV files, allowing one to see things such as which sheets are in which with dashboards,
+the data sources they connect to, and which Workbooks they're in.
+TWIS also generates diagrams/maps of the Workbook - Dashboard - Worksheet - Data Source relationships, one for each Workbook in PDF, PNG, and SVG.
+
+TWIS is described and available here: http://betterbi.biz/TWIS.html
+
+#### TWIS is deprecated, no longer maintained
+
+I created TWIS in Java, beginning in 2007. It was very valuable but became exceedingly difficult to maintain.

data/lib/tableautools.rb

@@ -0,0 +1,22 @@
+#  Copyright (C) 2014, 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_relative 'tableautools/utilities/anonymizer'
+
+# Represents Tableau Workbooks and their contents.
+#
+module TableauTools
+  VERSION = '0.0.1'
+end

data/lib/tableautools/utilities/anonymizer.rb

@@ -0,0 +1,86 @@
+require 'csv'
+
+module TableauTools
+
+  class Anonymizer
+
+    attr_reader   :anonWords, :low, :high
+    attr_accessor :input, :output, :field
+
+    @minWords = 2
+    @maxWords = 4
+
+    @@anonymousText = <<ANONTEXT
+    Lorem ipsum dolor sit amet consectetur adipiscing elit Mauris urna erat volutpat a ullamcorper sit amet 
+    convallis quis dui Ut sem erat euismod in iaculis id tincidunt aliquam magna Vivamus lobortis eu erat in feugiat 
+    Vestibulum fermentum dictum fermentum Class aptent taciti sociosqu ad litora torquent per conubia nostra 
+    per inceptos himenaeos Ut quis rutrum mi Mauris sit amet cursus nisi Suspendisse accumsan leo ac lobortis egestas 
+    sapien eros mattis lorem eu posuere mi justo in nunc Sed felis ligula egestas vel nulla sed egestas lobortis justo
+    Donec quis interdum velit Proin felis arcu vestibulum non augue nec ultricies pulvinar velit Nunc ac libero velit 
+    Aenean bibendum varius nisi ut molestie Nam tempus nec lacus eget malesuada Donec et accumsan dolor et ullamcorper ante 
+    Etiam quis consectetur leo Suspendisse mattis sagittis imperdiet Phasellus facilisis eget justo ac mollis 
+    Phasellus eleifend tortor est sit amet venenatis enim fringilla id Vestibulum rutrum tempus tortor ac volutpat 
+    Nullam non imperdiet lorem Cras tincidunt porttitor condimentum Pellentesque tincidunt magna id aliquet interdum augue 
+    nisl convallis enim volutpat mollis urna metus et lacus Donec tortor sapien ultrices sit amet blandit quis gravida ut 
+    massa Mauris mauris lacus pretium sit amet risus quis blandit viverra lorem Nunc fringilla elit a elementum gravida 
+    Duis vel sodales elit eget tempor leo Quisque in semper nisl Fusce eget risus sollicitudin molestie diam et tincidunt 
+    sem Curabitur accumsan pretium interdum Suspendisse semper enim ac augue hendrerit vel sollicitudin diam mollis 
+    Curabitur lacinia ante nec eros maximus a vehicula velit aliquet In ullamcorper nec ante eu dictum Proin mi enim 
+    malesuada ut ornare sit amet maximus commodo ipsum Nullam venenatis purus non sollicitudin sollicitudin augue 
+    augue euismod lorem ut hendrerit velit neque sed nibh Class aptent taciti sociosqu ad litora torquent per conubia 
+    nostra per inceptos himenaeos Proin ac elementum nisl
+ANONTEXT
+
+    @codedWords = {}
+
+    def initialize
+      @anonWords = @@anonymousText.gsub(/\n/,' ').split
+      @coded = {}
+      @low   = 0
+      @limit = @anonWords.length-1
+      @rand  = Random.new
+      @minWords = 2
+      @maxWords = 4
+    end
+
+    def anonymize(input, fields,  output)
+      puts "Anonymizing %-25s  to  %-25s  - %s " % [input, output, fields.inspect]
+      raise 'The input file must be specified' if     input.nil?
+      raise 'The input file must exist'        unless File.exist?(input)
+      raise 'The field(s) to anonymize must be provided as a String or an array of Strings' unless fields.instance_of?(String) || fields.instance_of?(Array)
+      @input    = input
+      @output   = output
+      @anonVals = {}
+      csvFields = CSV.open(@input, &:readline) 
+      output    = CSV.open(@output,'w')
+      output << csvFields
+      fields = [fields] if fields.is_a? String
+      CSV.foreach('input.csv', :headers => true) do |row|
+        fields.each do |field|
+          row[field] = anonWords(row[field]) unless row[field].nil?
+        end
+        output << row
+      end
+    end
+
+    def anonWords value
+      return @anonVals[value] unless @anonVals[value].nil?
+      range = rand(@minWords..@maxWords)
+      limit = @limit - range 
+      first = rand(range..limit)
+      last  = first + range - 1
+      words = @anonWords[first..last].join(' ')
+      @anonVals[value] = words
+    end
+
+    def codeValue value
+      if @codedWords[value].nil?
+        @codedWords[value] = anonWords
+      end
+      @codedWords[value]
+    end
+
+
+  end # class Anonymizer
+
+end # module utility

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: tableautools
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Chris Gerrard
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-02-01 00:00:00.000000000 Z
+dependencies: []
+description: A collection of Ruby classes designed for accessing and recording information
+  about, producing documentation about, and for manipulating Tableau Workbooks and
+  their contents.
+email: Chris@Gerrard.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- LICENSE.txt
+- README.md
+- lib/tableautools.rb
+- lib/tableautools/utilities/anonymizer.rb
+homepage: http://rubygems.org/gems/tableautools
+licenses:
+- GPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: Classes for analyzing, documenting, and managing Tableau Workbooks.
+test_files: []