2024 Update

.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: composer
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "02:30"
+      timezone: America/Los_Angeles
+    open-pull-requests-limit: 10
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "02:30"
+      timezone: America/Los_Angeles
+    open-pull-requests-limit: 10

.github/workflows/ci.yml

@@ -15,21 +15,21 @@ jobs:
 
     strategy:
       matrix:
-        php-version: [8.0]
+        php-version: [8.2, 8.3]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
     - name: Use PHP ${{ matrix.php-version }}
       uses: shivammathur/setup-php@v2
       with:
         coverage: none
         php-version: ${{ matrix.php-version }}
     - name: install dependencies
       run: composer install --no-interaction --prefer-dist
-    - name: lint src
-      run: bin/phpcs --standard=PSR2 src
-    - name: lint tests
-      run: bin/phpcs --standard=PSR2 tests
+    - name: lint PHP
+      run: bin/phpcs
+    - name: static code analysis
+      run: bin/phpstan
 
   tests:
     name: PHPUnit Tests
@@ -38,10 +38,10 @@ jobs:
 
     strategy:
       matrix:
-        php-version: [8.0]
+        php-version: [8.2, 8.3]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
     - name: Use PHP ${{ matrix.php-version }}
       uses: shivammathur/setup-php@v2
       with:

.gitignore

@@ -1,5 +1,9 @@
 *~
 *.patch
 /bin/*
+/html-coverage/
 /vendor/
-.phpunit.result.cache
+.phpunit.cache
+.phpcs-cache
+phpunit.xml
+

README.md

@@ -1,9 +1,9 @@
 # MeSH Parser
 
-This PHP code library provides tools for extracting [Medical Subject Headings](https://www.nlm.nih.gov/mesh/) 
+This PHP code library provides tools for extracting [Medical Subject Headings](https://www.nlm.nih.gov/mesh/meshhome.html) 
 (MeSH) descriptors and associated data from a given XML file into an object representation.
 
-It expects its input to be compliant with the 2019 or 2020 [MeSH DTDs](https://www.nlm.nih.gov/databases/dtd/).
+It expects its input to be compliant with the 2023 or 2024 [MeSH DTDs](https://www.nlm.nih.gov/databases/download/mesh.html).
 
 ## Installation
 
@@ -15,11 +15,11 @@ composer require ilios/mesh-parser
 
 ## Usage
 
-Instantiate `\Ilios\MeSH\Parser` and invoke its `parse()` method with an URI that points at valid MeSH descriptors 
+Instantiate `\Ilios\MeSH\Parser` and invoke its `parse()` method with a URI that points at valid MeSH descriptors 
 XML file.  
 This method call will return an instance of  `\Ilios\MeSH\Model\DescriptorSet`; this is the entry point into
 the object representation of the descriptors data model.  
-Use getter methods on this object and its sub-components to traverse and process this model.
+Use getter methods on this object and its subcomponents to traverse and process this model.
 
 ### Example
 
@@ -28,9 +28,9 @@ Use getter methods on this object and its sub-components to traverse and process
 
 require __DIR__ . '/vendor/autoload.php';
 
-// provide an URL or a local file path.
-//$uri = 'ftp://nlmpubs.nlm.nih.gov/online/mesh/MESH_FILES/xmlmesh/desc2020.xml';
-$uri = __DIR__ . '/desc2019.xml';
+// provide a URL or a local file path.
+//$uri = 'https://nlmpubs.nlm.nih.gov/projects/mesh/MESH_FILES/xmlmesh/desc2024.xml';
+$uri = __DIR__ . '/desc2024.xml';
 
 // instantiate the parser and parse the input.
 $parser = new \Ilios\MeSH\Parser();

composer.json

@@ -6,7 +6,7 @@
     "Ilios",
     "MeSH"
   ],
-  "homepage": "http://iliosproject.org/",
+  "homepage": "https://iliosproject.org/",
   "license": "MIT",
   "authors": [
     {
@@ -16,13 +16,16 @@
     }
   ],
   "require": {
-    "php": ">=8.0"
+    "php": ">=8.2",
+    "ext-dom": "*",
+    "ext-xmlreader": "*"
   },
   "require-dev": {
     "mockery/mockery": "@stable",
     "phpunit/phpunit": "@stable",
     "squizlabs/php_codesniffer": "@stable",
-    "fakerphp/faker": "@stable"
+    "fakerphp/faker": "@stable",
+    "phpstan/phpstan": "^1.10"
   },
   "autoload": {
     "psr-4": {