JPMarc

A library for using JPMARC in Elixir

Installation

Add jpmarc to your list of dependencies in mix.exs:

def deps do
  [{:jpmarc, github: "zuki/jpmarc"}]
end

Usage

alias JPMarc.Record
alias JPMarc.Leader
alias JPMarc.ControlField, as: CF
alias JPMarc.DataField, as: DF
alias JPMarc.SubField, as: SF
import JPMarc.MarkSigil

# Read MARC file and process every MARC record

for record <- JPMarc.parse_file("marc.dat") do
  # Print a value of field 245, subfield a
  IO.puts Record.subfield_value(record, "245", "a")
end

# Construct a JPMarc.Record

leader = %Leader{}
t001 = %CF{tag: "001", value: "1234"}
t003 = %CF{tag: "003", value: "JTNDL"}
t245a = %SF{code: "a", value: "Book title /"}
t245c = %SF{code: "c", value: "Yamada, Taro."}
t245 = %DF{tag: "245", ind1: "0", ind2: "0", subfields: [t245a, t245c]}
record = %Record{leader: leader, fields: [t001, t003, t245]}

# Construct a JPMarc.Record with ~m sigil
record = %Record{leader: %Leader{}, fields: [~m"001 1234", ~m"003 JTNDL", ~m"245 00 $a Book title / $b Yamada, Taro."]}

# Write records in MARC format
File.write("marc.dat", JPMarc.to_marc(record))

# Write records in MARCXML format
File.write("marc.xml", JPMarc.to_xml(record))

# Write records in Mark-in-json format
File.write("marc.json", JPMarc.to_json(record))

# Write records in Text format
File.write("marc.txt", Record.to_text(record))

~m Sigil

Covert string in Text MARC format to JPMarc.Record.

# Record
record = ~m"""
00276nam a2200109zi 4500
001 123456789012
003 JTNDL
005 20170209103923.0
007 ta
008 170209s2017    ja ||||g |||| |||||||jpn
020    $c 2000 $z 978-4-123456-01-0
245 00 $a Book title : $b subtitle / $c Yamada Taro.
"""

IO.puts Record.subfield_value(record, "245", "a") # -> "Book title : "

# Leader
leader = ~m"00276nam a2200109zi 4500"

# Control field
cf = ~m"001 123456789012"

# Data field
df = ~m"245 00 $a Book title : $b subtitle / $c Yamada Taro."

# fields
fields = ~m"""
001 123456789012
245 00 $a Book title : $b subtitle / $c Yamada Taro.
"""

length(fields) # -> 2
JPMarc.is_controlfield(Enum.at(fields, 0)) # -> true
JPMarc.is_datafield(Enum.at(fields, 1)) # -> true

API documents

mix docs

open "doc/index.html"

License

This software released under the MIT License.