2018-03-31 02:55:55 +02:00
# Contributing to Pinafore
## Caveats
Please note that this project is _very_ beta right now, and I'm
not in a good position to accept large PRs for
big new features.
I'm making my code open-source for the sake of
transparency and because it's the right thing to do, but I'm hesitant
to start nurturing a community because of
[all that entails ](https://nolanlawson.com/2017/03/05/what-it-feels-like-to-be-an-open-source-maintainer/ ).
So I may not be very responsive to PRs or issues. Thanks for understanding.
## Development
To run a dev server with hot reloading:
npm run dev
Now it's running at `localhost:4002` .
2018-12-18 02:21:29 +01:00
**Linux users:** for file changes to work,
you'll probably want to run `export CHOKIDAR_USEPOLLING=1`
because of [this issue ](https://github.com/paulmillr/chokidar/issues/237 ).
2018-03-31 02:55:55 +02:00
## Linting
Pinafore uses [JavaScript Standard Style ](https://standardjs.com/ ).
Lint:
npm run lint
Automatically fix most linting issues:
2018-04-28 23:19:39 +02:00
npm run lint-fix
2018-03-31 02:55:55 +02:00
## Testing
2018-04-12 18:44:02 +02:00
Testing requires running Mastodon itself, meaning the [Mastodon development guide ](https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Development-guide.md ) is relevant here. In particular, you'll need a recent version of Ruby, Redis, and Postgres running.
2018-03-31 02:55:55 +02:00
Run integration tests, using headless Chrome by default:
npm test
Run tests for a particular browser:
BROWSER=chrome npm run test-browser
BROWSER=chrome:headless npm run test-browser
BROWSER=firefox npm run test-browser
BROWSER=firefox:headless npm run test-browser
BROWSER=safari npm run test-browser
BROWSER=edge npm run test-browser
## Testing in development mode
In separate terminals:
1\. Run a Mastodon dev server:
npm run run-mastodon
2\. Run a Pinafore dev server:
npm run dev
3\. Run a debuggable TestCafé instance:
npx testcafe --hostname localhost --skip-js-errors --debug-mode firefox tests/spec
If you want to export the current data in the Mastodon instance as canned data,
so that it can be loaded later, run:
2018-04-12 05:33:34 +02:00
npm run backup-mastodon-data
## Writing tests
Tests use [TestCafé ](https://devexpress.github.io/testcafe/ ). The tests have a naming convention:
* `0xx-test-name.js` : tests that don't modify the Mastodon database (post, delete, follow, etc.)
* `1xx-test-name.js` : tests that do modify the Mastodon database
In principle the `0-` tests don't have to worry about
2018-04-12 18:44:02 +02:00
clobbering each other, whereas the `1-` ones do.
2018-05-02 02:00:34 +02:00
## Debugging Webpack
The Webpack Bundle Analyzer `report.html` and `stats.json` are available publicly via e.g.:
- [dev.pinafore.social/report.html ](https://dev.pinafore.social/report.html )
- [dev.pinafore.social/stats.json ](https://dev.pinafore.social/stats.json )
2018-06-08 00:26:47 +02:00
This is also available locally after `npm run build` at `.sapper/client/report.html` .
## Updating Mastodon used for testing
1. Run `rm -fr mastodon` to clear out all Mastodon data
1. Comment out `await restoreMastodonData()` in `run-mastodon.js` to avoid actually populating the database with statuses/favorites/etc.
2. Update the `GIT_TAG` in `run-mastodon.js` to whatever you want
3. Run `npm run run-mastodon`
4. Run `npm run backup-mastodon-data` to overwrite the data in `fixtures/`
5. Uncomment `await restoreMastodonData()` in `run-mastodon.js`
6. Commit all changed files
7. Run `rm -fr mastodon/` and `npm run run-mastodon` to confirm everything's working
2018-11-20 09:01:23 +01:00
Check `mastodon.log` if you have any issues.
## Unit tests
There are also some unit tests that run in Node using Mocha. You can find them in `tests/unit` and
2018-12-18 02:21:29 +01:00
run them using `npm run test-unit` .