yaml: implement basic Swagger/OpenAPI subparser

Tmain/list-subparsers-all.d/stdout-expected.txt

@@ -10,6 +10,7 @@ IPythonCell          Python     base => sub {shared}
 ITcl                 Tcl        base <> sub {bidirectional}
 Maven2               XML        base <> sub {bidirectional}
 Moose                Perl       base <> sub {bidirectional}
+OpenAPI              Yaml       base <> sub {bidirectional}
 PlistXML             XML        base <> sub {bidirectional}
 PythonLoggingConfig  Iniconf    base <> sub {bidirectional}
 QtMoc                C++        base <> sub {bidirectional}

Units/parser-openapi.r/openapi.d/args.ctags

@@ -0,0 +1 @@
+--language-force=openapi

Units/parser-openapi.r/openapi.d/expected.tags

@@ -0,0 +1,30 @@
+/sample/other/path	input.yaml	/^    \/sample\/other\/path:$/;"	p
+/sample/path	input.yaml	/^    \/sample\/path:$/;"	p
+Body1	input.yaml	/^        Body1:$/;"	B
+Body2	input.yaml	/^        Body2:$/;"	B
+Callback1	input.yaml	/^        Callback1: {}$/;"	c
+Callback2	input.yaml	/^        Callback2: {}$/;"	c
+CustomHeader	input.yaml	/^        CustomHeader:$/;"	P
+Example1	input.yaml	/^        Example1:$/;"	e
+Example2	input.yaml	/^        Example2:$/;"	e
+Header1	input.yaml	/^        Header1:$/;"	h
+Header2	input.yaml	/^        Header2:$/;"	h
+Link1	input.yaml	/^        Link1: {}$/;"	l
+Link2	input.yaml	/^        Link2: {}$/;"	l
+NullableField	input.yaml	/^        NullableField:$/;"	d
+NullableFieldStringEnum	input.yaml	/^        NullableFieldStringEnum:$/;"	d
+PathItem1	input.yaml	/^        PathItem1: {}$/;"	A
+PathItem2	input.yaml	/^        PathItem2: {}$/;"	A
+Response1	input.yaml	/^        Response1:$/;"	R
+Response2	input.yaml	/^        Response2:$/;"	R
+SSchema1	input.yaml	/^        SSchema1:$/;"	C
+SSchema2	input.yaml	/^        SSchema2:$/;"	C
+SomeApiKey	input.yaml	/^  - SomeApiKey:$/;"	s
+android_handler	input.yaml	/^  - name: android_handler$/;"	t
+description	input.yaml	/^    description: test$/;"	I
+http://example.com	input.yaml	/^    url: http:\/\/example.com$/;"	D
+http://example.com	input.yaml	/^  - url: http:\/\/example.com$/;"	S
+http://example2.com	input.yaml	/^  - url: http:\/\/example2.com$/;"	S
+ios_handler	input.yaml	/^  - name: ios_handler$/;"	t
+title	input.yaml	/^    title: test$/;"	I
+version	input.yaml	/^    version: '1.0'$/;"	I

Units/parser-openapi.r/openapi.d/features

@@ -0,0 +1 @@
+yaml

Units/parser-openapi.r/openapi.d/input.yaml

@@ -0,0 +1,119 @@
+openapi: 3.1.0
+info:
+    title: test
+    description: test
+    version: '1.0'
+
+servers:
+  - url: http://example.com
+    description: production
+  - url: http://example2.com
+    description: testing
+
+paths:
+    /sample/path:
+        get:
+            summary: simple handler
+            responses: {}
+
+    /sample/other/path:
+        get:
+            responses: {}
+        post:
+            summary: xxx
+            responses: {}
+
+components:
+    schemas:
+        NullableField:
+            type: object
+            properties: {}
+        NullableFieldStringEnum:
+            type: object
+            properties: {}
+
+    parameters:
+        CustomHeader:
+            in: header
+            name: X-Custom-Header
+            required: false
+            schema:
+                type: string
+
+    responses:
+        Response1:
+            description: Payment Required
+            content:
+                application/json:
+                    schema:
+                        type: object
+                        properties: {}
+        Response2:
+            description: smth 2
+            content:
+                application/json:
+                    schema:
+                        type: object
+                        properties: {}
+    examples:
+        Example1:
+            summary: xxx
+            value: yyyyy
+        Example2:
+            summary: xxx
+            value: yyyyy
+    requestBodies:
+        Body1:
+            description: bla bla bla
+            content:
+                application/json:
+                    schema:
+                        type: string
+        Body2:
+            description: bla bla bla
+            content:
+                application/json:
+                    schema:
+                        type: integer
+    headers:
+        Header1:
+            schema:
+                type: string
+        Header2:
+            schema:
+                type: string
+    securitySchemes:
+        SSchema1:
+            type: http
+            scheme: basic
+        SSchema2:
+            type: http
+            scheme: basic
+    links:
+        Link1: {}
+        Link2: {}
+    callbacks:
+        Callback1: {}
+        Callback2: {}
+    # pathItems is allowed in 3.1.0
+    pathItems:
+        PathItem1: {}
+        PathItem2: {}
+
+
+
+security:
+  - {}
+  - SomeApiKey:
+     - foo:read
+     - foo:write
+
+tags:
+  - name: android_handler
+    description: Handler for Android clients
+  - name: ios_handler
+    description: Handler for iOS clients
+
+externalDocs:
+    description: some docs
+    url: http://example.com

Units/parser-openapi.r/swagger.d/args.ctags

@@ -0,0 +1 @@
+--language-force=openapi

Units/parser-openapi.r/swagger.d/expected.tags

@@ -0,0 +1,11 @@
+/sample/other/path	input.yaml	/^    \/sample\/other\/path:$/;"	p
+/sample/path	input.yaml	/^    \/sample\/path:$/;"	p
+Param1	input.yaml	/^    Param1:$/;"	P
+Param2	input.yaml	/^    Param2:$/;"	P
+PolymorphicInteger	input.yaml	/^    PolymorphicInteger:$/;"	d
+PolymorphicString	input.yaml	/^    PolymorphicString:$/;"	d
+Response1	input.yaml	/^    Response1:$/;"	R
+Response2	input.yaml	/^    Response2:$/;"	R
+description	input.yaml	/^    description: test$/;"	I
+title	input.yaml	/^    title: test$/;"	I
+version	input.yaml	/^    version: '1.0'$/;"	I

Units/parser-openapi.r/swagger.d/features

@@ -0,0 +1 @@
+yaml

Units/parser-openapi.r/swagger.d/input.yaml

@@ -0,0 +1,64 @@
+swagger: '2.0'
+info:
+    description: test
+    title: test
+    version: '1.0'
+host: example.com
+
+paths:
+    /sample/path:
+        post:
+            description: test
+            responses:
+              200:
+                description: xxx
+
+    /sample/other/path:
+        get:
+            description: smth
+            responses:
+              200:
+                description: xxx
+
+definitions:
+    PolymorphicString:
+        type: object
+        required:
+          - type
+          - value
+        additionalProperties: false
+        properties:
+            type:
+                type: string
+            value:
+                type: string
+
+    PolymorphicInteger:
+        type: object
+        required:
+          - type
+          - value
+        additionalProperties: false
+        properties:
+            type:
+                type: string
+            value:
+                type: integer
+
+parameters:
+    Param1:
+        name: test1
+        in: query
+        type: boolean
+
+    Param2:
+        name: test2
+        in: query
+        type: boolean
+
+responses:
+    Response1:
+        description: aaa
+
+    Response2:
+        description: bbb

docs/news.rst

@@ -439,6 +439,7 @@ The following parsers have been added:
 * M4
 * NSIS
 * ObjectiveC
+* OpenAPI 3.x.x / Swagger 2.0
 * Passwd *optlib*
 * PuppetManifest *optlib*
 * Perl6

main/parsers_p.h

@@ -29,7 +29,8 @@
 #ifdef HAVE_LIBYAML
 #define YAML_PARSER_LIST						\
 	YamlParser,									\
-	AnsiblePlaybookParser
+	AnsiblePlaybookParser, \
+	OpenApiParser
 #else
 #define YAML_PARSER_LIST
 #endif