shomen-rdoc 0.1.0

data/spec/10_interface_overloading.rdoc

@@ -0,0 +1,94 @@
+== RDoc Method Interface Overloading
+
+RDoc supports the `:call-seq:` directive for defining "virtual"
+method interfaces. Given a file +lib/example.rb+ containing a class
+with a documented method using the directive:
+
+  class ExampleClass
+    # Example method using call-seq directive.
+    #
+    # :call-seq:
+    #   my_method(flazm, saszm) -> nil
+    #   my_method(bunny) { |ears| ... } -> true or false
+    #
+    def my_method(a1,a2=nil,&b)
+    end
+  end
+
+Running the script through shomen via rdoc the signatures list
+should have only three entries.
+
+  example = @shomen['ExampleClass#my_method']
+  example['interfaces'].size  #=> 3
+
+=== Literal Interface
+
+Lets get a closer look at the last signature, which is always 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 last 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-rdoc'
+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::Rdoc::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,105 @@
+--- !ruby/object:Gem::Specification
+name: shomen-rdoc
+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: rdoc
+  requirement: &24413160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: *24413160
+- !ruby/object:Gem::Dependency
+  name: shomen-model
+  requirement: &24411900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *24411900
+- !ruby/object:Gem::Dependency
+  name: detroit
+  requirement: &24410840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *24410840
+description: ! 'Shomen RDoc provides a command line utility for generating Shomen
+  standard
+
+  documentation via the RDoc''s `.rdoc` cache. It is an alternative to the
+
+  `rdoc-shomen` format plugin.'
+email:
+- transfire@gmail.com
+executables:
+- shomen-rdoc
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- HISTORY.rdoc
+- README.rdoc
+files:
+- .ruby
+- bin/shomen-rdoc
+- lib/shomen-rdoc/command.rb
+- lib/shomen-rdoc/generator.rb
+- lib/shomen-rdoc/rdoc_ext.rb
+- lib/shomen-rdoc.rb
+- lib/shomen-rdoc.yml
+- 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
+- HISTORY.rdoc
+- LICENSE.txt
+- README.rdoc
+homepage: http://rubyworks.github.com/shomen-rdoc
+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 Documentation via RDoc
+test_files: []