grantbb (奔跑的大兵)

Rails5.2 用 Wepacker 安装和使用 Materialize CSS

grantbb — Thu, 18 Apr 2019 12:33:55 +0800

Materialize CSS是一个比较新的基于Google Material Design的前端框架，界面非常简洁，而且很容易使用。

其中，在最新发布的1.0版本中，去掉了对于JQuery的依赖，这是一个很大进步。因为在Rails5以后也是移除了JQuery，而且接下来在我的项目中，我会开始使用React.js作为前端的开发框架。

下面就来介绍一下通过Webpacker安装和使用Materialize的步骤：

准备工作：在app/javascript/下面创建stylesheets目录以及application.scss文件：

$ mkdir app/javascript/stylesheets
$ touch app/javascript/stylesheets/application.scss

然后我们需要import刚才创建的scss文件，让Webpacker帮我们编译scss文件

// app/javascript/packs/application.js

import '../stylesheets/application'

在页面中引入Webpacker帮我们编译的application.js和application.css文件

# app/views/layouts/application.html.erb

<%= stylesheet_pack_tag 'application', media: 'all', 'data-turbolinks-track': 'reload' %>
<%= javascript_pack_tag 'application', 'data-turbolinks-track': 'reload' %>

使用yarn安装materialize-css，

yarn add materialize-css

我们可以在node_modules/materialize-css下面找到安装好的文件下面我们要把materialize.js加入到application.js中

// app/javascript/packs/application.js

import 'materialize-css/dist/js/materialize'

然后到application.scss中引入materialize.css

// app/javascript/stylesheets/application.scss

@import ‘materialize-css/dist/css/materialize’;

最后我们还需要在application.html.erb中加入Materialize依赖的字体和图标

// app/views/layouts/application.html.erb

<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">

安装配置到这里就完成了，接下来就是找一些 Materialize 的实例，应用到网站上吧。更多的细节可以参考我完成的 commit： Github commit

快速应用 Starter Template 的效果

2019 RubyConf AU 精彩内容回顾

grantbb — Sat, 09 Feb 2019 08:06:29 +0800

大会总结

两天的 2019 年澳洲的 Ruby 技术大会顺利结束了，这次大会组织的还是很不错的，现场的秩序和投影和音效都不错，不足的地方就是由于场地选在比较老的 Forum Melbourne，里面的座椅不是特别舒服。

本次大会的内容还是很丰富的，很多演讲者都是来自英国，美国。除了 Ruby 相关的技术主题，还有不少人文关怀的内容，比如 ADD（注意障碍），情绪管理和全球变暖的话题。

下面我来推荐几个我觉得非常不错的分享：

The Case Of The Missing Method - A Ruby Mystery Story

Nadia Odunayo 通过一个非常好的故事解释了 Ruby 中的 singleton class 的秘密，以及讲解了 singleton class 在 DSL 的实际应用，Nadia 的演讲节奏控制的非常好，声音非常清楚。

点击观看

How to hijack, proxy and smuggle sockets with Rack/Ruby

Dávid Halász 通过一个非常具体和实际的例子，演示了 Ruby 中的 Socket 编程相关的技术。

点击观看

Taming Monoliths Without Microservices

Kelly Sutton 在演讲中再次强调了如果要对 Monolithic Rails 应用进行拆分的话，重要的还是要把 Domain 划分清楚，以及如何恰当得处理 Domain 的界限和依赖，着重强调了不要有相互的依赖，依赖最好就是单向的。

点击观看

Representations Count

Tom Stuart, 来自英国，Understanding Computation 书的作者。他有着一口典型的英式口音。一听到这样的口音就让我想到了 IT Crowd. Tom 演示了通过不同的抽象表达，会对写代码解决问题产生巨大的影响。他用直观的图形解释了如何优雅的实现一个带负号的四则运算的实现。

点击观看

A Branch in Time (a story about revision histories)

Tekin Süleyman 也是通过一个生动的故事讲解了写好 git commit 信息的重要性，视频中还会学到几个新的 git 命令可以帮助你快速查找历史，以及展示了一些写好 git commit 的最佳实践。

点击观看

Views, from the top

Tim Riley 系统的介绍了 dry-rb view 的主要功能和使用方法。演示了如何通过 dry-rb 来写一个更加 OO 的 view 层的代码。

点击观看

Learn to make the point: data visualisation strategy

Mila Dymnikova 解释了数据可视化的重要作用，即使对于开发人员，在进行工作总结和汇报的时候也是非常重要的。她给出很具体的实现方法和一些好用的工具和服务。她的 PPT 做的非常生动。

点击观看

Building APIs you want to hug with GraphQL

Tom Ridge 介绍了如何设计和实现一个好的 GraphQL APIs.

点击观看

What the hell is a JRuby?

Tom Gamon 非常简洁清楚得总结了几种不同的 Ruby 的实现，重点介绍了 JRuby 的实现以及在什么情况下我们可能会考虑在产品环境使用 JRuby。视频里面提到的两本书《Working with ruby threads》《Ruby Under a Microscope》确实都是非常不错的。

点击观看

It's Down! Simulating Incidents in Production

Kelsey Pedersen 通过一个具体的实例，讲解了如何通过 Feature Flag 模拟产品环境的故障，然后如何分析故障以及完善相关的工具和流程。非常具有实战意义。

点击观看

Mechanically Confident

Adam Cuppy 演员出身的他有丰富的舞台经验，声音非常洪亮，非常能够调动现场的气氛，他总结了如何通过一些实践来建立好的 routine，从而不断取得进步然后建立自信。

点击观看

What were they thinking?"

Keith Pitty 凭借非常多年的经验，总结了软件开发方面的一些思考。

点击观看

更多视频请到 Ruby Australia 的 Youtube 官网查看！

使用 Rails Migration 转换 MySQL 数据库和表的字符集总结

grantbb — Wed, 20 Sep 2017 13:02:46 +0800

MySQL Character Set 基础知识

对于 MySQL 数据库你可以在不同的 Level 设置 Character Set 和 Collation，包括：Server Level，Database Level，Table Level，Column Level 还有 Application Level.

Server Level:

可以通过命令行设置，也可以通过配置文件设置

默认： --character-set-server=latin1   

latin1_swedish_ci is the default collation for latin1

还可以通过重新编译时指定参数实现：use the DEFAULT_CHARSET and DEFAULT_COLLATION

作用范围：如果创建数据库时不指定，那么就使用 Server Level 的设置

查看当前的设定，可以查看系统变量：character_set_server and collation_server

Database Level:

可以在创建数据库时设置：

CREATE DATABASE db_name CHARACTER SET latin1 COLLATE latin1_swedish_ci;

默认值：可以由 character_set_database and collation_database 系统变量决定。

可以通过下面的命令查看当前的设置：

USE db_name;

SELECT @@character_set_database, @@collation_database;

或者

SELECT DEFAULT_CHARACTER_SET_NAME, DEFAULT_COLLATION_NAME
FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = 'db_name';

作用：如果建表时没有指定，那么会作为表的默认值，同时也是作为 LOAD DATA 的默认值

修改数据库 level 的 character set 和 collation

ALTER DATABASE db_name CHARACTER SET utf8 COLLATE utf8_unicode_ci;

# 或者单独修改
ALTER DATABASE my_database DEFAULT COLLATE utf8_unicode_ci;

ALTER DATABASE my_database DEFAULT CHARACTER SET utf8;

Table Level:

可以在建表的语句中进行设置

作用：如果字段没有具体制定，那么会作为字段的默认值 note：该功能是 mysql 的一个扩展，不是标准的 SQL

使用下面语句可以同时修改 table 和 table 中字段的设置

ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name [COLLATE collation_name];

查看某个数据库中的所有表的一些设置信息的语句

SHOW TABLE STATUS FROM db_name;

Column Level:

N/A

Application Connection Level:

对于 Rails 应用，在 database.yml 的数据库连接设置中加上 ?reconnect=true&encoding=utf8&collation=utf8_unicode_ci

查看数据库不同级别的元数据的设置的语句，比如：character set

SELECT DEFAULT_COLLATION_NAME FROM information_schema.SCHEMATA S WHERE schema_name = 'db_name' AND DEFAULT_COLLATION_NAME != 'utf8_unicode_ci';

SELECT TABLE_NAME, TABLE_COLLATION FROM information_schema.TABLES WHERE table_schema = 'db_name' AND table_collation != 'utf8_unicode_ci';

SELECT * FROM information_schema.COLUMNS WHERE table_schema = 'db_name' AND collation_name != 'utf8_unicode_ci';

ConvertDatabaseCharacterSetAndCollationToUtf8 Migration

class ConvertDatabaseCharacterSetAndCollationToUtf8 < ActiveRecord::Migration
  def up
    execute <<~SQL
      ALTER DATABASE #{ActiveRecord::Base.connection.current_database} CHARACTER SET utf8 COLLATE utf8_unicode_ci;
    SQL
  end

  def down
    execute <<~SQL
      ALTER DATABASE #{ActiveRecord::Base.connection.current_database} CHARACTER SET latin1 COLLATE latin1_swedish_ci;
    SQL
  end
end

ConvertTablesCharacterSetAndCollationToUtf8 Migration

class ConvertTablesCharacterSetAndCollationToUtf8 < ActiveRecord::Migration
  def up
    execute("SET foreign_key_checks = 0")

    latin_tables_sql = <<~SQL
      SELECT TABLE_NAME, TABLE_COLLATION
      FROM information_schema.TABLES
      WHERE table_schema = '#{ActiveRecord::Base.connection.current_database}'
      AND table_collation != 'utf8_unicode_ci';
    SQL

    results = ActiveRecord::Base.connection.execute(latin_tables_sql)
    say "Total: #{results.count}"

    results.each do |result|
      alter_table_sql = "ALTER TABLE #{result[0]} CONVERT TO CHARACTER SET utf8 COLLATE utf8_unicode_ci;"
      execute alter_table_sql
    end

    execute("SET foreign_key_checks = 1")
  end
end

Rails Migration tips

在调试该功能的时候，学到的一些 tips：

rake db:migrate:status 查看当前 migration 的状态，包括版本信息等

rake db:migrate VERSION=33333333 migrate 指定 version

rake db:rollback STEP=n 通过 STEP 参数指定回滚的范围

User.connection 可以用来检查当前数据库设置和连接的信息

ActiveRecord::Base.connection.current_database 获取当前连接的数据库

ActiveRecord::Migrator.current_version 查看当前的版本

在 Rails Console 或者 Runner 中执行 SQL 语句，可以使用 ActiveRecord::Migration.execute("SQL")

参考文章： How to change all columns' and tables' collation to 'utf8_bin' in MySQL

ActiveRecord Enum 实战总结

grantbb — Tue, 07 Mar 2017 13:58:13 +0800

基本使用方法

案例说明：给已经存在的 Company 增加一个 size 属性，属性包括 large, medium, small 三个选项

从 Rails4.1 开始，可以通过 ActiveRecord::Enum 来快速实现这样的功能

class Company < ActiveRecord::Base
  enum size: [:large, :medium, :small]
end

定义了 enum 后，Rails 会自动产生下面这些方法

Company.sizes
# => {"large"=>0, "medium"=>1, "small"=>2}

# Scope methods
Company.large
Company.medium
Company.small

# Query methods
company.large?
company.medium?

# Action methods
company.large!
company.small!

Migration

enum 的实现是基于该字段是一个 integer 类型的。所以添加这个新的字段我们需要下面的 migration

class AddSizeToCompanies < ActiveRecord::Migration
  def change
    add_column :companies, :size, :integer, null: false, default: 0
    add_index  :companies, :size
  end
end

赋值操作

通过上面 Company.sizes 方法，我们看到 Rails 默认是从 0 开始对应的。所以上面的 migration 中默认值是 0。当新建一个 Company 时，默认 company 的 size 是 large

company = Company.new
company.size # => "large"

# 多种赋值操作
company.size = :medium
company.medium? # => true

company.size = 2
company.small? # => true

company.large = 'large'
company.large? # => true

enum 会自动添加一些验证，如果给 size 属性赋错误的值，Rails 会抛出异常

company.size = 5
# => ArgumentError: 5 is not a valid billing_category
company.size = :bala
# => ArgumentError: 'bala' is not a valid billing_category

Form 下拉菜单的填充

当在前端的 Form 中填充到下拉列表中，可以这样做

f.input :size, collection: Company.sizes.keys.map {|s| [s.titleize, s]}, prompt: "Select a size"

需要注意的地方：

由于存到数据库的仍然是 number，所以如果有别的应用也使用同样的数据库，那么该应用需要知道对应关系。

Rails4.1 及之后的版本中，由于 enum 会自动产生一些方法，所以要特别注意选项的命名问题，尽量用明确的命名。另外如果你还需要不同的属性，拥有相同的选项，那么你可以考虑这个 gem activerecord-enum-without-methods

同时在 Rails5 中，就可以使用_prefix和_postfix选项来避免相应的问题。·

更好的 Migration 方法

上面的 migration 方法对于产品环境已经有数据的情况下，可能会产生问题。

对于 Mysql 数据库，新加字段的时候对于已有的记录，mysql 会自动设置 NOT NULL 的已有记录为 default 但是对于 postgreSQL 就会出现下面的错误：

PG::NotNullViolation: ERROR: column "size" contains null values

这时可以先add_column添加字段，不要加 NOT NULL 的限制，然后更新已有数据，然后再通过change_column_null来添加 NOT NULL 限制。

找工作分享：顺利通过 Code Test 的 Checklist

grantbb — Mon, 17 Oct 2016 15:36:12 +0800

最近在找新的工作，澳洲这里几乎所有招 Ruby 工程师的公司都会要求你先做一个 Code Test。就是给你一个需求，用代码实现。 Code Test 通过后，才会进入面对面的面试，这其中还会有Pair Programming，所以一定要自己好好实践。下面是我总结的一些经验：

需求

要很好的理解需求，不要忽略一些细节
不要忘记一些非功能性的需求（比如要提供 github 地址，或者发送 zip 包）

面向对象设计

要符合一些基本的 OOD 的原则，比如Single Responsibility Principle, Open Close Principle
充分利用语言的特性，设计好类，接口以及抽象和继承的层次
使用常用的设计模式：Factory Pattern，Template Pattern，Observer Pattern，Command Pattern，Null Ojbect
设想一两个需求变更的场景，验证自己的代码能够很容易的扩展

系统和架构的设计

尽量采用 MVC 分层架构模式，有Data Model，Business Model，Controller， Display/Runner Class

异常的处理

自定义异常，然后做好异常的处理
提供友好的错误的提示

Test, Test, Test

尽可能采用 TDD，有清楚的 commits，体现代码的更新过程
每个测试尽量保证一个 assertion
保证足够高的测试覆盖率，100% 是可以有的，可以使用simplecov来帮助
要有集成测试，有正常的流程测试和非正常的流程测试
一定要测试好各种 edge cases
提供易用的rake tasks，方便运行相关的测试，比如单元测试，集成测试等

良好的接口设计

非常容易安装和执行，减少需要的依赖（比如尽量少的 gems，Ruby 版本）
有很好的命令行接口和帮助说明
要有一份README，说明如何安装和使用

注意代码质量和规范：

按照产品级别的代码要求自己
采用Rubocop进行质量检查
不要遗留任何的TODO
方法尽可能短小，不要超过 5 行

最后祝所有找工作的朋友好运！

干货分享：通过 Spree 开源代码学 Ruby 和 Rails

grantbb — Thu, 29 Sep 2016 08:38:39 +0800

最近在做Spree的定制开发，翻看其中的代码，发现其中有下面这么一段代码信息量是非常的大。所以就想通过这一小段代码来好好学习一下相关的 Ruby 知识。

# spree/api/lib/spree/api/engine.rb

def self.activate
  Dir.glob(File.join(File.dirname(__FILE__), "../../../app/**/*_decorator*.rb")) do |c|
    Rails.configuration.cache_classes ? require(c) : load(c)
  end
end

config.to_prepare &method(:activate).to_proc

就是这样的一段代码却包含了大量的 Ruby 和 Rails 的知识。其中最后一行config.to_prepare &method(:activate).to_proc 是本文重点解释的对象，接下来我们就一个一个来学习。

self.active

self.activate方法其实不难理解，这是一个类方法，会在引入 Spree 的应用中查找app目录下面文件名中带有_decorator的文件，这些文件都是用来定制扩展 Spree 功能的文件。在这里，找到后会判断是否设置了Rails.configuration.cache_classes这个选项，一般在开发环境中，该选项是 false，这样当你修改代码后 Rails 会自动 reload 相关的文件。而在产品环境中，该选项为 true，因为我们不会在产品环境修改代码让 Rails 自动 reload。

后面require和load的最重要的区别就是，require如果发现该文件已经加载过后就不会重新载入，而load不管之前是否已经载入都会加载该文件。

重点来了，让我们看看下面这行信息量巨大的代码吧。一眼就看明白的同学，请自行绕过！

config.to_prepare &method(:activate).to_proc

method(:activate)

method方法来自于Object，会在当前的实例 (上面的例子就是 self) 上查找通过参数指定的方法。找到后返回一个Method的实例，这个 Method 的对象就是一个封装了方法所属的对象以及该对象的实例变量的闭包。

method(:activate).to_proc

接下来就是调用Method对象的to_proc方法，产生一个对应的Proc对象。

&method(:activate).to_proc

在Proc对象前面加上&符号，作为参数传递，相当于给方法传递了一个block，然后方法内部通过yield调用block，例如：

def to_prepare
  yield if block_given?
  puts 'Done prepare!'
end

to_prepare(&proc)

相反，如果在接收的block参数前面加上&符号，那就相当于给方法传递了一个Proc的对象，然后方法内部通过proc.call来调用

def config(&block)
  block.call
  puts 'done config!'
end

config do
  puts 'I am block!'
end

config.to_prepare

这是来自 Rails 配置里面功能，该配置是全局性的，会在所有的 initializers 运行之后运行。很重要的一点是，该配置中的代码，在 production 和 test 环境中默认只会执行一次，而在开发环境 dev 中，会在每次修改文件，重新发出请求时，Rails 完成 reload，在实际进行请求处理之前执行这段代码。（好绕的流程）

所以，你会看到上面的代码就是来重新加载一些定制 Spree 功能的代码。

在 Rails 中你还可以手动调用ActionDispatch::Reloader.to_prepare来实现同样地功能。

另外还有一个与之对应的ActionDispatch::Reloader.to_cleanup,区别是该callback会在请求处理完成后执行。

上面提到开发环境的不同，主要是受到config.cache_classes配置的控制。开发环境 dev 下，该属性为false，所以 Rails 会发现有文件修改后，自动 realod。

实例

介绍完这些基本的知识点后，你可能会觉得还是有点糊涂，为什么 Spree 中要这么做呢？

这种做法其实在 Ruby 的世界是一种常见的用法，主要就是利用闭包的特点，把相关的逻辑更好的组织和封装。关于这一点上面 Spree 的例子不是很完美。

下面有给出一段利用闭包中封装的实例变量的例子。

class MethodTest
  class << self
    attr_accessor :root_path

    def activate
      puts @root_path
      puts helper
    end

    def helper
      "I am helper method. #{@root_path}"
    end
  end
end


def to_prepare
  yield if block_given?
  puts 'Done prepare!'
end

MethodTest.root_path = '/root'
to_prepare &MethodTest.method(:activate).to_proc

看完后，有学到新东西吗？Yes！那就点个💖呗。谢谢

理解 Rails 5 中 Controller 和 Integration 测试

grantbb — Sun, 07 Aug 2016 12:44:30 +0800

这篇文章首先介绍 Rails5 中 controller 测试的变化，然后通过类图来分析 Rails5 中的IntegrationTest相关的类组织结构。通过理解相关的类和模块的关系来帮助我们写出更好的测试。

在之前的文章minitest + capybara 测试基于 devise 的用户注册中，也是通过创建继承自ActionDispatch::IntegrationTest的FeatureTest类，然后引入 Capybara 的 DSL 模块，来方便我们创建其他 Feature Test 或者叫 User Acceptance Test。

第一部分：Rails5 中 controller 测试的变化

1. ActionController::TestCase 废弃掉了

在 Rails5 中 Controller 测试都是继承自ActionDispatch::IntegrationTest类，而不是之前的ActionController::TestCase。如果还想继续使用，那么可以使用这个 gem: rails-controller-testing。

2. assigns 和 assert_template 也废弃掉了

在 Rails4 的 controller 测试中assigns方法用于获得 action 中的实例变量然后进行验证，assert_template用于验证 action 最后渲染了指定的 template。

在 Rails5 中，controller 测试强调的更多的是 action 的处理结果，比如响应的状态和响应的结果。

如果你还是想使用上面这两个方法，还是可以在rails-controller-testing这个 gem 中找到他们。

3. 移走 assert_select 等方法

assert_select等验证响应的 HTML 内容的方法，已经移到单独的rails-dom-testing这个 gem 中。

所以，如果是我要验证页面的内容和样式等，还是通过 capybara 来进行精确的操作和验证。

4. 使用 URL 而不是 Action 来发送请求

在 Rails4 中，通过 action 的名字来发送请求（说实话我一直很不习惯）

class PicturesControllerTest < ActionController::TestCase

  def test_index_response
    get :index
    assert_response :success
  end
end

而在 Rails5 中，要换成 URL（多直观），否则就会抛出异常：URI::InvalidURIError: bad URI

class PicturesControllerTest < ActionDispatch::IntegrationTest

  def test_index
    get pictures_url
    assert_response :success
  end
end

5. HTTP 的请求方法中必须使用关键字参数

在 Rails5 中，HTTP 请求的方法参数必须明确指定关键字，比如 params，flash 等。这样会让代码更加清楚。请看例子：

class PicturesControllerTest < ActionDispatch::IntegrationTest

  def test_create
    post picture_url, params: { picture: { name: "sea" } }
    assert_response :success
  end
end

第二部分：理解 ActionDispatch::IntegrationTest 类和相关 module

在继承了ActionDispatch::IntegrationTest类的 Controller 测试中，我们可以使用很多方便的 helper 方法和大量用于结果验证的 assertions 方法。比如跟响应相关的：

json = response.parsed_body # 解析json格式的响应结果
assert_response :success # 验证成功的请求

还有跟路由 routing 相关的

assert_routing({ method: 'post', path: '/pictures' }, controller: 'pictures', action: 'create')
assert_recognizes({ controller: 'pictures', action: 'index' }, '/')

如果你要测试文件上传功能，Rails 提供了非常方便的方法fixture_file_upload。但是你会发现你无法在 controller 中直接使用，你需要引入ActionDispatch::TestProcess模块。有点奇怪？

所以，为了搞清楚这些 helper 方法和 assertions 的来源，也方便我们日后查询相关的文档，我会通过下面的类图来理解 IntegrationTest 这个类。

1. ActiveSupport::TestCase

首先在 Rails 中我们有ActiveSupport::TestCase类，它继承自Minitest::Test类，然后像ActionDispatch::IntegrationTest, ActionView::TestCase, ActiveJob::TestCase等我们自己的测试需要继承的测试基类，都继承自ActiveSupport::TestCase类。同时你会发现，我们自己的 model 的测试都是直接继承自ActiveSupport::TestCase类。

所以在我们的测试中，可以直接使用 minitest 提供的一些 assertions，比如常见的：

assert_equal( expected, actual, [msg] )
assert_includes( collection, obj, [msg] )
assert_instance_of( class, obj, [msg] )

由于ActiveSupport::TestCase引入了ActiveSupport::Testing::Assertions模块，所以我们可以使用非常方便的方法

assert_difference(expression, difference = 1, message = nil, &block)
# 例如
assert_difference 'Article.count' do
  post :create, params: { article: {...} }
end

assert_no_difference(expression, message = nil, &block)

另外还有两个比较有用的被引入的模块是ActiveSupport::Testing::FileFixtures和ActiveSupport::Testing::TimeHelpers。他们分别提供了访问 fixtures 下面的文件和修改测试时间的方法

file_fixture(fixture_name)

travel(duration, &block)
travel_back()
travel_to(date_or_time)

2. ActionDispatch::IntegrationTest

接下来我们再来看看IntegrationTest这个类，它首先通过引入Integration::Runner模块，从而一起引入了ActionDispatch::Assertions模块，然后 Runner 中运行测试的时候，会创建Integration::Session类的实例，Integration::Session引入了Integration::RequestHelpers模块，所以我们就可以使用像 get, post, put 等 HTTP 请求相关的方法。具体的这些请求相关的方法，参考文档： ActionDispatch::Integration::RequestHelpers

了解了发送请求的方法后，我们再来看看ActionDispatch::Assertions模块，它只是引入了另外两个重要的 module：ActionDispatch::Assertions::ResponseAssertions和 ActionDispatch::Assertions::RoutingAssertions

ResponseAssertions中提供了常用的 assert_redirected_to和assert_response方法

assert_redirected_to login_url
assert_response :redirect

RoutingAssertions中提供了上面展示过的：assert_generates， assert_recognizes， assert_routing方法，用于进行路由 Routing 相关的测试。

所以，理解了IntegrationTest的结构后，我们就知道为什么我们还需要引入ActionDispatch::TestProcess来测试文件上传，详细的如何测试 Carrierwave 的文件上传功能我会在下一篇文章中介绍。

Rails4 新项目的测试：minitest + capybara 测试基于 devise 的用户注册

grantbb — Mon, 23 Nov 2015 19:45:11 +0800

没有测试就会让写程序的开发者没有自信

这次的新项目没有想当然的选择之前一直在用 Rspec 测试框架，主要是我感觉 Rspec 里面有太多的 magic，在 helper 文件中很多 tricks, 很快相关的配置文件就非常大。这篇 Blog 说的跟我的体会很像 7 REASONS I'M STICKING WITH MINITEST AND FIXTURES IN RAILS

minitest 是 Rails4 后默认支持的测试框架，另外 rails 也提供了很多方便和强大的 assert 方法。可以参考官方文档

下面我就总结和分享一下，Rails4 新项目中 minitest 和 capybara 的集成和配置：

Gemfile

group :test do
  gem "minitest-reporters"

  gem 'capybara'
  gem "connection_pool"
  gem "launchy"
  gem "selenium-webdriver"

  gem "mocha"
  gem "poltergeist"
  gem 'phantomjs', :require => 'phantomjs/poltergeist'
end

minitest-reporters 是为了美化 minitest 的测试结果输出地，有颜色，有百分比。
mocha 是一个方便进行 mock 和 stub 的工具
其他几个都是跟 capybara 相关的工具，具体会在配置中看到。

test_helper 中添加的配置内容

require "mocha/mini_test"

require "capybara/rails"
require "capybara/poltergeist"

# 注释掉默认的driver，打开后方便切换driver测试，也可以在代码中指定current_driver
# Capybara.default_driver = :selenium
# Capybara.default_driver = :poltergeist

Capybara.javascript_driver = :poltergeist

class ActionDispatch::IntegrationTest
  # 可以在功能测试中使用capybara的DSL
  include Capybara::DSL

  # 默认的失败测试提示不是很有用，扩展后方便调试
  def assert_content(content)
    assert page.has_content?(content), %Q{Expected to found "#{content}" in: "#{page.text}"}
  end

  def refute_content(content)
    refute page.has_content?(content), %Q{Expected not to found "#{content}" in: "#{page.text}"}
  end
end

# See: https://gist.github.com/mperham/3049152
class ActiveRecord::Base
  mattr_accessor :shared_connection
  @@shared_connection = nil

  def self.connection
    @@shared_connection || ConnectionPool::Wrapper.new(:size => 1) { retrieve_connection }
  end
end
ActiveRecord::Base.shared_connection = ActiveRecord::Base.connection

测试确认邮件

如果要测试邮件的内容，内容中一般都会有链接，所以需要在 config/environments/test.rb 中加上：

config.action_mailer.default_url_options = { host: '127.0.0.1', port: 3000 }

如果使用了 delayed_job 可以在其配置中加上：

Delayed::Worker.delay_jobs = !Rails.env.test?

表明测试环境下，邮件任务都是直接发送出去的

用户注册和确认邮件测试的样例代码

在 test 目录下面，新建 features 目录，专门存放网站功能测试代码 test/features/user_authentication_test.rb

require 'test_helper'

class UserAuthenticationTest < ActionDispatch::IntegrationTest
  setup do
    ActionMailer::Base.deliveries.clear
  end

  test 'user can sign up with email and password' do
    visit new_user_registration_path

    assert_content "注册帐号"

    within '#new_user' do
      fill_in 'user[email]', with: 'test_user@gmail.com'
      fill_in 'user[password]', with: 'abcd1234'

      click_button '创建新帐号'
    end

    assert_equal sign_up_success_path, page.current_path

    assert_content "test_user@gmail.com"

    test_confirm_email
  end

  private

  def test_confirm_email
    assert_not ActionMailer::Base.deliveries.empty?

    cf_email = ActionMailer::Base.deliveries.last

    assert_equal ["support@guangchuan.com"], cf_email.from
    assert_equal ['test_user@gmail.com'], cf_email.to
    assert_equal '确认信息', cf_email.subject
    assert_match /Confirm my account/, cf_email.body.to_s
  end
end

所以可以看到用 minitest 写的代码都非常直接，都是纯 ruby 代码。等代码增多后，可以按照 ruby 的方式来组织，重用和重构。

原文链接 Rails4 新项目的测试：minitest + capybara 测试基于 devise 的用户注册

Rails 4 新项目的选择 2：前端框架 Simple_form 后台任务搜索和用户认证

grantbb — Sun, 08 Nov 2015 19:54:16 +0800

Rails 的世界各种开源的优秀解决方案非常多，项目开始的时候比较痛苦地就是要根据自己的原则和项目的特点来做出正确的选择。

前端开发框架的选择

原本打算在新的项目中开始使用 ES6，然后前端的开发框架选择容易上手的，轻量级的vue.js。由于 Vue.js 只支持 IE9 以及以上的浏览器，考虑到新项目是面向国内用户的产品，用户中还是有很大一部分的 IE8，以及以下的浏览器用户。所以，最后还是决定使用 Jquery+knockout.js这样的组合。

通过在论坛里面帖子前端框架选择的一个现实的问题评论了解到。jquery 也有支持双向绑定的 lib： jquerymy.js 还有就是在这种情况下，如果要做 SPA 的话，可以使用backbone.js，兼容性也是很好的。

放弃 Simple-form

不再使用 simple-form，主要是感觉它提供的一些功能对现在的项目帮助不大，还有就是 simple form 的 wrapper 定制比较麻烦，也会把页面代码弄得很臃肿。在这种前提下还是使用 rails 自带的 form_for 就可以了。原则就是如果要使用的 gem 帮助不是很大，还是最优先用 Ruby 和 Rails 自带的一些方案。

表单验证

尝试使用client side validations这个 gem，这样前后端尽可能共享验证的规则，减少自己写相关 js 代码。少些代码，少制造 bug。

Rails 后台任务框架的选择：

网上已经有很多资料比较 Sidekiq，Resque 和 DelayedJob。我自己也都有简单用过。所以决定在项目开始时（流量不大）使用 DelayedJob，简单易用，不要单独安装和配置 Redis，同时使用 ActiveJob 提供的 API，这样以后迁移到 Sidekiq 或者 Resque 也就不会很麻烦。

搜索：Elasticsearch

本周也开始看一下搜索功能的实现，以前我做过几年的基于 Lucene 的搜索开发，搜索服务就准备用 elasticsearch，发现相关的 Rails 的整合方案也很多。有官方的 elasticsearch-rails，还有一个比较流行的是searchkick,看了一下感觉功能很强大，所以下周准备拿 searchkick 试试。

用户认证：Devise

这个选择主要是因为 Devise 功能强大，相关文档也很多，之前在项目中也用过。

带有美图的原文链接

Rails 4 新项目之 CSS 框架的选择：Bourbon

grantbb — Sun, 01 Nov 2015 07:10:52 +0800

我在之前的项目中使用过Bootstrap和Foundation，确实非常方便使用，把相关的 gem 放到项目中之后，然后再到网站上找到一些 HTML 和 CSS 的例子，基本能够满足需求，但是要说到对这两个框架有多了解，还真是谈不上，这两个都是大而全的东西，在 Rails 中基本上都是一股脑全部引入，然后就只管用，确实省心。

但是时间长了就发现，用这两个框架写出来的页面代码还是非常啰嗦，易读性和可维护性随着项目的变大越来越差。

之前还有一个项目用到了Compass，Compass中也是包含了很多内容，我个人一直比较喜欢简单，轻量的东西，所以看到这种庞大的库就有点害怕。

然后我就想有没有其他选择呢？后来，在一个开源项目Hours中就发现了Bourbon，然后又是Neat，还有Bitters和Refills，一开始一下看到四个东西，感觉摸不清思路，都不知道是干什么的。后来，读了几篇文章后，就清楚了Bourbon整个技术栈的理念。就是把像Bootstrap这种大而全的框架，清楚地拆分成四个小的工具库，然后可以组合在一起使用，也可以根据需要来选择使用。

下面简单介绍一下四个工具：

Bourbon: 简单的轻量级的Sass Maxin库
Neat: 一个轻量级的语义化的页面网格框架
Bitters: 脚手架 (scaffold) 样式，变量的定义，方便快速开始 Bourbon 的项目
Refills: 基于以上三个的一些实用的组件库

另外看到Bourbon是thoughtbot出品的，我相信这些工具一定在实际项目中得到了验证。我一直以来都很喜欢thoughtbot开发一些 gems，非常实用，而且轻量，比如clearance等。

其中下面这两篇文章说服了我：

5 Reasons We Chose Bourbon/Neat Over Foundation or Bootstrap

Why I prefer Bourbon over Bootstrap

最吸引我得就是使用Bourbon和Neat，可以写出非常易读，易懂的语义化的HTML

特别是当我们使用Haml或者Slim这样的模板语言后，在模板中如果都是一些语义化的CSS class，代码看起来就非常直观。

比如：用 Bootstrap 会这样写 (如果再加上一些响应式的样式就更加冗长)：

.container
  .row
    .col-md-6 /* some content */
    .col-md-6 /* some content */

使用 Borbon 可能会是这样，非常清晰，直观：

.news
  .hot-news
  .latest-news

接下来简单说一下我是如何在新的 Rails 项目中使用的。

1. 基本安装：

这里没有什么特别需要说明的，大家只要按照官方 github 上的文档说明，很容易搞定。

2. 使用 normalize.css

在 Bootstrap 中默认是集成了normalize.css，所以我们不用单独引入，在 Bourbon 栈中默认是没有的，需要我们单独引用。这里使用 normalize-rails 这个 gem 就可以了。

gem "normalize-rails"

3. 使用`autoprefixer`

Bourbon 中有一大块功能是关于vendor prefixes的。需要开发者自己主动地去使用封装好的一些 Sass 的 mixin，这个对于我一个后端出身的号称全栈的开发者要求有些高了。同时 autoprefixer 的处理方式就是非常的傻瓜式，开发者自己不要管 vendor prefixes，尽管写标准的 CSS，剩下的 autoprefixer 自动搞定。 Bourbon 的开发者也同意这一点，所以在Bourbon5.0中，关于 vendor prefixes 的部分也将会删除。所以，我们只需要使用 gem "autoprefixer-rails"就可以了。

gem "autoprefixer-rails"

如果想了解和深入学习 Bourbon 相关的技术，可以到官方网站上查看详细的使用文档。

这里还有一个 youtube 视频系列，可以帮大家系统学习： Awesome CSS with Bourbon, Neat, Bitters & Refills! 国内的朋友记得翻墙哦。

BTW：随着项目的进行，我会逐步写出对于一些架构和工具选择总结的文章。

原文链接：BigBing 技术博客 - Rails4 新项目之 CSS 框架的选择：Bourbon

分享：产品环境 Nginx + Unicorn + Eye 的 Rails 应用配置

grantbb — Mon, 22 Dec 2014 14:37:42 +0800

最近整理了一下个人项目产品环境的配置，加了一些注释，分享出来希望对大家有用。欢迎大家提改进建议。

Nginx 的配置 https://gist.github.com/bingxie/a0039781a52ad908b0a2

Unicorn 的配置 https://gist.github.com/bingxie/0da00d3a22905cab30b7

Eye 配置 https://gist.github.com/bingxie/4684a7455edebbaa5a34

分享 - 免费的 Rails 安全相关的 screencasts

grantbb — Wed, 10 Dec 2014 07:30:15 +0800

分享给喜欢研究和学习安全相关的技术的同学

https://seccasts.com/mror

grantbb (奔跑的大兵)

Rails5.2 用 Wepacker 安装和使用 Materialize CSS

2019 RubyConf AU 精彩内容回顾

大会总结

The Case Of The Missing Method - A Ruby Mystery Story

How to hijack, proxy and smuggle sockets with Rack/Ruby

Taming Monoliths Without Microservices

Representations Count

A Branch in Time (a story about revision histories)

Views, from the top

Learn to make the point: data visualisation strategy

Building APIs you want to hug with GraphQL

What the hell is a JRuby?

It's Down! Simulating Incidents in Production

Mechanically Confident

What were they thinking?"

使用 Rails Migration 转换 MySQL 数据库和表的字符集总结

MySQL Character Set 基础知识

Server Level:

Database Level:

修改数据库 level 的 character set 和 collation

Table Level:

Column Level:

Application Connection Level:

查看数据库不同级别的元数据的设置的语句，比如：character set

ConvertDatabaseCharacterSetAndCollationToUtf8 Migration

ConvertTablesCharacterSetAndCollationToUtf8 Migration

Rails Migration tips

ActiveRecord Enum 实战总结

基本使用方法

Migration

赋值操作

Form 下拉菜单的填充

需要注意的地方：

更好的 Migration 方法

找工作分享： 顺利通过 Code Test 的 Checklist

需求

面向对象设计

系统和架构的设计

异常的处理

Test, Test, Test

良好的接口设计

注意代码质量和规范：

干货分享：通过 Spree 开源代码学 Ruby 和 Rails

self.active

method(:activate)

method(:activate).to_proc

&method(:activate).to_proc

config.to_prepare

实例

理解 Rails 5 中 Controller 和 Integration 测试

第一部分：Rails5 中 controller 测试的变化

1. ActionController::TestCase 废弃掉了

2. assigns 和 assert_template 也废弃掉了

3. 移走 assert_select 等方法

4. 使用 URL 而不是 Action 来发送请求

5. HTTP 的请求方法中必须使用关键字参数

第二部分：理解 ActionDispatch::IntegrationTest 类和相关 module

1. ActiveSupport::TestCase

2. ActionDispatch::IntegrationTest

Rails4 新项目的测试：minitest + capybara 测试基于 devise 的用户注册

Gemfile

test_helper 中添加的配置内容

测试确认邮件

用户注册和确认邮件测试的样例代码

Rails 4 新项目的选择 2：前端框架 Simple_form 后台任务 搜索和用户认证

前端开发框架的选择

放弃 Simple-form

表单验证

Rails 后台任务框架的选择：

搜索：Elasticsearch

用户认证：Devise

Rails 4 新项目之 CSS 框架的选择：Bourbon

1. 基本安装：

2. 使用 normalize.css

3. 使用autoprefixer

分享：产品环境 Nginx + Unicorn + Eye 的 Rails 应用配置

分享 - 免费的 Rails 安全相关的 screencasts

找工作分享：顺利通过 Code Test 的 Checklist

Rails 4 新项目的选择 2：前端框架 Simple_form 后台任务搜索和用户认证

3. 使用`autoprefixer`