babyapi

Apr 23, 2026

Changes in this version

+ func CollectIterator[T any](seq iter.Seq2[T, error]) ([]T, error)

Aug 11, 2025

Changes in this version

+ const MethodSearch

type API

+ Search http.HandlerFunc

+ func (a *API[T]) SetSearchFilter(f func(*http.Request) FilterFunc[T]) *API[T]

+ func (a *API[T]) SetSearchResponseWrapper(searchResponder func([]T) render.Renderer) *API[T]

type AnyResource

+ func (*AnyResource) ParentID() string

type Client

+ func (c *Client[T]) Search(ctx context.Context, rawQuery string, parentIDs ...string) (*Response[*ResourceList[T]], error)

+ func (c *Client[T]) SearchAny(ctx context.Context, rawQuery string, parentIDs ...string) (*Response[any], error)

+ func (c *Client[T]) SearchAnyWithEditor(ctx context.Context, rawQuery string, requestEditor RequestEditor, ...) (*Response[any], error)

+ func (c *Client[T]) SearchRequest(ctx context.Context, rawQuery string, parentIDs ...string) (*http.Request, error)

+ func (c *Client[T]) SearchWithEditor(ctx context.Context, rawQuery string, requestEditor RequestEditor, ...) (*Response[*ResourceList[T]], error)

type DefaultResource

+ func (*DefaultResource) ParentID() string

type KVStorage

+ func (c *KVStorage[T]) Search(_ context.Context, parentID string, query url.Values) ([]T, error)

type NilResource

+ func (*NilResource) ParentID() string

type Resource

+ ParentID func() string

type Storage

+ Search func(ctx context.Context, parentID string, query url.Values) ([]T, error)

Jul 19, 2025

Changes in this version

+ const MCPPermCRUD

+ const MCPPermCreate

+ const MCPPermDelete

+ const MCPPermNone

+ const MCPPermRead

+ const MCPPermUpdate

type API

+ func (a *API[T]) AddMCPHTTPOptions(opts ...server.StreamableHTTPOption) *API[T]

+ func (a *API[T]) AddMCPServerOptions(opts ...server.ServerOption) *API[T]

+ func (a *API[T]) AddMCPTools(tools ...server.ServerTool) *API[T]

+ func (a *API[T]) EnableMCP(defaultCRUDPerm MCPPerm) *API[T]

+ func (a *API[T]) MCPHandler() http.Handler

+ func (a *API[T]) SetMCPPath(path string) *API[T]

+ type MCPPerm uint8

+ func (p MCPPerm) Has(flag MCPPerm) bool

Feb 24, 2025

Changes in this version

type API

+ func (a *API[T]) SetAddress(addr string) *API[T]

Aug 12, 2024

Changes in this version

+ var DefaultMiddleware = []func(http.Handler) http.Handler

type API

+ func (a *API[T]) ApplyDefaultMiddleware(r chi.Router)

Aug 10, 2024

Changes in this version

+ func EnableHTMLRender()

Jun 30, 2024

Changes in this version

type API

+ func (a *API[T]) Modify(modify func(*API[T])) *API[T]

Jun 30, 2024

Changes in this version

+ func GetIDParamFromCtx(ctx context.Context, name string) string

type API

+ func (a *API[T]) GetIDParamFromCtx(ctx context.Context) string

Jun 27, 2024

Changes in this version

type Client

+ func (c *Client[T]) DeleteWithEditor(ctx context.Context, id string, requestEditor RequestEditor, ...) (*Response[T], error)

+ func (c *Client[T]) GetAllAnyWithEditor(ctx context.Context, rawQuery string, requestEditor RequestEditor, ...) (*Response[any], error)

+ func (c *Client[T]) GetAllWithEditor(ctx context.Context, rawQuery string, requestEditor RequestEditor, ...) (*Response[*ResourceList[T]], error)

+ func (c *Client[T]) GetWithEditor(ctx context.Context, id string, requestEditor RequestEditor, ...) (*Response[T], error)

+ func (c *Client[T]) MakeRequestWithEditor(req *http.Request, expectedStatusCode int, requestEditor RequestEditor) (*Response[T], error)

+ func (c *Client[T]) PatchRawWithEditor(ctx context.Context, id, body string, requestEditor RequestEditor, ...) (*Response[T], error)

+ func (c *Client[T]) PatchWithEditor(ctx context.Context, id string, resource T, requestEditor RequestEditor, ...) (*Response[T], error)

+ func (c *Client[T]) PostRawWithEditor(ctx context.Context, body string, requestEditor RequestEditor, ...) (*Response[T], error)

+ func (c *Client[T]) PostWithEditor(ctx context.Context, resource T, requestEditor RequestEditor, ...) (*Response[T], error)

+ func (c *Client[T]) PutRawWithEditor(ctx context.Context, id, body string, requestEditor RequestEditor, ...) (*Response[T], error)

+ func (c *Client[T]) PutWithEditor(ctx context.Context, resource T, requestEditor RequestEditor, ...) (*Response[T], error)

May 18, 2024

Changes in this version

+ func GetRequestBodyFromContext[T any](ctx context.Context) (T, bool)

+ func ReadRequestBodyAndDo[T RendererBinder](do func(*http.Request, T) (T, *ErrResponse), instance func() T) http.HandlerFunc

type ErrResponse

+ func GetFromRequest[T RendererBinder](r *http.Request, instance func() T) (T, *ErrResponse)

+ type RendererBinder interface

May 2, 2024

Changes in this version

+ func EndDatedQueryParam(value bool) url.Values

+ type EndDateable interface

+ EndDated func() bool

+ SetEndDate func(time.Time)

+ type KVStorage struct

+ func (c *KVStorage[T]) Delete(ctx context.Context, id string) error

+ func (c *KVStorage[T]) Get(_ context.Context, id string) (T, error)

+ func (c *KVStorage[T]) GetAll(_ context.Context, query url.Values) ([]T, error)

+ func (c *KVStorage[T]) Set(_ context.Context, item T) error

type Storage

+ func NewKVStorage[T Resource](db hord.Database, prefix string) Storage[T]

Apr 28, 2024

Changes in this version

type Client

+ func (c *Client[T]) GetAllAny(ctx context.Context, rawQuery string, parentIDs ...string) (*Response[any], error)

type FilterFunc

+ func (f FilterFunc[T]) Filter(in []T) []T

Apr 24, 2024

Changes in this version

+ const MethodGetAll

type Client

+ func (c *Client[T]) DeleteRequest(ctx context.Context, id string, parentIDs ...string) (*http.Request, error)

+ func (c *Client[T]) GetAllRequest(ctx context.Context, rawQuery string, parentIDs ...string) (*http.Request, error)

+ func (c *Client[T]) GetRequest(ctx context.Context, id string, parentIDs ...string) (*http.Request, error)

+ func (c *Client[T]) MakeGenericRequest(req *http.Request, target any) error

+ func (c *Client[T]) PatchRequest(ctx context.Context, body io.Reader, id string, parentIDs ...string) (*http.Request, error)

+ func (c *Client[T]) PostRequest(ctx context.Context, body io.Reader, parentIDs ...string) (*http.Request, error)

+ func (c *Client[T]) PutRequest(ctx context.Context, body io.Reader, id string, parentIDs ...string) (*http.Request, error)

Mar 26, 2024

Changes in this version

+ func GetCLIResultFromContext(ctx context.Context) any

+ func NewContextWithCLIResult(ctx context.Context, result any) context.Context

type API

+ func (a *API[T]) Command() *cobra.Command

+ func (a *API[T]) WithContext(ctx context.Context) *API[T]

type Client

+ func (c *Client[T]) Command(name string, input *cliArgs) *cobra.Command

Feb 25, 2024

Changes in this version

type API

+ func (a *API[T]) ApplyExtension(e Extension[T]) *API[T]

+ func (a *API[T]) ChildAPIs() map[string]RelatedAPI

+ func (a *API[T]) SetAfterCreateOrUpdate(afterCreateOrUpdate func(*http.Request, T) *ErrResponse) *API[T]

+ type BuilderError struct

+ func (e BuilderError) Error() string

+ type Extension interface

+ Apply func(*API[T]) error

Feb 2, 2024

Changes in this version

+ type BroadcastChannel struct

+ func (bc *BroadcastChannel[T]) GetInputChannel() chan T

+ func (bc *BroadcastChannel[T]) GetListener() chan T

+ func (bc *BroadcastChannel[T]) RemoveListener(removeChan chan T)

+ func (bc *BroadcastChannel[T]) SendToAll(input T)

type Client

+ Address string

+ func (c *Client[T]) RunFromCLI(args []string, headers []string, query string) (PrintableResponse, error)

+ type PrintableResponse interface

+ Fprint func(out io.Writer, pretty bool) error

Jan 29, 2024

Changes in this version

type API

+ func NewRootAPI(name, base string) *API[*NilResource]

+ func (a *API[T]) CreateClientMap(parent *Client[*AnyResource]) map[string]*Client[*AnyResource]

+ func (a *API[T]) DefaultMiddleware(r chi.Router)

type Client

+ func (c *Client[T]) SetCustomResponseCode(verb string, code int) *Client[T]

+ func (c *Client[T]) SetCustomResponseCodeMap(customResponseCodes map[string]int) *Client[T]

+ type NilResource struct

+ func (*NilResource) Bind(r *http.Request) error

+ func (*NilResource) GetID() string

type RelatedAPI

+ CreateClientMap func(*Client[*AnyResource]) map[string]*Client[*AnyResource]

Dec 29, 2023

Changes in this version

+ var ErrForbidden = &ErrResponse

+ func Handler(do func(http.ResponseWriter, *http.Request) render.Renderer) http.HandlerFunc

+ func MustRenderHTMLMap(tmpl *template.Template, tmplMap map[string]string, name string, data any) string

type API

+ func (a *API[T]) AddCustomRootRoute(route chi.Route) *API[T]

+ func (a *API[T]) AddIDMiddleware(m func(http.Handler) http.Handler) *API[T]

+ func (a *API[T]) AddMiddleware(m func(http.Handler) http.Handler) *API[T]

+ func (a *API[T]) GetRequestedResourceAndDoMiddleware(do func(*http.Request, T) (*http.Request, *ErrResponse)) func(next http.Handler) http.Handler

+ type DefaultRenderer struct

+ func (*DefaultRenderer) Render(w http.ResponseWriter, r *http.Request) error

type RequestEditor

+ var DefaultRequestEditor RequestEditor = func(r *http.Request) error { ... }

Dec 10, 2023

Changes in this version

+ func MustRenderHTML(tmpl *template.Template, data any) string

type API

+ func (a *API[T]) AddServerSentEventHandler(pattern string) chan *ServerSentEvent

+ func (a *API[T]) Done() <-chan os.Signal

+ func (a *API[T]) HandleServerSentEvents(events <-chan *ServerSentEvent) http.HandlerFunc

+ func (a *API[T]) SetCustomResponseCode(verb string, code int) *API[T]

+ func (a *API[T]) SetGetAllResponseWrapper(getAllResponder func([]T) render.Renderer) *API[T]

+ func (a *API[T]) SetResponseWrapper(responseWrapper func(T) render.Renderer) *API[T]

+ func (a *API[T]) Storage() Storage[T]

+ type HTMLer interface

+ HTML func(*http.Request) string

+ type RelatedAPI interface

+ Base func() string

+ GetIDParam func(*http.Request) string

+ Name func() string

+ Parent func() RelatedAPI

+ Route func(chi.Router)

+ Router func() chi.Router

+ type Response struct

+ Body string

+ ContentType string

+ Data T

+ Response *http.Response

+ func MakeRequest[T any](req *http.Request, client *http.Client, expectedStatusCode int, ...) (*Response[T], error)

+ func (sr *Response[T]) Fprint(out io.Writer, pretty bool) error

+ type ServerSentEvent struct

+ Data string

+ Event string

+ func (sse *ServerSentEvent) Write(w http.ResponseWriter)

Dec 2, 2023

Changes in this version

+ var ErrMethodNotAllowedResponse = &ErrResponse

+ var ErrNotFound = errors.New("resource not found")

+ var ErrNotFoundResponse = &ErrResponse

+ func GetIDParam(r *http.Request, name string) string

+ func GetLoggerFromContext(ctx context.Context) *slog.Logger

+ func GetResourceFromContext[T Resource](ctx context.Context, key ContextKey) (T, error)

+ func IDParamKey(name string) string

+ func NewContextWithLogger(ctx context.Context, logger *slog.Logger) context.Context

+ func TestServe[T Resource](t *testing.T, api *API[T]) (string, func())

+ func TestWithParentRoute[T, P Resource](t *testing.T, api *API[T], parent P, parentName, parentBasePath string, ...) *httptest.ResponseRecorder

+ func Test[T Resource](t *testing.T, api *API[T], r *http.Request) *httptest.ResponseRecorder

+ type API struct

+ func NewAPI[T Resource](name, base string, instance func() T) *API[T]

+ func (a *API[T]) AddCustomIDRoute(route chi.Route)

+ func (a *API[T]) AddCustomRoute(route chi.Route)

+ func (a *API[T]) AddMiddlewares(m chi.Middlewares)

+ func (a *API[T]) AddNestedAPI(childAPI relatedAPI)

+ func (a *API[T]) AnyClient(addr string) *Client[*AnyResource]

+ func (a *API[T]) Base() string

+ func (a *API[T]) Client(addr string) *Client[T]

+ func (a *API[T]) Delete(w http.ResponseWriter, r *http.Request)

+ func (a *API[T]) Get(w http.ResponseWriter, r *http.Request)

+ func (a *API[T]) GetAll(w http.ResponseWriter, r *http.Request)

+ func (a *API[T]) GetFromRequest(r *http.Request) (T, *ErrResponse)

+ func (a *API[T]) GetIDParam(r *http.Request) string

+ func (a *API[T]) GetParentIDParam(r *http.Request) string

+ func (a *API[T]) GetRequestBodyFromContext(ctx context.Context) T

+ func (a *API[T]) GetRequestedResource(r *http.Request) (T, *ErrResponse)

+ func (a *API[T]) GetRequestedResourceAndDo(do func(*http.Request, T) (render.Renderer, *ErrResponse)) http.HandlerFunc

+ func (a *API[T]) GetResourceFromContext(ctx context.Context) (T, error)

+ func (a *API[T]) IDParamKey() string

+ func (a *API[T]) Name() string

+ func (a *API[T]) NewContextWithRequestBody(ctx context.Context, item T) context.Context

+ func (a *API[T]) Parent() relatedAPI

+ func (a *API[T]) ParentContextKey() ContextKey

+ func (a *API[T]) Patch(w http.ResponseWriter, r *http.Request)

+ func (a *API[T]) Post(w http.ResponseWriter, r *http.Request)

+ func (a *API[T]) Put(w http.ResponseWriter, r *http.Request)

+ func (a *API[T]) ReadRequestBodyAndDo(do func(*http.Request, T) (T, *ErrResponse)) http.HandlerFunc

+ func (a *API[T]) ResponseWrapper(responseWrapper func(T) render.Renderer)

+ func (a *API[T]) Route(r chi.Router)

+ func (a *API[T]) Router() chi.Router

+ func (a *API[T]) RunCLI()

+ func (a *API[T]) RunWithArgs(out io.Writer, args []string, port int, address string, pretty bool) error

+ func (a *API[T]) Serve(port string)

+ func (a *API[T]) SetAfterDelete(after func(*http.Request) *ErrResponse)

+ func (a *API[T]) SetBeforeDelete(before func(*http.Request) *ErrResponse)

+ func (a *API[T]) SetGetAllFilter(f func(*http.Request) FilterFunc[T])

+ func (a *API[T]) SetOnCreateOrUpdate(onCreateOrUpdate func(*http.Request, T) *ErrResponse)

+ func (a *API[T]) SetStorage(s Storage[T])

+ func (a *API[T]) Stop()

+ type AnyResource map[string]any

+ func (*AnyResource) Render(w http.ResponseWriter, r *http.Request) error

+ func (ar AnyResource) GetID() string

+ func (dr *AnyResource) Bind(r *http.Request) error

+ type Client struct

+ func NewClient[T Resource](addr, base string) *Client[T]

+ func NewSubClient[T, R Resource](parent *Client[T], path string) *Client[R]

+ func (c *Client[T]) Delete(ctx context.Context, id string, parentIDs ...string) error

+ func (c *Client[T]) Get(ctx context.Context, id string, parentIDs ...string) (T, error)

+ func (c *Client[T]) GetAll(ctx context.Context, query url.Values, parentIDs ...string) (*ResourceList[T], error)

+ func (c *Client[T]) MakeRequest(req *http.Request, expectedStatusCode int) (*http.Response, error)

+ func (c *Client[T]) MakeRequestWithResponse(req *http.Request, expectedStatusCode int) (T, error)

+ func (c *Client[T]) NewRequestWithParentIDs(ctx context.Context, method string, body io.Reader, id string, ...) (*http.Request, error)

+ func (c *Client[T]) Patch(ctx context.Context, id string, resource T, parentIDs ...string) (T, error)

+ func (c *Client[T]) PatchRaw(ctx context.Context, id, body string, parentIDs ...string) (T, error)

+ func (c *Client[T]) Post(ctx context.Context, resource T, parentIDs ...string) (T, error)

+ func (c *Client[T]) PostRaw(ctx context.Context, body string, parentIDs ...string) (T, error)

+ func (c *Client[T]) Put(ctx context.Context, resource T, parentIDs ...string) error

+ func (c *Client[T]) PutRaw(ctx context.Context, id, body string, parentIDs ...string) error

+ func (c *Client[T]) SetHTTPClient(client *http.Client)

+ func (c *Client[T]) SetRequestEditor(requestEditor RequestEditor)

+ func (c *Client[T]) URL(id string, parentIDs ...string) (string, error)

+ type ContextKey string

+ type DefaultResource struct

+ ID ID

+ func NewDefaultResource() DefaultResource

+ func (*DefaultResource) Render(w http.ResponseWriter, r *http.Request) error

+ func (dr *DefaultResource) Bind(r *http.Request) error

+ func (dr *DefaultResource) GetID() string

+ type ErrResponse struct

+ AppCode int64

+ Err error

+ ErrorText string

+ HTTPStatusCode int

+ StatusText string

+ func ErrInvalidRequest(err error) *ErrResponse

+ func ErrRender(err error) *ErrResponse

+ func InternalServerError(err error) *ErrResponse

+ func (e *ErrResponse) Error() string

+ func (e *ErrResponse) Render(_ http.ResponseWriter, r *http.Request) error

+ type FilterFunc func(T) bool

+ type ID struct

+ func NewID() ID

+ func (id *ID) Bind(r *http.Request) error

+ type MapStorage map[string]T

+ func (m MapStorage[T]) Delete(id string) error

+ func (m MapStorage[T]) Get(id string) (T, error)

+ func (m MapStorage[T]) GetAll(filter FilterFunc[T]) ([]T, error)

+ func (m MapStorage[T]) Set(resource T) error

+ type Patcher interface

+ Patch func(T) *ErrResponse

+ type RequestEditor = func(*http.Request) error

+ type Resource interface

+ GetID func() string

+ type ResourceList struct

+ Items []T

+ func (rl *ResourceList[T]) Render(w http.ResponseWriter, r *http.Request) error

+ type Storage interface

+ Delete func(string) error

+ Get func(string) (T, error)

+ GetAll func(FilterFunc[T]) ([]T, error)

+ Set func(T) error