"""Offline executable contract for the Gitea 1.22 push entrypoint; no SSH/DB calls.""" import hashlib import os import pathlib import subprocess import textwrap import unittest ROOT = pathlib.Path(__file__).resolve().parents[1] class PushContract(unittest.TestCase): def setUp(self): self.workflow = (ROOT / '.gitea/workflows/auth-schema-reconcile.yml').read_text() self.shell = textwrap.dedent(self.workflow.split(' run: |\n', 1)[1]) self.gate = self.shell.split('[[ -n "$DEPLOY_KEY"', 1)[0] self.sha = 'a' * 40 self.digest = '8a22f3e89efb3dacc24f3ed9337ae87d0b4345da003a607bc1994478f69c6feb' def invoke(self, **changes): env = dict(os.environ, CI_EVENT='push', CI_REF='refs/heads/ops/auth-schema-stage', DEPLOY_SHA=self.sha, REVIEWED_SCHEMA_COMMIT=self.sha, SQL_SHA=self.digest, APPROVAL_ID='CEO-AUTH-SCHEMA-20261025', PRODUCTION_SCHEMA_APPROVAL='', STAGE_AUTH_ACCEPTANCE='') env.update(changes) return subprocess.run(['bash', '-c', self.gate + '\nprintf "%s:%s:%s" "$TARGET_ENV" "$schema_ok" "$auth_ok"'], env=env, capture_output=True, text=True) def test_only_supported_exact_push_branches(self): self.assertEqual(self.workflow.split('on:\n', 1)[1].split('jobs:', 1)[0], ' push:\n branches:\n - ops/auth-schema-stage\n - ops/auth-schema-production\n') self.assertNotIn('workflow_dispatch', self.workflow) deploy = (ROOT / '.gitea/workflows/deploy.yml').read_text() self.assertEqual(deploy.split('branches:\n', 1)[1].split('jobs:', 1)[0].strip(), '- main\n - develop') def test_stage_and_production_require_existing_approvals(self): stage = self.invoke() self.assertEqual((stage.returncode, stage.stdout), (0, 'stage:no:no'), stage.stderr) self.assertNotEqual(self.invoke(CI_REF='refs/heads/ops/auth-schema-production').returncode, 0) env = dict(CI_REF='refs/heads/ops/auth-schema-production', PRODUCTION_SCHEMA_APPROVAL=f'{self.sha}:{self.digest}:CEO-AUTH-SCHEMA-20261025', STAGE_AUTH_ACCEPTANCE=f'{self.sha}:{self.digest}') accepted = self.invoke(**env) self.assertEqual((accepted.returncode, accepted.stdout), (0, 'production:yes:yes'), accepted.stderr) for changes in [dict(PRODUCTION_SCHEMA_APPROVAL=''), dict(STAGE_AUTH_ACCEPTANCE=''), dict(STAGE_AUTH_ACCEPTANCE='b' * 40 + ':' + self.digest), dict(PRODUCTION_SCHEMA_APPROVAL=f'{self.sha}:{self.digest}:OTHER-APPROVAL'), dict(PRODUCTION_SCHEMA_APPROVAL=f'{self.sha}:'+ '0' * 64 + ':CEO-AUTH-SCHEMA-20261025'), dict(REVIEWED_SCHEMA_COMMIT='b' * 40)]: self.assertNotEqual(self.invoke(**(env | changes)).returncode, 0) def test_invalid_event_ref_sha_cannot_reach_ssh(self): for changes in [dict(CI_EVENT='workflow_dispatch'), dict(CI_EVENT='pull_request'), dict(CI_REF='refs/heads/main'), dict(CI_REF='refs/tags/ops/auth-schema-stage'), dict(CI_REF='refs/heads/ops/auth-schema-stage-extra'), dict(CI_REF='refs/heads/ops/auth-schema-stage; exit 0'), dict(DEPLOY_SHA='$(exit 0)'), dict(DEPLOY_SHA=''), dict(REVIEWED_SCHEMA_COMMIT='')]: self.assertNotEqual(self.invoke(**changes).returncode, 0, changes) def test_no_expression_interpolation_and_exact_checkout(self): self.assertNotIn('${{', self.shell) self.assertIn('CI_REF: ${{ github.ref }}', self.workflow) self.assertIn('CI_EVENT: ${{ github.event_name }}', self.workflow) self.assertIn('[[ $(git rev-parse HEAD) == "$sha" ]]', self.shell) self.assertEqual(hashlib.sha256((ROOT / 'scripts/auth-schema-reconcile.sql').read_bytes()).hexdigest(), self.digest) self.assertIn('SQL_SHA: ' + self.digest, self.workflow) self.assertIn('APPROVAL_ID: CEO-AUTH-SCHEMA-20261025', self.workflow) subprocess.run(['bash', '-n'], input=self.shell, text=True, check=True) if __name__ == '__main__': unittest.main(verbosity=2)