convenient_service 0.1.0

data/lib/convenient_service/examples/rails/gemfile/services/assert_valid_ruby_syntax.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class AssertValidRubySyntax
+            include RailsService::Config
+
+            attribute :content, :string
+
+            def result
+              ##
+              # NOTE: `> /dev/null 2>&1` is used to hide output.
+              # https://unix.stackexchange.com/a/119650/394253
+              #
+              check_ruby_syntax_result = Services::RunShell.result(command: "ruby -c #{file.path} > /dev/null 2>&1")
+
+              return error("`#{content}` contains invalid Ruby syntax") unless check_ruby_syntax_result.success?
+
+              success
+            end
+
+            private
+
+            def file
+              @file ||= ::Tempfile.new.tap { |tempfile| tempfile.write(content) }.tap(&:close)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/format.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Rails::Gemfile::Services::Format.result(path: "Gemfile")
+# result = ConvenientService::Examples::Rails::Gemfile::Services::Format.result(path: "spec/cli/gemfile/format/fixtures/Gemfile")
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class Format
+            include RailsService::Config
+
+            attribute :path, :string
+
+            step Services::ReadFileContent, in: :path, out: :content
+            step Services::StripComments, in: :content, out: :content_without_comments
+            step Services::ParseContent, in: {content: :content_without_comments}, out: :parsed_content
+            step Services::FormatHeader, in: :parsed_content, out: {formatted_content: :formatted_header_content}
+            step Services::FormatBody, in: :parsed_content, out: {formatted_content: :formatted_body_content}
+
+            before :result do
+              @progressbar = ::ProgressBar.create(title: "Formatting", total: steps.count)
+            end
+
+            after :step do |step_result|
+              @progressbar.increment
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/format_body.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Rails::Gemfile::Services::FormatBody.result(
+#   parsed_content: {
+#     gems: [
+#       {
+#         envs: [],
+#         line: %(gem "bootsnap", ">= 1.4.4", require: false)
+#       },
+#       {
+#         envs: [],
+#         line: %(gem "pg")
+#       },
+#       {
+#         envs: [:development],
+#         line: %(gem "listen", "~> 3.3")
+#       },
+#       {
+#         envs: [:development],
+#         line: %(gem "web-console", ">= 4.1.0")
+#       },
+#       {
+#         envs: [:development, :test],
+#         line: %(gem "rspec-rails")
+#       },
+#       {
+#         envs: [:test],
+#         line: %(gem "simplecov", require: false)
+#       },
+#       {
+#         envs: [],
+#         line: %(gem "tzinfo-data", platforms: [:mingw, :mswin, :x64_mingw, :jruby])
+#       }
+#     ]
+#   }
+# )
+#
+# NOTE: Check the corresponding spec file to see more examples.
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class FormatBody
+            include RailsService::Config
+
+            attr_accessor :parsed_content
+
+            step Services::FormatGemsWithoutEnvs,
+              in: :parsed_content,
+              out: [{formatted_content: :formatted_gems_without_envs_content}]
+
+            step Services::FormatGemsWithEnvs,
+              in: :parsed_content,
+              out: [{formatted_content: :formatted_gems_with_envs_content}]
+
+            step :result,
+              in: [:formatted_gems_without_envs_content, :formatted_gems_with_envs_content],
+              out: :formatted_content
+
+            def result
+              success(formatted_content: format_content)
+            end
+
+            private
+
+            def format_content
+              [formatted_gems_without_envs_content, formatted_gems_with_envs_content].reject(&:empty?).join("\n")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/format_gems_with_envs.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Rails::Gemfile::Services::FormatGemsWithEnvs.result(
+#   parsed_content: {
+#     gems: [
+#       {
+#         envs: [:development],
+#         line: %(gem "listen", "~> 3.3")
+#       },
+#       {
+#         envs: [:development],
+#         line: %(gem "web-console", ">= 4.1.0")
+#       },
+#       {
+#         envs: [:development, :test],
+#         line: %(gem "rspec-rails")
+#       },
+#       {
+#         envs: [:test],
+#         line: %(gem "simplecov", require: false)
+#       }
+#     ]
+#   }
+# )
+#
+# NOTE: Check the corresponding spec file to see more examples.
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class FormatGemsWithEnvs
+            BLOCK_END = "end"
+            BLOCK_DO = "do"
+            COMMA_WITH_SPACE = ", "
+            EMPTY_LINE = ""
+            ENTER = "\n"
+            GROUP = "group"
+            SPACE = " "
+            TAB = "  "
+
+            include RailsService::Config
+
+            attr_accessor :parsed_content
+
+            def result
+              success(formatted_content: format_content)
+            end
+
+            private
+
+            def format_content
+              return "" if gems_with_envs.none?
+
+              gems_with_envs
+                .group_by { |gem| gem[:envs] }
+                .sort
+                .map { |envs, gems|
+                  content = EMPTY_LINE.dup
+
+                  content << GROUP << SPACE << envs.map { |env| ":#{env}" }.join(COMMA_WITH_SPACE) << SPACE << BLOCK_DO << ENTER
+
+                  content << gems.map { |gem| "#{TAB}#{gem[:line]}#{ENTER}" }.join
+
+                  content << BLOCK_END << ENTER
+                }
+                .join(ENTER)
+            end
+
+            def gems_with_envs
+              @gems_with_envs ||= parsed_content[:gems].to_a.select { |gem| gem[:envs].any? }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/format_gems_without_envs.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Rails::Gemfile::Services::FormatGemsWithoutEnvs.result(
+#   parsed_content: {
+#     gems: [
+#       {
+#         envs: [],
+#         line: %(gem "bootsnap", ">= 1.4.4", require: false)
+#       },
+#       {
+#         envs: [],
+#         line: %(gem "pg")
+#       },
+#       {
+#         envs: [],
+#         line: %(gem "rails", "~> 6.1.3", ">= 6.1.3.2")
+#       },
+#       {
+#         envs: [],
+#         line: %(gem "webpacker", "~> 5.0")
+#       },
+#       {
+#         envs: [],
+#         line: %(gem "tzinfo-data", platforms: [:mingw, :mswin, :x64_mingw, :jruby])
+#       }
+#     ]
+#   }
+# )
+#
+# NOTE: Check the corresponding spec file to see more examples.
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class FormatGemsWithoutEnvs
+            EMPTY_LINE = ""
+            ENTER = "\n"
+
+            include RailsService::Config
+
+            attr_accessor :parsed_content
+
+            def result
+              success(formatted_content: format_content)
+            end
+
+            private
+
+            def format_content
+              return "" if gems_without_envs.none?
+
+              gems_without_envs
+                .map { |gem| gem[:line] }
+                .reduce(EMPTY_LINE.dup) { |content, line| content << line << ENTER }
+            end
+
+            def gems_without_envs
+              @gems_without_envs ||= parsed_content[:gems].to_a.select { |gem| gem[:envs].none? }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/format_header.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Rails::Gemfile::Services::FormatHeader.result(
+#   parsed_content: {
+#     ruby: [
+#       %(ruby "3.0.1")
+#     ],
+#     source: [
+#       %(source "https://rubygems.org")
+#     ],
+#     git_source: [
+#       %(git_source(:github) { |repo| "https://github.com/\#{repo}.git" })
+#     ]
+#   },
+#   skip_frozen_string_literal: true
+# )
+#
+# NOTE: Check the corresponding spec file to see more examples.
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class FormatHeader
+            FROZEN_STRING_LITERAL = "# frozen_string_literal: true"
+            EMPTY_LINE = ""
+            ENTER = "\n"
+
+            include RailsService::Config
+
+            ##
+            # NOTE: `attribute` has no `hash` type.
+            # https://github.com/rails/rails/blob/v7.0.4/activemodel/lib/active_model/type.rb#L42
+            #
+            # TODO: Implement custom types.
+            #
+            attr_accessor :parsed_content
+
+            attribute :skip_frozen_string_literal, :boolean, default: false
+
+            def result
+              success(formatted_content: format_content)
+            end
+
+            private
+
+            def format_content
+              content = EMPTY_LINE.dup
+
+              content << FROZEN_STRING_LITERAL << ENTER << ENTER unless skip_frozen_string_literal
+
+              parsed_content.slice(:source, :git_source, :ruby).each do |_group, lines|
+                content << lines.join(ENTER) << ENTER << ENTER
+              end
+
+              content.chomp!
+
+              content
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/parse_content.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Rails::Gemfile::Services::ParseContent.result(
+#   content:     <<~'RUBY'
+#     ruby "3.0.1"
+#     source "https://rubygems.org"
+
+#     git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+#     gem "bootsnap", ">= 1.4.4", require: false
+
+#     group :development do
+#       gem "listen", "~> 3.3"
+#     end
+
+#     group :development, :test do
+#       gem "rspec-rails"
+#     end
+#   RUBY
+# )
+#
+# NOTE: Check the corresponding spec file to see more examples.
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class ParseContent
+            RUBY_REGEX = /\A\s*ruby/
+            SOURCE_REGEX = /\A\s*source/
+            GIT_SOURCE_REGEX = /\A\s*git_source/
+            GROUP_REGEX = /\A\s*group/
+            GEM_REGEX = /\A\s*gem/
+            BLOCK_END_REGEX = /\A\s*end/
+            ENV_SCAN_REGEX = /:(\w+)/
+
+            include RailsService::Config
+
+            attribute :content, :string
+
+            validates :content, presence: true
+
+            step Services::AssertValidRubySyntax, in: :content
+            step :result, in: :content, out: :parsed_content
+
+            def result
+              success(data: {parsed_content: parse_content})
+            end
+
+            def parse_content
+              hash = ::Hash.new { |h, k| h[k] = [] }
+
+              ::StringIO.open(content) do |io|
+                envs = []
+
+                until io.eof?
+                  line = io.readline.rstrip
+
+                  case line
+                  when RUBY_REGEX
+                    hash[:ruby] << line
+                  when SOURCE_REGEX
+                    hash[:source] << line
+                  when GIT_SOURCE_REGEX
+                    hash[:git_source] << line
+                  when GROUP_REGEX
+                    envs = line.scan(ENV_SCAN_REGEX).map(&:first).map(&:to_sym)
+                  when GEM_REGEX
+                    hash[:gems] << {envs: envs, line: line.lstrip}
+                  when BLOCK_END_REGEX
+                    envs = []
+                  else
+                    hash[:rest] << line
+                  end
+                end
+              end
+
+              hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/print_shell_command.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+#   ConvenientService::Examples::Rails::Gemfile::Services::PrintShellCommand.result(text: "ls -a")
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class PrintShellCommand
+            include RailsService::Config
+
+            attribute :text, :string
+            attribute :out, default: $stdout
+
+            validates :text, presence: true
+
+            def result
+              out.puts
+
+              out.puts ::Paint["$ #{text}", :blue, :bold]
+
+              success
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/read_file_content.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class ReadFileContent
+            include RailsService::Config
+
+            attribute :path, :string
+
+            validates :path, presence: true
+
+            step Services::AssertFileExists, in: :path
+            step Services::AssertFileNotEmpty, in: :path
+            step :result, in: :path, out: :content
+
+            def result
+              success(data: {content: ::File.read(path)})
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/run_shell.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class RunShell
+            include RailsService::Config
+
+            attribute :command, :string
+            attribute :debug, :boolean, default: false
+
+            validates :command, presence: true
+
+            def result
+              Services::PrintShellCommand.result(text: command) if debug
+
+              ##
+              # NOTE: When the command exit code is 0, `system` return true, and false otherwise.
+              # - https://ruby-doc.org/core-3.1.2/Kernel.html#method-i-system
+              # - https://stackoverflow.com/a/37329716/12201472
+              #
+              if system(command)
+                success
+              else
+                error(message: "#{command} returned non-zero exit code")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/strip_comments.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+##
+# Usage:
+#
+#   ConvenientService::Examples::Rails::Gemfile::Services::StripComments.result(content: "abc")
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class StripComments
+            include RailsService::Config
+
+            attribute :content, :string
+
+            validates :content, presence: true
+
+            alias_method :content_with_comments, :content
+
+            step Services::AssertNpmPackageAvailable, in: {name: -> { "strip-comments" }}
+            step Services::RunShell, in: {command: -> { "node -e '#{js_script}' #{file_with_comments.path} #{file_without_comments.path}" }}
+            step :result, in: :file_without_comments, out: :content_without_comments
+
+            def result
+              success(data: {content_without_comments: file_without_comments.read})
+            end
+
+            ##
+            # NOTE: When you have no time to do something well, delegate that task to someone who already works with it all the time.
+            # That is why `strip-comments` npm package is used to remove comments.
+            #
+            def js_script
+              ##
+              # NOTE: `main` function is created in order to have an ability to use early returns.
+              #
+              # IMPORTANT: Use only double quotes inside this JS script, since it is later consumed by `node -e` option wrapped by single quoutes.
+              #
+              # TODO: Consider to use WeakRef if memory is a concern.
+              # https://ruby-doc.org/stdlib-2.5.1/libdoc/weakref/rdoc/WeakRef.html
+              #
+              # TODO: Jest tests for JS script.
+              #
+              @js_script ||= <<~JAVASCRIPT.gsub(/\n\s*/, " ")
+                const main = () => {
+                  const process = require("process");
+                  const fs = require("fs");
+
+                  /**
+                   * TODO: try/catch when "strip-comments" is not available.
+                   */
+                  const strip = require("strip-comments");
+
+                  const fileWithCommentsPath = process.argv[1];
+                  const fileWithoutCommentsPath = process.argv[2];
+                  const language = process.argv[3] || "ruby";
+
+                  if (!fileWithCommentsPath) {
+                    console.log("Error: Input file path is NOT passed.");
+
+                    process.exit(1);
+                  }
+
+                  if (!fileWithoutCommentsPath) {
+                    console.log("Error: Output file path is NOT passed.");
+
+                    process.exit(1);
+                  }
+
+                  if (!["ruby", "javascript"].includes(language)) {
+                    console.log("Error: Language " + language + " is NOT supported.");
+
+                    process.exit(1);
+                  }
+
+                  const fileWithCommentsContent = fs.readFileSync(fileWithCommentsPath, { encoding: "utf8" });
+                  const fileWithoutCommentsContent = strip(fileWithCommentsContent, { language });
+
+                  fs.writeFileSync(fileWithoutCommentsPath, fileWithoutCommentsContent, { encoding: "utf8" });
+
+                  process.exit(0);
+                };
+
+                main();
+              JAVASCRIPT
+            end
+
+            def file_with_comments
+              ##
+              # NOTE: Tempfile is used to avoid issues with escaping of quotes inside JS script.
+              #
+              @file_with_comments ||= ::Tempfile.new.tap { |tempfile| tempfile.write(content_with_comments) }.tap(&:close)
+            end
+
+            def file_without_comments
+              ##
+              # NOTE: JS script tries to fill content of the file without comments.
+              #
+              @file_without_comments ||= ::Tempfile.new
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "services/run_shell"
+require_relative "services/assert_file_exists"
+require_relative "services/assert_file_not_empty"
+require_relative "services/assert_node_available"
+require_relative "services/assert_npm_package_available"
+require_relative "services/assert_valid_ruby_syntax"
+require_relative "services/read_file_content"
+require_relative "services/strip_comments"
+require_relative "services/parse_content"
+require_relative "services/print_shell_command"
+require_relative "services/format_header"
+require_relative "services/format_gems_without_envs"
+require_relative "services/format_gems_with_envs"
+require_relative "services/format_body"
+require_relative "services/format"