χrust-net

Networking support for the χrust crate.

This crate provides a library with a function to resolve a URL to the content of the resource. In other words, it fetches a URL and returns a String containing the document. At a minimum it must support file: and http(s): schemes.

The intended use for this function is in the import and include methods for χrust's xslt module. One of the from_document function's argument is a closure. Use the resolve function in that closure, for example:

from_document(
  style,
	Some(Base URI),
	|s| make_document(s),
	|url| resolve(url, &policy),
)

NB. the resolver function must be provided with a security policy to allow access to resources, see below.

The resolve function may also be used for external entities when parsing XML documents.

See the test in resolver.rs for a complete example.

Security

Accessing files and network resources is a security risk. χrust-net provides security [Feature]s, using χrust's security mechanism, to be able to restrict access to file and network resources. Details of the feature is given in the resolver module.

The resolver is able to control:

• access to a resource, i.e. a file or a URL
• the size of the resource

Since the default is to not permit access to resources, an application must provide a security policy that permits access.