rails-annotate-solargraph 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ca6f0073923760a583abb52af713540b2f53cf6e8dd896584e3a76b97444c8b
-  data.tar.gz: a07141ca737ee0c60153cabd5e28540d3507ba09401b4cc31d30ea491bc32eb2
+  metadata.gz: 80d2fcb8fc2090d6a1eabc8f510b3b9fec1608da1870c7d88b301ce64907920a
+  data.tar.gz: 9553090d359f8f829e955349cac6c527c43335433e38d91152862780cce3ab63
 SHA512:
-  metadata.gz: f3a40df235de87414059053670f344e0e6606b9538ecba40b7fbb2c849c07f8009e5cec055e485033bae5529bce9146d2369d76b8a6ab4288664703bef29da2f
-  data.tar.gz: d920e8b59c64f57d22fba128b4db1acffd88b718799e24e2f361d43e99ae6505258faa2665f57fafdee9d9cd6d4dc47231c9e5e7bb99a7e687707c2642e211e5
+  metadata.gz: 8b2415d929d939454a4f65277d85baa03935219226c6ad5b35c35264cd2de94bb1b1d55a55a55ee8cc737523210e3653c648bea50798dd53b580767fbb6a2eec
+  data.tar.gz: 9436e870a6cbc28e636151b76717cde5bf4186f44bc8af4293ada785f1c50e039895fcf5cb38dd27868c5e88027df9f52be8ee070591e0635de30fdba7437aef

data/.vscode/settings.json

@@ -1,6 +1,7 @@
 {
   "cSpell.words": [
     "activerecord",
+    "klass",
     "rakefile",
     "solargraph",
     "yieldparam"

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.4.0] - 2022-04-17
+
+- Annotations get saved to a schema file by default `app/models/annotate_solargraph_schema.rb`
+
 ## [0.3.0] - 2022-04-17
 
 - `has_many :through` and `has_one :through` relations get documented

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rails-annotate-solargraph (0.3.0)
+    rails-annotate-solargraph (0.4.0)
       rails (>= 5.0, < 8.0)
 
 GEM

data/README.md

@@ -63,11 +63,31 @@ You can change the gem's default configuration like so:
 ```ruby
 # config/initializers/rails_annotate_solargraph.rb
 
-Rails::Annotate::Solargraph.configure do |conf|
-    conf.annotation_position = :top # `:bottom` by default
+if ::Rails.env.development?
+    ::Rails::Annotate::Solargraph.configure do |conf|
+        conf.annotation_position = :top # `:schema_file` by default
+    end
 end
 ```
 
+#### annotation_position
+
+There are a few values for this option:
+
+- `:schema_file` -- default value, annotations get saved to a special file `app/models/annotate_solargraph_schema.rb`
+- `:bottom` -- annotations are appended to the model files
+- `:top` -- annotations are prepended to the model files
+
+### Update
+
+To update this gem you should generate the rakefiles once again. Overwrite them.
+
+```sh
+$ rails g annotate:solargraph:install
+$ rake annotate:solargraph:remove
+$ rake annotate:solargraph:generate
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/rails/annotate/solargraph/configuration.rb

@@ -9,10 +9,10 @@ module Rails
         # @return [Symbol]
         attr_reader :annotation_position
 
-        ANNOTATION_POSITIONS = ::Set[:bottom, :top].freeze
+        ANNOTATION_POSITIONS = ::Set[:bottom, :top, :schema_file].freeze
 
         def initialize
-          @annotation_position = :bottom
+          @annotation_position = :schema_file
         end
 
         # @param val [Symbol]
@@ -22,6 +22,10 @@ module Rails
 
           @annotation_position = val
         end
+
+        def schema_file?
+          @annotation_position == :schema_file
+        end
       end
     end
   end

data/lib/rails/annotate/solargraph/model.rb

@@ -1,17 +1,13 @@
 # frozen_string_literal: true
 
+require 'fileutils'
+
 module Rails
   module Annotate
     module Solargraph
       class Model
         using TerminalColors::Refinement
 
-        # @return [String]
-        ANNOTATION_START = "\n# %%<RailsAnnotateSolargraph:Start>%%"
-        # @return [String]
-        ANNOTATION_END = "%%<RailsAnnotateSolargraph:End>%%\n\n"
-        # @return [Regexp]
-        ANNOTATION_REGEXP = /#{ANNOTATION_START}.*#{ANNOTATION_END}/m.freeze
         # @return [Regexp]
         MAGIC_COMMENT_REGEXP = /(^#\s*encoding:.*(?:\n|r\n))|(^# coding:.*(?:\n|\r\n))|(^# -\*- coding:.*(?:\n|\r\n))|(^# -\*- encoding\s?:.*(?:\n|\r\n))|(^#\s*frozen_string_literal:.+(?:\n|\r\n))|(^# -\*- frozen_string_literal\s*:.+-\*-(?:\n|\r\n))/.freeze
 
@@ -40,6 +36,26 @@ module Rails
               ::Object.to_s
             end
           end
+
+          # @param klass [Class]
+          # @return [String]
+          def annotation_start(klass = nil)
+            table_name = klass && CONFIG.schema_file? ? ":#{klass.table_name}" : ''
+            "\n# %%<RailsAnnotateSolargraph:Start#{table_name}>%%"
+          end
+
+          # @param klass [Class]
+          # @return [String]
+          def annotation_end(klass = nil)
+            table_name = klass && CONFIG.schema_file? ? ":#{klass.table_name}" : ''
+            "%%<RailsAnnotateSolargraph:End#{table_name}>%%\n\n"
+          end
+
+          # @param klass [Class]
+          # @return [Regexp]
+          def annotation_regexp(klass = nil)
+            /#{annotation_start(klass)}.*#{annotation_end(klass)}/m
+          end
         end
 
         # @return [String]
@@ -51,7 +67,23 @@ module Rails
         # @param klass [Class]
         def initialize(klass)
           @klass = klass
-          @file_name = ::File.join(::Rails.root, MODEL_DIR, "#{klass.to_s.underscore}.rb")
+          base_file_name = CONFIG.schema_file? ? SCHEMA_FILE_NAME : "#{klass.to_s.underscore}.rb"
+          @file_name = ::File.join(::Rails.root, MODEL_DIR, base_file_name)
+        end
+
+        # @return [String]
+        def annotation_start
+          self.class.annotation_start(@klass)
+        end
+
+        # @return [String]
+        def annotation_end
+          self.class.annotation_end(@klass)
+        end
+
+        # @return [Regexp]
+        def annotation_regexp
+          self.class.annotation_regexp(@klass)
         end
 
         # @param :write [Boolean]
@@ -79,8 +111,10 @@ module Rails
         # @param :write [Boolean]
         # @return [Array<String>] Old file content followed by new content.
         def remove_annotation(write: true)
+          return ['', ''] unless ::File.exist?(@file_name)
+
           file_content = ::File.read(@file_name)
-          new_file_content = file_content.sub(ANNOTATION_REGEXP, '')
+          new_file_content = file_content.sub(annotation_regexp, '')
           result = [file_content, new_file_content]
           return result unless write
           return result if file_content == new_file_content
@@ -93,7 +127,7 @@ module Rails
         def annotation
           doc_string = ::String.new
           doc_string << <<~DOC
-            #{ANNOTATION_START}
+            #{annotation_start}
             # @!parse
             #   class #{@klass} < #{@klass.superclass}
           DOC
@@ -117,7 +151,7 @@ module Rails
 
           doc_string << <<~DOC.chomp
             #   end
-            # #{ANNOTATION_END}
+            # #{annotation_end}
           DOC
         end
 
@@ -133,6 +167,7 @@ module Rails
         # @param content [String]
         # @return [void]
         def write_file(file_name, content)
+          ::FileUtils.touch(file_name) unless ::File.exists?(file_name)
           ::File.write(file_name, content)
           puts "modify".rjust(12).with_styles(:bold, :green) + "  #{relative_file_name(file_name)}"
         end

data/lib/rails/annotate/solargraph/version.rb

@@ -3,7 +3,7 @@
 module Rails
   module Annotate
     module Solargraph
-      VERSION = '0.3.0'
+      VERSION = '0.4.0'
     end
   end
 end

data/lib/rails/annotate/solargraph.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'set'
+require 'fileutils'
 
 require_relative "solargraph/version"
 require_relative "solargraph/configuration"
@@ -19,11 +20,16 @@ module Rails
       CONFIG = Configuration.new
       # @return [Set<Symbol>]
       VALID_MODIFICATION_METHODS = ::Set[:annotate, :remove_annotation].freeze
+      # @return [String]
+      SCHEMA_CLASS_NAME = 'AnnotateSolargraphSchema'
+      # @return [String]
+      SCHEMA_FILE_NAME = "annotate_solargraph_schema.rb"
 
       class << self
         # @return [Array<String>] Array of changed files.
         def generate
           title 'Generating model schema annotations'
+          create_schema_file
           modify_models :annotate
         end
 
@@ -49,6 +55,16 @@ module Rails
 
         include TerminalColors
 
+        def create_schema_file
+          schema_file = ::File.join(::Rails.root, MODEL_DIR, SCHEMA_FILE_NAME)
+          return unless CONFIG.schema_file? && !::File.exist?(schema_file)
+
+          ::FileUtils.touch(schema_file)
+          ::File.write schema_file, <<~SCHEMA
+            module AnnotateSolargraphSchema; end
+          SCHEMA
+        end
+
         # @param method [Symbol] Name of the method that will be called on every loaded Model
         # @return [Array<String>] Array of changed files.
         def modify_models(method)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-annotate-solargraph
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Mateusz Drewniak