parliamentarian 0.8.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9cd38f5cb99774b5aacfa8074a76cace5f9e68e1fca7939242fdccdea7dac42e
+  data.tar.gz: 1c8ebbec3a095b89f0250ba39620ef1fc2c7f0878aecb235dd867853983bf35d
+SHA512:
+  metadata.gz: f5e3702bec1c772317f3fd86a1893b964ba3ea5dbf00ff24ff61d240719b2c8ced76f4dbc1b8e35f5821f4a3612f42dc990c4613366fff915a2f73ad57bea971
+  data.tar.gz: b1bb5f7dc7ccca8ab0a898057df147573e4d4540acec4ec6821713f5565997733673cc783a0fe225b8d166e983784fbeee10d43cfb770d8ff333d001ecb3b716

data/lib/Array/blankQ.rb

@@ -0,0 +1,13 @@
+# Array#blank?
+# Array#blankQ
+
+# 20100308
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class Array
+  
+  alias_method :blank?, :empty?
+  
+end

data/lib/Array/extract_optionsX.rb

@@ -0,0 +1,14 @@
+# Array#extract_options!
+
+# 20090123
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class Array
+  
+  def extract_options!
+    last.is_a?(::Hash) ? pop : {}
+  end
+  
+end

data/lib/Array/peek_options.rb

@@ -0,0 +1,14 @@
+# Array#peek_options
+
+# 20100308
+# 0.1.0
+
+# History: Originally called #extract_options (no exclamation mark), but written again a few days ago for Switches as #peek_options.  #extract_options has been moved to #extract_options! as an alias for it.  
+
+class Array
+  
+  def peek_options
+    last.is_a?(::Hash) ? last : {}
+  end
+  
+end

data/lib/Array/to_csv.rb

@@ -0,0 +1,41 @@
+# Array#to_csv
+
+# 20111211
+# 0.9.9
+
+# Todo: 
+# 1. Split all these up and move each method into Array...  Done as of 0.9.0.  
+# 2. ~ Array#to_csv, massive refactor, including getting rid of a lot of aliases for now at least.  Done as of 0.9.0.  
+
+# Changes since 0.8: 
+# 1. Has it's own file now.  
+# 0/1
+# 2. Removed all the require lines for the array methods since these are simple operations.  So, I am now doing the quoting directly, since quote_each() which calls wrap_each() which in turn calls wrap() is lots of extra method calls.  
+# 2/3
+# 3. + require '_meta/default_to' && making use of it in the case test, since if I explicitly supply nil, then the quote is not set to double in the argument definition.  
+# 3/9
+# 4. Version number bump to 0.9.9.  
+# 5. /+ e +/+ e.to_s +/.  
+
+require '_meta/default_to'
+
+class Array
+  
+  def to_csv(quote = :double)
+    case quote.default_to(:double).to_sym
+    when :double
+      self.collect{|e| '"' + e.to_s + '"'}.join(',')
+    when :spacey_double
+      self.collect{|e| '"' + e.to_s + '"'}.join(', ')
+    when :single
+      self.collect{|e| "'" + e.to_s + "'"}.join(',')
+    when :spacey_single
+      self.collect{|e| "'" + e.to_s + "'"}.join(', ')
+    when :none, :unquoted
+      self.join(',')
+    when :spacey_none, :spacey_unquoted
+      self.join(', ')
+    end
+  end
+  
+end

data/lib/FalseClass/blankQ.rb

@@ -0,0 +1,15 @@
+# FalseClass#blank?
+# FalseClass#blankQ
+
+# 20100308
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class FalseClass
+  
+  def blank?
+    true
+  end
+  
+end

data/lib/Hash/blankQ.rb

@@ -0,0 +1,13 @@
+# Hash#blank?
+# Hash#blankQ
+
+# 20100308
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class Hash
+  
+  alias_method :blank?, :empty?
+  
+end

data/lib/Hash/to_csv.rb

@@ -0,0 +1,34 @@
+# Hash#to_csv
+
+# 2010.05.21
+# 0.9.1
+
+# Changes: 
+# 1. - Hash#write.  
+# 2. ~ Hash#to_csv, a significant reduction in complexity.  
+# 0/1
+# 3. /desired_columns/selected_columns/.  
+
+# Todo: 
+# 1. Split all these up and move each method into Array...  Done as of 0.9.0.  
+# 2. Tidy the splat stuff with that technique from recently!?...  Done/made redundant as of 0.9.0.  
+
+require 'Array/extract_optionsX'
+require 'Array/to_csv'
+
+class Hash
+  
+  def to_csv(*args)
+    options = args.extract_options!
+    quote = options[:quote]
+    selected_columns = options[:selected_columns]
+    collector = []
+    if selected_columns
+      selected_columns.each{|column| collector << self[column]}
+    else
+      self.each{|k,v| collector << self[v]}
+    end
+    collector.to_csv(quote)
+  end
+  
+end

data/lib/NilClass/blankQ.rb

@@ -0,0 +1,15 @@
+# NilClass#blank?
+# NilClass#blankQ
+
+# 20100308
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class NilClass
+  
+  def blank?
+    true
+  end
+  
+end

data/lib/NilClass/default_to.rb

@@ -0,0 +1,25 @@
+# NilClass/default_to.rb
+# NilClass#default_to
+
+# 20140524
+# 0.2.0
+
+# Description: Used in concert with Object#default_to, NilClass#default_to will assign a default value to a variable if that variable is nil, or if it isn't nil Object#default_to will return the value of the variable already set.  
+
+# History: Taken from Switches 0.9.9.
+
+# Changes:
+# 1. - alias_method :default, since the complement, Object#default_to, was clashing with the ruby mail gem.
+# 2. + require 'Object/default_to', since these two are supposed to work together.
+
+require 'Object/default_to'
+
+class NilClass
+
+  def default_to(o)
+    o
+  end
+  alias_method :defaults_to, :default_to
+  alias_method :default_is, :default_to
+
+end

data/lib/Numeric/blankQ.rb

@@ -0,0 +1,15 @@
+# Numeric#blank?
+# Numeric#blankQ
+
+# 20100308
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class Numeric
+  
+  def blank?
+    false
+  end
+  
+end

data/lib/Object/blankQ.rb

@@ -0,0 +1,18 @@
+# Object#blankQ
+# Object#blank?
+
+# 2010.04.04
+# 0.0.1
+
+# History: Stolen wholesale from a recent version of ActiveSupport.  
+
+# Changes: 
+# 1. Now using a more recent version from ActiveSupport.  This more recent version from ActiveSupport is likely more efficient and slightly more succinct.  
+
+class Object
+  
+  def blank?
+    respond_to?(:empty?) ? empty? : !self
+  end
+  
+end

data/lib/Object/default_to.rb

@@ -0,0 +1,25 @@
+# Object/default_to.rb
+# Object#default_to
+
+# 20140524
+# 0.2.0
+
+# Description: Enables a slightly more powerful assignment mechanism than does ||=, such that it will assign a default value to a variable if the parameterized source is nil, whereas ||= will only assign to the paramterized source if the variable is not already set.
+
+# History: Taken from Switches 0.9.9.
+
+# Changes:
+# 1. - alias_method :default, since it was clashing with the ruby mail gem.
+# 2. + require 'NilClass/default_to', since these two are supposed to work together.
+
+require 'NilClass/default_to'
+
+class Object
+
+  def default_to(o)
+    self
+  end
+  alias_method :defaults_to, :default_to
+  alias_method :default_is, :default_to
+
+end

data/lib/Parliamentarian.rb

@@ -0,0 +1,31 @@
+# Parliamentarian.rb
+# Parliamentarian
+
+# 20210408
+# 0.8.5
+
+# Changes since 0.7:
+# 0: Paramterised the location of the CSV files so that it can be a local file or the original URL by default with a view to making use of those files as fixtures for tests.
+# 1. ~ Australia::Federal.fetch, .senators, .members, so that one is able to supply a csv file location.
+# 2. ~ Australia::Victoria.fetch, .legislative_councillors, .legislative_assemblymen, so that one is able to supply a csv file location.
+# 3. Removed the self-run sections from Australia::Federal and Australia::Victoria with proper tests in their stead.
+# 4. + ./test
+# 0/1
+# 5. /require 'SimpleCSV.rbd'/SimpleCSV/require 'SimpleCSV'/
+# 1/2
+# 6. Swapped Victorian councillors and assemblymen URLs as they were the reverse of what they should be.
+# 7. /legislative_assemblymen/legislative_assemblymembers/, so as to be consistent with the CSV filename being downloaded.
+# 2/3
+# 8. Underscored all the dynamically created methods for each of the column names in the CSV files.
+# 3/4
+# 9. Missed some aliases when underscoring in the previous version.
+# 4/5
+# 10. + VERSION file
+# 11. + parliamentarian.gemspec
+# 12. ~ Gemfile to include webmock.
+# 13. + required lib files (to be broken out later.)
+
+lib_dir = File.dirname(File.expand_path(__FILE__))
+$LOAD_PATH.unshift(lib_dir) unless $LOAD_PATH.include?(lib_dir)
+
+require_relative 'Parliamentarian/Australia'

data/lib/Parliamentarian/Australia.rb

@@ -0,0 +1,4 @@
+# Parliamentarian/Australia.rb
+
+require_relative 'Australia/Federal'
+require_relative 'Australia/Victoria'

data/lib/Parliamentarian/Australia/Federal.rb

@@ -0,0 +1,95 @@
+# Parliamentarian/Australia/Federal.rb
+# Parliamentarian::Australia::Federal
+
+require 'open-uri'
+require 'SimpleCSV'
+require 'String/underscore'
+
+module Parliamentarian
+  module Australia
+    class Federal
+
+      SENATE_URL = 'https://www.aph.gov.au/~/media/03%20Senators%20and%20Members/Address%20Labels%20and%20CSV%20files/Senators/allsenel.csv?la=en'
+      HOUSE_OF_REPRESENTATIVES_URL = 'https://www.aph.gov.au/~/media/03%20Senators%20and%20Members/Address%20Labels%20and%20CSV%20files/SurnameRepsCSV.csv?la=en'
+
+      class << self
+
+        def fetch(csv_file_location)
+          raw_csv = if ['http', 'https'].include?(URI.parse(csv_file_location).scheme)
+            URI.open(csv_file_location)
+          else
+            File.read(csv_file_location)
+          end
+          SimpleCSV.read(raw_csv, headers: true)
+        end
+
+        def all(senators_csv_file_location = nil, members_csv_file_location = nil)
+          @all ||= (senators(senators_csv_file_location) + house_of_representatives(members_csv_file_location)).flatten
+        end
+
+        def senators(csv_file_location = nil)
+          @senators ||= (
+            csv_file_location = csv_file_location || SENATE_URL
+            fetch(csv_file_location).collect{|row| self.new(row)}
+          )
+        end
+        alias_method :senate, :senators
+
+        def members(csv_file_location = nil)
+          @members ||= (
+            csv_file_location = csv_file_location || HOUSE_OF_REPRESENTATIVES_URL
+            fetch(csv_file_location).collect{|row| self.new(row)}
+          )
+        end
+        alias_method :house_of_representatives, :members
+
+      end # class << self
+
+      def initialize(row)
+        row.keys.each do |header|
+          attr_name = self.attr_name(header)
+          self.class.send(:attr_accessor, attr_name)
+          self.send("#{attr_name}=", row[header])
+        end
+        synthesize_email_address
+      end
+
+      # For consistency with Australia::Victoria and vice-versa...
+      def firstname; first_name; end
+      def lastname; surname; end
+      def last_name; surname; end
+
+      def postcode
+        @electorate_postcode
+      end
+
+      # predicate methods
+
+      def senator?
+        salutation == 'Senator'
+      end
+
+      def member?
+        !senator?
+      end
+
+      private
+
+      def attr_name(header)
+        header.underscore
+      end
+
+      def synthesize_email_address
+        self.class.send(:attr_accessor, 'email')
+        self.email = (
+          if senator?
+            "senator.#{surname.downcase}@aph.gov.au"
+          else
+            "#{first_name}.#{surname}.MP@aph.gov.au"
+          end
+        )
+      end
+
+    end
+  end
+end

data/lib/Parliamentarian/Australia/Victoria.rb

@@ -0,0 +1,74 @@
+# Parliamentarian/Australia/Victoria.rb
+# Parliamentarian::Australia::Victoria
+
+require 'open-uri'
+require 'SimpleCSV'
+require 'String/underscore'
+
+module Parliamentarian
+  module Australia
+    class Victoria
+
+      LEGISLATIVE_COUNCIL_URL = 'https://www.parliament.vic.gov.au/images/members/councilmembers.csv'
+      LEGISLATIVE_ASSEMBLY_URL = 'https://www.parliament.vic.gov.au/images/members/assemblymembers.csv'
+
+      class << self
+
+        def fetch(csv_file_location)
+          raw_csv = if ['http', 'https'].include?(URI.parse(csv_file_location).scheme)
+            URI.open(csv_file_location)
+          else
+            File.read(csv_file_location)
+          end
+          SimpleCSV.read(raw_csv, headers: true)
+        end
+
+        def all(legislative_councillors_csv_file_location = nil, legislative_assemblymembers_csv_file_location = nil)
+          @all ||= (legislative_councillors(legislative_councillors_csv_file_location) + legislative_assemblymembers(legislative_assemblymembers_csv_file_location)).flatten
+        end
+
+        def legislative_councillors(csv_file_location = nil)
+          @legislative_council ||= (
+            csv_file_location = csv_file_location || LEGISLATIVE_COUNCIL_URL
+            fetch(csv_file_location).collect{|row| self.new(row)}
+          )
+        end
+
+        def legislative_assemblymembers(csv_file_location = nil)
+          @legislative_assembly ||= (
+            csv_file_location = csv_file_location || LEGISLATIVE_ASSEMBLY_URL
+            fetch(csv_file_location).collect{|row| self.new(row)}
+          )
+        end
+
+      end # class << self
+
+      def initialize(row)
+        row.keys.each do |header|
+          attr_name = self.attr_name(header)
+          self.class.send(:attr_accessor, attr_name)
+          self.send("#{attr_name}=", row[header])
+        end
+        extract_postcode_from_electorate_office_address
+      end
+
+      # For consistency with Australia::Federal and vice-versa...
+      def firstname; preferred_name; end
+      def first_name; preferred_name; end
+      def surname; last_name; end
+      def lastname; last_name; end
+
+      private
+
+      def attr_name(header)
+        header.underscore
+      end
+
+      def extract_postcode_from_electorate_office_address
+        self.class.send(:attr_accessor, 'postcode')
+        self.postcode = eo_address.split.last
+      end
+
+    end
+  end
+end

data/lib/Parliamentarian/VERSION.rb

@@ -0,0 +1,5 @@
+class Parliamentarian
+
+  VERSION = '0.8.5'
+
+end

data/lib/SimpleCSV.rb

@@ -0,0 +1,389 @@
+# SimpleCSV.rb
+# SimpleCSV
+
+# 20200606
+# 0.10.3
+
+# Description: A CSV object for reading and writing CSV (and similar) text files with tabulated data to and from files and strings.
+
+# Todo:
+# 1. Have it be able to read mixed CSV files.  Done as of 0.9.0.
+# 2. Have it be able to read escaped and quoted delimeters.
+# 3. Separate out the different classes into separate files.  Done as of 0.8 I think, but taken further with 0.9.
+# 4. Create a gem and/or Rubylibify and/or
+# 5. Optionally do line counts.
+# 6. Optionally do column count checks.
+# 7. Optionally do data consistency checks for column length, type, and anything else that makes sense.
+# 8. Put the option to specify quoting into to_csv and possibly remove it from #init.  Done as of at least 0.8.
+# 9. Remove underscores when outputting the header line, but only if they were added---and only if they're wanting to be removed?...  As of 0.9.0, I just use strings anyway.
+# 10. Reorder the conditionals in #write_line and #write_header.  Done as of 0.9.0.
+# 11. Simplify some more!  Done as of 0.9.1.
+
+# Ideas:
+# 1. Standardize on either symbols or strings for column names, since presently one has to be consistent.  It would be nicer to be able to mix and match---if possible.
+# 2. Automatically detect as to whether there is a header line by taking the first line and comparing the types (alpha, numeric, alpha-numeric, etcetera) with each of the column values with those of the subsequent 2 or 3 or so lines and if there is a correspondence, then assume that there is a header line.  This would mean that the assumption that there is would change and that if the guess was wrong that it would need to be made explict.
+# 3. Have it #read a file automatically if any of 'r' or 'r+' or 'w+' is given as the mode.
+# 4. Finally try to make use of Index instead of Hash, since that library file is still hanging around.  Using this class may be simpler but not faster than using Hash and Array.
+
+# Bugs:
+# 1. This did cope with commas within a quoted CSV file, however while I think I broke this again with 0.9.0, I'm not sure that I ever had it working properly.  It works properly as of 0.9.3 at least.
+# 2. Does SimpleCSV#write_row handle it if there are no attributes/columns defined?  It needs to work with CSV files with no column names.
+
+# Changes since 0.9:
+# 1. - SimpleCSV.rbd directory, moving everything up a directory, and SimpleCSV.rb inside the lib directory, so it now adheres to a more conventional Ruby library structure. May re-introduce .rbd, self-contained Ruby libraries one day, but will need to have the require overload work correctly and be able to load .rbd files correctly when presented. This may have changed sometime in the past quite a few years...
+# 2. + ./Kernel/silently.rb which was used in the speed testing file, but had never been incorporated into the lib directory as it should.
+# 0/1
+# 3. - ./test until such time as they are half-decent, which they have never been!
+# 1/2
+# 4. Separated CSVFile and CSVString into their own files.
+# 5. require 'stringio' --> CSVString.rb
+# 2/3
+# 6. /CSVFile/SimpleCSV::File/
+# 7. /CSVString/SimpleCSV::String/
+# 8. Ensured that there are a number of leading class colon separators (::) in strategic places!
+
+$LOAD_PATH.unshift(File.expand_path('..', __FILE__))
+
+require '_meta/blankQ'
+require 'Array/extract_optionsX'
+require 'Array/peek_options'
+require 'Array/to_csv'
+require 'Hash/to_csv'
+require 'String/split_csv'
+
+require 'SimpleCSV/File'
+require 'SimpleCSV/String'
+
+class SimpleCSV
+
+  class << self
+
+    def source_type(source)
+      if ::File.exist?(source)
+        SimpleCSV::File
+      else
+        SimpleCSV::String
+      end
+    end
+
+    def open(source, *args, &block)
+      @csv_file = new(source, *args)
+      if block
+        begin
+          yield @csv_file
+          @csv_file
+        ensure
+          @csv_file.close
+        end
+      else
+        @csv_file
+      end
+    end
+
+    def each(source, *args, &block)
+      new(source, *args).each(&block)
+    end
+    alias_method :foreach, :each
+
+    def collect(source, *args, &block)
+      new_collection = []
+      each(source, *args){|row| new_collection << block.call(row)}
+      new_collection
+    end
+    alias_method :map, :collect
+
+    def select(source, *args, &block)
+      new_collection = []
+      each(source, *args){|row| new_collection << row if block.call(row)}
+      new_collection
+    end
+    alias_method :find_all, :select
+
+    def reject(source, *args, &block)
+      new_collection = []
+      each(source, *args){|row| new_collection << row unless block.call(row)}
+      new_collection
+    end
+
+    def detect(source, *args, &block)
+      each(source, *args){|row| return row if block.call(row)}
+    end
+    alias_method :find, :detect
+
+    def read(source, *args, &block)
+      if block
+        parse(source, *args, &block)
+      else
+        new(source, *args).read_csv
+      end
+    end
+    alias_method :read_csv, :read
+
+    def parse(source, *args, &block)
+      if block
+        each(source, *args, &block)
+      else
+        read(source, *args)
+      end
+    end
+    alias_method :parse_csv, :parse
+
+    def write(source, *args)
+      new(source, *args).write_csv
+    end
+    alias_method :write_csv, :write
+
+    def header_row(source, *args)
+      new(source, *args).header_row
+    end
+
+    def first_row(source, *args)
+      new(source, *args).first_row
+    end
+
+    def attributes(source, *args)
+      new(source, *args).attributes
+    end
+
+    def columns(source, *args)
+      new(source, *args).columns
+    end
+
+    def parse_line(raw_row, *args) # For FasterCSV compatibility.
+      options = args.extract_options!
+      row_separator = options[:row_separator] || options[:row_sep] || "\n"
+      column_separator = options[:column_separator] || options[:col_sep] || ','
+      sc = SimpleCSV.new(raw_row, :quote => nil, :as_array => true, :row_separator => row_separator, :column_separator => column_separator)
+      sc.parse_row(raw_row)
+    end
+
+  end # class << self
+
+  include Enumerable
+
+  attr_accessor :header_row, :mode, :quote, :row_separator, :selected_columns, :as_array, :rows
+
+  def initialize(source, *args)
+    @source = (
+      if source.is_a?(::String)
+        SimpleCSV.source_type(source).new(source, *args).source
+      else
+        source
+      end
+    )
+    options = args.extract_options!
+    @header_row = options[:header_row] || options[:headers] || options[:header] || false
+    @mode = options[:mode] || 'r'
+    @quote = options[:quote] || nil
+    @row_separator = options[:row_separator] || options[:row_sep] || "\n"
+    @column_separator = options[:column_separator] || options[:col_sep] || ','
+    @selected_columns = options[:selected_columns]
+    @as_array = options[:as_array] || false
+    if options[:columns]
+      self.columns = options[:columns]
+    else
+      self.columns
+    end
+    @rows = []
+  end
+
+  def close
+    @source.close
+  end
+
+  def read(*selected_columns, &block)
+    if block
+      parse(*selected_columns, &block)
+    else
+      read_header
+      @source.each(@row_separator){|raw_row| @rows << parse_row(raw_row, *selected_columns)}
+      (@source.rewind; @source.truncate(0)) if @mode == 'r+'
+      @rows
+    end
+  end
+  alias_method :read_csv, :read
+
+  def read_header
+    columns
+    if header_row?
+      (@source.rewind; @source.gets(@row_separator))
+    else
+      @source.rewind
+    end
+  end
+  alias_method :read_csv_header, :read_header
+
+  def parse(*selected_columns, &block)
+    if block
+      each(*selected_columns, &block)
+    else
+      read(*selected_columns)
+    end
+  end
+  alias_method :parse_csv, :parse
+
+  def columns
+    @columns ||= (
+      if header_row? && ['r', 'r+', 'a+'].include?(@mode) && (first_row = first_row?)
+        columns, i = {}, -1
+        first_row.split_csv(@quote, @column_separator, @row_separator).each do |column_name|
+          if column_name.empty?
+            columns[column_name].blank? ? columns[column_name] = [i += 1] : columns[column_name] << (i += 1)
+          else
+            columns[column_name] = (i += 1)
+          end
+        end
+        columns
+      else
+        nil
+      end
+    )
+  end
+
+  def columns=(*column_order)
+    @columns = {}
+    column_order.flatten!
+    if column_order[0].is_a?(Hash)
+      column_order[0].each{|column_name, column_position| @columns[column_name.to_s] = column_position}
+    else
+      i = -1
+      column_order.each{|column| @columns[column.to_s] = (i += 1)}
+    end
+  end
+
+  def parse_row(raw_row, *selected_columns)
+    parsed_row = {}
+    i = -1
+    if selected_columns.empty?
+      if @columns.blank?
+        raw_row.split_csv(@quote, @column_separator, @row_separator).each{|column_value| parsed_row[i += 1] = column_value}
+      else
+        raw_row.split_csv(@quote, @column_separator, @row_separator).each{|column_value| parsed_row[attributes[i += 1]] = column_value}
+      end
+    else
+      selected_columns.flatten!
+      case selected_columns[0]
+      when Integer
+        raw_row.split_csv(@quote, @column_separator, @row_separator).each{|column_value| parsed_row[i] = column_value unless !selected_columns.include?(i += 1)}
+      else
+        raw_row.split_csv(@quote, @column_separator, @row_separator).each{|column_value| parsed_row[attributes[i]] = column_value unless !selected_columns.include?(attributes[i += 1])}
+      end
+    end
+    if @as_array
+      if @columns.blank?
+        (0..(parsed_row.size - 1)).inject([]){|a,i| a << parsed_row[i]}
+      else
+        attributes.collect{|attribute| parsed_row[attribute]}
+      end
+    else
+      parsed_row
+    end
+  end
+
+  def write(*selected_columns)
+    write_header(*selected_columns) if header_row?
+    each{|row| write_row(row, *selected_columns)}
+  end
+  alias_method :write_csv, :write
+
+  def write_header(*selected_columns)
+    selected_columns.flatten!
+    if selected_columns.empty?
+      write_row(attributes.to_csv)
+    else
+      write_row(columns.to_csv)
+    end
+  end
+  alias_method :write_csv_header, :write_header
+
+  def write_row(row, *selected_columns)
+    collector = []
+    selected_columns.flatten!
+    unless attributes.blank?
+      if selected_columns.blank?
+        attributes.each{|attribute| collector << row[attribute] unless row[attribute].nil?}
+      else
+        selected_columns.each{|column| collector << row[column] unless row[column].nil?}
+      end
+      @source.puts(collector.to_csv(@quote))
+    end
+  end
+  alias_method :write_csv_row, :write_row
+
+  def each(*selected_columns)
+    selected_columns.flatten!
+    if @rows[0]
+      if selected_columns.empty?
+        @rows.each{|row| yield row}
+      else
+        @rows.each do |row|
+          yield selected_columns.inject({}){|hash, column_name| hash[column_name] = row[column_name]; hash}
+        end
+      end
+    else
+      if selected_columns.empty?
+        read_csv.each{|row| yield row}
+      else
+        read_csv(selected_columns).each do |row|
+          yield selected_columns.inject({}){|hash, column_name| hash[column_name] = row[column_name]; hash}
+        end
+      end
+    end
+  end
+  alias_method :each_row, :each
+
+  def attributes
+    @attributes ||= (
+      if columns.blank?
+        nil
+      else
+        a = []
+        columns.each do |k,v|
+          case v
+          when Array
+            v.each{|e| a << ['', e]}
+          else
+            a << [k, v]
+          end
+        end
+        a.sort{|a,b| a[1] <=> b[1]}.collect{|a| a[0]}
+      end
+    )
+  end
+
+  def attributes=(attributes)
+    @attributes = attributes
+  end
+
+  def header_row?
+    @header_row
+  end
+
+  def first_row
+    @source.rewind
+    return_value = @source.gets(@row_separator)
+    @source.rewind
+    return_value
+  end
+  alias_method :first_row?, :first_row
+
+  def to_a
+    read_csv unless @rows[0]
+    if @as_array
+      @rows
+    elsif @columns.blank?
+      result = []
+      @rows.each do |row|
+        a = []
+        (0..(row.size - 1)).inject([]){|a,i| a << row[i]}
+        result << a
+      end
+      result
+    else
+      @rows.collect do |row|
+        attributes.collect{|attribute| row[attribute]}
+      end
+    end
+  end
+
+end # class SimpleCSV

data/lib/SimpleCSV/File.rb

@@ -0,0 +1,50 @@
+# SimpleCSV/File.rb
+# SimpleCSV::File
+
+require_relative File.join('..', 'SimpleCSV')
+
+class SimpleCSV
+  class File < SimpleCSV
+
+    class << self
+
+      def open(source, *args, &block)
+        @csv_file = new(source, *args)
+        super(source, *args, &block)
+      end
+
+    end # class << self
+
+    def initialize(filename, *args)
+      @filename = filename
+      @args = args
+      super(source, *args)
+    end
+
+    def source
+      @source ||= ::File.new(filename, mode, permissions)
+    end
+
+    def mode
+      @mode ||= (
+        case @args.peek_options[:mode].to_s
+        when 'r', 'r+', 'w', 'w+', 'a', 'a+'; @args.peek_options[:mode].to_s
+        when 'read_only', 'read-only', 'readonly'; 'r'
+        when 'rw', 'read_write', 'read-write', 'readwrite'; 'r+'
+        when 'write_only', 'write-only', 'writeonly'; 'w'
+        when 'append'; 'a'
+        else 'r'
+        end
+      )
+    end
+
+    def permissions
+      @permissions ||= @args.peek_options[:permissions]
+    end
+
+    def filename
+      @filename ||= File.expand_path(@filename)
+    end
+
+  end
+end

data/lib/SimpleCSV/String.rb

@@ -0,0 +1,30 @@
+# SimpleCSV/String.rb
+# SimpleCSV::String
+
+require 'stringio'
+
+require_relative File.join('..', 'SimpleCSV')
+
+class SimpleCSV
+  class String < SimpleCSV
+
+    class << self
+
+      def open(source, *args, &block)
+        @csv_file = new(source, *args)
+        super(source, *args, &block)
+      end
+
+    end # class << self
+
+    def initialize(string, *args)
+      @string = string
+      super(source, *args)
+    end
+
+    def source
+      @source ||= StringIO.new(@string)
+    end
+
+  end
+end

data/lib/String/blankQ.rb

@@ -0,0 +1,18 @@
+# String#blank?
+# String#blankQ
+
+# 2010.04.04
+# 0.0.1
+
+# History: Stolen wholesale from a recent version of ActiveSupport.  
+
+# Changes: 
+# 1. Now using a more recent version from ActiveSupport.  This more recent version from ActiveSupport is likely more efficient and slightly more succinct.  
+
+class String
+  
+  def blank?
+    self !~ /\S/
+  end
+  
+end

data/lib/String/split_csv.rb

@@ -0,0 +1,66 @@
+# String/split_csv
+# String#split_csv
+
+# 20111110
+# 0.7.0
+
+# History: Written for SimpleCSV.  
+
+# Todo: 
+# 1. Consider having a mode which splits up strings as if they were unquoted, but retains quotes (which contain commas) as per 0.4.0.  I think that is what I had in mind when I thought that the other two libraries weren't handling it correctly.  It should really be optional as to how quotes are handled.  
+
+# Notes: 
+# 1. I reckon both CSV and FasterCSV handle doubly-quoted quotes incorrectly.  If I am wanting everything between the commas, then that means *everything*, including any quote marks regardless of where they are.  If additionally, I am wanting to selectively choose only that which is between, then I can do this too by specifying that the data contained therein is mixed and so I dispense with the outer-most quote marks.  CSV and FasterCSV presume to know what I want and dispense with the outer quote marks even though the rest of a line is being parsed as if there are none.  This is inconsistent.  
+
+# Changes since 0.6: 
+# 1. + row_separator.  
+
+class String
+  
+  def split_csv(quote = nil, column_separator = ',', row_separator = nil)
+    case quote
+    when :none, :unquoted
+      if row_separator
+        self.chomp(row_separator).split(column_separator)
+      else
+        self.chomp.split(column_separator)
+      end
+    when :double, :double_quoted, :double_quotes
+      if row_separator
+        self.chomp(row_separator).split(column_separator).collect{|e| e.sub(/^"/, '').sub(/"$/, '')}
+      else
+        self.chomp.split(column_separator).collect{|e| e.sub(/^"/, '').sub(/"$/, '')}
+      end
+    else
+      split_row = []
+      assembling_column = false
+      buffer = ''
+      if row_separator
+        self.chomp!(row_separator)
+      else
+        self.chomp!
+      end
+      self.split(column_separator).each do |e|
+        if assembling_column && !(e =~ /"$/) # e.not_closing_quotes?
+          buffer << e
+        elsif assembling_column && e =~ /"$/ # e.closing_quotes?
+          buffer << e.sub(/"$/, '') # remove the trailing quote
+          split_row << buffer
+          assembling_column = false
+        elsif (e =~ /^"/) && !(e =~ /"$/) # e.opening_quotes_but_not_closing_quotes?
+          buffer = ''
+          buffer << e.sub(/^"/, '') + column_separator # remove leading quote and replace the column_separator
+          assembling_column = true
+        else
+          if (e =~ /^"/) && (e =~ /"$/) # e.both_opening_and_closing_quotes?
+            split_row << e.sub(/^"/, '').sub(/"$/, '')
+          else
+            split_row << e
+          end
+        end
+      end
+      split_row
+    end
+  end
+  
+end

data/lib/String/underscore.rb

@@ -0,0 +1,32 @@
+# String#underscore
+
+# 2010.10.15
+# 0.1.0
+
+# Description: The compliment of camelize.  This takes a camel-case word and converts any capitals into lowercase and excepting for a leading capital letter, prepends each with an underscore.  It also converts namespaces to paths, ie. '::' to '/'.  
+
+# History: Almost stolen wholesale from ActiveSupport::Inflector::Inflections#underscore 3.0.0.beta3.  
+
+# Examples: 
+# "ActiveRecord".underscore
+# => "active_record"
+# "ActiveRecord::Errors".underscore
+# => active_record/errors
+
+# Changes since 0.0
+# 1. Updated with changes from active_support 3.0.0.  
+# 2. Will now successfully handle strings with spaces.  
+# 3. Removed the dup'ed word since once the transformational methods were chained this became unnecessary.  
+
+class String
+  
+  def underscore
+    gsub(' ', '_').
+    gsub(/::/, '/').
+    gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+    gsub(/([a-z\d])([A-Z])/,'\1_\2').
+    tr("-", "_").
+    downcase
+  end
+  
+end

data/lib/TrueClass/blankQ.rb

@@ -0,0 +1,15 @@
+# TrueClass#blank?
+# TrueClass#blankQ
+
+# 20100308
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class TrueClass
+  
+  def blank?
+    false
+  end
+  
+end

data/lib/_meta/blankQ.rb

@@ -0,0 +1,13 @@
+# _meta/blankQ
+
+# 2010.04.04
+# 0.0.0
+
+require 'Array/blankQ'
+require 'FalseClass/blankQ'
+require 'Hash/blankQ'
+require 'NilClass/blankQ'
+require 'Numeric/blankQ'
+require 'Object/blankQ'
+require 'String/blankQ'
+require 'TrueClass/blankQ'

data/lib/_meta/default_to.rb

@@ -0,0 +1,7 @@
+# _meta/default_to
+
+# 0.0.0
+# 20100316
+
+require 'Object/default_to'
+require 'NilClass/default_to'

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: parliamentarian
+version: !ruby/object:Gem::Version
+  version: 0.8.5
+platform: ruby
+authors:
+- thoran
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-spec-context
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This will download and parse the lastest list of members and their contact
+  details for the alleged parliament of the State of Victoria and the alleged federal
+  parliament for Australia so far.
+email: code@thoran.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/Array/blankQ.rb
+- lib/Array/extract_optionsX.rb
+- lib/Array/peek_options.rb
+- lib/Array/to_csv.rb
+- lib/FalseClass/blankQ.rb
+- lib/Hash/blankQ.rb
+- lib/Hash/to_csv.rb
+- lib/NilClass/blankQ.rb
+- lib/NilClass/default_to.rb
+- lib/Numeric/blankQ.rb
+- lib/Object/blankQ.rb
+- lib/Object/default_to.rb
+- lib/Parliamentarian.rb
+- lib/Parliamentarian/Australia.rb
+- lib/Parliamentarian/Australia/Federal.rb
+- lib/Parliamentarian/Australia/Victoria.rb
+- lib/Parliamentarian/VERSION.rb
+- lib/SimpleCSV.rb
+- lib/SimpleCSV/File.rb
+- lib/SimpleCSV/String.rb
+- lib/String/blankQ.rb
+- lib/String/split_csv.rb
+- lib/String/underscore.rb
+- lib/TrueClass/blankQ.rb
+- lib/_meta/blankQ.rb
+- lib/_meta/default_to.rb
+homepage: http://github.com/thoran/Parliamentarian
+licenses:
+- Ruby
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.3
+signing_key:
+specification_version: 4
+summary: Download and parse details for members of parliament.
+test_files: []