add @Swagger to be backward compatible

src/SwaggerMarkdown.jl

@@ -8,7 +8,7 @@ const ROOT = dirname(dirname(@__FILE__))
 
 include("OpenAPI.jl")
 
-export OpenAPI, build, @swagger_str, InvalidSwaggerSpecificationException
+export OpenAPI, build, @swagger, @swagger_str, InvalidSwaggerSpecificationException
 
 const DOCS = []
 
@@ -17,6 +17,11 @@ macro swagger_str(doc)
     return esc(quote push!($m.DOCS, $doc) end)
 end
 
+macro swagger(doc)
+    m = @__MODULE__
+    return esc(quote push!($m.DOCS, $doc) end)
+end
+
 function build(spec::AbstractDict{<:AbstractString,<:Any})::Dict{String, Any}
     spec_copy = spec
     if !haskey(spec_copy, "paths")

test/macro_build_tests.jl

@@ -1,3 +1,37 @@
+@testset "Build directly through Dict with @swagger_str" begin
+    swagger"""
+    /test_swagger_str:
+        post:
+            description: Testing swagger markdown test!
+            responses:
+                '200':
+                    description: Returns a mysterious string test.
+    """
+
+    @swagger """
+    /test_swagger:
+        post:
+            description: Testing swagger markdown test!
+            responses:
+                '200':
+                    description: Returns a mysterious string test.
+    """
+
+    spec = Dict{String, Any}([
+        "info" => Dict{String, Any}([
+            "version" => "2.0",
+            "title" => "Swagger Petstore"
+        ]),
+        "swagger" => "2.0"
+    ])
+    spec = build(spec)
+    @test haskey(spec, "paths")
+
+    paths = spec["paths"];
+    @test haskey(paths, "/test_swagger")
+    @test haskey(paths, "/test_swagger_str")
+end
+
 @testset "Build directly through Dict" begin
     @swagger """
     /test: