apple / apple/swift-openapi-generator

Support external JSON references

Open
#25 29 comments 13 reactions 0 assignees View on GitHub
area/generator area/openapi size/M status/needs-design
Dominant language
Swift
Stars
2k
Forks
182
Avg merge
13h 28m
Merged PRs (30d)
5

Description

Support external JSON references to allow breaking up a large doc into smaller ones.

"External" can mean either:
1. another file on local disk
2. a remote file

To start, let's consider other local files first, as remote files might have other implications (security, privacy, etc).

Contributor guide

Open the contributing guide

Research direction

No files or tests are named. Start by tracing how swift-openapi-generator loads and resolves OpenAPI JSON documents, then locate the relevant entry points and tests. Keep the initial scope to local files; done means a large document can be split across local JSON files with tests covering that behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi, swift
Domain
backend-api-design
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.