convenient_service 0.1.0

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "gemfile/rails_service"
+require_relative "gemfile/services"
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Rails::Gemfile.format(path: "Gemfile")
+# result = ConvenientService::Examples::Rails::Gemfile.format(path: "spec/cli/gemfile/format/fixtures/Gemfile")
+#
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        class << self
+          def format
+            Services::Format[path: path]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/standard/gemfile/services/assert_file_exists.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Standard
+      module Gemfile
+        module Services
+          class AssertFileExists
+            include ConvenientService::Standard::Config
+
+            attr_accessor :path
+
+            def initialize(path:)
+              @path = path
+            end
+
+            def result
+              return failure(path: "Path is `nil`") if path.nil?
+              return failure(path: "Path is empty") if path.empty?
+
+              return error("File with path `#{path}` does NOT exist") unless ::File.exist?(path)
+
+              success
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/standard/gemfile/services/assert_file_not_empty.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Standard
+      module Gemfile
+        module Services
+          class AssertFileNotEmpty
+            include ConvenientService::Standard::Config
+
+            attr_accessor :path
+
+            def initialize(path:)
+              @path = path
+            end
+
+            def result
+              return failure(data: {path: "Path is `nil`"}) if path.nil?
+              return failure(data: {path: "Path is empty"}) if path.empty?
+
+              return error(message: "File with path `#{path}` is empty") if ::File.zero?(path)
+
+              success
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/standard/gemfile/services/assert_node_available.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+#   ConvenientService::Examples::Standard::Gemfile::Services::AssertNodeAvailable.result
+#
+module ConvenientService
+  module Examples
+    module Standard
+      module Gemfile
+        module Services
+          class AssertNodeAvailable
+            include ConvenientService::Standard::Config
+
+            ##
+            # NOTE: `commit_config!` is used explicitly, since `step` method is NOT missed. It will be taken from `Turnip`.
+            # - https://github.com/jnicklas/turnip/blob/master/lib/turnip.rb#L29
+            # - https://github.com/jnicklas/turnip/blob/8272ef92902329d2d29bb5ba2b29cd431523478f/lib/turnip/define.rb#L3
+            #
+            # TODO: Troubleshooting guide.
+            #
+            commit_config!
+
+            ##
+            # NOTE: `> /dev/null 2>&1` is used to hide output.
+            # https://unix.stackexchange.com/a/119650/394253
+            #
+            step Services::RunShell, in: {command: -> { "which node > /dev/null 2>&1" }}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/standard/gemfile/services/assert_npm_package_available.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+#   ConvenientService::Examples::Standard::Gemfile::Services::AssertNpmPackageAvailable.result(name: "lodash")
+#
+module ConvenientService
+  module Examples
+    module Standard
+      module Gemfile
+        module Services
+          class AssertNpmPackageAvailable
+            include ConvenientService::Standard::Config
+
+            attr_reader :name
+
+            step :validate_name
+
+            step Services::AssertNodeAvailable
+
+            ##
+            # NOTE: `> /dev/null 2>&1` is used to hide output.
+            # https://unix.stackexchange.com/a/119650/394253
+            #
+            # NOTE: For `npm list` and its options docs, see
+            # https://docs.npmjs.com/cli/v7/commands/npm-ls
+            #
+            step Services::RunShell, in: {command: -> { "npm list #{name} --depth=0 > /dev/null 2>&1" }}
+
+            def initialize(name:)
+              @name = name
+            end
+
+            private
+
+            def validate_name
+              return failure(name: "Name is `nil`") if name.nil?
+              return failure(name: "Name is empty") if name.empty?
+
+              success
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Standard
+      module Gemfile
+        module Services
+          class AssertValidRubySyntax
+            include ConvenientService::Standard::Config
+
+            attr_reader :content
+
+            def initialize(content:)
+              @content = content
+            end
+
+            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/standard/gemfile/services/format.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Standard::Gemfile::Services::Format.result(path: "Gemfile")
+# result = ConvenientService::Examples::Standard::Gemfile::Services::Format.result(path: "spec/cli/gemfile/format/fixtures/Gemfile")
+#
+module ConvenientService
+  module Examples
+    module Standard
+      module Gemfile
+        module Services
+          class Format
+            include ConvenientService::Standard::Config
+
+            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
+
+            def initialize(path:)
+              @path = path
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Standard::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 Standard
+      module Gemfile
+        module Services
+          class FormatBody
+            include ConvenientService::Standard::Config
+
+            attr_reader :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 initialize(parsed_content:)
+              @parsed_content = parsed_content
+            end
+
+            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/standard/gemfile/services/format_gems_with_envs.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Standard::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 Standard
+      module Gemfile
+        module Services
+          class FormatGemsWithEnvs
+            BLOCK_END = "end"
+            BLOCK_DO = "do"
+            COMMA_WITH_SPACE = ", "
+            EMPTY_LINE = ""
+            ENTER = "\n"
+            GROUP = "group"
+            SPACE = " "
+            TAB = "  "
+
+            include ConvenientService::Standard::Config
+
+            attr_reader :parsed_content
+
+            def initialize(parsed_content:)
+              @parsed_content = parsed_content
+            end
+
+            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/standard/gemfile/services/format_gems_without_envs.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Standard::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 Standard
+      module Gemfile
+        module Services
+          class FormatGemsWithoutEnvs
+            EMPTY_LINE = ""
+            ENTER = "\n"
+
+            include ConvenientService::Standard::Config
+
+            attr_reader :parsed_content
+
+            def initialize(parsed_content:)
+              @parsed_content = parsed_content
+            end
+
+            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/standard/gemfile/services/format_header.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Standard::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 Standard
+      module Gemfile
+        module Services
+          class FormatHeader
+            FROZEN_STRING_LITERAL = "# frozen_string_literal: true"
+            EMPTY_LINE = ""
+            ENTER = "\n"
+
+            include ConvenientService::Standard::Config
+
+            attr_reader :parsed_content, :skip_frozen_string_literal
+
+            def initialize(parsed_content:, skip_frozen_string_literal: false)
+              @parsed_content = parsed_content
+              @skip_frozen_string_literal = skip_frozen_string_literal
+            end
+
+            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/standard/gemfile/services/parse_content.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Standard::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 Standard
+      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 ConvenientService::Standard::Config
+
+            attr_reader :content
+
+            step :validate_content
+            step Services::AssertValidRubySyntax, in: :content
+            step :result, in: :content, out: :parsed_content
+
+            def initialize(content:)
+              @content = content
+            end
+
+            def result
+              success(data: {parsed_content: parse_content})
+            end
+
+            private
+
+            def validate_content
+              return failure(content: "Content is `nil`") if content.nil?
+              return failure(content: "Content is empty") if content.empty?
+
+              success
+            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/standard/gemfile/services/print_shell_command.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+#   ConvenientService::Examples::Standard::Gemfile::Services::PrintShellCommand.result(text: "ls -a")
+#
+module ConvenientService
+  module Examples
+    module Standard
+      module Gemfile
+        module Services
+          class PrintShellCommand
+            include ConvenientService::Standard::Config
+
+            attr_reader :text, :out
+
+            def initialize(text:, out: $stdout)
+              @text = text
+              @out = out
+            end
+
+            def result
+              return failure(text: "Text is `nil`") if text.nil?
+              return failure(text: "Text is empty?") if text.empty?
+
+              out.puts
+
+              out.puts ::Paint["$ #{text}", :blue, :bold]
+
+              success
+            end
+          end
+        end
+      end
+    end
+  end
+end