beaker-module_install_helper 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a1a5d53299f555a39466b8de21cb35006475c29c
+  data.tar.gz: c636a1beb7956aee0a2f169e176d683e6c3d1f2d
+SHA512:
+  metadata.gz: e6cbf3cc5e7c67da196b3e65ca8076f1b71c5cee693eb7c4b2f05a499382d7262e3f68f4b3302ff1e45d7ba22117fca86eb570bfdb80b8417ef430c0d69727dd
+  data.tar.gz: a0b526e752430e0dbf37d2c92947a751781b0af24c830110488a4b54a0afc491808e3a79fef3e439a50b9fdef65483894cf51052114502e09326ade80fb5a12d

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.idea/

data/.rubocop.yml

@@ -0,0 +1,31 @@
+require: rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 2.1
+
+RSpec/AnyInstance:
+  Enabled: false
+
+RSpec/DescribeClass:
+  Enabled: false
+
+RSpec/NestedGroups:
+  Enabled: false
+
+Lint/AmbiguousRegexpLiteral:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Bundler/DuplicatedGem:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 100
+
+Metrics/MethodLength:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+script:
+  - bundle exec rake lint spec
+notifications:
+  email: false
+rvm:
+  - 2.1.6
+  - 2.3.0

data/CONTRIBUTING.md

@@ -0,0 +1,5 @@
+### Contributing and adding features
+
+This package is currently being developed so any contributions are welcomed. The purpose of this package is to simplify the spec_helper_acceptance.rb files within each module and as such any contributions in this area are welcome, as long as backwards compatibility is kept in mind.
+
+Use this repo's issue tracker to track any issues you encounter

data/Gemfile

@@ -0,0 +1,18 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :test do
+  gem 'beaker', '= 2.52.0' if RUBY_VERSION <= '2.1.6'
+  gem 'beaker' if RUBY_VERSION > '2.1.6'
+  gem 'bundler', '~> 1.9'
+  gem 'rake', '~> 10.0'
+  gem 'rspec', '~> 3'
+  gem 'rubocop', require: false
+  gem 'rubocop-rspec', require: false
+end
+
+group :development do
+  gem 'pry'
+  gem 'pry-byebug'
+end

data/LICENSE

@@ -0,0 +1,15 @@
+Copyright (C) 2015 Puppet Labs Inc
+
+Puppet Labs can be contacted at: info@puppetlabs.com
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/MAINTAINERS

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "file_format": "This MAINTAINERS file format is described at http://pup.pt/maintainers",
+  "issues": "https://github.com/puppetlabs/beaker-module_install_helper/issues",
+  "people": [
+    {
+      "github": "wilson208",
+      "name": "Wilson McCoubrey"
+    }
+  ]
+}

data/README.md

@@ -0,0 +1,36 @@
+## beaker-module\_install\_helper
+
+This gem is simply an abstraction for the various functions that are performed within the `spec/spec_helper_acceptance.rb` files across the modules to standardise how these are implemented.
+
+### Usage
+The below example will install the module from source on the host with role 'master', if that doesn't exist, on all hosts with role 'agent'. Otherwise it will be installed on all hosts.
+```ruby
+require 'beaker/module_install_helper'
+install_module_dependencies
+install_module
+```
+
+The below example will install the module from source on the specified host and install module dependencies specified in metadata.json on the host
+```ruby
+require 'beaker/module_install_helper'
+install_module_dependencies_on(host)
+install_module_on(host)
+```
+
+### Assumptions
+* Module under test has a valid metadata.json file at the root of the module directory.
+
+### `install_module`
+This will call `install_module_on` on the hosts with role 'master'. If there are none, the module will be install on all hosts with the role 'agent', again, if there are none, the module will be installed on all hosts.
+
+### `install_module_on(host)`
+This will install the module under test on the specified host using the local source. The module name will be derived from the name property of the module's metadata.json file, assuming it is in format author-modulename.
+
+### `install_module_dependencies`
+This will call `install_module_dependencies_on` on the hosts with role 'master'. If there are none, the module will be install on all hosts with the role 'agent', again, if there are none, the module dependencies will be installed on all hosts.
+
+### `install_module_dependencies_on`
+This will install a list of dependencies on the specified host from the forge, using the dependencies list specified in the metadata.json file, taking into consideration the version constraints if specified.
+
+### Support
+No support is supplied or implied. Use at your own risk.

data/Rakefile

@@ -0,0 +1,15 @@
+require 'bundler/gem_tasks'
+task default: [:lint, :spec]
+
+require 'rubocop/rake_task'
+desc 'Run rubocop'
+RuboCop::RakeTask.new(:lint) do |t|
+  t.requires << 'rubocop-rspec'
+end
+
+require 'rspec/core/rake_task'
+desc 'Run spec tests using rspec'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = ['--color']
+  t.pattern = 'spec'
+end

data/beaker-module_install_helper.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'beaker-module_install_helper'
+  spec.version       = '0.1.0'
+  spec.authors       = ['Puppet']
+  spec.email         = ['wilson@puppet.com']
+
+  spec.summary       = 'A helper gem for use in a Puppet Modules ' \
+                       'spec_helper_acceptance.rb file'
+  spec.description   = 'A helper gem for use in a Puppet Modules ' \
+                       'spec_helper_acceptance.rb file to help install the ' \
+                       'module under test and its dependencies on the system ' \
+                       'under test'
+  spec.homepage      = 'https://github.com/puppetlabs/beaker-module_install_helper'
+  spec.license       = 'Apache-2'
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  spec.executables   = `git ls-files -- bin/*` \
+                       .split("\n") \
+                       .map { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  ## Testing dependencies
+  spec.add_development_dependency 'rspec'
+
+  # Run time dependencies
+  spec.add_runtime_dependency 'beaker', '>= 2.0'
+end

data/lib/beaker/module_install_helper.rb

@@ -0,0 +1,150 @@
+require 'beaker'
+
+# Provides method for use in module test setup to install the module under
+# test and it's dependencies on the specified hosts
+module Beaker::ModuleInstallHelper
+  include Beaker::DSL
+
+  # This method calls the install_module_on method for each host which is a
+  # master, or if no master is present, on all agent nodes.
+  def install_module
+    install_module_on hosts_to_install_module_on
+  end
+
+  # This method will install the module under test on the specified host(s) from
+  # the source on the local machine
+  def install_module_on(host)
+    copy_module_to(host,
+                   source:      @module_source_dir,
+                   module_name: module_name_from_metadata)
+  end
+
+  # This method calls the install_module_dependencies_on method for each
+  # host which is a master, or if no master is present, on all agent nodes.
+  def install_module_dependencies
+    hosts_to_install_module_on.each do |host|
+      install_module_dependencies_on(host)
+    end
+  end
+
+  # This method will install the module under tests module dependencies on the
+  # specified host from the dependencies list in metadata.json
+  def install_module_dependencies_on(host)
+    deps = module_dependencies_from_metadata
+    deps.each do |dep|
+      install_puppet_module_via_pmt_on(host, dep)
+    end
+  end
+
+  # This method returns an array of dependencies from the metadata.json file
+  # in the format of an array of hashes, containing :module_name and optionally
+  # :version elements. If no dependencies are specified, empty array is returned
+  def module_dependencies_from_metadata
+    metadata = module_metadata
+    return [] unless metadata.key?('dependencies')
+
+    dependencies = []
+    metadata['dependencies'].each do |d|
+      tmp = { module_name: d['name'].sub!('/', '-') }
+
+      if d.key?('version_requirement')
+        tmp[:version] = module_version_from_requirement(tmp[:module_name],
+                                                        d['version_requirement'])
+      end
+      dependencies.push(tmp)
+    end
+
+    dependencies
+  end
+
+  # This method takes a module name and the version requirement string from the
+  # metadata.json file, containing either lower bounds of version or both lower
+  # and upper bounds. The function then uses the forge rest endpoint to find
+  # the most recent release of the given module matching the version requirement
+  def module_version_from_requirement(mod_name, vr_str)
+    uri = URI("https://forgeapi.puppetlabs.com/v3/modules/#{mod_name}")
+    response = Net::HTTP.get(uri)
+    forge_data = JSON.parse(response)
+
+    vrs = version_requirements_from_string(vr_str)
+
+    # Here we iterate the releases of the given module and pick the most recent
+    # that matches to version requirement
+    forge_data['releases'].sort_by { |k| k['version'] }.reverse.each do |rel|
+      return rel['version'] if vrs.all? { |vr| vr.match?('', rel['version']) }
+    end
+
+    raise "No release version found matching '#{vr}'"
+  end
+
+  # This method takes a version requirement string as specified in the link
+  # below, with either simply a lower bound, or both lower and upper bounds and
+  # returns an array of Gem::Dependency objects
+  # https://docs.puppet.com/puppet/latest/modules_metadata.html
+  def version_requirements_from_string(vr_str)
+    ops = vr_str.scan(/[(<|>|=)]{1,2}/i)
+    vers = vr_str.scan(/[(0-9|\.)]+/i)
+
+    raise 'Invalid version requirements' if ops.count != 0 &&
+                                            ops.count != vers.count
+
+    vrs = []
+    ops.each_with_index do |op, index|
+      vrs.push(Gem::Dependency.new('', "#{op} #{vers[index]}"))
+    end
+
+    vrs
+  end
+
+  # This method will return array of all masters. If no masters exist, it will
+  # return all agent nodes. If no nodes tagged master or agent exist, all nodes
+  # will be returned
+  def hosts_to_install_module_on
+    masters = hosts_with_role(hosts, :master)
+    return masters unless masters.empty?
+
+    agents = hosts_with_role(hosts, :agent)
+    return agents unless agents.empty?
+
+    hosts
+  end
+
+  # This method will read the 'name' attribute from metadata.json file and
+  # remove the first segment. E.g. puppetlabs-vcsrepo -> vcsrepo
+  def module_name_from_metadata
+    res = get_module_name module_metadata['name']
+    raise 'Error getting module name' unless res
+    res[1]
+  end
+
+  # This method uses the module_source_directory path to read the metadata.json
+  # file into a json array
+  def module_metadata
+    metadata_path = "#{@module_source_dir}/metadata.json"
+    unless File.exist?(metadata_path)
+      raise "Error loading metadata.json file from #{@module_source_dir}"
+    end
+    JSON.parse(File.read(metadata_path))
+  end
+
+  # Use this property to store the module_source_dir, so we don't traverse
+  # the tree every time
+  def get_module_source_directory(search_in)
+    module_source_dir = nil
+    # here we go up the file tree and search the directories for a
+    # valid metadata.json
+    while module_source_dir.nil? && search_in != File.dirname(search_in)
+      # remove last segment (file or folder, doesn't matter)
+      search_in = File.dirname(search_in)
+
+      # Append metadata.json, check it exists in the directory we're searching
+      metadata_path = File.join(search_in, 'metadata.json')
+      module_source_dir = search_in if File.exist?(metadata_path)
+    end
+    module_source_dir
+  end
+end
+
+include Beaker::ModuleInstallHelper
+# Use the caller (requirer) of this file to begin search for module source dir
+@module_source_dir = get_module_source_directory caller[0][/[^:]+/]

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'beaker/module_install_helper'

data/spec/unit/beaker/module_install_helper_spec.rb

@@ -0,0 +1,288 @@
+require 'spec_helper'
+
+describe Beaker::ModuleInstallHelper do
+  context 'hosts_to_install_module_on' do
+    context 'on split master/agent setup' do
+      let(:hosts) do
+        [
+          { 'roles' => %w(master database dashboard classifier) },
+          { 'roles' => ['agent'] }
+        ]
+      end
+
+      it 'returns a node with master role' do
+        expect(hosts_to_install_module_on.first['roles']).to include 'master'
+      end
+    end
+
+    context 'on split agent only setup' do
+      let(:hosts) { [{ 'roles' => ['agent'] }] }
+
+      it 'returns a node with master role' do
+        expect(hosts_to_install_module_on.first['roles']).to include 'agent'
+      end
+    end
+  end
+
+  context 'module_name_from_metadata' do
+    let(:module_metadata) { { 'name' => 'puppetlabs-vcsrepo' } }
+
+    it 'Removes author from name' do
+      res = module_name_from_metadata
+      expect(res).to eq('vcsrepo')
+    end
+  end
+
+  context 'module_metadata' do
+    before do
+      @module_source_dir = '/a/b/c/d'
+      allow(File).to receive(:exist?)
+        .with('/a/b/c/d/metadata.json')
+        .and_return(true)
+      allow(File).to receive(:read)
+        .with('/a/b/c/d/metadata.json')
+        .and_return('{"name": "puppetlabs-vcsrepo"}')
+    end
+
+    it 'Returns hash with correct data' do
+      expect(module_metadata['name']).to eq('puppetlabs-vcsrepo')
+    end
+  end
+
+  context 'get_module_source_directory' do
+    let(:search_in) { '/a/b/c/d/e/f/g/h.rb' }
+    let(:search_in_no_metadata) { '/test/test/test/blah.rb' }
+
+    before do
+      allow(File).to receive(:exist?).with(anything).and_return(false)
+      allow(File).to receive(:exist?).with('/a/metadata.json').and_return(true)
+    end
+
+    it 'traverses file tree until it finds a folder containing metadata.json' do
+      expect(get_module_source_directory(search_in)).to eq('/a')
+    end
+
+    it 'traverses file tree without a metadata.json file' do
+      expect(get_module_source_directory(search_in_no_metadata)).to be_nil
+    end
+  end
+
+  context 'install_module_on' do
+    let(:module_source_dir) { '/a/b/c/d' }
+
+    before do
+      @module_source_dir = '/a/b/c/d'
+      allow(File).to receive(:exist?).and_return(true)
+      allow(File).to receive(:read).and_return('{"name": "puppetlabs-vcsrepo"}')
+
+      allow_any_instance_of(Beaker::DSL::InstallUtils::ModuleUtils)
+        .to receive(:copy_module_to)
+        .with(anything)
+        .and_return(false)
+
+      allow_any_instance_of(Beaker::DSL::InstallUtils::ModuleUtils)
+        .to receive(:copy_module_to)
+        .with(host, source: module_source_dir, module_name: 'vcsrepo')
+        .and_return(true)
+    end
+
+    let(:host) { { 'roles' => %w(master database dashboard classifier) } }
+
+    it 'copy module to given host' do
+      expect(install_module_on(host)).to be true
+    end
+  end
+
+  context 'module_version_matching_requirement' do
+    context 'with simple version requirement, no upper bound' do
+      it 'return latest matching version' do
+        res = module_version_from_requirement('puppetlabs-ntp', '= 6.0.0')
+        expect(res).to eql('6.0.0')
+      end
+    end
+
+    context 'with version range requirement with an upper bound' do
+      it 'return latest matching version' do
+        res = module_version_from_requirement('puppetlabs-ntp',
+                                              '>= 4.0.0 < 6.0.0')
+        expect(res).to eql('5.0.0')
+      end
+    end
+  end
+
+  context 'module_dependencies_from_metadata' do
+    before do
+      allow_any_instance_of(described_class)
+        .to receive(:module_metadata)
+        .and_return(input_metadata)
+    end
+
+    context 'multiple dependencies with versions' do
+      let(:input_metadata) do
+        {
+          'name' => 'puppetlabs-vcsrepo',
+          'dependencies' => [
+            {
+              'name' => 'puppetlabs/stdlib',
+              'version_requirement' => '>= 4.13.1 <= 4.14.0'
+            }, {
+              'name' => 'puppetlabs/concat',
+              'version_requirement' => '>= 2.0.0 <= 2.2.0'
+            }
+          ]
+        }
+      end
+
+      let(:desired) do
+        [
+          { module_name: 'puppetlabs-stdlib', version: '4.14.0' },
+          { module_name: 'puppetlabs-concat', version: '2.2.0' }
+        ]
+      end
+
+      it 'returns dependencies array with 2 dependencies and their versions' do
+        dependencies = module_dependencies_from_metadata
+        expect(dependencies).to eq(desired)
+      end
+    end
+
+    context 'multiple dependencies without versions' do
+      let(:input_metadata) do
+        {
+          'name' => 'puppetlabs-vcsrepo',
+          'dependencies' => [
+            { 'name' => 'puppetlabs/stdlib' },
+            { 'name' => 'puppetlabs/concat' }
+          ]
+        }
+      end
+
+      let(:desired) do
+        [
+          { module_name: 'puppetlabs-stdlib' },
+          { module_name: 'puppetlabs-concat' }
+        ]
+      end
+
+      it 'returns dependencies array with 2 dependencies without version' do
+        dependencies = module_dependencies_from_metadata
+        expect(dependencies).to eq(desired)
+      end
+    end
+
+    context 'empty dependencies' do
+      let(:input_metadata) do
+        {
+          'name' => 'puppetlabs-vcsrepo',
+          'dependencies' => []
+        }
+      end
+      let(:desired) { [] }
+
+      it 'returns empty dependencies array' do
+        dependencies = module_dependencies_from_metadata
+        expect(dependencies).to eq(desired)
+      end
+    end
+
+    context 'no dependencies' do
+      let(:input_metadata) { { 'name' => 'puppetlabs-vcsrepo' } }
+      let(:desired) { [] }
+
+      it 'returns empty dependencies array' do
+        dependencies = module_dependencies_from_metadata
+        expect(dependencies).to eq(desired)
+      end
+    end
+  end
+
+  context 'version_requirements_from_string' do
+    context 'with simple version requirement containing lower bound' do
+      let(:lower_bound) { '>= 2.0.0' }
+
+      it 'return array with single gem version dependency objects' do
+        res = version_requirements_from_string(lower_bound)
+        expect(res).to eql([Gem::Dependency.new('', lower_bound)])
+      end
+    end
+
+    context 'with complex version requirement containing upper bounds' do
+      let(:lower_bound) { '>= 2.0.0' }
+      let(:upper_bound) { '< 3.0.0' }
+
+      it 'return array with 2 gem version dependency objects' do
+        res = version_requirements_from_string("#{lower_bound} #{upper_bound}")
+        expect(res).to eql([Gem::Dependency.new('', lower_bound),
+                            Gem::Dependency.new('', upper_bound)])
+      end
+    end
+  end
+
+  context 'install_module_dependencies_on' do
+    before do
+      allow_any_instance_of(described_class)
+        .to receive(:module_metadata)
+        .and_return(input_metadata)
+    end
+
+    context 'with 1 dependencies with version' do
+      let(:a_host) { { name: 'a_host' } }
+      let(:dependency) do
+        { module_name: 'puppetlabs-stdlib', version: '4.14.0' }
+      end
+      let(:input_metadata) do
+        {
+          'name' => 'puppetlabs-vcsrepo',
+          'dependencies' => [
+            {
+              'name' => 'puppetlabs/stdlib',
+              'version_requirement' => '>= 4.13.1 <= 4.14.0'
+            }
+          ]
+        }
+      end
+
+      before do
+        expect_any_instance_of(Beaker::DSL::InstallUtils::ModuleUtils)
+          .to receive(:install_puppet_module_via_pmt_on)
+          .with(a_host, dependency)
+          .exactly(1)
+      end
+
+      it 'installs the modules' do
+        install_module_dependencies_on(a_host)
+      end
+    end
+
+    context 'with 2 dependencies without version' do
+      let(:input_metadata) do
+        {
+          'name' => 'puppetlabs-vcsrepo',
+          'dependencies' => [
+            { 'name' => 'puppetlabs/stdlib' },
+            { 'name' => 'puppetlabs/concat' }
+          ]
+        }
+      end
+      let(:a_host) { { name: 'a_host' } }
+      let(:dependency1) { { module_name: 'puppetlabs-concat' } }
+      let(:dependency2) { { module_name: 'puppetlabs-stdlib' } }
+
+      before do
+        expect_any_instance_of(Beaker::DSL::InstallUtils::ModuleUtils)
+          .to receive(:install_puppet_module_via_pmt_on)
+          .with(a_host, dependency1)
+          .exactly(1)
+
+        expect_any_instance_of(Beaker::DSL::InstallUtils::ModuleUtils)
+          .to receive(:install_puppet_module_via_pmt_on)
+          .with(a_host, dependency2)
+          .exactly(1)
+      end
+
+      it 'installs both modules' do
+        install_module_dependencies_on(a_host)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: beaker-module_install_helper
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Puppet
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: beaker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: A helper gem for use in a Puppet Modules spec_helper_acceptance.rb file
+  to help install the module under test and its dependencies on the system under test
+email:
+- wilson@puppet.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- MAINTAINERS
+- README.md
+- Rakefile
+- beaker-module_install_helper.gemspec
+- lib/beaker/module_install_helper.rb
+- spec/spec_helper.rb
+- spec/unit/beaker/module_install_helper_spec.rb
+homepage: https://github.com/puppetlabs/beaker-module_install_helper
+licenses:
+- Apache-2
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: A helper gem for use in a Puppet Modules spec_helper_acceptance.rb file
+test_files:
+- spec/spec_helper.rb
+- spec/unit/beaker/module_install_helper_spec.rb