/scala-xml

The standard Scala XML library

Primary LanguageScalaApache License 2.0Apache-2.0

scala-xml Travis latest release for 2.11 latest release for 2.12 latest release for 2.13.0-M5 Gitter

The standard Scala XML library. Please file XML issues here, not at https://github.com/scala/bug/issues.

Since Scala 2.11, this library is a separate jar that can be omitted from Scala projects that do not use XML.

The decoupling works because the compiler desugars XML literals in Scala source code into a set of method calls. Alternative implementations of these calls are welcome! (The calls are unfortunately only defined by the implementation.)

API documentation is available here.

How to documentation is available in the wiki

Cross-building with 2.10

If you are cross-building a project that uses scala-xml with both Scala 2.10 and later Scala versions, take a look at this example.

Maintenance status

This library is community-maintained. The lead maintainer is @aaron_s_hawley.

Contributors are welcome, and should read the contributor guide on the wiki.

Issues

Many old issues from the Scala JIRA issue tracker have been migrated here, but not all of them. Community assistance identifying and migrating still-relevant issues is welcome. See this page for details.

Security best practices

The XML spec has some features that are best turned off, to avoid unsavory things like file system access, DoS attacks,... Issue #17 tracks the recommended way of configuring the XML parser used by scala-xml to avoid these. This is by no means an exhaustive list. We'll be happy to incorporate your suggestions -- just comment on the ticket!