openmc-data 2.5.0__tar.gz → 2.6.0__tar.gz

{openmc_data-2.5.0 → openmc_data-2.6.0}/.github/workflows/test_package.yml

@@ -41,15 +41,17 @@ jobs:
           cd ..
           pip install .
           cd ..
-          pip install .
+          pip install '.[tests]'
+
+      - name: Test offline unit and CLI behavior
+        run: python -m pytest -q -rs tests -m 'not network and not integration'
 
         # this just check the scripts are accessible after the install
         # the scripts are not run or checked for correct behaviour
       - name: Test convert scripts exist
         run: |
           convert_fendl --help
-          convert_jeff32 --help
-          convert_jeff33 --help
+          convert_jeff --help
           convert_lib80x --help
           convert_mcnp70 --help
           convert_mcnp71 --help
@@ -60,12 +62,13 @@ jobs:
         run: |
           generate_cendl --help
           generate_endf --help
-          generate_jeff33 --help
+          generate_jeff --help
           generate_jendl --help
       
       - name: Test download h5 scripts exist
         run: |
           download_endf --help
+          download_jeff --help
           download_tendl --help
 
       - name: Test download chain files scripts exist

openmc_data-2.6.0/.github/workflows/test_processing.yml

@@ -0,0 +1,114 @@
+
+name: test_convert_scripts
+on:
+  workflow_dispatch:
+    inputs:
+      script:
+        description: Script recipe to run (downloads and processes large datasets)
+        required: true
+        type: choice
+        options:
+          - convert_fendl
+          - convert_jeff
+          - convert_endf
+          - convert_tendl
+          - convert_tendl_rand
+          - download_endf
+          - download_tendl
+          - download_chain
+          - add_branching_ratios
+          - reduce_chain
+
+
+jobs:
+    run_scripts:
+      runs-on: ubuntu-latest
+      timeout-minutes: 360
+      steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: 3.12
+
+      - name: Install testing dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install libhdf5-serial-dev
+          git clone --single-branch --branch develop --depth 1 https://github.com/openmc-dev/openmc.git
+          cd openmc
+          mkdir build
+          cd build
+          cmake ..
+          make -j2
+          sudo make -j2 install
+          cd ..
+          pip install .
+          cd ..
+          pip install .
+
+      # Convert scripts that require MCNP nuclear data are not tested because
+      # the CI doesn't contain that nuclear data.
+      # convert_lib80x.py convert_mcnp70.py convert_mcnp71.py files are not tested here
+
+      - name: test default convert_fendl
+        if: inputs.script == 'convert_fendl'
+        run: |
+          convert_fendl --cleanup
+
+      # Limit neutron processing to one temperature to bound disk use.
+      - name: test convert_jeff
+        if: inputs.script == 'convert_jeff'
+        run: convert_jeff -t 293 --cleanup
+
+      - name: test default convert_endf
+        if: inputs.script == 'convert_endf'
+        run: |
+          convert_endf --cleanup
+
+      - name: test default convert_tendl
+        if: inputs.script == 'convert_tendl'
+        run: |
+          convert_tendl --cleanup
+
+      - name: test default convert_tendl_rand
+        if: inputs.script == 'convert_tendl_rand'
+        run: |
+          convert_tendl_rand --nuclides O16 --cleanup
+
+      # download scripts
+      - name: test default download_endf
+        if: inputs.script == 'download_endf'
+        run: |
+          download_endf
+
+      - name: test default download_tendl
+        if: inputs.script == 'download_tendl'
+        run: |
+          download_tendl -r 2019
+          download_tendl -r 2021
+
+      - name: test default download_chain
+        if: inputs.script == 'download_chain'
+        run: |
+          download_chain -l endf -r b7.1 -b None
+          download_chain -l endf -r b8.0 -b None
+          download_chain -l endf -r b7.1 -b SFR
+          download_chain -l endf -r b8.0 -b SFR
+          download_chain -l endf -r b7.1 -b PWR
+          download_chain -l endf -r b8.0 -b PWR
+          download_chain -l endf -r b8.0 -b PWR
+
+      - name: test default add_branching_ratios
+        if: inputs.script == 'add_branching_ratios'
+        run: |
+          download_chain -l endf -r b8.0
+          add_branching_ratios -i chain-endf-b8.0.xml -o chain_endf_b8.0_sfr.xml -b sfr
+          add_branching_ratios -i chain-endf-b8.0.xml -o chain_endf_b8.0_pwr.xml -b pwr
+
+      - name: test default reduce_chain
+        if: inputs.script == 'reduce_chain'
+        run: |
+          download_chain -l endf -r b8.0
+          reduce_chain -i chain-endf-b8.0.xml -o chain_endf_b8.0_sfr.xml -hl 1e15

openmc_data-2.6.0/.github/workflows/test_urls.yml

@@ -0,0 +1,55 @@
+
+name: test_urls
+on:  
+  workflow_dispatch:
+  pull_request:    
+    branches:
+      - main
+    paths-ignore:
+      - "**.md"
+      - "**.txt"
+      - "**.cff"
+      - 'docs/**'
+      - '.gitignore'  
+  push:
+    branches:
+    - main
+  schedule:
+    - cron: "0 0 * * *"
+# cron job runs every day
+
+jobs:
+    ping_urls:
+      runs-on: ubuntu-latest
+      steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: 3.12
+
+      - name: Install testing dependencies
+        run: python -m pip install '.[tests]'
+
+      - name: Test URL registry and HTTP helpers offline
+        run: python -m pytest -q -rs tests/test_urls.py -m 'not network and not integration'
+
+    live_urls:
+      if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+      runs-on: ubuntu-latest
+      timeout-minutes: 180
+      steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: 3.12
+
+      - name: Install testing dependencies
+        run: python -m pip install '.[tests]'
+
+      # External failures remain failures; this health check is not a PR gate.
+      - name: Test live URLs with explicit skip reasons
+        run: python -m pytest -v -rs tests/test_urls.py -m network

{openmc_data-2.5.0 → openmc_data-2.6.0}/.gitignore

@@ -50,6 +50,7 @@ coverage.xml
 *.py,cover
 .hypothesis/
 .pytest_cache/
+.pytest-tmp/
 
 # Translations
 *.mo

{openmc_data-2.5.0 → openmc_data-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openmc_data
-Version: 2.5.0
+Version: 2.6.0
 Summary: A Python package containing a collection of scripts for producing and downloading data for OpenMC
 Author-email: Jonathan Shimwell <mail@jshimwell.com>
 License-Expression: MIT
@@ -40,6 +40,34 @@ The package is distributed on [PYPI](https://pypi.org/project/openmc-data/) and
 pip install openmc_data
 ```
 
+# Testing
+
+Install the test dependencies with `python -m pip install '.[tests]'`, then run
+the offline suite with `python -m pytest -q -rs tests -m 'not network and not integration'`.
+Tests stay in the flat [tests](tests) directory: [test_utils.py](tests/test_utils.py)
+covers shared utilities, [test_urls.py](tests/test_urls.py) covers registry
+validation, HTTP helper regressions and marked live URL checks, and script-specific
+tests belong in files named test_&lt;script&gt;.py alongside them. Use pytest's
+`tmp_path` for generated test artifacts rather than writing into the repository.
+
+The `network` marker identifies live external URL checks; `integration` identifies
+data download and processing tests. Pull requests and pushes run offline tests
+and CLI help checks in [test_package.yml](.github/workflows/test_package.yml), and
+offline URL syntax and repository-file checks in
+[test_urls.yml](.github/workflows/test_urls.yml), without compiling OpenMC for the
+URL jobs. Live URL checks run nightly or manually in a separate job of that same
+workflow. Full, multi-GB processing runs only through the required script choice
+in the manual [test_processing.yml](.github/workflows/test_processing.yml) workflow.
+
+Exactly one URL is explicitly **not tested over HTTP** because of its Cloudflare
+challenge:
+<https://nds.iaea.org/fendl/data/neutron/fendl-FENDL-3.2c-neutron-endf.zip>.
+Its syntax is still checked offline. Other HTTP errors, including IAEA and
+Cloudflare 403 responses, remain failures, not skips or expected failures.
+Nightly/manual external health checks may remain red until blocked IAEA and
+obsolete OECD URLs are restored; passing offline checks does not establish that
+downloads are available.
+
 # Usage
 
 Once installed several scripts are available in your terminal that are able to
@@ -81,10 +109,36 @@ A few categories of scripts are available:
 |convert_endf | ENDF/B | VII.1 | NNDC |
 |convert_lib80x | ENDF/B | VIII.0 | LANL |
 |convert_fendl | FENDL | 3.2c<br>3.2b<br>3.2a<br>3.2<br>3.1d<br>3.1a<br>3.1<br>3.0<br>2.1 |
-|convert_jeff32 | JEFF | 3.2 |
-|convert_jeff33 | JEFF | 3.3 |
+|convert_jeff | JEFF | 3.2<br>3.3<br>4.0 (default) | OECD/NEA |
 |convert_tendl | TENDL | 2015<br>2017<br>2019<br>2021 |
 
+#### JEFF ACE conversion
+
+`convert_jeff -r 3.3 -t 600 900 --destination jeff-hot` converts neutron and
+thermal ACE data without NJOY or a 293 K base. Defaults: release 4.0, all neutron
+temperatures, `--libver latest`. Available neutron archive temperatures:
+
+| Release | Neutron archive temperatures (K) |
+| --- | --- |
+| 3.2 | 293, 300, 400, 500, 600, 700, 800, 900, 1000, 1200, 1500, 1800 |
+| 3.3 | 293, 600, 900, 1200, 1500, 1800 |
+| 4.0 | 0.1, 293, 300, 600, 900, 1200, 1500, 1800 |
+
+Select the 4.0 archive containing 293.6 K data with `-t 293`. **All native thermal
+temperatures** are retained, including the 1 K UO2 pairs. **JEFF-4.0 supplies only
+the public 12-case/316-table thermal subset**, not the full TSL library.
+Unknown thermal aliases retain their identity with a `c_` prefix and warning.
+
+Output HDF5/XML goes directly into `--destination` (default `jeff-<release>-hdf5`),
+staged until conversion succeeds; existing files and name/temperature collisions fail.
+Downloads require multiple GB. `--no-download --no-extract` reuses working-directory
+caches `jeff-<release>-download` and `jeff-<release>-ace`; `--cleanup` removes both
+only after success. Metastable corrections never edit cached ACE files.
+Every discovered nuclide must have every selected neutron temperature; 3.3 also
+requires its 20 thermal groups. Caches cannot reveal nuclides absent at all temperatures.
+
+See `convert_jeff --help` for all options.
+
 ### Generate cross sections
 
 | Script name | Library | Release | Processed by |
@@ -93,15 +147,17 @@ A few categories of scripts are available:
 | generate_endf | ENDF/B | VII.1<br>VIII.0<br>VIII.1 | NNDC |
 | generate_fendl | FENDL | 3.2c<br>3.2b<br>3.2a<br>3.2<br>3.1d<br>3.1a<br>3.0 | |
 | generate_jendl | JENDL | 4.0<br>5.0 | |
+| generate_jeff | JEFF | 3.3<br>4.0 | NJOY |
 | generate_tendl | TENDL | 2023<br>2025 | |
 
 
 ### Download cross sections
 
-| Script name | Library | Release | Processed by |
-|-|-|-|-|
-| download_endf | ENDF/B | VII.1<br>VIII.0<br>VIII.1  | NNDC |
-| download_tendl | TENDL | 2019<br>2021  |  |
+| Script name | Library | Release | Processed by | Neutron temperatures (K) |
+|-|-|-|-|-|
+| download_endf | ENDF/B | VII.1<br>VIII.0<br>VIII.1  | NNDC | 250, 293.6, 600, 900, 1200, 2500 |
+| download_jeff | JEFF | 3.3<br>4.0 | OpenMC development team | 250, 293.6, 600, 900, 1200, 2500 |
+| download_tendl | TENDL | 2019<br>2021  |  | 293.6 |
 
 <!-- | Script name | Library | Release | Processed by | Download available | Downloads ACE files and convert to HDF5 | Downloads ENDF files and convert to HDF5 | Convert local ACE files |
 |-|-|-|-|-|-|-|-|
@@ -114,8 +170,6 @@ A few categories of scripts are available:
 |generate_endf| ENDF/B | VIII.0 | NNDC | [openmc.org](https://anl.box.com/shared/static/uhbxlrx7hvxqw27psymfbhi7bx7s6u6a.xz) |  | :heavy_check_mark: |  |
 |convert_fendl| FENDL | 2.1<br>3.0<br>3.1a<br>3.1d<br>3.2 |  | [openmc.org 3.2](https://anl.box.com/shared/static/3cb7jetw7tmxaw6nvn77x6c578jnm2ey.xz) | :heavy_check_mark: |  |  |
 |generate_jendl| JENDL | 4.0 |  |  |  | :heavy_check_mark: |  |
-|convert_jeff32| JEFF | 3.2 |  | [openmc.org](https://anl.box.com/shared/static/pb94oxriiipezysu7w4r2qdoufc2epxv.xz) | :heavy_check_mark: |  |  |
-|convert_jeff33| JEFF | 3.3 |  | [openmc.org](https://anl.box.com/shared/static/ddetxzp0gv1buk1ev67b8ynik7f268hw.xz) | :heavy_check_mark: |  |  |
 |convert_tendl| TENDL | 2015<br>2017<br>2019<br>2021|  |  | :heavy_check_mark: |  |  | -->
 
 ## Produce Depletion Chain files

{openmc_data-2.5.0 → openmc_data-2.6.0}/README.md

@@ -20,6 +20,34 @@ The package is distributed on [PYPI](https://pypi.org/project/openmc-data/) and
 pip install openmc_data
 ```
 
+# Testing
+
+Install the test dependencies with `python -m pip install '.[tests]'`, then run
+the offline suite with `python -m pytest -q -rs tests -m 'not network and not integration'`.
+Tests stay in the flat [tests](tests) directory: [test_utils.py](tests/test_utils.py)
+covers shared utilities, [test_urls.py](tests/test_urls.py) covers registry
+validation, HTTP helper regressions and marked live URL checks, and script-specific
+tests belong in files named test_<script>.py alongside them. Use pytest's
+`tmp_path` for generated test artifacts rather than writing into the repository.
+
+The `network` marker identifies live external URL checks; `integration` identifies
+data download and processing tests. Pull requests and pushes run offline tests
+and CLI help checks in [test_package.yml](.github/workflows/test_package.yml), and
+offline URL syntax and repository-file checks in
+[test_urls.yml](.github/workflows/test_urls.yml), without compiling OpenMC for the
+URL jobs. Live URL checks run nightly or manually in a separate job of that same
+workflow. Full, multi-GB processing runs only through the required script choice
+in the manual [test_processing.yml](.github/workflows/test_processing.yml) workflow.
+
+Exactly one URL is explicitly **not tested over HTTP** because of its Cloudflare
+challenge:
+<https://nds.iaea.org/fendl/data/neutron/fendl-FENDL-3.2c-neutron-endf.zip>.
+Its syntax is still checked offline. Other HTTP errors, including IAEA and
+Cloudflare 403 responses, remain failures, not skips or expected failures.
+Nightly/manual external health checks may remain red until blocked IAEA and
+obsolete OECD URLs are restored; passing offline checks does not establish that
+downloads are available.
+
 # Usage
 
 Once installed several scripts are available in your terminal that are able to
@@ -61,10 +89,36 @@ A few categories of scripts are available:
 |convert_endf | ENDF/B | VII.1 | NNDC |
 |convert_lib80x | ENDF/B | VIII.0 | LANL |
 |convert_fendl | FENDL | 3.2c<br>3.2b<br>3.2a<br>3.2<br>3.1d<br>3.1a<br>3.1<br>3.0<br>2.1 |
-|convert_jeff32 | JEFF | 3.2 |
-|convert_jeff33 | JEFF | 3.3 |
+|convert_jeff | JEFF | 3.2<br>3.3<br>4.0 (default) | OECD/NEA |
 |convert_tendl | TENDL | 2015<br>2017<br>2019<br>2021 |
 
+#### JEFF ACE conversion
+
+`convert_jeff -r 3.3 -t 600 900 --destination jeff-hot` converts neutron and
+thermal ACE data without NJOY or a 293 K base. Defaults: release 4.0, all neutron
+temperatures, `--libver latest`. Available neutron archive temperatures:
+
+| Release | Neutron archive temperatures (K) |
+| --- | --- |
+| 3.2 | 293, 300, 400, 500, 600, 700, 800, 900, 1000, 1200, 1500, 1800 |
+| 3.3 | 293, 600, 900, 1200, 1500, 1800 |
+| 4.0 | 0.1, 293, 300, 600, 900, 1200, 1500, 1800 |
+
+Select the 4.0 archive containing 293.6 K data with `-t 293`. **All native thermal
+temperatures** are retained, including the 1 K UO2 pairs. **JEFF-4.0 supplies only
+the public 12-case/316-table thermal subset**, not the full TSL library.
+Unknown thermal aliases retain their identity with a `c_` prefix and warning.
+
+Output HDF5/XML goes directly into `--destination` (default `jeff-<release>-hdf5`),
+staged until conversion succeeds; existing files and name/temperature collisions fail.
+Downloads require multiple GB. `--no-download --no-extract` reuses working-directory
+caches `jeff-<release>-download` and `jeff-<release>-ace`; `--cleanup` removes both
+only after success. Metastable corrections never edit cached ACE files.
+Every discovered nuclide must have every selected neutron temperature; 3.3 also
+requires its 20 thermal groups. Caches cannot reveal nuclides absent at all temperatures.
+
+See `convert_jeff --help` for all options.
+
 ### Generate cross sections
 
 | Script name | Library | Release | Processed by |
@@ -73,15 +127,17 @@ A few categories of scripts are available:
 | generate_endf | ENDF/B | VII.1<br>VIII.0<br>VIII.1 | NNDC |
 | generate_fendl | FENDL | 3.2c<br>3.2b<br>3.2a<br>3.2<br>3.1d<br>3.1a<br>3.0 | |
 | generate_jendl | JENDL | 4.0<br>5.0 | |
+| generate_jeff | JEFF | 3.3<br>4.0 | NJOY |
 | generate_tendl | TENDL | 2023<br>2025 | |
 
 
 ### Download cross sections
 
-| Script name | Library | Release | Processed by |
-|-|-|-|-|
-| download_endf | ENDF/B | VII.1<br>VIII.0<br>VIII.1  | NNDC |
-| download_tendl | TENDL | 2019<br>2021  |  |
+| Script name | Library | Release | Processed by | Neutron temperatures (K) |
+|-|-|-|-|-|
+| download_endf | ENDF/B | VII.1<br>VIII.0<br>VIII.1  | NNDC | 250, 293.6, 600, 900, 1200, 2500 |
+| download_jeff | JEFF | 3.3<br>4.0 | OpenMC development team | 250, 293.6, 600, 900, 1200, 2500 |
+| download_tendl | TENDL | 2019<br>2021  |  | 293.6 |
 
 <!-- | Script name | Library | Release | Processed by | Download available | Downloads ACE files and convert to HDF5 | Downloads ENDF files and convert to HDF5 | Convert local ACE files |
 |-|-|-|-|-|-|-|-|
@@ -94,8 +150,6 @@ A few categories of scripts are available:
 |generate_endf| ENDF/B | VIII.0 | NNDC | [openmc.org](https://anl.box.com/shared/static/uhbxlrx7hvxqw27psymfbhi7bx7s6u6a.xz) |  | :heavy_check_mark: |  |
 |convert_fendl| FENDL | 2.1<br>3.0<br>3.1a<br>3.1d<br>3.2 |  | [openmc.org 3.2](https://anl.box.com/shared/static/3cb7jetw7tmxaw6nvn77x6c578jnm2ey.xz) | :heavy_check_mark: |  |  |
 |generate_jendl| JENDL | 4.0 |  |  |  | :heavy_check_mark: |  |
-|convert_jeff32| JEFF | 3.2 |  | [openmc.org](https://anl.box.com/shared/static/pb94oxriiipezysu7w4r2qdoufc2epxv.xz) | :heavy_check_mark: |  |  |
-|convert_jeff33| JEFF | 3.3 |  | [openmc.org](https://anl.box.com/shared/static/ddetxzp0gv1buk1ev67b8ynik7f268hw.xz) | :heavy_check_mark: |  |  |
 |convert_tendl| TENDL | 2015<br>2017<br>2019<br>2021|  |  | :heavy_check_mark: |  |  | -->
 
 ## Produce Depletion Chain files

{openmc_data-2.5.0 → openmc_data-2.6.0}/pyproject.toml

@@ -37,6 +37,13 @@ tests = [
     "requests"
 ]
 
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "network: live external URL checks (scheduled or manual, not a pull request gate)",
+    "integration: data download and processing tests (manual only)",
+]
+
 [project.urls]
 "Homepage" = "https://github.com/fusion-energy/openmc_data"
 "Bug Tracker" = "https://github.com/fusion-energy/openmc_data/issues"
@@ -54,8 +61,7 @@ include-package-data = false
 
 [project.scripts]
 convert_fendl = "openmc_data.convert.convert_fendl:main"
-convert_jeff32 = "openmc_data.convert.convert_jeff32:main"
-convert_jeff33 = "openmc_data.convert.convert_jeff33:main"
+convert_jeff = "openmc_data.convert.convert_jeff:main"
 convert_lib80x = "openmc_data.convert.convert_lib80x:main"
 convert_mcnp70 = "openmc_data.convert.convert_mcnp70:main"
 convert_mcnp71 = "openmc_data.convert.convert_mcnp71:main"
@@ -64,7 +70,7 @@ convert_tendl = "openmc_data.convert.convert_tendl:main"
 
 generate_cendl = "openmc_data.generate.generate_cendl:main"
 generate_endf = "openmc_data.generate.generate_endf:main"
-generate_jeff33 = "openmc_data.generate.generate_jeff33:main"
+generate_jeff = "openmc_data.generate.generate_jeff:main"
 generate_jendl = "openmc_data.generate.generate_jendl:main"
 generate_fendl = "openmc_data.generate.generate_fendl:main"
 generate_tendl = "openmc_data.generate.generate_tendl:main"
@@ -87,5 +93,6 @@ sample_sandy = "openmc_data.other.sample_sandy:main"
 reduce_chain = "openmc_data.depletion.reduce_chain:main"
 
 download_endf = "openmc_data.download.download_endf:main"
+download_jeff = "openmc_data.download.download_jeff:main"
 download_tendl = "openmc_data.download.download_tendl:main"
 download_chain = "openmc_data.download.download_chain:main"

{openmc_data-2.5.0 → openmc_data-2.6.0}/src/openmc_data/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.5.0'
-__version_tuple__ = version_tuple = (2, 5, 0)
+__version__ = version = '2.6.0'
+__version_tuple__ = version_tuple = (2, 6, 0)
 
-__commit_id__ = commit_id = 'gf334eb8a8'
+__commit_id__ = commit_id = 'g06d8c2c1f'