M.V. Hutz
361f529bdc
## Summary - Added doc comments across the codebase: `pkg/lambda`, `pkg/saccharine`, `pkg/codec`, `pkg/engine`, `pkg/iterator`, `pkg/set`, `pkg/convert`, `internal/registry`, and `cmd/lambda`. - Made lambda and saccharine expression structs use public fields instead of getters, matching `go/ast` conventions. - Removed superfluous constructors for saccharine and lambda expression/statement types in favor of struct literals. - Consolidated saccharine token constructors into a single `NewToken` function. - Removed the unused `trace` package. ## Test plan - [x] `go build ./...` passes. - [x] `go test ./...` passes. - [ ] Verify `go doc` output renders correctly for documented packages. Reviewed-on: #45 Co-authored-by: M.V. Hutz <git@maximhutz.me> Co-committed-by: M.V. Hutz <git@maximhutz.me>
28 lines
622 B
Go
28 lines
622 B
Go
package saccharine
|
|
|
|
import (
|
|
"git.maximhutz.com/max/lambda/pkg/codec"
|
|
)
|
|
|
|
// A Codec is a [codec.Codec] that serializes Saccharine expressions.
|
|
type Codec struct{}
|
|
|
|
// Decode parses a string as Saccharine source code. Returns an error
|
|
// if it cannot.
|
|
func (c Codec) Decode(s string) (Expression, error) {
|
|
tokens, err := scan(s)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return parse(tokens)
|
|
}
|
|
|
|
// Encode turns a Saccharine expression into a string. Returns an error if it
|
|
// cannot.
|
|
func (c Codec) Encode(e Expression) (string, error) {
|
|
return stringifyExpression(e), nil
|
|
}
|
|
|
|
var _ codec.Codec[Expression] = (*Codec)(nil)
|