{"__v":32,"_id":"55a4a6f7e10ba50d00b40bbf","category":{"__v":1,"_id":"56cf5c8d336aa60b0086a40d","pages":["56cf5ea2287eb20b009f9f2e"],"project":"559b65bd8b04e90d00702d54","version":"559b65bd8b04e90d00702d57","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-02-25T19:57:01.905Z","from_sync":false,"order":2,"slug":"advanced","title":"Advanced"},"parentDoc":null,"project":"559b65bd8b04e90d00702d54","user":"559b658d8b04e90d00702d52","version":{"__v":6,"_id":"559b65bd8b04e90d00702d57","project":"559b65bd8b04e90d00702d54","createdAt":"2015-07-07T05:38:05.890Z","releaseDate":"2015-07-07T05:38:05.890Z","categories":["559b65be8b04e90d00702d58","55a46e7468c7e20d0036d4d1","55a4971be6c2470d002a6483","55a4a690e10ba50d00b40bba","55a4bcf31a5f991700a94066","56cf5c8d336aa60b0086a40d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":["55c883a02980231700f6bb8c","561f1bc62681910d0004d693","561f1c10cfc3610d0056717a","57155de06f0f900e00091160","57bc9898ae44a4190069986e"],"next":{"pages":[],"description":""},"createdAt":"2015-07-14T06:06:47.767Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Chimp and the integrated packages are all configurable through the command-line. Although Chimp is somewhat opinionated, it tries to be as flexible as possible for advanced users. \n\nSee the [default Chimp configuration](https://github.com/xolvio/chimp/blob/master/src/bin/default.js) file for the available options. You can provide any of the options in that file via the command-line also by prefixing the listed option with `--`.\n\n## Using a Configuration File\nIf you would like to use a configuration file, you can simply place a `chimp.js` file in the directory that you run Chimp from.\n\nYou can also name your configuration file, but be sure to include the word `chimp` inside it, and pass it in as the first parameter after the test runner, for example:\n\n```bash\nchimp config/chimp-ci.js \n```\n\n#### Using Meteor?\nIf you are using Meteor, you will not be able to put the configuration file in the root directory of your project as Meteor will compile and run it, which results in a `module.exports` is not defined error.\n\nYou can get around Create a directory such as `.config` inside your Meteor directory and you can place a configuration file in there, like this:\n\n```\n<meteor app>\n├── .config\n    └── chimp.js\n```\n\nThen you can run Chimp with:\n\n```bash\nchimp .config/chimp.js\n```\n\nBe sure the config file is the first parameter you pass to Chimp that the config filename contains the word `chimp`.\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You need to pass arguments always with an equal sign like `--tags=:::at:::focus` to Chimp.\",\n  \"title\": \"Chimp argument passing syntax\"\n}\n[/block]\nFor Cucumber pass-through options, see here:\n* See [Cucumber.js CLI documentation](https://github.com/cucumber/cucumber-js#cli)\n* See [Cucumber.js options source code](https://github.com/cucumber/cucumber-js/blob/v0.9.2/lib/cucumber/cli.js#L24-L43)\n\n\n---\n\n<a href=\"http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Footer&utm_campaign=QFLaunch\"><img src=\"https://files.readme.io/764e495-qualityfasterbook-commas.small.png\" width=\"200\" align=\"right\" /></a>\n##Learn the Fundamentals of Testing, Specifications and Become a Chimp Ninja!\n[Checkout our new book](http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Footer&utm_campaign=QFLaunch) where you can learn how to can use Chimp across the Full Stack from React to Node.JS, Mocha, Meteor and more.\n\n\n**[Quality, Faster.](http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Footer&utm_campaign=QFLaunch)** By Sam Hatoum, creator of Chimp.","excerpt":"For the advanced folk","slug":"command-line-options","type":"basic","title":"Configuration"}

Configuration

For the advanced folk

Chimp and the integrated packages are all configurable through the command-line. Although Chimp is somewhat opinionated, it tries to be as flexible as possible for advanced users. See the [default Chimp configuration](https://github.com/xolvio/chimp/blob/master/src/bin/default.js) file for the available options. You can provide any of the options in that file via the command-line also by prefixing the listed option with `--`. ## Using a Configuration File If you would like to use a configuration file, you can simply place a `chimp.js` file in the directory that you run Chimp from. You can also name your configuration file, but be sure to include the word `chimp` inside it, and pass it in as the first parameter after the test runner, for example: ```bash chimp config/chimp-ci.js ``` #### Using Meteor? If you are using Meteor, you will not be able to put the configuration file in the root directory of your project as Meteor will compile and run it, which results in a `module.exports` is not defined error. You can get around Create a directory such as `.config` inside your Meteor directory and you can place a configuration file in there, like this: ``` <meteor app> ├── .config     └── chimp.js ``` Then you can run Chimp with: ```bash chimp .config/chimp.js ``` Be sure the config file is the first parameter you pass to Chimp that the config filename contains the word `chimp`. [block:callout] { "type": "info", "body": "You need to pass arguments always with an equal sign like `--tags=@focus` to Chimp.", "title": "Chimp argument passing syntax" } [/block] For Cucumber pass-through options, see here: * See [Cucumber.js CLI documentation](https://github.com/cucumber/cucumber-js#cli) * See [Cucumber.js options source code](https://github.com/cucumber/cucumber-js/blob/v0.9.2/lib/cucumber/cli.js#L24-L43) --- <a href="http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Footer&utm_campaign=QFLaunch"><img src="https://files.readme.io/764e495-qualityfasterbook-commas.small.png" width="200" align="right" /></a> ##Learn the Fundamentals of Testing, Specifications and Become a Chimp Ninja! [Checkout our new book](http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Footer&utm_campaign=QFLaunch) where you can learn how to can use Chimp across the Full Stack from React to Node.JS, Mocha, Meteor and more. **[Quality, Faster.](http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Footer&utm_campaign=QFLaunch)** By Sam Hatoum, creator of Chimp.