Подготовить skeleton лабораторной 2 по мессенджеру

scripts/check_contract.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""Offline structural checks; full schema validation is a separate target."""
+import ast
+import json
+from pathlib import Path
+import re
+
+ROOT = Path(__file__).resolve().parents[1]
+
+def main():
+    lab = json.loads((ROOT/'lab.json').read_text())['number']
+    spec = json.loads((ROOT/'contracts/openapi.json').read_text())
+    assert spec['openapi']=='3.1.0'
+    assert spec['info']['version']=='1.%d.0'%lab
+    operation_ids = set()
+    def walk(value):
+        if isinstance(value,dict):
+            if '$ref' in value:
+                pointer = value['$ref']
+                assert pointer.startswith('#/'), 'unexpected external reference'
+                target = spec
+                for part in pointer[2:].split('/'):
+                    target = target[part.replace('~1','/').replace('~0','~')]
+            for v in value.values():
+                walk(v)
+        elif isinstance(value,list):
+            for v in value:
+                walk(v)
+    walk(spec)
+    for route,methods in spec['paths'].items():
+        placeholders = set(re.findall(r'\{([^}]+)\}',route))
+        for method,op in methods.items():
+            assert op['operationId'] not in operation_ids, 'duplicate operationId'
+            operation_ids.add(op['operationId'])
+            params = {p['name'] for p in op.get('parameters',[]) if p['in']=='path' and p.get('required')}
+            assert placeholders==params, 'path parameter mismatch: '+route
+            for response in op['responses'].values():
+                assert 'X-Request-Id' in response['headers']
+                if lab>=3:
+                    assert 'X-Instance-Id' in response['headers']
+    assert ('/api/v1/auth/sessions' in spec['paths']) == (lab>=2)
+    assert ('/api/v1/attachments/{attachment_id}' in spec['paths']) == (lab>=4)
+    for file in list((ROOT/'tests').glob('*.py'))+list((ROOT/'scripts').glob('*.py')):
+        ast.parse(file.read_text(),filename=str(file))
+    for file in ROOT.rglob('*.json'):
+        if any(part in {'.git','.venv','node_modules','vendor','output'} for part in file.parts):
+            continue
+        json.loads(file.read_text())
+    for required in ('README.md','COURSE.md','CONTRIBUTING.md','REPORT.md','contracts/README.md','tests/smoke.py','tests/README.md'):
+        assert (ROOT/required).is_file(), 'missing '+required
+    print('PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.')
+
+if __name__=='__main__':
+    main()

scripts/restart.example.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+set -eu
+# TODO: copy to restart.sh and implement using YOUR compose/stack services.
+# Restart API and ALL used state stores (DB, sessions, S3, broker as applicable).
+# Preserve persistent volumes and schema/data; never down -v / flush / re-seed.
+# Allow operator unseal if required in lab7; do not print credentials.
+# Exit 0 only after the intended action; test waits for API readiness separately.
+printf '%s
+' 'TODO: implement restart.sh for your infrastructure' >&2
+exit 2

scripts/validate_openapi.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+"""Full OpenAPI and JSON Schema checks; install requirements-dev.txt first."""
+import json
+from pathlib import Path
+from openapi_spec_validator import validate
+from jsonschema import Draft202012Validator
+
+root = Path(__file__).resolve().parents[1]
+spec = json.loads((root/'contracts/openapi.json').read_text())
+validate(spec)
+from referencing import Registry, Resource
+# The base URI resolves local #/components references inside examples.
+resource = dict(spec, **{'$schema': 'https://json-schema.org/draft/2020-12/schema'})
+registry = Registry().with_resource('urn:mtusi:openapi', Resource.from_contents(resource))
+for name, example in json.loads((root/'contracts/examples.json').read_text()).items():
+    schema = {'$ref': 'urn:mtusi:openapi#/components/schemas/' + name}
+    Draft202012Validator(schema, registry=registry).validate(example)
+for path in (root/'contracts').glob('*.schema.json'):
+    schema = json.loads(path.read_text())
+    Draft202012Validator.check_schema(schema)
+    for example in schema.get('examples',[]):
+        Draft202012Validator(schema).validate(example)
+print('PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.')