mediawiki-extensions-Visual.../modules/parser/test/README

Work in progress. :)

Please see https://www.mediawiki.org/wiki/Parsoid for some information on how
to get started with these tests and the current parser architecture.

Install dependencies and run tests:

(cd .. if you are in this README file's directory)
npm test

== Running parserTests.js ==

For parserTests, you also need MediaWiki's parser test cases (parserTests.txt). 
'npm test' from the modules directory automatically fetches the current
version to this directory. You can also specify a test case file as an
argument. You can also symlink parserTests.txt from a core git checkout.

node ./parserTests.js

Several options are available for parserTests:

node ./parserTests.js --help

Example for round-trip testing:

node ./parserTests.js --roundtrip

Enjoy!
First combination of WikiDom serializers with existing parser in tests/parser/parserTests.js. * Removed var from es in es.js to allow node.js to access it as global. Only alternative solution appears to be a node-specific 'exports' construct: http://nodejs.org/docs/v0.3.1/api/modules.html * Added es.Document.js and es.Document.Serializer.js in es/bases. Not sure if this is the desired location. * Changed es.extend to es.extendClass in the serializers * Modified the first parser test to include the WikiDom modules and call the new HTML serializer 2011-11-03 13:55:48 +00:00			`Work in progress. :)`

Update test README Change-Id: Icc4f26804295d48bcf244e61ef7654e31b05b306 2012-07-23 21:43:12 +00:00			`Please see https://www.mediawiki.org/wiki/Parsoid for some information on how`
			`to get started with these tests and the current parser architecture.`
First combination of WikiDom serializers with existing parser in tests/parser/parserTests.js. * Removed var from es in es.js to allow node.js to access it as global. Only alternative solution appears to be a node-specific 'exports' construct: http://nodejs.org/docs/v0.3.1/api/modules.html * Added es.Document.js and es.Document.Serializer.js in es/bases. Not sure if this is the desired location. * Changed es.extend to es.extendClass in the serializers * Modified the first parser test to include the WikiDom modules and call the new HTML serializer 2011-11-03 13:55:48 +00:00
As much as I have loved writing Makefiles... I've replaced its functionality with package.json, mostly so we can avoid non-node dependencies. This is one of the recommended practices. We should consider moving tests/parser into modules/parser/tests, other node projects keep all module code in one directory. Explained in the README how to use npm to load the dependencies and run tests. Too bad about NODE_PATH... Don't try to find parserTests.txt in assorted places--if it isn't present, fetch from gerrit. You can symlink from core if you're developing on both parsers, and the fetch script will not overwrite. Use __dirname in parserTests.js to allow the script to run independent of current working directory. Change-Id: I4c8b884e91f4fdeae385c7697aff768bdd199dd5 2012-03-24 23:31:48 +00:00			`Install dependencies and run tests:`

Parsoid: move tests/parser to modules/parser/test In preparation for the big extraction of Parsoid out of VisualEditor, we'll start by moving the tests into the parsoid location. Change-Id: I4a926ee4aad1490d4f769d44e91af80842b881f0 2012-07-25 00:22:45 +00:00			`(cd .. if you are in this README file's directory)`
Update test README Change-Id: Icc4f26804295d48bcf244e61ef7654e31b05b306 2012-07-23 21:43:12 +00:00			`npm test`
Update README 2011-12-13 10:03:01 +00:00
			`== Running parserTests.js ==`

Update test README Change-Id: Icc4f26804295d48bcf244e61ef7654e31b05b306 2012-07-23 21:43:12 +00:00			`For parserTests, you also need MediaWiki's parser test cases (parserTests.txt).`
			`'npm test' from the modules directory automatically fetches the current`
			`version to this directory. You can also specify a test case file as an`
			`argument. You can also symlink parserTests.txt from a core git checkout.`
Update README 2011-12-13 10:03:01 +00:00
			`node ./parserTests.js`

			`Several options are available for parserTests:`

			`node ./parserTests.js --help`

Update test README Change-Id: Icc4f26804295d48bcf244e61ef7654e31b05b306 2012-07-23 21:43:12 +00:00			`Example for round-trip testing:`
Update README 2011-12-13 10:03:01 +00:00
Update test README Change-Id: Icc4f26804295d48bcf244e61ef7654e31b05b306 2012-07-23 21:43:12 +00:00			`node ./parserTests.js --roundtrip`
Update README 2011-12-13 10:03:01 +00:00
Update test README Change-Id: Icc4f26804295d48bcf244e61ef7654e31b05b306 2012-07-23 21:43:12 +00:00			`Enjoy!`