Add CI workflow for build, test, and type checking; enhance README and XmlElement tests

Author: daniel-sc

.github/workflows/build.yml

@@ -0,0 +1,19 @@
+name: Build, test and typecheck
+
+on: push
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.2
+      - name: Install dependencies
+        run: bun install
+      - name: Test
+        run: bun test --coverage
+      - name: Typecheck
+        run: bun typecheck

.gitignore

@@ -102,7 +102,6 @@ dist
 
 # vuepress v2.x temp and cache directory
 .temp
-.cache
 
 # Docusaurus cache and generated files
 .docusaurus
@@ -129,4 +128,5 @@ dist
 .yarn/install-state.gz
 .pnp.*
 
-*.js
+.idea
+*.js

README.md

@@ -13,3 +13,12 @@ If you have an XML file that you want to read, modify, and write back, this libr
 - Retains attribute quotes (single or double) and whitespace before and after the attribute name
 - Retains XML processing instructions (including the XML declaration)
 - Retains CDATA sections
+
+## Development
+
+This project is written in Typescript and uses Bun.
+
+```bash
+bun install
+bun test
+```

model/xmlElement.spec.ts

@@ -1,6 +1,7 @@
 import { describe, expect, it } from 'bun:test';
 import { XmlElement } from './xmlElement';
 import { XmlText } from './xmlText';
+import { XmlAttribute } from './xmlAttribute';
 
 describe('XmlElement', () => {
   describe('addElement', () => {
@@ -80,4 +81,15 @@ describe('XmlElement', () => {
       });
     });
   });
+  describe('getAttributeValue', () => {
+    it('should return the value of the attribute', () => {
+      const element = new XmlElement('test', [new XmlAttribute('key', 'value &')]);
+      expect(element.getAttributeValue('key')).toBe('value &');
+    });
+
+    it('should return undefined if the attribute does not exist', () => {
+      const element = new XmlElement('test');
+      expect(element.getAttributeValue('key')).toBeUndefined();
+    });
+  });
 });

model/xmlElement.ts

@@ -81,6 +81,15 @@ export class XmlElement extends XmlNode {
     this.joinTextNodes();
   }
 
+  getAttribute(name: string): XmlAttribute | undefined {
+    return this.attributes.find((attr) => attr.name === name);
+  }
+
+  /** returns unescaped attribute value or undefined if not found */
+  getAttributeValue(name: string): string | undefined {
+    return this.getAttribute(name)?.unescapeValue();
+  }
+
   toString(): string {
     let openTag = `<${this.tagName}`;
     for (const attr of this.attributes) {