neo4j-asciidoctor-extensions 0.0.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f56c5e2f8d13065832c148fb4b3724e45a2542a19062b77953b92235e675010c
-  data.tar.gz: 3129172a1921f8fb0fd666e36dff542255b5b797c5c6b68278cff728dabca7cb
+  metadata.gz: b626381905fbdc566cc3b33c79a9b4d25c1e19b117499855e2788414b642ebfc
+  data.tar.gz: f8deb91ca96056010694555067bc881a941134f46f7773d33e6db22f0f3b578c
 SHA512:
-  metadata.gz: 4a348aefd8422a543a9608907e3861386078ed6004715bbd0fac40f323c856c2d30925dc43b2a7d2d5086a34b8e8fa31475248fd7b02b628a6ab051e0a943fc4
-  data.tar.gz: 7abdf4c55bab07472dc5b50f8e4891bf7555d07626d6ae0152a34d92e07f641101a95952169276de95e3994a2638d6315f0df332d6ad2530a2ad6dcc7a51ea81
+  metadata.gz: 0513ca555b1fb6106be5b3e3564da63775fc129b428dfb28a90d75cda2cbedb409b0dd685c577c96bf746a8213c7433a383dea4b10872c788319ae6a5342c1b7
+  data.tar.gz: da20878966af3518704eba61ad82b05bdc5c3d110ead0dd386bfd5c544f91fbafe3e705a92adeabf00b56c4d1eda3ce0621d509d3d82bfe6c62728769ffa7f61

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    neo4j-asciidoctor-extensions (0.0.4)
+    neo4j-asciidoctor-extensions (0.2.0)
       asciidoctor (~> 2.0.0)
       asciidoctor-pdf (= 1.5.3)
       rouge (~> 3.18.0)

data/README.adoc

@@ -1,4 +1,5 @@
 = Neo4j Asciidoctor Extensions
+:caution-caption: :fire:
 :uri-neo4j: https://neo4j.com
 
 image:https://github.com/neo4j-contrib/neo4j-asciidoctor-extensions/workflows/CI/badge.svg[CI,link=https://github.com/neo4j-contrib/neo4j-asciidoctor-extensions/actions?query=workflow%3ACI]
@@ -41,15 +42,30 @@ See below for the complete list of extensions.
 
 The Ruby gem contains 6 distinct extensions:
 
-=== `course_document_attributes`
+=== Neo4j course attributes
 
-A postprocessor that adds attributes about the course.
+A postprocessor that adds attributes about a course on the `Document`.
 
-=== `cypher_syntax_role`
+[CAUTION]
+====
+This extension is tightly coupled to the course publishing project and should not be used for other purposes
+====
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/course_document_attributes'
+----
+
+=== Cypher syntax role
 
 A tree processor that adds a role on code blocks using "cypher-syntax" as a language.
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/cypher_syntax_role'
+----
 
 [source]
 ....
@@ -62,11 +78,16 @@ A tree processor that adds a role on code blocks using "cypher-syntax" as a lang
 ----
 ....
 
-=== `document_metadata_generator`
+=== Metadata generator (YAML)
 
 A postprocess that generates a metadata file (in YAML format) from a list of document attributes.
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/document_metadata_generator'
+----
 
 .file.adoc
 [source,adoc]
@@ -79,7 +100,7 @@ A postprocess that generates a metadata file (in YAML format) from a list of doc
 ----
 
 .file.yml
-[source,adoc]
+[source,yaml]
 ----
 slug: intro-neo4j-4-0
 parent_path: /intro
@@ -104,12 +125,17 @@ taxonomies:
       - 3-6
 ----
 
-=== `inline_highlighter_rouge`
+=== Inline syntax highlighter based on Rouge
 
 Inline syntax highlighter based on Rouge.
 It applies syntax highlighting on both monospaced text cypher and `src` inline macro:
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/inline_highlighter_rouge'
+----
 
 [source,adoc]
 ----
@@ -118,16 +144,29 @@ It applies syntax highlighting on both monospaced text cypher and `src` inline m
 src:cypher[MATCH (c:Customer {customerName: 'ABCCO'}) RETURN c.BOUGHT.productName]
 ----
 
-=== `revealjs_linear_navigation`
+=== Linear navigation for reveal.js
 
 A tree process that "flatten" a reveal.js presentation to use a linear navigation.
 By default, the reveal.js converter will use a vertical navigation for the second levels of section titles (and below).
 This extension will effectively prevent that by using only first level section titles.
 
-=== `revealjs_speaker_notes_aggregator`
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/revealjs_linear_navigation'
+----
+
+=== Notes aggregator for reveal.js
+
 A tree processor that aggregates multiple `[.notes]` blocks in a section (slide).
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/revealjs_speaker_notes_aggregator'
+----
 
 [source,adoc]
 ----
@@ -146,10 +185,38 @@ This is another speaker note.
 --
 ----
 
+=== Document attribute update
+
+A tree processor that update an attribute depending on a given rule.
+
+==== Usage
+
+In the example below, we update the value of the `slug` attribute depending on the `stage` attribute:
+[source,rb]
+----
+require 'asciidoctor/extensions'
+require 'neo4j/asciidoctor/extensions/attribute_update/extension'
+
+Asciidoctor::Extensions.register do
+  ext = Neo4j::AsciidoctorExtensions::AttributeUpdateTreeProcessor
+  tree_processor ext.new attr_name: 'slug',
+                         update_rule: lambda { |document, value|
+                           case document.attr('stage')
+                           when 'production'
+                             value
+                           when 'development'
+                             "_dev_#{value}"
+                           else
+                             "_test_#{value}"
+                           end
+                         }
+end
+----
+
 == Release
 
 The release process is automated and relies on GitHub Actions.
-We are using the :robot: `neo4j-oss-build` account to published on https://rubygems.org/gems/neo4j-asciidoctor-extensions.
+We are using the :robot: `neo4j-oss-build` account to publish on https://rubygems.org/gems/neo4j-asciidoctor-extensions.
 
 The `RUBYGEMS_API_KEY` secret is configured on GitHub.
 See the `.github/workflows/release.yml` file for details.

data/lib/neo4j/asciidoctor/extensions.rb

@@ -6,3 +6,4 @@ require_relative 'extensions/document_metadata_generator'
 require_relative 'extensions/inline_highlighter_rouge'
 require_relative 'extensions/revealjs_linear_navigation'
 require_relative 'extensions/revealjs_speaker_notes_aggregator'
+require_relative 'extensions/stage_slug'

data/lib/neo4j/asciidoctor/extensions/attribute_update/extension.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'asciidoctor/extensions' unless RUBY_ENGINE == 'opal'
+
+module Neo4j
+  # Asciidoctor extensions by Neo4j
+  module AsciidoctorExtensions
+    include Asciidoctor
+
+    # A tree processor that update an attribute depending on a given rule.
+    #
+    class AttributeUpdateTreeProcessor < Extensions::TreeProcessor
+      use_dsl
+
+      def process(document)
+        if (attribute_name = @config[:attr_name]) &&
+           (current_value = document.attr attribute_name) &&
+           (update_rule = @config[:update_rule])
+          new_value = update_rule.call(document, current_value)
+          document.set_attr attribute_name, new_value if new_value != current_value
+        end
+        document
+      end
+    end
+
+    # A tree processor that update the "slug" attribute depending on the "stage" attribute.
+    #
+    class StageSlugTreeProcessor < AttributeUpdateTreeProcessor
+      TESTING_SLUG_PREFIX = '_testing_'
+
+      def initialize(config = nil)
+        super
+        @config[:attr_name] = 'slug'
+        @config[:update_rule] = lambda { |document, value|
+          case document.attr('stage')
+          when 'production'
+            value
+          else
+            "#{TESTING_SLUG_PREFIX}#{value}"
+          end
+        }
+      end
+    end
+  end
+end

data/lib/neo4j/asciidoctor/extensions/document_metadata_generator/extension.rb

@@ -69,7 +69,7 @@ module Neo4j
               attr_name = resolve_attr_name(attr_include)
               if document.attr? attr_name
                 attr_value = resolve_attribute_value(attr_name, document, value_type)
-                metadata[attr_name] = attr_value
+                metadata[attr_name.gsub('-', '_')] = attr_value
               end
             end
             metadata['title'] = document.doctitle
@@ -84,7 +84,7 @@ module Neo4j
       def resolve_value_type(attr_include)
         if attr_include.end_with? '*'
           ValueType::LIST_STRING
-        elsif attr_include.end_with? '*<>'
+        elsif (attr_include.end_with? '*&lt;&gt;') || (attr_include.end_with? '*<>')
           ValueType::LIST_TUPLES
         else
           ValueType::STRING
@@ -95,7 +95,7 @@ module Neo4j
         attr_include
           .gsub(/\*$/, '')
           .gsub(/\*&lt;&gt;$/, '')
-          .gsub('-', '_')
+          .gsub(/\*<>$/, '')
       end
 
       def write(metadata, outfile)
@@ -118,7 +118,7 @@ module Neo4j
           split_values(attr_name, document)
             .map do |tuple|
             key, value = tuple.split('=')
-            { 'key' => key.strip, 'values' => value.strip.split(';').map(&:strip).reject(&:empty?) }
+            { 'key' => key.strip, 'values' => (value && value.strip.split(';').map(&:strip).reject(&:empty?)) || [] }
           end
         else
           document.attr attr_name

data/lib/neo4j/asciidoctor/extensions/stage_slug.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'asciidoctor/extensions' unless RUBY_ENGINE == 'opal'
+require_relative 'attribute_update/extension'
+
+Asciidoctor::Extensions.register do
+  tree_processor Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor
+end

data/lib/neo4j/rouge/themes/neo.rb

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*- #
+# frozen_string_literal: true
+
+require 'rouge' unless defined? ::Rouge::Lexers
+
+module Rouge
+  module Themes
+    #
+    # Neo4j (default) theme
+    class Neo < CSSTheme
+      name 'neo'
+
+      style Comment::Multiline,
+            Comment::Preproc,
+            Comment::Single,
+            Comment::Special,
+            Comment, fg: '#75787b'
+      style Error,
+            Generic::Error,
+            Generic::Traceback, fg: '#960050'
+      style Keyword::Constant,
+            Keyword::Declaration,
+            Keyword::Reserved,
+            Name::Constant,
+            Keyword::Type, fg: '#1d75b3'
+      style Literal::String, fg: '#b35e14'
+      style Name::Function,
+            Operator, fg: '#2e383c'
+      style Name::Namespace,
+            Name::Label,
+            Literal::String::Delimiter,
+            Name::Property, fg: '#75438a'
+      style Name::Entity,
+            Name::Builtin::Pseudo,
+            Name::Variable::Global,
+            Name::Variable::Instance,
+            Name::Variable,
+            Text::Whitespace,
+            Text,
+            Name, fg: '#047d65'
+      style Keyword, fg: '#1d75b3'
+      style Literal::String::Symbol, fg: '#9c3328'
+    end
+  end
+end

data/lib/neo4j/rouge/themes/neo_forest.rb

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*- #
+# frozen_string_literal: true
+
+require 'rouge' unless defined? ::Rouge::Lexers
+
+module Rouge
+  module Themes
+    #
+    # Neo4j forest theme
+    class NeoForest < CSSTheme
+      name 'neo.forest'
+
+      style Comment::Multiline,
+            Comment::Preproc,
+            Comment::Single,
+            Comment::Special,
+            Comment, fg: '#75787b'
+      style Error,
+            Generic::Error,
+            Generic::Traceback, fg: '#960050'
+      style Name::Function,
+            Operator::Word,
+            Keyword,
+            Keyword::Constant,
+            Keyword::Declaration,
+            Keyword::Reserved,
+            Name::Constant,
+            Keyword::Type, fg: '#859900'
+      style Literal::String, fg: '#b58900'
+      style Literal::Number, fg: '#2aa198'
+      style Operator,
+            Name::Namespace,
+            Name::Label,
+            Literal::String::Delimiter,
+            Name::Property,
+            Name::Entity,
+            Name::Builtin::Pseudo,
+            Name::Variable::Global,
+            Name::Variable::Instance,
+            Name::Variable,
+            Text::Whitespace,
+            Text,
+            Name,
+            Literal::String::Symbol, fg: '#333333'
+    end
+  end
+end

data/neo4j-asciidoctor-extensions.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = 'neo4j-asciidoctor-extensions'
-  s.version = '0.0.4'
+  s.version = '0.2.0'
   s.summary = 'Asciidoctor extensions by Neo4j.'
   s.description = 'Asciidoctor extensions by Neo4j.'
 

data/spec/document_metadata_generator_spec.rb

@@ -54,7 +54,7 @@ describe Neo4j::AsciidoctorExtensions::DocumentMetadataGeneratorPostProcessor do
       expect(metadata['slug']).to eql('introduction-neo4j-4-0')
       expect(metadata['tags']).to eql(%w[intro neo4j])
     end
-    it 'should generate metadata with taxonomies (list of tuples)' do
+    it 'should generate metadata with taxonomies (list of tuples) using document attribute' do
       input = <<~'ADOC'
         = Introduction to Neo4j 4.0
         :document-metadata-attrs-include: slug,tags*,taxonomies*<>
@@ -74,5 +74,80 @@ describe Neo4j::AsciidoctorExtensions::DocumentMetadataGeneratorPostProcessor do
       expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'programming_language' }['values']).to eql(%w[java])
       expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'neo4j_version' }['values']).to eql(%w[3-5 3-6])
     end
+    it 'should generate metadata with taxonomies (list of tuples) using document attribute with pass' do
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :document-metadata-attrs-include: pass:[slug,tags*,taxonomies*<>]
+        :slug: introduction-neo4j-4-0
+        :tags:  intro , neo4j,,
+        :taxonomies:  os= linux,,programming_language =java, neo4j_version=3-5; 3-6;
+
+        This is a paragraph.
+      ADOC
+      Asciidoctor.convert(input, safe: 'safe', to_file: 'spec/output/test.html')
+      metadata = YAML.load_file('spec/output/test.yml')
+      expect(metadata['title']).to eql('Introduction to Neo4j 4.0')
+      expect(metadata['slug']).to eql('introduction-neo4j-4-0')
+      expect(metadata['tags']).to eql(%w[intro neo4j])
+      taxonomies = metadata['taxonomies']
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'os' }['values']).to eql(%w[linux])
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'programming_language' }['values']).to eql(%w[java])
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'neo4j_version' }['values']).to eql(%w[3-5 3-6])
+    end
+    it 'should generate metadata with taxonomies (list of tuples) using CLI attribute' do
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :slug: introduction-neo4j-4-0
+        :tags:  intro , neo4j,,
+        :taxonomies:  os= linux,,programming_language =java, neo4j_version=3-5; 3-6;
+
+        This is a paragraph.
+      ADOC
+      Asciidoctor.convert(input, safe: 'safe', to_file: 'spec/output/test.html', attributes: {
+                            'document-metadata-attrs-include' => 'slug,tags*,taxonomies*<>'
+                          })
+      metadata = YAML.load_file('spec/output/test.yml')
+      expect(metadata['title']).to eql('Introduction to Neo4j 4.0')
+      expect(metadata['slug']).to eql('introduction-neo4j-4-0')
+      expect(metadata['tags']).to eql(%w[intro neo4j])
+      taxonomies = metadata['taxonomies']
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'os' }['values']).to eql(%w[linux])
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'programming_language' }['values']).to eql(%w[java])
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'neo4j_version' }['values']).to eql(%w[3-5 3-6])
+    end
+    it 'should replace - by _ in the attribute name' do
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :slug: introduction-neo4j-4-0
+        :parent-path: /labs
+
+        This is a paragraph.
+      ADOC
+      Asciidoctor.convert(input, safe: 'safe', to_file: 'spec/output/test.html', attributes: {
+                            'document-metadata-attrs-include' => 'slug,parent-path'
+                          })
+      metadata = YAML.load_file('spec/output/test.yml')
+      expect(metadata['title']).to eql('Introduction to Neo4j 4.0')
+      expect(metadata['slug']).to eql('introduction-neo4j-4-0')
+      expect(metadata['parent_path']).to eql('/labs')
+    end
+    it 'should ignore empty value in taxonomies' do
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :slug: introduction-neo4j-4-0
+        :taxonomies: neo4j_versions= , tags= intro ; neo4j;;
+
+        This is a paragraph.
+      ADOC
+      Asciidoctor.convert(input, safe: 'safe', to_file: 'spec/output/test.html', attributes: {
+                            'document-metadata-attrs-include' => 'slug,taxonomies*<>'
+                          })
+      metadata = YAML.load_file('spec/output/test.yml')
+      expect(metadata['title']).to eql('Introduction to Neo4j 4.0')
+      expect(metadata['slug']).to eql('introduction-neo4j-4-0')
+      taxonomies = metadata['taxonomies']
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'neo4j_versions' }['values']).to eql([])
+      expect(taxonomies.detect { |taxonomy| taxonomy['key'] == 'tags' }['values']).to eql(%w[intro neo4j])
+    end
   end
 end

data/spec/stage_slug_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+require_relative '../lib/neo4j/asciidoctor/extensions/attribute_update/extension'
+
+describe Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor do
+  context 'convert to html5' do
+    it 'should update slug' do
+      registry = Asciidoctor::Extensions.create
+      registry.tree_processor Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :slug: intro-neo4j-4-0
+
+        {slug}
+      ADOC
+      output = Asciidoctor.convert(input, extension_registry: registry, standalone: false, doctype: 'inline')
+      (expect output).to eql '_testing_intro-neo4j-4-0'
+    end
+    it 'should not update slug' do
+      registry = Asciidoctor::Extensions.create
+      registry.tree_processor Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :stage: production
+        :slug: intro-neo4j-4-0
+
+        {slug}
+      ADOC
+      output = Asciidoctor.convert(input, extension_registry: registry, standalone: false, doctype: 'inline')
+      (expect output).to eql 'intro-neo4j-4-0'
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: neo4j-asciidoctor-extensions
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Guillaume Grossetie
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-24 00:00:00.000000000 Z
+date: 2020-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -127,6 +127,7 @@ files:
 - README.adoc
 - Rakefile
 - lib/neo4j/asciidoctor/extensions.rb
+- lib/neo4j/asciidoctor/extensions/attribute_update/extension.rb
 - lib/neo4j/asciidoctor/extensions/course_document_attributes.rb
 - lib/neo4j/asciidoctor/extensions/course_document_attributes/extension.rb
 - lib/neo4j/asciidoctor/extensions/cypher_syntax_role.rb
@@ -139,6 +140,9 @@ files:
 - lib/neo4j/asciidoctor/extensions/revealjs_linear_navigation/extension.rb
 - lib/neo4j/asciidoctor/extensions/revealjs_speaker_notes_aggregator.rb
 - lib/neo4j/asciidoctor/extensions/revealjs_speaker_notes_aggregator/extension.rb
+- lib/neo4j/asciidoctor/extensions/stage_slug.rb
+- lib/neo4j/rouge/themes/neo.rb
+- lib/neo4j/rouge/themes/neo_forest.rb
 - neo4j-asciidoctor-extensions.gemspec
 - spec/.rubocop.yml
 - spec/cypher_syntax_role_spec.rb
@@ -146,6 +150,7 @@ files:
 - spec/inline_highlighter_rouge_spec.rb
 - spec/revealjs_linear_navigation_spec.rb
 - spec/revealjs_speaker_notes_aggregator_spec.rb
+- spec/stage_slug_spec.rb
 - tasks/bundler.rake
 - tasks/lint.rake
 - tasks/rspec.rake
@@ -181,3 +186,4 @@ test_files:
 - spec/inline_highlighter_rouge_spec.rb
 - spec/revealjs_linear_navigation_spec.rb
 - spec/revealjs_speaker_notes_aggregator_spec.rb
+- spec/stage_slug_spec.rb