rdoc-markdown 0.2.1 → 0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16494339df3b522fae317e9010c0a9ee8cae1a7f4452595c8fde01e238421c64
-  data.tar.gz: 1dec9b05ccdea281811213800b2301a4f89097dcaacbf72ac59fa7c85aeff676
+  metadata.gz: 022adabd6f2ced45f3d5ff3216b48376914f7ba7b80cc1b87d83e8d7507824d7
+  data.tar.gz: 5d9a514dbbcf570811d0a3f230a2eff9434d61413cf994500bb6fd1f1f49a5d2
 SHA512:
-  metadata.gz: 30b4a879efd549f01f627558c390b34b05aece87ce14fe46293770e342c90fdaf176457b50fad52f215de6aa91b7477607601530d8874f60869570e9990b043d
-  data.tar.gz: 76947d62302a58b3ceeb41d78be86dcbe7d6032fa41579e9287567aecda5bf23c7271bfb453c8125d9dd6d6b934bd5de996637145a2ba377f068f8198909c82a
+  metadata.gz: 41604d7644f1e4a437f79c3fcbc868c71189355e4b4ae79be430bd313e7729970d8029af95e2d649c71226079acef183329a1b63c1ce500a00815fa82ef587c1
+  data.tar.gz: f0a44ac4166d92a26b5166c8a290cbcfe16970b8d20c4f8c92ea4f0b5c3a1ae9a23ffe0348f79323c22caad9687eddb0d82346da3a31ba5b7594aeb39dd5e971

data/Gemfile.lock

@@ -1,8 +1,7 @@
 PATH
   remote: .
   specs:
-    rdoc-markdown (0.2.1)
-      activesupport (~> 7.0)
+    rdoc-markdown (0.3)
       erb (~> 2.0)
       extralite-bundle (~> 1.0)
       rdoc (~> 6.0)
@@ -12,19 +11,11 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.0.4)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      tzinfo (~> 2.0)
     ast (2.4.2)
     cgi (0.3.3)
-    concurrent-ruby (1.1.10)
     erb (2.2.3)
       cgi
     extralite-bundle (1.16)
-    i18n (1.12.0)
-      concurrent-ruby (~> 1.0)
     json (2.6.2)
     minitest (5.16.3)
     nokogiri (1.13.9-arm64-darwin)
@@ -66,8 +57,6 @@ GEM
       rubocop (= 1.35.1)
       rubocop-performance (= 1.14.3)
     stringio (3.0.2)
-    tzinfo (2.0.5)
-      concurrent-ruby (~> 1.0)
     unicode-display_width (2.3.0)
     unindent (1.0)
 

data/README.md

@@ -1,5 +1,5 @@
 # Rdoc::Markdown
-Rdoc Generator plugin to generate markdown documentation and search index as sqlite database that goes along with it.
+RDoc plugin to generate markdown documentation and search index as sqlite database for entire content.
 
 ## Installation
 

data/lib/rdoc/generator/markdown.rb

@@ -5,9 +5,8 @@ gem "rdoc"
 require "pathname"
 require "erb"
 require "reverse_markdown"
-require 'extralite'
-require 'active_support/core_ext/string/inflections'
-require 'unindent'
+require "extralite"
+require "unindent"
 
 class RDoc::Generator::Markdown
   RDoc::RDoc.add_generator self
@@ -95,7 +94,7 @@ class RDoc::Generator::Markdown
   # This class emits a search index for generated documentation as sqlite database
   #
 
-  def emit_sqlite(name="index.db")
+  def emit_sqlite(name = "index.db")
     db = Extralite::Database.new("#{output_dir}/#{name}")
 
     db.execute <<-SQL
@@ -130,7 +129,7 @@ class RDoc::Generator::Markdown
         result << {
           name: "#{klass.full_name}.#{const.name}",
           type: "Constant",
-          path: "#{turn_to_path(klass.full_name)}##{ActiveSupport::Inflector.parameterize const.name}"
+          path: "#{turn_to_path(klass.full_name)}##{const.name}"
         }
       end
 
@@ -150,19 +149,6 @@ class RDoc::Generator::Markdown
 
   def emit_classfiles
     @classes.each do |klass|
-      klass_methods = []
-      instance_methods = []
-
-      klass.method_list.each do |method|
-        next if method.visibility.to_s.eql?("private")
-
-        if method.type == "class"
-          klass_methods << method
-        else
-          instance_methods << method
-        end
-      end
-
       template = ERB.new File.read(File.join(TEMPLATE_DIR, "classfile.md.erb"))
 
       out_file = Pathname.new("#{output_dir}/#{turn_to_path klass.full_name}")
@@ -185,7 +171,7 @@ class RDoc::Generator::Markdown
   # Converts HTML string into a Markdown string with some cleaning and improvements.
 
   def markdownify(input)
-    md= ReverseMarkdown.convert input, github_flavored: true
+    md = ReverseMarkdown.convert input
 
     # unintent multiline strings
     md.unindent!
@@ -196,14 +182,10 @@ class RDoc::Generator::Markdown
 
       "[#{match[1]}](#{match[2]}.md#{match[3]})"
     end
-
-    # clean up things, to make it look neat.
-
-    md.gsub("[↑](#top)", "").lstrip
   end
 
   # Aliasing a shorter method name for use in templates
-  alias_method  :h, :markdownify
+  alias_method :h, :markdownify
 
   ##
   # Prepares for document generation, by creating required folders and initializing variables.
@@ -219,14 +201,4 @@ class RDoc::Generator::Markdown
 
     @classes = @store.all_classes_and_modules.sort
   end
-
-  ##
-  # Return a list of the documented modules sorted by salience first, then
-  # by name.
-
-  def get_sorted_module_list classes
-    classes.select do |klass|
-      klass.display?
-    end.sort
-  end
 end

data/lib/rdoc/markdown/version.rb

@@ -2,6 +2,6 @@
 
 module Rdoc
   module Markdown
-    VERSION = "0.2.1"
+    VERSION = "0.3"
   end
 end

data/lib/templates/classfile.md.erb

@@ -1,23 +1,31 @@
-# <% if klass.type == 'class' %><%= klass.type.capitalize %>: **<%= klass.full_name %>**<% if klass.superclass %> < <% end %><% unless String === klass.superclass %><%= klass.superclass&.name %> <% else %> <%= klass.superclass %> <% end %> <% else %> <%= klass.type.capitalize %>: <%= klass&.name %> <% end %>
+# <%= klass.type %> <%= klass.full_name.strip %> [](#<%= klass.aref.strip %>) [](#top)
 <%= h klass.description %>
-<% unless klass.constants.empty? %>
-| Constants | Description |
-| ------------- | ------------- |
-<% klass.constants.sort_by { |x| x.name }.each do |const| %> |**[<%= const.name %>](#<%= ActiveSupport::Inflector.parameterize const.name%>)** | <%= h const.description %> |
-<% end %><% end %>
-<% unless klass.attributes.empty? %>
+<% klass.each_section do |section, constants, attributes| %>
+  <% if section.title %>## <%= section.title.strip %> <% end %>
+  <% if section.comment %> <%=h  section.description %><% end%>
+  <% unless klass.constants.empty? %>
+## Constants
+    <% klass.constants.each do |const| %>
+### <%= const.name.strip %>[](#<%= const.name.strip %>)
+<% if const.comment %> <%= h const.description %> <%else%> (Not documented) <% end %>
+    <% end %>
+  <% end %>
+  <% unless attributes&.empty? %>
 ## Attributes
-<% klass.attributes.sort_by { |x| x.name }.each do |attr| %>
-  [[**<%= attr.rw %>**] <%= attr.name %>](#<%= attr.aref %>)
-<% end %><% end %>
-<% unless klass_methods.empty? %>
-## Public Class Methods
-***
-<% klass_methods.each do |method| %>### [<%= method.name %><%= method.params %>](#<%= method.aref %>)
-
-<%= h method.description %><% end %><% end %>
-<% unless instance_methods.empty? %>
-## Public Instance Methods
-<% instance_methods.each do |method| %>### [<%= method.name %><%= method.params %>](#<%= method.aref %>)
-
-<%= h method.description %><% end %><% end %>
+    <% attributes.each do |attr| %>
+### <%= attr.rw %><%=h attr.name.strip %>[](#<%= attr.aref.strip %>)
+<% if attr.comment %> <%= h attr.description %> <%else%> (Not documented) <% end %>
+    <% end %>
+  <% end %>
+  <% klass.methods_by_type(section).each do |type, visibilities| %>
+    <% next if visibilities.empty? %>
+    <% visibilities.each do |visibility, methods| %>
+      <% next if methods.empty? %>
+##  <%= visibility.capitalize %> <%= type.capitalize %> Methods
+      <% methods.each do |method|%>
+### <%= method.name.strip %><%= method.param_seq.strip %> [](#<%= method.aref.strip %>)
+<% if method.comment %> <%= h method.description %>  <% else %> (Not documented) <%end%>
+      <% end %>
+    <% end %>
+  <% end %>
+<% end %>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rdoc-markdown
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: '0.3'
 platform: ruby
 authors:
 - Stanislav (Stas) Katkov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-23 00:00:00.000000000 Z
+date: 2022-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdoc
@@ -66,20 +66,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: unindent
   requirement: !ruby/object:Gem::Requirement