Add support for multiple examples per code object

[quartzmo]

This PR adds support for writing specific before/after hooks when there are multiple examples per code object (example from google-cloud-ruby) by increasing the detail in the identifier passed to register_hooks.

Some notes:

1. The new identifier is the spec method name generated by Minitest::Spec. This makes it very simple to match hooks to failing tests, all you need to do is copy the name from the Minitest output.
2. Because hooks are matched by testing include? on the hook name, backwards-compatibility is maintained for less-specific hook names (all Cucumber tests pass.)
3. As was the case before, less-specific hook names will also be matched, so hook order is important.

I'm happy to make any edits/changes, just let me know!

/cc @blowmage

[quartzmo]

The failing Cucumber test is due to a change in Minitest: "Add encoding information when test fails." minitest/minitest#620. Let me know if you want me to update the Cucumber expectation in this PR.

[p0deje]

The new identifier is the spec method name generated by Minitest::Spec. This makes it very simple to match hooks to failing tests, all you need to do is copy the name from the Minitest output.

Maybe it's better to just use example name in this case?

[p0deje]

What do you think if we use a different notation, e.g. #flag@Second example for flag? I feel like #test_0001_ in is implementation detail provided by Minitest.

I'm good to merge this anyways if you don't like the proposed changes.

[p0deje]

The failing Cucumber test is due to a change in Minitest: "Add encoding information when test fails." minitest/minitest#620. Let me know if you want me to update the Cucumber expectation in this PR.

That would be great!

[p0deje]

Thanks for the PR! I'm definitely ready to merge it, but I'll wait until you answer to my comments above.

[quartzmo]

Great suggestion for the notation, it is much cleaner. (Should I also add an example to the README?)

I'll update the PR later today with both changes.

[p0deje]

I'll add new hooks to README, create CHANGELOG and release new version today. Thanks again for PR!

[p0deje]

Released in 0.1.6

[blowmage]

👏🏻

[quartzmo]

@p0deje Thank you!

googleapis/google-cloud-ruby#901 is the beginning of our effort to test all of the google-cloud doc examples (current count: 772) with yard-doctest. Thank you very much for creating and maintaining it!

[p0deje]

@quartzmo Thank you for using it! It's really cool to build something that is used by Google.