require 'zlib'
require 'fileutils'
require 'sitemap_generator/helpers/number_helper'
module SitemapGenerator
module Builder
#
# General Usage:
#
# sitemap = SitemapFile.new(:location => SitemapLocation.new(...))
# sitemap.add('/', { ... }) <- add a link to the sitemap
# sitemap.finalize! <- write the sitemap file and freeze the object to protect it from further modification
#
class SitemapFile
include SitemapGenerator::Helpers::NumberHelper
attr_reader :link_count, :filesize, :location, :news_count
# === Options
#
# * location - a SitemapGenerator::SitemapLocation instance or a Hash of options
# from which a SitemapLocation will be created for you. See `SitemapGenerator::SitemapLocation` for
# the supported list of options.
def initialize(opts={})
@location = opts.is_a?(Hash) ? SitemapGenerator::SitemapLocation.new(opts) : opts
@link_count = 0
@news_count = 0
@xml_content = '' # XML urlset content
@xml_wrapper_start = <<-HTML
HTML
@xml_wrapper_start.gsub!(/\s+/, ' ').gsub!(/ *> */, '>').strip!
@xml_wrapper_end = %q[]
@filesize = SitemapGenerator::Utilities.bytesize(@xml_wrapper_start) + SitemapGenerator::Utilities.bytesize(@xml_wrapper_end)
@written = false
@reserved_name = nil # holds the name reserved from the namer
@frozen = false # rather than actually freeze, use this boolean
end
# If a name has been reserved, use the last modified time from the file.
# Otherwise return nil. We don't want to prematurely assign a name
# for this sitemap if one has not yet been reserved, because we may
# mess up the name-assignment sequence.
def lastmod
File.mtime(location.path) if location.reserved_name?
rescue
nil
end
def empty?
@link_count == 0
end
# Return a boolean indicating whether the sitemap file can fit another link
# of bytes bytes in size. You can also pass a string and the
# bytesize will be calculated for you.
def file_can_fit?(bytes)
bytes = bytes.is_a?(String) ? SitemapGenerator::Utilities.bytesize(bytes) : bytes
(@filesize + bytes) < SitemapGenerator::MAX_SITEMAP_FILESIZE && @link_count < max_sitemap_links && @news_count < SitemapGenerator::MAX_SITEMAP_NEWS
end
# Add a link to the sitemap file.
#
# If a link cannot be added, for example if the file is too large or the link
# limit has been reached, a SitemapGenerator::SitemapFullError exception is raised
# and the sitemap is finalized.
#
# If the Sitemap has already been finalized a SitemapGenerator::SitemapFinalizedError
# exception is raised.
#
# Return the new link count.
#
# Call with:
# sitemap_url - a SitemapUrl instance
# sitemap, options - a Sitemap instance and options hash
# path, options - a path for the URL and options hash. For supported options
# see the SitemapGenerator::Builder::SitemapUrl class.
#
# The link added to the sitemap will use the host from its location object
# if no host has been specified.
def add(link, options={})
raise SitemapGenerator::SitemapFinalizedError if finalized?
sitemap_url = if link.is_a?(SitemapUrl)
link
else
options[:host] ||= @location.host
SitemapUrl.new(link, options)
end
xml = sitemap_url.to_xml
raise SitemapGenerator::SitemapFullError if !file_can_fit?(xml)
if sitemap_url.news?
@news_count += 1
end
# Add the XML to the sitemap
@xml_content << xml
@filesize += SitemapGenerator::Utilities.bytesize(xml)
@link_count += 1
end
# "Freeze" this object. Actually just flags it as frozen.
#
# A SitemapGenerator::SitemapFinalizedError exception is raised if the Sitemap
# has already been finalized.
def finalize!
raise SitemapGenerator::SitemapFinalizedError if finalized?
@frozen = true
end
def finalized?
@frozen
end
# Write out the sitemap and free up memory.
#
# All the xml content in the instance is cleared, but attributes like
# filesize are still available.
#
# A SitemapGenerator::SitemapError exception is raised if the file has
# already been written.
def write
raise SitemapGenerator::SitemapError.new("Sitemap already written!") if written?
finalize! unless finalized?
reserve_name
@location.write(@xml_wrapper_start + @xml_content + @xml_wrapper_end, link_count)
@xml_content = @xml_wrapper_start = @xml_wrapper_end = ''
@written = true
end
# Return true if this file has been written out to disk
def written?
@written
end
# Reserve a name from the namer unless one has already been reserved.
# Safe to call more than once.
def reserve_name
@reserved_name ||= @location.reserve_name
end
# Return a boolean indicating whether a name has been reserved
def reserved_name?
!!@reserved_name
end
# Return a new instance of the sitemap file with the same options,
# and the next name in the sequence.
def new
location = @location.dup
location.delete(:filename) if location.namer
self.class.new(location)
end
def max_sitemap_links
@location[:max_sitemap_links] || SitemapGenerator::MAX_SITEMAP_LINKS
end
end
end
end