Files
koi_swagger_parser/test/defaults_and_parameters_test.dart
T
mr.koi ea93f09154 Establish the Koi Swagger parser release
Prepare the OpenAPI parser and Dart generator as a publishable Koi package with CLI entrypoint, docs, examples, tests, and pub.dev release metadata.

Constraint: Initial GitHub import follows koi_blueprint_flutter identity mr.koi <i@mrkoi.is>.

Rejected: Keep local runtime state in the initial repository | .dart_tool, .omx, and pubspec.lock are ignored for a reusable package source tree.

Confidence: high

Scope-risk: moderate

Directive: Keep generated-output behavior covered by parser and generator tests before changing rendering rules.

Tested: dart analyze; dart test; PUB_HOSTED_URL=https://pub.dev dart pub publish --dry-run

Not-tested: End-to-end downstream build_runner compilation of generated Retrofit/Freezed output.
2026-06-02 22:00:13 +08:00

134 lines
3.3 KiB
Dart

import 'dart:io';
import 'package:koi_swagger_parser/koi_swagger_parser.dart';
import 'package:path/path.dart' as p;
import 'package:test/test.dart';
void main() {
group('default values and optional parameters', () {
test('枚举默认值与 query 默认值生成合法 Dart 代码', () async {
final tempDir = await Directory.systemTemp.createTemp(
'koi_swagger_parser_defaults_',
);
addTearDown(() => tempDir.delete(recursive: true));
final specFile = File(p.join(tempDir.path, 'openapi.json'));
await specFile.writeAsString(r'''
{
"openapi": "3.1.0",
"info": {
"title": "Defaults Sample",
"version": "1.0.0"
},
"paths": {
"/api/v1/samples": {
"get": {
"tags": ["samples"],
"operationId": "list_samples_api_v1_samples_get",
"parameters": [
{
"name": "page_no",
"in": "query",
"required": false,
"schema": {"type": "integer", "default": 1}
},
{
"name": "tag",
"in": "query",
"required": false,
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "ok",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/SampleResponse"}
}
}
}
}
}
}
},
"components": {
"schemas": {
"SampleResponse": {
"type": "object",
"required": ["id"],
"properties": {
"id": {"type": "integer"},
"conflict_policy": {
"type": "string",
"enum": ["exclusive", "mix"],
"default": "exclusive"
}
}
}
}
}
}
''');
final outputDir = p.join(tempDir.path, 'lib', 'src');
final configFile = File(p.join(tempDir.path, 'koi_swagger_parser.yaml'));
await configFile.writeAsString('''
input:
swagger_urls:
- url: ${specFile.path}
enabled: true
output:
base_dir: $outputDir
api_dir: ${p.join(outputDir, 'api')}
models_dir: ${p.join(outputDir, 'api_models')}
included_tags:
- samples
split_by_tags: true
generation:
preset:
name: koi_flutter
api:
enabled: true
use_retrofit: true
cancel_token_support: false
client:
class_name: SampleApiClient
file_name: sample_api_client
response_wrapper:
mode: passthrough
detect_standard_envelope: false
success_data_field: data
models:
enabled: true
class_prefix: Koi
default_non_nullable_list_to_empty: true
json_serializable:
checked: true
explicit_to_json: true
include_if_null: false
formatting:
run_dart_format: false
''');
await const KoiSwaggerParser().generate(configPath: configFile.path);
final apiFile = File(
p.join(outputDir, 'api', 'v1', 'samples_api.dart'),
).readAsStringSync();
expect(apiFile, contains("@Query('page_no') int pageNo = 1"));
expect(apiFile, contains("@Query('tag') String? tag"));
final resultFile = File(
p.join(outputDir, 'api_models', 'result', 'sample_response.dart'),
).readAsStringSync();
expect(
resultFile,
contains('@Default(KoiSampleResponseConflictPolicy.exclusive)'),
);
});
});
}