Metadata-Version: 2.4
Name: squidient
Version: 4.0.0
Summary: CI/CD framework for alya
Project-URL: Homepage, https://alya.gitlab.bsc.es/alya/ci-cd/squidient
Project-URL: Bug Tracker, https://alya.gitlab.bsc.es/alya/ci-cd/squidient/issues
Author-email: Damien Dosimont <damien.dosimont@gmail.com>
License-File: LICENSE.txt
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Requires-Dist: importlib-resources; python_version < '3.9'
Requires-Dist: lxml
Requires-Dist: mariasql>=5
Requires-Dist: packaging>=21.3
Description-Content-Type: text/markdown

# Squidient

Squidient is a scheduler for testing, benchmarking and deploying HPC programs on SLURM machines.

## Refreshing Workspace Data

Squidient records a fingerprint of its packaged `data/` in `version/data.json`
when `squidient init .` completes. A completed full configuration records
that fingerprint in `configuration.json.dataRevision`. Staging and monitoring stop
with exit code 1 if either differs from the installed package, including for older
workspaces without this metadata. No confirmation prompt is displayed. The check
runs before Terraform provisioning, remote connections, or job submission.
A package release that leaves `data/` unchanged does not require a refresh.

Refreshing is explicit: back up any customized workspace files and configuration
first, then run:

```sh
squidient init .
squidient configure --all
```

`init` overwrites packaged workspace files but does not regenerate
`configuration.json`. `configure --all` regenerates the configuration; reapply
your local settings as necessary. Partial reconfiguration does not mark an old
configuration as current. The check never overwrites customizations automatically.
Help and cleanup commands, including `terraform stop`, remain available.
The former `fileFormat` counter and `version/version.json` are no longer used;
legacy configurations must be refreshed before workflow execution when their
data revision cannot be established.

