lcsp 1.1.1 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e712e000a8e15ef4b85889acdef9d9148e29047f1062682b4732fc3cbab2be3
-  data.tar.gz: 52bee9c3f6dcfb6424a8527b2f4b1a1a8c2ff14a84db52027342f796600565dc
+  metadata.gz: b2dd406499415daf45abcf93e8d29af8c35688224cc1b260c5e7ca892c68c55f
+  data.tar.gz: a545c498a3a2fab4efdd9b8b4e1ff9c3ac1a8b5729973491abf6c85d6012420f
 SHA512:
-  metadata.gz: aa994764f5906f9ea8552867012855bcb35e69cef3de26ce5966530849a487630d37062af5cb2a6ae608e17b79db56e7efb5378b72e1f0b72fff0a772790f08d
-  data.tar.gz: c98409cf3dd0d5423765e0f504068eaa34832202ba520d62c784ab7f09b7ea6c42f50d425963c397668ad00d308329dde088118583de4f28188290c23a0a73ba
+  metadata.gz: 036a29fef2e949ba4bd87c0cf9d674f5214b347e73600616c256d79bcbb8f50579e234b16ffbcb97e48eefa691c258f1c61f4ab5d56749714e7364ec1d8f1c92
+  data.tar.gz: 5da7e15d3c63f19e72eacea1f798812085823442443564baf6574b4578233318a12a628485d1c8aaf8c480baf34ff30f629bd6693919f987cb98fbf36c563ddd

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

@@ -1,44 +1,96 @@
 # lcsp
 
-[![GitHubActions](https://github.com/fartem/distincter2/workflows/Build/badge.svg)](https://github.com/fartem/distincter2/actions?branch=master)
+[![GitHubActions](https://github.com/fartem/lcsp/workflows/Build/badge.svg)](https://github.com/fartem/lcsp/actions?branch=master)
 [![codebeat badge](https://codebeat.co/badges/eca07972-3b5a-4b3c-a424-a277ce8128b7)](https://codebeat.co/projects/github-com-fartem-lcsp-master)
 [![Gem Version](https://badge.fury.io/rb/lcsp.svg)](https://badge.fury.io/rb/lcsp)
 [![Gem Downloads](https://img.shields.io/gem/dt/lcsp)](https://badge.fury.io/rb/lcsp)
 
 ## About
 
-A tool for showing solutions from LeetCode.
+A tool for showing and counting solutions from LeetCode.
 
 ## How to use
 
 ### Installation
 
-Soon.
+#### Download gem from RubyGems
 
-### Run
+```shell
+$ gem i lcsp
+```
+
+#### As local installed gem
+
+Build and install gem from sources:
+
+```shell
+$ gem build lcsp.gemspec
+$ gem i lcsp
+```
+
+### Print solution
 
-You need to provide 3 arguments for run `lcsp`:
+You need to provide 3 arguments for run `print` command:
 
-| Parameter number | Description       | Example         |
-|------------------|-------------------|-----------------|
-| 1                | GitHub user name  | `fartem`        |
-| 2                | Repository name   | `leetcode-ruby` |
-| 3                | Number of problem | `11`            |
+| Parameter | Description       | Example         |
+| --------- | ----------------- | --------------- |
+| `user`    | GitHub user name  | `fartem`        |
+| `repo`    | Repository name   | `leetcode-ruby` |
+| `number`  | Number of problem | `11`            |
 
 One of valid input variants be like:
 
 ```shell
-$ lcsp fartem leetcode-ruby 11
+$ lcsp print --user=fartem --repo=leetcode-ruby --number=11
+```
+
+### Count solutions
+
+You need to provide 2 arguments for run `count` command:
+
+| Parameter | Description      | Example         |
+| --------- | ---------------- | --------------- |
+| `user`    | GitHub user name | `fartem`        |
+| `repo`    | Repository name  | `leetcode-ruby` |
+
+One of valid input variants be like:
+
+```shell
+$ lcsp count --user=fartem --repo=leetcode-ruby
+```
+
+### Clean local cache
+
+Just run next command from any folder:
+
+```shell
+$ lcsp clean
+```
+
+### Contacts
+
+You can see actual author contacts by following command:
+
+```shell
+$ lcsp author
 ```
 
-### How to write your own `LCSPResolver`
+### Version
+
+If you need to check installed version of `lcsp`, run from shell:
+
+```shell
+$ lcsp author
+```
+
+### How to write your own `LCSPFinder`
 
 #### Read before start
 
-`lcsp` works with custom resolvers - classes that should placed in your project and that will perform
+`lcsp` works with custom finders - classes that should placed in your project and that will perform
 search locally.
 
-You need to write resolver classes in Ruby because only this format accepting right now, but all work
+You need to write finder classes in Ruby because only this format accepting right now, but all work
 around search and parse for your repository you can place in classes/scripts/files in any other programming language.
 
 One of the correct and working example available
@@ -65,10 +117,6 @@ module LCSP
     # @return {String}
     def solution
     end
-
-    # @param {String} path
-    # @param {String[]} dirs
-    def fill_directories(path, dirs) end
   end
 end
 ```
@@ -114,6 +162,75 @@ module LCSP
 end
 ```
 
+### How to write your own `LCSCCounter`
+
+#### Read before start
+
+`lcsc` works with custom counters - classes that should placed in your project and that will perform
+count locally.
+
+You need to write counter classes in Ruby because only this format accepting right now, but all work
+around search and parse for your repository you can place in classes/scripts/files in any other programming language.
+
+One of the correct and working example available
+by [this link](https://github.com/fartem/leetcode-ruby/blob/master/lcsp/counter.rb).
+
+#### Template class
+
+`path` are default parameter that are presenting for every repository. It is a path to repository in cache.
+
+```ruby
+# frozen_string_literal: true
+
+require 'find'
+
+module LCSC
+  # Solutions counter.
+  class LCSCCounter
+    # @param {String} path
+    def initialize
+      @path = './'
+    end
+
+    # @return {Integer}
+    def count
+      dir_sub = "#{@path}/lib"
+
+      easy = find_for_dir("#{dir_sub}/easy")
+      medium = find_for_dir("#{dir_sub}/medium")
+
+      easy + medium
+    end
+
+    private
+
+    def find_for_dir(dir)
+      ::Find.find(dir).count { |file| ::File.file?(file) }
+    end
+  end
+end
+```
+
+#### Reference class example
+
+```ruby
+# frozen_string_literal: true
+
+module LCSC
+  # Solutions counter.
+  class LCSCFinder
+    # @param {String} path
+    def initialize(path)
+      @path = path
+    end
+
+    # @return {Integer}
+    def count
+    end
+  end
+end
+```
+
 ## Contributors
 
 * [@fartem](https://github.com/fartem) as Artem Fomchenkov

data/bin/cli.rb

@@ -4,8 +4,6 @@ require 'dry/cli'
 require 'fileutils'
 require 'rubygems'
 
-# frozen_string_literal: true
-
 module CLI
   # lcsp CLI
   module Commands
@@ -53,6 +51,35 @@ module CLI
       end
     end
 
+    # This class represents a command for counting solutions.
+    # It inherits from Dry::CLI::Command and is registered under the 'count' alias.
+    class Count < ::Dry::CLI::Command
+      desc 'Counts solutions'
+
+      option :user,
+             default: '',
+             desc: 'GitHub user name'
+
+      option :repo,
+             default: '',
+             desc: 'GitHub repository with solutions'
+
+      # The main method of the command.
+      # It creates an instance of LCSC::LCSC and calls its start method with the provided options.
+      #
+      # @param options [Hash] The command-line options.
+      # @option options [String] :user The GitHub user name.
+      # @option options [String] :repo The GitHub repository with solutions.
+      #
+      # @return [void]
+      def call(options)
+        ::LCSC::LCSC.new.start(
+          options[:user],
+          options[:repo]
+        )
+      end
+    end
+
     # This class represents a command for cleaning the local cache of LCSP.
     # It inherits from Dry::CLI::Command and is registered under the 'clean' alias.
     class Clean < ::Dry::CLI::Command
@@ -117,6 +144,7 @@ module CLI
     end
 
     register 'print', Print.new, aliases: ['p']
+    register 'count', Count.new, aliases: ['t']
     register 'clean', Clean.new, aliases: ['c']
     register 'version', Version.new, aliases: ['v']
     register 'author', Author.new, aliases: ['a']

data/bin/lcsp

@@ -3,5 +3,6 @@
 # frozen_string_literal: true
 
 require 'lcsp'
+require 'lcsc'
 
 require_relative 'cli'

data/lib/lcsc/resolver.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative '../common/cache'
+
+module LCSC
+  # LCSCResolver logic.
+  class LCSCResolver
+    # LCSCResolver is entry point for any LCSP request by user.
+    #
+    # @param user [String] The GitHub username of the user.
+    # @param repository [String] The name of the repository containing the LCSP problem.
+    def initialize(user, repository)
+      @user = user
+      @repository = repository
+    end
+
+    # Resolves the LCSC by creating an LCSPCache instance, locating the LCSCCounter file,
+    # requiring it, and then creating an LCSCCounter instance to find the solution.
+    #
+    # @return [String] The solution to the LCSP problem.
+    # @return [nil] If the LCSPFinder file is not found or the solution is not found.
+    def resolve
+      cache = ::LCSP::LCSPCache.new(@user, @repository)
+      finder_path = "#{cache.path}/lcsp/counter.rb"
+
+      unless ::File.exist?(finder_path)
+        puts('counter.rb not found in repository. Please, check config and try again.')
+
+        exit(1)
+      end
+
+      require_relative(finder_path)
+
+      count = ::LCSC::LCSCCounter.new(cache.path).count
+
+      if count.nil?
+        puts('Failed to count solutions. Please, check your input and try again.')
+
+        exit(2)
+      end
+
+      count
+    end
+  end
+end

data/lib/lcsc.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'rouge'
+require 'rouge/cli'
+
+require_relative './lcsc/resolver'
+
+module LCSC
+  # This class represents the main functionality of the LCSC (LeetCode Solution Counter) tool.
+  class LCSC
+    # Starts the LCSC tool.
+    #
+    # @param user [String] The GitHub username of the repository owner.
+    # @param repository [String] The name of the GitHub repository.
+    #
+    # @return [Integer] The exit status of the Rouge CLI tool after processing the resolved LCSP.
+    def start(user, repository)
+      output = ::LCSC::LCSCResolver.new(user, repository).resolve
+
+      ::Rouge::CLI.parse([output]).run
+    end
+  end
+end

data/lib/lcsp/resolver.rb

@@ -1,12 +1,11 @@
 # frozen_string_literal: true
 
-require_relative './cache'
+require_relative '../common/cache'
 
 module LCSP
-  # LCSPResolver logic
+  # LCSPResolver logic.
   class LCSPResolver
-    # LCSPResolver is responsible for resolving the Least Common Subsequence Problem (LCSP)
-    # for a given user, repository, and problem number.
+    # LCSPResolver is entry point for any LCSP request by user.
     #
     # @param user [String] The GitHub username of the user.
     # @param repository [String] The name of the repository containing the LCSP problem.

data/lib/lcsp.rb

@@ -6,10 +6,9 @@ require 'rouge/cli'
 require_relative './lcsp/resolver'
 
 module LCSP
-  # This class represents the main functionality of the LCSP (Longest Common Subsequence Problem) tool.
+  # This class represents the main functionality of the LCSP (LeetCode Solution Printer) tool.
   class LCSP
-    # Starts the LCSP tool by resolving the longest common subsequence for a given user, repository,
-    # and pull request number.
+    # Starts the LCSP tool.
     #
     # @param user [String] The GitHub username of the repository owner.
     # @param repository [String] The name of the GitHub repository.
@@ -18,6 +17,7 @@ module LCSP
     # @return [Integer] The exit status of the Rouge CLI tool after processing the resolved LCSP.
     def start(user, repository, number)
       output = ::LCSP::LCSPResolver.new(user, repository, number).resolve
+
       ::Rouge::CLI.parse([output]).run
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lcsp
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.1
 platform: ruby
 authors:
 - Artem Fomchenkov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-20 00:00:00.000000000 Z
+date: 2025-01-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-cli
@@ -134,8 +134,10 @@ files:
 - README.md
 - bin/cli.rb
 - bin/lcsp
+- lib/common/cache.rb
+- lib/lcsc.rb
+- lib/lcsc/resolver.rb
 - lib/lcsp.rb
-- lib/lcsp/cache.rb
 - lib/lcsp/resolver.rb
 homepage: https://github.com/fartem/lcsp
 licenses:
@@ -157,7 +159,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 for showing solutions from LeetCode