Sha256: 4a2713901989633f8a32a7138460e810ebff0a4a3e6d49c69e78a6f2befc68fa

Contents?: true

Size: 1.59 KB

Versions: 8

Compression:

Stored size: 1.59 KB

Contents

# Contributing

This is the issue tracker for Opal. If you have a more general question about
using opal (or related libraries) then use the
[google group for opal](http://groups.google.com/forum/#!forum/opalrb), or the
[#opal](http://webchat.freenode.net/?channels=opal) irc channel on
FreeNode.

## Contributing

* Before opening a new issue, search for previous discussions including closed
ones. At comments there if a similar issue is found.

* Before sending pull requests make sure all tests run and pass (see below).

* Make sure to use a similar coding style to the rest of the code base. In ruby
and javascript code we use 2 spaces (no tabs).

## Quick Start

Clone repo:

```
$ git clone git://github.com/opal/opal.git
```

Get dependencies:

```
$ bundle
```

## Running Tests

### Runtime

Some opal specific tests are found inside `spec/`, but the majority of our
runtime tests now come from rubyspec. Rubyspec is included as a git submodule.
To get our latest referenced checkout, just run:

```
$ git submodule update --init
```

You need phantomjs installed to run tests. To build opal, its dependencies
and all specs, run:

```
$ bundle exec rake mspec
```

You can alternatively run tests in a browser using:

```
$ rackup
```

And then opening `http://127.0.0.1:9292` in a web browser.

### Gem/lib tests

We also include some tests for running under your standard ruby implementation
which are in `mri_spec/`. To run tests tests using rake, use:

```
$ bundle exec rake mri_spec
```

### All tests

To run all the tests together (which you should do while contributing), run:

```
$ bundle exec rake
```

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
opal-0.6.3 CONTRIBUTING.md
opal-0.6.2 CONTRIBUTING.md
opal-0.6.1 CONTRIBUTING.md
opal-0.6.0 CONTRIBUTING.md
opal-0.5.5 CONTRIBUTING.md
opal-0.5.4 CONTRIBUTING.md
opal-0.5.2 CONTRIBUTING.md
opal-0.5.0 CONTRIBUTING.md