Pautas de empaquetamiento de Ruby

Most of the pure Ruby packages will work on all Ruby interpreters. There are however cases when the packages use interpreter-specific functions (like fork()) and won’t run on other interpreters (JRuby). In this case, the package SHOULD require that interpreter. For example, a package that uses fork SHOULD explicitly specify Requires: ruby. In case of such package, packager SHOULD file a bug to ask upstream to provide support for other interpreter(s). This SHOULD be documented in specfile.

En Fedora, /usr/bin/ruby está implementado por medio de Rubypick. Rubypick es una herramienta similar a RVM o rbenv. Permite elegir intérprete para ejecutar guion de Ruby. Rubypick enruta cualquiera ejecutado por medio de /usr/bin/ruby a /usr/bin/ruby-mri o /usr/bin/jruby. Por defecto, ejecuta MRI (Implementación Ruby de Matz), pero el usuario puede especificar explícitamente el intérprete utilizando _mri_ o _jruby_ como un primer parámetro. Por ejemplo:

Al utilizar la variable de entorno RUBYPICK puede logar el mismo resultado. La variable del entorno puede ser utilizada para establecer un intérprete como el predeterminado global:

Ejecutables Ruby que son conocidos para ejecutar solo en una implementación Ruby UTILIZARÍAN que implementación específica en su shebang (#!/usr/bin/ruby-mri o #!/usr/bin/jruby) para asegurar que ejecutan utilizando que implementación. Todos otros códigos UTILIZARÁN #!/usr/bin/ruby.

Es posible que hayas notado que la tabla anterior tiene diferentes directorios para bibliotecas que no son gem en diferentes intérpretes de Ruby, pero solo un único conjunto de directorios para bibliotecas rubygem. Esto se debe a que el código escrito para un intérprete de Ruby a menudo se ejecutará en todos los intérpretes de Ruby que incluye Fedora (Ruby, JRuby, etc.). Sin embargo, algunos códigos utilizan métodos que no están disponibles en todos los intérpretes (consulte [Compatibilidad entre diferentes intérpretes]). Rubygems tiene la capacidad de incluir diferentes versiones del código en la misma gema, de modo que esta pueda ejecutarse en todas las versiones del intérprete, por lo que solo necesitamos tener un directorio común para rubygems que puedan utilizar todos los intérpretes.

The standard ruby %{vendorlib} directories lack this facility. For this reason, non-gem libraries need to be placed in per-interpreter directories and MUST have a separate subpackage (or package depending on upstream) for each interpreter that they support.

RubyGems son el formato de empaquetado propio de Ruby. Las gemas contienen muchos de los mismos metadatos que necesitan los RPM, lo que permite una interoperabilidad bastante fluida entre RPM y Gems. Esta directriz garantiza que las gemas se empaqueten como RPM de manera que dichos RPM encajen perfectamente con el resto de la distribución y permite al usuario final satisfacer las dependencias de una gema instalando la Gem empaquetada en RPM adecuada.

Both RPM’s and Gems use similar terminology; there are specfiles, package names, dependencies, etc. for both. To keep confusion to a minimum, terms relating to Gem concepts will be explicitly referred to with the word "Gem" prefixed, e.g., "Gem specification" (.gemspec). An unqualified "package" in the following always means an RPM.

Los paquetes Ruby Sin Gem DEBEN requerir el paquete ruby-devel en tiempo de compilación con un BuildRequires: ruby-devel, y PUEDE indicar la versión de ruby mínima necesaria para compilar.

Para ejecutar con implementaciones diferentes de Ruby tales como JRuby, añada BuildRequires: jruby Después utilice intercambiador de intérprete de Rubypick:

Si tu paquete ejecuta pruebas unitarias para ruby-mri y está destinado a ejecutarse en intérpretes alternativos, entonces también debe ejecutar las pruebas unitarias en todos los intérpretes alternativos. Este es el único método que tenemos para comprobar la compatibilidad del código en cada intérprete. Se aplican las mismas reglas: puedes omitir esto si las bibliotecas que necesitas no están disponibles para un intérprete alternativo específico, pero DEBES incluir un comentario para explicarlo.

La comunidad de Ruby admite muchas pruebas de marcos de trabajo. Las secciones siguientes demuestran como varias de las pruebas de ejecución utilizando las más comunes de ellas.

A veces tiene que obtener las pruebas separadamente desde el paquete de gem de versión superior. Como un ejemplo deja proporcionar que está empaquetando rubygem-delorean, versión 1.2.0, lo cual es hospedado en Github. Las pruebas no incluyen en el mismo Gem, tal que necesite obtenerlas y ajustar el archivo specfile correspondientemente: