Class: YARD::Serializers::FileSystemSerializer

Inherits:
Base
  • Object
show all
Defined in:
lib/yard/serializers/file_system_serializer.rb

Overview

Implements a serializer that reads from and writes to the filesystem.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(opts = {}) ⇒ FileSystemSerializer

Creates a new FileSystemSerializer with options

Parameters:

  • opts (Hash) (defaults to: {})

    a customizable set of options

Options Hash (opts):

  • :basepath (String) — default: 'doc'

    the base path to write data to

  • :extension (String) — default: 'html'

    the extension of the serialized path filename. If this is set to the empty string, no extension is used.



28
29
30
31
32
33
# File 'lib/yard/serializers/file_system_serializer.rb', line 28

def initialize(opts = {})
  super
  @name_map = nil
  @basepath = (options[:basepath] || 'doc').to_s
  @extension = (options.key?(:extension) ? options[:extension] : 'html').to_s
end

Instance Attribute Details

#basepathString

The base path to write data to.

Returns:



8
9
10
# File 'lib/yard/serializers/file_system_serializer.rb', line 8

def basepath
  @basepath
end

#extensionString

The extension of the filename (defaults to html)

Returns:

  • (String)

    the extension of the file. Empty string for no extension.



17
18
19
# File 'lib/yard/serializers/file_system_serializer.rb', line 17

def extension
  @extension
end

Instance Method Details

#exists?(object) ⇒ Boolean

Checks the disk for an object and returns whether it was serialized.

Parameters:

Returns:

  • (Boolean)

    whether an object has been serialized to disk



71
72
73
# File 'lib/yard/serializers/file_system_serializer.rb', line 71

def exists?(object)
  File.exist?(File.join(basepath, serialized_path(object)))
end

#serialize(object, data) ⇒ String

Serializes object with data to its serialized path (prefixed by the #basepath).

Returns:

  • (String)

    the written data (for chaining)



38
39
40
41
42
# File 'lib/yard/serializers/file_system_serializer.rb', line 38

def serialize(object, data)
  path = File.join(basepath, serialized_path(object))
  log.debug "Serializing to #{path}"
  File.open!(path, "wb") {|f| f.write data }
end

#serialized_path(object) ⇒ String

Implements the serialized path of a code object.

Parameters:

Returns:

  • (String)

    if object is a String, returns object, otherwise the path on disk (without the basepath).



50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# File 'lib/yard/serializers/file_system_serializer.rb', line 50

def serialized_path(object)
  return object if object.is_a?(String)

  if object.is_a?(CodeObjects::ExtraFileObject)
    fspath = ['file.' + object.name + (extension.empty? ? '' : ".#{extension}")]
  else
    objname = object != YARD::Registry.root ? mapped_name(object) : "top-level-namespace"
    objname += '_' + object.scope.to_s[0, 1] if object.is_a?(CodeObjects::MethodObject)
    fspath = [objname + (extension.empty? ? '' : ".#{extension}")]
    if object.namespace && object.namespace.path != ""
      fspath.unshift(*object.namespace.path.split(CodeObjects::NSEP))
    end
  end

  File.join(encode_path_components(*fspath))
end