What's the best way to unit test protected & private methods in Ruby?
使用标准的Ruby
我敢肯定有人会说道,"你应该只测试公共方法;如果它需要单元测试,它不应该是一个受保护的或私有的方法",但我真的不想讨论这个问题。出于正当和有效的原因,我有几个受保护或私有的方法,这些私有/受保护的方法是中等复杂的,并且类中的公共方法依赖于这些受保护/私有方法正常运行,因此我需要一种方法来测试受保护/私有方法。
还有一件事......我通常将给定类的所有方法放在一个文件中,然后单元在另一个文件中测试该类。理想情况下,我希望将所有"受保护和私有方法的单元测试"功能实现到单元测试文件而不是主要源文件中,以保持主源文件尽可能简单明了。
您可以使用send方法绕过封装:
1 | myobject.send(:method_name, args) |
这是Ruby的"特性"。 :)
在Ruby 1.9开发过程中存在内部争论,认为
如果您使用RSpec,这是一种简单的方法:
1 2 3 | before(:each) do MyClass.send(:public, *MyClass.protected_instance_methods) end |
只需在测试文件中重新打开该类,然后将这些方法重新定义为公共方法。您无需重新定义方法本身的内容,只需将符号传递给
如果原始类定义如下:
1 2 3 4 5 6 7 8 | class MyClass private def foo true end end |
在您的测试文件中,只需执行以下操作:
1 2 3 4 | class MyClass public :foo end |
如果要公开更多私有方法,可以将多个符号传递给
1 | public :foo, :bar |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | --------------------------------------------------- Object#instance_eval obj.instance_eval(string [, filename [, lineno]] ) => obj obj.instance_eval {| | block } => obj ------------------------------------------------------------------------ Evaluates a string containing Ruby source code, or the given block, within the context of the receiver (obj). In order to set the context, the variable self is set to obj while the code is executing, giving the code access to obj's instance variables. In the version of instance_eval that takes a String, the optional second and third parameters supply a filename and starting line number that are used when reporting compilation errors. class Klass def initialize @secret = 99 end end k = Klass.new k.instance_eval { @secret } #=> 99 |
您可以使用它直接访问私有方法和实例变量。
您还可以考虑使用
或者,您可以修改测试对象的元类,以使私有/受保护方法仅为该对象公开。
1 2 3 4 5 6 7 8 9 10 11 | test_obj.a_private_method(...) #=> raises NoMethodError test_obj.a_protected_method(...) #=> raises NoMethodError class << test_obj public :a_private_method, :a_protected_method end test_obj.a_private_method(...) # executes test_obj.a_protected_method(...) # executes other_test_obj = test.obj.class.new other_test_obj.a_private_method(...) #=> raises NoMethodError other_test_obj.a_protected_method(...) #=> raises NoMethodError |
这将允许您调用这些方法,而不会影响该类的其他对象。
您可以在测试目录中重新打开该类,并将其公开给所有人
测试代码中的实例,但这可能会影响您对公共接口的测试。
我过去做过的一种方法是:
1 2 3 4 5 6 7 8 9 10 11 | class foo def public_method private_method end private unless 'test' == Rails.env def private_method 'private' end end |
I'm sure somebody will pipe up and
dogmatically assert that"you should
only unit test public methods; if it
needs unit testing, it shouldn't be a
protected or private method", but I'm
not really interested in debating
that.
您还可以将这些方法重构为一个新对象,其中这些方法是公共的,并在原始类中私下委托给它们。这将允许您在规范中测试没有魔法元数据的方法,同时保持它们的私密性。
I've got several methods that are
protected or private for good and
valid reasons
这些正当理由是什么?其他OOP语言可以在没有私有方法的情况下逃脱(想到smalltalk,其中私有方法仅作为约定存在)。
与@ WillSargent的响应类似,这是我在
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | describe"protected custom `validates` methods" do # Test these methods directly to avoid needing FactoryGirl.create # to trigger before_create, etc. before(:all) do @protected_methods = MyClass.protected_instance_methods MyClass.send(:public, *@protected_methods) end after(:all) do MyClass.send(:protected, *@protected_methods) @protected_methods = nil end # ...do some tests... end |
要公开所描述的类的所有受保护和私有方法,您可以将以下内容添加到spec_helper.rb,而不必触摸任何spec文件。
1 2 3 4 5 6 | RSpec.configure do |config| config.before(:each) do described_class.send(:public, *described_class.protected_instance_methods) described_class.send(:public, *described_class.private_instance_methods) end end |
我知道我迟到了,但不要测试私人方法......我想不出这样做的理由。一种可公开访问的方法是在某处使用该私有方法,测试公共方法以及可能导致使用该私有方法的各种方案。有些东西进来了,有些东西出来了。测试私有方法是一个很大的禁忌,它使得以后重构代码变得更加困难。他们是私人的有一个原因。
您可以"重新打开"该类并提供一个委托给私有类的新方法:
1 2 3 4 5 6 7 8 9 10 | class Foo private def bar; puts"Oi! how did you reach me??"; end end # and then class Foo def ah_hah; bar; end end # then Foo.new.ah_hah |
我可能倾向于使用instance_eval()。然而,在我了解instance_eval()之前,我会在单元测试文件中创建一个派生类。然后我会将私有方法设置为公开。
在下面的示例中,build_year_range方法在PublicationSearch :: ISIQuery类中是私有的。为了测试目的而派生一个新类允许我将方法设置为公共的,因此可以直接测试。同样,派生类公开了一个先前未公开的名为"result"的实例变量。
1 2 3 4 5 | # A derived class useful for testing. class MockISIQuery < PublicationSearch::ISIQuery attr_accessor :result public :build_year_range end |
在我的单元测试中,我有一个测试用例,它实例化MockISIQuery类并直接测试build_year_range()方法。
在Test :: Unit框架中可以写,
1 | MyClass.send(:public, :method_name) |
这里"method_name"是私有方法。
&虽然调用这个方法可以写,
1 | assert_equal expected, MyClass.instance.method_name(params) |
您可以使用单例方法代替obj.send。你的代码中还有3行代码
测试类,不需要更改要测试的实际代码。
1 2 3 | def obj.my_private_method_publicly (*args) my_private_method(*args) end |
在测试用例中,只要您想测试
http://mathandprogramming.blogspot.com/2010/01/ruby-testing-private-methods.html
私有方法的
要纠正上面的最佳答案:在Ruby 1.9.1中,它是发送所有消息的Object#send,以及尊重隐私的Object#public_send。
这是我使用的Class的一般补充。它比仅仅公开您正在测试的方法更多的霰弹枪,但在大多数情况下它并不重要,而且它更具可读性。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | class Class def publicize_methods saved_private_instance_methods = self.private_instance_methods self.class_eval { public *saved_private_instance_methods } begin yield ensure self.class_eval { private *saved_private_instance_methods } end end end MyClass.publicize_methods do assert_equal 10, MyClass.new.secret_private_method end |
在1.9中使用send来访问protected / private方法,因此不推荐使用。
为此:
1 2 3 | disrespect_privacy @object do |p| assert p.private_method end |
您可以在test_helper文件中实现此功能:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | class ActiveSupport::TestCase def disrespect_privacy(object_or_class, &block) # access private methods in a block raise ArgumentError, 'Block must be specified' unless block_given? yield Disrespect.new(object_or_class) end class Disrespect def initialize(object_or_class) @object = object_or_class end def method_missing(method, *args) @object.send(method, *args) end end end |