docwright 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '089438eeadde6877f7ec2590b98c79d6698631099d3443223d77ca8f4cdbe581'
-  data.tar.gz: 2508d5a8a398a7c3df4650c2c32e9b09be1876a2bd23729b924c4914e6a34214
+  metadata.gz: c2c2b7fdb076fbaa9947c9845dd1c8caa70a5c6c94a0b88ac0552c70482dd9ba
+  data.tar.gz: 970f6bfdf94be116319634eb88fb32dcc3bbb550c3b7842eb4c648cd5e9a3ebc
 SHA512:
-  metadata.gz: 5a4b6893d2308dc9cb0ba1d487413a5f9df48653f8dcf32aca1039e921701bee53fddbf16d0f78d2b48e67335fbeb52f07548d119e87189dac333c3acc032b81
-  data.tar.gz: e316d0cfd343876518a2315d619177cbd9d05db76b121d756bb2099385f5879cb5594a1072695bf2f919c34722fc8b4b3ae73fc428acba1b5247a1d11fda1f0e
+  metadata.gz: 0c4c92513a2e33907e80158c9f14caac77ee38d485c1db48e6bcc03d69f39a2c377dcfc4df4459e6544fdca6410783250352c9bfc9895f0a6a3946c55bbdc460
+  data.tar.gz: 42bd0a87016cdc592cb2770156f843988f6d5a412d1dd1a7d300dd3a728ead363016cbd777a88fb68b0259f2f5901d2618a68987113ff63fc7553fa8ea7bf07d

data/CHANGELOG.md

@@ -5,7 +5,7 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Unreleased]
 
-## [0.1.0] - Unreleased
+## [0.1.0] - 2026-07-22
 
 ### Added
 
@@ -23,3 +23,13 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Smart merge markers — human-written content preserved across regenerations
 - `docwright:check` — audit task for missing files, placeholder content, empty notes
 - `docwright:search` — search across all documentation files
+
+## [0.1.1] - 2026-07-24
+
+### Fixed
+
+- `eager_load!` rescue in model, auth, concerns, and background_jobs extractors to handle missing railties gracefully
+- `merger.rb` notes_placeholder now passed through to `merge_named` — fixes inconsistent notes headers
+- `write_template` in wizard now correctly handles feature files using `FeatureGenerator`
+- `FeatureGenerator` — added `generate_single` method for wizard template writing
+- `README.md` — added link to examples/ folder

data/README.md

@@ -138,10 +138,14 @@ bundle install
 bundle exec rspec
 ```
 
+## Examples
+
+See the [examples/](examples/) folder for sample generated output.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on
-[GitHub](https://github.com/GraceHtet/docwright).
+[GitHub](https://github.com/GraceHtet/docwright/issues).
 
 ## License
 

data/lib/docwright/extractors/auth_extractor.rb

@@ -5,7 +5,11 @@ module Docwright
     class AuthExtractor # rubocop:disable Style/Documentation
       CALLBACK_KINDS = %i[before around after].freeze
       def generate
-        Rails.application.eager_load!
+        begin
+          Rails.application.eager_load!
+        rescue NameError => e
+          puts "DocWright: warning — could not eager load all files: #{e.message}"
+        end
 
         controllers = find_controllers
         filter_map = build_filter_map(controllers)

data/lib/docwright/extractors/background_jobs_extractor.rb

@@ -6,7 +6,17 @@ module Docwright
       INTERNAL_JOBS = %w[ApplicationJob].freeze
 
       def generate
-        Rails.application.eager_load!
+        unless defined?(ActiveJob)
+          puts "DocWright: skipped background_jobs.md — ActiveJob is not loaded."
+          puts "  To enable: uncomment 'require \"active_job/railtie\"' in config/application.rb"
+          return
+        end
+        
+        begin
+          Rails.application.eager_load!
+        rescue NameError => e
+          puts "DocWright: warning — could not eager load all files: #{e.message}"
+        end
 
         jobs = find_jobs
         if jobs.empty?

data/lib/docwright/extractors/concerns_extractor.rb

@@ -4,7 +4,16 @@ module Docwright
   module Extractors
     class ConcernsExtractor
       def generate
-        Rails.application.eager_load!
+        unless defined?(ActiveRecord) && defined?(ActionController)
+          puts "DocWright: skipped concerns.md — ActiveRecord or ActionController is not loaded."
+          return
+        end
+
+        begin
+          Rails.application.eager_load!
+        rescue NameError => e
+          puts "DocWright: warning — could not eager load all files: #{e.message}"
+        end
 
         concerns = find_model_concerns + find_controller_concerns
 

data/lib/docwright/extractors/model_extractor.rb

@@ -4,6 +4,17 @@ module Docwright
   module Extractors
     class ModelExtractor
       def generate
+        unless defined?(ActiveRecord)
+          puts "DocWright: skipped models.md — ActiveRecord is not loaded."
+          return
+        end
+
+        begin
+          Rails.application.eager_load!
+        rescue NameError => e
+          puts "DocWright: warning — could not eager load all files: #{e.message}"
+        end
+
         models = find_models
         FileUtils.mkdir_p("docs")
 
@@ -42,7 +53,6 @@ module Docwright
       private
 
       def find_models
-        Rails.application.eager_load!
         ActiveRecord::Base.descendants.reject { |m| m.abstract_class? }.sort_by(&:name)
       end
     end

data/lib/docwright/generators/feature_generator.rb

@@ -30,6 +30,16 @@ module Docwright
         end
       end
 
+      def generate_single(path, filename)
+        return if File.exist?(path)
+
+        name = filename.gsub(".md", "")
+
+        description = "<!-- Describe the feature -->"
+        FileUtils.mkdir_p(File.dirname(path))
+        File.write(path, template(name, description))
+      end
+
       private
 
       def template(name, description)

data/lib/docwright/merger.rb

@@ -15,7 +15,7 @@ module Docwright
 
     def self.write_named(path, name, auto_content, notes_placeholder)
       if File.exist?(path)
-        merge_named(path, name, auto_content)
+        merge_named(path, name, auto_content, notes_placeholder)
       else
         fresh_named(path, name, auto_content, notes_placeholder)
       end
@@ -42,7 +42,7 @@ module Docwright
       File.write(path, updated)
     end
 
-    def self.merge_named(path, name, auto_content)
+    def self.merge_named(path, name, auto_content, notes_placeholder)
       existing = File.read(path)
       start_marker = "<!-- DOCWRIGHT:AUTO:#{name} -->"
       end_marker = "<!-- DOCWRIGHT:END:#{name} -->"
@@ -51,7 +51,7 @@ module Docwright
       updated = if existing.include?(start_marker)
                   existing.gsub(/#{Regexp.escape(start_marker)}.*?#{Regexp.escape(end_marker)}/m, replacement)
                 else
-                  existing + "\n#{replacement}\n### Notes for #{name}\n<!-- Add your notes about #{name} here -->\n"
+                  existing + "\n#{replacement}\n#{notes_placeholder}\n"
                 end
       File.write(path, updated)
     end

data/lib/docwright/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Docwright
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/docwright/wizard.rb

@@ -159,6 +159,9 @@ module Docwright
       Docwright::Extractors::BackgroundJobsExtractor.new.generate if optional["background_jobs"]
       Docwright::Extractors::ServicesExtractor.new.generate if optional["services"]
       Docwright::Extractors::ConcernsExtractor.new.generate if optional["concerns"]
+    rescue NameError => e
+      puts "DocWright: skipped some optional docs — #{e.message}"
+      puts "  Check your config/application.rb and ensure required railties are loaded."
     end
 
     def process_manual_files(files)
@@ -237,7 +240,11 @@ module Docwright
 
     def write_template(path, filename)
       FileUtils.mkdir_p(File.dirname(path))
-      Docwright::Generators::ManualGenerator.new.generate_single(path, filename)
+      if path.include?("features/")
+        Docwright::Generators::FeatureGenerator.new.generate_single(path, filename)
+      else
+        Docwright::Generators::ManualGenerator.new.generate_single(path, filename)
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docwright
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Grace