distincter2 1.3.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b8d1d5aa62302ef718c566a9053311075f4999fc1e8509c1e2d93e788f85a87
-  data.tar.gz: 66ebec72784df7a866f179c730f354120db1e227911655a8ee11ce509947adb5
+  metadata.gz: 0a6cd807f2f889320a66b76f7f787b1caac82139d48026c9840966e36a06a20a
+  data.tar.gz: 4240110004fb807cad542c872e03b952fbcbbc2c09b8d98295703e3074ff5148
 SHA512:
-  metadata.gz: 81680f8b162f0851527be19be9a8018ebf34a9a613aab8f7451a9035ba3e8b1146303054810dff9724638ab3bd871965e27a2c030949c85804a2a477e0e6f4f4
-  data.tar.gz: 9c5898feafe48a5111c47bdbe99907c2b36eba081ffcc2d89f9e70cdaa9cbc542828f76f10cf6f64ba7d7dc68acb6a44a9793f2f4b0e324b11277b7e4c25fa1d
+  metadata.gz: c0869afab0fbe87c5cb6daa71aa6dd6c8ca0b123e86623031acbe857ddebad38dfe8b143e08b406e88f4ae81e72963b34153be216f40121f2fc53af2fb92ad9f
+  data.tar.gz: 133222727ec67744206a168e09aa52cbbea1a25fd8dfc36f3ae502000c04145dec2545271d4f95b244045c4fccc908641b1f07afd95b3d0a6340b4ef808119bd

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Artem Fomchenkov
+Copyright (c) 2023-2025 Artem Fomchenkov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -10,22 +10,20 @@ A tool that can check lists in Markdown files and find duplicates.
 
 ## How to use
 
-### Global installation
+You need to install `distincter2` from [RubyGems](https://rubygems.org/gems/distincter2) by next command:
 
 ```shell
 $ gem i distincter2
-$ distincter2 ./path_to_directory_with_markdown_files
 ```
-
-### Local installation
+After that, run `distincter2` from any place with a path to your markdown files as parameter:
 
 ```shell
-$ ./bin/local_distincter2 ./path_to_directory_with_markdown_files
+$ distincter2 ./path_to_directory_with_markdown_files
 ```
 
 ### Config
 
-Add `distincter2_config.d2c` to root of your project and add excluded files line by line. Below you can find examples.
+Add `.d2_config.d2c` to root of your project and add excluded files line by line. Below you can find examples.
 
 #### v1
 
@@ -47,6 +45,25 @@ BOOKS.md
 DONE.md
 ```
 
+## Documentation
+
+You can generate documentation locally by next command from root of the project:
+
+```shell
+$ rdoc
+```
+
+## How to contribute
+
+Read [Commit Convention](./COMMIT_CONVENTION.md). Make sure your build is green before you contribute your pull request.
+Then:
+
+```shell
+$ bundle exec rake
+```
+
+If you don't see any error messages, submit your pull request.
+
 ## Contributors
 
 * [@fartem](https://github.com/fartem) as Artem Fomchenkov

data/lib/distincter2/checker.rb

@@ -1,26 +1,31 @@
 # frozen_string_literal: true
 
 module Distincter2
-  # distincter2 checker.
-  # Handles a file and operate them.
+  # Class to check for duplicate lines in markdown files
   class D2Checker
-    # @param {D2Config} config
-    # @param {Boolean} mute
+    # Initialize the D2Checker with a configuration object and an optional mute flag
+    #
+    # @param config [Object] The configuration object containing settings for the checker
+    # @param mute [Boolean] A flag indicating whether to mute the output of duplicate lines (default: false)
     def initialize(config, mute: false)
       @config = config
       @mute = mute
     end
 
-    # @param {String} path
+    # Check for duplicate lines in markdown files within a given directory
+    #
+    # @param path [String] The path to the directory to check
+    # @return [Array] An array of duplicate lines found in the markdown files
     def check(path)
       duplicates = analyze_dir(path)
 
       exit(duplicates.empty? ? 0 : 1)
     end
 
-    # @param {String} path
-    # @return {String[]}
-    # rubocop:disable Metrics/MethodLength
+    # Recursively analyze a directory for duplicate lines in markdown files
+    #
+    # @param path [String] The path to the directory to analyze
+    # @return [Array] An array of duplicate lines found in the markdown files
     def analyze_dir(path)
       duplicates = []
       ::Dir.foreach(path).each do |entry|
@@ -45,18 +50,20 @@ module Distincter2
       duplicates
     end
 
-    # rubocop:enable Metrics/MethodLength
-
-    # @param {String} entry
+    # Check if a file can be analyzed based on the configuration settings
+    #
+    # @param entry [String] The name of the file to check
+    # @return [Boolean] True if the file can be analyzed, false otherwise
     def can_analyze(entry)
       return false unless @config.version == 'v1'
 
       @config.exclude_paths.none?(entry)
     end
 
-    # @param {String} path
-    # @return {String[]}
-    # rubocop:disable Metrics/MethodLength
+    # Analyze a markdown file for duplicate lines
+    #
+    # @param path [String] The path to the markdown file to analyze
+    # @return [Array] An array of duplicate lines found in the markdown file
     def analyze_file(path)
       lines = []
       ::File.open(path, 'r') do |file|
@@ -75,7 +82,5 @@ module Distincter2
 
       duplicates
     end
-
-    # rubocop:enable Metrics/MethodLength
   end
 end

data/lib/distincter2/config.rb

@@ -3,51 +3,71 @@
 require 'set'
 
 module Distincter2
-  # Distincter2 config.
+  # Class representing the configuration for Distincter2.
   class D2Config
-    # @param {String[]} exclude_paths
-    # @param {String} version
+    # Initializes a new instance of D2Config.
+    #
+    # @param exclude_paths [Array<String>] An array of paths to be excluded.
+    # @param version [String] The version of the configuration. Default is 'v1'.
     def initialize(exclude_paths, version = 'v1')
       @exclude_paths = exclude_paths.to_set
       @version = version
     end
 
-    attr_accessor :exclude_paths, :version
+    # Accessor for the exclude_paths attribute.
+    #
+    # @return [Set<String>] The set of paths to be excluded.
+    attr_accessor :exclude_paths
+
+    # Accessor for the version attribute.
+    #
+    # @return [String] The version of the configuration.
+    attr_accessor :version
   end
 
-  # D2Config with empty arguments.
-  class D2ConfigEmpty < ::Distincter2::D2Config
+  # Class representing an empty configuration for Distincter2.
+  # This class inherits from D2Config and initializes with an empty array of exclude_paths.
+  class D2EmptyConfig < ::Distincter2::D2Config
     # Constructor without paths.
+    #
+    # @return [void]
     def initialize
+      # Calls the parent class's initialize method with an empty array of exclude_paths.
       super([])
     end
   end
 
-  # D2Config parser.
+  # Class representing a parser for Distincter2 configuration files.
   class D2ConfigParser
-    # @param {String} config_path
+    # Initializes a new instance of D2ConfigParser.
+    #
+    # @param config_path [String] The path to the configuration file.
     def initialize(config_path)
       @config_path = config_path
     end
 
-    # @return {D2Config}
-    # rubocop:disable Metrics/MethodLength
+    # Parses the configuration file and returns a D2Config object.
+    #
+    # @return [Distincter2::D2Config] A D2Config object representing the parsed configuration.
     def parse
       exclude_paths = []
       version = 'v1'
+
+      # Open the configuration file and read its lines.
       ::File.open(@config_path, 'r') do |file|
         file.readlines.each do |line|
           l = line.strip
 
-          next if l == 'v1'
-
-          next if l.empty?
+          # Skip lines that contain the version number or are empty.
+          next if l == 'v1' || l.empty?
 
+          # Add the non-empty, non-version lines to the exclude_paths array.
           exclude_paths << l
         end
       end
+
+      # Create a new D2Config object with the parsed exclude_paths and version.
       ::Distincter2::D2Config.new(exclude_paths, version)
     end
-    # rubocop:enable Metrics/MethodLength
   end
 end

data/lib/distincter2.rb

@@ -5,18 +5,43 @@ require_relative './distincter2/config'
 
 module Distincter2
   # distincter2 runner. Just an entrypoint.
+  # This class represents the main entry point for the Distincter2 runner.
   class Distincter2
+    # This method starts the validation process for a given project path.
     #
-    # You need a project path to run validation.
+    # @param path [String] The path to the project directory.
+    # @return [void]
+    #
+    # @example
+    #   # Create an instance of Distincter2
+    #   distincter = Distincter2.new
+    #
+    #   # Start the validation process for a project located at '/path/to/project'
+    #   distincter.start('/path/to/project')
     def start(path)
-      config_path = "#{path}/distincter2_config.d2c"
+      # Construct the path to the .d2_config.d2c file
+      new_config_path = "#{path}/.d2_config.d2c"
+      old_config_path =
+        if ::File.exist?(new_config_path)
+          nil
+        else
+          "#{path}/distincter2_config.d2c"
+        end
+
+      config_path = old_config_path.nil? ? new_config_path : old_config_path
+
+      # Create a new D2Checker instance with the appropriate configuration
       checker = ::Distincter2::D2Checker.new(
         if ::File.exist?(config_path)
+          # If the config file exists, parse it and use the parsed configuration
           ::Distincter2::D2ConfigParser.new(config_path).parse
         else
-          ::Distincter2::D2ConfigEmpty.new
+          # If the config file does not exist, use an empty configuration
+          ::Distincter2::D2EmptyConfig.new
         end
       )
+
+      # Run the validation process using the checker
       checker.check(path)
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: distincter2
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Artem Fomchenkov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-14 00:00:00.000000000 Z
+date: 2025-01-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize
@@ -114,7 +114,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.23
 signing_key:
 specification_version: 4
 summary: A tool that can check lists in Markdown files and find duplicates