fbe 0.0.75 → 0.0.77

data/lib/fbe/octo.rb

@@ -22,27 +22,28 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-require 'loog'
 require 'decoor'
+require 'faraday/http_cache'
+require 'faraday/retry'
+require 'loog'
 require 'obk'
 require 'octokit'
 require 'verbose'
-require 'faraday/http_cache'
-require 'faraday/retry'
 require_relative '../fbe'
 require_relative 'middleware'
-require_relative 'middleware/quota'
 require_relative 'middleware/logging_formatter'
+require_relative 'middleware/quota'
 
-# Interface to GitHub API.
+# Makes a call to the GitHub API.
 #
-# It is supposed to be used instead of Octokit client, because it
-# is pre-configured and enables additional fearues, such as retrying,
+# It is supposed to be used instead of +Octokit::Client+, because it
+# is pre-configured and enables additional features, such as retrying,
 # logging, and caching.
 #
 # @param [Judges::Options] options The options available globally
 # @param [Hash] global Hash of global options
 # @param [Loog] loog Logging facility
+# @return [Hash] Usually returns a JSON, as it comes from the GitHub API
 def Fbe.octo(options: $options, global: $global, loog: $loog)
   raise 'The $global is not set' if global.nil?
   global[:octo] ||=
@@ -132,7 +133,7 @@ def Fbe.octo(options: $options, global: $global, loog: $loog)
         def repo_id_by_name(name)
           json = @origin.repository(name)
           id = json[:id]
-          @loog.debug("GitHub repository #{name} has an ID: ##{id}")
+          @loog.debug("GitHub repository #{name.inspect} has an ID: ##{id}")
           id
         end
 
@@ -291,7 +292,8 @@ class Fbe::FakeOctokit
       },
       pull_request: {
         merged_at: nil
-      }
+      },
+      created_at: Time.parse('2024-09-20 19:00:00 UTC')
     }
   end
 
@@ -498,6 +500,7 @@ class Fbe::FakeOctokit
                 name: 'bug'
               }
             ],
+            user: { login: 'yegor256', id: 526_301, type: 'User' },
             created_at: Time.parse('2024-08-20 19:00:00 UTC')
           }
         ]

data/lib/fbe/overwrite.rb

@@ -25,18 +25,19 @@
 require_relative '../fbe'
 require_relative 'fb'
 
-# Overwrite a property in the fact.
+# Overwrites a property in the fact.
 #
 # If the property doesn't exist in the fact, it will be added. If it does
-# exist, it will be removed (the entire fact will be destroyed, new fact
-# created, and property set).
+# exist, it will be re-set (the entire fact will be destroyed, new fact
+# created, and property set with the new value).
 #
-# It is important that the fact has +_id+ property. If it doesn't, an exception
-# will be raised.
+# It is important that the fact has the +_id+ property. If it doesn't,
+# an exception will be raised.
 #
 # @param [Factbase::Fact] fact The fact to modify
 # @param [String] property The name of the property to set
 # @param [Any] value The value to set
+# @return [nil] Nothing
 def Fbe.overwrite(fact, property, value, fb: Fbe.fb)
   raise 'The fact is nil' if fact.nil?
   raise "The property is not a String but #{property.class} (#{property})" unless property.is_a?(String)
@@ -56,4 +57,5 @@ def Fbe.overwrite(fact, property, value, fb: Fbe.fb)
       n.send("#{k}=", v)
     end
   end
+  nil
 end

data/lib/fbe/pmp.rb

@@ -23,24 +23,34 @@
 # SOFTWARE.
 
 require 'others'
-require_relative 'fb'
 require_relative '../fbe'
+require_relative 'fb'
 
-# Get configuration parameter from the "PMP" fact.
+# Takes configuration parameter from the "PMP" fact.
+#
+# The factbase may have a few facts with the +what+ set to +pmp+ (stands for
+# "project management plan"). These facts contain information that configure
+# the project. It is expected that every fact with the +what+ set to +pmp+ also
+# contains the +area+ property, which is set to one of nine values: +scope+,
+# +time+, +cost+, etc. (by nine process areas in the PMBOK).
 #
 # @param [Factbase] fb The factbase
 # @param [Hash] global The hash for global caching
 # @param [Judges::Options] options The options coming from the +judges+ tool
 # @param [Loog] loog The logging facility
+# @return [String|Integer] The value of the property found
 def Fbe.pmp(fb: Fbe.fb, global: $global, options: $options, loog: $loog)
   others do |*args1|
     area = args1.first
+    unless %w[cost scope hr time procurement risk integration quality communication].include?(area.to_s)
+      raise "Invalid area #{area.inspect} (not part of PMBOK)"
+    end
     others do |*args2|
       param = args2.first
       f = Fbe.fb(global:, fb:, options:, loog:).query("(and (eq what 'pmp') (eq area '#{area}'))").each.to_a.first
-      raise "Unknown area '#{area}'" if f.nil?
+      raise "Unknown area #{area.inspect}" if f.nil?
       r = f[param]
-      raise "Unknown property '#{param}' in the '#{area}' area" if r.nil?
+      raise "Unknown property #{param.inspect} in the #{area.inspect} area" if r.nil?
       r.first
     end
   end

data/lib/fbe/regularly.rb

@@ -33,6 +33,7 @@ require_relative 'fb'
 # @param [Factbase] fb The factbase
 # @param [String] judge The name of the judge, from the +judges+ tool
 # @param [Loog] loog The logging facility
+# @return [nil] Nothing
 def Fbe.regularly(area, p_every_days, p_since_days = nil, fb: Fbe.fb, judge: $judge, loog: $loog, &)
   pmp = fb.query("(and (eq what 'pmp') (eq area '#{area}') (exists #{p_every_days}))").each.to_a.first
   interval = pmp.nil? ? 7 : pmp[p_every_days].first
@@ -53,4 +54,5 @@ def Fbe.regularly(area, p_every_days, p_since_days = nil, fb: Fbe.fb, judge: $ju
     f.since = since
   end
   yield f
+  nil
 end

data/lib/fbe/repeatedly.rb

@@ -33,6 +33,7 @@ require_relative 'overwrite'
 # @param [Factbase] fb The factbase
 # @param [String] judge The name of the judge, from the +judges+ tool
 # @param [Loog] loog The logging facility
+# @return [nil] Nothing
 def Fbe.repeatedly(area, p_every_hours, fb: Fbe.fb, judge: $judge, loog: $loog, &)
   pmp = fb.query("(and (eq what 'pmp') (eq area '#{area}') (exists #{p_every_hours}))").each.to_a.first
   hours = pmp.nil? ? 24 : pmp[p_every_hours].first
@@ -51,4 +52,5 @@ def Fbe.repeatedly(area, p_every_hours, fb: Fbe.fb, judge: $judge, loog: $loog,
   end
   Fbe.overwrite(f, 'when', Time.now)
   yield fb.query("(and (eq what '#{judge}'))").each.to_a.first
+  nil
 end

data/lib/fbe/sec.rb

@@ -26,11 +26,16 @@ require_relative '../fbe'
 
 # Converts number of seconds into text.
 #
+# THe number of seconds is taken from the +fact+ provided, usually stored
+# there in the +seconds+ property. The seconds are formatted to hours,
+# days, or weeks.
+#
 # @param [Factbase::Fact] fact The fact, where to get the number of seconds
 # @param [String] prop The property in the fact, with the seconds
+# @return [String] Time interval as a text
 def Fbe.sec(fact, prop = :seconds)
   s = fact[prop.to_s]
-  raise "There is no #{prop} property" if s.nil?
+  raise "There is no #{prop.inspect} property" if s.nil?
   s = s.first.to_i
   if s < 60
     format('%d seconds', s)
@@ -38,7 +43,9 @@ def Fbe.sec(fact, prop = :seconds)
     format('%d minutes', s / 60)
   elsif s < 60 * 60 * 24
     format('%d hours', s / (60 * 60))
-  else
+  elsif s < 7 * 60 * 60 * 24
     format('%d days', s / (60 * 60 * 24))
+  else
+    format('%d weeks', s / (7 * 60 * 60 * 24))
   end
 end

data/lib/fbe/unmask_repos.rb

@@ -22,40 +22,54 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+require_relative '../fbe'
 require_relative 'octo'
 
-# Unmask.
-# Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2024 Zerocracy
-# License:: MIT
-module Fbe
-  def self.mask_to_regex(mask)
-    org, repo = mask.split('/')
-    raise "Org '#{org}' can't have an asterisk" if org.include?('*')
-    Regexp.compile("#{org}/#{repo.gsub('*', '.*')}")
-  end
+# Converts mask to repository name.
+#
+# This function takes something like +"zerocracy/*"+ as an input and returns
+# a regular expression that may match repositories defined by this mask, which
+# is +/zerocracy\/.*+ in this particular case.
+#
+# @param [String] mask The mask
+# @return [Regex] Regular expression
+def Fbe.mask_to_regex(mask)
+  org, repo = mask.split('/')
+  raise "Org '#{org}' can't have an asterisk" if org.include?('*')
+  Regexp.compile("#{org}/#{repo.gsub('*', '.*')}")
+end
 
-  def self.unmask_repos(options: $options, global: $global, loog: $loog)
-    repos = []
-    octo = Fbe.octo(loog:, global:, options:)
-    masks = (options.repositories || '').split(',')
-    masks.reject { |m| m.start_with?('-') }.each do |mask|
-      unless mask.include?('*')
-        repos << mask
-        next
-      end
-      re = Fbe.mask_to_regex(mask)
-      octo.repositories(mask.split('/')[0]).each do |r|
-        repos << r[:full_name] if re.match?(r[:full_name])
-      end
+# Builds a list of repositories required by the +repositories+ option.
+#
+# The +repositories+ option defined in the +$options+ must contain something
+# like "zerocracy/fbe,zerocracy/ab*" (comma-separated list of masks). This
+# function will go to the GitHub API and fetch all available repositories
+# by these masks.
+#
+# @param [Judges::Options] options The options coming from the +judges+ tool
+# @param [Hash] global The hash for global caching
+# @param [Loog] loog The logging facility
+# @return [Array<String>] List of repository full names
+def Fbe.unmask_repos(options: $options, global: $global, loog: $loog)
+  repos = []
+  octo = Fbe.octo(loog:, global:, options:)
+  masks = (options.repositories || '').split(',')
+  masks.reject { |m| m.start_with?('-') }.each do |mask|
+    unless mask.include?('*')
+      repos << mask
+      next
     end
-    masks.select { |m| m.start_with?('-') }.each do |mask|
-      re = Fbe.mask_to_regex(mask[1..])
-      repos.reject! { |r| re.match?(r) }
+    re = Fbe.mask_to_regex(mask)
+    octo.repositories(mask.split('/')[0]).each do |r|
+      repos << r[:full_name] if re.match?(r[:full_name])
     end
-    repos.reject! { |repo| octo.repository(repo)[:archived] }
-    raise "No repos found matching: #{options.repositories}" if repos.empty?
-    loog.debug("Scanning #{repos.size} repositories: #{repos.join(', ')}...")
-    repos
   end
+  masks.select { |m| m.start_with?('-') }.each do |mask|
+    re = Fbe.mask_to_regex(mask[1..])
+    repos.reject! { |r| re.match?(r) }
+  end
+  repos.reject! { |repo| octo.repository(repo)[:archived] }
+  raise "No repos found matching: #{options.repositories}" if repos.empty?
+  loog.debug("Scanning #{repos.size} repositories: #{repos.join(', ')}...")
+  repos
 end

data/lib/fbe/who.rb

@@ -23,17 +23,24 @@
 # SOFTWARE.
 
 require_relative '../fbe'
+require_relative 'octo'
 
 # Converts an ID of GitHub user into a nicely formatting string with his name.
 #
+# The ID of the user (integer) is expected to be stored in the +who+ property of the
+# provided +fact+. This function makes a live request to GitHub API in order
+# to find out what is the name of the user. For example, the ID +526301+
+# will be converted to the +"@yegor256"+ string.
+#
 # @param [Factbase::Fact] fact The fact, where to get the ID of GitHub user
 # @param [String] prop The property in the fact, with the ID
 # @param [Judges::Options] options The options coming from the +judges+ tool
 # @param [Hash] global The hash for global caching
 # @param [Loog] loog The logging facility
+# @return [String] Full name of the user
 def Fbe.who(fact, prop = :who, options: $options, global: $global, loog: $loog)
   id = fact[prop.to_s]
-  raise "There is no #{prop} property" if id.nil?
+  raise "There is no #{prop.inspect} property" if id.nil?
   id = id.first.to_i
   "@#{Fbe.octo(options:, global:, loog:).user_name_by_id(id)}"
 end

data/lib/fbe.rb

@@ -20,12 +20,12 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-# The module.
+# The main and only module of this gem.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2024 Zerocracy
 # License:: MIT
 module Fbe
-  # Current version of the gem (changed by .rultor.yml on every release)
-  VERSION = '0.0.75'
+  # Current version of the gem (changed by +.rultor.yml+ on every release)
+  VERSION = '0.0.77'
 end

data/test/fbe/test_conclude.rb

@@ -64,26 +64,6 @@ class TestConclude < Minitest::Test
     assert_equal('something funny', f.details)
   end
 
-  def test_maybe
-    options = Judges::Options.new
-    fb = Fbe.fb(fb: Factbase.new, global: {}, options:, loog: Loog::NULL)
-    fb.insert.foo = 1
-    Fbe.conclude(fb:, judge: 'issue-was-opened', loog: Loog::NULL, options:, global: {}) do
-      on '(exists foo)'
-      maybe do |n, prev|
-        n.repository = 111
-        n.where = 'github'
-        n.issue = prev.foo
-        n.who = 777
-        n.when = Time.now
-        "it's a test." * 20
-      end
-    end
-    f = fb.query('(exists issue)').each.to_a[0]
-    assert_equal(1, f.issue)
-    assert(f._id.positive?)
-  end
-
   def test_consider
     fb = Factbase.new
     fb.insert.foo = 1

data/test/fbe/test_enter.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# MIT License
+#
+# Copyright (c) 2024 Zerocracy
+#
+# 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.
+
+require 'minitest/autorun'
+require 'loog'
+require_relative '../test__helper'
+require_relative '../../lib/fbe/enter'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Zerocracy
+# License:: MIT
+class TestEnter < Minitest::Test
+  def test_simple
+    WebMock.disable_net_connect!
+    options = Judges::Options.new({ 'testing' => true, 'zerocracy_token' => '00000-0000-0000-00000' })
+    stub_request(:get, 'https://api.zerocracy.com/valves/result?badge=foo')
+      .to_return(status: 204)
+    stub_request(:post, 'https://api.zerocracy.com/valves/add?badge=foo&job=0&result=hi&why=no%20reason')
+      .to_return(status: 302)
+    assert_equal('hi', Fbe.enter('foo', 'no reason', options:, loog: Loog::NULL) { 'hi' })
+  end
+end

metadata

@@ -1,139 +1,153 @@
 --- !ruby/object:Gem::Specification
 name: fbe
 version: !ruby/object:Gem::Version
-  version: 0.0.75
+  version: 0.0.77
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-07 00:00:00.000000000 Z
+date: 2024-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: baza.rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: decoor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: factbase
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: faraday-http-cache
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: faraday-multipart
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: faraday-retry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: graphql-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: judges
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
@@ -154,70 +168,70 @@ dependencies:
   name: loog
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: obk
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: octokit
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: others
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: verbose
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 description: A collection of extensions for a factbase, helping the judges of Zerocracy
@@ -265,6 +279,7 @@ files:
 - lib/fbe/bylaws.rb
 - lib/fbe/conclude.rb
 - lib/fbe/copy.rb
+- lib/fbe/enter.rb
 - lib/fbe/fb.rb
 - lib/fbe/github_graph.rb
 - lib/fbe/if_absent.rb
@@ -290,6 +305,7 @@ files:
 - test/fbe/test_bylaws.rb
 - test/fbe/test_conclude.rb
 - test/fbe/test_copy.rb
+- test/fbe/test_enter.rb
 - test/fbe/test_fb.rb
 - test/fbe/test_github_graph.rb
 - test/fbe/test_if_absent.rb