CSC/ECE 517 Fall 2015/oss/M1503/IntegrateXMLParser - Revision history

Rghadiy: Undo previous changes

2015-11-10T04:30:42Z

Undo previous changes

@@ Line 21: / Line 21: @@
 The Adapter Design Pattern was applied to enhance parsing mechanism for XML5 in Servo. Interface defined using adapter pattern closely resembles servoHTMLParser interface as this will facilitate parsing or modifying any code for both XML and [[HTML]] documents and future reader don't have to understand code for both separately as they are related in their functionality.
-== Initial steps==
+== Initial implementation==
 To achieve project goal we have done following initial steps.
@@ Line 32: / Line 32: @@
 Called parse_xml from domparser.rs located at components/script/dom this will help compile.
 == Challenges ==
@@ Line 87: / Line 48: @@
 All the modifications which were suggested by servo community through comments on pull request, have been incorporated and pull request has been merged successfully.
 == External Links ==

Rghadiy at 04:24, 10 November 2015

2015-11-10T04:24:13Z

@@ Line 32: / Line 32: @@
 Called parse_xml from domparser.rs located at components/script/dom this will help compile.
 == Implementation ==
@@ Line 87: / Line 71: @@
 ## Replace all the children of document by the children of result (even if it has no children), firing mutation events as if a DocumentFragment containing the new children had been inserted.
 ## Fire a simple event named load at document.
 == External Links ==

Rghadiy: Implementation

2015-11-10T04:23:11Z

Implementation

← Older revision		Revision as of 04:23, 10 November 2015
Line 21:		Line 21:
	The Adapter Design Pattern was applied to enhance parsing mechanism for XML5 in Servo. Interface defined using adapter pattern closely resembles servoHTMLParser interface as this will facilitate parsing or modifying any code for both XML and [[HTML]] documents and future reader don't have to understand code for both separately as they are related in their functionality.		The Adapter Design Pattern was applied to enhance parsing mechanism for XML5 in Servo. Interface defined using adapter pattern closely resembles servoHTMLParser interface as this will facilitate parsing or modifying any code for both XML and [[HTML]] documents and future reader don't have to understand code for both separately as they are related in their functionality.

	== Initial ~~Implementation~~ ==		== Initial steps==

	To achieve project goal we have done following initial steps.		To achieve project goal we have done following initial steps.
Line 41:		Line 41:
	To integrate the model of XML parser into current servo code, no extra test cases were added. We have added interface files and method stubs, XML parser functionality will be implemented as subsequent steps in final project. Integration success is tested by successful compilation and build after adding our changes. Following commands are used to check that all test cases were passed.		To integrate the model of XML parser into current servo code, no extra test cases were added. We have added interface files and method stubs, XML parser functionality will be implemented as subsequent steps in final project. Integration success is tested by successful compilation and build after adding our changes. Following commands are used to check that all test cases were passed.

			<pre>
	./mach run tests/html/about-mozilla.html		./mach run tests/html/about-mozilla.html

	./mach test-tidy		./mach test-tidy
			</pre>

	All the modifications which were suggested by servo community through comments on pull request, have been incorporated and pull request has been merged successfully.		All the modifications which were suggested by servo community through comments on pull request, have been incorporated and pull request has been merged successfully.

	== ~~Subsequent steps for final project~~ ==		== Implementation ==

	Modify ~~ScriptTask~~::load in ~~script_task~~.rs to ~~recognize the~~ text/xml content type ~~and~~ call parse_xml instead of parse_html as appropriate, while passing the appropriate flag to the Document constructor.		* Modify Script::load in scipt_task.rs to check whether documents we are parsing isof type text/xml. We the content type of the document is text/xml then we have to call parse_xml which we defined in OSS project. Earlier it called parse_html for all the documents but now since we are integrating the XML parser, it will call parse_xml instead of parse_html as appropriate, while passing the appropriate flag to the Document constructor.
			* Implement a TreeSink for the XML parser which will pick nodes from XML document and append them to XML tree in the hierarchy. Serializable module also needs to be implemented in order to implement TeeSink.
			* Support for XML document responses needs to be implemented. We will check the response Document and its MIME type. If either one of them is null then function will return null. Otherwise if MIME type is text/html then we will check its charset and if its null then set it to UTF-8 and if MIME type is text/xml then we will define document to be a Document that represents the result of running the XML parser with XML scripting support disabled on bytes. At the end end we will set document’s encoding to charset, content type to final MIME type and url to document’s URL and return response document object.
			* Implement XMLDocument API:
			# adding the new IDL file at components/script/dom/webidls/XMLDocument.webidl;
			# creating components/script/dom/XMLDocument.rs;
			# listing XMLDocument .rs in components/script/dom/mod.rs;
			# defining the DOM struct XMLDocument with a #[dom_struct] attribute, a superclass or Reflector member, and other members as appropriate;
			# implementing the dom::bindings::codegen::Bindings::XMLDocumentBindings::XMLDocumentMethods trait for &'a XMLDocument.
			# In XMLDocument.webidl file, implement the load method.

	~~Implement a TreeSink for the XML parser that performs appropriate tree modifications for each action.~~		<pre>
			partial interface XMLDocument {
			boolean load(DOMString url);
			};
			</pre>

	~~Implement support in xmlhttprequest~~.~~rs for XML~~ document ~~responses (see step 7~~ in ~~https://xhr~~.~~spec~~.~~whatwg~~.~~org/~~#document-response).		The load(url) method must run the following steps:
			# Let document be the XMLDocument object on which the method was invoked.
	~~Implement XMLDocument API by~~ following the ~~documentation and implementing~~ the ~~steps laid out in~~ the ~~specification for~~ the load ~~method~~.		# Resolve the method's first argument, relative to the API base URL specified by the entry settings object. If this is not successful, throw a SyntaxError exception and abort these steps. Otherwise, let url be the resulting absolute URL.
			# If the origin of url is not the same as the origin of document, throw a SecurityError exception and abort these steps.
			# Remove all child nodes of document, without firing any mutation events.
			# Set the current document readiness of document to "loading".
			# Run the remainder of these steps in parallel, and return true from the method.
			# Let result be a Document object.
			# Let success be false.
			# Let request be a new request whose url is url, client is entry settings object, destination is "subresource", synchronous flag is set, mode is "same- 1. origin", credentials mode is "same-origin", and whose use-URL-credentials flag is set.
			# Let response be the result of fetching request.
			# If response's Content-Type metadata is an XML MIME type, then run these substeps:
			## Create a new XML parser associated with the result document.
			## Pass this parser response's body.
			## If there is an XML well-formedness or XML namespace well-formedness error, then remove all child nodes from result. Otherwise let success be true.
			# Queue a task to run the following steps.
			## Set the current document readiness of document to "complete".
			## Replace all the children of document by the children of result (even if it has no children), firing mutation events as if a DocumentFragment containing the new children had been inserted.
			## Fire a simple event named load at document.

	== External Links ==		== External Links ==
Line 74:		Line 105:

	Rust Documentation - https://doc.rust-lang.org/nightly/index.html		Rust Documentation - https://doc.rust-lang.org/nightly/index.html

			XML specs - https://xhr.spec.whatwg.org/#document-response

Rghadiy: Added Testing part

2015-11-06T20:27:12Z

Added Testing part

← Older revision		Revision as of 20:27, 6 November 2015
Line 36:		Line 36:

	Primary challenge is to continuously sync with the latest commits of servo and ensuring build success after integrating each step. And keep on adding of necessary stubs as per the new changes in parsing mechanism also need continuous and careful efforts.		Primary challenge is to continuously sync with the latest commits of servo and ensuring build success after integrating each step. And keep on adding of necessary stubs as per the new changes in parsing mechanism also need continuous and careful efforts.

			== Testing ==

			To integrate the model of XML parser into current servo code, no extra test cases were added. We have added interface files and method stubs, XML parser functionality will be implemented as subsequent steps in final project. Integration success is tested by successful compilation and build after adding our changes. Following commands are used to check that all test cases were passed.

			./mach run tests/html/about-mozilla.html

			./mach test-tidy

			All the modifications which were suggested by servo community through comments on pull request, have been incorporated and pull request has been merged successfully.

	== Subsequent steps for final project ==		== Subsequent steps for final project ==

Rghadiy at 01:55, 1 November 2015

2015-11-01T01:55:37Z

← Older revision		Revision as of 01:55, 1 November 2015
Line 1:		Line 1:

	== Rust ==		== Rust ==

	Rust is a general-purpose, compiled programming language developed by Mozilla Research. The syntax of [[Rust]] is somewhat similar to [[C]] and [[C++]], with blocks of code delimited by curly brackets, and control flow and structure. Rust does not use automatic [[garbage collection]] mechanism similar to [[java]]. It accomplishes the goals of memory safe without using garbage collection and it supports concurrency and parallelism in building platforms.		Rust is a general-purpose, compiled programming language developed by Mozilla Research. The syntax of [[Rust]] is somewhat similar to [[C]] and [[C++]], with blocks of code delimited by curly brackets, and control flow and structure. Rust does not use automatic [[garbage collection]] mechanism similar to [[java]]. It accomplishes the goals of memory safe without using garbage collection and it supports concurrency and parallelism in building platforms.


	== Servo ==		== Servo ==

	Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[API]]s, [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.		Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[API]]s, [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.


	== Compilation and Build ==		== Compilation and Build ==
Line 14:		Line 11:
	Code link: https://github.com/servo/servo/ . This repository is forked to https://github.com/ronak6892/servo .		Code link: https://github.com/servo/servo/ . This repository is forked to https://github.com/ronak6892/servo .
	Build success is ensured by commands ./mach build --dev and ./mach run tests/html/about-mozilla.html.		Build success is ensured by commands ./mach build --dev and ./mach run tests/html/about-mozilla.html.


	== Project Description ==		== Project Description ==

	Servo currently lacks a parser for [[XML]] documents, which prevents implementation of several APIs. The goal of the project is to integrate xml5ever parser into Servo.		Servo currently lacks a parser for [[XML]] documents, which prevents implementation of several APIs. The goal of the project is to integrate xml5ever parser into Servo.


	== Design ==		== Design ==
Line 25:		Line 20:
	To integrate XML5ever, dependency was added for XML5ever parser similar to HTML5ever.A separate interface was defined in ServoXMLParser webidl file and this interface was implemented in its corresponding rust file along with necessary stubs to parse XML.		To integrate XML5ever, dependency was added for XML5ever parser similar to HTML5ever.A separate interface was defined in ServoXMLParser webidl file and this interface was implemented in its corresponding rust file along with necessary stubs to parse XML.
	The Adapter Design Pattern was applied to enhance parsing mechanism for XML5 in Servo. Interface defined using adapter pattern closely resembles servoHTMLParser interface as this will facilitate parsing or modifying any code for both XML and [[HTML]] documents and future reader don't have to understand code for both separately as they are related in their functionality.		The Adapter Design Pattern was applied to enhance parsing mechanism for XML5 in Servo. Interface defined using adapter pattern closely resembles servoHTMLParser interface as this will facilitate parsing or modifying any code for both XML and [[HTML]] documents and future reader don't have to understand code for both separately as they are related in their functionality.


	== Initial Implementation ==		== Initial Implementation ==
Line 38:		Line 32:

	Called parse_xml from domparser.rs located at components/script/dom this will help compile.		Called parse_xml from domparser.rs located at components/script/dom this will help compile.


	== Challenges ==		== Challenges ==

	Primary challenge is to continuously sync with the latest commits of servo and ensuring build success after integrating each step. And keep on adding of necessary stubs as per the new changes in parsing mechanism also need continuous and careful efforts.		Primary challenge is to continuously sync with the latest commits of servo and ensuring build success after integrating each step. And keep on adding of necessary stubs as per the new changes in parsing mechanism also need continuous and careful efforts.


	== Subsequent steps for final project ==		== Subsequent steps for final project ==
Line 54:		Line 46:

	Implement XMLDocument API by following the documentation and implementing the steps laid out in the specification for the load method.		Implement XMLDocument API by following the documentation and implementing the steps laid out in the specification for the load method.


	== External Links ==		== External Links ==


	HTML5ever - https://github.com/servo/html5ever/		HTML5ever - https://github.com/servo/html5ever/
Line 66:		Line 56:

	YouTube - https://youtu.be/i8dONOzYwlc		YouTube - https://youtu.be/i8dONOzYwlc


	== References ==		== References ==

Rghadiy at 01:54, 1 November 2015

2015-11-01T01:54:18Z

← Older revision		Revision as of 01:54, 1 November 2015
Line 1:		Line 1:

	== Rust ==		== Rust ==

	Rust is a general-purpose, compiled programming language developed by Mozilla Research. The syntax of [[Rust]] is somewhat similar to [[C]] and [[C++]], with blocks of code delimited by curly brackets, and control flow and structure. Rust does not use automatic [[garbage collection]] mechanism similar to [[java]]. It accomplishes the goals of memory safe without using garbage collection and it supports concurrency and parallelism in building platforms.		Rust is a general-purpose, compiled programming language developed by Mozilla Research. The syntax of [[Rust]] is somewhat similar to [[C]] and [[C++]], with blocks of code delimited by curly brackets, and control flow and structure. Rust does not use automatic [[garbage collection]] mechanism similar to [[java]]. It accomplishes the goals of memory safe without using garbage collection and it supports concurrency and parallelism in building platforms.


	== Servo ==		== Servo ==

	Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[API]]s, [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.		Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[API]]s, [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.


	== Compilation and Build ==		== Compilation and Build ==
Line 11:		Line 14:
	Code link: https://github.com/servo/servo/ . This repository is forked to https://github.com/ronak6892/servo .		Code link: https://github.com/servo/servo/ . This repository is forked to https://github.com/ronak6892/servo .
	Build success is ensured by commands ./mach build --dev and ./mach run tests/html/about-mozilla.html.		Build success is ensured by commands ./mach build --dev and ./mach run tests/html/about-mozilla.html.


	== Project Description ==		== Project Description ==

	Servo currently lacks a parser for [[XML]] documents, which prevents implementation of several APIs. The goal of the project is to integrate xml5ever parser into Servo.		Servo currently lacks a parser for [[XML]] documents, which prevents implementation of several APIs. The goal of the project is to integrate xml5ever parser into Servo.


	== Design ==		== Design ==

	To integrate XML5ever, dependency was added for XML5ever parser similar to HTML5ever.A separate interface was defined in ServoXMLParser webidl file and this interface was implemented in its corresponding rust file along with necessary stubs to parse XML.		To integrate XML5ever, dependency was added for XML5ever parser similar to HTML5ever.A separate interface was defined in ServoXMLParser webidl file and this interface was implemented in its corresponding rust file along with necessary stubs to parse XML.
	The Adapter Design Pattern was applied to enhance parsing mechanism for XML5 in Servo. Interface defined using adapter pattern closely resembles servoHTMLParser interface as this will facilitate parsing or modifying any code for both XML and [[HTML]] documents and future reader don't have to understand code for both separately as they are related in their functionality.		The Adapter Design Pattern was applied to enhance parsing mechanism for XML5 in Servo. Interface defined using adapter pattern closely resembles servoHTMLParser interface as this will facilitate parsing or modifying any code for both XML and [[HTML]] documents and future reader don't have to understand code for both separately as they are related in their functionality.
Line 40:		Line 46:

	== Subsequent steps for final project ==		== Subsequent steps for final project ==

	Modify ScriptTask::load in script_task.rs to recognize the text/xml content type and call parse_xml instead of parse_html as appropriate, while passing the appropriate flag to the Document constructor.		Modify ScriptTask::load in script_task.rs to recognize the text/xml content type and call parse_xml instead of parse_html as appropriate, while passing the appropriate flag to the Document constructor.

Rghadiy at 01:52, 1 November 2015

2015-11-01T01:52:31Z

← Older revision		Revision as of 01:52, 1 November 2015
Line 32:		Line 32:

	Called parse_xml from domparser.rs located at components/script/dom this will help compile.		Called parse_xml from domparser.rs located at components/script/dom this will help compile.


	== Challenges ==		== Challenges ==

Rghadiy: Added building and challenges

2015-11-01T01:41:13Z

Added building and challenges

← Older revision		Revision as of 01:41, 1 November 2015
Line 6:		Line 6:

	Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[API]]s, [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.		Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[API]]s, [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.

			== Compilation and Build ==

			Code link: https://github.com/servo/servo/ . This repository is forked to https://github.com/ronak6892/servo .
			Build success is ensured by commands ./mach build --dev and ./mach run tests/html/about-mozilla.html.

	== Project Description ==		== Project Description ==
Line 28:		Line 33:
	Called parse_xml from domparser.rs located at components/script/dom this will help compile.		Called parse_xml from domparser.rs located at components/script/dom this will help compile.

			== Challenges ==

			Primary challenge is to continuously sync with the latest commits of servo and ensuring build success after integrating each step. And keep on adding of necessary stubs as per the new changes in parsing mechanism also need continuous and careful efforts.

Djvaghel at 01:32, 1 November 2015

2015-11-01T01:32:57Z

← Older revision		Revision as of 01:32, 1 November 2015
Line 5:		Line 5:
	== Servo ==		== Servo ==

	Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[~~APIs~~]], [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.		Servo is web browser layout engine developed by Mozilla Research. It was developed in Rust. Servo handles parallel environments such as rendering, layout, image decoding as a separate tasks. Servo provides [[API]]s, [[JavaScript]] support. Servo was not developed explicitly to create full web browser but to achieve maximum parallelism.

	== Project Description ==		== Project Description ==

Djvaghel at 01:32, 1 November 2015

2015-11-01T01:32:31Z

← Older revision		Revision as of 01:32, 1 November 2015
Line 1:		Line 1:
	== Rust ==		== Rust ==

	Rust is a general-purpose, compiled programming language developed by [[Mozilla Research]]. The syntax of [[Rust]] is somewhat similar to [[C]] and [[C++]], with blocks of code delimited by curly brackets, and control flow and structure. Rust does not use automatic [[garbage collection]] mechanism similar to [[java]]. It accomplishes the goals of memory safe without using garbage collection and it supports concurrency and parallelism in building platforms.		Rust is a general-purpose, compiled programming language developed by Mozilla Research. The syntax of [[Rust]] is somewhat similar to [[C]] and [[C++]], with blocks of code delimited by curly brackets, and control flow and structure. Rust does not use automatic [[garbage collection]] mechanism similar to [[java]]. It accomplishes the goals of memory safe without using garbage collection and it supports concurrency and parallelism in building platforms.

	== Servo ==		== Servo ==