marc 0.1.6 → 0.1.7

data/Changes

@@ -0,0 +1,99 @@
+v0.1.7 Mon Nov 12 09:33:57 EST 2007
+- updated Record.to_marc documentation to be a bit more precise
+- removed doc references to MARC::Field which is no longer around
+- changed from Artistic to MIT License
+
+v0.1.6 Fri May  4 12:37:33 EDT 2007
+- fixed bad record length test
+- removed MARC::XMLWriter convert_to_utf8 which wasn't really working and
+  shouldn't be there if it isn't good
+- added unescaping of entities to MARC::XMLReader
+
+v0.1.5 Tue May  1 16:50:02 EDT 2007
+- docfix in MARC::DataField (thanks Jason Ronallo)
+- multiple docfixes (thanks Jonathan Rochkind)
+
+v0.1.4 Tue Jan  2 15:45:53 EST 2007
+- fixed bug in MARC::XMLWriter that was outputting all control field tags as 00z
+  (thanks Ross Singer)
+- added :include_namespace option to MARC::XMLWriter::encode to include the
+  marcxml namespace, which allows MARC::Record::to_xml to emit the namespace 
+  for a single record.
+
+v0.1.3  Tue Jan  2 12:56:36 EST 2007
+- added ability to map a MARC record to the Dublin Core fields.  Calling
+  to_dublin_core on a MARC::Record returns a hash that has Dublin Core fields
+  as the hash keys.
+
+v0.1.2  Thu Dec 21 18:46:01 EST 2007
+- fixed MARC::Record::to_xml so that it actually is tested and works (thanks 
+  Ross Singer)
+
+v0.1.1
+- added ability to pass File like objects to the constructor for 
+  MARC::XMLReader like MARC::Reader (thanks Jake Glenn)
+
+v0.1.0  Wed Dec  6 15:40:40 EST 2006
+- fixed pretty xml when stylesheet is used
+- added value() to MARC::DataField
+- added Rakefile for testing/building
+
+v0.0.9  Tue Mar 28 10:02:16 CST 2006
+- changed XMLWriter.write to output pretty-printed XML
+- normalized Text in XML output
+- added XMLWriter checks and replacements for bad subfield codes and indicator
+  values
+- added XMLWriter check and replacement for invalid control codes in xml data
+  values
+- added XMLWriter checks for values in the leader that are invalid MARCXML
+- added bin/marc2xml
+- collapsed tc_xmlreader.rb tc_xmlwriter.rb into tc_xml.rb for full write/read
+  test.
+- added :stylesheet argument to XLMWriter.new
+
+v0.0.8  Mon Jan 16 22:31:00 EST 2006
+- removed control tests out of tc_field.rb into tc_control.rb 
+- fixed some formatting
+- changed control/field to controlfield/datafield
+- added == check for controlfield
+- removed namespace declarations on record elements in favor of default 
+  namespace on collection element
+- added spaces around subfield code and delimeter in to_s
+- fixed up relevant tests that were expecting old formatting
+- fixed xmlreader strip_ns which was rerturning Nil when no namespace
+  was found on an element (exposed by namespace changes).
+
+v0.0.7  Mon Jan  2 21:39:28 CST 2006
+- MARC::XMLWriter added
+- removed encode/decode methods in MARC::MARC21 into MARC::Writer and 
+  MARC::Reader respectively. This required pushing MARC21 specific constants 
+  out into MARC::Constants which is required as necessary.
+- moved encode from MARC::MARXML into MARC::XMLWriter and added constants
+  to MARC::Constants
+- added MARC::XMLReader for reading MARX as XML
+- added xml reading tests
+- fixed indentation to be two spaces
+
+v0.0.6  Tue Oct 18 09:33:12 CDT 2005
+- MARC::MARC21::decode throws an exception when a directory can't be found.
+  Exception is caught and ignored in MARC::ForgivingReader
+
+v0.0.5  Tue Oct 18 01:50:40 CDT 2005
+- when unspecified field indicators are forced to blanks
+- checking for when a field appears to not have indicators and subfields in
+  which case the field is skipped entirely
+
+v0.0.4  Tue Oct 18 00:39:50 CDT 2005
+- fixed off by one error when reading in leader, previous versions were
+  reading an extra character
+
+v0.0.3  Mon Oct 17 22:51:23 CDT 2005
+- added ForgivingReader class and support for reading records without using
+  possibly faulty offsets when the user needs them.
+
+v0.0.2  Mon Oct 17 17:42:57 CDT 2005
+- updated version string to see if it'll fix some gem oddness
+
+v0.0.1  Mon Oct 10 10:29:20 CDT 2005
+- initial release
+

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2007 Ed Summers, Kevin Clarke, Will Groppe
+
+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

@@ -0,0 +1,50 @@
+marc is a ruby library for reading and writing MAchine Readable Cataloging
+(MARC). More information about MARC can be found at <http://www.loc.gov/marc>.
+
+USAGE 
+
+  require 'marc'
+
+  # reading records from a batch file
+  reader = MARC::Reader.new('marc.dat')
+  for record in reader
+    # print out field 245 subfield a
+    puts record['245']['a']
+  end
+
+  # creating a record 
+  record = MARC::Record.new()
+  record.append(MARC::DataField.new('100', '0',  ' ', ['a', 'John Doe']))
+
+  # writing a record
+  writer = MARC::Writer.new('marc.dat')
+  writer.write(record)
+  writer.close()
+
+  # writing a record as XML
+  writer = MARC::XMLWriter.new('marc.xml')
+  writer.write(record)
+  writer.close()
+
+INSTALLATION
+
+If you are looking at this file you may want to be able to install the code. 
+First you'll need to test:
+
+  rake test
+
+then build the gem:
+
+  rake package
+
+and install the versioned gem:
+
+  gem install pkg/marc-x.x.x.gem 
+
+AUTHORS
+
+Kevin Clarke <ksclarke@gmail.com>
+William Groppe <will.groppe@gmail.com>
+Ed Summers <ehs@pobox.com>
+
+Please send bugs, requests and comments to the authors. 

data/Rakefile

@@ -0,0 +1,46 @@
+RUBY_MARC_VERSION = '0.1.7'
+
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+
+task :default => [:test]
+
+Rake::TestTask.new('test') do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/tc_*.rb'
+  t.verbose = true
+  t.ruby_opts = ['-r marc', '-r test/unit']
+end
+
+spec = Gem::Specification.new do |s|
+  s.name = 'marc'
+  s.version = RUBY_MARC_VERSION
+  s.author = 'Ed Summers'
+  s.email = 'ehs@pobox.com'
+  s.homepage = 'http://www.textualize.com/ruby_marc'
+  s.platform = Gem::Platform::RUBY
+  s.summary = 'A ruby library for working with Machine Readable Cataloging'
+  s.files = Dir.glob("{lib,test}/**/*") + ["Rakefile", "README", "Changes",
+    "LICENSE"]
+  s.require_path = 'lib'
+  s.autorequire = 'marc'
+  s.has_rdoc = true
+  
+  s.test_file = 'test/ts_marc.rb'
+  s.bindir = 'bin'
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+Rake::RDocTask.new('doc') do |rd|
+  rd.rdoc_files.include("lib/**/*.rb")
+  rd.main = 'MARC::Record'
+  rd.rdoc_dir = 'doc'
+end

data/lib/marc/datafield.rb

@@ -60,7 +60,7 @@ module MARC
       # must use MARC::ControlField for tags < 010
       if @tag.to_i < 10
         raise MARC::Exception.new(),
-          "MARC::Field objects can't have tags < 010"
+          "MARC::DataField objects can't have tags < 010"
       end
 
       # allows MARC::Subfield objects to be passed directly

data/lib/marc/record.rb

@@ -35,7 +35,7 @@ module MARC
     end
 
     # add a field to the record
-    #   record.append(MARC::Field.new( '100', '2', '0', ['a', 'Fred']))
+    #   record.append(MARC::DataField.new( '100', '2', '0', ['a', 'Fred']))
 
     def append(field)
       @fields.push(field)
@@ -89,10 +89,9 @@ module MARC
     end
 
 
-    # Handy method for returning a the MARC21 serialization for a 
-    # MARC::Record object. Really this is just a wrapper around
-    # MARC::MARC21::encode
-    # 
+    # Returns a record in MARC21 transmission format (ANSI Z39.2). 
+    # Really this is just a wrapper around MARC::MARC21::encode
+    #
     #   marc = record.to_marc()
 
     def to_marc 

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.2
 specification_version: 1
 name: marc
 version: !ruby/object:Gem::Version 
-  version: 0.1.6
-date: 2007-05-04 00:00:00 -04:00
+  version: 0.1.7
+date: 2007-11-12 00:00:00 -05:00
 summary: A ruby library for working with Machine Readable Cataloging
 require_paths: 
 - lib
@@ -30,30 +30,34 @@ authors:
 - Ed Summers
 files: 
 - lib/marc
+- lib/marc.rb
+- lib/marc/constants.rb
 - lib/marc/controlfield.rb
 - lib/marc/datafield.rb
-- lib/marc/subfield.rb
-- lib/marc/xmlwriter.rb
+- lib/marc/dublincore.rb
 - lib/marc/exception.rb
-- lib/marc/record.rb
 - lib/marc/reader.rb
-- lib/marc/xmlreader.rb
-- lib/marc/dublincore.rb
-- lib/marc/constants.rb
+- lib/marc/record.rb
+- lib/marc/subfield.rb
 - lib/marc/writer.rb
-- lib/marc.rb
-- test/tc_datafield.rb
+- lib/marc/xmlreader.rb
+- lib/marc/xmlwriter.rb
+- test/batch.dat
 - test/batch.xml
-- test/tc_writer.rb
+- test/one.dat
 - test/tc_controlfield.rb
-- test/tc_subfield.rb
+- test/tc_datafield.rb
+- test/tc_dublincore.rb
+- test/tc_reader.rb
 - test/tc_record.rb
-- test/batch.dat
-- test/one.dat
+- test/tc_subfield.rb
+- test/tc_writer.rb
 - test/tc_xml.rb
-- test/tc_reader.rb
 - test/ts_marc.rb
-- test/tc_dublincore.rb
+- Rakefile
+- README
+- Changes
+- LICENSE
 test_files: 
 - test/ts_marc.rb
 rdoc_options: []