add V2 Ruby plugin

snapcraft/plugins/v2/__init__.py

@@ -34,4 +34,5 @@
     from .npm import NpmPlugin  # noqa: F401
     from .python import PythonPlugin  # noqa: F401
     from .qmake import QMakePlugin  # noqa: F401
+    from .ruby import RubyPlugin  # noqa: F401
     from .rust import RustPlugin  # noqa: F401

snapcraft/plugins/v2/ruby.py

@@ -0,0 +1,160 @@
+# -*- Mode:Python; indent-tabs-mode:nil; tab-width:4 -*-
+#
+# Copyright (C) 2021 Patrik Wenger <paddor@gmail.com>
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+"""The ruby plugin is useful for ruby based parts.
+It uses ruby-install to install Ruby and can use bundler to install
+dependencies from a `Gemfile` found in the sources.
+
+Additionally, this plugin uses the following plugin-specific keywords:
+    - ruby-version:
+      (string)
+      The version of ruby you want this snap to run. (e.g. '3.0' or '2.7.2')
+    - ruby-flavor:
+      (string)
+      Other flavors of ruby supported by ruby-install (e.g. 'jruby', ...)
+    - ruby-gems:
+      (list)
+      A list of gems to install.
+    - ruby-use-bundler
+      (boolean)
+      Use bundler to install gems from a Gemfile (defaults 'false').
+    - ruby-prefix:
+      (string)
+      Prefix directory for installation (defaults '/usr').
+    - ruby-shared:
+      (boolean)
+      Build ruby as a shared library (defaults 'false').
+    - ruby-use-jemalloc:
+      (boolean)
+      Build ruby with libjemalloc (defaults 'false').
+    - ruby-configure-options:
+      (array of strings)
+      Additional configure options to use when configuring ruby.
+"""
+
+import os
+import re
+import logging
+
+from typing import Any, Dict, List, Set
+from snapcraft.plugins.v2 import PluginV2
+
+
+class RubyPlugin(PluginV2):
+    @classmethod
+    def get_schema(cls) -> Dict[str, Any]:
+        return {
+            "$schema": "http://json-schema.org/draft-04/schema#",
+            "type": "object",
+            "additionalProperties": False,
+            "properties": {
+                "ruby-flavor": {
+                    "type": "string",
+                    "default": "ruby",
+                },
+                "ruby-version": {
+                    "type": "string",
+                    "default": "3.0",
+                    "pattern": r"^\d+\.\d+(\.\d+)?$",
+                },
+                "ruby-use-bundler": {
+                    "type": "boolean",
+                    "default": False,
+                },
+                "ruby-prefix": {
+                    "type": "string",
+                    "default": "/usr",
+                },
+                "ruby-use-jemalloc": {
+                    "type": "boolean",
+                    "default": False,
+                },
+                "ruby-shared": {
+                    "type": "boolean",
+                    "default": False,
+                },
+                "ruby-configure-options": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "default": [],
+                },
+                "ruby-gems": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "default": [],
+                },
+            },
+        }
+
+    def get_build_snaps(self) -> Set[str]:
+        return set()
+
+    def get_build_packages(self) -> Set[str]:
+        packages = {"curl", "jq"}
+
+        if self.options.ruby_use_jemalloc:
+            packages.add("libjemalloc-dev")
+
+        return packages
+
+    def get_build_environment(self) -> Dict[str, str]:
+        env = {
+            "PATH": "${{SNAPCRAFT_PART_INSTALL}}{}/bin:${PATH}".format(self.options.ruby_prefix),
+        }
+
+        if self.options.ruby_shared:
+            # for finding ruby.so when running `gem` or `bundle`
+            env["LD_LIBRARY_PATH"] = "${{SNAPCRAFT_PART_INSTALL}}{}/lib${{LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}}".format(
+                    self.options.ruby_prefix)
+
+        return env
+
+    def _configure_opts(self) -> List[str]:
+        configure_opts = [
+            "--without-baseruby",
+            "--enable-load-relative",
+            "--disable-install-doc",
+        ] + self.options.ruby_configure_options
+
+        if self.options.ruby_shared:
+            configure_opts.append("--enable-shared")
+        if self.options.ruby_use_jemalloc:
+            configure_opts.append("--with-jemalloc")
+
+        return configure_opts
+
+    def get_build_commands(self) -> List[str]:
+        commands = []
+        commands.append("ruby_install_url=$(curl -L --proto '=https' --tlsv1.2 'https://api.github.com/repos/postmodern/ruby-install/tags' | jq -r '.[0].tarball_url')")
+        commands.append("curl -L --proto '=https' --tlsv1.2 $ruby_install_url | tar xz")
+        commands.append("postmodern-ruby-install-*/bin/ruby-install -i ${{SNAPCRAFT_PART_INSTALL}}{} --package-manager apt -j${{SNAPCRAFT_PARALLEL_BUILD_COUNT}} {}-{} -- {}".format(
+            self.options.ruby_prefix,
+            self.options.ruby_flavor,
+            self.options.ruby_version,
+            ' '.join(self._configure_opts())))
+
+        # NOTE: Update bundler. Avoid conflicts/prompts about replacing bundler
+        #       executables by removing them first.
+        commands.append("rm -f ${{SNAPCRAFT_PART_INSTALL}}{}/bin/{{bundle,bundler}}".format(self.options.ruby_prefix))
+        commands.append("gem install --env-shebang --no-document bundler")
+
+        if self.options.ruby_use_bundler:
+            commands.append("bundle")
+
+        if self.options.ruby_gems:
+            commands.append("gem install --env-shebang --no-document {}".format(' '.join(self.options.ruby_gems)))
+
+        return commands