dsl_compose 1.14.0 → 1.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fe38926f435f6f7978468bb08e0b91ebbd6962d5863032a7cb49095856c3c50
-  data.tar.gz: c4523746ddbef25e5c64e8b47ea624393d6efa25f0c6b795a0d69ea7910d2683
+  metadata.gz: ddb7398a7cd392f48c54e7ee60404342857d7d010247926ca006d84ad5caa1ac
+  data.tar.gz: d4515e288a0eea8be71a869434c1f28a20f2cec3943a33c9c6615028b223b970
 SHA512:
-  metadata.gz: ef54cc72949be0609a9bd1feacad07b202c90b183f6be89c6494c19a95944639ccc0cba3986375a16234803aa96f4e90721abc2308fa75e20ace407504bfedce
-  data.tar.gz: 4143b1a1d0d84597da9fa29ef745a9ca0002fc4bc6107a9206b700453f511cdc1e7a0bc6eea16af69e169cc3c220ff43bbbdd5b8603df58704bcc9d51fa5d58b
+  metadata.gz: 8512aec08f472d946b2c9a84b6e824bbc1d46db610f3bb908766e05a324833e3c07feeb05638153633d23bccbe1f0e66e8132721e7056e903beaed1a42ef866c
+  data.tar.gz: a2897b08ed6b226a06c8fbf2e07277b68fc1476b7467db663c06acacaa3a1e92db64b3aaac782fb2ada0657605dfecccb47bce6517339d60a49016a48ccd9726

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.14.1](https://github.com/craigulliott/dsl_compose/compare/v1.14.0...v1.14.1) (2023-07-19)
+
+
+### Bug Fixes
+
+* Clearing the parser_usage_notes when also clearing the DSLs. ([#41](https://github.com/craigulliott/dsl_compose/issues/41)) ([bbdb445](https://github.com/craigulliott/dsl_compose/commit/bbdb445ed9fa4b495f8aa5bf0b889707680858d0))
+
 ## [1.14.0](https://github.com/craigulliott/dsl_compose/compare/v1.13.1...v1.14.0) (2023-07-19)
 
 

data/README.md

@@ -247,6 +247,16 @@ MyParser < DSLCompose::Parser
   # which extend the provided base class, but do not have their own children) then
   # use `for_final_children_of` instead of `for_children_of`
   for_children_of SomeBaseClass do |child_class:|
+    description <<-DESCRIPTION
+      You can optionally provide a description of anything specific that your parser
+      does in this block, this description will be used when generating documentation
+
+      This description accepts markdown.
+
+      Do not add a description here if the parser does not have any business logic here
+      other than making calls to `for_dsl`, `for_dsl_or_inherited_dsl` or `for_inherited_dsl`
+    DESCRIPTION
+
     # `for_dsl` accepts a DSL name or an array of DSL names and will yield it's
     # provided block once for each time a DSL of that name has been used
     # directly on the child_class.
@@ -266,6 +276,16 @@ MyParser < DSLCompose::Parser
     # consider a DSL to have been executed on the actual class it was used, and
     # any classes which are descendants of that class
     for_dsl [:dsl1, :dsl2] do |dsl_name:, a_dsl_argument:|
+      description <<-DESCRIPTION
+        You can optionally provide a description of anything specific that your parser
+        does in this block, this description will be used when generating documentation.
+
+        This description accepts markdown.
+
+        Do not add a description here if the parser does not have any business logic here
+        other than making calls to `for_method`
+      DESCRIPTION
+
       # `for_method` accepts a method name or an array of method names and will
       # yield it's provided block once for each time a method with this name is
       # executed within the DSL.
@@ -277,6 +297,13 @@ MyParser < DSLCompose::Parser
       # are provided then the requested dsl argument must be present on all DSLs
       # otherwise an error will be raised.
       for_method :some_method_name do |method_name:, a_method_argument:|
+        description <<-DESCRIPTION
+          You can optionally provide a description of anything specific that your parser
+          does in this block, this description will be used when generating documentation.
+
+          This description accepts markdown.
+        DESCRIPTION
+
         # your business logic goes here
         ...
       end

data/lib/dsl_compose/interpreter.rb

@@ -61,11 +61,13 @@ module DSLCompose
       @executions.filter { |e| e.dsl.name == dsl_name && ((on_current_class && e.klass == klass) || (on_ancestor_class && klass < e.klass)) }
     end
 
-    # removes all executions from the interpreter, this is primarily used from
-    # within a test suite when dynamically creating classes for tests and then
-    # wanting to clear the interpreter before the next test.
+    # removes all executions from the interpreter, and any parser_usage_notes
+    # this is primarily used from within a test suite when dynamically creating
+    # classes for tests and then wanting to clear the interpreter before the
+    # next test.
     def clear
       @executions = []
+      @parser_usage_notes ||= {}
     end
 
     def to_h dsl_name

data/lib/dsl_compose/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DSLCompose
-  VERSION = "1.14.0"
+  VERSION = "1.14.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dsl_compose
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.14.1
 platform: ruby
 authors:
 - Craig Ulliott