ComicInfo Ruby Gem

gem 'comicinfo'

require 'comicinfo'

# Load from file path
comic = ComicInfo.load 'path/to/ComicInfo.xml'

# Load from XML string
xml_content = File.read 'ComicInfo.xml'
comic       = ComicInfo.load xml_content

# Basic information
puts comic.title  #=> "The Amazing Spider-Man"
puts comic.series #=> "The Amazing Spider-Man"
puts comic.number #=> "1"
puts comic.count  #=> 600
puts comic.volume #=> 3

# Publication details
puts comic.publisher #=> "Marvel Comics"
puts comic.year      #=> 2018
puts comic.month     #=> 3
puts comic.day       #=> 15

# Creator information
puts comic.writer       #=> "Dan Slott, Christos Gage"
puts comic.penciller    #=> "Ryan Ottley"
puts comic.cover_artist #=> "Ryan Ottley"

# Content details
puts comic.page_count   #=> 20
puts comic.genre        #=> "Superhero, Action, Adventure"
puts comic.language_iso #=> "en-US"
puts comic.format       #=> "Digital"

# Ratings and reviews
puts comic.age_rating       #=> "Teen"
puts comic.community_rating #=> 4.25

# Boolean helpers
puts comic.manga?           #=> false
puts comic.right_to_left?   #=> false
puts comic.black_and_white? #=> false

# Page information
puts comic.pages?       #=> true
puts comic.pages.length #=> 12

# Get specific page types
covers  = comic.cover_pages
stories = comic.story_pages

# Multi-value fields as arrays
characters = comic.characters #=> ["Spider-Man", "Peter Parker", ...]
teams      = comic.teams      #=> ["Avengers"]
locations  = comic.locations  #=> ["New York City", "Manhattan", ...]
genres     = comic.genres     #=> ["Superhero", "Action", "Adventure"]
web_urls   = comic.web_urls   #=> ["https://marvel.com/...", "https://comicvine.com/..."]

# Raw data methods for original comma-separated strings
genres_raw     = comic.genres_raw_data     #=> "Superhero, Action, Adventure"
characters_raw = comic.characters_raw_data #=> "Spider-Man, Peter Parker, J. Jonah Jameson, Aunt May"
story_arcs_raw = comic.story_arcs_raw_data #=> "Brand New Day, Spider-Island"

# Singular schema elements alias to plural arrays
genre          = comic.genre          #=> ["Superhero", "Action", "Adventure"] (same as genres)
story_arc      = comic.story_arc      #=> ["Brand New Day", "Spider-Island"] (same as story_arcs)
story_arc_num  = comic.story_arc_number #=> ["1", "5"] (same as story_arc_numbers)

comic.pages.each do |page|
  puts "Page #{page.image}: #{page.type}"
  puts "  Double page: #{page.double_page?}"                    if page.double_page?
  puts "  Bookmark: #{page.bookmark}"                           if page.bookmarked?
  puts "  Dimensions: #{page.image_width}x#{page.image_height}" if page.dimensions_available?
end

# Page type checks
page = comic.pages.first
puts page.cover?   #=> true for FrontCover, BackCover, InnerCover
puts page.story?   #=> true for Story pages
puts page.deleted? #=> true for Deleted pages

# Load a manga ComicInfo file
manga = ComicInfo.load 'path/to/manga/ComicInfo.xml'

puts manga.title            #=> "進撃の巨人"
puts manga.series           #=> "Attack on Titan"
puts manga.manga            #=> "YesAndRightToLeft"
puts manga.right_to_left?   #=> true
puts manga.language_iso     #=> "ja-JP"
puts manga.black_and_white? #=> true
puts manga.black_and_white  #=> "Yes"

begin
  comic = ComicInfo.load('nonexistent.xml')
rescue ComicInfo::Errors::FileError => e
  puts "File error: #{e.message}"
rescue ComicInfo::Errors::ParseError => e
  puts "Parse error: #{e.message}"
rescue ComicInfo::Errors::InvalidEnumError => e
  puts "Invalid enum: #{e.field} = '#{e.value}', valid: #{e.valid_values}"
rescue ComicInfo::Errors::RangeError => e
  puts "Out of range: #{e.field} = #{e.value}, range: #{e.min}..#{e.max}"
rescue ComicInfo::Errors::TypeCoercionError => e
  puts "Type coercion error: #{e.message}"
end

comic = ComicInfo.load 'path/to/ComicInfo.xml'

# Export as JSON
json_string = comic.to_json
puts JSON.pretty_generate(JSON.parse(json_string))

# Export as YAML
yaml_string = comic.to_yaml
puts yaml_string

# Generate XML
xml_string = comic.to_xml
puts xml_string

# Save to file
comic.save 'path/to/new/ComicInfo.xml'

# Save to IO object
File.open('path/to/new/ComicInfo.xml', 'w') do |file|
  comic.save file
end

# Export as Hash
hash = comic.to_h
puts hash[:title]                   #=> "The Amazing Spider-Man"
puts hash[:genre]                   #=> "Superhero, Action, Adventure" (raw data)
puts hash[:genres]                  #=> ["Superhero", "Action", "Adventure"] (parsed array)
puts hash[:genres_raw_data]         #=> "Superhero, Action, Adventure" (same as :genre)
puts hash[:characters]              #=> ["Spider-Man", "Peter Parker", ...]
puts hash[:characters_raw_data]     #=> "Spider-Man, Peter Parker, J. Jonah Jameson, Aunt May"
puts hash[:pages].length            #=> 12