https://github.com/splattael/minitest-around

Around block for minitest.
https://github.com/splattael/minitest-around

around minitest ruby spec testing

Last synced: 12 days ago
JSON representation

Around block for minitest.

• Host: GitHub
• URL: https://github.com/splattael/minitest-around
• Owner: splattael
• License: mit
• Created: 2011-12-07T01:23:18.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2018-12-02T12:06:02.000Z (about 6 years ago)
• Last Synced: 2024-12-10T07:11:18.981Z (21 days ago)
• Topics: around, minitest, ruby, spec, testing
• Language: Gherkin
• Homepage:
• Size: 86.9 KB
• Stars: 41
• Watchers: 3
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[github]: https://github.com/splattael/minitest-around

[doc]: http://rubydoc.info/github/splattael/minitest-around/master/file/README.md

[gem]: https://rubygems.org/gems/minitest-around

[travis]: https://travis-ci.org/splattael/minitest-around

# minitest-around

[![Travis](https://img.shields.io/travis/splattael/minitest-around.svg?branch=master)][travis]

[![Gem Version](https://img.shields.io/gem/v/minitest-around.svg)][gem]

[Gem][gem] |

[Source][github]

Around block for minitest 5.X.

Alternative for setup/teardown dance.

## Installation

```Bash

gem install minitest-around

```

## Usage

### Unit tests

```Ruby

require 'minitest/autorun'

require 'minitest/around/unit'

require 'thread'

class MutexTest < Minitest::Test

  def around(&block)

    Mutex.new.synchronize(&block)

  end

  def test_synchronized

    # ...

  end

end

```

### Spec

```Ruby

require 'minitest/autorun'

require 'minitest/around/spec'

require 'tmpdir'

describe "inside new directory" do

  around do |test|

    Dir.mktmpdir do |dir|

      @dir = dir

      Dir.chdir(dir) do

        test.call

      end

    end

  end

  it "is in new directory" do

    assert_equal @dir, Dir.pwd.sub("/private/var/", "/var/")

  end

end

```

## Multiple before/after blocks

Minitest-around also enables the use of multiple before/after blocks, which normally don't work in minitest.

## Caveats

 - Test bodies won't be run if you don't test.call inside +around+.

 - around runs inside a Fiber, so use `Thread.get_thread_local` / `set_thread_local` instead of `Thread.current.[]`

### Minitest 5.X only

`minitest-around` currently supports only `minitest` 5.X.

Please see the [mt4](https://github.com/splattael/minitest-around/tree/mt4) branch

for `minitest` 4.7.X support.

## License

[MIT License](http://www.opensource.org/licenses/mit-license.php)

## Authors

* [Peter Leitzen](https://github.com/splattael)

## [Contributors](https://github.com/splattael/minitest-around/graphs/contributors)

* [Michael Grosser](https://github.com/grosser)

* [Hendra Uzia](https://github.com/hendrauzia)

* [Rick Martínez](https://github.com/rickmzp)

* [Philip Nelson](https://github.com/pnelson)

## Contributing

1. Fork it

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Added some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create new Pull Request

## Test

```Bash

bundle exec rake test

```

## Release

```Bash

bundle exec rake bump:{patch|minor|major}

bundle exec rake release

```