rubocop-schema-gen 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9896f77d8a3c4c39bd31f21878bffdb2d8979dee897b5fe38b3ef090bd11043d
-  data.tar.gz: bfa9fe9b715b977f1dc973f48e80eafe59a448545bbef559247055bd98cfc5bd
+  metadata.gz: d13b27e5b62cc1a35d64acf5a81f2c6443aae1d0e9597207634bb7defa2a6b34
+  data.tar.gz: 78ac1aadadf7a5f23700615d717262fa0601e54ac772f8a5f2a790fe3dcd37bf
 SHA512:
-  metadata.gz: 074f101c7a87e0ce7e1de730a82b6bc83682bf0068d60519c1b042ca6bbcc7d3ca574e5ed47f3fec0f2cb63ce3639b98ab2915b90644b1e349aa4c589c3d6cab
-  data.tar.gz: aeafc3e4661bed171c7d182ffbf6c752ded81d002623984bd0e146072c70fca9609d79410a8f5c23fe031c49caf15755d8ad5a3fe120955e7f23b9ddbd813398
+  metadata.gz: 4293f202f9132881733e84b280e1b4ba93df2ab1b9567efb7ae48703835dc4d3e5aebb8a797f05453766e7929a3efe5c2c150b8d575611c6c959deeefc290a5c
+  data.tar.gz: b61fcf727e203d2ca162eba0bd081c9bf008d8606774e8c16cd6727bd35c9e3f144606a375efdce1c115ae35001a04411cf70aebe09ecddd4cbf046b9ced3b6d

data/.rspec

@@ -1,3 +1,3 @@
---format documentation
+--format progress
 --color
 --require spec_helper

data/.rubocop.yml

@@ -16,7 +16,7 @@ require:
 AllCops:
   SuggestExtensions: false
   NewCops: enable
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 2.4
 
 Layout/HashAlignment:
   EnforcedColonStyle: table
@@ -36,3 +36,39 @@ Style/StringConcatenation:
 
 Style/StderrPuts:
   Enabled: false
+
+Lint/AmbiguousOperator:
+  Enabled: false
+
+Lint/AmbiguousRegexpLiteral:
+  Enabled: false
+
+Lint/AmbiguousBlockAssociation:
+  Enabled: false
+
+Style/StabbyLambdaParentheses:
+  EnforcedStyle: require_no_parentheses
+
+Layout/SpaceInLambdaLiteral:
+  EnforcedStyle: require_space
+
+Metrics/AbcSize:
+  Max: 18
+
+Metrics/ParameterLists:
+  Exclude:
+    - lib/rubocop/schema/cli.rb
+
+Metrics/BlockLength:
+  IgnoredMethods:
+    - describe
+
+Style/FormatStringToken:
+  Enabled: false
+
+RSpec/NamedSubject:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Exclude:
+    - spec/rubocop/schema/cli_spec.rb

data/.ruby-version

@@ -1 +1 @@
-3.0.0
+2.4.10

data/.travis.yml

@@ -2,5 +2,9 @@
 language: ruby
 cache: bundler
 rvm:
+  - 2.4.10
+  - 2.5.8
+  - 2.6.6
+  - 2.7.3
   - 3.0.0
-before_install: gem install bundler -v 2.1.4
+before_install: gem install bundler -v 1.17.3

data/Gemfile

@@ -5,6 +5,11 @@ gemspec
 
 gem 'rake', '~> 12.0'
 gem 'rspec', '~> 3.0'
-gem 'rubocop', '~> 1.13.0', require: false
+gem 'rubocop', require: false
+gem 'rubocop-minitest', require: false
+gem 'rubocop-performance', require: false
+gem 'rubocop-rails', require: false
 gem 'rubocop-rake', require: false
 gem 'rubocop-rspec', require: false
+gem 'vcr'
+gem 'webmock'

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2021 Neil E. Pearson
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -1,44 +1,39 @@
-# Rubocop::Schema
+# RuboCop Config Schema Generator
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/rubocop/schema`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+This gem generates a JSON schema for your RuboCop configuration files, which you can use in your IDE (e.g. RubyMine) for autocompletion and validation.
 
 ## Installation
 
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'rubocop-schema'
-```
-
-And then execute:
+    $ gem install rubocop-schema-gem
 
-    $ bundle install
+## Usage
 
-Or install it yourself as:
+Change to a directory containing a `Gemfile.lock`, which the generator will use to target your version of `rubocop`, and any extensions you may be using (e.g. `rubocop-rails`).
 
-    $ gem install rubocop-schema
+```
+$ cd ./my_project
+$ rubocop-schema-gen
+Generating rubocop-1.13.1-config-schema.json … complete in 5.2s
+```
 
-## Usage
+The name of the generated file is based on your gem version(s). You can override it with an argument.
 
-TODO: Write usage instructions here
+```
+$ rubocop-schema-gen rubocop-schema.json
+Generating rubocop-schema.json … complete in 0.7s
+```
 
-## Development
+Pass `-` to write to standard output.
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+The generator caches pages from https://raw.githubusercontent.com/rubocop in `~/.rubocop-schema-cache`.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Please refer to your IDE's documentation regarding applying the schema to your `.rubocop.yml` file.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/rubocop-schema. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/rubocop-schema/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/hx/rubocop-schema. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/hx/rubocop-schema/blob/master/CODE_OF_CONDUCT.md).
 
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the Rubocop::Schema project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/rubocop-schema/blob/master/CODE_OF_CONDUCT.md).
+The gem is available as open source under the terms of the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).

data/assets/templates/cop_schema.yml

@@ -1,9 +1,7 @@
 type: object
 additionalProperties: true
 
-propertyNames:
-  type: string
-  pattern: '^[A-Z][A-Za-z]*$'
+propertyNames: { $ref: '#/definitions/attributeName' }
 
 properties:
   Enabled: { type: boolean }

data/assets/templates/schema.yml

@@ -41,6 +41,10 @@ definitions:
       - type: array
         items: { type: string }
 
+  attributeName:
+    type: string
+    pattern: '^[A-Z][A-Za-z]*$'
+
 properties:
   inherit_from: { type: string }
 

data/bin/console

@@ -2,6 +2,7 @@
 
 require 'bundler/setup'
 require 'rubocop/schema'
+require 'rubocop/schema/cli'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.

data/exe/rubocop-schema-gen

@@ -1,8 +1,10 @@
 #!/usr/bin/env ruby
 
-require 'bundler/setup'
+Dir.chdir File.expand_path('..', __dir__) do
+  require 'bundler/setup'
+end
 require 'rubocop/schema'
 require 'rubocop/schema/cli'
 require 'json'
 
-RuboCop::Schema::CLI.new(Dir.pwd, ENV, ARGV).run
+RuboCop::Schema::CLI.new.run

data/lib/rubocop/schema.rb

@@ -2,9 +2,6 @@ require 'pathname'
 require 'rubocop'
 
 require 'rubocop/schema/version'
-require 'rubocop/schema/cache'
-require 'rubocop/schema/scraper'
-require 'rubocop/schema/lockfile_inspector'
 
 module RuboCop
   module Schema

data/lib/rubocop/schema/ascii_doc/base.rb

@@ -0,0 +1,53 @@
+require 'rubocop/schema/ascii_doc/stringifier'
+require 'rubocop/schema/helpers'
+
+module RuboCop
+  module Schema
+    module AsciiDoc
+      class Base
+        include Helpers
+
+        # @param [Asciidoctor::AbstractBlock] ascii_block
+        def initialize(ascii_block)
+          @root = ascii_block
+          scan
+        end
+
+        protected
+
+        # @return [Asciidoctor::Document]
+        attr_reader :root
+
+        def scan
+          raise NotImplementedError
+        end
+
+        def link_text(str)
+          # The Asciidoctor API doesn't provide access to the raw title, or parts of it.
+          # If performance becomes an issue, this could become a regexp or similarly crude solution.
+          Nokogiri::HTML(str).at_css('a')&.text
+        end
+
+        # @param [Asciidoctor::Table] table
+        # @return [Array<Hash>] A hash for each row, with table headings as keys
+        def table_to_hash(table)
+          headings = table.rows.head.first.map(&:text)
+          table.rows.body.map do |row|
+            headings.each_with_index.map do |heading, i|
+              [heading, strip_html(row[i].text)]
+            end.to_h
+          end
+        end
+
+        def stringify_section(section)
+          @stringifier ||= Stringifier.new
+          @stringifier.stringify section
+        end
+
+        def presence(str)
+          str unless str.strip == ''
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/schema/ascii_doc/cop.rb

@@ -0,0 +1,93 @@
+require 'rubocop/schema/ascii_doc/base'
+require 'rubocop/schema/value_objects'
+
+module RuboCop
+  module Schema
+    module AsciiDoc
+      class Cop < Base
+        # @return [String]
+        attr_reader :name
+
+        # @return [String]
+        attr_reader :description
+
+        # @return [TrueClass, FalseClass]
+        attr_reader :enabled_by_default
+
+        # @return [TrueClass, FalseClass]
+        attr_reader :supports_autocorrect
+
+        # @return [Array<Attribute>]
+        attr_reader :attributes
+
+        ATTRS = public_instance_methods(false).freeze
+
+        def to_h
+          ATTRS.map { |k| [k, __send__(k)] }.to_h
+        end
+
+        protected
+
+        def scan
+          @name = root.title
+          read_stats_table
+          read_description
+          read_attributes
+        end
+
+        private
+
+        def read_stats_table
+          return unless stats_table
+
+          @enabled_by_default   = stats_table['Enabled by default'] == 'Enabled'
+          @supports_autocorrect = stats_table['Supports autocorrection'] == 'Yes'
+        end
+
+        def read_description
+          blocks       = root.blocks[find_description_range]
+          @description = blocks.map(&method(:stringify_section)).join("\n\n") if blocks.any?
+        end
+
+        def read_attributes
+          return unless attr_table_block
+
+          @attributes = table_to_hash(attr_table_block).map do |row|
+            Attribute.new(
+              name:    row['Name'],
+              default: presence(row['Default value']),
+              type:    presence(row['Configurable values'])
+            )
+          end
+        end
+
+        def find_description_range
+          top    = stats_table_block ? root.blocks.index(stats_table_block) + 1 : 0
+          bottom = root.blocks.index(root.sections.first) || 0
+          top..(bottom - 1)
+        end
+
+        # @return [Asciidoctor::Block, nil]
+        def stats_table_block
+          @stats_table_block ||= root
+            .query(context: :table) { |t| t.rows.head.first.first.text == 'Enabled by default' }
+            .first
+        end
+
+        # @return [Asciidoctor::Block, nil]
+        def attr_table_block
+          @attr_table_block ||= root
+            .query(context: :section) { |s| s.title == 'Configurable attributes' }
+            &.first
+            &.query(context: :table)
+            &.first
+        end
+
+        # @return [Array<Hash>, nil]
+        def stats_table
+          @stats_table ||= stats_table_block && table_to_hash(stats_table_block).first
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/schema/ascii_doc/department.rb

@@ -0,0 +1,21 @@
+require 'rubocop/schema/ascii_doc/base'
+require 'rubocop/schema/ascii_doc/cop'
+
+module RuboCop
+  module Schema
+    module AsciiDoc
+      class Department < Base
+        # @return [Array<Cop>]
+        attr_reader :cops
+
+        protected
+
+        def scan
+          @cops = root
+            .query(context: :section) { |s| s.title.start_with? "#{root.title}/" }
+            .map &Cop.method(:new)
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/schema/ascii_doc/index.rb

@@ -0,0 +1,20 @@
+require 'rubocop/schema/ascii_doc/base'
+
+module RuboCop
+  module Schema
+    module AsciiDoc
+      class Index < Base
+        # @return [Array<string>]
+        attr_reader :department_names
+
+        protected
+
+        def scan
+          @department_names = root
+            .query(context: :section) { |s| s.title.start_with? 'Department ' }
+            .map { |section| link_text section.title }
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/schema/ascii_doc/stringifier.rb

@@ -0,0 +1,49 @@
+require 'rubocop/schema/helpers'
+
+module RuboCop
+  module Schema
+    module AsciiDoc
+      class Stringifier
+        include Helpers
+
+        # @param [Asciidoctor::Section] section
+        def stringify(section)
+          method = :"stringify_#{section.context}"
+          raise "Don't know what to do with #{section.context}" unless private_methods(false).include? method
+
+          __send__(method, section)
+        end
+
+        private
+
+        # @param [Asciidoctor::Section] section
+        def stringify_paragraph(section)
+          section.lines.join ' '
+        end
+
+        alias stringify_admonition stringify_paragraph
+        alias stringify_listing stringify_paragraph
+
+        # @param [Asciidoctor::Section] section
+        def stringify_literal(section)
+          section.lines.map { |l| "  #{l}" }.join "\n"
+        end
+
+        # @param [Asciidoctor::Section] section
+        def stringify_ulist(section)
+          section.blocks.map { |b| " - #{strip_html b.text}" }.join "\n\n" # TODO: single newline
+        end
+
+        # @param [Asciidoctor::Section] section
+        def stringify_olist(section)
+          section.blocks.map.with_index { |b, i| "  #{i + 1}. #{strip_html b.text}" }.join "\n\n" # TODO: single newline
+        end
+
+        # @param [Asciidoctor::Section] section
+        def stringify_dlist(section)
+          strip_html section.convert # Too hard, just go HTML for now
+        end
+      end
+    end
+  end
+end