Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs for testScheduler.run() #3612

Merged
merged 1 commit into from
May 3, 2018
Merged

Conversation

jayphelps
Copy link
Member

Follow up to #3596 which introduced the new testScheduler.run(callback) helper.

Not done yet, needs more content and the content already here is likely to change. If you have suggestions or examples feel free to comment! One thing I think is a good idea is to move the content of the existing writing-marble-tests.md file and clarifying that it's particular content is intended for internal rxjs tests, not tests in your client apps. This new file I'm introducing is intended for client apps.

When it's ready I'd like to solicit feedback from people who know RxJS relatively well but have never used TestScheduler.

@jayphelps jayphelps self-assigned this Apr 27, 2018
@@ -0,0 +1,188 @@
> NOTE: This document refers to the writing marble tests for the **RxJS repo internals** and is intended for anyone wishing to help maintain the RxJS repo. **Users of RxJS** should instead view the [guide for writing marbles tests for applications](./marble-testing.md). The major difference is that the behavior of the TestScheduler differs between manual usage and using the `testScheduler.run(callback)` helper.

# Writing Marble Tests
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file is just a copy and paste from the existing old writing-marble-tests.md, with the added disclaimer at the top.


Then, when running `npm run tests2png`, this test case will be parsed and a PNG file `zip.png` (filename determined by `${operatorLabel}.png`) will be created in the `img/` folder.
- [USERS: Writing marble diagram tests for your application](./marble-testing.md).
- [INTERNAL MAINTAINERS ONLY: Writing marble diagram tests for your the RxJS internals](./internal-marble-tests.md).
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I imagine even though this doc was written with the intended audience being maintainers of rxjs itself, some people have linked to this doc so to aid in their search I added this links.

@coveralls
Copy link

coveralls commented Apr 27, 2018

Coverage Status

Coverage remained the same at 96.502% when pulling 0c79911 on jayphelps:marble-docs into 0e1f9d6 on ReactiveX:master.

@jayphelps jayphelps force-pushed the marble-docs branch 2 times, most recently from 1f6c239 to ccf68a5 Compare May 1, 2018 00:38
@jayphelps jayphelps changed the title WIP(marble tests): WIP docs for testScheduler.run() docs for testScheduler.run() May 3, 2018
@jayphelps jayphelps removed the PR: WIP label May 3, 2018
@benlesh benlesh merged commit ce20af9 into ReactiveX:master May 3, 2018
@lock
Copy link

lock bot commented Jun 5, 2018

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.

@lock lock bot locked as resolved and limited conversation to collaborators Jun 5, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants