test2 state

ErrFormNotFound

ErrBadSlug

ErrSlugTaken

ErrFormClosed

ErrFormOpen

ErrNotOwner

ErrNoFields

ErrTooManyFields

ErrFieldSpecMismatch

ErrBadFieldKind

ErrSelectNoOptions

ErrEmptyLabel

ErrPipeInField

ErrEmptyTitle

ErrTitleTooLong

ErrDescriptionTooLong

ErrBadDeadline

ErrDeadlinePassed

ErrAlreadyResponded

ErrNoResponse

ErrRequired

ErrNotANumber

ErrNotAnOption

ErrAnswerTooLong

ErrTooManyAnswers

ErrNotUserCall

forms

// slug -> \*Form

nextRespID

slugRe

Create

Create publishes a new form under slug, which becomes its ID and its URL segment (/r/\<ns>/forms:\<slug>). Slugs are unique per realm. 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.

CreateForm

CreateForm is Create for the browser: the index page renders it as a gnoweb form, one row per field, so nothing has to be typed into the wallet. Every parameter is a string because gnoweb submits "" for an empty or unchecked input, and "" is not a bool or an int64 as far as the VM is concerned. Checkboxes send "1" when ticked. Blank rows are skipped; a row with an empty kind is text. deadline "" means none.

boolFlag

boolFlag normalises what a checkbox or a human might send to "1" or "0".

create

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.46

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

renderCreateHelp draws the form that creates forms. gnoweb submits it as a CreateForm call with every input mapped to the parameter of the same name.

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.

MinSlugLen

Slug rules. A slug is the form's ID and its URL segment, chosen at creation: lowercase letters and digits, single hyphens between words, 3–48 characters.

MaxSlugLen

Slug rules. A slug is the form's ID and its URL segment, chosen at creation: lowercase letters and digits, single hyphens between words, 3–48 characters.

Form

Form is a published questionnaire and its responses.

Response

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