mould

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #rust #windows #awesome #cli #kubernetes #awesome-list #vue #pytorch #mcp #open-source

(★ 10)

Generate forms + the server that serves 'em using a custom plaintext syntax

mould 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Mould

Mould is an all-inclusive form builder and server that uses a custom syntax for succinctly  declaring a form.

Mould parses the incoming syntax and generates a form and a server that will serve the form and
receive its responses. Responses are saved in a json file and persisted between restarts of the
form server.

## Usage
```
go run main.go --input example-form-format.txt
go build server.go
./server
# Listening on port:  :7272
# Visit localhost:7272 in your browser to see the form in action! :)
```

## Flags

Generating the form page has a few options you can provide, other than the form input, such as
providing custom html and styles:

```
go run main.go --help

-html-footer string
        a single html file containing all of the html that will be presented immediately below the form contents
  -html-header string
        a single html file containing all of the html that will be presented immediately above the form contents
  -input string
        a file containing the form format to generate a form server using
  -stylesheet string
        a single css file containing styles that will be applied to the form (fully replaces mould's default styling)
```

Change the port the server will run on by passing the `--port` flag:

```
go run server.go --help

-port int
        the port to serve the form server on (default 7272)
```

## Example
```
form-title          = Nonsensical Form
form-desc           = Hey! Hello! This is a nonsensical form served by <untitled form>
form-bg             = wheat
form-titlecolor     = purple
form-fg             = black
input[Name]         = Preferred moniker
textarea[Address]   = Your fediverse residence, else null
number[Money]#amount = min=1, max=100, value=1
radio[Sky type]     = Sunny, Rainy, Moony
```

Or generically:

``` 
<element>[<title>]#<key> = <content>
```

**Elements** are on the very left of the equals sign. Elements are a mix of html form elements (`input`, `textarea`) and elements for controlling themes (`form-bg`) or page titles (`form-title`) of the form. This latter group has the prefix `form-`.

Examples: `input`, `radio`, `textarea`, `form-title`,

**required**: You can make a form element be **required**, and blocking submission until filled, by prefixing the element name with an exclamation sign: `!textarea`

**content**, from above, contains the content of the specified element. Typically, this will be used as part of the form element's `placeholder` attribute.
In some cases (`range`, `radio`) the contents will set options on those elements, in others (`form-bg`/`form-fg`) the contents will set colours or the page title (`form-title`).

`[title]` sets the **title** of the form element's corresponding `<label>`.

Example: `email[Email address]` creates an html `input[email]` element with an adjacent visible label of `Email address`.

`#key` sets an explicit **key**, which will be used instead of the title for things like keys on the input (useful if you want shorter html ids)

### Supported form elements

* `<input type="text">` as `input`
* `<textarea>` as `textarea`
* `<input type="range">` as `range`
* `<input type="number">` as `number`
* `<input type="radio">` (radio buttons) as `radio`
* `<input type="hidden">` as `hidden`
* require elements by prefixing a form element with `!` (exclamation mark)
    * `!input[Your favourite tea] = compulsory tea information here` 
* `<input type="email">` as `email`
    * the right-hand side of the email element is the regex pattern that validates it
    * `email[Email address] = .*@.*\..*`
* `<p>` (paragraph) as `form-paragraph`
* ~~checkboxes~~

## Basic auth: Password protection

Mould has support for [http basic authentication](https://en.wikipedia.org/wiki/Basic_access_authentication) with the
`form-password` and `form-user` form options. To enable basic auth set at least `form-password`
in the form syntax input (default user: `mouldy`).

Basic auth should be used in combination with https / TLS secured connections to prevent
snooping the set password (http specifies that basic credentials are passed in plaintext with
the request).

## Mould on the web

Mould is being used to facilitate sticker sharing for a community, see the [repository](https://git.sr.ht/~rostiger/merveilles_stickers) for how its been setup and consider adapting the script [`mould-it`](https://git.sr.ht/~rostiger/merveilles_stickers/tree/main/item/mould-it) if you are considering using Mould.

## How does it work?
Messily!

From the input syntax I generate the html page that will be served for the form as well as go
code, representing the response model. The generated go code is used to parse responses that
the form server receives.

All responses are saved in a local json file every time they come through. Respondents, on
submitting, are redirected to a static url containing their responses, should they forget
what they responded and want to refresh their memory.

The local json file is used to repopulate the form database between server restarts.

## Why did you do this?
Yes, why indeed

Well it's done now!!!

mould

mould 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

mould

mould 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README