update readme with example

diff --git a/README.md b/README.md
index b332bc4d622bbb16e6d9d053860ac8d65f824752..f8b3c64c890dd33a0d5627e7ff4ab0cead1863c7 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,6 +4,52 @@
 
 This is a minimal parser for HTTP Link Headers, basically just a wrapper around a PEG grammar.
 
 
 This is a minimal parser for HTTP Link Headers, basically just a wrapper around a PEG grammar.
 

+## API
+
+- `parse(text: string, options?: object)`  
+  Parse string as a Link header value, returning an array of link objects.  
+  The available options are as documented in [peggy](https://peggyjs.org/documentation.html#using-the-parser).
+  ```javascript
+  const { parse, SyntaxError: ParserSyntaxError } = require('@squeep/web-linking');
+  const result = parse('</TheBook/chapter2>;rel="previous"; title*=UTF-8\'de\'letztes%20Kapitel,</TheBook/chapter4>;rel="next"; title*=UTF-8\'de\'n%c3%a4chstes%20Kapitel');
+  console.log(JSON.stringify(result, undefined, 2));
+  ```
+  Produces this:
+  ```json
+  [
+    {
+      "target": "/TheBook/chapter2",
+      "attributes": [
+        {
+          "name": "rel",
+          "extended": false,
+          "value": "previous"
+        },
+        {
+          "name": "title*",
+          "extended": true,
+          "value": "UTF-8'de'letztes%20Kapitel"
+        }
+      ]
+    },
+    {
+      "target": "/TheBook/chapter4",
+      "attributes": [
+        {
+          "name": "rel",
+          "extended": false,
+          "value": "next"
+        },
+        {
+          "name": "title*",
+          "extended": true,
+          "value": "UTF-8'de'n%c3%a4chstes%20Kapitel"
+        }
+      ]
+    }
+  ]
+  ```
+

 ## Notes
 
 After updating the grammar, `npm run generate` will compile the parser.
 ## Notes
 
 After updating the grammar, `npm run generate` will compile the parser.