macchiato-framework/macchiato-core

Input & output validation with api-docs (swagger)

Open

#7 aberto em 20 de dez. de 2016

Ver no GitHub
 (17 comments) (0 reactions) (0 assignees)Clojure (34 forks)github user discovery
enhancementhelp wanted

Métricas do repositório

Stars
 (383 stars)
Métricas de merge de PR
 (Métricas PR pendentes)

Description

Optional & pluggable, for handlers, maybe also for middleware. Schema is awesome and proven per today, Spec is the probable future. I could pull out a proposal for a common structure for input & output coercion with api-docs, based on our libs.

  • simple, data-driven core
  • optionally "easy" macro sugar with inferred models
  • pluggable implementation (schema, spec, other)
  • protocols for routing libs to collect routes for api-docs
  • swagger-docs (ring/spec-swagger)

what do you think?

Guia do colaborador

Direção de pesquisa
Examine as bibliotecas metosin existentes (schema, spec) e proponha uma estrutura comum orientada a dados para coerção de entrada/saída e integração de documentação de API com swagger.
Pilha de tecnologia
clojure
Domain
backend
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
3-5 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Principalmente claro
Prerequisites
Clojure
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
40