generate model

Creates a Codable struct. Without a sample, it’s an empty skeleton. With --from, fields are inferred from a real JSON payload.

Synopsis

swiftspawn generate model <Name> [--from <path-or-url>] [--in <feature>] [--dry-run] [--force] [--quiet] [--verbose]

Description

generate model is meant to be the fastest path from an example JSON response to a Swift type that decodes it.

Without --from, it produces an empty Codable struct with a comment placeholder, ready for you to fill in.

With --from <path-or-url>, the generator:

1. Loads the JSON sample (file path or HTTP URL).
2. Walks every field; infers its Swift type (Int, Double, String, Bool, arrays, nested structs).
3. Marks fields Optional if they’re null in the sample.
4. Converts snake_case JSON keys to camelCase Swift properties and emits a CodingKeys enum.

A single sample only sees one shape of the response. If the API returns null for a field that’s non-null in your sample, the generated type will fail to decode at runtime; open the file and add ? to the affected fields.

Examples

swiftspawn generate model Genre
swiftspawn generate model Movie --from sample.json --in Movies
swiftspawn generate model User --from https://api.example.com/users/1

Generated files

With --in <feature>:

Features/<Feature>/Models/<Name>.swift

Without --in:

Models/<Name>.swift

Side effects

None.

Options

Flag	Description
--from <path-or-url>	Path or URL to a JSON sample to infer the schema from.
--in <feature>	Feature folder. Defaults to top-level Models/. Bare in <feature> also works.
--dry-run	Preview without writing.
--force	Overwrite existing file.

Exit codes

Code	Meaning
2	Invalid name.
5	Not in a swiftspawn project.
9	File not found at --from path.
10	Failed to fetch URL at --from.
11	Malformed JSON at --from.

See also

• generate service
• recipe crud bundles generate model --from into a full pattern.