yard 0.9.23 → 0.9.27

data/spec/templates/examples/module004.html

@@ -1,394 +0,0 @@
-<h1>Class: A
-  
-  
-  
-</h1>
-<div class="box_info">
-  
-  <dl>
-    <dt>Inherits:</dt>
-    <dd>
-      <span class="inheritName">Object</span>
-      
-        <ul class="fullTree">
-          <li>Object</li>
-          
-            <li class="next">A</li>
-          
-        </ul>
-        <a href="#" class="inheritanceTree">show all</a>
-      
-    </dd>
-  </dl>
-  
-
-  
-  
-  <dl>
-      <dt>Extended by:</dt>
-      <dd>Bar</dd>
-  </dl>
-  
-  
-  
-  <dl>
-      <dt>Includes:</dt>
-      <dd>BarFooBar, Baz::ABC, Baz::XYZ, Foo</dd>
-  </dl>
-  
-  
-
-  
-
-  
-  <dl>
-    <dt>Defined in:</dt>
-    <dd>(stdin)</dd>
-  </dl>
-  
-</div>
-
-
-
-
-
-  <h2>Instance Attribute Summary <small><a href="#" class="summary_toggle">collapse</a></small></h2>
-  <ul class="summary">
-    
-      <li class="public ">
-  <span class="summary_signature">
-    
-      <a  title="#bar_attr (instance method)">#<strong>bar_attr</strong>  </a>
-    
-
-    
-  </span>
-  
-    <span class="note title not_defined_here">
-      included
-      from Foo
-    </span>
-  
-  
-  
-    
-    
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'>Docs for bar_attr.</div></span>
-  
-</li>
-
-    
-  </ul>
-
-
-
-
-  
-    <h2>
-      Booya
-      <small><a href="#" class="summary_toggle">collapse</a></small>
-    </h2>
-
-    <ul class="summary">
-      
-        <li class="public ">
-  <span class="summary_signature">
-    
-      <a  title="#baz (class method)">.<strong>baz</strong>  </a>
-    
-
-    
-  </span>
-  
-    <span class="note title not_defined_here">
-      extended
-      from Bar
-    </span>
-  
-  
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'>Docs for baz in Booya group.</div></span>
-  
-</li>
-
-      
-        <li class="public ">
-  <span class="summary_signature">
-    
-      <a  title="#baz_abc (instance method)">#<strong>baz_abc</strong>  </a>
-    
-
-    
-  </span>
-  
-    <span class="note title not_defined_here">
-      included
-      from Baz::ABC
-    </span>
-  
-  
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'></div></span>
-  
-</li>
-
-      
-    </ul>
-  
-    <h2>
-      Instance Method Summary
-      <small><a href="#" class="summary_toggle">collapse</a></small>
-    </h2>
-
-    <ul class="summary">
-      
-        <li class="public ">
-  <span class="summary_signature">
-    
-      <a  title="#foo (instance method)">#<strong>foo</strong>  </a>
-    
-
-    
-  </span>
-  
-  
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'>This method is in A.</div></span>
-  
-</li>
-
-      
-        <li class="public ">
-  <span class="summary_signature">
-    
-      <a  title="#xyz (instance method)">#<strong>xyz</strong>  </a>
-    
-
-    
-  </span>
-  
-    <span class="note title not_defined_here">
-      included
-      from Foo
-    </span>
-  
-  
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'>Docs for xyz.</div></span>
-  
-</li>
-
-      
-    </ul>
-  
-
-
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  <h3 class="inherited">Methods included from Baz::XYZ</h3>
-  <p class="inherited">#baz_xyz</p>
-
-  
-  
-  
-  
-  
-  
-  
-  
-  <h3 class="inherited">Methods included from BarFooBar</h3>
-  <p class="inherited">#bar_foo_bar</p>
-
-  
-  
-  <div id="instance_attr_details" class="attr_details">
-    <h2>Instance Attribute Details</h2>
-    
-      
-      <span id="bar_attr=-instance_method"></span>
-      <div class="method_details first">
-  <h3 class="signature first" id="bar_attr-instance_method">
-  
-    #<strong>bar_attr</strong>  
-  
-
-  
-
-  
-    <span class="not_defined_here">
-      Originally defined in module
-        Foo
-    </span>
-  
-</h3><div class="docstring">
-  <div class="discussion">
-    Docs for bar_attr
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div>
-</div>
-    
-  </div>
-
-
-  <div id="class_method_details" class="method_details_list">
-    <h2>Class Method Details</h2>
-
-    
-      <div class="method_details first">
-  <h3 class="signature first" id="baz-class_method">
-  
-    .<strong>baz</strong>  
-  
-
-  
-
-  
-    <span class="not_defined_here">
-      Originally defined in module
-        Bar
-    </span>
-  
-</h3><div class="docstring">
-  <div class="discussion">
-    Docs for baz in Booya group
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div>
-</div>
-    
-  </div>
-
-  <div id="instance_method_details" class="method_details_list">
-    <h2>Instance Method Details</h2>
-
-    
-      <div class="method_details first">
-  <h3 class="signature first" id="baz_abc-instance_method">
-  
-    #<strong>baz_abc</strong>  
-  
-
-  
-
-  
-    <span class="not_defined_here">
-      Originally defined in module
-        Baz::ABC
-    </span>
-  
-</h3>
-</div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="foo-instance_method">
-  
-    #<strong>foo</strong>  
-  
-
-  
-
-  
-</h3><div class="docstring">
-  <div class="discussion">
-    This method is in A
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-
-
-3</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File '(stdin)', line 3</span>
-
-def foo; end</pre>
-    </td>
-  </tr>
-</table>
-</div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="xyz-instance_method">
-  
-    #<strong>xyz</strong>  
-  
-
-  
-
-  
-    <span class="not_defined_here">
-      Originally defined in module
-        Foo
-    </span>
-  
-</h3><div class="docstring">
-  <div class="discussion">
-    Docs for xyz
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div>
-</div>
-    
-  </div>
-

data/spec/templates/examples/module005.html

@@ -1,82 +0,0 @@
-<h1>Module: A
-
-
-
-</h1>
-<div class="box_info">
-
-
-
-
-
-
-
-
-
-
-
-  <dl>
-    <dt>Defined in:</dt>
-    <dd>(stdin)</dd>
-  </dl>
-
-</div>
-
-
-
-    <h2>
-      Foo
-      <small><a href="#" class="constants_summary_toggle">collapse</a></small>
-    </h2>
-
-    <dl class="constants">
-
-        <dt id="FOO-constant" class="">FOO =
-
-        </dt>
-        <dd><pre class="code">1</pre></dd>
-
-        <dt id="BAR-constant" class="deprecated">BAR =
-          <div class="docstring">
-  <div class="discussion">
-    <div class="note deprecated"><strong>Deprecated.</strong> <div class='inline'></div></div>
-
-
-  </div>
-</div>
-<div class="tags">
-
-
-</div>
-        </dt>
-        <dd><pre class="code">2</pre></dd>
-
-    </dl>
-
-    <h2>
-      Bar
-      <small><a href="#" class="constants_summary_toggle">collapse</a></small>
-    </h2>
-
-    <dl class="constants">
-
-        <dt id="BAZ-constant" class="">BAZ =
-
-        </dt>
-        <dd><pre class="code">3</pre></dd>
-
-    </dl>
-
-    <h2>
-      Constant Summary
-      <small><a href="#" class="constants_summary_toggle">collapse</a></small>
-    </h2>
-
-    <dl class="constants">
-
-        <dt id="WORLD-constant" class="">WORLD =
-
-        </dt>
-        <dd><pre class="code">4</pre></dd>
-
-    </dl>

data/spec/templates/examples/tag001.txt

@@ -1,82 +0,0 @@
-------------------------------------------------------------- Method: #m
-                                                   (Defined in: (stdin))
-
-    root.m(opts = {}) {|a| ... } -> String 
-------------------------------------------------------------------------
-
-    Deprecated. for great justice
-
-    Abstract. override me
-
-    Comments 
-
-Examples:
----------
-
-    # Wash your car
-    car.wash
-
-    # To kill a mockingbird
-    a = String.new
-    flip(a.reverse)
-
-Parameters:
------------
-
-    (Hash) opts - the options
-
-Options Hash (opts):
---------------------
-
-    (Object) :key - default: '' - hello
-
-    (Object) :key2 - default: X - hello
-
-Yields:
--------
-
-    - a block
-
-Yield Parameters:
------------------
-
-    (String) a - a value
-
-Yield Returns:
---------------
-
-    (Hash) - a hash
-
-Returns:
---------
-
-    (String) - the result
-
-Raises:
--------
-
-    (Exception) - Exception class
-
-See Also:
----------
-
-    - A
-    - http://url.com
-    - http://url.com - Example
-
-Author:
--------
-
-    Name
-
-Since:
-------
-
-    1.0
-
-Version:
---------
-
-    1.0
-
-

data/spec/templates/helpers/base_helper_spec.rb

@@ -1,171 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.describe YARD::Templates::Helpers::BaseHelper do
-  include YARD::Templates::Helpers::BaseHelper
-
-  describe "#run_verifier" do
-    it "runs verifier proc against list if provided" do
-      mock = Verifier.new
-      expect(mock).to receive(:call).with(1)
-      expect(mock).to receive(:call).with(2)
-      expect(mock).to receive(:call).with(3)
-      expect(self).to receive(:options).at_least(1).times.and_return(Options.new.update(:verifier => mock))
-      run_verifier [1, 2, 3]
-    end
-
-    it "prunes list if lambda returns false and only false" do
-      mock = Verifier.new
-      expect(self).to receive(:options).at_least(1).times.and_return(Options.new.update(:verifier => mock))
-      expect(mock).to receive(:call).with(1).and_return(false)
-      expect(mock).to receive(:call).with(2).and_return(true)
-      expect(mock).to receive(:call).with(3).and_return(nil)
-      expect(mock).to receive(:call).with(4).and_return("value")
-      expect(run_verifier([1, 2, 3, 4])).to eq [2, 3, 4]
-    end
-
-    it "returns list if no verifier exists" do
-      expect(self).to receive(:options).at_least(1).times.and_return(Options.new)
-      expect(run_verifier([1, 2, 3])).to eq [1, 2, 3]
-    end
-  end
-
-  describe "#h" do
-    it "returns just the text" do
-      expect(h("hello world")).to eq "hello world"
-      expect(h(nil)).to eq nil
-    end
-  end
-
-  describe "#link_object" do
-    it "returns the title if provided" do
-      expect(link_object(1, "title")).to eq "title"
-      expect(link_object(Registry.root, "title")).to eq "title"
-    end
-
-    it "returns a path if argument is a Proxy or object" do
-      expect(link_object(Registry.root)).to eq "Top Level Namespace"
-      expect(link_object(P("Array"))).to eq "Array"
-    end
-
-    it "returns path of Proxified object if argument is a String or Symbol" do
-      expect(link_object("Array")).to eq "Array"
-      expect(link_object(:"A::B")).to eq "A::B"
-    end
-
-    it "returns the argument if not an object, proxy, String or Symbol" do
-      expect(link_object(1)).to eq 1
-    end
-  end
-
-  describe "#link_url" do
-    it "returns the URL" do
-      expect(link_url("http://url")).to eq "http://url"
-    end
-  end
-
-  describe "#linkify" do
-    let(:object) { Registry.root }
-    # before do
-    #   stub!(:object).and_return(Registry.root)
-    # end
-
-    it "calls #link_url for mailto: links" do
-      expect(self).to receive(:link_url)
-      linkify("mailto:steve@example.com")
-    end
-
-    it "calls #link_url for URL schemes (http://)" do
-      expect(self).to receive(:link_url)
-      linkify("http://example.com")
-    end
-
-    it "calls #link_file for file: links" do
-      expect(self).to receive(:link_file).with('Filename', nil, 'anchor')
-      linkify("file:Filename#anchor")
-    end
-
-    it "passes off to #link_object if argument is an object" do
-      obj = CodeObjects::NamespaceObject.new(nil, :YARD)
-      expect(self).to receive(:link_object).with(obj)
-      linkify obj
-    end
-
-    it "returns empty string and warn if object does not exist" do
-      expect(log).to receive(:warn).with(/Cannot find object .* for inclusion/)
-      expect(linkify('include:NotExist')).to eq ''
-    end
-
-    it "passes off to #link_url if argument is recognized as a URL" do
-      url = "http://yardoc.org/"
-      expect(self).to receive(:link_url).with(url, nil, :target => '_parent')
-      linkify url
-    end
-
-    it "calls #link_include_object for include:ObjectName" do
-      obj = CodeObjects::NamespaceObject.new(:root, :Foo)
-      expect(self).to receive(:link_include_object).with(obj)
-      linkify 'include:Foo'
-    end
-
-    it "calls #link_include_file for include:file:path/to/file" do
-      expect(File).to receive(:file?).with('path/to/file').and_return(true)
-      expect(File).to receive(:read).with('path/to/file').and_return('FOO')
-      expect(linkify('include:file:path/to/file')).to eq 'FOO'
-    end
-
-    it "does not allow include:file for path above pwd" do
-      expect(log).to receive(:warn).with("Cannot include file from path `a/b/../../../../file'")
-      expect(linkify('include:file:a/b/../../../../file')).to eq ''
-    end
-
-    it "warns if include:file:path does not exist" do
-      expect(log).to receive(:warn).with(/Cannot find file .+ for inclusion/)
-      expect(linkify('include:file:notexist')).to eq ''
-    end
-  end
-
-  describe "#format_types" do
-    it "returns the list of types separated by commas surrounded by brackets" do
-      expect(format_types(['a', 'b', 'c'])).to eq '(a, b, c)'
-    end
-
-    it "returns the list of types without brackets if brackets=false" do
-      expect(format_types(['a', 'b', 'c'], false)).to eq 'a, b, c'
-    end
-
-    it "returns an empty string if list is empty or nil" do
-      expect(format_types(nil)).to eq ""
-      expect(format_types([])).to eq ""
-    end
-  end
-
-  describe "#format_object_type" do
-    it "returns Exception if type is Exception" do
-      obj = double(:object, :is_exception? => true)
-      allow(obj).to receive(:is_a?) {|arg| arg == YARD::CodeObjects::ClassObject }
-      expect(format_object_type(obj)).to eq "Exception"
-    end
-
-    it "returns Class if type is Class" do
-      obj = double(:object, :is_exception? => false)
-      allow(obj).to receive(:is_a?) {|arg| arg == YARD::CodeObjects::ClassObject }
-      expect(format_object_type(obj)).to eq "Class"
-    end
-
-    it "returns object type in other cases" do
-      obj = double(:object, :type => "value")
-      expect(format_object_type(obj)).to eq "Value"
-    end
-  end
-
-  describe "#format_object_title" do
-    it "returns Top Level Namespace for root object" do
-      expect(format_object_title(Registry.root)).to eq "Top Level Namespace"
-    end
-
-    it "returns 'type: title' in other cases" do
-      obj = double(:object, :type => :class, :title => "A::B::C")
-      expect(format_object_title(obj)).to eq "Class: A::B::C"
-    end
-  end
-end