github
/
ruby
зеркало из https://github.com/github/ruby.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
ruby/spec/mspec
История
KJ Tsanaktsidis 33290896dc Disable NSS modules when using the leakchecker 
The leakchecker will report leaked file descriptors when tests do things
like access `Etc.getgrgid`, for example, if NSS modules (like `sss`)
handle these lookups by connecting to a daemon like `sssd` and leave the
connection open.

To address this, we can call glibc's `__nss_configure_lookup` to
override NSS modules configured in /etc/nsswitch.conf and only use
ordinary file/DNS lookups.

(This is a cherry-pick of a patch applied to ruby/mspec here:
https://github.com/ruby/mspec/pull/62)
 		2024-01-22 13:44:52 +11:00
..
bin Update to ruby/mspec@bd47c2a 2022-03-03 14:43:11 +01:00
lib Disable NSS modules when using the leakchecker 2024-01-22 13:44:52 +11:00
spec Update to ruby/mspec@3cf2d16 2023-06-26 15:55:09 +02:00
tool Update to ruby/mspec@d03ad9c 2023-10-30 16:44:52 +01:00
.rspec Update to ruby/mspec@0091e8a 2021-06-02 14:34:01 +02:00
Gemfile Update to ruby/mspec@d1adf59 2021-03-27 13:02:38 +01:00
Gemfile.lock Update to ruby/mspec@d1adf59 2021-03-27 13:02:38 +01:00
LICENSE
…
README.md Update to ruby/mspec@9542a88 2021-07-29 22:11:19 +02:00
Rakefile
…

README.md

Overview

MSpec is a specialized framework that is syntax-compatible with RSpec 2 for basic things like describe, it blocks and before, after actions. MSpec contains additional features that assist in writing specs for Ruby implementations in ruby/spec.

MSpec attempts to use the simplest Ruby language features so that beginning Ruby implementations can run the Ruby specs. For example, no file from the standard library or RubyGems is necessary to run MSpec.

MSpec is not intended as a replacement for RSpec. MSpec attempts to provide a subset of RSpec's features in some cases and a superset in others. It does not provide all the matchers, for instance.

However, MSpec provides several extensions to facilitate writing the Ruby specs in a manner compatible with multiple Ruby implementations.

  1. MSpec offers a set of guards to control execution of the specs. These guards not only enable or disable execution but also annotate the specs with additional information about why they are run or not run.

  2. MSpec provides a different shared spec implementation specifically designed to ease writing specs for the numerous aliased methods in Ruby.

  3. MSpec provides various helper methods to simplify some specs, for example, creating temporary file names.

  4. MSpec has several specialized runner scripts that includes a configuration facility with a default project file and user-specific overrides.

  5. MSpec support "tagging", that is excluding specs known as failing on a particular Ruby implementation, and automatically adding and removing tags while running the specs.

Requirements

MSpec requires Ruby 2.6 or more recent.

Bundler

A Gemfile is provided. Use Bundler to install gem dependencies. To install Bundler, run the following:

gem install bundler

To install the gem dependencies with Bundler, run the following:

ruby -S bundle install

Development

Use RSpec to run the MSpec specs. There are no plans currently to make the MSpec specs runnable by MSpec: https://github.com/ruby/mspec/issues/19.

After installing the gem dependencies, the specs can be run as follows:

ruby -S bundle exec rspec

To run an individual spec file, use the following example:

ruby -S bundle exec rspec spec/helpers/ruby_exe_spec.rb

Documentation

See CONTRIBUTING.md in ruby/spec for a list of matchers and how to use mspec.

Source Code

See https://github.com/ruby/mspec

License

See the LICENSE in the source code.