lib/whimsy/asf/memapps.rb

#
# Common access to membership application files
#

### INITIAL RELEASE - SUBJECT TO CHANGE ###

require_relative 'config'
require_relative 'svn'

module ASF
  class MemApps
    @@files = nil
    @@tag = nil

    # list the stems of the files (excluding any ones which record emeritus)
    def self.stems
      refresh
      apps = @@files.reject{|f| f =~ /_emeritus\.\w+$/}.map do |file|
        file.sub(/\.\w+$/, '')
      end
      apps
    end

    # list the names of the files (excluding any ones which record emeritus)
    def self.names
      refresh
      @@files.reject{|f| f =~ /_emeritus\.\w+$/}
    end

    # names of emeritus files
    def self.emeritus
      refresh
      apps = @@files.select {|f| f =~ /_emeritus\.\w+$/}.map do |file|
        file.sub(/_emeritus\.\w+$/, '')
      end
      apps
    end

    def self.sanitize(name)
      # Don't transform punctation into '-'
      ASF::Person.asciize(name.strip.downcase.gsub(/[.,()"]/,''))
    end

    # search for file name
    # @return filename if it exists, or
    # return full name if filename matches the stem of a file
    def self.search(filename)
      names = self.names()
      if names.include?(filename)
        return filename
      end
      names.each { |name|
        if name.start_with?("#{filename}.")
          return name
        end
      }
      nil
    end

    # find the name of the memapp for a person or nil
    def self.find1st(person)
      self.find(person)[0].first
    end

    # find the memapp for a person; return an array:
    # - [array of files that matched (possibly empty), array of stems that were tried]
    def self.find(person)
      found=[] # matches we found
      names=[] # names we tried
      [
        (person.icla.legal_name rescue nil),
        (person.icla.name rescue nil),
        person.member_name # this is slow
      ].uniq.each do |name|
        next unless name
        memapp = self.sanitize(name) # this may generate dupes, so we use uniq below
        names << memapp
        file = self.search(memapp)
        if file
          found << file
        end
      end
      return [found, names.uniq]
    end

    # All files, including emeritus
    def self.files
      refresh
      @@files
    end

    private

    def self.refresh
      @@tag, list = ASF::SVN.getlisting('member_apps', @@tag)
      if list
        @@files = list
      end
    end
  end
end

# for test purposes
if __FILE__ == $0
  puts ASF::MemApps.files.length
  puts ASF::MemApps.names.length
  puts ASF::MemApps.stems.length
  puts ASF::MemApps.emeritus.length
end