source2md 0.0.11 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cbcbb886c48d226f8864af1134aa3c0bdac15dcb2adf2acfd8aadb1d9b62bcc
-  data.tar.gz: bdcdb4870afc49aeb7fbb20534a54ba44fd42bd9e1e56c2bb260babe46d9cb74
+  metadata.gz: 562135200c7492a703d690fe621a77ef6341567ef499a0a868033db4c93f0d72
+  data.tar.gz: 9bb67852ae6ae568edded0478116ea78e9e24ce58d58ce16df0c6b692f515f59
 SHA512:
-  metadata.gz: 9fe4bde35b551e33b11a53a10df2941b3828eba7b5e91c470bae0001f26f95ab2ecb006183fb89384be8fe22d3f9b5c461917b1525e3f002800846f19ea2547a
-  data.tar.gz: ab48da56d8bf0b4ce3755432f9ed281dbceacf67a8cdbb4663b328f614c73bdcc1680a4e03675d8ba547ff638d054f2249644fca5f52c6812b3e17c6474b523c
+  metadata.gz: 619ff51efb9c41fe3cbeea92774fc3e853e5c915fde446f9118f1af9c5dc6262ea510430c7e48bf338f822d3f6f58d9f2d69e095c04c035d02d63c84c6f82a1b
+  data.tar.gz: cf9e28c97304ba30b623a5d7f66a4c79ba47231f5ce8d3ac1c8452e5beeaba9c1f77f379be37412bc94eddceafd53261f5cf6e99020d4d7a4a230a80daf45cf1

data/examples/output.md

@@ -1,11 +1,30 @@
+## (title) ##
+
+### (name1) ###
+
+(desc1)
+
+```ruby
+"foo1".size  # => 4
+```
+
+(comment1)
+
+### (name2) ###
+
+(desc2)
+
 ```ruby
-# ```yaml:config.yml
-#   frequencies: frequencies1.rb
-# ```
+"foo2".size  # => 4
 ```
 
-```ruby:frequencies1.rb
-def frequencies(words)
-  words.tally.sort_by { -_2 }.take(25)
-end
+(comment2)
+
+| x | x | x |
+|---|---|---|
+| x | x | x |
+| x | x | x |
+
+```ruby
+1 + 2  # => 3
 ```

data/lib/source2md/cli.rb

@@ -34,6 +34,7 @@ module Source2MD
     map "g" => :generate
     desc "generate [files]", "Markdown generation"
     option :output_file, type: :string, aliases: "-o", default: nil
+    option :glob,        type: :string, aliases: "-g"
     def generate(*files)
       Generator.new(options.to_options.merge(files: files)).call
     end

data/lib/source2md/code_block.rb

@@ -1,7 +1,7 @@
 module Source2MD
   class CodeBlock
     PADDING_KEEP = 2
-    ARROW_MARK         = %r{(?:#{RE.comment_re}) =>}
+    ARROW_MARK = %r{(?:#{RE.comment_re}) =>}
 
     def initialize(text, options = {})
       @text = text

data/lib/source2md/generator.rb

@@ -12,14 +12,10 @@ module Source2MD
       end
 
       if output_file
-        if output_file.exist?
-          FileUtils.chmod("a+w", output_file)
+        temporarily_disable_write_protection do
+          output_file.write(to_md)
+          puts "write: #{output_file}"
         end
-        output_file.write(to_md)
-        if Source2MD.readonly
-          FileUtils.chmod("a-w", output_file)
-        end
-        puts "write: #{output_file}"
       end
     end
 
@@ -36,7 +32,13 @@ module Source2MD
     end
 
     def files
-      @files ||= Array(params[:files]).collect { |e| Pathname(e).expand_path }
+      @files ||= yield_self do
+        if params[:glob]
+          Pathname.glob(params[:glob])
+        else
+          Array(params[:files]).collect { |e| Pathname(e).expand_path }
+        end
+      end
     end
 
     def output_file
@@ -46,5 +48,15 @@ module Source2MD
         end
       end
     end
+
+    def temporarily_disable_write_protection
+      if output_file.exist?
+        FileUtils.chmod("a+w", output_file)
+      end
+      yield
+      if Source2MD.readonly
+        FileUtils.chmod("a-w", output_file)
+      end
+    end
   end
 end

data/lib/source2md/version.rb

@@ -1,3 +1,3 @@
 module Source2MD
-  VERSION = "0.0.11"
+  VERSION = "0.0.12"
 end

data/spec/generator_spec.rb

@@ -0,0 +1,51 @@
+require "spec_helper"
+
+module Source2MD
+  describe Generator do
+    before do
+      Pathname("_input.rb").write("# (content)")
+    end
+
+    after do
+      Pathname("_input.rb").delete
+      Pathname("_output.md").delete rescue nil
+    end
+
+    it "files option" do
+      output = capture("stdout") do
+        Generator.new(files: ["_input.rb"]).call
+      end
+      assert { output == "(content)\n" }
+    end
+
+    it "glob option" do
+      output = capture("stdout") do
+        Generator.new(glob: "_i*.rb").call
+      end
+      assert { output == "(content)\n" }
+    end
+
+    it "output file is write protected" do
+      capture("stdout") do
+        Generator.new(files: ["_input.rb"], output_file: "_output.md").call
+      end
+      assert { Pathname("_output.md").stat.writable? == false }
+    end
+  end
+end
+# >> .F
+# >>
+# >> Failures:
+# >>
+# >>   1) Source2MD::Generator glob option
+# >>      Failure/Error: Unable to find - to read failed line
+# >>      Test::Unit::AssertionFailedError:
+# >>      # -:25:in `block (2 levels) in <module:Source2MD>'
+# >>
+# >> Finished in 0.01412 seconds (files took 0.28313 seconds to load)
+# >> 2 examples, 1 failure
+# >>
+# >> Failed examples:
+# >>
+# >> rspec -:21 # Source2MD::Generator glob option
+# >>

data/spec/spec_helper.rb

@@ -18,3 +18,11 @@ RSpec.configure do |config|
   config.expect_with :test_unit
   config.example_status_persistence_file_path = "#{__dir__}/.all_test_result.txt"
 end
+
+if true
+  require "tempfile"            # for capture
+  require "active_support/testing/stream"
+  RSpec.configure do |config|
+    config.include ActiveSupport::Testing::Stream
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: source2md
 version: !ruby/object:Gem::Version
-  version: 0.0.11
+  version: 0.0.12
 platform: ruby
 authors:
 - Akira Ikeda
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-08-13 00:00:00.000000000 Z
+date: 2023-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -212,7 +212,6 @@ files:
 - lib/source2md/tasks/test.rake
 - lib/source2md/text_helper.rb
 - lib/source2md/version.rb
-- output.md
 - source2md.gemspec
 - spec/code_block_spec.rb
 - spec/formatter/sample.yml
@@ -228,6 +227,7 @@ files:
 - spec/formatter/type_text_spec.rb
 - spec/formatter/type_title_spec.rb
 - spec/formatter/type_warn_spec.rb
+- spec/generator_spec.rb
 - spec/scanner_spec.rb
 - spec/spec_helper.rb
 - spec/text_helper_spec.rb
@@ -250,7 +250,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.18
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Markdown generator from source code
@@ -269,6 +269,7 @@ test_files:
 - spec/formatter/type_text_spec.rb
 - spec/formatter/type_title_spec.rb
 - spec/formatter/type_warn_spec.rb
+- spec/generator_spec.rb
 - spec/scanner_spec.rb
 - spec/spec_helper.rb
 - spec/text_helper_spec.rb

data/output.md

@@ -1,13 +0,0 @@
-```ruby
-a
-```
-
-```ruby
-r.xy();      // => Vec2(0.0, 0.0)
-    r.xy();  // => Vec2(0.0, 0.0)
-    r.xy();  // => Vec2(0.0, 0.0)
-```
-
-```ruby
-b
-```