doc_rspec 0.2.2 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46bc118ccd32d52dd764381cf3d8c6273c31c448199fbd6776e78f4ece0b8504
-  data.tar.gz: 606e445893abbc97ad32e506ce45ce23d49554a19d7e5342de84630ebd99467f
+  metadata.gz: 59e8d3ee3246fe4e1840227fee649981f2f57fb6be5ef1b9c02e2fb9a2ebb9ab
+  data.tar.gz: e470857001bff3657ae5ab05c269d00369f89111e292d5678de760dd53771265
 SHA512:
-  metadata.gz: 8082a05554da0613a0e6566f8bbc60c515652037b95c1d273dd09a8955dfb625b7471af38a91a759bbc685c9bc0be136916deb4735bbb0e4231bcd987ac36378
-  data.tar.gz: 877dda2bc5bd01c8acaf40a9ed521b3a2d72ba23a98e428e963b887c65a70119d26437fd4415686e82430f899af81662df5cc3275c6290bb1084fc79130166c7
+  metadata.gz: 410226d89424038b7c58c1a971e20942af897472b6a9d4825e1b08aebe8e3a0f876bcec58c9205c0c3720006e63acd9a0654aaea8ba7693f84bbae3bacafae48
+  data.tar.gz: 9f73f46d97b292a6e7e8c0c198186b29021adeb50bcbfcb7c8e7901d8f7640ac360f1789c073c34e4f9e36d5acaafcc755579c5e7df3495ea0625f9be5aa63f1

data/lib/doc_rspec/compiler.rb

@@ -4,6 +4,7 @@ class DocRSpec
   class Compiler
     class IncorrectSpec < RuntimeError; end
 
+    include DocRSpec::Debugging
     attr_reader :example_group, :path, :spec_definitions
 
     def compile
@@ -30,13 +31,22 @@ class DocRSpec
     def compile_example(example_spec)
       # See comment above for an explanation why we capture
       # this method as a function into a closure
-      example_group.it example_spec.it_name(path) do
-        example = self
-        code = example_spec
-          .lines
-          .join("\n")
+      code = example_spec
+        .lines
+        .join("\n")
+      return if code.empty?
+
+      example_name = example_spec.it_name(path)
+      if debug_level > 1
+        puts "Example: #{example_name}"
+        puts example_spec.lines.map { ">  #{it}" }
+        puts "=" * 72
+      end
+      return if debug_level > 2
 
-        eval(code) unless code.empty?
+      example_group.it example_name do
+        example = self
+        eval(code)
       end
     end
 

data/lib/doc_rspec/debugging.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class DocRSpec
+  module Debugging
+
+    DEBUG_ENV_VAR_NAME = 'DEBUG_DOC_RSPEC'
+    def debug_level
+      @__debug_level__ ||=
+        case ENV[DEBUG_ENV_VAR_NAME]
+        in nil
+          0
+        in value
+          value.to_i.succ
+        end
+    end
+
+    def debugging? = debug_level.positive?
+
+  end
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/doc_rspec/parser.rb

@@ -1,13 +1,15 @@
 # frozen_string_literal: true
 
 require_relative 'context'
+require_relative '../enumerable'
 
 class DocRSpec
   class Parser
     class InternalError < RuntimeError; end
     class SyntaxError < RuntimeError; end
+    include DocRSpec::Debugging
 
-
+    COMMENT_LINE = %r{\A \s* \#}x
     CONTEXT_DEFINITION = %r{\A \s* \# \s ={1,7} \s (.*)}x
 
     EXAMPLE_LINE = %r{\A \s* \# \s{4,} (.*)}x
@@ -15,8 +17,16 @@ class DocRSpec
     SHORT_EQUALS = %r{\s \=\=\> \s}x
     SHORT_MATCHES = %r{\s \~\> \s}x
     SHORT_PREDICATE = %r{\s is\! \s}x
+    SHORT_ANTIPREDICATE = %r{\s not\! \s}x
     START_EXAMPLE = %r{\A \s* \# \s{4,} \# \s example: \s (.*)}x
 
+    SHORTCUTS = [
+      [ SHORT_EQUALS, "to", "eq(%%%)" ],
+      [ SHORT_MATCHES, "to", "match(%%%)" ],
+      [ SHORT_PREDICATE, "to", "be_%%%" ],
+      [ SHORT_ANTIPREDICATE, "not_to", "be_%%%" ],
+    ]
+
     attr_reader :ast, :lines, :state
 
     def parse
@@ -52,26 +62,21 @@ class DocRSpec
       code = match[1]
       return if code.empty?
 
-      case code.split(SHORT_EQUALS)
-      in [lhs, rhs]
-        ast.last.add_example_line("expect(#{lhs}).to eq(#{rhs})")
-      else
-        case code.split(SHORT_MATCHES)
-        in [lhs, rhs]
-          ast.last.add_example_line("expect(#{lhs}).to match(#{rhs})")
-        else
-          case code.split(SHORT_PREDICATE)
+      compiled =
+        SHORTCUTS.find_value(default: code) do |shtct_def|
+          shtct_def => [rgx, to_or_not, rhs_template]
+          case code.split(rgx)
           in [lhs, rhs]
-            ast.last.add_example_line("expect(#{lhs}).to be_#{rhs}")
+            "expect(#{lhs}).#{to_or_not} #{rhs_template.sub("%%%", rhs)}"
           else
-            ast.last.add_example_line(code)
+            nil
           end
         end
-      end
+      ast.last.add_example_line(compiled)
     end
 
     def parse_line(line, lnb)
-      p(state:, lnb:, line:) if ENV["DEBUG"]
+      p(state:, lnb:, line:) if debugging?
       case state
       when :outside
         parse_line_outside(line, lnb)
@@ -90,6 +95,10 @@ class DocRSpec
         add_example(lnb, Regexp.last_match)
       when EXAMPLE_LINE
         parse_example_line(Regexp.last_match)
+      when COMMENT_LINE
+        nil
+      else
+        @state = :outside
       end
     end
 

data/lib/doc_rspec/version.rb

@@ -2,7 +2,7 @@
 
 class DocRSpec
   module Version
-    VERSION = '0.2.2'
+    VERSION = '0.2.4'
   end
 end
 # SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/doc_rspec.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'rspec'
+require_relative 'doc_rspec/debugging'
 require_relative 'doc_rspec/compiler'
 require_relative 'doc_rspec/rspec_example_group'
 require_relative 'doc_rspec/parser'
@@ -85,6 +86,20 @@ RSpec.configure { it.extend DocRSpec::RSpecExampleGroup }
 #     require 'ostruct'
 #     OpenStruct.new(ok?: true) is! ok
 #
+# === +not!+ for not be_
+# 
+#     # example: is! shorthand for be 
+#
+#     require 'ostruct'
+#     OpenStruct.new(ok?: false) not! ok
+#
+# === End of Example
+#
+# the code does not continue after the rdoc comment
+
+#     # not a problem
+#     raise "This should never happen"
+#
 class DocRSpec
 
   attr_reader :example_group, :lines, :path

data/lib/enumerable.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Enumerable
+  def find_value(default: nil, &blk)
+    each do |ele|
+      result = blk.(ele)
+      return result if result
+    end
+    default 
+  end
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: doc_rspec
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.4
 platform: ruby
 authors:
 - Robert Dober
@@ -49,9 +49,11 @@ files:
 - lib/doc_rspec/compiler.rb
 - lib/doc_rspec/context.rb
 - lib/doc_rspec/context/example.rb
+- lib/doc_rspec/debugging.rb
 - lib/doc_rspec/parser.rb
 - lib/doc_rspec/rspec_example_group.rb
 - lib/doc_rspec/version.rb
+- lib/enumerable.rb
 homepage: https://codeberg.org/lab419/doc_rspec
 licenses:
 - AGPL-3.0-or-later