Nibbler 技术文档

1. 安装指南

Nibbler 是一个轻量级的 Ruby 库，用于将数据结构映射到自定义对象中。安装 Nibbler 非常简单，您可以通过 Ruby 的包管理器 gem 来安装。

在终端中运行以下命令：

gem install nibbler

如果您正在使用 Nokogiri 库处理 HTML 字符串，请确保也安装了 Nokogiri：

gem install nokogiri

对于 Ruby 1.8 用户，如果需要解析 JSON 内容，还需要安装 JSON 库：

gem install json

2. 项目使用说明

Nibbler 可以用于 HTML 屏幕抓取、解析 XML API 负载或者 JSON 数据。以下是一些基本的使用示例：

HTML 屏幕抓取

require 'nibbler'
require 'open-uri'

class BlogScraper < Nibbler
  element :title

  elements 'div.hentry' => :articles do
    element 'h2' => :title
    element 'a/@href' => :url
  end
end

blog = BlogScraper.parse open('http://example.com')

puts blog.title           # 输出博客标题
puts blog.articles.first.title  # 输出第一篇文章标题
puts blog.articles.first.url  # 输出第一篇文章链接

XML API 负载解析

class Movie < Nibbler
  element './title/@regular' => :name
  element './box_art/@large' => :poster_large
  element 'release_year' => :year, :with => lambda { |node| node.text.to_i }
  element './/link[@title="web page"]/@href' => :url
end

response = Net::HTTP.get_response URI('http://example.com/movie.xml')
movie = Movie.parse response.body

puts movie.name  # 输出电影名称
puts movie.year  # 输出电影年份

JSON 数据解析

require 'json'
require 'nibbler/json'

class Movie < NibblerJSON
  element :title
  element :year
  elements :genres
  element '.links.alternate' => :url
  element '.ratings.critics_score' => :critics_score
end

movie = Movie.parse json_string

puts movie.title           # 输出电影标题
puts movie.year            # 输出电影年份
puts movie.genres.join(', ')  # 输出电影类型
puts movie.url             # 输出电影链接

3. 项目 API 使用文档

Nibbler 提供了以下核心方法：

• element：定义一个元素映射。
• elements：定义多个元素映射。
• parse：解析给定的字符串或对象。

对于 JSON 数据，NibblerJSON 类提供了相同的方法。

元素选择器

元素选择器可以是 CSS 选择器，对于 XML，也可以使用 XPath 选择器。

映射转换

您可以在定义元素时，通过 :with 选项提供一个 lambda 函数来进行数据转换。

示例

class Product < Nibbler
  element '.name' => :name
  element '.price' => :price, :with => lambda { |node| node.text.to_f }
end

在上面的例子中，价格会被转换为浮点数。

4. 项目安装方式

除了通过 gem 安装之外，您也可以将 Nibbler 库的代码克隆到本地，然后手动安装。

克隆代码仓库：

git clone https://github.com/mislav/nibbler.git

然后，在项目的根目录下运行：

ruby setup.rb

这样，Nibbler 库就会被安装到您的 Ruby 环境中。