test state

ErrFormNotFound

ErrFormClosed

ErrFormOpen

ErrNotOwner

ErrNoFields

ErrTooManyFields

ErrFieldSpecMismatch

ErrBadFieldKind

ErrSelectNoOptions

ErrEmptyLabel

ErrEmptyTitle

ErrTitleTooLong

ErrDescriptionTooLong

ErrBadDeadline

ErrDeadlinePassed

ErrAlreadyResponded

ErrNoResponse

ErrRequired

ErrNotANumber

ErrNotAnOption

ErrAnswerTooLong

ErrTooManyAnswers

ErrNotUserCall

forms

// form id -> \*Form

nextFormID

nextRespID

Create

Create publishes a new form and returns its ID. Fields are described by four parallel, pipe-separated strings so the call stays usable from gnokey and gnoweb without structured arguments: labels: "Name|Why gno.land?|Server type" kinds: "text|textarea|select" required: "1|1|0" options: "||cloud,on-prem,data-center" (comma-separated; only select uses it) deadline is a chain height after which the form stops accepting responses, or 0 for none. onePerAddr limits each address to a single response.

Close

Close stops a form from accepting responses. Owner only.

Reopen

Reopen lets a closed form accept responses again. Owner only. A form whose deadline has passed stays closed regardless.

TransferOwnership

TransferOwnership hands a form to another address. Owner only.

GetForm

GetForm returns a form by ID.

ResponseCount

ResponseCount returns how many responses the form currently holds.

FormCount

FormCount returns how many forms exist.

mustGetForm

mustUserCaller

parseFields

parseFields decodes the four parallel field-spec strings.

splitFields

formsPerPage

responsesPerPage

router

init.40

Render

Render routes: /r/<ns>/forms index of forms /r/<ns>/forms:<id> a form, fillable in gnoweb /r/<ns>/forms:<id>/responses its responses, paginated /r/<ns>/forms:<id>/responses.csv its responses as CSV

renderIndex

renderForm

renderMDForm

renderMDForm draws the fillable form. gnoweb turns it into an HTML form that calls Submit; each input is named after the Submit parameter it fills.

renderResponses

renderCSV

renderCSV emits every response as CSV inside a code block, so a reviewer can copy it straight into a spreadsheet.

renderCreateHelp

statusLabel

formURL

responsesURL

csvURL

realmPath

realmURL

realmURL is this realm's path as gnoweb addresses it, derived from where it is deployed rather than hardcoded.

shortAddr

cell

cell makes an answer safe inside a markdown table cell.

csvRow

csvRow quotes every field, doubling embedded quotes, per RFC 4180.

Submit

Submit records a response to a form. Answers a1..a8 align with the form's fields in order; slots beyond the form's field count must be empty. gnoweb builds this call from the rendered form: each input is named after the parameter it fills, and parameters with no input arrive as "". The respondent pays the storage deposit for their own answers, and gets it back on Withdraw.

Withdraw

Withdraw deletes the caller's response to a form. The storage deposit the answers were holding is refunded to the caller by the chain. Only the author can withdraw. Owners cannot delete responses: the refund goes to whoever deletes, which would hand the owner the respondent's deposit.

validateAnswers

validateAnswers checks every answer against its field and returns the trimmed answers, exactly len(f.Fields) long. Nothing is written before it returns, so a rejected submission leaves no trace.

fieldErr

contains

FieldKind

FieldKind is the input type a field renders as, and the validation it gets.

KindText

KindTextarea

KindNumber

KindSelect

MaxFields

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

MaxTitleLen

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

MaxDescriptionLen

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

MaxLabelLen

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

MaxOptionLen

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

MaxTextLen

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

MaxTextareaLen

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

MaxNumberLen

Limits. Answers are stored on chain and the respondent pays the storage deposit for them, so the caps exist to keep that cost predictable rather than to save the realm anything.

Field

Field is one question on a form.

Form

Form is a published questionnaire and its responses.

Response

Response is one submission to a form. Answers align with Form.Fields.