asciidoctor-jenkins-extensions 0.4.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ee1c1c33177b20cfad6e9dee7ca15929dcfa2d8a
-  data.tar.gz: 5e88024460fc5ecb4e62197ea751b64e6a0c72b4
+SHA256:
+  metadata.gz: 44db75a4df011538a44e50cbdc49212d4f82f8a8b8ce781994edfca135ba1759
+  data.tar.gz: 761ef5559a64cc161b9bf7cae7270a0fcfe089db18d911c7109f26040c8152aa
 SHA512:
-  metadata.gz: 667f68027379155a97b278addaf22adf68192f6881bbe7d443de6c48a282e8c15e59766e95c0a6e58d85bc95c64e90fb1cecb878cc2fdd5fe75144911f7df5c5
-  data.tar.gz: f6f612f16c54321f846ff3ef62c166a740c4740477d6d509383a2cc862f93c725e1b84954d994920c807ea6c41cb1070f84789946d35c5b65fb848d2a2461577
+  metadata.gz: 5d015413168e06e810655ad5095056ed50cebd946526925cdcf9578add61eb53ee28d40acf2a8866c135898dcdd0ae2b5b9fbcdf59377601a9640182937924bb
+  data.tar.gz: f84b081cb1d5162d2230ebfadf588d52050ff908e9fdfcd806f2a23eebf06abd9028fd9db1e52245bc75aa4a00d958461df148e1a1a3e5796e22c142974b6bb9

data/asciidoctor-jenkins-extensions.gemspec

@@ -26,11 +26,11 @@ formatting in Jenkins-related content.
   spec.require_paths = ["lib"]
 
 
-  spec.add_dependency 'asciidoctor', '~> 1.5.5'
+  spec.add_dependency 'asciidoctor', '>= 1.5.5'
   spec.add_dependency 'coderay', '~> 1.1.1'
   spec.add_dependency 'colorize', '~> 0.8.1'
 
-  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "bundler", "~> 2.0"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec"
   spec.add_development_dependency "rspec-its"

data/lib/asciidoctor/jenkins/extensions/author-link.rb

@@ -0,0 +1,24 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+#
+# Usage:
+# author:timja[Tim Jacomb]
+# author:timja[]
+#
+Asciidoctor::Extensions.register do
+  inline_macro do
+    named :author
+    name_positional_attributes 'label'
+
+    process do |parent, target, attrs|
+      if attrs['label']
+        label = %(#{attrs['label']})
+      else
+        label = %(#{target})
+      end
+      target = %(/blog/authors/#{target})
+      (create_anchor parent, label, type: :link, target: target).render
+    end
+  end
+end

data/lib/asciidoctor/jenkins/extensions/javadoc-link.rb

@@ -20,6 +20,14 @@ require 'asciidoctor/extensions'
 # jenkinsdoc:git:hudson.plugins.git.GitSCM[some label]
 # jenkinsdoc:git:hudson.plugins.git.GitSCM#anchor[]
 # jenkinsdoc:git:hudson.plugins.git.GitSCM#anchor[some label]
+#
+#
+# For component Javadoc:
+#
+# jenkinsdoc:component:remoting:hudson.remoting.Channel[]
+# jenkinsdoc:component:remoting:hudson.remoting.Channel[some label]
+# jenkinsdoc:component:remoting:hudson.remoting.Channel#anchor[]
+# jenkinsdoc:component:remoting:hudson.remoting.Channel#anchor[some label]
 
 Asciidoctor::Extensions.register do
   inline_macro do
@@ -29,8 +37,13 @@ Asciidoctor::Extensions.register do
     process do |parent, target, attrs|
 
       if target.include? ":"
-        parts = target.split(':', 2)
-        plugin = parts.first
+        parts = target.split(':', 3)
+
+        if parts.first == "component"
+          component = parts[1]
+        else
+          plugin = parts.first
+        end
         target = parts.last
       end
       classname = label = title = target
@@ -43,6 +56,13 @@ Asciidoctor::Extensions.register do
       classname.split('.').each do |part|
         if is_package && /[[:lower:]]/.match(part[0])
           package_parts.push(part)
+        elsif match = /(.*)#/.match(part)
+          class_part = match.captures
+          simpleclass_parts.push(class_part)
+          is_package = false
+
+          # escape once fragment has been found, required for complex fragments that contain a '.'
+          break
         else
           is_package = false
           simpleclass_parts.push(part)
@@ -52,22 +72,25 @@ Asciidoctor::Extensions.register do
       package = package_parts.join('.')
       simpleclass = simpleclass_parts.join('.')
 
-      if package.length > 0 || plugin
+      if package.length > 0 || plugin || component
         classname = classname.gsub(/#.*/, '')
         classurl = package.gsub(/\./, '/') + '/' + simpleclass + ".html"
 
-        classfrag = (target.include? "#") ? '#' + target.gsub(/.*#/, '') : ''
+        classfrag = (target.include? "#") ? '#' + target.gsub(/.*#/, '').gsub(/\(\)/, '--') : ''
 
         if plugin
           label = (attrs.has_key? 'label') ? attrs['label'] : %(#{classname} in #{plugin})
-          target = %(http://javadoc.jenkins.io/plugin/#{plugin}/#{classurl}#{classfrag})
+          target = %(https://javadoc.jenkins.io/plugin/#{plugin}/#{classurl}#{classfrag})
+        elsif component
+          label = (attrs.has_key? 'label') ? attrs['label'] : %(#{classname} in #{component})
+          target = %(https://javadoc.jenkins.io/component/#{component}/#{classurl}#{classfrag})
         else
           label = (attrs.has_key? 'label') ? attrs['label'] : classname
-          target = %(http://javadoc.jenkins.io/#{classurl}#{classfrag})
+          target = %(https://javadoc.jenkins.io/#{classurl}#{classfrag})
         end
       else
         label = (attrs.has_key? 'label') ? attrs['label'] : classname
-        target = %(http://javadoc.jenkins.io/byShortName/#{classname})
+        target = %(https://javadoc.jenkins.io/byShortName/#{classname})
       end
 
       title = %(Javadoc for #{classname})
@@ -92,8 +115,16 @@ Asciidoctor::Extensions.register do
       is_package = true
 
       classname.split('.').each do |part|
+        match = /(.*)#/.match(part)
         if is_package && /[[:lower:]]/.match(part[0])
           package_parts.push(part)
+        elsif match = /(.*)#/.match(part)
+          class_part = match.captures
+          simpleclass_parts.push(class_part)
+          is_package = false
+
+          # escape once fragment has been found, required for complex fragments that contain a '.'
+          break
         else
           is_package = false
           simpleclass_parts.push(part)
@@ -106,9 +137,9 @@ Asciidoctor::Extensions.register do
       classname = target.gsub(/#.*/, '')
       classurl = package.gsub(/\./, '/') + '/' + simpleclass + ".html"
 
-      classfrag = (target.include? "#") ? '#' + target.gsub(/.*#/, '') : ''
+      classfrag = (target.include? "#") ? '#' + target.gsub(/.*#/, '').gsub(/\(\)/, '--') : ''
       label = (attrs.has_key? 'label') ? attrs['label'] : classname
-      target = %(http://stapler.kohsuke.org/apidocs/#{classurl}#{classfrag})
+      target = %(https://stapler.kohsuke.org/apidocs/#{classurl}#{classfrag})
 
       title = %(Javadoc for #{classname})
 
@@ -135,6 +166,13 @@ Asciidoctor::Extensions.register do
       classname.split('.').each do |part|
         if is_package && /[[:lower:]]/.match(part[0])
           package_parts.push(part)
+        elsif match = /(.*)#/.match(part)
+          class_part = match.captures
+          simpleclass_parts.push(class_part)
+          is_package = false
+
+          # escape once fragment has been found, required for complex fragments that contain a '.'
+          break
         else
           is_package = false
           simpleclass_parts.push(part)
@@ -147,9 +185,9 @@ Asciidoctor::Extensions.register do
       classname = target.gsub(/#.*/, '')
       classurl = package.gsub(/\./, '/') + '/' + simpleclass + ".html"
 
-      classfrag = (target.include? "#") ? '#' + target.gsub(/.*#/, '') : ''
+      classfrag = (target.include? "#") ? '#' + target.gsub(/.*#/, '').gsub(/\(\)/, '--') : ''
       label = (attrs.has_key? 'label') ? attrs['label'] : classname
-      target = %(http://docs.oracle.com/javase/7/docs/api/#{classurl}#{classfrag})
+      target = %(https://docs.oracle.com/javase/8/docs/api/#{classurl}#{classfrag})
 
       title = %(Javadoc for #{classname})
 

data/lib/asciidoctor/jenkins/extensions/jep-link.rb

@@ -0,0 +1,23 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+#
+# Usage:
+# jep:201[Jenkins Configuration as Code]
+#
+Asciidoctor::Extensions.register do
+  inline_macro do
+    named :jep
+    name_positional_attributes 'label'
+
+    process do |parent, target, attrs|
+      if attrs['label']
+        label = %(JEP-#{target}: #{attrs['label']})
+      else
+        label = %(JEP-#{target})
+      end
+      target = %(https://github.com/jenkinsci/jep/blob/master/jep/#{target}/README.adoc)
+      (create_anchor parent, label, type: :link, target: target).render
+    end
+  end
+end

data/lib/asciidoctor/jenkins/extensions/jira-link.rb

@@ -0,0 +1,30 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+#
+# Usage:
+# jira:JENKINS-12345[Issue description]
+#
+Asciidoctor::Extensions.register do
+  inline_macro do
+    named :jira
+    name_positional_attributes 'label'
+
+    process do |parent, target, attrs|
+      if target.include? "-"
+        issueId = target
+      else
+        issueId = %(JENKINS-#{target})
+      end
+
+      if attrs['label']
+        label = %(#{issueId}: #{attrs['label']})
+      else
+        label = issueId
+      end
+
+      target = %(https://issues.jenkins.io/browse/#{issueId})
+      (create_anchor parent, label, type: :link, target: target).render
+    end
+  end
+end

data/lib/asciidoctor/jenkins/extensions/security-link.rb

@@ -0,0 +1,36 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+#
+# Usage:
+# security:12345[Issue description, date]
+#
+Asciidoctor::Extensions.register do
+  inline_macro do
+    named :security
+    name_positional_attributes 'label', 'date'
+
+    process do |parent, target, attrs|
+      if target.include? "-"
+        issueId = target
+      else
+        issueId = %(SECURITY-#{target})
+      end
+
+      if attrs['label']
+        label = %(#{issueId}: #{attrs['label']})
+      else
+        label = issueId
+      end
+
+    if attrs['date']
+        target = %(https://jenkins.io/security/advisory/#{attrs['date']}/##{issueId})
+    else
+        # TODO(oleg_nenashev): Change to a security issue redirect service if it gets created
+        target = %(https://jenkins.io/security/advisories/)
+    end
+
+      (create_anchor parent, label, type: :link, target: target).render
+    end
+  end
+end

data/lib/asciidoctor/jenkins/extensions/version.rb

@@ -1,7 +1,7 @@
 module Asciidoctor
   module Jenkins
     module Extensions
-      VERSION = "0.4.0"
+      VERSION = "0.8.0"
     end
   end
 end

metadata

@@ -1,27 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-jenkins-extensions
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.8.0
 platform: ruby
 authors:
 - R. Tyler Croy
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-07-10 00:00:00.000000000 Z
+date: 2020-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.5.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.5.5
 - !ruby/object:Gem::Dependency
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -161,9 +161,13 @@ extra_rdoc_files: []
 files:
 - asciidoctor-jenkins-extensions.gemspec
 - lib/asciidoctor/jenkins/extensions.rb
+- lib/asciidoctor/jenkins/extensions/author-link.rb
 - lib/asciidoctor/jenkins/extensions/javadoc-link.rb
+- lib/asciidoctor/jenkins/extensions/jep-link.rb
+- lib/asciidoctor/jenkins/extensions/jira-link.rb
 - lib/asciidoctor/jenkins/extensions/pipeline-block.rb
 - lib/asciidoctor/jenkins/extensions/plugin-link.rb
+- lib/asciidoctor/jenkins/extensions/security-link.rb
 - lib/asciidoctor/jenkins/extensions/version.rb
 homepage: https://github.com/jenkins-infra/asciidoctor-jenkins-extensions
 licenses: []
@@ -183,8 +187,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: a collection of Asciidoctor extensions which enable more advanced formatting