# conjure

> Parallel CasperJS runner, BDD flow, module-based tests, API helpers

Latest version **0.1.4** (published 2013-06-07) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install conjure
pnpm add conjure
yarn add conjure
bun add conjure
```

Provides the command `conjure`.

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.1.4 |
| Published | 2013-06-07 |
| First published | 2013-05-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | codeactual |
| Keywords | casper, casperjs, phantom, phantomjs, bdd, parallel, runner, helpers, wrappers, test |

## Links

- npm: https://www.npmjs.com/package/conjure
- Repository: https://github.com/codeactual/conjure
- Issues: https://github.com/codeactual/conjure/issues
- npm.io page: https://npm.io/package/conjure

## Dependencies (3)

- [commander](https://npm.io/package/commander.md) ~1.1.1
- [impulse-bin](https://npm.io/package/impulse-bin.md) ~0.1.3
- [outer-shelljs](https://npm.io/package/outer-shelljs.md) ~0.3.4

## Recent versions

- 0.1.4 (latest) — 2013-06-07
- 0.1.3 — 2013-05-24
- 0.1.2 — 2013-05-08
- 0.1.1 — 2013-05-07
- 0.1.0 — 2013-05-07

## README

# conjure

Parallel CasperJS runner, BDD flow, module-based tests, API helpers

* `describe()/it()` and hooks
* `require('relative/path/in/my/proj/module.js)`
* Bootstrap test modules with common settings and arguments
* Full access to standard CasperJS APIs
* [Helpers](docs/Conjure.md#toc_helpers) use preexisting jQuery for selectors
* Stack traces that cover `describe()/it()` and helpers
* Load test directories recursively, filter by `it()`/filename regex

[![Build Status](https://travis-ci.org/codeactual/conjure.png)](https://travis-ci.org/codeactual/conjure)

## Examples

### Basic test module

```js
module.exports = function(conjure) {
  conjure.set('initPath', '/login').set('initSel', '.login');
  conjure.test('login page', function() {
    this.describe('form', function() {
      this.it('should not auto-check "Remember Me"' , function() {
        this.conjure.selectorExists('.remember-me');
        this.conjure.selectorMissing('.remember-me:checked');
      });
    });
  });
};
```

### Stack traces

* Displayed after the standard `CasperJS` trace.
* Cover `describe()/it()` and helpers.

**After `TypeError`:**

![Trace screenshot](http://codeactual.github.io/conjure/default-trace.png)

_By default, traces are limited to logs from the most recent `it()`._

**After `TypeError` with `--full-trace`:**

![Trace screenshot](http://codeactual.github.io/conjure/full-trace.png)

**After a timeout:**

_Consecutive repeats are collapsed into a count (ex. `x 34`)._

![Timeout trace screenshot](http://codeactual.github.io/conjure/timeout-trace.png)

[More Examples](docs/examples.md)

## CLI

Basic run:

    conjure --server /path/to/myproj/http-server

> Start the server.
> Run all test scripts under `<cwd>/test` that end with `.js`.
> Kill the server.

[More Examples](docs/cli.md)

## API

### Context properties in `it()` callbacks

* `utils`: Native CasperJS module.
* `colorizer`: Native CasperjS module.
* `casper`: Native CasperJS module.
* `conjure`: Helpers described below.
* Custom properties added to `this` in subsequently executed hooks and `it()` callbacks.

### API

* [Helpers](docs/Conjure.md#toc_helpers)
* [Examples](docs/examples.md)

## Installation

### [NPM](https://npmjs.org/package/conjure)

    npm install conjure

## Tests

    npm test

[Documentation](docs/testing.md)

## License

  MIT

---
_Source: https://npm.io/package/conjure · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._