Socs

Description
This is a minor release after changing the build backend. There are no functionality changes, but the source distribution published to PyPI has changed slightly. In prior releases _some_ of the tests were published, but not in a way that was functional. In this, and future releases, the `tests/` directory is not included in the sdist. Some other files that should not have been included have also been removed. Users interested in contributing to `ocs` are encouraged to get the tests directly from this repo instead.

Reported version change when installing from source
The reported version installed now has a slightly different format, as we have dropped use of `versioneer`, which was providing this version number. This only affects users who install directly from source, not if you install from PyPI. Here is an example of the change:

**old version format:** `0.11.2+7.ga1e7e91`
**new version format:** `0.11.2.post1.dev7+ga1e7e91`

What's Changed
* Switch build-backend from setuptools to hatchling by BrianJKoopman in https://github.com/simonsobs/ocs/pull/403
* Drop link to license file in pyproject.toml by BrianJKoopman in https://github.com/simonsobs/ocs/pull/406


**Full Changelog**: https://github.com/simonsobs/ocs/compare/v0.11.2...v0.11.3

Description
This release reworks how the ocs Docker image is built, removing some unneeded base layers. This shrinks the image considerably.

It also introduces a timeout feature in the `create_agent_runner_fixture` function, used in integration testing. This timeout feature helps abort tests that hang due to a crash in the agent subprocess. The default timeout is 60 seconds. If you have integration tests that take longer than that for a given test you should be sure to use a longer timeout, else the test will abort early.

What's Changed
* Remove old compiled spt3g/so3g layers from Docker image by BrianJKoopman in https://github.com/simonsobs/ocs/pull/397
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/399
* Interrupt agent within pytest fixture if it crashes during testing by BrianJKoopman in https://github.com/simonsobs/ocs/pull/401


**Full Changelog**: https://github.com/simonsobs/ocs/compare/v0.11.1...v0.11.2

Description
This release is mostly to solidify the recent packaging issue resolutions from 392 and 394. The setuptools issue in particular was hitting downstream packages like [socs](https://github.com/simonsobs/socs).

We expect these packaging fixes to be temporary, but found them to be necessary for now. Please use the discussion associated with this release or the issues tracker to report any issues.

What's Changed

Packaging
* Pin setuptools version by BrianJKoopman in https://github.com/simonsobs/ocs/pull/392
* Pin numpy<2.0 by BrianJKoopman in https://github.com/simonsobs/ocs/pull/394

Version Updates
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/386
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/388
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/389

Misc.
* Organize badges, define supported Python versions, and update versioneer by BrianJKoopman in https://github.com/simonsobs/ocs/pull/393
* Clean up lingering Docker Compose v1 references by BrianJKoopman in https://github.com/simonsobs/ocs/pull/395

**Full Changelog**: https://github.com/simonsobs/ocs/compare/v0.11.0...v0.11.1

Description
Release v0.11.0 drops support for Docker Compose v1 in the Host Manager agent and adds support for Docker Compose v2. It also comes with improvements to the `session.status` object. Lastly, we have stopped publishing the `ocs-utils` image, which has not been properly maintained for a while now.

Compose v2 Update
OCS users relying on the Host Manager Agent likely already have Compose v2 installed, but should [migrate to Compose v2](https://docs.docker.com/compose/migrate/) and remove v1. Using v1 may result in some [errors](https://github.com/simonsobs/ocs/issues/382) preventing updates to services.

`session.status` Update
Details on this update can be found in 371. One added feature is the new "DEGRADED" OpCode value. See the [updated documentation](https://ocs.readthedocs.io/en/main/developer/clients.html#check-health-of-a-process) for how to use this to monitor the state of an agent.

Additionally, `session.status` is now placed into the "RUNNING" state automatically just before the agent operation is launched. Agent developers no longer need to call `session.set_status('running')` explicitly within their agents. Any instances of `session.set_status('starting')` should be removed from existing Agents, as they will cause an error related to the session status going backwards. `session.publish_status` has also been removed.

What's Changed
New Features
* Improvements to session.status by mhasself in https://github.com/simonsobs/ocs/pull/371
* HostManager: Replace docker compose v1 with v2 by mhasself in https://github.com/simonsobs/ocs/pull/383
* Update docs for Docker Compose v2 by BrianJKoopman in https://github.com/simonsobs/ocs/pull/384

Bug Fixes
* Fix bug in how args are parsed from site-config by jlashner in https://github.com/simonsobs/ocs/pull/378

Version Updates
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/369
* Bump styfle/cancel-workflow-action from 0.12.0 to 0.12.1 by dependabot in https://github.com/simonsobs/ocs/pull/374
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/376
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/379

Misc.
* Relax pinned versions on docs requirements by BrianJKoopman in https://github.com/simonsobs/ocs/pull/375
* Drop the ocs-utils container by BrianJKoopman in https://github.com/simonsobs/ocs/pull/381


**Full Changelog**: https://github.com/simonsobs/ocs/compare/v0.10.4...v0.11.0

Description
Release v0.10.4 fixes a data duplication bug that can occur under certain circumstances in any agent that subscribes to a Feed. Within the core OCS agents this means the aggregator and InfluxDB publisher agents. The bug occurs when a network interruption disrupts the connection between the crossbar server and the subscribing agent, depending on the state of the crossbar server. Details are available in 366. Users are encouraged to update their agents.

What's Changed
* Bump actions/setup-python from 4 to 5 by dependabot in https://github.com/simonsobs/ocs/pull/364
* Fix duplicate data frame writes in Aggregator agent by BrianJKoopman in https://github.com/simonsobs/ocs/pull/366


**Full Changelog**: https://github.com/simonsobs/ocs/compare/v0.10.3...v0.10.4

Description
Release v0.10.3 focuses on the Host Manager Agent and introduces a configurable agent timeout for crossbar disconnects. Users are encouraged to upgrade.

Host Manager
There are many bug fixes and some new features for the Host Manager introduced by 353. For details see the ["Centralized Management"](https://ocs.readthedocs.io/en/main/user/centralized_management.html#) page in the docs. One highlight in particular is the new "manage" options, detailed in ["Advanced host config"](https://ocs.readthedocs.io/en/main/user/centralized_management.html#advanced-host-config). These changes should also enable running a single Host Manager where two previously were run (one for agents on the host, and one for agents within Docker containers.)

Crossbar Timeout
The "crossbar-timeout" setting allows for agents to wait longer for the crossbar server to come back online before shutting down. They can wait indefinitely if this is set to 0. See ["Crossbar Connection Timeout"](https://ocs.readthedocs.io/en/main/user/site_config.html#crossbar-connection-timeout) for more details.

What's Changed

New Features
* HostManager overhaul by mhasself in https://github.com/simonsobs/ocs/pull/353
* Allow user configurable agent timeout for crossbar disconnection by BrianJKoopman in https://github.com/simonsobs/ocs/pull/337
* Add SITE_HOST envvar to ocs-agent-cli by mhasself in https://github.com/simonsobs/ocs/pull/354

Bug Fixes
* systemd service file: add RestartSec=10s by mhasself in https://github.com/simonsobs/ocs/pull/344
* HostManager overhaul by mhasself in https://github.com/simonsobs/ocs/pull/353

Version Updates
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/340
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/346
* Bump docker/login-action from 2 to 3 by dependabot in https://github.com/simonsobs/ocs/pull/352
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/350
* Bump actions/checkout from 3 to 4 by dependabot in https://github.com/simonsobs/ocs/pull/349
* Bump styfle/cancel-workflow-action from 0.11.0 to 0.12.0 by dependabot in https://github.com/simonsobs/ocs/pull/355
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/simonsobs/ocs/pull/358

Testing
* Replace pytest-docker-compose with pytest-docker plugin by BrianJKoopman in https://github.com/simonsobs/ocs/pull/342

**Full Changelog**: https://github.com/simonsobs/ocs/compare/v0.10.2...v0.10.3