Documentation
¶
Overview ¶
Package rendercycle binds one rendered output to every effect produced by the same controller reconciliation under an authenticated immutable root.
Index ¶
- type Authority
- type Occurrence
- type Snapshot
- func (s *Snapshot) ContentChecksum() (string, error)
- func (s *Snapshot) ExactEqual(other *Snapshot) (bool, error)
- func (s *Snapshot) OutputSnapshot() (*renderoutput.Snapshot, error)
- func (s *Snapshot) RenderedEventSnapshot() (*templating.RenderedEventSnapshot, error)
- func (s *Snapshot) RenderedResourceSnapshot() (*templating.RenderedResourceSnapshot, error)
- func (s *Snapshot) SameRoot(other *Snapshot) (bool, error)
- func (s *Snapshot) StatusPatchSnapshot() (*templating.StatusPatchSnapshot, error)
- func (s *Snapshot) ValidateAuthentication() error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Authority ¶
type Authority struct {
// contains filtered or unexported fields
}
Authority owns one render-cycle lineage and its exact output lineage.
func NewAuthority ¶
func NewAuthority(outputs *renderoutput.Authority) (*Authority, error)
NewAuthority binds a render-output lineage to a new render-cycle lineage.
func (*Authority) ValidateAuthentication ¶
ValidateAuthentication verifies the authority's exact lineage binding.
func (*Authority) ValidateSnapshot ¶
ValidateSnapshot proves that snapshot belongs to this render-cycle lineage.
type Occurrence ¶
type Occurrence struct {
// contains filtered or unexported fields
}
Occurrence identifies one execution that produced an authenticated cycle.
func NewOccurrence ¶
func NewOccurrence(snapshot *Snapshot) (*Occurrence, error)
NewOccurrence seals a new process-local occurrence of snapshot.
func (*Occurrence) Proof ¶
func (o *Occurrence) Proof() (string, error)
Proof returns the diagnostic process-local occurrence identifier.
func (*Occurrence) Same ¶
func (o *Occurrence) Same(other *Occurrence) (bool, error)
Same reports whether other is this exact occurrence.
func (*Occurrence) Snapshot ¶
func (o *Occurrence) Snapshot() (*Snapshot, error)
Snapshot returns the exact cycle bound to this occurrence.
func (*Occurrence) ValidateAuthentication ¶
func (o *Occurrence) ValidateAuthentication() error
ValidateAuthentication verifies the occurrence and its exact cycle binding.
type Snapshot ¶
type Snapshot struct {
// contains filtered or unexported fields
}
Snapshot is one authenticated immutable render output and effect set.
func NewSnapshot ¶
func NewSnapshot( authority *Authority, output *renderoutput.Snapshot, statusPatches *templating.StatusPatchSnapshot, events *templating.RenderedEventSnapshot, renderedResources *templating.RenderedResourceSnapshot, previous *Snapshot, ) (*Snapshot, error)
NewSnapshot validates and seals one complete render cycle. Previous is reused only when every supplied child has the same authenticated root.
func (*Snapshot) ContentChecksum ¶
ContentChecksum returns the checksum authenticated by the bound output root.
func (*Snapshot) ExactEqual ¶
ExactEqual compares every output byte, declaration, and effect. It is an explicit full fallback; checksums only reject unequal outputs.
func (*Snapshot) OutputSnapshot ¶
func (s *Snapshot) OutputSnapshot() (*renderoutput.Snapshot, error)
OutputSnapshot returns the exact authenticated rendered-output root.
func (*Snapshot) RenderedEventSnapshot ¶
func (s *Snapshot) RenderedEventSnapshot() (*templating.RenderedEventSnapshot, error)
RenderedEventSnapshot returns the exact authenticated rendered-event root.
func (*Snapshot) RenderedResourceSnapshot ¶
func (s *Snapshot) RenderedResourceSnapshot() (*templating.RenderedResourceSnapshot, error)
RenderedResourceSnapshot returns the exact authenticated desired-resource root.
func (*Snapshot) StatusPatchSnapshot ¶
func (s *Snapshot) StatusPatchSnapshot() (*templating.StatusPatchSnapshot, error)
StatusPatchSnapshot returns the exact authenticated status-patch root.
func (*Snapshot) ValidateAuthentication ¶
ValidateAuthentication verifies the complete composite root in constant time.
Source Files