practicalli / practicalli/clojure-web-services

Api: generate routes & handlers from api spec

Open
#135 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

API
Dominant language
Markdown
Stars
16
Forks
14
PR merge metrics
No merged PRs in 30d

Description

Research the options for generating code for routes and (mock) handlers, given an API specification file, e.g. swagger.json

Add specifications to support type checking of request & response data (clojure spec /malli)

Research

Clojurians Slack discussions:

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the swagger.json example and the linked Clojurians Slack discussion. Compare options for generating routes and mock handlers, then assess Clojure spec and Malli for request and response checking. Done means documenting a selected approach and its scope for this project.

Written by the indexing model from the issue text.

Assessment

Tech stack
clojure
Domain
api, backend-api-design
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.