Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eerohele/sigel
XSLT and XPath in your Clojure
https://github.com/eerohele/sigel
clojure saxon xpath xslt
Last synced: about 1 month ago
JSON representation
XSLT and XPath in your Clojure
- Host: GitHub
- URL: https://github.com/eerohele/sigel
- Owner: eerohele
- License: epl-1.0
- Created: 2017-04-23T19:47:39.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-17T09:37:38.000Z (11 months ago)
- Last Synced: 2024-11-09T10:41:24.430Z (about 1 month ago)
- Topics: clojure, saxon, xpath, xslt
- Language: Clojure
- Homepage:
- Size: 175 KB
- Stars: 28
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Sigel
=====
[](https://clojars.org/me.flowthing/sigel)
( [Changelog] | **[API]** )
Sigel «ᛋ» is a Clojure interface to the XSLT and XPath bits of [Saxon].
## XSLT
Sigel lets you write XSLT, but with parentheses instead of angle brackets.
### Examples
```clojure
(require '[sigel.xslt.core :as xslt]
'[sigel.xslt.elements :as xsl])
(def stylesheet-1
"An XSLT stylesheet that converts to ."
(xsl/stylesheet {:version 3.0}
(xsl/template {:match "a"} [:b])))
(def stylesheet-2
"An XSLT stylesheet that converts to ."
(xsl/stylesheet {:version 3.0}
(xsl/template {:match "b"} [:c])))
(def compiled-stylesheets
[(xslt/compile-sexp stylesheet-1) (xslt/compile-sexp stylesheet-2)])
;; Transform the XML string "" with stylesheet-1 and then stylesheet-2.
(xslt/transform compiled-stylesheets "")
;;=> #object[net.sf.saxon.s9api.XdmNode 0x61acfa00 ""]
```
You can also write your transformation in EDN:
```clojure
;; a.edn
[:xsl/stylesheet {:version 3.0}
[:xsl/template {:match "a"} [:b]]]
;; in your Clojure code
(xslt/transform (xslt/compile-edn "/path/to/a.edn") "")
;;=> #object[net.sf.saxon.s9api.XdmNode 0xf2a49c4 ""]
```
You can also execute XSLT transformations written in plain old XML:
```xsl
```
```clojure
(xslt/transform (xslt/compile-xslt "a-to-b.xsl") "")
;;=> #object[net.sf.saxon.s9api.XdmNode 0x2bda7fdc ""]
```
## XPath
Select things in an XML document with XPath.
### Examples
```clojure
(require '[sigel.xpath.core :as xpath])
;; Select nodes with XPath.
(seq (xpath/select "" "a/b | a/c"))
;;=>
;;(#object[net.sf.saxon.s9api.XdmNode 0x3cadbb6f ""]
;; #object[net.sf.saxon.s9api.XdmNode 0x136b811a ""])
;; Get the result of evaluating an XPath expression against a node as a Java
;; object.
(xpath/value-of "1" "xs:int(num)")
;;=> 1
```
## XML
Every function in this library that takes XML as input accepts any object that implements [the `XMLSource` protocol](https://github.com/eerohele/sigel/blob/master/src/sigel/protocols.clj).
### Examples
```clojure
(require '[clojure.java.io :as io])
;; java.lang.String
(xpath/select "" "a/b")
;;=> #object[net.sf.saxon.s9api.XdmNode 0x772300a6 ""]
;; java.io.File
(xpath/select (io/as-file "/tmp/a.xml") "a/b")
;;=> #object[net.sf.saxon.s9api.XdmNode 0x5487f8c7 ""]
;; java.net.URL
(xpath/select (io/as-url "http://www.xmlfiles.com/examples/note.xml") "/note/to")
;;=> #object[net.sf.saxon.s9api.XdmNode 0x79f4a8cb "Tove"]
```
## License
Copyright © 2019 Eero Helenius
Distributed under the [Eclipse Public License][EPL] either version 1.0 or (at
your option) any later version.
Saxon is licensed under the [Mozilla Public License][MPL].
[API]: https://cljdoc.xyz/d/me.flowthing/sigel/CURRENT
[CHANGELOG]: https://github.com/eerohele/sigel/blob/master/CHANGELOG.md
[EPL]: https://www.eclipse.org/legal/epl-v10.html
[MPL]: https://www.mozilla.org/en-US/MPL
[Saxon]: http://www.saxonica.com