Files
mesh-delivery/modules/mesh-delivery-contracts/go/seats/git/contract.go
T
jschoubben 67caa79640 H-A-376: the runner's list answers short rows, show each mover's row
list answers by default the newest 20 short rows (key, call, start, end,
outcome, movers' count and the first failed or could-not-run step with its
module and why), and the whole pipelines only with full and a limit. show
answers one mover's steps when it names one, the steps its filters hold,
or else each mover's row, never every step of every mover. The tools
program describes each seat verb's tool from its contract, which seatgen
now generates a VerbDescription for; runner_cancel reads the whole
pipelines with full. The runner seat's form is 6.

Builds: design 47 H2 H-A-376, H-A-449, §789
2026-11-22 02:14:51 +01:00

1239 lines
50 KiB
Go

// Code generated by seatgen from the seat definitions; DO NOT EDIT.
// Package git is the contract of the seat "git", defined whole (seats/git/seat.json): The forge: every read and act a delivery part makes of the mesh's git repositories, and what the forge says happened (design 47 *The seat git*, ADR 0596 §1, §2). A failed read answers an error, never an empty answer.
package git
import (
"encoding/json"
"strings"
"time"
)
// Seat is the seat's name.
const Seat = "git"
// Form is the form of the seat's values, events and answers this contract was generated at (design 47 H2 §780):
// a reader of a value of another form says "form N, this reader knows M".
const Form = 2
// The forms and the digest of the fields this contract was generated from: the generator's compare fails a definition
// whose fields changed while its forms did not (design 47 H2 §780).
const (
generatedForms = "2"
generatedFieldsDigest = "BranchAnswer=1cc6612a710e BranchMovedEvent=baaa6fdf37f2 Call=ebef3639e061 CallMember=8d7bf9b9c258 CallsByCallCallValue=05142ac90d52 Change=5a13d1572e59 CommentAnswer=74ec3ece9f05 ContainsAnswer=071d0e9742bd ErrorKind=3d26b2c1442a FailedStep=d68341819717 FailedStepsByModuleFingerprintStepValue=0fce6f5d3273 FileAnswer=8fcc52522004 ForgeDeleteEvent=35a0828a1238 ForgePullEvent=303345c390d7 ForgeStatusEvent=689488c43094 MemberOutcome=c35056683738 MergeCalled=cb5a36d22c92 MergeCalledEvent=8597a63a790c MergeCalledMembersItem=211bdc9bab48 MergeCalledRefusedItem=bbf9ce4382c8 MergePullAnswer=4ada4a7040bb Merging=482fbecedd58 NoteAnswer=74ec3ece9f05 OpenPull=56217c4c348a OpenPullsAnswer=a15ee399a171 Pull=6e3fdd146b1c PullAnswer=a8def6c28bf9 PullClosedEvent=c2b7ac1de473 PullMergedEvent=619d9c863307 PullUpdatedEvent=f86ee614998e RepoWritableEvent=1a8c6e6344ba Status=b2980533a044 StatusAnswer=74ec3ece9f05 StatusesAnswer=1c524343c18d Tag=b419017f7885 TagAnswer=8c1fa0ac9f1b TagsAnswer=77e4374f7d62 TreesAnswer=bc1ffccd2716 ViewAnswer=74ec3ece9f05"
)
const (
VerbPull = "pull"
VerbBranch = "branch"
VerbOpenPulls = "open-pulls"
VerbTags = "tags"
VerbTrees = "trees"
VerbFile = "file"
VerbContains = "contains"
VerbStatuses = "statuses"
VerbStatus = "status"
VerbComment = "comment"
VerbView = "view"
VerbNote = "note"
VerbMergePull = "merge-pull"
VerbTag = "tag"
)
const (
EventPullUpdated = "pull-updated"
EventPullMerged = "pull-merged"
EventPullClosed = "pull-closed"
EventForgePull = "forge-pull"
EventForgeStatus = "forge-status"
EventForgeDelete = "forge-delete"
EventRepoWritable = "repo-writable"
EventBranchMoved = "branch-moved"
EventMergeCalled = "merge-called"
)
// Verbs is every verb the seat serves, in its definition's order: a new copy each call.
func Verbs() []string {
return []string{VerbPull, VerbBranch, VerbOpenPulls, VerbTags, VerbTrees, VerbFile, VerbContains, VerbStatuses, VerbStatus, VerbComment, VerbView, VerbNote, VerbMergePull, VerbTag}
}
// VerbDescription is a verb's description as the seat's definition says it, "" for a verb the seat does not serve or
// does not describe (design 47 H2 H-A-449).
func VerbDescription(verb string) string {
switch verb {
case VerbPull:
return "One pull request, by its repository and number or by its merge commit: its number, base, head branch, head, merge commit, author and state; for an open one, also what the forge would merge now (merging). A pull request the forge does not hold answers an error naming it."
case VerbBranch:
return "A branch's head (design 47 *The seat git*, *Watched branches and the catalog graph per branch*). A branch the forge does not hold answers the error kind not-found."
case VerbOpenPulls:
return "Every open pull request of every repository, its head and base, the statuses its base's protection requires and those its head has."
case VerbTags:
return "A repository's tags, a page at a time, newest first; the page's bound is said, and more when another page exists."
case VerbTrees:
return "The trees of one commit: the root tree and the tree of every directory that holds a module.json, by their git hashes; with files, every blob under each named directory; with paths, the object of each named path. A listing the forge cut is refused, never answered in part. A directory named in files or paths that the commit does not hold answers the error kind not-found (design 47 H2 §796)."
case VerbFile:
return "One file at one commit, branch or tag, decoded; a file over 512 KiB is refused. An absent file is answered absent only when the forge said so."
case VerbContains:
return "Whether one commit contains another: an ancestor of it, or the same."
case VerbStatuses:
return "The statuses a commit carries, the newest of each context."
case VerbStatus:
return "Set a commit status. An act: its id is the caller's, and the same id said again sets it again to the same."
case VerbComment:
return "Add a comment to a pull request. The comment carries the act's id, and an id the pull request already holds is skipped (held)."
case VerbView:
return "Keep the delivery's one view comment on a pull request: made the first time, edited in place after; it carries the act's id, and an id already held is skipped (held)."
case VerbNote:
return "Append one line to a commit's note under refs/notes/mesh-plan. The line carries the act's id, and an id the note already holds is skipped (held)."
case VerbMergePull:
return "Merge one or more pull requests with the forge tools' account, each at the head the caller names: one merge call, a delivery's start and, with two or more members, its group (design 47 H §734, §735, §766; ADR 0682 §1, §2). Every member is judged before any is merged: still the pull request's head, its base a watched branch, no run at the head's build-input fingerprint failed a required step (judged from its own state failed-steps), registrations heard; no branch protection is read. When one member is refused, none is merged. Then it merges them in the order named, writing the call in its state calls before the first merge, and says merge-called once. It answers once, at the call's end, naming the call and each member's outcome; a member already merged is refused already-merged, naming its commit."
case VerbTag:
return "Write the git tag of a released version, <directory>/vMAJOR.MINOR.PATCH for a Go package (design 47 H2 §796), at the commit its build was made from; the builder writes it only on the catalog's version-released (design 47 G section 370). A tag already at that commit is answered performed. An error answer carries error and error-kind."
}
return ""
}
// Events is every event published on the seat's subject: a new copy each call.
func Events() []string {
return []string{EventPullUpdated, EventPullMerged, EventPullClosed, EventForgePull, EventForgeStatus, EventForgeDelete, EventRepoWritable, EventBranchMoved, EventMergeCalled}
}
// Family is where the seat's events are kept: the shared events stream, filtered to the seat's subjects.
const (
Family = "git.events"
FamilyMaxAgeDays = 7
)
// SubjectPullUpdated is where pull-updated is published.
const SubjectPullUpdated = "mesh.seat.git.event.pull-updated"
// SubjectPullMerged is where pull-merged is published.
const SubjectPullMerged = "mesh.seat.git.event.pull-merged"
// SubjectPullClosed is where pull-closed is published.
const SubjectPullClosed = "mesh.seat.git.event.pull-closed"
// SubjectForgePull is where forge-pull is published.
const SubjectForgePull = "mesh.seat.git.event.forge-pull"
// SubjectForgeStatus is where forge-status is published.
const SubjectForgeStatus = "mesh.seat.git.event.forge-status"
// SubjectForgeDelete is where forge-delete is published.
const SubjectForgeDelete = "mesh.seat.git.event.forge-delete"
// SubjectRepoWritable is where repo-writable is published.
const SubjectRepoWritable = "mesh.seat.git.event.repo-writable"
// StreamBranchMoved is the stream branch-moved is kept in.
const StreamBranchMoved = "SEAT_git_branch-moved"
// SubjectBranchMoved is where branch-moved is published.
const SubjectBranchMoved = "mesh.seat.git.event.branch-moved"
// StreamMergeCalled is the stream merge-called is kept in.
const StreamMergeCalled = "SEAT_git_merge-called"
// SubjectMergeCalled is where merge-called is published, on mesh.seat.git.event.merge-called.<call>.
func SubjectMergeCalled(call string) string { return "mesh.seat.git.event.merge-called." + call }
// SubjectMergeCalledAll hears every merge-called.
const SubjectMergeCalledAll = "mesh.seat.git.event.merge-called.*"
const (
StateFailedSteps = "failed-steps"
StateCalls = "calls"
)
// FailedStepsByModuleFingerprintStepKey is the key of one value of the state failed-steps under the form "<module>.<fingerprint>.<step>".
func FailedStepsByModuleFingerprintStepKey(module, fingerprint, step string) string {
return module + "." + fingerprint + "." + step
}
// ParseFailedStepsByModuleFingerprintStepKey reads the parts of a key of the form "<module>.<fingerprint>.<step>", in the order of the form; the last result is false for a key of another form.
func ParseFailedStepsByModuleFingerprintStepKey(key string) (string, string, string, bool) {
rest := key
v0, after0, found0 := strings.Cut(rest, ".")
if !found0 || v0 == "" {
return "", "", "", false
}
rest = after0
v2, after2, found2 := strings.Cut(rest, ".")
if !found2 || v2 == "" {
return "", "", "", false
}
rest = after2
if rest == "" {
return "", "", "", false
}
v4 := rest
rest = ""
if rest != "" {
return "", "", "", false
}
return v0, v2, v4, true
}
// DecodeFailedStepsByModuleFingerprintStepValue reads one value of the state failed-steps under the form "<module>.<fingerprint>.<step>" as another part wrote it: a field FailedStepsByModuleFingerprintStepValue does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeFailedStepsByModuleFingerprintStepValue(raw []byte) (FailedStepsByModuleFingerprintStepValue, int, error) {
var v FailedStepsByModuleFingerprintStepValue
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// CallsByCallCallKey is the key of one value of the state calls under the form "call.<call>".
func CallsByCallCallKey(call string) string { return "call." + call }
// ParseCallsByCallCallKey reads the parts of a key of the form "call.<call>", in the order of the form; the last result is false for a key of another form.
func ParseCallsByCallCallKey(key string) (string, bool) {
rest := key
if !strings.HasPrefix(rest, "call.") {
return "", false
}
rest = rest[5:]
if rest == "" {
return "", false
}
v1 := rest
rest = ""
if rest != "" {
return "", false
}
return v1, true
}
// DecodeCallsByCallCallValue reads one value of the state calls under the form "call.<call>" as another part wrote it: a field CallsByCallCallValue does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeCallsByCallCallValue(raw []byte) (CallsByCallCallValue, int, error) {
var v CallsByCallCallValue
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// Call is one merge call, written before its first merge and updated as each member merges (design 47 H §766).
type Call struct {
// the bus account the tool runner proved for the call
Account string `json:"account"`
At time.Time `json:"at"`
// the caller as who@node
By string `json:"by"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
Members []CallMember `json:"members"`
// merge-called was said for it
Said bool `json:"said"`
}
// CallMember is one member of a kept call.
type CallMember struct {
// the pull request's base, a watched branch, read at judging
Branch string `json:"branch"`
// for merged, the merge commit
Commit string `json:"commit,omitempty"`
Head string `json:"head"`
Number int64 `json:"number"`
Repository string `json:"repository"`
State string `json:"state"`
// for refused, why
Why string `json:"why,omitempty"`
}
// The values of CallMember's state.
const (
CallMemberStateJudged = "judged"
CallMemberStateMerged = "merged"
CallMemberStateRefused = "refused"
)
// Change is what a pull request changed.
type Change struct {
// the changed directories that hold a module at its head; absent when they could not be read
ModuleDirs []string `json:"module-dirs,omitempty"`
// the paths it changed
Paths []string `json:"paths"`
// the forge cut the list
PathsTruncated bool `json:"paths-truncated,omitempty"`
// which of them it deleted
Removed []string `json:"removed,omitempty"`
}
// ErrorKind is which kind of error, set with error alone: refused, the forge or the holder refused and error says why in the forge's own words; not-found, the forge said that what was asked about (a repository, a commit, a pull request, a branch or a tag) does not exist, so a caller never reads it out of error's words; failed, the forge failed or could not be reached, so the act or read could not be performed; away, a part the holder depends on (the forge, its store) is away, with part naming what did not answer and words: a caller reads it as a transport fault and calls again (design 47 H2 §776).
type ErrorKind = string
// The values of ErrorKind.
const (
ErrorKindRefused = "refused"
ErrorKindNotFound = "not-found"
ErrorKindFailed = "failed"
ErrorKindAway = "away"
)
// FailedStep is a failed required step at a build-input fingerprint, with the commits it was seen at and the run that failed it (design 47 *Judged from its own state, never by a call*); cleared by a later passing rerun of that step whose proved caller is the operator or a healer.
type FailedStep struct {
// the artifact reference, <module>:<artifact>
Artifact string `json:"artifact,omitempty"`
At *time.Time `json:"at,omitempty"`
// every commit it was seen at
Commits []string `json:"commits"`
// the build-input fingerprint the step failed at
Fingerprint string `json:"fingerprint"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
Module string `json:"module"`
// the run that failed it: the runner's pipeline key
Run string `json:"run"`
// why it failed, as the runner's step-ended said
Said string `json:"said,omitempty"`
Step string `json:"step"`
// the layout version
V int64 `json:"v,omitempty"`
}
// MemberOutcome is one member of a merge call and where it stands (design 47 H §766, H-A-22).
type MemberOutcome struct {
// for merged, the merge commit; for a member refused already-merged, its commit
Commit string `json:"commit,omitempty"`
Number int64 `json:"number"`
Repository string `json:"repository"`
// judged, judged and not merged; merged, with its commit; refused, with why
State string `json:"state"`
// for refused, why, naming the step for a failed required step
Why string `json:"why,omitempty"`
}
// The values of MemberOutcome's state.
const (
MemberOutcomeStateJudged = "judged"
MemberOutcomeStateMerged = "merged"
MemberOutcomeStateRefused = "refused"
)
// Merging is what the forge would merge now, for an open pull request (issues 1275, 1945; ADR 0441 §1): answered whole or not at all, and a read the forge could not make answers the verb's error, never a guess; absent for a merged or closed one.
type Merging struct {
// the forge's own word on whether it merges into its base now: false while it is in conflict with its base, or while the forge works that out after the base moved
Mergeable bool `json:"mergeable"`
// whether a protection rule guards its base branch
Protected bool `json:"protected"`
// the status contexts the base branch's protection requires; none when it requires none
Required []string `json:"required"`
// whether the forge's merging account may write the repository: false, its statuses and its merge are refused
Writes bool `json:"writes"`
}
// OpenPull is an open pull request, with the statuses its base requires and those its head has.
type OpenPull struct {
// the head's statuses by context, the newest of each
Checks map[string]Status `json:"checks"`
Pull Pull `json:"pull"`
// the contexts the base branch's protection requires; none when it requires none
Required []string `json:"required"`
}
// Pull is one pull request as the forge holds it; never its description (ADR 0659 §1).
type Pull struct {
// who opened it, the forge's login
Author string `json:"author,omitempty"`
// the branch it merges into
Base string `json:"base"`
// its head branch: what a delivery group is named by
Branch string `json:"branch"`
// a commit, its full 40-hex sha
Head string `json:"head"`
// the merge commit, once merged
MergeCommit string `json:"merge-commit,omitempty"`
// when it merged
MergedAt *time.Time `json:"merged-at,omitempty"`
// the pull request's number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// open, merged or closed
State string `json:"state"`
// its title
Title string `json:"title,omitempty"`
// its page on the forge
URL string `json:"url,omitempty"`
}
// The values of Pull's state.
const (
PullStateOpen = "open"
PullStateMerged = "merged"
PullStateClosed = "closed"
)
// Status is the newest status of one context on a commit.
type Status struct {
// when it was set
At *time.Time `json:"at,omitempty"`
// who set it
By string `json:"by,omitempty"`
// the status's context, such as mesh/check
Context string `json:"context"`
// what it says
Description string `json:"description,omitempty"`
// pending, success, failure, error or warning
State string `json:"state"`
// the page it links to
Target string `json:"target,omitempty"`
}
// Tag is a tag and the commit it names (design 47 H2 §796).
type Tag struct {
// the commit it names, its full 40-hex sha
Commit string `json:"commit"`
Tag string `json:"tag"`
}
// MergeCalledMembersItem is a type of the contract.
type MergeCalledMembersItem struct {
// the pull request's base, a watched branch
Branch string `json:"branch"`
// the merge commit the forge records for the pull request
Commit string `json:"commit"`
Head string `json:"head"`
Number int64 `json:"number"`
Repository string `json:"repository"`
}
// MergeCalledRefusedItem is a type of the contract.
type MergeCalledRefusedItem struct {
Number int64 `json:"number"`
Repository string `json:"repository"`
Why string `json:"why"`
}
// MergeCalled is a merge call's members merged or refused, said once by the forge module (design 47 H §736, §767).
type MergeCalled struct {
// the bus account the tool runner proved
Account string `json:"account"`
// the time of the last merge
At time.Time `json:"at"`
// the caller as who@node
By string `json:"by"`
// the merge call, 16 lowercase hex characters made once per call
Call string `json:"call"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// one per landed member
Members []MergeCalledMembersItem `json:"members"`
// one per member not merged after every member was judged (design 47 H §767)
Refused []MergeCalledRefusedItem `json:"refused,omitempty"`
}
// PullInput is what pull takes.
type PullInput struct {
// instead of the number: the merge commit it made
MergeCommit string `json:"merge-commit,omitempty"`
// its number
Number int64 `json:"number,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// PullAnswer is what pull answers.
type PullAnswer struct {
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
Merging *Merging `json:"merging,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
Pull *Pull `json:"pull,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// BranchInput is what branch takes.
type BranchInput struct {
Branch string `json:"branch"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// BranchAnswer is what branch answers.
type BranchAnswer struct {
Branch string `json:"branch,omitempty"`
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// a commit, its full 40-hex sha
Head string `json:"head,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
Repository string `json:"repository,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// OpenPullsInput is what open-pulls takes.
type OpenPullsInput struct {
}
// OpenPullsAnswer is what open-pulls answers.
type OpenPullsAnswer struct {
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// every open pull request; said empty when none is open, so an answer that lacks it is never read as none
Pulls []OpenPull `json:"pulls"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// TagsInput is what tags takes.
type TagsInput struct {
// the page, from 1
Page int64 `json:"page,omitempty"`
// only tags starting with it
Prefix string `json:"prefix,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// TagsAnswer is what tags answers.
type TagsAnswer struct {
// how many tags a page holds
Bound int64 `json:"bound,omitempty"`
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// another page exists
More bool `json:"more,omitempty"`
// the page
Page int64 `json:"page,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository,omitempty"`
// the tags of this page, each with the commit it names (design 47 H2 §796)
Tags []Tag `json:"tags,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// TreesInput is what trees takes.
type TreesInput struct {
// a commit, its full 40-hex sha
Commit string `json:"commit"`
// directories whose every blob is answered; the root is the empty name
Files []string `json:"files,omitempty"`
// {directory: [path relative to it]}; the root is the empty name
Paths map[string][]string `json:"paths,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// TreesAnswer is what trees answers.
type TreesAnswer struct {
// a commit, its full 40-hex sha
Commit string `json:"commit,omitempty"`
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// directory to {path: blob id}
Files map[string]map[string]string `json:"files,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// directory to {path: object id}
Paths map[string]map[string]string `json:"paths,omitempty"`
// the root tree's hash
Root string `json:"root,omitempty"`
// directory to its tree's hash, the root as the empty name
Trees map[string]string `json:"trees,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// FileInput is what file takes.
type FileInput struct {
// the file's path from the repository's root
Path string `json:"path"`
// a commit, branch or tag; the default branch when absent
Ref string `json:"ref,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// FileAnswer is what file answers.
type FileAnswer struct {
// the forge holds no such file there
Absent bool `json:"absent,omitempty"`
// the file's git blob id
Blob string `json:"blob,omitempty"`
// its content
Content string `json:"content,omitempty"`
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the path
Path string `json:"path,omitempty"`
// what was read
Ref string `json:"ref,omitempty"`
// its size in bytes
Size int64 `json:"size,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// ContainsInput is what contains takes.
type ContainsInput struct {
// the commit asked about
Commit string `json:"commit"`
// the commit it may be contained in
In string `json:"in"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// ContainsAnswer is what contains answers.
type ContainsAnswer struct {
// how many commits commit is ahead of in
Ahead int64 `json:"ahead,omitempty"`
// the commit
Commit string `json:"commit,omitempty"`
// in contains commit
Contains bool `json:"contains,omitempty"`
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the other
In string `json:"in,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// StatusesInput is what statuses takes.
type StatusesInput struct {
// a commit, its full 40-hex sha
Commit string `json:"commit"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// StatusesAnswer is what statuses answers.
type StatusesAnswer struct {
// the forge's combined state
Combined string `json:"combined,omitempty"`
// a commit, its full 40-hex sha
Commit string `json:"commit,omitempty"`
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the newest of each context
Statuses []Status `json:"statuses,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// StatusInput is what status takes.
type StatusInput struct {
// a commit, its full 40-hex sha
Commit string `json:"commit"`
// the context, such as mesh/check
Context string `json:"context"`
// what it says
Description string `json:"description,omitempty"`
// the act's id
ID string `json:"id"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// the state
State string `json:"state"`
// the page it links to
Target string `json:"target,omitempty"`
}
// The values of StatusInput's state.
const (
StatusInputStatePending = "pending"
StatusInputStateSuccess = "success"
StatusInputStateFailure = "failure"
StatusInputStateError = "error"
StatusInputStateWarning = "warning"
)
// StatusAnswer is what status answers.
type StatusAnswer struct {
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the id was already held on the pull request or the note, so nothing was done again
Held bool `json:"held,omitempty"`
// the act's id, as the caller gave it
ID string `json:"id,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the forge holds the act now
Performed bool `json:"performed,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// CommentInput is what comment takes.
type CommentInput struct {
// the act's id
ID string `json:"id"`
// the pull request's number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// the comment, markdown
Text string `json:"text"`
}
// CommentAnswer is what comment answers.
type CommentAnswer struct {
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the id was already held on the pull request or the note, so nothing was done again
Held bool `json:"held,omitempty"`
// the act's id, as the caller gave it
ID string `json:"id,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the forge holds the act now
Performed bool `json:"performed,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// ViewInput is what view takes.
type ViewInput struct {
// the act's id
ID string `json:"id"`
// the pull request's number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// the view, markdown
Text string `json:"text"`
}
// ViewAnswer is what view answers.
type ViewAnswer struct {
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the id was already held on the pull request or the note, so nothing was done again
Held bool `json:"held,omitempty"`
// the act's id, as the caller gave it
ID string `json:"id,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the forge holds the act now
Performed bool `json:"performed,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// NoteInput is what note takes.
type NoteInput struct {
// a commit, its full 40-hex sha
Commit string `json:"commit"`
// the act's id
ID string `json:"id"`
// the line, one line
Line string `json:"line"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// NoteAnswer is what note answers.
type NoteAnswer struct {
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the id was already held on the pull request or the note, so nothing was done again
Held bool `json:"held,omitempty"`
// the act's id, as the caller gave it
ID string `json:"id,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the forge holds the act now
Performed bool `json:"performed,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// MergePullInputPullsItem is a type of the contract.
type MergePullInputPullsItem struct {
// the head the caller names
Head string `json:"head"`
// the pull request's number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// MergePullInput is what merge-pull takes.
type MergePullInput struct {
// the caller as who@node, recorded beside the bus account the tool runner proves
By string `json:"by"`
// the members, in the order they are merged
Pulls []MergePullInputPullsItem `json:"pulls"`
}
// MergePullAnswer is what merge-pull answers.
type MergePullAnswer struct {
// the merge call, 16 lowercase hex characters made once per call
Call string `json:"call,omitempty"`
// why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// each member's outcome, in the order named
Members []MemberOutcome `json:"members,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// TagInput is what tag takes.
type TagInput struct {
// the commit it is written at
Commit string `json:"commit"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// the tag
Tag string `json:"tag"`
}
// TagAnswer is what tag answers.
type TagAnswer struct {
// why the forge could not write it: set alone with error-kind
Error string `json:"error,omitempty"`
ErrorKind ErrorKind `json:"error-kind,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// with the error kind away, what did not answer (design 47 H2 §776)
Part string `json:"part,omitempty"`
// the forge holds the tag at that commit now
Performed bool `json:"performed,omitempty"`
// the tag, as asked
Tag string `json:"tag,omitempty"`
// with the error kind away, the holder's words (design 47 H2 §776)
Words string `json:"words,omitempty"`
}
// PullUpdatedEvent is the body of the event pull-updated.
type PullUpdatedEvent struct {
// who opened it
Author string `json:"author,omitempty"`
// the branch it merges into
Base string `json:"base"`
// the base branch's head as the head was announced; absent when it could not be read
BaseHead string `json:"base-head,omitempty"`
// its head branch
Branch string `json:"branch"`
Change *Change `json:"change,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// a commit, its full 40-hex sha
Head string `json:"head"`
// the pull request's number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// its title
Title string `json:"title,omitempty"`
// its page
URL string `json:"url,omitempty"`
}
// PullMergedEvent is the body of the event pull-merged.
type PullMergedEvent struct {
// who opened it
Author string `json:"author,omitempty"`
// the branch it merges into
Base string `json:"base"`
// its head branch
Branch string `json:"branch"`
Change *Change `json:"change,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// a commit, its full 40-hex sha
Head string `json:"head"`
// the head's statuses by context, their states; absent when they could not be read
HeadChecks map[string]string `json:"head-checks,omitempty"`
// a commit, its full 40-hex sha
MergeCommit string `json:"merge-commit"`
// when
MergedAt *time.Time `json:"merged-at,omitempty"`
// the pull request's number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// its title
Title string `json:"title,omitempty"`
// its page
URL string `json:"url,omitempty"`
}
// PullClosedEvent is the body of the event pull-closed.
type PullClosedEvent struct {
// who opened it
Author string `json:"author,omitempty"`
// the branch it merges into
Base string `json:"base"`
// its head branch
Branch string `json:"branch"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// a commit, its full 40-hex sha
Head string `json:"head"`
// the pull request's number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// its title
Title string `json:"title,omitempty"`
// its page
URL string `json:"url,omitempty"`
}
// ForgePullEvent is the body of the event forge-pull.
type ForgePullEvent struct {
// what the forge said: opened, reopened, synchronized, edited, closed, merged
Action string `json:"action"`
// who opened it
Author string `json:"author,omitempty"`
// its base branch
Base string `json:"base,omitempty"`
// its head branch
Branch string `json:"branch,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// its head commit
Head string `json:"head,omitempty"`
// the merge commit
MergeCommit string `json:"merge-commit,omitempty"`
// merged
Merged bool `json:"merged,omitempty"`
// its number
Number int64 `json:"number"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// who acted
Sender string `json:"sender,omitempty"`
}
// ForgeStatusEvent is the body of the event forge-status.
type ForgeStatusEvent struct {
// the commit
Commit string `json:"commit"`
// the context
Context string `json:"context"`
// what it says
Description string `json:"description,omitempty"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// who set it
Sender string `json:"sender,omitempty"`
// the state
State string `json:"state"`
}
// ForgeDeleteEvent is the body of the event forge-delete.
type ForgeDeleteEvent struct {
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the deleted branch or tag
Ref string `json:"ref"`
// branch or tag
RefType string `json:"ref-type,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
// who deleted it
Sender string `json:"sender,omitempty"`
}
// RepoWritableEvent is the body of the event repo-writable.
type RepoWritableEvent struct {
// the account that writes it now
Account string `json:"account"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// BranchMovedEvent is the body of the event branch-moved.
type BranchMovedEvent struct {
At *time.Time `json:"at,omitempty"`
Branch string `json:"branch"`
// is the form of what this value carries, left out while it is 1 (design 47 H2 §780).
Form int64 `json:"form,omitempty"`
// the head the webhook said, a commit's full 40-hex sha; read again by branch
Head string `json:"head,omitempty"`
// the repository, <owner>/<name>
Repository string `json:"repository"`
}
// MergeCalledEvent is the body of the event merge-called.
type MergeCalledEvent = MergeCalled
// FailedStepsByModuleFingerprintStepValue is one value of the state failed-steps under the key <module>.<fingerprint>.<step>.
type FailedStepsByModuleFingerprintStepValue = FailedStep
// CallsByCallCallValue is one value of the state calls under the key call.<call>.
type CallsByCallCallValue = Call
// DecodePullAnswer reads a PullAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodePullAnswer(raw []byte) (PullAnswer, int, error) {
var v PullAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeBranchAnswer reads a BranchAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeBranchAnswer(raw []byte) (BranchAnswer, int, error) {
var v BranchAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeOpenPullsAnswer reads a OpenPullsAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeOpenPullsAnswer(raw []byte) (OpenPullsAnswer, int, error) {
var v OpenPullsAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeTagsAnswer reads a TagsAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeTagsAnswer(raw []byte) (TagsAnswer, int, error) {
var v TagsAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeTreesAnswer reads a TreesAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeTreesAnswer(raw []byte) (TreesAnswer, int, error) {
var v TreesAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeFileAnswer reads a FileAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeFileAnswer(raw []byte) (FileAnswer, int, error) {
var v FileAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeContainsAnswer reads a ContainsAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeContainsAnswer(raw []byte) (ContainsAnswer, int, error) {
var v ContainsAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeStatusesAnswer reads a StatusesAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeStatusesAnswer(raw []byte) (StatusesAnswer, int, error) {
var v StatusesAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeStatusAnswer reads a StatusAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeStatusAnswer(raw []byte) (StatusAnswer, int, error) {
var v StatusAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeCommentAnswer reads a CommentAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeCommentAnswer(raw []byte) (CommentAnswer, int, error) {
var v CommentAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeViewAnswer reads a ViewAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeViewAnswer(raw []byte) (ViewAnswer, int, error) {
var v ViewAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeNoteAnswer reads a NoteAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeNoteAnswer(raw []byte) (NoteAnswer, int, error) {
var v NoteAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeMergePullAnswer reads a MergePullAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeMergePullAnswer(raw []byte) (MergePullAnswer, int, error) {
var v MergePullAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeTagAnswer reads a TagAnswer as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeTagAnswer(raw []byte) (TagAnswer, int, error) {
var v TagAnswer
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodePullUpdatedEvent reads a PullUpdatedEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodePullUpdatedEvent(raw []byte) (PullUpdatedEvent, int, error) {
var v PullUpdatedEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodePullMergedEvent reads a PullMergedEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodePullMergedEvent(raw []byte) (PullMergedEvent, int, error) {
var v PullMergedEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodePullClosedEvent reads a PullClosedEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodePullClosedEvent(raw []byte) (PullClosedEvent, int, error) {
var v PullClosedEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeForgePullEvent reads a ForgePullEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeForgePullEvent(raw []byte) (ForgePullEvent, int, error) {
var v ForgePullEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeForgeStatusEvent reads a ForgeStatusEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeForgeStatusEvent(raw []byte) (ForgeStatusEvent, int, error) {
var v ForgeStatusEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeForgeDeleteEvent reads a ForgeDeleteEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeForgeDeleteEvent(raw []byte) (ForgeDeleteEvent, int, error) {
var v ForgeDeleteEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeRepoWritableEvent reads a RepoWritableEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeRepoWritableEvent(raw []byte) (RepoWritableEvent, int, error) {
var v RepoWritableEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeBranchMovedEvent reads a BranchMovedEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeBranchMovedEvent(raw []byte) (BranchMovedEvent, int, error) {
var v BranchMovedEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// DecodeMergeCalledEvent reads a MergeCalledEvent as another part wrote it: a field this reader does not know is left unread, never refused; the form read is answered, 1 when absent (design 47 H2 §780).
func DecodeMergeCalledEvent(raw []byte) (MergeCalledEvent, int, error) {
var v MergeCalledEvent
if err := json.Unmarshal(raw, &v); err != nil {
return v, 0, err
}
return v, formRead(raw), nil
}
// formRead is the form a value says on the wire: 1 when it says none, or is no object.
func formRead(raw []byte) int {
var f struct {
Form int `json:"form"`
}
if json.Unmarshal(raw, &f) != nil || f.Form < 1 {
return 1
}
return f.Form
}