shomen-yard 0.1.0

data/spec/10_interface_overloading.rdoc

@@ -0,0 +1,97 @@
+== YARD Method Signature Overloading
+
+YARD supports the `@overload` tag for defining "virtual" method interfaces.
+Given a file +lib/example.rb+ containing a class with a documented method
+using the overload tag:
+
+  class ExampleClass
+    # Example method using overload directive.
+    #
+    # @overload my_method(flazm, saszm)
+    #   @param [String] flazm
+    #   @param [String] saszm
+    #
+    # @overload my_method(bunny){ |ears| ... } -> true or false
+    #   @param [String] bunny
+    #
+    def my_method(a1,a2=nil,&b)
+    end
+  end
+
+Running the script through shomen via yard the signatures list should have
+three entries, the literal interface and the two virtual interfaces.
+
+  example = @shomen['ExampleClass#my_method']
+  example['interfaces'].size  #=> 3
+
+=== Literal Interface
+
+Lets get a closer look at the last signature, which is alway the literal
+interface.
+
+  signature = example['interfaces'].last
+
+The first signature should match the literal definition.
+
+  signature['signature']  #=> 'my_method(a1,a2=nil,&b)'
+
+And the arguments should be detailed as expected.
+
+  signature['arguments'][0]['name']      #=> 'a1'
+  signature['arguments'][0]['default']   #=> nil
+
+  signature['arguments'][1]['name']      #=> 'a2'
+  signature['arguments'][1]['default']   #=> 'nil'
+
+As should the block argument.
+
+  signature['block']['name']  #=> '&b'
+
+=== Virtual Interface
+
+The second and third signatures should conform to those given in
+under the `:call-seq:` directive.
+
+Lets get a closer look at the first of these.
+
+  signature = example['interfaces'][0]
+
+The signature should match the provided image.
+
+  signature['signature']  #=> 'my_method(flazm, saszm)'
+
+And the arguments should be detailed as expected.
+
+  signature['arguments'][0]['name']      #=> 'flazm'
+  signature['arguments'][0]['default']   #=> nil
+
+  signature['arguments'][1]['name']      #=> 'saszm'
+  signature['arguments'][1]['default']   #=> nil
+
+This virtual signature does not specify a block so the block argument
+should return `nil`.
+
+  signature['block']  #=> nil
+
+Now lets' look at the second virtual signature.
+
+  signature = example['interfaces'][1]
+
+The signature should match the provided image.
+
+  signature['signature']  #=> 'my_method(bunny)'
+
+And the arguments should be detailed as expected.
+
+  signature['arguments'][0]['name']      #=> 'bunny'
+  signature['arguments'][0]['default']   #=> nil
+
+This virtual signature does specify a block, but not as an argument, but rather
+as a representation the call arguments.
+
+  signature['block']['image']  #=> '{ |ears| ... }'
+
+This signature also give a returns description.
+
+  signature['returns']  #=> 'true or false'
+

data/spec/applique/ae.rb

@@ -0,0 +1 @@
+require 'ae'

data/spec/applique/shomen.rb

@@ -0,0 +1,24 @@
+require 'shomen-yard'
+require 'stringio'
+
+#Before :all do
+  if not File.exist?('.ruby')
+    dotruby = "---\nname: example\n"
+    File.open('.ruby', 'w'){ |f| f << dotruby }
+  end
+#end
+
+When 'Given a file +(((.*?)))+' do |file, text|
+  @file = file
+  FileUtils.mkdir_p(File.dirname(file))
+  File.open(file, 'w'){ |f| f << text }
+end
+
+When 'Running the script through shomen' do
+  output = ''
+  $stdout = StringIO.new(output,'w+')
+  Shomen::Yard::Command.run('--yaml', @file)
+  $stdout.close
+  @shomen = YAML.load(output)
+end
+

data/spec/fixture/lib/example.rb

@@ -0,0 +1,52 @@
+# This is an example toplevel class method.
+def self.example_toplevel_method_class_method
+end
+
+# This is an example toplevel instance method.
+def example_toplevel_method
+end
+
+# This is an example module.
+module ExampleModule
+
+  # This is an example constant in a module.
+  EXAMPLE_CONSTANT = "example constant in a module"
+
+  # This is an example class method in a module.
+  def self.example_class_method
+  end
+
+  # This is an example instance method in a module.
+  def example_method
+  end
+
+end
+
+# This is an example class.
+class ExampleClass
+
+  # This is an example constant in a class.
+  EXAMPLE_CONSTANT = "example constant in a class"
+
+  # This is an example class method in a class.
+  def self.example_class_method
+  end
+
+  # This is an example attribute.
+  attr :example_attribute
+
+  # This is an example attribute reader.
+  attr_reader :example_attribute_reader
+
+  # This is an example attribute writer.
+  attr_writer :example_attribute_writer
+
+  # This is an example attribute accessor.
+  attr_accessor :example_attribute_accessor
+
+  # This is an example instance method in a class.
+  def example_method
+  end
+
+end
+

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: shomen-yard
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- trans
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &17741400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *17741400
+- !ruby/object:Gem::Dependency
+  name: shomen-model
+  requirement: &17740140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *17740140
+- !ruby/object:Gem::Dependency
+  name: detroit
+  requirement: &17738980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *17738980
+description: ! 'Shomen YARD is a utiliity for generating Shomen documentation file
+
+  using YARD as a backend parser.'
+email:
+- transfire@gmail.com
+executables:
+- shomen-yard
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- HISTORY.md
+- README.md
+files:
+- .ruby
+- .yardopts
+- bin/shomen-yard
+- lib/shomen-yard/command.rb
+- lib/shomen-yard/generator.rb
+- lib/shomen-yard.rb
+- spec/01_metadata.rdoc
+- spec/02_class.rdoc
+- spec/03_module.rdoc
+- spec/04_constant.rdoc
+- spec/05_method.rdoc
+- spec/10_interface_overloading.rdoc
+- spec/applique/ae.rb
+- spec/applique/shomen.rb
+- spec/fixture/lib/example.rb
+- LICENSE.txt
+- HISTORY.md
+- README.md
+homepage: http://rubyworks.github.com/shomen-yard
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Shomen via YARD command line utility
+test_files: []