convenient_service 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8ac75a9e4491384ec69ea4ddf3b7e9c4b9fc652dda2ec28236d0625d684605a2
+  data.tar.gz: a76819b97f23ef9d66185757832cb3be6c8b703cbfbe39fa8704be59c2af936d
+SHA512:
+  metadata.gz: 8da7165d9eee47a3f978db542c7eaf77b6b80d8a2c27d885ce032b8433bae881d2c7c345923c676c38b1b1d30ad5aef9231c962ae282d0392f7278d768e8d9d6
+  data.tar.gz: e64a25c3a7513b2c2cf028a11c6a1ee692d6ad01c31ebd053d32e44c980bfddab9e77c2a1d7ca5fa529e4458eea6dae026b3f01bb743159045d6874e02757a47

data/.dockerignore

@@ -0,0 +1 @@
+Gemfile.lock

data/.gem_release.yml

@@ -0,0 +1,23 @@
+quiet: false
+
+##
+# NOTE: `bump` options.
+# https://github.com/svenfuchs/gem-release#gem-bump
+#
+bump:
+  file: ./lib/convenient_service/version.rb
+  message: 🎉 🎉 🎉 Release %{version} 🎉 🎉 🎉
+  recurse: false
+  release: true
+  sign: true
+  tag: true
+
+##
+# NOTE: `release` options.
+# https://github.com/svenfuchs/gem-release#gem-release
+#
+release:
+  color: true
+  host: https://rubygems.org
+  recurse: false
+  key: convenient_service

data/.github/workflows/cd.yml

@@ -0,0 +1,54 @@
+##
+# CD using GitHub Actions.
+#
+# NOTE: GitHub Actions DSL.
+# - https://docs.github.com/en/actions/learn-github-actions/understanding-github-actions#understanding-the-workflow-file
+# - https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions
+#
+# NOTE: Ruby workflow example.
+# - https://github.com/ruby/setup-ruby#usage
+#
+# NOTE: How to set the working directory for the run directive (working-directory)?
+# - https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrunhttps://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+#
+# NOTE: How to deploy to GitHub Pages using GitHub Actions?
+# - https://github.com/marketplace/actions/github-pages-action
+#
+name: CD
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-20.04
+    name: Deploy
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.1
+          ##
+          # NOTE: Installs the latest compatible Bundler version, runs `bundle install` and caches installed gems.
+          # - https://github.com/ruby/setup-ruby#usage
+          # - https://github.com/ruby/setup-ruby#bundler
+          #
+          bundler-cache: true
+      ##
+      # NOTE: Installs Task (task runner).
+      # https://taskfile.dev/installation/#github-actions
+      # https://github.com/go-task/task
+      #
+      - name: Install Task (task runner)
+        uses: arduino/setup-task@v1
+      - name: Generate docs
+        working-directory: ./
+        run: task docs:generate
+      - name: Deploy docs to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs

data/.github/workflows/ci.yml

@@ -0,0 +1,190 @@
+##
+# CI using GitHub Actions.
+#
+# NOTE: GitHub Actions DSL.
+# - https://docs.github.com/en/actions/learn-github-actions/understanding-github-actions#understanding-the-workflow-file
+# - https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions
+#
+# NOTE: Ruby workflow example.
+# - https://github.com/ruby/setup-ruby#usage
+#
+# NOTE: Building and testing Ruby.
+# - https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-ruby
+#
+# NOTE: More examples.
+# - https://gist.github.com/geonizeli/57376c15f23feecdabf5ea213c3d7f41
+# - https://docs.knapsackpro.com/2019/how-to-run-rspec-on-github-actions-for-ruby-on-rails-app-using-parallel-jobs
+#
+# NOTE: Sharing data between jobs and post-workflow artifacts.
+# - https://docs.github.com/en/actions/learn-github-actions/essential-features-of-github-actions#sharing-data-between-jobs
+# - https://github.com/actions/upload-artifact
+# - https://github.com/actions/download-artifact
+#
+# NOTE: Virtual Environments.
+# - https://github.com/actions/virtual-environments
+#
+# NOTE: How to collect and upload coverage reports for Coveralls?
+# - https://github.com/marketplace/actions/coveralls-github-action#complete-parallel-job-example
+# - https://github.com/coverallsapp/github-action/issues/29
+# - https://github.com/coverallsapp/github-action/issues/29#issuecomment-704366557
+#
+# NOTE: What is the purpose of bundle-audit?
+# - https://github.com/rubysec/bundler-audit
+#
+# IMPORTANT: This workflow is heavily based on Shopify/packwerk workflow.
+# - https://github.com/Shopify/packwerk/blob/main/.github/workflows/ci.yml
+# - https://github.com/Shopify/packwerk/actions/runs/331834549/workflow
+#
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+
+jobs:
+  lint:
+    ##
+    # NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
+    # In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
+    # That is why the well-known Ubuntu is used.
+    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#choosing-github-hosted-runners
+    #
+    runs-on: ubuntu-20.04
+    name: Lint
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.1
+          ##
+          # NOTE: Installs the latest compatible Bundler version, runs `bundle install` and caches installed gems.
+          # - https://github.com/ruby/setup-ruby#usage
+          # - https://github.com/ruby/setup-ruby#bundler
+          #
+          bundler-cache: true
+      ##
+      # NOTE: Installs Task (task runner).
+      # https://taskfile.dev/installation/#github-actions
+      # https://github.com/go-task/task
+      #
+      - name: Install Task (task runner)
+        uses: arduino/setup-task@v1
+      - name: Run Rubocop
+        run: task rubocop
+      - name: Run Yard-Junk (docs linter)
+        run: task docs:lint
+
+  test:
+    needs:
+      - lint
+    ##
+    # NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
+    # In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
+    # That is why the well-known Ubuntu is used.
+    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#choosing-github-hosted-runners
+    #
+    runs-on: ubuntu-20.04
+    strategy:
+      matrix:
+        gemfile:
+          - Gemfile
+        ruby:
+          - 2.7
+          ##
+          # NOTE: 3.0 is wrapped by quotes in order to avoid misparsing it as integer.
+          # https://github.com/actions/runner/issues/849
+          #
+          - "3.0"
+          - 3.1
+    env:
+      BUNDLE_GEMFILE: ${{ matrix.gemfile }}
+
+    name: "Test Ruby `${{ matrix.ruby }}` with Gemfile `${{ matrix.gemfile }}`"
+    steps:
+      - uses: actions/checkout@v2
+      - name: "Set up Ruby `${{ matrix.ruby }}`"
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          ##
+          # NOTE: Installs the latest compatible Bundler version, runs `bundle install` and caches installed gems.
+          # - https://github.com/ruby/setup-ruby#usage
+          # - https://github.com/ruby/setup-ruby#bundler
+          #
+          bundler-cache: true
+      ##
+      # NOTE: Installs Task (task runner).
+      # https://taskfile.dev/installation/#github-actions
+      # https://github.com/go-task/task
+      #
+      - name: Install Task (task runner)
+        uses: arduino/setup-task@v1
+      - name: Run RSpec without appraisals
+        run: task rspec:standard
+      - name: Install dependencies for appraisals
+        run: task deps:install
+      - name: Run RSpec with Rails 5.2
+        run: task rspec:rails_5.2
+      - name: Run RSpec with Rails 6.0
+        run: task rspec:rails_6.0
+      - name: Run RSpec with Rails 6.1
+        run: task rspec:rails_6.1
+      - name: Run RSpec with Rails 7.0
+        run: task rspec:rails_7.0
+      - name: Run RSpec with Dry
+        run: task rspec:dry
+      ##
+      # NOTE: `lcov-result-merger` is written in JS.
+      #
+      - name: Set up Node.js 16.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16.x
+      ##
+      # NOTE: `lcov-result-merger` docs.
+      # https://github.com/mweibel/lcov-result-merger
+      #
+      # NOTE: `npx --yes` option.
+      # https://stackoverflow.com/questions/70742968/automatically-accept-installing-npx-package
+      #
+      # NOTE: `lcov-result-merger` uses `vinyl-fs` for globs which in turn uses `node-glob`.
+      # - https://github.com/mweibel/lcov-result-merger/blob/v3.3.0/bin/lcov-result-merger.js#L38
+      # - https://github.com/gulpjs/vinyl-fs#srcglobs-options
+      # - https://github.com/isaacs/node-glob#glob-primer
+      #
+      # NOTE: Append `&& cat coverage/lcov.info` to debug.
+      #
+      # IMPORTANT: 'coverage/**/lcov.info' single quotes are mandatory.
+      #
+      - name: Merge coverage reports into single file
+        run: task coverage:lcov:merge
+      - name: Configure coverage reports for Coveralls
+        uses: coverallsapp/github-action@master
+        with:
+          github-token: ${{ secrets.github_token }}
+          flag-name: run-${{ matrix.ruby }}-${{ matrix.gemfile }}
+          parallel: true
+          path-to-lcov: "./coverage/lcov.info"
+
+  coverage:
+    needs:
+      - test
+    ##
+    # NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
+    # In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
+    # That is why the well-known Ubuntu is used.
+    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#choosing-github-hosted-runners
+    #
+    runs-on: ubuntu-20.04
+    name: Gather coverage
+    steps:
+      - name: Upload coverage reports to Coveralls
+        uses: coverallsapp/github-action@master
+        with:
+          github-token: ${{ secrets.github_token }}
+          parallel-finished: true

data/.gitignore

@@ -0,0 +1,34 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/*
+!/coverage/.gitkeep
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+/.rspec_status
+
+# Hide `byebug` history
+/.byebug_history
+
+# Ignore `Gemfile.lock`
+/Gemfile.lock
+
+##
+# NOTE: Ignores `Gemfile` amd `Gemfile.lock` used in docker containers.
+#
+# NOTE: `Gemfile*` matches all files that start with Gemfile in any nesting.
+# NOTE: `/Gemfile*` matches all files that start with Gemfile only from root folder.
+#
+/Gemfile*
+
+##
+# NOTE: Ignores `.DS_Store` in any nesting.
+#
+.DS_Store
+
+# Ignore docs
+/docs/*

data/.inch.yml

@@ -0,0 +1,7 @@
+##
+# Configures Inch (inch gives you hints where to improve your docs).
+# https://github.com/rrrene/inch#configuration
+#
+files:
+  included:
+    - lib/**/*.rb

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,45 @@
+inherit_from:
+  - .rubocop_rspec.yml
+
+##
+# Standard based Rubocop config.
+# - https://github.com/testdouble/standard
+# - https://github.com/testdouble/standard#usage-via-rubocop
+# - https://evilmartians.com/chronicles/rubocoping-with-legacy-bring-your-ruby-code-up-to-standard
+#
+require:
+  ##
+  # Rubocop for RSpec files.
+  # https://github.com/rubocop/rubocop-rspec#usage
+  #
+  - rubocop-rspec
+  ##
+  # NOTE: `rubocop-performance` is automatically bundled with Standard.
+  #
+  - rubocop-performance
+  ##
+  # NOTE: Custom Standard cop that should be loaded before `config/base.yml`.
+  #
+  - standard/cop/block_single_line_braces
+
+inherit_gem:
+  standard: config/base.yml
+
+AllCops:
+  ##
+  # https://github.com/testdouble/standard#how-do-i-specify-a-ruby-version-what-is-supported
+  #
+  TargetRubyVersion: 2.7
+
+  Exclude:
+    ##
+    # NOTE: Excludes vendor from linting. Needed by GitHub Actions.
+    # - https://github.com/rubocop/rubocop/issues/9832
+    # - https://github.com/rubocop/rubocop/issues/9832#issuecomment-873398952
+    #
+    - vendor/**/*
+
+    ##
+    # NOTE: Excludes dependencies from linting.
+    #
+    - lib/convenient_service/dependencies/**/*

data/.rubocop_rspec.yml

@@ -0,0 +1,58 @@
+##
+# Standard based Rubocop config suggested by Evil Martians.
+# - https://evilmartians.com/chronicles/rubocoping-with-legacy-bring-your-ruby-code-up-to-standard
+# - https://github.com/testdouble/standard
+#
+# Copied without any modifications from:
+# https://gist.github.com/palkan/623c0816b05ed246bfe0cb406050990a
+#
+require:
+  - rubocop-rspec
+
+RSpec/Focus:
+  Enabled: true
+
+RSpec/EmptyExampleGroup:
+  Enabled: true
+
+RSpec/EmptyLineAfterExampleGroup:
+  Enabled: true
+
+RSpec/EmptyLineAfterFinalLet:
+  Enabled: true
+
+RSpec/EmptyLineAfterHook:
+  Enabled: true
+
+RSpec/EmptyLineAfterSubject:
+  Enabled: true
+
+RSpec/HookArgument:
+  Enabled: true
+
+RSpec/HooksBeforeExamples:
+  Enabled: true
+
+RSpec/ImplicitExpect:
+  Enabled: true
+
+RSpec/IteratedExpectation:
+  Enabled: true
+
+RSpec/LetBeforeExamples:
+  Enabled: true
+
+RSpec/MissingExampleGroupArgument:
+  Enabled: true
+
+RSpec/ReceiveCounts:
+  Enabled: true
+
+RSpec/Capybara/CurrentPathExpectation:
+  Enabled: true
+
+RSpec/FactoryBot/AttributeDefinedStatically:
+  Enabled: true
+
+RSpec/FactoryBot/CreateList:
+  Enabled: true

data/.ruby-version

@@ -0,0 +1 @@
+3.1.0

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.1.0

data/.yardopts

@@ -0,0 +1,13 @@
+##
+# NOTE: `.yardopts` docs.
+# https://rubydoc.info/gems/yard/YARD/CLI/Yardoc
+#
+# NOTE: `@internal` tag.
+# https://github.com/lsegal/yard/issues/484#issuecomment-442596174
+#
+--markup markdown
+--markup-provider commonmarker
+--output-dir docs
+--tag internal --hide-tag internal
+'lib/**/*.rb' -
+README.md

data/Appraisals

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+##
+# TODO: GitHub wiki for `shouda-matchers`.
+#
+# IMPORTANT: `shoulda-matchers` loads active support core extensions.
+# https://guides.rubyonrails.org/active_support_core_extensions.html
+# https://apidock.com/rails/v6.1.3.1/Hash/symbolize_keys
+#
+# This can lead to the false positive tests. For example:
+#
+#   {"a" => 1}.symbolize_keys
+#   # => {:a=>1}
+#   # Works well with Active Support
+#
+#   {"a" => 1}.symbolize_keys
+#   # undefined method `symbolize_keys` for {"a"=>1}:Hash (NoMethodError)
+#   # Raises for Ruby 3.1 and lower.
+#
+# To debug who actually requires Active Support, use the following snippet:
+#
+#   # env.rb (or any other file that is loaded as early as it is possible)
+#   def require(path)
+#     if path.include?("active_support")
+#       print "require \"#{path}\" from \"#{caller.first.gsub(ENV['HOME'], "~")}\"\n\n"
+#     end
+#
+#     super
+#   end
+#
+appraise "rails_5.2" do
+  gem "activemodel", "~> 5.2.0"
+
+  ##
+  # NOTE: Waits for `should-matchers` full support.
+  #
+  # gem "shoulda-matchers", "~> 5.0.0"
+end
+
+appraise "rails_6.0" do
+  gem "activemodel", "~> 6.0.0"
+
+  ##
+  # NOTE: Waits for `should-matchers` full support.
+  #
+  # gem "shoulda-matchers", "~> 5.0.0"
+end
+
+appraise "rails_6.1" do
+  gem "activemodel", "~> 6.1.0"
+
+  ##
+  # NOTE: Waits for `should-matchers` full support.
+  #
+  # gem "shoulda-matchers", "~> 5.0.0"
+end
+
+appraise "rails_7.0" do
+  gem "activemodel", "~> 7.0.0"
+
+  ##
+  # NOTE: Waits for `should-matchers` full support.
+  #
+  # gem "shoulda-matchers", "~> 5.0.0"
+end
+
+appraise "dry" do
+  gem "dry-initializer", "~> 3.0.0"
+
+  gem "dry-validation", "~> 1.5.0"
+
+  ##
+  # NOTE: Restricts temporarily `dry-configurable` version (dependency of `dry-validation`) until the following issue is resolved:
+  # https://github.com/dry-rb/dry-configurable/issues/146
+  #
+  gem "dry-configurable", "~> 0.15.0"
+
+  ##
+  # NOTE: Restricts temporarily `dry-schema` version (dependency of `dry-validation`) until the following issue is resolved:
+  # https://github.com/dry-rb/dry-schema/issues/434
+  #
+  gem "dry-schema", "~> 1.10.0"
+
+  ##
+  # NOTE: Restricts temporarily `dry-core` version (dependency of `dry-validation`) until the following issue is resolved:
+  # https://github.com/dry-rb/dry-core/issues/73#issuecomment-1279774309
+  #
+  gem "dry-core", "~> 0.8.0"
+end
+
+##
+# NOTE: A combination of all the highest versions of gems. Just for quick hacking in `task console:all`.
+# IMPORTANT: Should not be enforced in CI, since integrity checks between external gems are not the goal of this library (a least for now).
+#
+appraise "all" do
+  gem "activemodel", "~> 7.0.0"
+
+  gem "dry-initializer", "~> 3.0.0"
+
+  gem "dry-validation", "~> 1.5.0"
+
+  ##
+  # NOTE: Restricts temporarily `dry-configurable` version (dependency of `dry-validation`) until the following issue is resolved:
+  # https://github.com/dry-rb/dry-configurable/issues/146
+  #
+  gem "dry-configurable", "~> 0.15.0"
+
+  ##
+  # NOTE: Restricts temporarily `dry-schema` version (dependency of `dry-validation`) until the following issue is resolved:
+  # https://github.com/dry-rb/dry-schema/issues/434
+  #
+  gem "dry-schema", "~> 1.10.0"
+
+  ##
+  # NOTE: Restricts temporarily `dry-core` version (dependency of `dry-validation`) until the following issue is resolved:
+  # https://github.com/dry-rb/dry-core/issues/73#issuecomment-1279774309
+  #
+  gem "dry-core", "~> 0.8.0"
+
+  ##
+  # NOTE: Waits for `should-matchers` full support.
+  #
+  # gem "shoulda-matchers", "~> 5.0.0"
+end

data/CHANGELOG.md

@@ -0,0 +1 @@
+## 0.1.0

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in convenient_service.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Marian Kostyk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,55 @@
+<!-- stand_with_ukraine:start -->
+<h1 align="center">
+  #StandWithUkraine
+</h1>
+
+[![SWUbanner](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner-direct.svg)](https://vshymanskyy.github.io/StandWithUkraine)
+<!-- stand_with_ukraine:end -->
+
+<!-- header:start -->
+<!-- TODO: Remove html to display in YARD with commonmark -->
+<h1 align="center">
+  Convenient Service
+</h1>
+<!-- header:end -->
+
+<!-- badges:start -->
+[![Gem Version](https://badge.fury.io/rb/convenient_service.svg)](https://rubygems.org/gems/convenient_service) [![GitHub Actions CI](https://github.com/marian13/convenient_service/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/marian13/convenient_service/actions/workflows/ci.yml) [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard) [![Coverage Status](https://coveralls.io/repos/github/marian13/convenient_service/badge.svg)](https://coveralls.io/github/marian13/convenient_service?branch=main) [![inline docs](http://inch-ci.org/github/marian13/convenient_service.svg?branch=main)](http://inch-ci.org/github/marian13/convenient_service)
+[![Convenient Service on stackoverflow](https://img.shields.io/badge/stackoverflow-community-orange.svg?logo=stackoverflow)](https://stackoverflow.com/tags/convenient-service)
+[![Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/user?u=31435716&fan_landing=true)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<!-- badges:end -->
+
+<!-- logo:start -->
+<!-- TODO: Remove html to display in YARD with commonmark -->
+<p align="center">
+  <img src="https://raw.githubusercontent.com/marian13/convenient_service/main/logo.png" width="300">
+</p>
+<!-- logo:end -->
+
+<!-- general_description:start -->
+Yet another approach to revisit the service object pattern, but this time focusing on the unique, opinionated features.
+
+\* Logo is downloaded from [CuteWallpaper.org](https://cutewallpaper.org/24/cartoon-diamond-png/2703010921.html). It will be replaced later.
+<!-- general_description:end -->
+
+<!-- warning:start -->
+## WARNING ❗❗❗
+
+This library is under heavy development. Public API may be subject to change. The first major release is still to come. Use the current version at your own risk. Ruby 2.7+. Thanks.
+<!-- features:end -->
+<!-- warning:end -->
+
+<!-- documentation:start -->
+## Documentation
+
+- Check out [Convenient Service Official User Docs](https://marian13.github.io/convenient_service_docs/) for installation, requirements, and usage guides.
+
+- Have a look at [Convenient Service Development Wiki](https://github.com/marian13/convenient_service/wiki) if you consider making a contribution.
+
+---
+<!-- documentation:end -->
+
+<!-- author:start -->
+Copyright (c) 2022 [Marian Kostyk](http://mariankostyk.com).
+<!-- author:end -->