Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions .github/workflows/attachment-contracts.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
name: Attachment contracts

on:
pull_request:
branches: [dev, main]
paths:
- 'spec/attachments/**'
- '.github/workflows/attachment-contracts.yml'
workflow_dispatch:

permissions:
contents: read

jobs:
conformance:
name: Attachment v1 conformance
runs-on: ubuntu-24.04
timeout-minutes: 10
steps:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
persist-credentials: false
- name: Install isolated fixture validator dependencies
run: |
python3 -m venv "$RUNNER_TEMP/attachment-contract"
"$RUNNER_TEMP/attachment-contract/bin/python" -m pip install -r spec/attachments/v1/requirements.txt
- name: Validate shared fixtures and contract unit tests without egress
run: |
sudo unshare --net -- "$RUNNER_TEMP/attachment-contract/bin/python" -I spec/attachments/v1/validate.py
sudo unshare --net -- "$RUNNER_TEMP/attachment-contract/bin/python" -I spec/attachments/v1/test_contract.py
- name: Validate synthetic HTTP protocol with loopback only
run: |
sudo unshare --net -- bash -c 'ip link set lo up; exec "$@"' bash \
"$RUNNER_TEMP/attachment-contract/bin/python" -I spec/attachments/v1/test_protocol.py
553 changes: 553 additions & 0 deletions spec/attachments/v1/README.rst

Large diffs are not rendered by default.

47 changes: 47 additions & 0 deletions spec/attachments/v1/constants.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
{
"contract": "fi.attachments.v1",
"schema_version": 1,
"span_attributes": {
"version": "fi.attachment.schema_version",
"references": "fi.attachment.refs",
"session": "fi.attachment.capture_session_id",
"correlation": "fi.attachment.correlation_nonce"
},
"uri_prefix": "fi-attachment:",
"projection": {
"max_entries": 64,
"max_utf8_bytes": 16384
},
"sdk": {
"descriptors": 128,
"owned_bytes": 33554432,
"workers": 2,
"stream_buffer_bytes": 262144,
"transfer_attempts": 3,
"shutdown_seconds": 5,
"finalization_seconds": 30
},
"source_envelope_ttl_seconds": 600,
"unbound_ttl_seconds": 86400,
"organization_limits": {
"active_transfers": 32,
"active_recordings": 8,
"reserved_bytes": 2147483648,
"validation_jobs": 2048,
"initializations_per_minute": 240
},
"manifest_max_utf8_bytes": 1048576,
"default_transfer_mode": "authenticated_stream",
"default_cache_control": "private, no-store",
"completed_recording_import": {
"mode": "completed_recording",
"source_bytes": 1073741824,
"duration_ms": 7200000,
"source_range_bytes": 8388608,
"stream_buffer_bytes": 262144,
"output_window_segments": 1,
"max_job_seconds": 10800,
"source_requirement": "terminal_completed_immutable_bounded_ranges",
"publication": "all_validated_segments_and_bound_manifest_atomically"
}
}
Loading
Loading