{"id":18550675,"url":"https://github.com/smiley4/schema-kenerator","last_synced_at":"2025-10-14T10:08:56.223Z","repository":{"id":212104528,"uuid":"729430513","full_name":"SMILEY4/schema-kenerator","owner":"SMILEY4","description":"Analyze kotlin types, extract information and generate schemas","archived":false,"fork":false,"pushed_at":"2025-09-18T21:35:49.000Z","size":6793,"stargazers_count":33,"open_issues_count":4,"forks_count":9,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2025-10-12T21:36:35.318Z","etag":null,"topics":["json-schema","kotlin","kotlinx-serialization","openapi","reflection","schema","swagger"],"latest_commit_sha":null,"homepage":"https://smiley4.github.io/schema-kenerator/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SMILEY4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-12-09T07:47:25.000Z","updated_at":"2025-09-18T21:26:49.000Z","dependencies_parsed_at":"2023-12-14T08:27:34.513Z","dependency_job_id":"a1e2d947-5639-40ec-8dcc-866e515118dc","html_url":"https://github.com/SMILEY4/schema-kenerator","commit_stats":null,"previous_names":["smiley4/schema-kenerator"],"tags_count":37,"template":false,"template_full_name":null,"purl":"pkg:github/SMILEY4/schema-kenerator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SMILEY4%2Fschema-kenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SMILEY4%2Fschema-kenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SMILEY4%2Fschema-kenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SMILEY4%2Fschema-kenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SMILEY4","download_url":"https://codeload.github.com/SMILEY4/schema-kenerator/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SMILEY4%2Fschema-kenerator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018768,"owners_count":26086449,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["json-schema","kotlin","kotlinx-serialization","openapi","reflection","schema","swagger"],"created_at":"2024-11-06T21:05:26.855Z","updated_at":"2025-10-14T10:08:56.217Z","avatar_url":"https://github.com/SMILEY4.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Schema Kenerator\n\n[![Version](https://img.shields.io/maven-central/v/io.github.smiley4/schema-kenerator-core?style=flat\u0026color=blue\u0026logo=apachemaven)](https://central.sonatype.com/search?q=github.smiley4.schema-kenerator-*)\n[![Checks Passing](https://img.shields.io/github/actions/workflow/status/SMILEY4/schema-kenerator/checks.yml?style=flat\u0026logo=github)](https://github.com/SMILEY4/schema-kenerator/actions/workflows/checks.yml)\n[![License](https://img.shields.io/github/license/SMILEY4/schema-kenerator?style=flat\u0026color=teal)](https://github.com/SMILEY4/schema-kenerator/blob/develop/LICENSE)\n\n\nThe schema-kenerator project consists of multiple artifacts that are used together with the goal to extract information from types and generate different schemas.\nIt is designed as a pipeline of individual steps to be highly configurable and flexible to match any situation.\n\n\n## Features\n\n- Analyze Java and Kotlin types using reflection or [Kotlinx.Serialization](https://github.com/Kotlin/kotlinx.serialization)\n   - complex class configurations\n   - recursion\n   - collections, maps, enums\n   - inheritance\n   - type parameters\n   - annotations\n   - nullability and default values\n   - inline types\n   - ...\n- Enhance types with additional information\n   - [Jackson](https://github.com/FasterXML/jackson) annotations\n   - [Swagger](https://github.com/swagger-api/swagger-core/wiki/Swagger-2.X---Annotations) annotations\n   - Javax/Jakarta validation annotations\n   - ...\n- Generate schemas\n   - [JSON schema](https://json-schema.org/)\n   - [Swagger schema](https://swagger.io/docs/specification/v3_0/data-models/data-models/)\n- Highly configurable and customizable schema generation pipeline by adding new processing steps and creating own modules\n\n\n## Documentation\n\nA wiki with documentation is available [here](https://smiley4.github.io/schema-kenerator/latest).\n\nExamples showcasing and explaining the functionalities and use cases of this project can be found [here](https://github.com/SMILEY4/schema-kenerator/tree/develop/examples/src/test/kotlin/io/github/smiley4/schemakenerator/examples).\n\n\n## Installation\n\nSee [modules](https://smiley4.github.io/schema-kenerator/latest/modules/) wiki page for installation instructions.\n\n\n## Example\n\n```kotlin\nclass MyExampleClass(\n    val someText: String,\n    val someNullableInt: Int?,\n    val someBoolList: List\u003cBoolean\u003e,\n)\n```\n```kotlin\nval jsonSchema = initial\u003cString\u003e()\n    // Analyze the type using reflection and extract information\n    .analyzeTypeUsingReflection()\n    // Generate (independent) json schemas for each associated type (here: `MyExampleClass`, `Int`, `Boolean` and `List\u003cBoolean\u003e`)\n    .generateJsonSchema()\n    // Add the simple/short name of the type as the title to the schema\n    .withTitle(TitleType.SIMPLE)\n    // Combine the individual schemas into a single schema for `MyExampleClass` by inlining all referenced types.\n    .compileInlining()\n```\n```json\n{\n  \"title\": \"MyExampleClass\",\n  \"type\": \"object\",\n  \"required\": [\"someBoolList\", \"someText\"],\n  \"properties\": {\n    \"someBoolList\": {\n      \"title\": \"List\u003cBoolean\u003e\",\n      \"type\": \"array\",\n      \"items\": {\n        \"title\": \"Boolean\",\n        \"type\": \"boolean\"\n      }\n    },\n    \"someNullableInt\": {\n      \"title\": \"Int\",\n      \"type\": \"integer\",\n      \"minimum\": -2147483648,\n      \"maximum\": 2147483647\n    },\n    \"someText\": {\n      \"title\": \"String\",\n      \"type\": \"string\"\n    }\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmiley4%2Fschema-kenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmiley4%2Fschema-kenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmiley4%2Fschema-kenerator/lists"}