randumb 项目技术文档

1. 安装指南

首先，您需要在您的Gemfile文件中添加以下代码来引入randumb库：

gem 'randumb'

接下来，执行以下命令来更新您的bundle：

bundle install

确保您的ActiveRecord版本不低于3.0.0，并且您的数据库支持SQLite、MySQL或Postgres/PostGIS。

2. 项目的使用说明

randumb是一个Ruby库，允许您轻松地从您的数据库中随机抽取记录。最简单的使用方式是将其作为ActiveRecord查询的一部分：

Artist.order_by_rand.first # 如果有Artist记录，则返回一个随机的Artist，否则返回nil
Artist.order_by_rand.limit(3).all # 返回一个包含三个随机Artist的数组
Artist.order_by_rand.limit(1).all # 返回一个包含一个随机Artist的数组

###randumb的工作原理

randumb实际上只是在您的查询中添加了一个额外的ORDER BY RANDOM()（对于MySQL则是RAND()）。

3. 项目API使用文档

以下是randumb提供的一些高级使用方法：

加权随机排序

您可以使用order_by_rand_weighted方法来偏好某些记录。

例如，如果您想偏好评分较高的电影，并且您的Movie模型有一个数字类型的score字段，您可以使用以下方式：

Movie.order_by_rand_weighted(:score).first # 随机返回一个电影
Movie.order_by_rand_weighted(:score).limit(10).all # 返回一个最多包含10个电影的数组

种子随机性

如果您希望给随机性设定一个种子以便产生可预测的结果，您可以在randumb的任何方法中提供一个可选的整数种子：

Artist.order_by_rand(seed: 123).limit(2) # 两次调用将返回相同的两个Artist
Artist.order_by_rand(seed: 123).limit(2)

随机ID洗牌

还有一些方法允许您使用randumb的早期算法进行随机记录选择。请注意，使用此方法时无法应用加权，并且limit/orders的行为也会有所不同。

# 返回视图数最高的100个Artist中随机选取的5个
artists = Artist.limit(100).order("view_count DESC").random_by_id_shuffle(5)

4. 项目安装方式

项目的安装方式已在安装指南中详细描述。您需要通过Gemfile添加randumb依赖，然后执行bundle安装命令。请确保您的ActiveRecord和数据库支持与randumb兼容。