lcclasses 0.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 William Melody
+
+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/README.markdown

@@ -0,0 +1,66 @@
+# LCCLasses
+
+A Ruby gem that provides the Library of Congress Classification system main classes and subclasses along with some convenience menthods.
+
+To install:
+
+    gem install lcclasses
+    
+## Usage
+
+To find a classification code:
+
+    LCClasses.find_main_class_by_code("T")
+    => ["T", "Technology (General)"]
+    LCClasses.find_subclass_by_code("AM")
+    => ["AM", "Museums. Collectors and collecting"]
+    LCClasses.find_all_by_code("E")
+    => # returns the main "E" class and all subclasses in nested array
+    LCClasses.main_classes
+    => # returns all main classes
+    LCClasses.subclasses
+    => # returns all subclasses
+
+The entire set of classes can be retrieved in 3 formats:
+
+    LCClasses::CLASS_HASH
+    => # nested hash of classes and subclasses
+    LCClases.nested
+    => # nested array of classes and subclasses as LCClasses::LCClass objects
+    LCClases.flat
+    => # flat array of classes and subclasses as LCClasses::LCClass objects
+
+The CLASS\_HASH conststant is in the following format (truncated example):
+
+    { "A" => { 
+        :name => "General Works",
+        :subclasses => {
+          "AC" => { :name => "Collections; Series; Collected works" }
+        }
+      }
+    }
+    
+Classes are returned as specialized LCClasses::Class arrays in the format `[code, name]`. In the case of nested LCClasses:LCClass objects, they are in the format `[main_class_code, main_class_name, [[subclass_code, subclass_name]]]`. These objects are normal arrays with the following methods added:
+
+    @class = LCClasses.find_main_class_by_code("M")
+    @class.code
+    => "M"
+    @class.name
+    => "Music"
+    @class.subclasses
+    => [["M", "Music"], ["ML", "Literature on music"], ["MT", "Instruction and study"]]
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 William Melody. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "lcclasses"
+    gem.summary = %Q{Library of Congress Classification classes and subclasses}
+    gem.description = %Q{Library of Congress Classification classes and subclasses}
+    gem.email = "hi@williammelody.com"
+    gem.homepage = "http://github.com/autodata/lcclasses"
+    gem.authors = ["William Melody"]
+    gem.add_development_dependency "thoughtbot-shoulda"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "lcclasses #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.0

data/lcclasses.gemspec

@@ -0,0 +1,54 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{lcclasses}
+  s.version = "0.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["William Melody"]
+  s.date = %q{2010-02-25}
+  s.description = %q{Library of Congress Classification classes and subclasses}
+  s.email = %q{hi@williammelody.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.markdown"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "lcclasses.gemspec",
+     "lib/lcclasses.rb",
+     "test/test_helper.rb",
+     "test/test_lcclasses.rb"
+  ]
+  s.homepage = %q{http://github.com/autodata/lcclasses}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Library of Congress Classification classes and subclasses}
+  s.test_files = [
+    "test/test_helper.rb",
+     "test/test_lcclasses.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_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+  end
+end
+

data/lib/lcclasses.rb

@@ -0,0 +1,404 @@
+module LCClasses
+  class LCClass < Array
+    
+    # Convert nested LCClasses::CLASS_HASH to nested array.
+    def self.nest(hash)
+      return self[] if hash.nil?
+      hash.sort { |a,b| a[0] <=> b[0] }.inject(self[]) do |result, klass|
+        if klass[1][:subclasses]
+          result << self[klass[0],klass[1][:name], self.nest(klass[1][:subclasses])]
+        else
+          result << self[klass[0],klass[1][:name]]
+        end
+      end
+    end
+    
+    # Convert nested LCClasses::CLASS_HASH to flat array.
+    def self.flatten(hash)
+      return self[] if hash.nil?
+      hash.sort { |a,b| a[0] <=> b[0] }.inject(self[]) do |result, klass|
+        result << self[klass[0],klass[1][:name]]
+        result += self.flatten(klass[1][:subclasses])
+      end
+    end
+    
+    # Return the subclasses of this class, if any.
+    def subclasses
+      return unless i = LCClasses::CLASS_HASH[self[0]]
+      LCClasses::LCClass.nest(i[:subclasses])
+    end
+    
+    # The class code.
+    def code; self[0] end
+    # THe class name.
+    def name; self[1] end
+  end
+  
+  # Library of Congress Main Classes and Subclasses
+  CLASS_HASH = {
+    "A" => { 
+      :name => "General Works",
+      :subclasses => {
+        "AC"   => { :name => "Collections; Series; Collected works" },
+        "AE"   => { :name => "Encyclopedias" },
+        "AG"   => { :name => "Dictionaries and other general reference works" },
+        "AI"   => { :name => "Indexes" },
+        "AM"   => { :name => "Museums. Collectors and collecting" },
+        "AN"   => { :name => "AN Newspapers" },
+        "AP"   => { :name => "Periodicals" },
+        "AS"   => { :name => "Academies and learned societies" },
+        "AY"   => { :name => "Yearbooks. Almanacs. Directories" },
+        "AZ"   => { :name => "History of scholarship and learning. The humanities" },
+      }
+    },
+    "B" => {
+      :name => "Philosophy, Psychology, Religion",
+      :subclasses => {
+        "B"    => { :name => "Philosophy (General)" },
+        "BC"   => { :name => "Logic" },
+        "BD"   => { :name => "Speculative philosophy" },
+        "BF"   => { :name => "Psychology" },
+        "BH"   => { :name => "Aesthetics" },
+        "BJ"   => { :name => "Ethics" },
+        "BL"   => { :name => "Religions; Mythology; Rationalism" },
+        "BM"   => { :name => "Judaism" },
+        "BP"   => { :name => "Islam; Bahaism; Theosophy, etc." },
+        "BQ"   => { :name => "Buddhism" },
+        "BR"   => { :name => "Christianity" },
+        "BS"   => { :name => "The Bible" },
+        "BT"   => { :name => "Doctrinal Theology" },
+        "BV"   => { :name => "Practical Theology" },
+        "BX"   => { :name => "Christian Denominations" },
+      }
+    },
+    "C" => {
+      :name => "Auxiliary Sciences of History (General)",
+      :subclasses => {
+        "CB"   => { :name => "History of Civilization" },
+        "CC"   => { :name => "Archaeology" },
+        "CD"   => { :name => "Diplomatics. Archives. Seals" },
+        "CE"   => { :name => "Technical Chronology. Calendar" },
+        "CJ"   => { :name => "Numismatics" },
+        "CN"   => { :name => "Inscriptions. Epigraphy" },
+        "CR"   => { :name => "Heraldry" },
+        "CS"   => { :name => "Genealogy" },
+        "CT"   => { :name => "Biography" },
+      }
+    },
+    "D" => {
+      :name => "World History and History of Europe, Asia, Africa, Australia, New Zealand, etc.",
+      :subclasses => {
+        "D"    => { :name => "History (General)" },
+        "DA"   => { :name => "Great Britain" },
+        "DAW"  => { :name => "Central Europe" },
+        "DB"   => { :name => "Austria - Liechtenstein - Hungary - Czechoslovakia" },
+        "DC"   => { :name => "France - Andorra - Monaco" },
+        "DD"   => { :name => "Germany" },
+        "DE"   => { :name => "Greco-Roman World" },
+        "DF"   => { :name => "Greece" },
+        "DG"   => { :name => "Italy - Malta" },
+        "DH"   => { :name => "Low Countries - Benelux Countries (Continued on next page)" },
+        "DJ"   => { :name => "Netherlands (Holland)" },
+        "DJK"  => { :name => "Eastern Europe (General)" },
+        "DK"   => { :name => "Russia. Soviet Union. Former Soviet Republics - Poland" },
+        "DL"   => { :name => "Northern Europe. Scandinavia" },
+        "DP"   => { :name => "Spain - Portugal" },
+        "DQ"   => { :name => "Switzerland" },
+        "DR"   => { :name => "Balkan Peninsula" },
+        "DS"   => { :name => "Asia" },
+        "DT"   => { :name => "Africa" },
+        "DU"   => { :name => "Oceania (South Seas)" },
+        "DX"   => { :name => "Gypsies" },
+      }
+    },
+    "E" => {
+      :name => "History of America, United States",
+    },
+    "F" => {
+      :name => "Local History of the United States and British, Dutch, French, and Latin America",
+    },
+    "G" => {
+      :name => "Geography, Anthropology, Recreation",
+      :subclasses => {
+        "G"  => { :name => "Geography (General). Atlases. Maps" },
+        "GA" => { :name => "Mathematical geography. Cartography" },
+        "GB" => { :name => "Physical geography" },
+        "GC" => { :name => "Oceanography" },
+        "GE" => { :name => "Environmental Sciences" },
+        "GF" => { :name => "Human ecology. Anthropogeography" },
+        "GN" => { :name => "Anthropology" },
+        "GR" => { :name => "Folklore" },
+        "GT" => { :name => "Manners and customs (General)" },
+        "GV" => { :name => "Recreation. Leisure" },
+      }
+    },
+    "H" => {
+      :name => "Social Sciences",
+      :subclasses => {
+        "H"  => { :name => "Social sciences (General)" },
+        "HA" => { :name => "Statistics" },
+        "HB" => { :name => "Economic theory. Demography" },
+        "HC" => { :name => "Economic history and conditions" },
+        "HD" => { :name => "Industries. Land use. Labor" },
+        "HE" => { :name => "Transportation and communications" },
+        "HF" => { :name => "Commerce" },
+        "HG" => { :name => "Finance" },
+        "HJ" => { :name => "Public finance" },
+        "HM" => { :name => "Sociology (General)" },
+        "HN" => { :name => "Social history and conditions. Social problems. Social reform" },
+        "HQ" => { :name => "The family. Marriage. Women" },
+        "HS" => { :name => "Societies: secret, benevolent, etc." },
+        "HT" => { :name => "Communities. Classes. Races" },
+        "HV" => { :name => "Social pathology. Social and public welfare. Criminology" },
+        "HX" => { :name => "Socialism. Communism. Anarchism" },
+      }
+    },
+    "J" => {
+      :name => "Political Sciences",
+      :subclasses => {
+        "J"  => { :name => "General legislative and executive papers" },
+        "JA" => { :name => "Political science (General)" },
+        "JC" => { :name => "Political theory" },
+        "JF" => { :name => "Political institutions and public administration" },
+        "JJ" => { :name => "Political institutions and public administration (North America)" },
+        "JK" => { :name => "Political institutions and public administration (United States)" },
+        "JL" => { :name => "Political institutions and public administration (Canada, Latin America, etc.)" },
+        "JN" => { :name => "Political institutions and public administration (Europe)" },
+        "JQ" => { :name => "Political institutions and public administration (Asia, Africa, Australia, Pacific Area, etc.)" },
+        "JS" => { :name => "Local government. Municipal government" },
+        "JV" => { :name => "Colonies and colonization. Emigration and immigration. International migration" },
+        "JX" => { :name => "International law, see JZ and KZ (obsolete)" },
+        "JZ" => { :name => "International relations" },
+      }
+    },
+    "K" => {
+      :name => "Law",
+      :subclasses => {
+        "K"       => { :name => "Law in general. Comparative and uniform law. Jurisprudence" },
+        "KB"      => { :name => "Religious law in general. Comparative religious law. Jurisprudence" },
+        "KBM"     => { :name => "Jewish law" },
+        "KBP"     => { :name => "Islamic law" },
+        "KBR"     => { :name => "History of canon law" },
+        "KBU"     => { :name => "Law of the Roman Catholic Church. The Holy See" },
+        "KD-KDK"  => { :name => "United Kingdom and Ireland" },
+        "KDZ"     => { :name => "America. North America" },
+        "KE"      => { :name => "Canada" },
+        "KF"      => { :name => "United States" },
+        "KG"      => { :name => "Latin America - Mexico and Central America - West Indies. Caribbean area" },
+        "KH"      => { :name => "South America" },
+        "KJ-KKZ"  => { :name => "Europe" },
+        "KL-KWX"  => { :name => "Asia and Eurasia, Africa, Pacific Area, and Antarctica" },
+        "KZ"      => { :name => "Law of nations" },
+      }
+    },
+    "L" => {
+      :name => "Education",
+      :subclasses => {
+        "L"  => { :name => "Education (General)" },
+        "LA" => { :name => "History of education" },
+        "LB" => { :name => "Theory and practice of education" },
+        "LC" => { :name => "Special aspects of education" },
+        "LD" => { :name => "Individual institutions - United States" },
+        "LE" => { :name => "Individual institutions - America (except United States)" },
+        "LF" => { :name => "Individual institutions - Europe" },
+        "LG" => { :name => "Individual institutions - Asia, Africa, Indian Ocean islands, Australia, New Zealand, Pacific islands" },
+        "LH" => { :name => "College and school magazines and papers" },
+        "LJ" => { :name => "Student fraternities and societies, United States" },
+        "LT" => { :name => "Textbooks" },
+      }
+    },
+    "M" => {
+      :name => "Music",
+      :subclasses => {
+        "M"  => { :name => "Music" },
+        "ML" => { :name => "Literature on music" },
+        "MT" => { :name => "Instruction and study" },
+      }
+    },
+    "N" => {
+      :name => "Fine Arts",
+      :subclasses => {
+        "N"  => { :name => "Visual arts" },
+        "NA" => { :name => "Architecture" },
+        "NB" => { :name => "Sculpture" },
+        "NC" => { :name => "Drawing. Design. Illustration" },
+        "ND" => { :name => "Painting" },
+        "NE" => { :name => "Print media" },
+        "NK" => { :name => "Decorative arts" },
+        "NX" => { :name => "Arts in general" },
+      }
+    },
+    "P" => {
+      :name => "Language and Literature",
+      :subclasses => {
+        "P"  => { :name => "Philology. Linguistics" },
+        "PA" => { :name => "Greek language and literature. Latin language and literature" },
+        "PB" => { :name => "Modern languages. Celtic languages" },
+        "PC" => { :name => "Romanic languages" },
+        "PD" => { :name => "Germanic languages. Scandinavian languages" },
+        "PE" => { :name => "English language" },
+        "PF" => { :name => "West Germanic languages" },
+        "PG" => { :name => "Slavic languages and literatures. Baltic languages. Albanian language" },
+        "PH" => { :name => "Uralic languages. Basque language" },
+        "PJ" => { :name => "Oriental languages and literatures" },
+        "PK" => { :name => "Indo-Iranian languages and literatures" },
+        "PL" => { :name => "Languages and literatures of Eastern Asia, Africa, Oceania" },
+        "PM" => { :name => "Hyperborean, Indian, and artificial languages" },
+        "PN" => { :name => "Literature (General)" },
+        "PQ" => { :name => "French literature - Italian literature - Spanish literature - Portuguese literature" },
+        "PR" => { :name => "English literature" },
+        "PS" => { :name => "American literature" },
+        "PT" => { :name => "German literature - Dutch literature - Flemish literature since 1830 -Afrikaans literature - Scandinavian literature - Old Norse literature: Old Icelandic and Old Norwegian - Modern Icelandic literature - Faroese literature - Danish literature - Norwegian literature - Swedish literature" },
+        "PZ" => { :name => "Fiction and juvenile belles lettres" },
+      }
+    },
+    "Q" => {
+      :name => "Science",
+      :subclasses => {
+        "Q"  => { :name => "Science (General)" },
+        "QA" => { :name => "Mathematics" },
+        "QB" => { :name => "Astronomy" },
+        "QC" => { :name => "Physics" },
+        "QD" => { :name => "Chemistry" },
+        "QE" => { :name => "Geology" },
+        "QH" => { :name => "Natural history - Biology" },
+        "QK" => { :name => "Botany" },
+        "QL" => { :name => "Zoology" },
+        "QM" => { :name => "Human anatomy" },
+        "QP" => { :name => "Physiology" },
+        "QR" => { :name => "Microbiology" },
+      }
+    },
+    "R" => {
+      :name => "Medicine",
+      :subclasses => {
+        "R"  => { :name => "Medicine (General)" },
+        "RA" => { :name => "Public aspects of medicine" },
+        "RB" => { :name => "Pathology" },
+        "RC" => { :name => "Internal medicine" },
+        "RD" => { :name => "Surgery" },
+        "RE" => { :name => "Ophthalmology" },
+        "RF" => { :name => "Otorhinolaryngology" },
+        "RG" => { :name => "Gynecology and obstetrics" },
+        "RJ" => { :name => "Pediatrics" },
+        "RK" => { :name => "Dentistry" },
+        "RL" => { :name => "Dermatology" },
+        "RM" => { :name => "Therapeutics. Pharmacology" },
+        "RS" => { :name => "Pharmacy and materia medica" },
+        "RT" => { :name => "Nursing" },
+        "RV" => { :name => "Botanic, Thomsonian, and eclectic medicine" },
+        "RX" => { :name => "Homeopathy" },
+        "RZ" => { :name => "Other systems of medicine" },
+      }
+    },
+    "S" => {
+      :name => "Agriculture",
+      :subclasses => {
+        "S"  => { :name => "Agriculture (General)" },
+        "SB" => { :name => "Plant culture" },
+        "SD" => { :name => "Forestry" },
+        "SF" => { :name => "Animal culture" },
+        "SH" => { :name => "Aquaculture. Fisheries. Angling" },
+        "SK" => { :name => "Hunting sports" },
+      }
+    },
+    "T" => {
+      :name => "Technology",
+      :subclasses => {
+        "T"  => { :name => "Technology (General)" },
+        "TA" => { :name => "Engineering (General). Civil engineering" },
+        "TC" => { :name => "Hydraulic engineering. Ocean engineering" },
+        "TD" => { :name => "Environmental technology. Sanitary engineering" },
+        "TE" => { :name => "Highway engineering. Roads and pavements" },
+        "TF" => { :name => "Railroad engineering and operation" },
+        "TG" => { :name => "Bridge engineering" },
+        "TH" => { :name => "Building construction" },
+        "TJ" => { :name => "Mechanical engineering and machinery" },
+        "TK" => { :name => "Electrical engineering. Electronics. Nuclear engineering" },
+        "TL" => { :name => "Motor vehicles. Aeronautics. Astronautics" },
+        "TN" => { :name => "Mining engineering. Metallurgy" },
+        "TP" => { :name => "Chemical technology" },
+        "TR" => { :name => "Photography" },
+        "TS" => { :name => "Manufactures" },
+        "TT" => { :name => "Handicrafts. Arts and crafts" },
+        "TX" => { :name => "Home economics" },
+      }
+    },
+    "U" => {
+      :name => "Military Science",
+      :subclasses => {
+        "U"  => { :name => "Military science (General)" },
+        "UA" => { :name => "Armies: Organization, distribution, military situation" },
+        "UB" => { :name => "Military administration" },
+        "UC" => { :name => "Maintenance and transportation" },
+        "UD" => { :name => "Infantry" },
+        "UE" => { :name => "Cavalry. Armor" },
+        "UF" => { :name => "Artillery" },
+        "UG" => { :name => "Military engineering. Air forces" },
+        "UH" => { :name => "Other services" },
+      }
+    },
+    "V" => {
+      :name => "Naval Science",
+      :subclasses => {
+        "V"  => { :name => "Naval science (General)" },
+        "VA" => { :name => "Navies: Organization, distribution, naval situation" },
+        "VB" => { :name => "Naval administration" },
+        "VC" => { :name => "Naval maintenance" },
+        "VD" => { :name => "Naval seamen" },
+        "VE" => { :name => "Marines" },
+        "VF" => { :name => "Naval ordnance" },
+        "VG" => { :name => "Minor services of navies" },
+        "VK" => { :name => "Navigation. Merchant marine" },
+        "VM" => { :name => "Naval architecture. Shipbuilding. Marine engineering" },
+      }
+    },
+    "Z" => {
+      :name => "Bibliography, Library Science",
+      :subclasses => {
+        "Z"   => { :name => "Books (General). Writing. Paleography. Book industries and trade. Libraries. Bibliography" },
+        "ZA"  => { :name => "Information resources (General)" },
+      }
+    }
+  }
+  
+  # An array of main LC Classes.
+  def self.main_classes
+    CLASS_HASH.map do |k,v|
+      LCClasses::LCClass[k,v[:name]]
+    end.sort
+  end
+  
+  # An array of all LC Subclasses.
+  def self.subclasses
+    self.main_classes.inject([]) do |result, main_class|
+      result += main_class.subclasses
+    end
+  end
+  
+  # A nested array of main classes and subclasses.
+  def self.nested
+    LCClasses::LCClass.nest(LCClasses::CLASS_HASH)
+  end
+  
+  # All main classes and subclasses in a flat array.
+  def self.flat
+    LCClasses::LCClass.flatten(LCClasses::CLASS_HASH)
+  end
+  
+  # Find an main classe by code.
+  def self.find_main_class_by_code(code)
+    LCClasses.main_classes.detect { |i| i[0] == code.to_s }
+  end
+  
+  # Find a subclass by code.
+  def self.find_subclass_by_code(code)
+    LCClasses.subclasses.detect { |i| i[0] == code.to_s }
+  end
+  
+  # Find all main classes and subclass that match or start with a code or character.
+  def self.find_all_by_code(code)
+    LCClasses.flat.select { |i| i[0] if (i[0] =~ /^#{code}[A-Z]?[A-Z]?/) }
+  end
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'lcclasses'
+
+class Test::Unit::TestCase
+end

data/test/test_lcclasses.rb

@@ -0,0 +1,72 @@
+require 'test_helper'
+
+class TestLCClasses < Test::Unit::TestCase
+  
+  should "return main classes" do
+    assert_equal 21, LCClasses.main_classes.length
+  end
+  
+  should "return subclasses" do
+    assert_equal 223, LCClasses.subclasses.length
+  end
+  
+  should "should return flat" do
+    assert_equal 244, LCClasses.flat.length
+  end
+  
+  should "should return nested" do
+    assert_equal 21, LCClasses.nested.length
+    assert_equal 223, LCClasses.nested.inject([]) { |r, m| r += m.subclasses }.length
+  end
+  
+  should "find main class by code" do
+    assert_equal ["T", "Technology (General)"], LCClasses.find_subclass_by_code("T")
+  end
+  
+  should "find subclass by code" do
+    assert_equal ["AM", "Museums. Collectors and collecting"], LCClasses.find_subclass_by_code("AM")
+  end
+  
+  should "find all by code" do
+    assert_equal [["E", "History of America, United States"]], LCClasses.find_all_by_code("E")
+    assert_equal 11, LCClasses.find_all_by_code("A").length
+  end
+  
+  context "LCCLass" do
+  
+    setup {
+      @hash = { 
+        "A" => { 
+          :name => "General Works",
+          :subclasses => {
+            "AC"   => { :name => "Collections; Series; Collected works" }
+          }
+        }
+      }
+    }
+  
+    should "flatten code hash" do
+      assert_equal(
+        [["A", "General Works"], ["AC", "Collections; Series; Collected works"]],
+        LCClasses::LCClass.flatten(@hash)
+      )
+    end
+    
+    should "nest code hash" do
+      assert_equal(
+        [["A", "General Works", [["AC", "Collections; Series; Collected works"]]]],
+        LCClasses::LCClass.nest(@hash)
+      )
+    end
+    
+    should "return subclasses" do
+      assert_equal 3, LCClasses.find_main_class_by_code("M").subclasses.length
+      assert_equal 0, LCClasses.find_main_class_by_code("E").subclasses.length
+    end
+    
+    should "respond to code and name" do
+      assert_equal "A", LCClasses::LCClass["A", "General Works"].code
+      assert_equal "General Works", LCClasses::LCClass["A", "General Works"].name
+    end
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: lcclasses
+version: !ruby/object:Gem::Version 
+  version: 0.0.0
+platform: ruby
+authors: 
+- William Melody
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-25 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thoughtbot-shoulda
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Library of Congress Classification classes and subclasses
+email: hi@williammelody.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- lcclasses.gemspec
+- lib/lcclasses.rb
+- test/test_helper.rb
+- test/test_lcclasses.rb
+has_rdoc: true
+homepage: http://github.com/autodata/lcclasses
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Library of Congress Classification classes and subclasses
+test_files: 
+- test/test_helper.rb
+- test/test_lcclasses.rb