From Fedora Project Wiki
(→‎Members: Update link to FAS)
 
(107 intermediate revisions by 58 users not shown)
Line 1: Line 1:
= Ruby Special Interest Group =
{{autolang|base=yes}}
{|width="100%" align="center"
{|width="100%" align="center"
|-
|-
Line 10: Line 10:
== State of Affairs ==
== State of Affairs ==


Packaging Ruby libraries and applications for Fedora is still in its infancy, and only very few RPM's are available. We hope that this situation will improve ''dramatically'' over the next few months; that means that you, dear reader, can become a hero by packaging your favorite piece of Ruby code as an RPM and [http://fedoraproject.org/wiki/PackageMaintainers/Join submitting it to Fedora] .
We are always happy to get more Ruby packages into Fedora. That means that you, dear reader, can become a hero by packaging your favorite piece of Ruby code as an RPM and [https://docs.fedoraproject.org/en-US/package-maintainers/Joining_the_Package_Maintainers/ submitting it to Fedora].
 
* We are closely following Ruby MRI development. Once a new Ruby release gets in the wild it is packaged for Rawhide.
* All Ruby implementations should be able to use gem provided by the single package, but we are not yet there.


=== Creating RPM's ===
=== Creating RPM's ===
The ''guidelines'' for building Ruby packages can be found on a [[Packaging/Rubyseparate page]] .
The ''guidelines'' for building Ruby packages can be found on a [https://docs.fedoraproject.org/en-US/packaging-guidelines/Ruby/ separate page].


[[OliverAndrich|  Oliver Andrich]]  has created a specfile template for Ruby packages that is included in rpmdevtools 1.5 and later. Please start with this template when packaging Ruby code for Fedora.
[[OliverAndrich|  Oliver Andrich]]  has created a specfile template for Ruby packages that is included in rpmdevtools 1.5 and later. Please start with this template when packaging Ruby code for Fedora.
Line 20: Line 23:
Ruby has its own packaging format, gem, meant to be a cross-platform way to distribute Ruby software. Gems carry much of the metadata that RPM's carry, but not all of it, and because of their cross-platform nature violate the LSB. Gems that contain shared libraries also do not play nicely with multilib.
Ruby has its own packaging format, gem, meant to be a cross-platform way to distribute Ruby software. Gems carry much of the metadata that RPM's carry, but not all of it, and because of their cross-platform nature violate the LSB. Gems that contain shared libraries also do not play nicely with multilib.


[http://rubyforge.org/projects/gem2rpm/ gem2rpm] is now available as <code>rubygem-gem2rpm</code>, and obsoletes <code>gem2spec</code>.
Please use the {{package|rubygem-gem2rpm}} utility for all new gem packages.
 
=== Bundler and RPM ===
 
Fedora doesn't allow vendorizing packages without special exception, but this does not mean bundler based applications cannot be used with the Fedora stack.
 
The [https://github.com/bundlerext/bundler_ext bundler_ext] gem loads the system-installed versions of packages specified in a Ruby application Gemfile, providing a simple mechanism to switch between custom ruby stacks and distro-supported stacks.
 
The [https://github.com/ManageIQ/polisher polisher] gem implements many downstream / post-publishing operations and querying mechanisms. Developers and end users can utilize these to check the state of their Ruby gems and applications and move them along custom workflows.
 
== Useful tools ==
 
* [https://github.com/lutter/gem2rpm gem2rpm] Generate an rpm from a rubygem.
* [https://github.com/daviddavis/pkgwat pkgwat] Checking that your project's gems are available in Fedora/EPEL repos.
* [https://github.com/strzibny/gem-compare gem-compare] A RubyGems plugin that compares versions of the given gem.
* [https://github.com/ManageIQ/polisher polisher] A Ruby module and set of utilities aimed to assist the post-publishing packaging process for Ruby gems and applications.
* [https://github.com/bundlerext/bundler_ext bundler_ext] Simple library leveraging the Bundler Gemfile DSL to load gems already on the system and managed by the systems package manager (like [[dnf|DNF]]/[[yum|YUM]]/apt).


== References ==
== References ==
[http://www.ruby-lang.org/ Ruby] <BR>
[http://www.ruby-lang.org/ Ruby] <BR>
[http://www.ruby-doc.org/ Ruby-Doc.org] <BR>
[http://www.ruby-doc.org/ Ruby-Doc.org] <BR>
[http://rubyforge.org/ RubyForge] <BR>
[http://rubygems.org/ RubyGems.org] <BR>
[https://github.com/fedora-ruby/ fedora-ruby] repository at GitHub <BR>
 
== Mailing list ==
{{fplist|ruby-sig}} mailing list
 
==IRC Channel==
{{fpchat|#fedora-ruby}} on Libera.Chat


== Currently Open Ruby Package Review Bugs==
== Currently Open Ruby Package Review Bugs==
The Ruby SIG also likes to get more Ruby packages into Fedora. The following are open review requests for ruby packages.
The Ruby SIG also likes to get more Ruby packages into Fedora. [https://bugzilla.redhat.com/buglist.cgi?list_id=580018&short_desc=rubygem-&query_based_on=Rubygems%20review&query_format=advanced&bug_status=NEW&bug_status=ASSIGNED&short_desc_type=allwordssubstr&component=Package%20Review&product=Fedora&known_name=Rubygems%20review This] is the list of opened review requests for ruby packages.
* [https://bugzilla.redhat.com/show_bug.cgi?id=226381 Merge Review: Ruby]
 
* [https://bugzilla.redhat.com/show_bug.cgi?id=437574 Review Request: ruby-pg]
==Meetings==
* [https://bugzilla.redhat.com/show_bug.cgi?id=445208 Review Request: rubygem-rapt]
There are not too many chances to meet and discuss Ruby topics related to Fedora. But you can always hold an IRC meeting.
* [https://bugzilla.redhat.com/show_bug.cgi?id=446563 Review Request: rubygem-rspec]
 
== Join the Ruby SIG ==
We are always glad for new contributors. If you are interested in joining the SIG there are a few steps to do first:
 
=== Join the mailing list ===
To join the mailing list, you must subscribe to {{fplist|ruby-sig}} mailing list. Important news, discussions, and announcements take place there.
 
=== Send a self-introduction  ===
Send a self-introduction mail to [mailto:ruby-sig@lists.fedoraproject.org Ruby SIG mailing list] to introduce and tell us a bit about yourself. Tell us why are you interested in contributing and what area do you want to contribute to. Also you can share with us what projects are you working on and your role there. Additionally, it is the perfect place to ask what do you need help with to get started, maybe something left you confused? Just ask.
 
=== Join #fedora-ruby channel on IRC ===
Next step would be joining the {{fpchat|#fedora-ruby}} channel on the Libera.Chat [[IRC]] network.


== Members ==
=== Create an FAS Account ===
To be able to contribute to Fedora you will need a [[Account_System | FAS account]] and sign the [[Legal:Fedora_Project_Contributor_Agreement|Fedora Project Contributor Agreement]] if you have not already.


''If you are interested in joining the SIG, just add yourself to this list''
=== Members ===
Members of Ruby SIG are tracked by [https://accounts.fedoraproject.org/group/ruby-sig/ ruby-sig FAS group]. The minimal requirement to get sponsored to the group is to go through all the steps above. Members of the group are awarded [https://badges.fedoraproject.org/badge/ruby-sig-member this nice small badge].


# [[DavidLutterkort| David Lutterkort]]
The old list of members, prior we used [https://accounts.fedoraproject.org/group/ruby-sig/ ruby-sig FAS group], can be found in [https://fedoraproject.org/w/index.php?title=SIGs/Ruby&diff=543749&oldid=543748 wiki history]
# [[OliverAndrich| Oliver Andrich]]
# [[AkiraTagoh| Akira TAGOH]]
# [[JeremyHinegardner|  Jeremy Hinegardner]]
# [[MichaelStahnke|  Michael Stahnke]]
# [[ConradMeyer|  Conrad Meyer]]
# [[User:Mikedanko|  Mike Danko]]
# [[User:Kanarip | Jeroen van Meeuwen]]


[[Category:SIGs]]
[[Category:Language-specific SIGs]]
[[Category:Language-specific SIGs]]
[[Category:Ruby]]
[[Category:Fedora special-interest groups|Ruby SIG]]

Latest revision as of 09:20, 16 February 2023

Ruby SIG
Ruby Special Interest Group

A SIG for people who are interested in improving the state of Ruby in Fedora. This includes packaging Ruby libraries and applications, setting and improving standards for packaging them as RPM's and maintaining Ruby packages for Fedora.

State of Affairs

We are always happy to get more Ruby packages into Fedora. That means that you, dear reader, can become a hero by packaging your favorite piece of Ruby code as an RPM and submitting it to Fedora.

  • We are closely following Ruby MRI development. Once a new Ruby release gets in the wild it is packaged for Rawhide.
  • All Ruby implementations should be able to use gem provided by the single package, but we are not yet there.

Creating RPM's

The guidelines for building Ruby packages can be found on a separate page.

Oliver Andrich has created a specfile template for Ruby packages that is included in rpmdevtools 1.5 and later. Please start with this template when packaging Ruby code for Fedora.

Gems and RPM

Ruby has its own packaging format, gem, meant to be a cross-platform way to distribute Ruby software. Gems carry much of the metadata that RPM's carry, but not all of it, and because of their cross-platform nature violate the LSB. Gems that contain shared libraries also do not play nicely with multilib.

Please use the rubygem-gem2rpm utility for all new gem packages.

Bundler and RPM

Fedora doesn't allow vendorizing packages without special exception, but this does not mean bundler based applications cannot be used with the Fedora stack.

The bundler_ext gem loads the system-installed versions of packages specified in a Ruby application Gemfile, providing a simple mechanism to switch between custom ruby stacks and distro-supported stacks.

The polisher gem implements many downstream / post-publishing operations and querying mechanisms. Developers and end users can utilize these to check the state of their Ruby gems and applications and move them along custom workflows.

Useful tools

  • gem2rpm Generate an rpm from a rubygem.
  • pkgwat Checking that your project's gems are available in Fedora/EPEL repos.
  • gem-compare A RubyGems plugin that compares versions of the given gem.
  • polisher A Ruby module and set of utilities aimed to assist the post-publishing packaging process for Ruby gems and applications.
  • bundler_ext Simple library leveraging the Bundler Gemfile DSL to load gems already on the system and managed by the systems package manager (like DNF/YUM/apt).

References

Ruby
Ruby-Doc.org
RubyGems.org
fedora-ruby repository at GitHub

Mailing list

ruby-sig mailing list

IRC Channel

#fedora-ruby[?] on Libera.Chat

Currently Open Ruby Package Review Bugs

The Ruby SIG also likes to get more Ruby packages into Fedora. This is the list of opened review requests for ruby packages.

Meetings

There are not too many chances to meet and discuss Ruby topics related to Fedora. But you can always hold an IRC meeting.

Join the Ruby SIG

We are always glad for new contributors. If you are interested in joining the SIG there are a few steps to do first:

Join the mailing list

To join the mailing list, you must subscribe to ruby-sig mailing list. Important news, discussions, and announcements take place there.

Send a self-introduction

Send a self-introduction mail to Ruby SIG mailing list to introduce and tell us a bit about yourself. Tell us why are you interested in contributing and what area do you want to contribute to. Also you can share with us what projects are you working on and your role there. Additionally, it is the perfect place to ask what do you need help with to get started, maybe something left you confused? Just ask.

Join #fedora-ruby channel on IRC

Next step would be joining the #fedora-ruby[?] channel on the Libera.Chat IRC network.

Create an FAS Account

To be able to contribute to Fedora you will need a FAS account and sign the Fedora Project Contributor Agreement if you have not already.

Members

Members of Ruby SIG are tracked by ruby-sig FAS group. The minimal requirement to get sponsored to the group is to go through all the steps above. Members of the group are awarded this nice small badge.

The old list of members, prior we used ruby-sig FAS group, can be found in wiki history