mit_stalker 1.0

data/CHANGELOG

@@ -0,0 +1 @@
+v1.0. Initial release.

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2009 Zergling.Net
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Manifest

@@ -0,0 +1,10 @@
+CHANGELOG
+LICENSE
+Manifest
+README.textile
+Rakefile
+lib/mit_stalker.rb
+test/fixtures/multi_response.txt
+test/fixtures/no_response.txt
+test/fixtures/single_response.txt
+test/mit_stalker_test.rb

data/README.textile

@@ -0,0 +1,19 @@
+h1. MIT Student Information Retriever
+
+mit_stalker is a Ruby gem that parses publicly available information about MIT
+students. 
+
+h2. Setup
+
+bc. gem install mit_stalker 
+
+h2. Usage
+
+Read the RDoc.
+
+h2. Contributions
+
+The code was factored out of the 6.006 Web site, and it contains exactly what I
+needed for that site. I will not be adding features, but I will do my best to
+fix bugs. If you want a feature, please don't hesitate to fork the project and
+send me pull requests.

data/Rakefile

@@ -0,0 +1,28 @@
+# Rakefile that uses echoe to manage mit_stalker's gemspec. 
+#
+# Author:: Victor Costan
+# Copyright:: Copyright (C) 2009 Zergling.Net
+# License:: MIT
+
+require 'rubygems'
+require 'echoe'
+
+Echoe.new('mit_stalker') do |p|
+  p.project = 'zerglings'  # RubyForge project.
+  
+  p.author = 'Victor Costan'
+  p.email = 'victor@zergling.net'
+  p.summary = "RAM-based cache for FeedTools."
+  p.url = 'http://github.com/costan/feed_tools_ram_cache'
+  p.dependencies = ["feedtools >=0.2.29"]
+  p.development_dependencies = ["echoe >=3.1.1", "flexmock >=0.8.6"]
+  
+  p.need_tar_gz = true
+  p.need_zip = true
+  p.rdoc_pattern = /^(lib|bin|tasks|ext)|^BUILD|^README|^CHANGELOG|^TODO|^LICENSE|^COPYING$/  
+end
+
+if $0 == __FILE__
+  Rake.application = Rake::Application.new
+  Rake.application.run
+end

data/lib/mit_stalker.rb

@@ -0,0 +1,107 @@
+# Fetch publicly available information about MIT students. 
+#
+# Author:: Victor Costan
+# Copyright:: Copyright (C) 2009 Zergling.Net
+# License:: MIT
+
+require 'socket'
+
+
+# Fetch publicly available information about MIT students. 
+module MitStalker
+  # Issues a finger request to a server.
+  #
+  # Returns a string containing the finger response, or nil if something went
+  # wrong.
+  def self.finger(request, host)
+    begin
+      client = TCPSocket.open host, 'finger'
+      client.send request + "\n", 0    # 0 means standard packet
+      result = client.readlines.join
+      client.close
+      
+      return result
+    rescue
+      return nil
+    end
+  end
+  
+  # Retrieves an MIT student's full name, based on the Athena username.
+  #
+  # Returns a string containing the full name, or nil if the Athena username is
+  # not recognized. 
+  def self.full_name_from_user_name(user_name)
+    athena_data = finger user_name, 'linux.mit.edu'
+    return nil if athena_data.nil?
+    match = athena_data.match /(N|n)ame\: (.*)$/
+    match and match[2].strip
+  end
+  
+  # Parses a MIT directory response into users.
+  #
+  # Returns a (possibly empty) array of hashes, with one hash per user. A hash
+  # has the directory information for the user, using symbols as keys, e.g.
+  # {:name => 'Victor Costan', :year => '1'}
+  def self.parse_mitdir_response(response)
+    return [] if response.nil?
+    
+    lines = response.split("\r\n").reverse    
+    users = []
+    user = {}
+    lines.each do |line|
+      if line.empty?
+        users << user unless user.empty?
+        user = {}
+        next
+      end
+      
+      match = /([^:]*):(.+)/.match line
+      break unless match
+      
+      user[match[1].strip.downcase.gsub(' ', '_').to_sym] = match[2].strip
+    end
+    users
+  end
+  
+  # Computes a name vector from a full name.
+  #
+  # The same name, in different formats, should yield the same vector. Different
+  # names should yield different vectors.
+  def self.name_vector(name)
+    name.gsub(/\W/, ' ').gsub(/ +/, ' ').split.sort
+  end
+  
+  # Narrows down a MIT directory response to a single user.
+  #
+  # Returns a single user information hash, or nil if no user has the given
+  # full name. 
+  def self.refine_mitdir_response(users, full_name)
+    vector = name_vector(full_name)
+    user_base_info = users.find { |user| name_vector(user[:name]) == vector }
+    return nil unless user_base_info
+  
+    # Don't make an extra request for the same info.
+    return users.first if users.length == 1
+    
+    # Requesting by alias should return a single name.
+    users = parse_mitdir_response finger(user_base_info[:alias], 'web.mit.edu')
+    users and users.first
+  end
+  
+  # Retrieves information about an MIT student from an Athena username.
+  #
+  # Returns a hash containing user information, or nil if the user was not
+  # found.
+  def self.from_user_name(user_name)
+    full_name = full_name_from_user_name user_name
+    return nil unless full_name
+    
+    users = parse_mitdir_response finger(full_name, 'web.mit.edu')
+    if users.empty?
+      users = parse_mitdir_response finger(user_name, 'web.mit.edu')
+    end
+    
+    user = refine_mitdir_response(users, full_name)
+    user and user.merge(:full_name => full_name)
+  end
+end

data/mit_stalker.gemspec

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{mit_stalker}
+  s.version = "1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Victor Costan"]
+  s.date = %q{2009-09-29}
+  s.description = %q{RAM-based cache for FeedTools.}
+  s.email = %q{victor@zergling.net}
+  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README.textile", "lib/mit_stalker.rb"]
+  s.files = ["CHANGELOG", "LICENSE", "Manifest", "README.textile", "Rakefile", "lib/mit_stalker.rb", "test/fixtures/multi_response.txt", "test/fixtures/no_response.txt", "test/fixtures/single_response.txt", "test/mit_stalker_test.rb", "mit_stalker.gemspec"]
+  s.homepage = %q{http://github.com/costan/feed_tools_ram_cache}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Mit_stalker", "--main", "README.textile"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{zerglings}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{RAM-based cache for FeedTools.}
+  s.test_files = ["test/mit_stalker_test.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<feedtools>, [">= 0.2.29"])
+      s.add_development_dependency(%q<echoe>, [">= 3.1.1"])
+      s.add_development_dependency(%q<flexmock>, [">= 0.8.6"])
+    else
+      s.add_dependency(%q<feedtools>, [">= 0.2.29"])
+      s.add_dependency(%q<echoe>, [">= 3.1.1"])
+      s.add_dependency(%q<flexmock>, [">= 0.8.6"])
+    end
+  else
+    s.add_dependency(%q<feedtools>, [">= 0.2.29"])
+    s.add_dependency(%q<echoe>, [">= 3.1.1"])
+    s.add_dependency(%q<flexmock>, [">= 0.8.6"])
+  end
+end

data/test/fixtures/multi_response.txt

@@ -0,0 +1,732 @@
+Student data loaded as of Sep 29, Staff data loaded as of Sep 29.
+
+Notify Personnel or use WebSIS as appropriate to change your information.
+
+Our on-line help system describes
+  How to change data, how the directory works, where to get more info.
+  For a listing of help topics, enter finger help@mit.edu. Try finger
+  help_about@mit.edu to read about how the directory works.
+  Directory bluepages may be found at http://mit.edu/communications/bp.
+
+There were 155 matches to your request.
+
+Complete information will be shown only when one individual matches
+your query.  Resubmit your query with more information.
+For example, use both firstname and lastname or use the alias field.
+
+       name: Li, Alice
+ department: Electrical Eng & Computer Sci
+       year: 4
+      alias: A-li
+
+       name: Li, Amber H.
+       year: 1
+      alias: A-li1
+
+       name: Li, An
+ department: Electrical Eng & Computer Sci
+       year: 4
+      alias: A-li2
+
+       name: Li, Aoxi
+ department: Physics
+       year: 2
+      alias: A-li3
+
+       name: Li, Adrienne Victoria
+ department: Biological Engineering
+       year: G
+      alias: A-li4
+
+       name: Li, Anye
+ department: Lincoln Laboratory
+      title: LL - Assistant Staff
+      alias: A-li5
+
+       name: Li, Bo 
+      title: MIT Affiliate
+      alias: B-li
+
+       name: Li, Bokyung
+ department: Management
+       year: G
+      alias: B-li1
+
+       name: Li, Biao
+ department: Laboratory for Manufacturing and Productivity
+      title: Visiting Engineer
+      alias: B-li2
+
+       name: Li, Chen 
+      title: MIT Affiliate
+      alias: C-li
+
+       name: Li, Chi King 
+      title: MIT Affiliate
+      alias: C-li1
+
+       name: Li, Chunyu 
+      title: MIT Affiliate
+      alias: C-li2
+
+       name: Li, Chun 
+      title: MIT Affiliate
+      alias: C-li3
+
+       name: Li, Chung-Lun 
+      title: MIT Affiliate
+      alias: C-li4
+
+       name: Li, Cheng
+ department: Health Sciences & Technology
+       year: G
+      alias: C-li5
+
+       name: Li, Cheri Yingjie
+ department: Chemical Engineering
+       year: G
+      alias: C-li6
+
+       name: Li, Chikang
+ department: Plasma Science and Fusion Center
+      title: Principal Research Scientist
+      alias: C-li7
+
+       name: Li, Daniel 
+      title: MIT Affiliate
+      alias: D-li
+
+       name: Li, Donghong 
+      title: MIT Affiliate
+      alias: D-li1
+
+       name: Li, Danielle
+ department: Economics
+       year: G
+      alias: D-li2
+
+       name: Li, Daniel C
+ department: Management
+       year: 3
+      alias: D-li3
+
+       name: Li, David
+ department: Electrical Eng & Computer Sci
+       year: 4
+      alias: D-li4
+
+       name: Li, Dai-Yin
+      alias: D-li5
+
+       name: Li, Duo
+ department: Electrical Eng & Computer Sci
+       year: G
+      alias: D-li6
+
+       name: Li, Derek Z
+ department: Mechanical Engineering
+       year: 3
+      alias: D-li7
+
+       name: Li, Dian
+ department: Political Science
+       year: G
+      alias: D-li8
+
+       name: Li, Deyu
+ department: Department of Biological Engineering
+      title: Postdoctoral Associate
+      alias: D-li9
+
+       name: Li, Enhao 
+      title: MIT Affiliate
+      alias: E-li
+
+       name: Li, Fang 
+      title: MIT Affiliate
+      alias: F-li
+
+       name: Li, Fulu 
+      title: MIT Affiliate
+      alias: F-li1
+
+       name: Li, Frank H.
+       year: 1
+      alias: F-li2
+
+       name: Li, Guang 
+      title: MIT Affiliate
+      alias: G-li
+
+       name: Li, Grace M
+ department: Electrical Eng & Computer Sci
+       year: 4
+      alias: G-li1
+
+       name: Li, George Z
+ department: Chemical Engineering
+       year: 4
+      alias: G-li2
+
+       name: Li, Guoan
+ department: Department of Mechanical Engineering
+      title: Lecturer
+      alias: G-li3
+
+       name: Li, Guohui
+ department: Dept of Earth, Atmospheric, & Planetary Sciences
+      title: Postdoctoral Associate
+      alias: G-li4
+
+       name: Li, Hua-Jung 
+      title: MIT Affiliate
+      alias: H-li
+
+       name: Li, Hong 
+      title: MIT Affiliate
+      alias: H-li1
+
+       name: Li, Hanhan 
+      title: MIT Affiliate
+      alias: H-li2
+
+       name: Li, Huipeng 
+      title: MIT Affiliate
+      alias: H-li3
+
+       name: Li, Hanqing
+ department: Management
+       year: G
+      alias: H-li4
+
+       name: Li, HaoQi
+ department: Biology
+       year: 3
+      alias: H-li5
+
+       name: Li, Hsinjung
+ department: Chemical Engineering
+       year: 3
+      alias: H-li6
+
+       name: Li, Hui
+ department: Aeronautics And Astronautics
+       year: G
+      alias: H-li7
+
+       name: Li, Harriet
+       year: 1
+      alias: H-li8
+
+       name: Li, Hongyi
+ department: Economics
+       year: 3
+      alias: H-li9
+
+       name: Li, Hanqing
+ department: Microsystems Technology Laboratories
+      title: Research Scientist
+      alias: H-li10
+
+       name: Li, Jim 
+      title: MIT Affiliate
+      alias: J-li
+
+       name: Li, Jie 
+      title: MIT Affiliate
+      alias: J-li1
+
+       name: Li, Jacqueline
+ department: Non-Institute  Harvard
+       year: 3
+      alias: J-li2
+
+       name: Li, Jennifer
+ department: Electrical Eng & Computer Sci
+       year: 3
+      alias: J-li3
+
+       name: Li, Jessica X.
+       year: 1
+      alias: J-li4
+
+       name: Li, Jessie Q
+ department: Electrical Eng & Computer Sci
+       year: 3
+      alias: J-li5
+
+       name: Li, Jialing
+ department: Physics
+       year: G
+      alias: J-li6
+
+       name: Li, Janet
+ department: Biology
+       year: 2
+      alias: J-li7
+
+       name: Li, Josepher
+       year: 1
+      alias: J-li8
+
+       name: Li, Junlun
+ department: Earth, Atmos, & Planetary Sci
+       year: G
+      alias: J-li9
+
+       name: Li, Justine
+ department: Aeronautics And Astronautics
+       year: 4
+      alias: J-li10
+
+       name: Li, Jing
+ department: Electrical Eng & Computer Sci
+       year: 3
+      alias: J-li11
+
+       name: Li, Jinghua
+ department: Department of Urban Studies and Planning
+      title: Visiting Scholar
+      alias: J-li12
+
+       name: Li, Kai 
+      title: MIT Affiliate
+      alias: K-li
+
+       name: Li, Karen R
+ department: Economics
+       year: 3
+      alias: K-li1
+
+       name: Li, Kathleen Y
+ department: Biology
+       year: 3
+      alias: K-li2
+
+       name: Li, Kimberly Q.
+ department: Electrical Eng & Computer Sci
+       year: 2
+      alias: K-li3
+
+       name: Li, Kevin K.
+       year: 1
+      alias: K-li4
+
+       name: Li, Lin 
+      title: MIT Affiliate
+      alias: L-li
+
+       name: Li, Loretta S
+      title: MIT Affiliate
+      alias: L-li1
+
+       name: Li, Lulu 
+      title: MIT Affiliate
+      alias: L-li2
+
+       name: Li, Leon Daliang
+ department: Health Sciences & Technology
+       year: G
+      alias: L-li3
+
+       name: Li, Lifang
+ department: Mechanical Engineering
+       year: G
+      alias: L-li4
+
+       name: Li, Ling
+ department: Materials Science And Eng.
+       year: G
+      alias: L-li5
+
+       name: Li, Lishuai
+ department: Aeronautics And Astronautics
+       year: G
+      alias: L-li6
+
+       name: Li, Letitia W
+ department: Electrical Eng & Computer Sci
+       year: 3
+      alias: L-li7
+
+       name: Li, Lynn Lei
+      alias: L-li8
+
+       name: Li, Li
+ department: Department of Chemistry
+      title: Research Specialist
+      alias: L-li9
+
+       name: Li, Lu
+ department: Department of Physics
+      title: Postdoctoral Fellow
+      alias: L-li10
+
+       name: Li, Mingjie 
+      title: MIT Affiliate
+      alias: M-li
+
+       name: Li, Man Chung
+ department: Biology
+       year: G
+      alias: M-li1
+
+       name: Li, Mingda
+ department: Nuclear Science & Engineering
+       year: G
+      alias: M-li2
+
+       name: Li, Meng
+ department: Computation For Design & Optimization
+       year: G
+      alias: M-li3
+
+       name: Li, Ning 
+      title: MIT Affiliate
+      alias: N-li
+
+       name: Li, Nan
+ department: Mathematics
+       year: G
+      alias: N-li1
+
+       name: Li, Nathan P
+ department: Management
+       year: 3
+      alias: N-li2
+
+       name: Li, Ning
+ department: Leaders for Global Operations Program
+      title: Visiting Scholar
+      alias: N-li3
+
+       name: Li, Puyao C.
+ department: Health Sciences & Technology
+       year: G
+      alias: P-li
+
+       name: Li, Patricia Z.
+       year: 1
+      alias: P-li1
+
+       name: Li, Ping
+ department: Department of Chemistry
+      title: Postdoctoral Fellow
+      alias: P-li2
+
+       name: Li Ting, Poh 
+      title: MIT Affiliate
+      alias: P-liting
+
+       name: Li, Qing 
+      title: MIT Affiliate
+      alias: Q-li
+
+       name: Li, Qiushi 
+      title: MIT Affiliate
+      alias: Q-li1
+
+       name: Li, Quentin 
+      title: MIT Affiliate
+      alias: Q-li2
+
+       name: Li, Qing
+ department: Management
+       year: 4
+      alias: Q-li3
+
+       name: Li, Qing
+ department: Management
+       year: 2
+      alias: Q-li4
+
+       name: Li, Qiuyuan J
+ department: Electrical Eng & Computer Sci
+       year: G
+      alias: Q-li5
+
+       name: Li, Qingnan
+ department: Mathematics
+       year: 2
+      alias: Q-li6
+
+       name: Li, Qu
+ department: Department of Civil and Environmental Engineering
+      title: Research Assistant
+      alias: Q-li7
+
+       name: Li, Randolph H
+      title: MIT Affiliate
+      alias: R-li
+
+       name: Li, Ran 
+      title: MIT Affiliate
+      alias: R-li1
+
+       name: Li, Ranning
+ department: Management
+       year: G
+      alias: R-li2
+
+       name: Li, Richard
+ department: Aeronautics And Astronautics
+       year: 4
+      alias: R-li3
+
+       name: Li, Rui
+ department: Electrical Eng & Computer Sci
+       year: G
+      alias: R-li4
+
+       name: Li, Sean A
+      title: MIT Affiliate
+      alias: S-li
+
+       name: Li, Sheung L
+      title: MIT Affiliate
+      alias: S-li1
+
+       name: Li, Shuo C.
+ department: Electrical Eng & Computer Sci
+       year: 2
+      alias: S-li2
+
+       name: Li, Shirley Xue
+ department: Management
+       year: G
+      alias: S-li3
+
+       name: Li, Tieyu
+ department: Engineering Systems Division
+       year: G
+      alias: T-li
+
+       name: Li, Tong
+       year: 1
+      alias: T-li1
+
+       name: Li, Tracy Y
+ department: Physics
+       year: 4
+      alias: T-li2
+
+       name: Li, Victoria 
+      title: MIT Affiliate
+      alias: V-li
+
+       name: Li, Weigang 
+      title: MIT Affiliate
+      alias: W-li
+
+       name: Li, Wendi 
+      title: MIT Affiliate
+      alias: W-li1
+
+       name: Li, Wentao 
+      title: MIT Affiliate
+      alias: W-li2
+
+       name: Li, Wu 
+      title: MIT Affiliate
+      alias: W-li3
+
+       name: Li, Wei
+ department: Electrical Eng & Computer Sci
+       year: G
+      alias: W-li4
+
+       name: Li, Weifeng
+ department: Urban Studies And Planning
+       year: G
+      alias: W-li5
+
+       name: Li, Weiliang
+ department: Aeronautics And Astronautics
+       year: G
+      alias: W-li6
+
+       name: Li, Weisen Janet
+ department: Management
+       year: G
+      alias: W-li7
+
+       name: Li, William Pui Lum
+ department: Engineering Systems Division
+       year: G
+      alias: W-li8
+
+       name: Li, Wu-Hsi
+ department: Media Arts And Sciences
+       year: G
+      alias: W-li9
+
+       name: Li, Wai-ming
+ department: Information Services & Technology
+      title: Team Leader, Technical Services
+      alias: W-li10
+
+       name: Li, Wei
+ department: Laboratory for Nuclear Science
+      title: Postdoctoral Associate
+      alias: W-li11
+
+       name: Li, Xiaochang 
+      title: MIT Affiliate
+      alias: X-li
+
+       name: Li, Xianlin 
+      title: MIT Affiliate
+      alias: X-li1
+
+       name: Li, Xuying
+ department: Mathematics
+       year: 3
+      alias: X-li2
+
+       name: Li, Xingyi
+ department: Electrical Eng & Computer Sci
+       year: 3
+      alias: X-li3
+
+       name: Li, Xin
+ department: Urban Studies And Planning
+       year: G
+      alias: X-li4
+
+       name: Li, Xin Qi
+ department: Biology
+       year: 2
+      alias: X-li5
+
+       name: Li, Xitong
+ department: Management
+       year: G
+      alias: X-li6
+
+       name: Li, Xiang
+ department: Department of Chemical Engineering
+      title: Visiting Scholar
+      alias: X-li7
+
+       name: Li, Yuanjian 
+      title: MIT Affiliate
+      alias: Y-li
+
+       name: Li, Yu 
+      title: MIT Affiliate
+      alias: Y-li1
+
+       name: Li, Yue 
+      title: MIT Affiliate
+      alias: Y-li2
+
+       name: Li, Yuanzhen 
+      title: MIT Affiliate
+      alias: Y-li3
+
+       name: Li, Yuan
+ department: Non-Institute  Wellesley
+       year: 4
+      alias: Y-li4
+
+       name: Li, Yu-Tzu
+ department: Chemistry
+       year: G
+      alias: Y-li5
+
+       name: Li, Yujing
+ department: Architecture
+       year: 4
+      alias: Y-li6
+
+       name: Li, Yong
+ department: Mechanical Engineering
+       year: G
+      alias: Y-li7
+
+       name: Li, Yan
+ department: Electrical Eng & Computer Sci
+       year: G
+      alias: Y-li8
+
+       name: Li, Yat Ming Victor
+ department: Mechanical Engineering
+       year: 3
+      alias: Y-li9
+
+       name: Li, Yang
+ department: Biological Engineering
+       year: G
+      alias: Y-li10
+
+       name: Li, YingFei
+ department: Biological Engineering
+       year: 4
+      alias: Y-li11
+
+       name: Li, Yinqing
+ department: Electrical Eng & Computer Sci
+       year: G
+      alias: Y-li12
+
+       name: Li, Yan
+ department: Mathematics
+       year: 2
+      alias: Y-li13
+
+       name: Li, Yue
+ department: Mechanical Engineering
+       year: 3
+      alias: Y-li14
+
+       name: Li, Yuqiong
+ department: Chemical Engineering
+       year: G
+      alias: Y-li15
+
+       name: Li, Yan Ping
+ department: Division of Comparative Medicine
+      title: Assistant Animal Technician
+      alias: Y-li16
+
+       name: Li, Yang
+ department: Department of Chemistry
+      title: Postdoctoral Associate
+      alias: Y-li17
+
+       name: Li, Yaning
+ department: Department of Mechanical Engineering
+      title: Postdoctoral Associate
+      alias: Y-li18
+
+       name: Li, Yi
+ department: Department of Materials Science and Engineering
+      title: SMA Visiting Scientist
+      alias: Y-li19
+
+       name: Li, Zane K
+      title: MIT Affiliate
+      alias: Z-li
+
+       name: Li, Zhongwei 
+      title: MIT Affiliate
+      alias: Z-li1
+
+       name: Li, Zhen
+ department: Electrical Eng & Computer Sci
+       year: G
+      alias: Z-li2
+
+       name: Li, Zhipeng
+ department: Electrical Eng & Computer Sci
+      alias: Z-li3
+
+       name: Li, Zhi
+ department: Department of Chemical Engineering
+      title: SMA Visiting Scientist
+      alias: Z-li4
+
+       name: Li, Zhuan
+ department: Division of Comparative Medicine
+      title: Assistant Animal Technician
+      alias: Z-li5

data/test/fixtures/no_response.txt

@@ -0,0 +1,11 @@
+Student data loaded as of Sep 29, Staff data loaded as of Sep 29.
+
+Notify Personnel or use WebSIS as appropriate to change your information.
+
+Our on-line help system describes
+  How to change data, how the directory works, where to get more info.
+  For a listing of help topics, enter finger help@mit.edu. Try finger
+  help_about@mit.edu to read about how the directory works.
+  Directory bluepages may be found at http://mit.edu/communications/bp.
+
+No matches to your query.

data/test/fixtures/single_response.txt

@@ -0,0 +1,21 @@
+Student data loaded as of Sep 29, Staff data loaded as of Sep 29.
+
+Notify Personnel or use WebSIS as appropriate to change your information.
+
+Our on-line help system describes
+  How to change data, how the directory works, where to get more info.
+  For a listing of help topics, enter finger help@mit.edu. Try finger
+  help_about@mit.edu to read about how the directory works.
+  Directory bluepages may be found at http://mit.edu/communications/bp.
+
+There was 1 match to your request.
+
+      name: Costan, Victor Marius
+     email: costan@MIT.EDU
+     phone: (617) 452-5244
+   address: Sidney-Pacific NW86-948C
+department: Electrical Eng & Computer Sci
+    school: School Of Engineering         
+      year: G
+       url: http://www.costan.us
+     alias: V-costan

data/test/mit_stalker_test.rb

@@ -0,0 +1,80 @@
+# Author:: Victor Costan
+# Copyright:: Copyright (C) 2009 Zergling.Net
+# License:: MIT
+
+require 'mit_stalker'
+require 'test/unit'
+require 'flexmock/test_unit'
+
+
+class MitStalkerTest < Test::Unit::TestCase
+  def fixture(name)
+    File.read File.join(File.dirname(__FILE__), 'fixtures', name)
+  end
+  
+  def test_finger
+    assert_equal nil, MitStalker.finger('root', 'nosuchhostname.com'),
+                 'Invalid hostname'
+    
+    result = MitStalker.finger('no_such_user', 'web.mit.edu')
+    assert_operator(/matche?s? to your (query)|(request)/, :=~, result,
+                    "The finger response looks incorrect")
+  end
+  
+  def test_full_name
+    assert_equal 'Srinivas Devadas',
+                 MitStalker.full_name_from_user_name('devadas')
+    assert_equal nil, MitStalker.full_name_from_user_name('no_user')
+  end
+  
+  def test_parse_mitdir_no_response
+    assert_equal [],
+                 MitStalker.parse_mitdir_response(fixture('no_response.txt'))
+  end
+  
+  def test_parse_mitdir_single_response
+    response = MitStalker.parse_mitdir_response fixture('single_response.txt')
+    assert_equal 1, response.length, 'Response should have 1 user'
+    
+    assert_equal 'Costan, Victor Marius', response.first[:name]
+    assert_equal 'costan@MIT.EDU', response.first[:email]
+    assert_equal 'G', response.first[:year]
+    assert_equal 'Sidney-Pacific NW86-948C', response.first[:address]
+    assert_equal 'http://www.costan.us', response.first[:url]
+    assert_equal 'V-costan', response.first[:alias]
+  end
+  
+  def test_parse_mitdir_multiple_responses
+    response = MitStalker.parse_mitdir_response fixture('multi_response.txt')
+    assert_equal 155, response.length, 'Response should have 110 users'
+    
+    response.each do |user|
+      assert_operator(/Li/, :=~, user[:name], "Name doesn't match query")
+      assert_operator(/li/i, :=~, user[:alias], "Alias doesn't match query")
+    end
+  end
+  
+  def test_name_vector
+    ['Victor-Marius Costan', 'Victor Marius Costan', 'Costan, Victor-Marius',
+     'Costan, Victor Marius'].each do |name|
+      assert_equal ['Costan', 'Marius', 'Victor'], MitStalker.name_vector(name)
+    end
+  end
+  
+  def test_refine_mitdir_response
+    flexmock(MitStalker).should_receive(:finger).with('Y-li16', 'web.mit.edu').
+                         and_return(fixture('single_response.txt'))
+                         
+    multi_response =
+        MitStalker.parse_mitdir_response fixture('multi_response.txt')
+    user = MitStalker.refine_mitdir_response multi_response, 'Yan Ping Li'
+    assert_equal 'costan@MIT.EDU', user[:email], 'Wrong user information'
+  end
+  
+  def test_from_user_name
+    assert_equal nil, MitStalker.from_user_name('no_such_user')
+    
+    info = MitStalker.from_user_name 'devadas'
+    assert_equal 'Devadas, Srinivas', info[:name]
+  end
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: mit_stalker
+version: !ruby/object:Gem::Version 
+  version: "1.0"
+platform: ruby
+authors: 
+- Victor Costan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-29 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: feedtools
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.29
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 3.1.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: flexmock
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.6
+    version: 
+description: RAM-based cache for FeedTools.
+email: victor@zergling.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- LICENSE
+- README.textile
+- lib/mit_stalker.rb
+files: 
+- CHANGELOG
+- LICENSE
+- Manifest
+- README.textile
+- Rakefile
+- lib/mit_stalker.rb
+- test/fixtures/multi_response.txt
+- test/fixtures/no_response.txt
+- test/fixtures/single_response.txt
+- test/mit_stalker_test.rb
+- mit_stalker.gemspec
+has_rdoc: true
+homepage: http://github.com/costan/feed_tools_ram_cache
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Mit_stalker
+- --main
+- README.textile
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: zerglings
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: RAM-based cache for FeedTools.
+test_files: 
+- test/mit_stalker_test.rb