Module: YARD

Defined in:

lib/yard.rb,
lib/yard/logging.rb,
lib/yard/cli/yri.rb,
lib/yard/cli/diff.rb,
lib/yard/cli/gems.rb,
lib/yard/verifier.rb,
lib/yard/cli/help.rb,
lib/yard/tags/tag.rb,
lib/yard/autoload.rb,
lib/yard/registry.rb,
lib/yard/cli/graph.rb,
lib/yard/docstring.rb,
lib/yard/cli/stats.rb,
lib/yard/cli/yardoc.rb,
lib/yard/cli/server.rb,
lib/yard/parser/base.rb,
lib/yard/cli/command.rb,
lib/yard/tags/ref_tag.rb,
lib/yard/tags/library.rb,
lib/yard/server/router.rb,
lib/yard/handlers/base.rb,
lib/yard/server/adapter.rb,
lib/yard/registry_store.rb,
lib/yard/tags/option_tag.rb,
lib/yard/parser/c_parser.rb,
lib/yard/serializers/base.rb,
lib/yard/templates/engine.rb,
lib/yard/tags/default_tag.rb,
lib/yard/rake/yardoc_task.rb,
lib/yard/templates/section.rb,
lib/yard/tags/ref_tag_list.rb,
lib/yard/code_objects/base.rb,
lib/yard/tags/overload_tag.rb,
lib/yard/cli/command_parser.rb,
lib/yard/handlers/ruby/base.rb,
lib/yard/code_objects/proxy.rb,
lib/yard/handlers/processor.rb,
lib/yard/templates/template.rb,
lib/yard/templates/erb_cache.rb,
lib/yard/server/rack_adapter.rb,
lib/yard/tags/default_factory.rb,
lib/yard/parser/source_parser.rb,
lib/yard/parser/ruby/ast_node.rb,
lib/yard/server/commands/base.rb,
lib/yard/tags/tag_format_error.rb,
lib/yard/server/static_caching.rb,
lib/yard/server/webrick_adapter.rb,
lib/yard/server/library_version.rb,
lib/yard/parser/ruby/ruby_parser.rb,
lib/yard/code_objects/root_object.rb,
lib/yard/server/doc_server_helper.rb,
lib/yard/handlers/ruby/legacy/base.rb,
lib/yard/parser/ruby/legacy/ruby_lex.rb,
lib/yard/server/commands/list_command.rb,
lib/yard/parser/ruby/legacy/statement.rb,
lib/yard/templates/helpers/uml_helper.rb,
lib/yard/server/doc_server_serializer.rb,
lib/yard/serializers/stdout_serializer.rb,
lib/yard/templates/helpers/text_helper.rb,
lib/yard/templates/helpers/html_helper.rb,
lib/yard/serializers/yardoc_serializer.rb,
lib/yard/parser/ruby/legacy/token_list.rb,
lib/yard/serializers/process_serializer.rb,
lib/yard/server/commands/search_command.rb,
lib/yard/server/commands/frames_command.rb,
lib/yard/parser/ruby/legacy/ruby_parser.rb,
lib/yard/templates/helpers/module_helper.rb,
lib/yard/templates/helpers/method_helper.rb,
lib/yard/templates/helpers/filter_helper.rb,
lib/yard/templates/helpers/markup_helper.rb,
lib/yard/server/commands/library_command.rb,
lib/yard/parser/ruby/legacy/statement_list.rb,
lib/yard/serializers/file_system_serializer.rb,
lib/yard/server/commands/static_file_command.rb,
lib/yard/server/commands/display_file_command.rb,
lib/yard/server/commands/library_index_command.rb,
lib/yard/server/commands/display_object_command.rb,
lib/yard/templates/helpers/html_syntax_highlight_helper.rb,
lib/yard/templates/helpers/html_syntax_highlight_helper18.rb

Constant Summary

Class Method Summary (collapse)

• + (true) load_plugins

  Loads gems that match the name 'yard-*' (recommended) or 'yard_*' except those listed in ~/.yard/ignored_plugins.

• + (Object) parse(*args)

  An alias to Parser::SourceParser's parsing method.

• + (Object) parse_string(*args)

  An alias to Parser::SourceParser's parsing method.

32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# File 'lib/yard.rb', line 32

def self.load_plugins
  ignored_plugins_file = File.join(CONFIG_DIR, "ignored_plugins")
  if File.file?(ignored_plugins_file)
    ignored_plugins = IO.read(ignored_plugins_file).split(/\s+/)
  else
    ignored_plugins = []
  end
  
  Gem.source_index.find_name('').each do |gem|
    begin
      if gem.name =~ /^yard[-_](?!doc-)/ && !ignored_plugins.include?(gem.name)
        log.debug "Loading plugin '#{gem.name}'..."
        require gem.name 
      end
    rescue Gem::LoadError, LoadError
      log.warn "Error loading plugin '#{gem.name}'"
    end
  end
  true
end

YARD.parse('lib/**/*.rb')

18

# File 'lib/yard.rb', line 18

def self.parse(*args) Parser::SourceParser.parse(*args) end

YARD.parse_string('class Foo; end')

25

# File 'lib/yard.rb', line 25

def self.parse_string(*args) Parser::SourceParser.parse_string(*args) end