Skip to content

Releases: BambooHR/satis

BambooHR's first release branch

01 Nov 15:27
@Bearlock Bearlock
2.0.0
c2e0145
Compare
Choose a tag to compare
BambooHR's first release branch Latest
Latest

Why

Howdy folks! The motivation behind the fork (and this release) is that the official downline, composer/satis, last had an official release sometime around 2018. A couple of things have changed since then, namely:

  • BambooHR's build servers via CIHub now only run PHP 8.1 (as of writing this)
  • v1.0.0 of composer/satis has a composer/composer dependency locking it to PHP ^7.4
  • PHP 8.1 is incompatible with composer v1, and that incompatibility is incompatible with the official 1.0.0 release of Satis

To be clear, composer/satis still has active development and is supported, but they don't seem to cut official releases anymore. The expectation then, is to update our composer.json to have a dependency that looks like: composer/satis: dev-main, meaning we'd be sourcing the dependency directly from the main branch of composer/satis. There are a couple of problems with this approach:

  • We'd be indiscriminately slurping in any changes to the mainline; breaking changes could slip in that are incompatible with what we do since they're not depending on version pinning anymore. Yuck.
  • When fetching a dependency from Github straight from VCS (so not a nice 'n' tidy tarball/zip), Github expects an Oauth token. Our build servers don't have that concept baked in. We'd have to use somebody's PAT in our build system and that gets brittle quick + it seriously ups our bus factor.

We may still research and go down the path of updating our build servers to have a token to talk to Github, but until we fully understand the implications (or the work necessary) for that action, we opted to for forking Satis.

What this enables us to do is to cut a release branch inside of our own walled garden and hopefully circumvent some of that aforementioned token weirdness.

What

This release will include whatever changes were made to composer/satis's main branch as of 2023-11-01. Note: we're opting for the 2.0.0 tag as a way to denote a point in time difference from the official composer/satis 1.0.0 release.

Full Changelog: https://github.com/BambooHR/satis/commits/2.0.0-bhr

Assets 2
Loading