git.iko.soy/typeable/openapi3
on 867ff82 help sign in
.github/workflows/haskell-ci.ymldeleted−243
since splitsnapshots
unifiedsplit
@@ -1,243 +0,0 @@
1−# This GitHub workflow config has been generated by a script via
2−#
3−# haskell-ci 'github' 'cabal.project'
4−#
5−# To regenerate the script (for example after adjusting tested-with) run
6−#
7−# haskell-ci regenerate
8−#
9−# For more information, see https://github.com/haskell-CI/haskell-ci
10−#
11−# version: 0.14.3
12−#
13−# REGENDATA ("0.14.3",["github","cabal.project"])
14−#
15−name: Haskell-CI
16−on:
17− push:
18− branches:
19− - master
20− pull_request:
21− branches:
22− - master
23−jobs:
24− linux:
25− name: Haskell-CI - Linux - ${{ matrix.compiler }}
26− runs-on: ubuntu-18.04
27− timeout-minutes:
28− 60
29− container:
30− image: buildpack-deps:focal
31− continue-on-error: ${{ matrix.allow-failure }}
32− strategy:
33− matrix:
34− include:
35− - compiler: ghc-9.2.2
36− compilerKind: ghc
37− compilerVersion: 9.2.2
38− setup-method: ghcup
39− allow-failure: true
40− - compiler: ghc-9.0.2
41− compilerKind: ghc
42− compilerVersion: 9.0.2
43− setup-method: ghcup
44− allow-failure: false
45− - compiler: ghc-8.10.7
46− compilerKind: ghc
47− compilerVersion: 8.10.7
48− setup-method: ghcup
49− allow-failure: false
50− - compiler: ghc-8.8.4
51− compilerKind: ghc
52− compilerVersion: 8.8.4
53− setup-method: hvr-ppa
54− allow-failure: false
55− - compiler: ghc-8.6.5
56− compilerKind: ghc
57− compilerVersion: 8.6.5
58− setup-method: hvr-ppa
59− allow-failure: false
60− - compiler: ghc-8.4.4
61− compilerKind: ghc
62− compilerVersion: 8.4.4
63− setup-method: hvr-ppa
64− allow-failure: false
65− fail-fast: false
66− steps:
67− - name: apt
68− run: |
69− apt-get update
70− apt-get install -y --no-install-recommends gnupg ca-certificates dirmngr curl git software-properties-common libtinfo5
71− if [ "${{ matrix.setup-method }}" = ghcup ]; then
72− mkdir -p "$HOME/.ghcup/bin"
73− curl -sL https://downloads.haskell.org/ghcup/0.1.17.5/x86_64-linux-ghcup-0.1.17.5 > "$HOME/.ghcup/bin/ghcup"
74− chmod a+x "$HOME/.ghcup/bin/ghcup"
75− "$HOME/.ghcup/bin/ghcup" install ghc "$HCVER"
76− "$HOME/.ghcup/bin/ghcup" install cabal 3.6.2.0
77− else
78− apt-add-repository -y 'ppa:hvr/ghc'
79− apt-get update
80− apt-get install -y "$HCNAME"
81− mkdir -p "$HOME/.ghcup/bin"
82− curl -sL https://downloads.haskell.org/ghcup/0.1.17.5/x86_64-linux-ghcup-0.1.17.5 > "$HOME/.ghcup/bin/ghcup"
83− chmod a+x "$HOME/.ghcup/bin/ghcup"
84− "$HOME/.ghcup/bin/ghcup" install cabal 3.6.2.0
85− fi
86− env:
87− HCKIND: ${{ matrix.compilerKind }}
88− HCNAME: ${{ matrix.compiler }}
89− HCVER: ${{ matrix.compilerVersion }}
90− - name: Set PATH and environment variables
91− run: |
92− echo "$HOME/.cabal/bin" >> $GITHUB_PATH
93− echo "LANG=C.UTF-8" >> "$GITHUB_ENV"
94− echo "CABAL_DIR=$HOME/.cabal" >> "$GITHUB_ENV"
95− echo "CABAL_CONFIG=$HOME/.cabal/config" >> "$GITHUB_ENV"
96− HCDIR=/opt/$HCKIND/$HCVER
97− if [ "${{ matrix.setup-method }}" = ghcup ]; then
98− HC=$HOME/.ghcup/bin/$HCKIND-$HCVER
99− echo "HC=$HC" >> "$GITHUB_ENV"
100− echo "HCPKG=$HOME/.ghcup/bin/$HCKIND-pkg-$HCVER" >> "$GITHUB_ENV"
101− echo "HADDOCK=$HOME/.ghcup/bin/haddock-$HCVER" >> "$GITHUB_ENV"
102− echo "CABAL=$HOME/.ghcup/bin/cabal-3.6.2.0 -vnormal+nowrap" >> "$GITHUB_ENV"
103− else
104− HC=$HCDIR/bin/$HCKIND
105− echo "HC=$HC" >> "$GITHUB_ENV"
106− echo "HCPKG=$HCDIR/bin/$HCKIND-pkg" >> "$GITHUB_ENV"
107− echo "HADDOCK=$HCDIR/bin/haddock" >> "$GITHUB_ENV"
108− echo "CABAL=$HOME/.ghcup/bin/cabal-3.6.2.0 -vnormal+nowrap" >> "$GITHUB_ENV"
109− fi
110−
111− HCNUMVER=$(${HC} --numeric-version|perl -ne '/^(\d+)\.(\d+)\.(\d+)(\.(\d+))?$/; print(10000 * $1 + 100 * $2 + ($3 == 0 ? $5 != 1 : $3))')
112− echo "HCNUMVER=$HCNUMVER" >> "$GITHUB_ENV"
113− echo "ARG_TESTS=--enable-tests" >> "$GITHUB_ENV"
114− echo "ARG_BENCH=--enable-benchmarks" >> "$GITHUB_ENV"
115− echo "HEADHACKAGE=false" >> "$GITHUB_ENV"
116− echo "ARG_COMPILER=--$HCKIND --with-compiler=$HC" >> "$GITHUB_ENV"
117− echo "GHCJSARITH=0" >> "$GITHUB_ENV"
118− env:
119− HCKIND: ${{ matrix.compilerKind }}
120− HCNAME: ${{ matrix.compiler }}
121− HCVER: ${{ matrix.compilerVersion }}
122− - name: env
123− run: |
124− env
125− - name: write cabal config
126− run: |
127− mkdir -p $CABAL_DIR
128− cat >> $CABAL_CONFIG <<EOF
129− remote-build-reporting: anonymous
130− write-ghc-environment-files: never
131− remote-repo-cache: $CABAL_DIR/packages
132− logs-dir: $CABAL_DIR/logs
133− world-file: $CABAL_DIR/world
134− extra-prog-path: $CABAL_DIR/bin
135− symlink-bindir: $CABAL_DIR/bin
136− installdir: $CABAL_DIR/bin
137− build-summary: $CABAL_DIR/logs/build.log
138− store-dir: $CABAL_DIR/store
139− install-dirs user
140− prefix: $CABAL_DIR
141− repository hackage.haskell.org
142− url: http://hackage.haskell.org/
143− EOF
144− cat >> $CABAL_CONFIG <<EOF
145− program-default-options
146− ghc-options: $GHCJOBS +RTS -M3G -RTS
147− EOF
148− cat $CABAL_CONFIG
149− - name: versions
150− run: |
151− $HC --version || true
152− $HC --print-project-git-commit-id || true
153− $CABAL --version || true
154− - name: update cabal index
155− run: |
156− $CABAL v2-update -v
157− - name: install cabal-plan
158− run: |
159− mkdir -p $HOME/.cabal/bin
160− curl -sL https://github.com/haskell-hvr/cabal-plan/releases/download/v0.6.2.0/cabal-plan-0.6.2.0-x86_64-linux.xz > cabal-plan.xz
161− echo 'de73600b1836d3f55e32d80385acc055fd97f60eaa0ab68a755302685f5d81bc cabal-plan.xz' | sha256sum -c -
162− xz -d < cabal-plan.xz > $HOME/.cabal/bin/cabal-plan
163− rm -f cabal-plan.xz
164− chmod a+x $HOME/.cabal/bin/cabal-plan
165− cabal-plan --version
166− - name: checkout
167− uses: actions/checkout@v2
168− with:
169− path: source
170− - name: initial cabal.project for sdist
171− run: |
172− touch cabal.project
173− echo "packages: $GITHUB_WORKSPACE/source/." >> cabal.project
174− cat cabal.project
175− - name: sdist
176− run: |
177− mkdir -p sdist
178− $CABAL sdist all --output-dir $GITHUB_WORKSPACE/sdist
179− - name: unpack
180− run: |
181− mkdir -p unpacked
182− find sdist -maxdepth 1 -type f -name '*.tar.gz' -exec tar -C $GITHUB_WORKSPACE/unpacked -xzvf {} \;
183− - name: generate cabal.project
184− run: |
185− PKGDIR_openapi3="$(find "$GITHUB_WORKSPACE/unpacked" -maxdepth 1 -type d -regex '.*/openapi3-[0-9.]*')"
186− echo "PKGDIR_openapi3=${PKGDIR_openapi3}" >> "$GITHUB_ENV"
187− rm -f cabal.project cabal.project.local
188− touch cabal.project
189− touch cabal.project.local
190− echo "packages: ${PKGDIR_openapi3}" >> cabal.project
191− echo "package openapi3" >> cabal.project
192− echo " ghc-options: -Werror=missing-methods" >> cabal.project
193− cat >> cabal.project <<EOF
194− allow-newer: http-media:base
195− EOF
196− $HCPKG list --simple-output --names-only | perl -ne 'for (split /\s+/) { print "constraints: $_ installed\n" unless /^(openapi3)$/; }' >> cabal.project.local
197− cat cabal.project
198− cat cabal.project.local
199− - name: dump install plan
200− run: |
201− $CABAL v2-build $ARG_COMPILER $ARG_TESTS $ARG_BENCH --dry-run all
202− cabal-plan
203− - name: cache
204− uses: actions/cache@v2
205− with:
206− key: ${{ runner.os }}-${{ matrix.compiler }}-${{ github.sha }}
207− path: ~/.cabal/store
208− restore-keys: ${{ runner.os }}-${{ matrix.compiler }}-
209− - name: install dependencies
210− run: |
211− $CABAL v2-build $ARG_COMPILER --disable-tests --disable-benchmarks --dependencies-only -j2 all
212− $CABAL v2-build $ARG_COMPILER $ARG_TESTS $ARG_BENCH --dependencies-only -j2 all
213− - name: build w/o tests
214− run: |
215− $CABAL v2-build $ARG_COMPILER --disable-tests --disable-benchmarks all
216− - name: build
217− run: |
218− $CABAL v2-build $ARG_COMPILER $ARG_TESTS $ARG_BENCH all --write-ghc-environment-files=always
219− - name: tests
220− run: |
221− $CABAL v2-test $ARG_COMPILER $ARG_TESTS $ARG_BENCH all --test-show-details=direct
222− - name: cabal check
223− run: |
224− cd ${PKGDIR_openapi3} || false
225− ${CABAL} -vnormal check
226− - name: haddock
227− run: |
228− $CABAL v2-haddock $ARG_COMPILER --with-haddock $HADDOCK $ARG_TESTS $ARG_BENCH all
229− - name: unconstrained build
230− run: |
231− rm -f cabal.project.local
232− $CABAL v2-build $ARG_COMPILER --disable-tests --disable-benchmarks all
233− - name: prepare for constraint sets
234− run: |
235− rm -f cabal.project.local
236− - name: constraint set aeson-2
237− run: |
238− $CABAL v2-build $ARG_COMPILER --disable-tests --disable-benchmarks --constraint='aeson >=2.0' --dependencies-only -j2 all
239− $CABAL v2-build $ARG_COMPILER --disable-tests --disable-benchmarks --constraint='aeson >=2.0' all
240− - name: constraint set aeson-1
241− run: |
242− if [ $((HCNUMVER < 90200)) -ne 0 ] ; then $CABAL v2-build $ARG_COMPILER --disable-tests --disable-benchmarks --constraint='aeson <2.0' --dependencies-only -j2 all ; fi
243− if [ $((HCNUMVER < 90200)) -ne 0 ] ; then $CABAL v2-build $ARG_COMPILER --disable-tests --disable-benchmarks --constraint='aeson <2.0' all ; fi
.travis.ymlnew file+149
@@ -0,0 +1,149 @@
1+# This Travis job script has been generated by a script via
2+#
3+# haskell-ci '--branches' 'master' '--haddock-jobs=>=8.4' '--output' '.travis.yml' 'openapi3.cabal'
4+#
5+# To regenerate the script (for example after adjusting tested-with) run
6+#
7+# haskell-ci regenerate
8+#
9+# For more information, see https://github.com/haskell-CI/haskell-ci
10+#
11+# version: 0.10.1
12+#
13+version: ~> 1.0
14+language: c
15+os: linux
16+dist: xenial
17+git:
18+ # whether to recursively clone submodules
19+ submodules: false
20+branches:
21+ only:
22+ - master
23+cache:
24+ directories:
25+ - $HOME/.cabal/packages
26+ - $HOME/.cabal/store
27+ - $HOME/.hlint
28+before_cache:
29+ - rm -fv $CABALHOME/packages/hackage.haskell.org/build-reports.log
30+ # remove files that are regenerated by 'cabal update'
31+ - rm -fv $CABALHOME/packages/hackage.haskell.org/00-index.*
32+ - rm -fv $CABALHOME/packages/hackage.haskell.org/*.json
33+ - rm -fv $CABALHOME/packages/hackage.haskell.org/01-index.cache
34+ - rm -fv $CABALHOME/packages/hackage.haskell.org/01-index.tar
35+ - rm -fv $CABALHOME/packages/hackage.haskell.org/01-index.tar.idx
36+ - rm -rfv $CABALHOME/packages/head.hackage
37+jobs:
38+ include:
39+ - compiler: ghc-8.10.1
40+ addons: {"apt":{"sources":[{"sourceline":"deb http://ppa.launchpad.net/hvr/ghc/ubuntu xenial main","key_url":"https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x063dab2bdc0b3f9fcebc378bff3aeacef6f88286"}],"packages":["ghc-8.10.1","cabal-install-3.2"]}}
41+ os: linux
42+ - compiler: ghc-8.8.3
43+ addons: {"apt":{"sources":[{"sourceline":"deb http://ppa.launchpad.net/hvr/ghc/ubuntu xenial main","key_url":"https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x063dab2bdc0b3f9fcebc378bff3aeacef6f88286"}],"packages":["ghc-8.8.3","cabal-install-3.2"]}}
44+ os: linux
45+ - compiler: ghc-8.6.5
46+ addons: {"apt":{"sources":[{"sourceline":"deb http://ppa.launchpad.net/hvr/ghc/ubuntu xenial main","key_url":"https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x063dab2bdc0b3f9fcebc378bff3aeacef6f88286"}],"packages":["ghc-8.6.5","cabal-install-3.2"]}}
47+ os: linux
48+ - compiler: ghc-8.4.4
49+ addons: {"apt":{"sources":[{"sourceline":"deb http://ppa.launchpad.net/hvr/ghc/ubuntu xenial main","key_url":"https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x063dab2bdc0b3f9fcebc378bff3aeacef6f88286"}],"packages":["ghc-8.4.4","cabal-install-3.2"]}}
50+ os: linux
51+before_install:
52+ - HC=$(echo "/opt/$CC/bin/ghc" | sed 's/-/\//')
53+ - WITHCOMPILER="-w $HC"
54+ - HADDOCK=$(echo "/opt/$CC/bin/haddock" | sed 's/-/\//')
55+ - HCPKG="$HC-pkg"
56+ - unset CC
57+ - CABAL=/opt/ghc/bin/cabal
58+ - CABALHOME=$HOME/.cabal
59+ - export PATH="$CABALHOME/bin:$PATH"
60+ - TOP=$(pwd)
61+ - "HCNUMVER=$(${HC} --numeric-version|perl -ne '/^(\\d+)\\.(\\d+)\\.(\\d+)(\\.(\\d+))?$/; print(10000 * $1 + 100 * $2 + ($3 == 0 ? $5 != 1 : $3))')"
62+ - echo $HCNUMVER
63+ - CABAL="$CABAL -vnormal+nowrap"
64+ - set -o pipefail
65+ - TEST=--enable-tests
66+ - BENCH=--enable-benchmarks
67+ - HEADHACKAGE=false
68+ - rm -f $CABALHOME/config
69+ - |
70+ echo "verbose: normal +nowrap +markoutput" >> $CABALHOME/config
71+ echo "remote-build-reporting: anonymous" >> $CABALHOME/config
72+ echo "write-ghc-environment-files: always" >> $CABALHOME/config
73+ echo "remote-repo-cache: $CABALHOME/packages" >> $CABALHOME/config
74+ echo "logs-dir: $CABALHOME/logs" >> $CABALHOME/config
75+ echo "world-file: $CABALHOME/world" >> $CABALHOME/config
76+ echo "extra-prog-path: $CABALHOME/bin" >> $CABALHOME/config
77+ echo "symlink-bindir: $CABALHOME/bin" >> $CABALHOME/config
78+ echo "installdir: $CABALHOME/bin" >> $CABALHOME/config
79+ echo "build-summary: $CABALHOME/logs/build.log" >> $CABALHOME/config
80+ echo "store-dir: $CABALHOME/store" >> $CABALHOME/config
81+ echo "install-dirs user" >> $CABALHOME/config
82+ echo " prefix: $CABALHOME" >> $CABALHOME/config
83+ echo "repository hackage.haskell.org" >> $CABALHOME/config
84+ echo " url: http://hackage.haskell.org/" >> $CABALHOME/config
85+install:
86+ - ${CABAL} --version
87+ - echo "$(${HC} --version) [$(${HC} --print-project-git-commit-id 2> /dev/null || echo '?')]"
88+ - |
89+ echo "program-default-options" >> $CABALHOME/config
90+ echo " ghc-options: $GHCJOBS +RTS -M6G -RTS" >> $CABALHOME/config
91+ - cat $CABALHOME/config
92+ - rm -fv cabal.project cabal.project.local cabal.project.freeze
93+ - travis_retry ${CABAL} v2-update -v
94+ # Generate cabal.project
95+ - rm -rf cabal.project cabal.project.local cabal.project.freeze
96+ - touch cabal.project
97+ - |
98+ echo "packages: ." >> cabal.project
99+ - echo 'package openapi3' >> cabal.project
100+ - "echo ' ghc-options: -Werror=missing-methods' >> cabal.project"
101+ - |
102+ - "for pkg in $($HCPKG list --simple-output); do echo $pkg | sed 's/-[^-]*$//' | (grep -vE -- '^(openapi3)$' || true) | sed 's/^/constraints: /' | sed 's/$/ installed/' >> cabal.project.local; done"
103+ - cat cabal.project || true
104+ - cat cabal.project.local || true
105+ - if [ -f "./configure.ac" ]; then (cd "." && autoreconf -i); fi
106+ - ${CABAL} v2-freeze $WITHCOMPILER ${TEST} ${BENCH}
107+ - "cat cabal.project.freeze | sed -E 's/^(constraints: *| *)//' | sed 's/any.//'"
108+ - rm cabal.project.freeze
109+ - travis_wait 40 ${CABAL} v2-build $WITHCOMPILER ${TEST} ${BENCH} --dep -j2 all
110+ - travis_wait 40 ${CABAL} v2-build $WITHCOMPILER --disable-tests --disable-benchmarks --dep -j2 all
111+script:
112+ - DISTDIR=$(mktemp -d /tmp/dist-test.XXXX)
113+ # Packaging...
114+ - ${CABAL} v2-sdist all
115+ # Unpacking...
116+ - mv dist-newstyle/sdist/*.tar.gz ${DISTDIR}/
117+ - cd ${DISTDIR} || false
118+ - find . -maxdepth 1 -type f -name '*.tar.gz' -exec tar -xvf '{}' \;
119+ - find . -maxdepth 1 -type f -name '*.tar.gz' -exec rm '{}' \;
120+ - PKGDIR_openapi3="$(find . -maxdepth 1 -type d -regex '.*/openapi3-[0-9.]*')"
121+ # Generate cabal.project
122+ - rm -rf cabal.project cabal.project.local cabal.project.freeze
123+ - touch cabal.project
124+ - |
125+ echo "packages: ${PKGDIR_openapi3}" >> cabal.project
126+ - echo 'package openapi3' >> cabal.project
127+ - "echo ' ghc-options: -Werror=missing-methods' >> cabal.project"
128+ - |
129+ - "for pkg in $($HCPKG list --simple-output); do echo $pkg | sed 's/-[^-]*$//' | (grep -vE -- '^(openapi3)$' || true) | sed 's/^/constraints: /' | sed 's/$/ installed/' >> cabal.project.local; done"
130+ - cat cabal.project || true
131+ - cat cabal.project.local || true
132+ # Building...
133+ # this builds all libraries and executables (without tests/benchmarks)
134+ - ${CABAL} v2-build $WITHCOMPILER --disable-tests --disable-benchmarks all
135+ # Building with tests and benchmarks...
136+ # build & run tests, build benchmarks
137+ - ${CABAL} v2-build $WITHCOMPILER ${TEST} ${BENCH} all
138+ # Testing...
139+ - ${CABAL} v2-test $WITHCOMPILER ${TEST} ${BENCH} all
140+ # cabal check...
141+ - (cd ${PKGDIR_openapi3} && ${CABAL} -vnormal check)
142+ # haddock...
143+ - ${CABAL} v2-haddock $WITHCOMPILER --with-haddock $HADDOCK ${TEST} ${BENCH} all
144+ # Building without installed constraints for packages in global-db...
145+ - rm -f cabal.project.local
146+ - ${CABAL} v2-build $WITHCOMPILER --disable-tests --disable-benchmarks all
147+
148+# REGENDATA ("0.10.1",["--branches","master","--haddock-jobs=>=8.4","--output",".travis.yml","openapi3.cabal"])
149+# EOF
CHANGELOG.md−47
@@ -1,50 +1,3 @@
1−Unreleased
2−----------
3−
4−3.2.2
5−-----
6−
7−- Fix bug with infinite recursion in GToSchema [#37](https://github.com/biocad/openapi3/pull/37).
8−
9−3.2.1
10−-----
11−
12−- Support aeson-2.0.3.
13−- Support GHC-9.2 (doctests still fail).
14−
15−3.2.0
16−-----
17−
18−- Support aeson-2 [#34](https://github.com/biocad/openapi3/pull/34).
19−- Use `SecurityDefinitions` type for `_componentsSecuritySchemes`
20− [#32](https://github.com/biocad/openapi3/pull/32).
21−
22−3.1.0
23−-----
24−
25−- Use `format: date-time` for `ToParamSchema ZonedTime` instance (see
26− [#20](https://github.com/biocad/openapi3/pull/20)).
27−- Support generating schema for any polymorphic types via `Typeable` (see
28− [#19](https://github.com/biocad/openapi3/pull/19)).
29−- Allow `hashable-1.3.1`, prettify doctests (see [#18](https://github.com/biocad/openapi3/pull/18)).
30−
31−3.0.2.0
32−-------
33−
34−- Fix definition for HTTP security scheme (see [#10](https://github.com/biocad/openapi3/pull/10));
35−- Fix error message in `exclusiveMaximum` / `exclusiveMinimum` validation (see
36− [#15](https://github.com/biocad/openapi3/pull/15));
37−
38−3.0.1.0
39−-------
40−
41−- Support polymorphic types in schema generator.
42−
43−3.0.0
44−-----
45−
46−- Switch to OpenAPI 3.0 specification.
47−
482.6.1
12.6.1
49-----
2-----
50
3
README.md+2−2
@@ -1,4 +1,4 @@
1−# OpenApi 3
1+# swagger2
2
2
3[![Hackage](https://img.shields.io/hackage/v/openapi3.svg)](http://hackage.haskell.org/package/openapi3)
3[![Hackage](https://img.shields.io/hackage/v/openapi3.svg)](http://hackage.haskell.org/package/openapi3)
4[![Build Status](https://travis-ci.org/biocad/openapi3.svg?branch=master)](https://travis-ci.org/biocad/openapi3)
4[![Build Status](https://travis-ci.org/biocad/openapi3.svg?branch=master)](https://travis-ci.org/biocad/openapi3)
@@ -14,7 +14,7 @@ https://github.com/GetShopTV/swagger2.
14
14
15## Usage
15## Usage
16
16
17−This library is intended to be used for decoding and encoding OpenApi 3.0.3 specifications as well as manipulating them.
17+This library is intended to be used for decoding and encoding Swagger 2.0 API specifications as well as manipulating them.
18
18
19Please refer to [haddock documentation](http://hackage.haskell.org/package/openapi3).
19Please refer to [haddock documentation](http://hackage.haskell.org/package/openapi3).
20
20
cabal.haskell-cideleted−11
@@ -1,11 +0,0 @@
1−branches: master
2−
3−distribution: focal
4−allow-failures: >=9.2
5−
6−constraint-set aeson-1
7− constraints: aeson <2.0
8− ghc: <9.2
9−
10−constraint-set aeson-2
11− constraints: aeson >=2.0
cabal.project−2
@@ -1,4 +1,2 @@
1packages: .
1packages: .
2tests: true
2tests: true
3−
4−allow-newer: http-media:base
examples/hackage.hs+11−11
@@ -10,10 +10,10 @@ import Data.Proxy
10import Data.Text (Text)
10import Data.Text (Text)
11import GHC.Generics
11import GHC.Generics
12
12
13−import Data.OpenApi
13+import Data.Swagger
14−import Data.OpenApi.Declare
14+import Data.Swagger.Declare
15−import Data.OpenApi.Lens
15+import Data.Swagger.Lens
16−import Data.OpenApi.Operation
16+import Data.Swagger.Operation
17
17
18type Username = Text
18type Username = Text
19
19
@@ -27,7 +27,7 @@ instance ToSchema UserSummary where
27 usernameSchema <- declareSchemaRef (Proxy :: Proxy Username)
27 usernameSchema <- declareSchemaRef (Proxy :: Proxy Username)
28 useridSchema <- declareSchemaRef (Proxy :: Proxy Int)
28 useridSchema <- declareSchemaRef (Proxy :: Proxy Int)
29 return $ NamedSchema (Just "UserSummary") $ mempty
29 return $ NamedSchema (Just "UserSummary") $ mempty
30− & type_ ?~ OpenApiObject
30+ & type_ ?~ SwaggerObject
31 & properties .~
31 & properties .~
32 [ ("summaryUsername", usernameSchema )
32 [ ("summaryUsername", usernameSchema )
33 , ("summaryUserid" , useridSchema )
33 , ("summaryUserid" , useridSchema )
@@ -47,13 +47,13 @@ data UserDetailed = UserDetailed
47newtype Package = Package { packageName :: Text }
47newtype Package = Package { packageName :: Text }
48 deriving (Generic, ToSchema)
48 deriving (Generic, ToSchema)
49
49
50−hackageOpenApi :: OpenApi
50+hackageSwagger :: Swagger
51−hackageOpenApi = spec & components.schemas .~ defs
51+hackageSwagger = spec & components.schemas .~ defs
52 where
52 where
53− (defs, spec) = runDeclare declareHackageOpenApi mempty
53+ (defs, spec) = runDeclare declareHackageSwagger mempty
54
54
55−declareHackageOpenApi :: Declare (Definitions Schema) OpenApi
55+declareHackageSwagger :: Declare (Definitions Schema) Swagger
56−declareHackageOpenApi = do
56+declareHackageSwagger = do
57 -- param schemas
57 -- param schemas
58 let usernameParamSchema = toParamSchema (Proxy :: Proxy Username)
58 let usernameParamSchema = toParamSchema (Proxy :: Proxy Username)
59
59
@@ -78,5 +78,5 @@ declareHackageOpenApi = do
78 ]
78 ]
79
79
80main :: IO ()
80main :: IO ()
81−main = putStrLn . read . show . encode $ hackageOpenApi
81+main = putStrLn . read . show . encode $ hackageSwagger
82
82
openapi3.cabal+40−44
@@ -1,9 +1,9 @@
1cabal-version: >=1.10
1cabal-version: >=1.10
2name: openapi3
2name: openapi3
3−version: 3.2.2
3+version: 3.0.0
4
4
5synopsis: OpenAPI 3.0 data model
5synopsis: OpenAPI 3.0 data model
6−category: Web, Swagger, OpenApi
6+category: Web, Swagger
7description:
7description:
8 This library is intended to be used for decoding and encoding OpenAPI 3.0 API
8 This library is intended to be used for decoding and encoding OpenAPI 3.0 API
9 specifications as well as manipulating them.
9 specifications as well as manipulating them.
@@ -25,10 +25,8 @@ extra-source-files:
25tested-with:
25tested-with:
26 GHC ==8.4.4
26 GHC ==8.4.4
27 || ==8.6.5
27 || ==8.6.5
28− || ==8.8.4
28+ || ==8.8.3
29− || ==8.10.7
29+ || ==8.10.1
30− || ==9.0.2
31− || ==9.2.2
32
30
33custom-setup
31custom-setup
34 setup-depends:
32 setup-depends:
@@ -37,56 +35,54 @@ custom-setup
37library
35library
38 hs-source-dirs: src
36 hs-source-dirs: src
39 exposed-modules:
37 exposed-modules:
40− Data.OpenApi
38+ Data.Swagger
41− Data.OpenApi.Declare
39+ Data.Swagger.Declare
42− Data.OpenApi.Lens
40+ Data.Swagger.Lens
43− Data.OpenApi.Operation
41+ Data.Swagger.Operation
44− Data.OpenApi.Optics
42+ Data.Swagger.Optics
45− Data.OpenApi.ParamSchema
43+ Data.Swagger.ParamSchema
46− Data.OpenApi.Schema
44+ Data.Swagger.Schema
47− Data.OpenApi.Schema.Generator
45+ Data.Swagger.Schema.Generator
48− Data.OpenApi.Schema.Validation
46+ Data.Swagger.Schema.Validation
49− Data.OpenApi.SchemaOptions
47+ Data.Swagger.SchemaOptions
50
48
51 -- internal modules
49 -- internal modules
52− Data.OpenApi.Internal
50+ Data.Swagger.Internal
53− Data.OpenApi.Internal.Schema
51+ Data.Swagger.Internal.Schema
54− Data.OpenApi.Internal.Schema.Validation
52+ Data.Swagger.Internal.Schema.Validation
55− Data.OpenApi.Internal.ParamSchema
53+ Data.Swagger.Internal.ParamSchema
56− Data.OpenApi.Internal.Utils
54+ Data.Swagger.Internal.Utils
57− Data.OpenApi.Internal.AesonUtils
55+ Data.Swagger.Internal.AesonUtils
58− Data.OpenApi.Internal.TypeShape
56+ Data.Swagger.Internal.TypeShape
59−
60− Data.OpenApi.Aeson.Compat
61
57
62 -- GHC boot libraries
58 -- GHC boot libraries
63 build-depends:
59 build-depends:
64− base >=4.11.1.0 && <4.17
60+ base >=4.11.1.0 && <4.15
65− , bytestring >=0.10.8.2 && <0.12
61+ , bytestring >=0.10.8.2 && <0.11
66 , containers >=0.5.11.0 && <0.7
62 , containers >=0.5.11.0 && <0.7
67− , template-haskell >=2.13.0.0 && <2.19
63+ , template-haskell >=2.13.0.0 && <2.17
68− , time >=1.8.0.2 && <1.14
64+ , time >=1.8.0.2 && <1.10
69 , transformers >=0.5.5.0 && <0.6
65 , transformers >=0.5.5.0 && <0.6
70
66
71 build-depends:
67 build-depends:
72 mtl >=2.2.2 && <2.3
68 mtl >=2.2.2 && <2.3
73− , text >=1.2.3.1 && <2.1
69+ , text >=1.2.3.1 && <1.3
74
70
75 -- other dependencies
71 -- other dependencies
76 build-depends:
72 build-depends:
77− base-compat-batteries >=0.11.1 && <0.13
73+ base-compat-batteries >=0.11.1 && <0.12
78− , aeson >=1.4.2.0 && <1.6 || >=2.0.1.0 && < 2.1
74+ , aeson >=1.4.2.0 && <1.6
79 , aeson-pretty >=0.8.7 && <0.9
75 , aeson-pretty >=0.8.7 && <0.9
80 -- cookie 0.4.3 is needed by GHC 7.8 due to time>=1.4 constraint
76 -- cookie 0.4.3 is needed by GHC 7.8 due to time>=1.4 constraint
81 , cookie >=0.4.3 && <0.5
77 , cookie >=0.4.3 && <0.5
82 , generics-sop >=0.5.1.0 && <0.6
78 , generics-sop >=0.5.1.0 && <0.6
83− , hashable >=1.2.7.0 && <1.5
79+ , hashable >=1.2.7.0 && <1.4
84 , http-media >=0.8.0.0 && <0.9
80 , http-media >=0.8.0.0 && <0.9
85 , insert-ordered-containers >=0.2.3 && <0.3
81 , insert-ordered-containers >=0.2.3 && <0.3
86− , lens >=4.16.1 && <5.2
82+ , lens >=4.16.1 && <4.20
87 , network >=2.6.3.5 && <3.2
83 , network >=2.6.3.5 && <3.2
88− , optics-core >=0.2 && <0.5
84+ , optics-core >=0.2 && <0.4
89− , optics-th >=0.2 && <0.5
85+ , optics-th >=0.2 && <0.4
90 , scientific >=0.3.6.2 && <0.4
86 , scientific >=0.3.6.2 && <0.4
91 , unordered-containers >=0.2.9.0 && <0.3
87 , unordered-containers >=0.2.9.0 && <0.3
92 , uuid-types >=1.0.3 && <1.1
88 , uuid-types >=1.0.3 && <1.1
@@ -122,23 +118,23 @@ test-suite spec
122
118
123 -- test-suite only dependencies
119 -- test-suite only dependencies
124 build-depends:
120 build-depends:
125− hspec >=2.5.5 && <2.10
121+ hspec >=2.5.5 && <2.8
126 , HUnit >=1.6.0.0 && <1.7
122 , HUnit >=1.6.0.0 && <1.7
127 , quickcheck-instances >=0.3.19 && <0.14
123 , quickcheck-instances >=0.3.19 && <0.14
128 , utf8-string >=1.0.1.1 && <1.1
124 , utf8-string >=1.0.1.1 && <1.1
129
125
130 -- https://github.com/haskell/cabal/issues/3708
126 -- https://github.com/haskell/cabal/issues/3708
131 build-tool-depends:
127 build-tool-depends:
132− hspec-discover:hspec-discover >=2.5.5 && <2.10
128+ hspec-discover:hspec-discover >=2.5.5 && <2.8
133
129
134 other-modules:
130 other-modules:
135 SpecCommon
131 SpecCommon
136− Data.OpenApiSpec
132+ Data.SwaggerSpec
137− Data.OpenApi.CommonTestTypes
133+ Data.Swagger.CommonTestTypes
138− Data.OpenApi.ParamSchemaSpec
134+ Data.Swagger.ParamSchemaSpec
139− Data.OpenApi.SchemaSpec
135+ Data.Swagger.SchemaSpec
140− Data.OpenApi.Schema.ValidationSpec
136+ Data.Swagger.Schema.ValidationSpec
141− Data.OpenApi.Schema.GeneratorSpec
137+ Data.Swagger.Schema.GeneratorSpec
142 default-language: Haskell2010
138 default-language: Haskell2010
143
139
144test-suite doctests
140test-suite doctests
src/Data/OpenApi/Aeson/Compat.hsdeleted−76
@@ -1,76 +0,0 @@
1−{-# LANGUAGE CPP #-}
2−
3−module Data.OpenApi.Aeson.Compat where
4−
5−#if MIN_VERSION_aeson(2,0,0)
6−import Data.Aeson (Key)
7−import qualified Data.Aeson.Key as Key
8−import qualified Data.Aeson.KeyMap as KeyMap
9−#else
10−import qualified Data.HashMap.Strict as HM
11−#endif
12−import Data.Bifunctor (first)
13−import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
14−import qualified Data.Text as T
15−
16−#if MIN_VERSION_aeson(2,0,0)
17−deleteKey :: Key -> KeyMap.KeyMap v -> KeyMap.KeyMap v
18−deleteKey = KeyMap.delete
19−
20−objectToList :: KeyMap.KeyMap v -> [(Key, v)]
21−objectToList = KeyMap.toList
22−
23−objectKeys :: KeyMap.KeyMap v -> [T.Text]
24−objectKeys = map Key.toText . KeyMap.keys
25−
26−stringToKey :: String -> Key
27−stringToKey = Key.fromString
28−
29−keyToString :: Key -> String
30−keyToString = Key.toString
31−
32−keyToText :: Key -> T.Text
33−keyToText = Key.toText
34−
35−toInsOrdHashMap :: KeyMap.KeyMap v -> InsOrdHashMap.InsOrdHashMap T.Text v
36−toInsOrdHashMap = InsOrdHashMap.fromList . fmap (first Key.toText) . KeyMap.toList
37−
38−fromInsOrdHashMap :: InsOrdHashMap.InsOrdHashMap T.Text v -> KeyMap.KeyMap v
39−fromInsOrdHashMap = KeyMap.fromList . fmap (first Key.fromText) . InsOrdHashMap.toList
40−
41−lookupKey :: T.Text -> KeyMap.KeyMap v -> Maybe v
42−lookupKey = KeyMap.lookup . Key.fromText
43−
44−hasKey :: T.Text -> KeyMap.KeyMap a -> Bool
45−hasKey = KeyMap.member . Key.fromText
46−#else
47−deleteKey :: T.Text -> HM.HashMap T.Text v -> HM.HashMap T.Text v
48−deleteKey = HM.delete
49−
50−objectToList :: HM.HashMap T.Text v -> [(T.Text, v)]
51−objectToList = HM.toList
52−
53−objectKeys :: HM.HashMap T.Text v -> [T.Text]
54−objectKeys = HM.keys
55−
56−stringToKey :: String -> T.Text
57−stringToKey = T.pack
58−
59−keyToString :: T.Text -> String
60−keyToString = T.unpack
61−
62−keyToText :: T.Text -> T.Text
63−keyToText = id
64−
65−toInsOrdHashMap :: HM.HashMap T.Text v -> InsOrdHashMap.InsOrdHashMap T.Text v
66−toInsOrdHashMap = InsOrdHashMap.fromHashMap
67−
68−fromInsOrdHashMap :: InsOrdHashMap.InsOrdHashMap T.Text v -> HM.HashMap T.Text v
69−fromInsOrdHashMap = InsOrdHashMap.toHashMap
70−
71−lookupKey :: T.Text -> HM.HashMap T.Text v -> Maybe v
72−lookupKey = HM.lookup
73−
74−hasKey :: T.Text -> HM.HashMap T.Text a -> Bool
75−hasKey = HM.member
76−#endif
src/Data/OpenApi.hs → src/Data/Swagger.hsrenamed+47−168
@@ -1,5 +1,5 @@
1-- |
1-- |
2−-- Module: Data.OpenApi
2+-- Module: Data.Swagger
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
4-- Stability: experimental
4-- Stability: experimental
5--
5--
@@ -9,7 +9,7 @@
9-- These files can then be used by the Swagger-UI project to display the API
9-- These files can then be used by the Swagger-UI project to display the API
10-- and Swagger-Codegen to generate clients in various languages.
10-- and Swagger-Codegen to generate clients in various languages.
11-- Additional utilities can also take advantage of the resulting files, such as testing tools.
11-- Additional utilities can also take advantage of the resulting files, such as testing tools.
12−module Data.OpenApi (
12+module Data.Swagger (
13 -- * How to use this library
13 -- * How to use this library
14 -- $howto
14 -- $howto
15
15
@@ -29,15 +29,15 @@ module Data.OpenApi (
29 -- $validation
29 -- $validation
30
30
31 -- * Re-exports
31 -- * Re-exports
32− module Data.OpenApi.Lens,
32+ module Data.Swagger.Lens,
33− module Data.OpenApi.Optics,
33+ module Data.Swagger.Optics,
34− module Data.OpenApi.Operation,
34+ module Data.Swagger.Operation,
35− module Data.OpenApi.ParamSchema,
35+ module Data.Swagger.ParamSchema,
36− module Data.OpenApi.Schema,
36+ module Data.Swagger.Schema,
37− module Data.OpenApi.Schema.Validation,
37+ module Data.Swagger.Schema.Validation,
38
38
39 -- * Swagger specification
39 -- * Swagger specification
40− OpenApi(..),
40+ Swagger(..),
41 Server(..),
41 Server(..),
42 ServerVariable(..),
42 ServerVariable(..),
43 Components(..),
43 Components(..),
@@ -56,7 +56,7 @@ module Data.OpenApi (
56 TagName,
56 TagName,
57
57
58 -- ** Types and formats
58 -- ** Types and formats
59− OpenApiType(..),
59+ SwaggerType(..),
60 Format,
60 Format,
61 Definitions,
61 Definitions,
62 Style(..),
62 Style(..),
@@ -75,7 +75,7 @@ module Data.OpenApi (
75 -- ** Schemas
75 -- ** Schemas
76 Schema(..),
76 Schema(..),
77 NamedSchema(..),
77 NamedSchema(..),
78− OpenApiItems(..),
78+ SwaggerItems(..),
79 Xml(..),
79 Xml(..),
80 Pattern,
80 Pattern,
81 AdditionalProperties(..),
81 AdditionalProperties(..),
@@ -91,7 +91,6 @@ module Data.OpenApi (
91 -- ** Security
91 -- ** Security
92 SecurityScheme(..),
92 SecurityScheme(..),
93 SecuritySchemeType(..),
93 SecuritySchemeType(..),
94− HttpSchemeType(..),
95 SecurityDefinitions(..),
94 SecurityDefinitions(..),
96 SecurityRequirement(..),
95 SecurityRequirement(..),
97
96
@@ -121,14 +120,14 @@ module Data.OpenApi (
121 URL(..),
120 URL(..),
122) where
121) where
123
122
124−import Data.OpenApi.Lens
123+import Data.Swagger.Lens
125−import Data.OpenApi.Optics ()
124+import Data.Swagger.Optics ()
126−import Data.OpenApi.Operation
125+import Data.Swagger.Operation
127−import Data.OpenApi.ParamSchema
126+import Data.Swagger.ParamSchema
128−import Data.OpenApi.Schema
127+import Data.Swagger.Schema
129−import Data.OpenApi.Schema.Validation
128+import Data.Swagger.Schema.Validation
130
129
131−import Data.OpenApi.Internal
130+import Data.Swagger.Internal
132
131
133-- $setup
132-- $setup
134-- >>> import Control.Lens
133-- >>> import Control.Lens
@@ -137,7 +136,6 @@ import Data.OpenApi.Internal
137-- >>> import Data.Proxy
136-- >>> import Data.Proxy
138-- >>> import GHC.Generics
137-- >>> import GHC.Generics
139-- >>> import qualified Data.ByteString.Lazy.Char8 as BSL
138-- >>> import qualified Data.ByteString.Lazy.Char8 as BSL
140−-- >>> import Data.OpenApi.Internal.Utils
141-- >>> :set -XDeriveGeneric
139-- >>> :set -XDeriveGeneric
142-- >>> :set -XOverloadedStrings
140-- >>> :set -XOverloadedStrings
143-- >>> :set -XOverloadedLists
141-- >>> :set -XOverloadedLists
@@ -154,16 +152,8 @@ import Data.OpenApi.Internal
154--
152--
155-- In this library you can use @'mempty'@ for a default/empty value. For instance:
153-- In this library you can use @'mempty'@ for a default/empty value. For instance:
156--
154--
157−-- >>> BSL.putStrLn $ encodePretty (mempty :: OpenApi)
155+-- >>> BSL.putStrLn $ encode (mempty :: Swagger)
158−-- {
156+-- {"openapi":"3.0.0","info":{"version":"","title":""},"components":{}}
159−-- "components": {},
160−-- "info": {
161−-- "title": "",
162−-- "version": ""
163−-- },
164−-- "openapi": "3.0.0",
165−-- "paths": {}
166−-- }
167--
157--
168-- As you can see some spec properties (e.g. @"version"@) are there even when the spec is empty.
158-- As you can see some spec properties (e.g. @"version"@) are there even when the spec is empty.
169-- That is because these properties are actually required ones.
159-- That is because these properties are actually required ones.
@@ -171,87 +161,46 @@ import Data.OpenApi.Internal
171-- You /should/ always override the default (empty) value for these properties,
161-- You /should/ always override the default (empty) value for these properties,
172-- although it is not strictly necessary:
162-- although it is not strictly necessary:
173--
163--
174−-- >>> BSL.putStrLn $ encodePretty mempty { _infoTitle = "Todo API", _infoVersion = "1.0" }
164+-- >>> BSL.putStrLn $ encode mempty { _infoTitle = "Todo API", _infoVersion = "1.0" }
175−-- {
176−-- "title": "Todo API",
177−-- "version": "1.0"
165+-- {"version":"1.0","title":"Todo API"}
178−-- }
179--
166--
180-- You can merge two values using @'mappend'@ or its infix version @('<>')@:
167-- You can merge two values using @'mappend'@ or its infix version @('<>')@:
181--
168--
182−-- >>> BSL.putStrLn $ encodePretty $ mempty { _infoTitle = "Todo API" } <> mempty { _infoVersion = "1.0" }
169+-- >>> BSL.putStrLn $ encode $ mempty { _infoTitle = "Todo API" } <> mempty { _infoVersion = "1.0" }
183−-- {
184−-- "title": "Todo API",
185−-- "version": "1.0"
170+-- {"version":"1.0","title":"Todo API"}
186−-- }
187−
188--
171--
189-- This can be useful for combining specifications of endpoints into a whole API specification:
172-- This can be useful for combining specifications of endpoints into a whole API specification:
190--
173--
191-- @
174-- @
192-- \-\- /account subAPI specification
175-- \-\- /account subAPI specification
193−-- accountAPI :: OpenApi
176+-- accountAPI :: Swagger
194--
177--
195-- \-\- /task subAPI specification
178-- \-\- /task subAPI specification
196−-- taskAPI :: OpenApi
179+-- taskAPI :: Swagger
197--
180--
198-- \-\- while API specification is just a combination
181-- \-\- while API specification is just a combination
199-- \-\- of subAPIs' specifications
182-- \-\- of subAPIs' specifications
200−-- api :: OpenApi
183+-- api :: Swagger
201-- api = accountAPI <> taskAPI
184-- api = accountAPI <> taskAPI
202-- @
185-- @
203
186
204-- $lens
187-- $lens
205--
188--
206−-- Note: if you're working with the <https://hackage.haskell.org/package/optics optics> library, take a look at "Data.OpenApi.Optics".
189+-- Note: if you're working with the <https://hackage.haskell.org/package/optics optics> library, take a look at "Data.Swagger.Optics".
207--
190--
208-- Since @'Swagger'@ has a fairly complex structure, lenses and prisms are used
191-- Since @'Swagger'@ has a fairly complex structure, lenses and prisms are used
209-- to work comfortably with it. In combination with @'Monoid'@ instances, lenses
192-- to work comfortably with it. In combination with @'Monoid'@ instances, lenses
210-- make it fairly simple to construct/modify any part of the specification:
193-- make it fairly simple to construct/modify any part of the specification:
211--
194--
212-- >>> :{
195-- >>> :{
213−-- BSL.putStrLn $ encodePretty $ (mempty :: OpenApi)
196+-- BSL.putStrLn $ encode $ (mempty :: Swagger)
214−-- & components . schemas .~ [ ("User", mempty & type_ ?~ OpenApiString) ]
197+-- & components . schemas .~ [ ("User", mempty & type_ ?~ SwaggerString) ]
215-- & paths .~
198-- & paths .~
216-- [ ("/user", mempty & get ?~ (mempty
199-- [ ("/user", mempty & get ?~ (mempty
217-- & at 200 ?~ ("OK" & _Inline.content.at "application/json" ?~ (mempty & schema ?~ Ref (Reference "User")))
200-- & at 200 ?~ ("OK" & _Inline.content.at "application/json" ?~ (mempty & schema ?~ Ref (Reference "User")))
218-- & at 404 ?~ "User info not found")) ]
201-- & at 404 ?~ "User info not found")) ]
219-- :}
202-- :}
220−-- {
203+-- {"openapi":"3.0.0","info":{"version":"","title":""},"paths":{"/user":{"get":{"responses":{"404":{"description":"User info not found"},"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"OK"}}}}},"components":{"schemas":{"User":{"type":"string"}}}}
221−-- "components": {
222−-- "schemas": {
223−-- "User": {
224−-- "type": "string"
225−-- }
226−-- }
227−-- },
228−-- "info": {
229−-- "title": "",
230−-- "version": ""
231−-- },
232−-- "openapi": "3.0.0",
233−-- "paths": {
234−-- "/user": {
235−-- "get": {
236−-- "responses": {
237−-- "200": {
238−-- "content": {
239−-- "application/json": {
240−-- "schema": {
241−-- "$ref": "#/components/schemas/User"
242−-- }
243−-- }
244−-- },
245−-- "description": "OK"
246−-- },
247−-- "404": {
248−-- "description": "User info not found"
249−-- }
250−-- }
251−-- }
252−-- }
253−-- }
254−-- }
255--
204--
256-- In the snippet above we declare an API with a single path @/user@. This path provides method @GET@
205-- In the snippet above we declare an API with a single path @/user@. This path provides method @GET@
257-- which produces @application/json@ output. It should respond with code @200@ and body specified
206-- which produces @application/json@ output. It should respond with code @200@ and body specified
@@ -263,34 +212,23 @@ import Data.OpenApi.Internal
263-- common field is @'description'@. Many components of a Swagger specification
212-- common field is @'description'@. Many components of a Swagger specification
264-- can have descriptions, and you can use the same name for them:
213-- can have descriptions, and you can use the same name for them:
265--
214--
266−-- >>> BSL.putStrLn $ encodePretty $ (mempty :: Response) & description .~ "No content"
215+-- >>> BSL.putStrLn $ encode $ (mempty :: Response) & description .~ "No content"
267−-- {
268−-- "description": "No content"
216+-- {"description":"No content"}
269−-- }
270-- >>> :{
217-- >>> :{
271−-- BSL.putStrLn $ encodePretty $ (mempty :: Schema)
218+-- BSL.putStrLn $ encode $ (mempty :: Schema)
272−-- & type_ ?~ OpenApiBoolean
219+-- & type_ ?~ SwaggerBoolean
273-- & description ?~ "To be or not to be"
220-- & description ?~ "To be or not to be"
274-- :}
221-- :}
275−-- {
276−-- "description": "To be or not to be",
222+-- {"type":"boolean","description":"To be or not to be"}
277−-- "type": "boolean"
278−-- }
279--
223--
280-- Additionally, to simplify working with @'Response'@, both @'Operation'@ and @'Responses'@
224-- Additionally, to simplify working with @'Response'@, both @'Operation'@ and @'Responses'@
281-- have direct access to it via @'at' code@. Example:
225-- have direct access to it via @'at' code@. Example:
282--
226--
283-- >>> :{
227-- >>> :{
284−-- BSL.putStrLn $ encodePretty $ (mempty :: Operation)
228+-- BSL.putStrLn $ encode $ (mempty :: Operation)
285-- & at 404 ?~ "Not found"
229-- & at 404 ?~ "Not found"
286-- :}
230-- :}
287−-- {
288−-- "responses": {
289−-- "404": {
290−-- "description": "Not found"
231+-- {"responses":{"404":{"description":"Not found"}}}
291−-- }
292−-- }
293−-- }
294--
232--
295-- You might've noticed that @'type_'@ has an extra underscore in its name
233-- You might've noticed that @'type_'@ has an extra underscore in its name
296-- compared to, say, @'description'@ field accessor.
234-- compared to, say, @'description'@ field accessor.
@@ -306,7 +244,7 @@ import Data.OpenApi.Internal
306-- @'ParamSchema'@ and @'Schema'@ are the two core types for data model specification.
244-- @'ParamSchema'@ and @'Schema'@ are the two core types for data model specification.
307--
245--
308-- @'ParamSchema' t@ specifies all the common properties, available for every data schema.
246-- @'ParamSchema' t@ specifies all the common properties, available for every data schema.
309−-- The @t@ parameter imposes some restrictions on @type@ and @items@ properties (see @'OpenApiType'@ and @'OpenApiItems'@).
247+-- The @t@ parameter imposes some restrictions on @type@ and @items@ properties (see @'SwaggerType'@ and @'SwaggerItems'@).
310--
248--
311-- @'Schema'@ is used for request and response bodies and allows specifying objects
249-- @'Schema'@ is used for request and response bodies and allows specifying objects
312-- with properties in addition to what @'ParamSchema'@ provides.
250-- with properties in addition to what @'ParamSchema'@ provides.
@@ -337,27 +275,10 @@ import Data.OpenApi.Internal
337-- >>> data Person = Person { name :: String, age :: Integer } deriving Generic
275-- >>> data Person = Person { name :: String, age :: Integer } deriving Generic
338-- >>> instance ToJSON Person
276-- >>> instance ToJSON Person
339-- >>> instance ToSchema Person
277-- >>> instance ToSchema Person
340−-- >>> BSL.putStrLn $ encodePretty (Person "David" 28)
278+-- >>> BSL.putStrLn $ encode (Person "David" 28)
341−-- {
342−-- "age": 28,
343−-- "name": "David"
279+-- {"age":28,"name":"David"}
344−-- }
345−-- >>> BSL.putStrLn $ encodePretty $ toSchema (Proxy :: Proxy Person)
280+-- >>> BSL.putStrLn $ encode $ toSchema (Proxy :: Proxy Person)
346−-- {
281+-- {"required":["name","age"],"type":"object","properties":{"age":{"type":"integer"},"name":{"type":"string"}}}
347−-- "properties": {
348−-- "age": {
349−-- "type": "integer"
350−-- },
351−-- "name": {
352−-- "type": "string"
353−-- }
354−-- },
355−-- "required": [
356−-- "name",
357−-- "age"
358−-- ],
359−-- "type": "object"
360−-- }
361--
282--
362-- This package implements OpenAPI 3.0 spec, which supports @oneOf@ in schemas, allowing any sum types
283-- This package implements OpenAPI 3.0 spec, which supports @oneOf@ in schemas, allowing any sum types
363-- to be faithfully represented. All sum encodings supported by @aeson@ are supported here as well, with
284-- to be faithfully represented. All sum encodings supported by @aeson@ are supported here as well, with
@@ -368,50 +289,8 @@ import Data.OpenApi.Internal
368-- >>> data Error = ErrorNoUser { userId :: Int } | ErrorAccessDenied { requiredPermission :: String } deriving Generic
289-- >>> data Error = ErrorNoUser { userId :: Int } | ErrorAccessDenied { requiredPermission :: String } deriving Generic
369-- >>> instance ToJSON Error
290-- >>> instance ToJSON Error
370-- >>> instance ToSchema Error
291-- >>> instance ToSchema Error
371−-- >>> BSL.putStrLn $ encodePretty $ toSchema (Proxy :: Proxy Error)
292+-- >>> BSL.putStrLn $ encode $ toSchema (Proxy :: Proxy Error)
372−-- {
293+-- {"oneOf":[{"required":["userId","tag"],"type":"object","properties":{"tag":{"type":"string","enum":["ErrorNoUser"]},"userId":{"maximum":9223372036854775807,"minimum":-9223372036854775808,"type":"integer"}}},{"required":["requiredPermission","tag"],"type":"object","properties":{"tag":{"type":"string","enum":["ErrorAccessDenied"]},"requiredPermission":{"type":"string"}}}],"type":"object"}
373−-- "oneOf": [
374−-- {
375−-- "properties": {
376−-- "tag": {
377−-- "enum": [
378−-- "ErrorNoUser"
379−-- ],
380−-- "type": "string"
381−-- },
382−-- "userId": {
383−-- "maximum": 9223372036854775807,
384−-- "minimum": -9223372036854775808,
385−-- "type": "integer"
386−-- }
387−-- },
388−-- "required": [
389−-- "userId",
390−-- "tag"
391−-- ],
392−-- "type": "object"
393−-- },
394−-- {
395−-- "properties": {
396−-- "requiredPermission": {
397−-- "type": "string"
398−-- },
399−-- "tag": {
400−-- "enum": [
401−-- "ErrorAccessDenied"
402−-- ],
403−-- "type": "string"
404−-- }
405−-- },
406−-- "required": [
407−-- "requiredPermission",
408−-- "tag"
409−-- ],
410−-- "type": "object"
411−-- }
412−-- ],
413−-- "type": "object"
414−-- }
415
294
416-- $manipulation
295-- $manipulation
417-- Sometimes you have to work with an imported or generated @'Swagger'@.
296-- Sometimes you have to work with an imported or generated @'Swagger'@.
@@ -419,10 +298,10 @@ import Data.OpenApi.Internal
419-- for a type-level servant API.
298-- for a type-level servant API.
420--
299--
421-- Lenses and prisms can be used to manipulate such specification to add additional information, tags, extra responses, etc.
300-- Lenses and prisms can be used to manipulate such specification to add additional information, tags, extra responses, etc.
422−-- To facilitate common needs, @"Data.OpenApi.Operation"@ module provides useful helpers.
301+-- To facilitate common needs, @"Data.Swagger.Operation"@ module provides useful helpers.
423
302
424-- $validation
303-- $validation
425-- While @'ToParamSchema'@ and @'ToSchema'@ provide means to easily obtain schemas for Haskell types,
304-- While @'ToParamSchema'@ and @'ToSchema'@ provide means to easily obtain schemas for Haskell types,
426-- there is no static mechanism to ensure those instances correspond to the @'ToHttpApiData'@ or @'ToJSON'@ instances.
305-- there is no static mechanism to ensure those instances correspond to the @'ToHttpApiData'@ or @'ToJSON'@ instances.
427--
306--
428−-- @"Data.OpenApi.Schema.Validation"@ addresses @'ToJSON'@/@'ToSchema'@ validation.
307+-- @"Data.Swagger.Schema.Validation"@ addresses @'ToJSON'@/@'ToSchema'@ validation.
src/Data/OpenApi/Declare.hs → src/Data/Swagger/Declare.hsrenamed+2−2
@@ -4,12 +4,12 @@
4{-# LANGUAGE MultiParamTypeClasses #-}
4{-# LANGUAGE MultiParamTypeClasses #-}
5{-# LANGUAGE UndecidableInstances #-}
5{-# LANGUAGE UndecidableInstances #-}
6-- |
6-- |
7−-- Module: Data.OpenApi.Declare
7+-- Module: Data.Swagger.Declare
8-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
8-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
9-- Stability: experimental
9-- Stability: experimental
10--
10--
11-- Declare monad transformer and associated functions.
11-- Declare monad transformer and associated functions.
12−module Data.OpenApi.Declare where
12+module Data.Swagger.Declare where
13
13
14import Prelude ()
14import Prelude ()
15import Prelude.Compat
15import Prelude.Compat
src/Data/OpenApi/Internal.hs → src/Data/Swagger/Internal.hsrenamed+81−147
@@ -1,6 +1,6 @@
1−{-# LANGUAGE CPP #-}
2{-# LANGUAGE DataKinds #-}
1{-# LANGUAGE DataKinds #-}
3{-# LANGUAGE DeriveDataTypeable #-}
2{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveFunctor #-}
4{-# LANGUAGE DeriveGeneric #-}
4{-# LANGUAGE DeriveGeneric #-}
5{-# LANGUAGE DeriveTraversable #-}
5{-# LANGUAGE DeriveTraversable #-}
6{-# LANGUAGE FlexibleContexts #-}
6{-# LANGUAGE FlexibleContexts #-}
@@ -14,7 +14,7 @@
14{-# LANGUAGE TemplateHaskell #-}
14{-# LANGUAGE TemplateHaskell #-}
15{-# LANGUAGE TypeFamilies #-}
15{-# LANGUAGE TypeFamilies #-}
16{-# LANGUAGE UndecidableInstances #-}
16{-# LANGUAGE UndecidableInstances #-}
17−module Data.OpenApi.Internal where
17+module Data.Swagger.Internal where
18
18
19import Prelude ()
19import Prelude ()
20import Prelude.Compat
20import Prelude.Compat
@@ -22,9 +22,6 @@ import Prelude.Compat
22import Control.Applicative
22import Control.Applicative
23import Control.Lens ((&), (.~), (?~))
23import Control.Lens ((&), (.~), (?~))
24import Data.Aeson hiding (Encoding)
24import Data.Aeson hiding (Encoding)
25−#if MIN_VERSION_aeson(2,0,0)
26−import qualified Data.Aeson.KeyMap as KeyMap
27−#endif
28import qualified Data.Aeson.Types as JSON
25import qualified Data.Aeson.Types as JSON
29import Data.Data (Constr, Data (..), DataType, Fixity (..), Typeable,
26import Data.Data (Constr, Data (..), DataType, Fixity (..), Typeable,
30 constrIndex, mkConstr, mkDataType)
27 constrIndex, mkConstr, mkDataType)
@@ -49,56 +46,58 @@ import Text.Read (readMaybe)
49import Data.HashMap.Strict.InsOrd (InsOrdHashMap)
46import Data.HashMap.Strict.InsOrd (InsOrdHashMap)
50import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
47import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
51
48
52−import Data.OpenApi.Aeson.Compat (deleteKey)
53−import Data.OpenApi.Internal.AesonUtils (AesonDefaultValue (..), HasSwaggerAesonOptions (..),
54− mkSwaggerAesonOptions, saoAdditionalPairs, saoSubObject,
55− sopSwaggerGenericParseJSON, sopSwaggerGenericToEncoding,
56− sopSwaggerGenericToJSON, sopSwaggerGenericToJSONWithOpts)
57−import Data.OpenApi.Internal.Utils
58import Generics.SOP.TH (deriveGeneric)
49import Generics.SOP.TH (deriveGeneric)
50+import Data.Swagger.Internal.AesonUtils (sopSwaggerGenericToJSON
51+ ,sopSwaggerGenericToJSONWithOpts
52+ ,sopSwaggerGenericParseJSON
53+ ,HasSwaggerAesonOptions(..)
54+ ,AesonDefaultValue(..)
55+ ,mkSwaggerAesonOptions
56+ ,saoAdditionalPairs
57+ ,saoSubObject)
58+import Data.Swagger.Internal.Utils
59+import Data.Swagger.Internal.AesonUtils (sopSwaggerGenericToEncoding)
59
60
60-- $setup
61-- $setup
61-- >>> :seti -XDataKinds
62-- >>> :seti -XDataKinds
62-- >>> import Data.Aeson
63-- >>> import Data.Aeson
63−-- >>> import Data.ByteString.Lazy.Char8 as BSL
64−-- >>> import Data.OpenApi.Internal.Utils
65
64
66-- | A list of definitions that can be used in references.
65-- | A list of definitions that can be used in references.
67type Definitions = InsOrdHashMap Text
66type Definitions = InsOrdHashMap Text
68
67
69-- | This is the root document object for the API specification.
68-- | This is the root document object for the API specification.
70−data OpenApi = OpenApi
69+data Swagger = Swagger
71 { -- | Provides metadata about the API.
70 { -- | Provides metadata about the API.
72 -- The metadata can be used by the clients if needed.
71 -- The metadata can be used by the clients if needed.
73− _openApiInfo :: Info
72+ _swaggerInfo :: Info
74
73
75 -- | An array of Server Objects, which provide connectivity information
74 -- | An array of Server Objects, which provide connectivity information
76 -- to a target server. If the servers property is not provided, or is an empty array,
75 -- to a target server. If the servers property is not provided, or is an empty array,
77 -- the default value would be a 'Server' object with a url value of @/@.
76 -- the default value would be a 'Server' object with a url value of @/@.
78− , _openApiServers :: [Server]
77+ , _swaggerServers :: [Server]
79
78
80 -- | The available paths and operations for the API.
79 -- | The available paths and operations for the API.
81− , _openApiPaths :: InsOrdHashMap FilePath PathItem
80+ , _swaggerPaths :: InsOrdHashMap FilePath PathItem
82
81
83 -- | An element to hold various schemas for the specification.
82 -- | An element to hold various schemas for the specification.
84− , _openApiComponents :: Components
83+ , _swaggerComponents :: Components
85
84
86 -- | A declaration of which security mechanisms can be used across the API.
85 -- | A declaration of which security mechanisms can be used across the API.
87 -- The list of values includes alternative security requirement objects that can be used.
86 -- The list of values includes alternative security requirement objects that can be used.
88 -- Only one of the security requirement objects need to be satisfied to authorize a request.
87 -- Only one of the security requirement objects need to be satisfied to authorize a request.
89 -- Individual operations can override this definition.
88 -- Individual operations can override this definition.
90 -- To make security optional, an empty security requirement can be included in the array.
89 -- To make security optional, an empty security requirement can be included in the array.
91− , _openApiSecurity :: [SecurityRequirement]
90+ , _swaggerSecurity :: [SecurityRequirement]
92
91
93 -- | A list of tags used by the specification with additional metadata.
92 -- | A list of tags used by the specification with additional metadata.
94 -- The order of the tags can be used to reflect on their order by the parsing tools.
93 -- The order of the tags can be used to reflect on their order by the parsing tools.
95 -- Not all tags that are used by the 'Operation' Object must be declared.
94 -- Not all tags that are used by the 'Operation' Object must be declared.
96 -- The tags that are not declared MAY be organized randomly or based on the tools' logic.
95 -- The tags that are not declared MAY be organized randomly or based on the tools' logic.
97 -- Each tag name in the list MUST be unique.
96 -- Each tag name in the list MUST be unique.
98− , _openApiTags :: InsOrdHashSet Tag
97+ , _swaggerTags :: InsOrdHashSet Tag
99
98
100 -- | Additional external documentation.
99 -- | Additional external documentation.
101− , _openApiExternalDocs :: Maybe ExternalDocs
100+ , _swaggerExternalDocs :: Maybe ExternalDocs
102 } deriving (Eq, Show, Generic, Data, Typeable)
101 } deriving (Eq, Show, Generic, Data, Typeable)
103
102
104-- | The object provides metadata about the API.
103-- | The object provides metadata about the API.
@@ -196,7 +195,7 @@ data Components = Components
196 , _componentsExamples :: Definitions Example
195 , _componentsExamples :: Definitions Example
197 , _componentsRequestBodies :: Definitions RequestBody
196 , _componentsRequestBodies :: Definitions RequestBody
198 , _componentsHeaders :: Definitions Header
197 , _componentsHeaders :: Definitions Header
199− , _componentsSecuritySchemes :: SecurityDefinitions
198+ , _componentsSecuritySchemes :: Definitions SecurityScheme
200 , _componentsLinks :: Definitions Link
199 , _componentsLinks :: Definitions Link
201 , _componentsCallbacks :: Definitions Callback
200 , _componentsCallbacks :: Definitions Callback
202 } deriving (Eq, Show, Generic, Data, Typeable)
201 } deriving (Eq, Show, Generic, Data, Typeable)
@@ -337,7 +336,7 @@ data RequestBody = RequestBody
337 -- | The content of the request body.
336 -- | The content of the request body.
338 -- The key is a media type or media type range and the value describes it.
337 -- The key is a media type or media type range and the value describes it.
339 -- For requests that match multiple keys, only the most specific key is applicable.
338 -- For requests that match multiple keys, only the most specific key is applicable.
340− -- e.g. @text/plain@ overrides @text/\*@
339+ -- e.g. @text/plain@ overrides @text/*@
341 , _requestBodyContent :: InsOrdHashMap MediaType MediaTypeObject
340 , _requestBodyContent :: InsOrdHashMap MediaType MediaTypeObject
342
341
343 -- | Determines if the request body is required in the request.
342 -- | Determines if the request body is required in the request.
@@ -394,7 +393,7 @@ data Encoding = Encoding
394 -- for other primitive types – @text/plain@; for object - @application/json@;
393 -- for other primitive types – @text/plain@; for object - @application/json@;
395 -- for array – the default is defined based on the inner type.
394 -- for array – the default is defined based on the inner type.
396 -- The value can be a specific media type (e.g. @application/json@),
395 -- The value can be a specific media type (e.g. @application/json@),
397− -- a wildcard media type (e.g. @image/\*@), or a comma-separated list of the two types.
396+ -- a wildcard media type (e.g. @image/*@), or a comma-separated list of the two types.
398 _encodingContentType :: Maybe MediaType
397 _encodingContentType :: Maybe MediaType
399
398
400 -- | A map allowing additional information to be provided as headers,
399 -- | A map allowing additional information to be provided as headers,
@@ -434,11 +433,11 @@ mimeListConstr :: Constr
434mimeListConstr = mkConstr mimeListDataType "MimeList" ["getMimeList"] Prefix
433mimeListConstr = mkConstr mimeListDataType "MimeList" ["getMimeList"] Prefix
435
434
436mimeListDataType :: DataType
435mimeListDataType :: DataType
437−mimeListDataType = mkDataType "Data.OpenApi.MimeList" [mimeListConstr]
436+mimeListDataType = mkDataType "Data.Swagger.MimeList" [mimeListConstr]
438
437
439instance Data MimeList where
438instance Data MimeList where
440 gunfold k z c = case constrIndex c of
439 gunfold k z c = case constrIndex c of
441− 1 -> k (z (MimeList . map fromString))
440+ 1 -> k (z (\xs -> MimeList (map fromString xs)))
442 _ -> error $ "Data.Data.gunfold: Constructor " ++ show c ++ " is not of type MimeList."
441 _ -> error $ "Data.Data.gunfold: Constructor " ++ show c ++ " is not of type MimeList."
443 toConstr (MimeList _) = mimeListConstr
442 toConstr (MimeList _) = mimeListConstr
444 dataTypeOf _ = mimeListDataType
443 dataTypeOf _ = mimeListDataType
@@ -573,27 +572,27 @@ data Link = Link
573 , _linkServer :: Maybe Server
572 , _linkServer :: Maybe Server
574 } deriving (Eq, Show, Generic, Typeable, Data)
573 } deriving (Eq, Show, Generic, Typeable, Data)
575
574
576−-- | Items for @'OpenApiArray'@ schemas.
575+-- | Items for @'SwaggerArray'@ schemas.
577--
576--
578-- __Warning__: OpenAPI 3.0 does not support tuple arrays. However, OpenAPI 3.1 will, as
577-- __Warning__: OpenAPI 3.0 does not support tuple arrays. However, OpenAPI 3.1 will, as
579-- it will incorporate Json Schema mostly verbatim.
578-- it will incorporate Json Schema mostly verbatim.
580--
579--
581−-- @'OpenApiItemsObject'@ should be used to specify homogenous array @'Schema'@s.
580+-- @'SwaggerItemsObject'@ should be used to specify homogenous array @'Schema'@s.
582--
581--
583−-- @'OpenApiItemsArray'@ should be used to specify tuple @'Schema'@s.
582+-- @'SwaggerItemsArray'@ should be used to specify tuple @'Schema'@s.
584−data OpenApiItems where
583+data SwaggerItems where
585− OpenApiItemsObject :: Referenced Schema -> OpenApiItems
584+ SwaggerItemsObject :: Referenced Schema -> SwaggerItems
586− OpenApiItemsArray :: [Referenced Schema] -> OpenApiItems
585+ SwaggerItemsArray :: [Referenced Schema] -> SwaggerItems
587 deriving (Eq, Show, Typeable, Data)
586 deriving (Eq, Show, Typeable, Data)
588
587
589−data OpenApiType where
588+data SwaggerType where
590− OpenApiString :: OpenApiType
589+ SwaggerString :: SwaggerType
591− OpenApiNumber :: OpenApiType
590+ SwaggerNumber :: SwaggerType
592− OpenApiInteger :: OpenApiType
591+ SwaggerInteger :: SwaggerType
593− OpenApiBoolean :: OpenApiType
592+ SwaggerBoolean :: SwaggerType
594− OpenApiArray :: OpenApiType
593+ SwaggerArray :: SwaggerType
595− OpenApiNull :: OpenApiType
594+ SwaggerNull :: SwaggerType
596− OpenApiObject :: OpenApiType
595+ SwaggerObject :: SwaggerType
597 deriving (Eq, Show, Typeable, Generic, Data)
596 deriving (Eq, Show, Typeable, Generic, Data)
598
597
599data ParamLocation
598data ParamLocation
@@ -645,9 +644,9 @@ data Schema = Schema
645 -- Unlike JSON Schema this value MUST conform to the defined type for this parameter.
644 -- Unlike JSON Schema this value MUST conform to the defined type for this parameter.
646 _schemaDefault :: Maybe Value
645 _schemaDefault :: Maybe Value
647
646
648− , _schemaType :: Maybe OpenApiType
647+ , _schemaType :: Maybe SwaggerType
649 , _schemaFormat :: Maybe Format
648 , _schemaFormat :: Maybe Format
650− , _schemaItems :: Maybe OpenApiItems
649+ , _schemaItems :: Maybe SwaggerItems
651 , _schemaMaximum :: Maybe Scientific
650 , _schemaMaximum :: Maybe Scientific
652 , _schemaExclusiveMaximum :: Maybe Bool
651 , _schemaExclusiveMaximum :: Maybe Bool
653 , _schemaMinimum :: Maybe Scientific
652 , _schemaMinimum :: Maybe Scientific
@@ -682,7 +681,7 @@ data NamedSchema = NamedSchema
682
681
683data Xml = Xml
682data Xml = Xml
684 { -- | Replaces the name of the element/attribute used for the described schema property.
683 { -- | Replaces the name of the element/attribute used for the described schema property.
685− -- When defined within the @'OpenApiItems'@ (items), it will affect the name of the individual XML elements within the list.
684+ -- When defined within the @'SwaggerItems'@ (items), it will affect the name of the individual XML elements within the list.
686 -- When defined alongside type being array (outside the items),
685 -- When defined alongside type being array (outside the items),
687 -- it will affect the wrapping element and only if wrapped is true.
686 -- it will affect the wrapping element and only if wrapped is true.
688 -- If wrapped is false, it will be ignored.
687 -- If wrapped is false, it will be ignored.
@@ -734,7 +733,7 @@ data Response = Response
734 -- | A map containing descriptions of potential response payloads.
733 -- | A map containing descriptions of potential response payloads.
735 -- The key is a media type or media type range and the value describes it.
734 -- The key is a media type or media type range and the value describes it.
736 -- For responses that match multiple keys, only the most specific key is applicable.
735 -- For responses that match multiple keys, only the most specific key is applicable.
737− -- e.g. @text/plain@ overrides @text/\*@.
736+ -- e.g. @text/plain@ overrides @text/*@.
738 , _responseContent :: InsOrdHashMap MediaType MediaTypeObject
737 , _responseContent :: InsOrdHashMap MediaType MediaTypeObject
739
738
740 -- | Maps a header name to its definition.
739 -- | Maps a header name to its definition.
@@ -797,17 +796,17 @@ type AuthorizationURL = Text
797-- | The token URL to be used for OAuth2 flow. This SHOULD be in the form of a URL.
796-- | The token URL to be used for OAuth2 flow. This SHOULD be in the form of a URL.
798type TokenURL = Text
797type TokenURL = Text
799
798
800−newtype OAuth2ImplicitFlow
799+data OAuth2ImplicitFlow = OAuth2ImplicitFlow
801− = OAuth2ImplicitFlow {_oAuth2ImplicitFlowAuthorizationUrl :: AuthorizationURL}
800+ { _oAuth2ImplicitFlowAuthorizationUrl :: AuthorizationURL
802− deriving (Eq, Show, Generic, Data, Typeable)
801+ } deriving (Eq, Show, Generic, Data, Typeable)
803
802
804−newtype OAuth2PasswordFlow
803+data OAuth2PasswordFlow = OAuth2PasswordFlow
805− = OAuth2PasswordFlow {_oAuth2PasswordFlowTokenUrl :: TokenURL}
804+ { _oAuth2PasswordFlowTokenUrl :: TokenURL
806− deriving (Eq, Show, Generic, Data, Typeable)
805+ } deriving (Eq, Show, Generic, Data, Typeable)
807
806
808−newtype OAuth2ClientCredentialsFlow
807+data OAuth2ClientCredentialsFlow = OAuth2ClientCredentialsFlow
809− = OAuth2ClientCredentialsFlow {_oAuth2ClientCredentialsFlowTokenUrl :: TokenURL}
808+ { _oAuth2ClientCredentialsFlowTokenUrl :: TokenURL
810− deriving (Eq, Show, Generic, Data, Typeable)
809+ } deriving (Eq, Show, Generic, Data, Typeable)
811
810
812data OAuth2AuthorizationCodeFlow = OAuth2AuthorizationCodeFlow
811data OAuth2AuthorizationCodeFlow = OAuth2AuthorizationCodeFlow
813 { _oAuth2AuthorizationCodeFlowAuthorizationUrl :: AuthorizationURL
812 { _oAuth2AuthorizationCodeFlowAuthorizationUrl :: AuthorizationURL
@@ -840,50 +839,8 @@ data OAuth2Flows = OAuth2Flows
840 , _oAuth2FlowsAuthorizationCode :: Maybe (OAuth2Flow OAuth2AuthorizationCodeFlow)
839 , _oAuth2FlowsAuthorizationCode :: Maybe (OAuth2Flow OAuth2AuthorizationCodeFlow)
841 } deriving (Eq, Show, Generic, Data, Typeable)
840 } deriving (Eq, Show, Generic, Data, Typeable)
842
841
843−type BearerFormat = Text
844−
845−data HttpSchemeType
846− = HttpSchemeBearer (Maybe BearerFormat)
847− | HttpSchemeBasic
848− | HttpSchemeCustom Text
849− deriving (Eq, Show, Generic, Data, Typeable)
850−
851−-- |
852−--
853−-- >>> BSL.putStrLn $ encodePretty (SecuritySchemeHttp (HttpSchemeBearer Nothing))
854−-- {
855−-- "scheme": "bearer",
856−-- "type": "http"
857−-- }
858−--
859−-- >>> BSL.putStrLn $ encodePretty (SecuritySchemeHttp (HttpSchemeBearer (Just "jwt")))
860−-- {
861−-- "bearerFormat": "jwt",
862−-- "scheme": "bearer",
863−-- "type": "http"
864−-- }
865−--
866−-- >>> BSL.putStrLn $ encodePretty (SecuritySchemeHttp HttpSchemeBasic)
867−-- {
868−-- "scheme": "basic",
869−-- "type": "http"
870−-- }
871−--
872−-- >>> BSL.putStrLn $ encodePretty (SecuritySchemeHttp (HttpSchemeCustom "CANARY"))
873−-- {
874−-- "scheme": "CANARY",
875−-- "type": "http"
876−-- }
877−--
878−-- >>> BSL.putStrLn $ encodePretty (SecuritySchemeApiKey (ApiKeyParams "id" ApiKeyCookie))
879−-- {
880−-- "in": "cookie",
881−-- "name": "id",
882−-- "type": "apiKey"
883−-- }
884−--
885data SecuritySchemeType
842data SecuritySchemeType
886− = SecuritySchemeHttp HttpSchemeType
843+ = SecuritySchemeHttp
887 | SecuritySchemeApiKey ApiKeyParams
844 | SecuritySchemeApiKey ApiKeyParams
888 | SecuritySchemeOAuth2 OAuth2Flows
845 | SecuritySchemeOAuth2 OAuth2Flows
889 | SecuritySchemeOpenIdConnect URL
846 | SecuritySchemeOpenIdConnect URL
@@ -980,7 +937,7 @@ deriveGeneric ''MediaTypeObject
980deriveGeneric ''Responses
937deriveGeneric ''Responses
981deriveGeneric ''SecurityScheme
938deriveGeneric ''SecurityScheme
982deriveGeneric ''Schema
939deriveGeneric ''Schema
983−deriveGeneric ''OpenApi
940+deriveGeneric ''Swagger
984deriveGeneric ''Example
941deriveGeneric ''Example
985deriveGeneric ''Encoding
942deriveGeneric ''Encoding
986deriveGeneric ''Link
943deriveGeneric ''Link
@@ -989,9 +946,9 @@ deriveGeneric ''Link
989-- Monoid instances
946-- Monoid instances
990-- =======================================================================
947-- =======================================================================
991
948
992−instance Semigroup OpenApi where
949+instance Semigroup Swagger where
993 (<>) = genericMappend
950 (<>) = genericMappend
994−instance Monoid OpenApi where
951+instance Monoid Swagger where
995 mempty = genericMempty
952 mempty = genericMempty
996 mappend = (<>)
953 mappend = (<>)
997
954
@@ -1125,13 +1082,12 @@ instance SwaggerMonoid Response
1125instance SwaggerMonoid ExternalDocs
1082instance SwaggerMonoid ExternalDocs
1126instance SwaggerMonoid Operation
1083instance SwaggerMonoid Operation
1127instance (Eq a, Hashable a) => SwaggerMonoid (InsOrdHashSet a)
1084instance (Eq a, Hashable a) => SwaggerMonoid (InsOrdHashSet a)
1128−instance SwaggerMonoid SecurityDefinitions
1129
1085
1130instance SwaggerMonoid MimeList
1086instance SwaggerMonoid MimeList
1131deriving instance SwaggerMonoid URL
1087deriving instance SwaggerMonoid URL
1132
1088
1133−instance SwaggerMonoid OpenApiType where
1089+instance SwaggerMonoid SwaggerType where
1134− swaggerMempty = OpenApiString
1090+ swaggerMempty = SwaggerString
1135 swaggerMappend _ y = y
1091 swaggerMappend _ y = y
1136
1092
1137instance SwaggerMonoid ParamLocation where
1093instance SwaggerMonoid ParamLocation where
@@ -1154,7 +1110,7 @@ instance Monoid a => SwaggerMonoid (Referenced a) where
1154instance ToJSON Style where
1110instance ToJSON Style where
1155 toJSON = genericToJSON (jsonPrefix "Style")
1111 toJSON = genericToJSON (jsonPrefix "Style")
1156
1112
1157−instance ToJSON OpenApiType where
1113+instance ToJSON SwaggerType where
1158 toJSON = genericToJSON (jsonPrefix "Swagger")
1114 toJSON = genericToJSON (jsonPrefix "Swagger")
1159
1115
1160instance ToJSON ParamLocation where
1116instance ToJSON ParamLocation where
@@ -1209,7 +1165,7 @@ instance ToJSON OAuth2AuthorizationCodeFlow where
1209instance FromJSON Style where
1165instance FromJSON Style where
1210 parseJSON = genericParseJSON (jsonPrefix "Style")
1166 parseJSON = genericParseJSON (jsonPrefix "Style")
1211
1167
1212−instance FromJSON OpenApiType where
1168+instance FromJSON SwaggerType where
1213 parseJSON = genericParseJSON (jsonPrefix "Swagger")
1169 parseJSON = genericParseJSON (jsonPrefix "Swagger")
1214
1170
1215instance FromJSON ParamLocation where
1171instance FromJSON ParamLocation where
@@ -1274,19 +1230,8 @@ instance ToJSON OAuth2Flows where
1274 toEncoding = sopSwaggerGenericToEncoding
1230 toEncoding = sopSwaggerGenericToEncoding
1275
1231
1276instance ToJSON SecuritySchemeType where
1232instance ToJSON SecuritySchemeType where
1277− toJSON (SecuritySchemeHttp ty) = case ty of
1233+ toJSON SecuritySchemeHttp
1278− HttpSchemeBearer mFmt ->
1279− object $ [ "type" .= ("http" :: Text)
1280− , "scheme" .= ("bearer" :: Text)
1281− ] <> maybe [] (\t -> ["bearerFormat" .= t]) mFmt
1282− HttpSchemeBasic ->
1283− object [ "type" .= ("http" :: Text)
1284− , "scheme" .= ("basic" :: Text)
1285− ]
1286− HttpSchemeCustom t ->
1287− object [ "type" .= ("http" :: Text)
1234+ = object [ "type" .= ("http" :: Text) ]
1288− , "scheme" .= t
1289− ]
1290 toJSON (SecuritySchemeApiKey params)
1235 toJSON (SecuritySchemeApiKey params)
1291 = toJSON params
1236 = toJSON params
1292 <+> object [ "type" .= ("apiKey" :: Text) ]
1237 <+> object [ "type" .= ("apiKey" :: Text) ]
@@ -1299,9 +1244,9 @@ instance ToJSON SecuritySchemeType where
1299 , "openIdConnectUrl" .= url
1244 , "openIdConnectUrl" .= url
1300 ]
1245 ]
1301
1246
1302−instance ToJSON OpenApi where
1247+instance ToJSON Swagger where
1303 toJSON a = sopSwaggerGenericToJSON a &
1248 toJSON a = sopSwaggerGenericToJSON a &
1304− if InsOrdHashMap.null (_openApiPaths a)
1249+ if InsOrdHashMap.null (_swaggerPaths a)
1305 then (<+> object ["paths" .= object []])
1250 then (<+> object ["paths" .= object []])
1306 else id
1251 else id
1307 toEncoding = sopSwaggerGenericToEncoding
1252 toEncoding = sopSwaggerGenericToEncoding
@@ -1325,21 +1270,17 @@ instance ToJSON Header where
1325-- | As for nullary schema for 0-arity type constructors, see
1270-- | As for nullary schema for 0-arity type constructors, see
1326-- <https://github.com/GetShopTV/swagger2/issues/167>.
1271-- <https://github.com/GetShopTV/swagger2/issues/167>.
1327--
1272--
1328−-- >>> BSL.putStrLn $ encodePretty (OpenApiItemsArray [])
1273+-- >>> encode (SwaggerItemsArray [])
1329−-- {
1330−-- "example": [],
1331−-- "items": {},
1332−-- "maxItems": 0
1274+-- "{\"example\":[],\"items\":{},\"maxItems\":0}"
1333−-- }
1334--
1275--
1335−instance ToJSON OpenApiItems where
1276+instance ToJSON SwaggerItems where
1336− toJSON (OpenApiItemsObject x) = object [ "items" .= x ]
1277+ toJSON (SwaggerItemsObject x) = object [ "items" .= x ]
1337− toJSON (OpenApiItemsArray []) = object
1278+ toJSON (SwaggerItemsArray []) = object
1338 [ "items" .= object []
1279 [ "items" .= object []
1339 , "maxItems" .= (0 :: Int)
1280 , "maxItems" .= (0 :: Int)
1340 , "example" .= Array mempty
1281 , "example" .= Array mempty
1341 ]
1282 ]
1342− toJSON (OpenApiItemsArray x) = object [ "items" .= x ]
1283+ toJSON (SwaggerItemsArray x) = object [ "items" .= x ]
1343
1284
1344instance ToJSON Components where
1285instance ToJSON Components where
1345 toJSON = sopSwaggerGenericToJSON
1286 toJSON = sopSwaggerGenericToJSON
@@ -1439,19 +1380,14 @@ instance FromJSON SecuritySchemeType where
1439 parseJSON js@(Object o) = do
1380 parseJSON js@(Object o) = do
1440 (t :: Text) <- o .: "type"
1381 (t :: Text) <- o .: "type"
1441 case t of
1382 case t of
1442− "http" -> do
1443− scheme <- o .: "scheme"
1444− SecuritySchemeHttp <$> case scheme of
1383+ "http" -> pure SecuritySchemeHttp
1445− "bearer" -> HttpSchemeBearer <$> (o .:! "bearerFormat")
1446− "basic" -> pure HttpSchemeBasic
1447− t -> pure $ HttpSchemeCustom t
1448 "apiKey" -> SecuritySchemeApiKey <$> parseJSON js
1384 "apiKey" -> SecuritySchemeApiKey <$> parseJSON js
1449 "oauth2" -> SecuritySchemeOAuth2 <$> (o .: "flows")
1385 "oauth2" -> SecuritySchemeOAuth2 <$> (o .: "flows")
1450 "openIdConnect" -> SecuritySchemeOpenIdConnect <$> (o .: "openIdConnectUrl")
1386 "openIdConnect" -> SecuritySchemeOpenIdConnect <$> (o .: "openIdConnectUrl")
1451 _ -> empty
1387 _ -> empty
1452 parseJSON _ = empty
1388 parseJSON _ = empty
1453
1389
1454−instance FromJSON OpenApi where
1390+instance FromJSON Swagger where
1455 parseJSON = sopSwaggerGenericParseJSON
1391 parseJSON = sopSwaggerGenericParseJSON
1456
1392
1457instance FromJSON Server where
1393instance FromJSON Server where
@@ -1464,7 +1400,7 @@ instance FromJSON Schema where
1464 parseJSON = fmap nullaryCleanup . sopSwaggerGenericParseJSON
1400 parseJSON = fmap nullaryCleanup . sopSwaggerGenericParseJSON
1465 where nullaryCleanup :: Schema -> Schema
1401 where nullaryCleanup :: Schema -> Schema
1466 nullaryCleanup s =
1402 nullaryCleanup s =
1467− if _schemaItems s == Just (OpenApiItemsArray [])
1403+ if _schemaItems s == Just (SwaggerItemsArray [])
1468 then s { _schemaExample = Nothing
1404 then s { _schemaExample = Nothing
1469 , _schemaMaxItems = Nothing
1405 , _schemaMaxItems = Nothing
1470 }
1406 }
@@ -1473,18 +1409,18 @@ instance FromJSON Schema where
1473instance FromJSON Header where
1409instance FromJSON Header where
1474 parseJSON = sopSwaggerGenericParseJSON
1410 parseJSON = sopSwaggerGenericParseJSON
1475
1411
1476−instance FromJSON OpenApiItems where
1412+instance FromJSON SwaggerItems where
1477 parseJSON js@(Object obj)
1413 parseJSON js@(Object obj)
1478− | null obj = pure $ OpenApiItemsArray [] -- Nullary schema.
1414+ | null obj = pure $ SwaggerItemsArray [] -- Nullary schema.
1479− | otherwise = OpenApiItemsObject <$> parseJSON js
1415+ | otherwise = SwaggerItemsObject <$> parseJSON js
1480− parseJSON js@(Array _) = OpenApiItemsArray <$> parseJSON js
1416+ parseJSON js@(Array _) = SwaggerItemsArray <$> parseJSON js
1481 parseJSON _ = empty
1417 parseJSON _ = empty
1482
1418
1483instance FromJSON Components where
1419instance FromJSON Components where
1484 parseJSON = sopSwaggerGenericParseJSON
1420 parseJSON = sopSwaggerGenericParseJSON
1485
1421
1486instance FromJSON MimeList where
1422instance FromJSON MimeList where
1487− parseJSON js = MimeList . map fromString <$> parseJSON js
1423+ parseJSON js = (MimeList . map fromString) <$> parseJSON js
1488
1424
1489instance FromJSON Param where
1425instance FromJSON Param where
1490 parseJSON = sopSwaggerGenericParseJSON
1426 parseJSON = sopSwaggerGenericParseJSON
@@ -1492,7 +1428,7 @@ instance FromJSON Param where
1492instance FromJSON Responses where
1428instance FromJSON Responses where
1493 parseJSON (Object o) = Responses
1429 parseJSON (Object o) = Responses
1494 <$> o .:? "default"
1430 <$> o .:? "default"
1495− <*> parseJSON (Object (deleteKey "default" o))
1431+ <*> (parseJSON (Object (HashMap.delete "default" o)))
1496 parseJSON _ = empty
1432 parseJSON _ = empty
1497
1433
1498instance FromJSON Example where
1434instance FromJSON Example where
@@ -1591,7 +1527,7 @@ instance HasSwaggerAesonOptions SecurityScheme where
1591 swaggerAesonOptions _ = mkSwaggerAesonOptions "securityScheme" & saoSubObject ?~ "type"
1527 swaggerAesonOptions _ = mkSwaggerAesonOptions "securityScheme" & saoSubObject ?~ "type"
1592instance HasSwaggerAesonOptions Schema where
1528instance HasSwaggerAesonOptions Schema where
1593 swaggerAesonOptions _ = mkSwaggerAesonOptions "schema" & saoSubObject ?~ "paramSchema"
1529 swaggerAesonOptions _ = mkSwaggerAesonOptions "schema" & saoSubObject ?~ "paramSchema"
1594−instance HasSwaggerAesonOptions OpenApi where
1530+instance HasSwaggerAesonOptions Swagger where
1595 swaggerAesonOptions _ = mkSwaggerAesonOptions "swagger" & saoAdditionalPairs .~ [("openapi", "3.0.0")]
1531 swaggerAesonOptions _ = mkSwaggerAesonOptions "swagger" & saoAdditionalPairs .~ [("openapi", "3.0.0")]
1596instance HasSwaggerAesonOptions Example where
1532instance HasSwaggerAesonOptions Example where
1597 swaggerAesonOptions _ = mkSwaggerAesonOptions "example"
1533 swaggerAesonOptions _ = mkSwaggerAesonOptions "example"
@@ -1610,10 +1546,8 @@ instance AesonDefaultValue OAuth2AuthorizationCodeFlow
1610instance AesonDefaultValue p => AesonDefaultValue (OAuth2Flow p)
1546instance AesonDefaultValue p => AesonDefaultValue (OAuth2Flow p)
1611instance AesonDefaultValue Responses
1547instance AesonDefaultValue Responses
1612instance AesonDefaultValue SecuritySchemeType
1548instance AesonDefaultValue SecuritySchemeType
1613−instance AesonDefaultValue OpenApiType
1549+instance AesonDefaultValue SwaggerType
1614instance AesonDefaultValue MimeList where defaultValue = Just mempty
1550instance AesonDefaultValue MimeList where defaultValue = Just mempty
1615instance AesonDefaultValue Info
1551instance AesonDefaultValue Info
1616instance AesonDefaultValue ParamLocation
1552instance AesonDefaultValue ParamLocation
1617instance AesonDefaultValue Link
1553instance AesonDefaultValue Link
1618−instance AesonDefaultValue SecurityDefinitions where
1619− defaultValue = Just mempty
src/Data/OpenApi/Internal/AesonUtils.hs → src/Data/Swagger/Internal/AesonUtils.hsrenamed+13−12
@@ -5,7 +5,7 @@
5{-# LANGUAGE ExplicitForAll #-}
5{-# LANGUAGE ExplicitForAll #-}
6{-# LANGUAGE TemplateHaskell #-}
6{-# LANGUAGE TemplateHaskell #-}
7{-# LANGUAGE UndecidableSuperClasses #-}
7{-# LANGUAGE UndecidableSuperClasses #-}
8−module Data.OpenApi.Internal.AesonUtils (
8+module Data.Swagger.Internal.AesonUtils (
9 -- * Generic functions
9 -- * Generic functions
10 AesonDefaultValue(..),
10 AesonDefaultValue(..),
11 sopSwaggerGenericToJSON,
11 sopSwaggerGenericToJSON,
@@ -27,7 +27,7 @@ import Prelude.Compat
27import Control.Applicative ((<|>))
27import Control.Applicative ((<|>))
28import Control.Lens (makeLenses, (^.))
28import Control.Lens (makeLenses, (^.))
29import Control.Monad (unless)
29import Control.Monad (unless)
30−import Data.Aeson (ToJSON(..), FromJSON(..), Value(..), Object, object, (.:), (.:?), (.!=), withObject, Encoding, pairs, (.=), Series)
30+import Data.Aeson (ToJSON(..), FromJSON(..), Value(..), Object, object, (.:), (.:?), (.!=), withObject)
31import Data.Aeson.Types (Parser, Pair)
31import Data.Aeson.Types (Parser, Pair)
32import Data.Char (toLower, isUpper)
32import Data.Char (toLower, isUpper)
33import Data.Foldable (traverse_)
33import Data.Foldable (traverse_)
@@ -36,11 +36,12 @@ import Data.Text (Text)
36import Generics.SOP
36import Generics.SOP
37
37
38import qualified Data.Text as T
38import qualified Data.Text as T
39+import qualified Data.HashMap.Strict as HM
39import qualified Data.Set as Set
40import qualified Data.Set as Set
40import qualified Data.HashMap.Strict.InsOrd as InsOrd
41import qualified Data.HashMap.Strict.InsOrd as InsOrd
41import qualified Data.HashSet.InsOrd as InsOrdHS
42import qualified Data.HashSet.InsOrd as InsOrdHS
42
43
43−import Data.OpenApi.Aeson.Compat (keyToString, objectToList, stringToKey)
44+import Data.Aeson (Encoding, pairs, (.=), Series)
44
45
45-------------------------------------------------------------------------------
46-------------------------------------------------------------------------------
46-- SwaggerAesonOptions
47-- SwaggerAesonOptions
@@ -48,7 +49,7 @@ import Data.OpenApi.Aeson.Compat (keyToString, objectToList, stringToKey)
48
49
49data SwaggerAesonOptions = SwaggerAesonOptions
50data SwaggerAesonOptions = SwaggerAesonOptions
50 { _saoPrefix :: String
51 { _saoPrefix :: String
51− , _saoAdditionalPairs :: [Pair]
52+ , _saoAdditionalPairs :: [(Text, Value)]
52 , _saoSubObject :: Maybe String
53 , _saoSubObject :: Maybe String
53 }
54 }
54
55
@@ -155,14 +156,14 @@ sopSwaggerGenericToJSON'' (SwaggerAesonOptions prefix _ sub) = go
155 go Nil Nil Nil = []
156 go Nil Nil Nil = []
156 go (I x :* xs) (FieldInfo name :* names) (def :* defs)
157 go (I x :* xs) (FieldInfo name :* names) (def :* defs)
157 | Just name' == sub = case json of
158 | Just name' == sub = case json of
158− Object m -> objectToList m ++ rest
159+ Object m -> HM.toList m ++ rest
159 Null -> rest
160 Null -> rest
160 _ -> error $ "sopSwaggerGenericToJSON: subjson is not an object: " ++ show json
161 _ -> error $ "sopSwaggerGenericToJSON: subjson is not an object: " ++ show json
161 -- If default value: omit it.
162 -- If default value: omit it.
162 | Just x == def =
163 | Just x == def =
163 rest
164 rest
164 | otherwise =
165 | otherwise =
165− (stringToKey name', json) : rest
166+ (T.pack name', json) : rest
166 where
167 where
167 json = toJSON x
168 json = toJSON x
168 name' = fieldNameModifier name
169 name' = fieldNameModifier name
@@ -196,11 +197,11 @@ sopSwaggerGenericParseJSON = withObject "Swagger Record Object" $ \obj ->
196 proxy = Proxy :: Proxy a
197 proxy = Proxy :: Proxy a
197 opts = swaggerAesonOptions proxy
198 opts = swaggerAesonOptions proxy
198
199
199− parseAdditionalField :: Object -> Pair -> Parser ()
200+ parseAdditionalField :: Object -> (Text, Value) -> Parser ()
200 parseAdditionalField obj (k, v) = do
201 parseAdditionalField obj (k, v) = do
201 v' <- obj .: k
202 v' <- obj .: k
202 unless (v == v') $ fail $
203 unless (v == v') $ fail $
203− "Additonal field don't match for key " ++ keyToString k
204+ "Additonal field don't match for key " ++ T.unpack k
204 ++ ": " ++ show v
205 ++ ": " ++ show v
205 ++ " /= " ++ show v'
206 ++ " /= " ++ show v'
206
207
@@ -231,8 +232,8 @@ sopSwaggerGenericParseJSON'' (SwaggerAesonOptions prefix _ sub) obj = go
231 -- Note: we might strip fields of outer structure.
232 -- Note: we might strip fields of outer structure.
232 cons <$> (withDef $ parseJSON $ Object obj) <*> rest
233 cons <$> (withDef $ parseJSON $ Object obj) <*> rest
233 | otherwise = case def of
234 | otherwise = case def of
234− Just def' -> cons <$> obj .:? stringToKey name' .!= def' <*> rest
235+ Just def' -> cons <$> obj .:? T.pack name' .!= def' <*> rest
235− Nothing -> cons <$> obj .: stringToKey name' <*> rest
236+ Nothing -> cons <$> obj .: T.pack name' <*> rest
236 where
237 where
237 cons h t = I h :* t
238 cons h t = I h :* t
238 name' = fieldNameModifier name
239 name' = fieldNameModifier name
@@ -295,14 +296,14 @@ sopSwaggerGenericToEncoding'' (SwaggerAesonOptions prefix _ sub) = go
295 go Nil Nil Nil = mempty
296 go Nil Nil Nil = mempty
296 go (I x :* xs) (FieldInfo name :* names) (def :* defs)
297 go (I x :* xs) (FieldInfo name :* names) (def :* defs)
297 | Just name' == sub = case toJSON x of
298 | Just name' == sub = case toJSON x of
298− Object m -> pairsToSeries (objectToList m) <> rest
299+ Object m -> pairsToSeries (HM.toList m) <> rest
299 Null -> rest
300 Null -> rest
300 _ -> error $ "sopSwaggerGenericToJSON: subjson is not an object: " ++ show (toJSON x)
301 _ -> error $ "sopSwaggerGenericToJSON: subjson is not an object: " ++ show (toJSON x)
301 -- If default value: omit it.
302 -- If default value: omit it.
302 | Just x == def =
303 | Just x == def =
303 rest
304 rest
304 | otherwise =
305 | otherwise =
305− (stringToKey name' .= x) <> rest
306+ (T.pack name' .= x) <> rest
306 where
307 where
307 name' = fieldNameModifier name
308 name' = fieldNameModifier name
308 rest = go xs names defs
309 rest = go xs names defs
src/Data/OpenApi/Internal/ParamSchema.hs → src/Data/Swagger/Internal/ParamSchema.hsrenamed+37−55
@@ -15,7 +15,7 @@
15{-# OPTIONS_GHC -Wno-redundant-constraints #-}
15{-# OPTIONS_GHC -Wno-redundant-constraints #-}
16-- For TypeErrors
16-- For TypeErrors
17{-# OPTIONS_GHC -Wno-unticked-promoted-constructors #-}
17{-# OPTIONS_GHC -Wno-unticked-promoted-constructors #-}
18−module Data.OpenApi.Internal.ParamSchema where
18+module Data.Swagger.Internal.ParamSchema where
19
19
20import Control.Lens
20import Control.Lens
21import Data.Aeson (ToJSON (..))
21import Data.Aeson (ToJSON (..))
@@ -41,31 +41,31 @@ import Data.Word
41import Data.UUID.Types (UUID)
41import Data.UUID.Types (UUID)
42import Web.Cookie (SetCookie)
42import Web.Cookie (SetCookie)
43
43
44−import Data.OpenApi.Internal
44+import Data.Swagger.Internal
45−import Data.OpenApi.Lens
45+import Data.Swagger.Lens
46−import Data.OpenApi.SchemaOptions
46+import Data.Swagger.SchemaOptions
47
47
48import qualified Data.ByteString as BS
48import qualified Data.ByteString as BS
49−import qualified Data.ByteString.Lazy.Char8 as BSL
49+import qualified Data.ByteString.Lazy as BSL
50import GHC.TypeLits (TypeError, ErrorMessage(..))
50import GHC.TypeLits (TypeError, ErrorMessage(..))
51
51
52-- | Default schema for binary data (any sequence of octets).
52-- | Default schema for binary data (any sequence of octets).
53binarySchema :: Schema
53binarySchema :: Schema
54binarySchema = mempty
54binarySchema = mempty
55− & type_ ?~ OpenApiString
55+ & type_ ?~ SwaggerString
56 & format ?~ "binary"
56 & format ?~ "binary"
57
57
58-- | Default schema for binary data (base64 encoded).
58-- | Default schema for binary data (base64 encoded).
59byteSchema :: Schema
59byteSchema :: Schema
60byteSchema = mempty
60byteSchema = mempty
61− & type_ ?~ OpenApiString
61+ & type_ ?~ SwaggerString
62 & format ?~ "byte"
62 & format ?~ "byte"
63
63
64-- | Default schema for password string.
64-- | Default schema for password string.
65-- @"password"@ format is used to hint UIs the input needs to be obscured.
65-- @"password"@ format is used to hint UIs the input needs to be obscured.
66passwordSchema :: Schema
66passwordSchema :: Schema
67passwordSchema = mempty
67passwordSchema = mempty
68− & type_ ?~ OpenApiString
68+ & type_ ?~ SwaggerString
69 & format ?~ "password"
69 & format ?~ "password"
70
70
71-- | Convert a type into a plain @'Schema'@.
71-- | Convert a type into a plain @'Schema'@.
@@ -87,7 +87,7 @@ passwordSchema = mempty
87--
87--
88-- instance ToParamSchema Direction where
88-- instance ToParamSchema Direction where
89-- toParamSchema _ = mempty
89-- toParamSchema _ = mempty
90−-- & type_ ?~ OpenApiString
90+-- & type_ ?~ SwaggerString
91-- & enum_ ?~ [ \"Up\", \"Down\" ]
91-- & enum_ ?~ [ \"Up\", \"Down\" ]
92-- @
92-- @
93--
93--
@@ -112,26 +112,24 @@ passwordSchema = mempty
112class ToParamSchema a where
112class ToParamSchema a where
113 -- | Convert a type into a plain parameter schema.
113 -- | Convert a type into a plain parameter schema.
114 --
114 --
115− -- >>> BSL.putStrLn $ encodePretty $ toParamSchema (Proxy :: Proxy Integer)
115+ -- >>> encode $ toParamSchema (Proxy :: Proxy Integer)
116− -- {
117− -- "type": "integer"
116+ -- "{\"type\":\"integer\"}"
118− -- }
119 toParamSchema :: Proxy a -> Schema
117 toParamSchema :: Proxy a -> Schema
120 default toParamSchema :: (Generic a, GToParamSchema (Rep a)) => Proxy a -> Schema
118 default toParamSchema :: (Generic a, GToParamSchema (Rep a)) => Proxy a -> Schema
121 toParamSchema = genericToParamSchema defaultSchemaOptions
119 toParamSchema = genericToParamSchema defaultSchemaOptions
122
120
123instance {-# OVERLAPPING #-} ToParamSchema String where
121instance {-# OVERLAPPING #-} ToParamSchema String where
124− toParamSchema _ = mempty & type_ ?~ OpenApiString
122+ toParamSchema _ = mempty & type_ ?~ SwaggerString
125
123
126instance ToParamSchema Bool where
124instance ToParamSchema Bool where
127− toParamSchema _ = mempty & type_ ?~ OpenApiBoolean
125+ toParamSchema _ = mempty & type_ ?~ SwaggerBoolean
128
126
129instance ToParamSchema Integer where
127instance ToParamSchema Integer where
130− toParamSchema _ = mempty & type_ ?~ OpenApiInteger
128+ toParamSchema _ = mempty & type_ ?~ SwaggerInteger
131
129
132instance ToParamSchema Natural where
130instance ToParamSchema Natural where
133 toParamSchema _ = mempty
131 toParamSchema _ = mempty
134− & type_ ?~ OpenApiInteger
132+ & type_ ?~ SwaggerInteger
135 & minimum_ ?~ 0
133 & minimum_ ?~ 0
136 & exclusiveMinimum ?~ False
134 & exclusiveMinimum ?~ False
137
135
@@ -157,45 +155,41 @@ instance ToParamSchema Word64 where
157
155
158-- | Default plain schema for @'Bounded'@, @'Integral'@ types.
156-- | Default plain schema for @'Bounded'@, @'Integral'@ types.
159--
157--
160−-- >>> BSL.putStrLn $ encodePretty $ toParamSchemaBoundedIntegral (Proxy :: Proxy Int8)
158+-- >>> encode $ toParamSchemaBoundedIntegral (Proxy :: Proxy Int8)
161−-- {
162−-- "maximum": 127,
163−-- "minimum": -128,
164−-- "type": "integer"
159+-- "{\"maximum\":127,\"minimum\":-128,\"type\":\"integer\"}"
165−-- }
166toParamSchemaBoundedIntegral :: forall a t. (Bounded a, Integral a) => Proxy a -> Schema
160toParamSchemaBoundedIntegral :: forall a t. (Bounded a, Integral a) => Proxy a -> Schema
167toParamSchemaBoundedIntegral _ = mempty
161toParamSchemaBoundedIntegral _ = mempty
168− & type_ ?~ OpenApiInteger
162+ & type_ ?~ SwaggerInteger
169 & minimum_ ?~ fromInteger (toInteger (minBound :: a))
163 & minimum_ ?~ fromInteger (toInteger (minBound :: a))
170 & maximum_ ?~ fromInteger (toInteger (maxBound :: a))
164 & maximum_ ?~ fromInteger (toInteger (maxBound :: a))
171
165
172instance ToParamSchema Char where
166instance ToParamSchema Char where
173 toParamSchema _ = mempty
167 toParamSchema _ = mempty
174− & type_ ?~ OpenApiString
168+ & type_ ?~ SwaggerString
175 & maxLength ?~ 1
169 & maxLength ?~ 1
176 & minLength ?~ 1
170 & minLength ?~ 1
177
171
178instance ToParamSchema Scientific where
172instance ToParamSchema Scientific where
179− toParamSchema _ = mempty & type_ ?~ OpenApiNumber
173+ toParamSchema _ = mempty & type_ ?~ SwaggerNumber
180
174
181instance HasResolution a => ToParamSchema (Fixed a) where
175instance HasResolution a => ToParamSchema (Fixed a) where
182 toParamSchema _ = mempty
176 toParamSchema _ = mempty
183− & type_ ?~ OpenApiNumber
177+ & type_ ?~ SwaggerNumber
184 & multipleOf ?~ (recip . fromInteger $ resolution (Proxy :: Proxy a))
178 & multipleOf ?~ (recip . fromInteger $ resolution (Proxy :: Proxy a))
185
179
186instance ToParamSchema Double where
180instance ToParamSchema Double where
187 toParamSchema _ = mempty
181 toParamSchema _ = mempty
188− & type_ ?~ OpenApiNumber
182+ & type_ ?~ SwaggerNumber
189 & format ?~ "double"
183 & format ?~ "double"
190
184
191instance ToParamSchema Float where
185instance ToParamSchema Float where
192 toParamSchema _ = mempty
186 toParamSchema _ = mempty
193− & type_ ?~ OpenApiNumber
187+ & type_ ?~ SwaggerNumber
194 & format ?~ "float"
188 & format ?~ "float"
195
189
196timeParamSchema :: String -> Schema
190timeParamSchema :: String -> Schema
197timeParamSchema fmt = mempty
191timeParamSchema fmt = mempty
198− & type_ ?~ OpenApiString
192+ & type_ ?~ SwaggerString
199 & format ?~ T.pack fmt
193 & format ?~ T.pack fmt
200
194
201-- | Format @"date"@ corresponds to @yyyy-mm-dd@ format.
195-- | Format @"date"@ corresponds to @yyyy-mm-dd@ format.
@@ -216,9 +210,9 @@ instance ToParamSchema LocalTime where
216
210
217-- |
211-- |
218-- >>> toParamSchema (Proxy :: Proxy ZonedTime) ^. format
212-- >>> toParamSchema (Proxy :: Proxy ZonedTime) ^. format
219−-- Just "date-time"
213+-- Just "yyyy-mm-ddThh:MM:ss+hhMM"
220instance ToParamSchema ZonedTime where
214instance ToParamSchema ZonedTime where
221− toParamSchema _ = timeParamSchema "date-time"
215+ toParamSchema _ = timeParamSchema "yyyy-mm-ddThh:MM:ss+hhMM"
222
216
223-- |
217-- |
224-- >>> toParamSchema (Proxy :: Proxy UTCTime) ^. format
218-- >>> toParamSchema (Proxy :: Proxy UTCTime) ^. format
@@ -237,12 +231,12 @@ instance ToParamSchema TL.Text where
237
231
238instance ToParamSchema Version where
232instance ToParamSchema Version where
239 toParamSchema _ = mempty
233 toParamSchema _ = mempty
240− & type_ ?~ OpenApiString
234+ & type_ ?~ SwaggerString
241 & pattern ?~ "^\\d+(\\.\\d+)*$"
235 & pattern ?~ "^\\d+(\\.\\d+)*$"
242
236
243instance ToParamSchema SetCookie where
237instance ToParamSchema SetCookie where
244 toParamSchema _ = mempty
238 toParamSchema _ = mempty
245− & type_ ?~ OpenApiString
239+ & type_ ?~ SwaggerString
246
240
247type family ToParamSchemaByteStringError bs where
241type family ToParamSchemaByteStringError bs where
248 ToParamSchemaByteStringError bs = TypeError
242 ToParamSchemaByteStringError bs = TypeError
@@ -265,8 +259,8 @@ instance ToParamSchema a => ToParamSchema (Identity a) where toParamSchema _ = t
265
259
266instance ToParamSchema a => ToParamSchema [a] where
260instance ToParamSchema a => ToParamSchema [a] where
267 toParamSchema _ = mempty
261 toParamSchema _ = mempty
268− & type_ ?~ OpenApiArray
262+ & type_ ?~ SwaggerArray
269− & items ?~ OpenApiItemsObject (Inline $ toParamSchema (Proxy :: Proxy a))
263+ & items ?~ SwaggerItemsObject (Inline $ toParamSchema (Proxy :: Proxy a))
270
264
271instance ToParamSchema a => ToParamSchema (V.Vector a) where toParamSchema _ = toParamSchema (Proxy :: Proxy [a])
265instance ToParamSchema a => ToParamSchema (V.Vector a) where toParamSchema _ = toParamSchema (Proxy :: Proxy [a])
272instance ToParamSchema a => ToParamSchema (VP.Vector a) where toParamSchema _ = toParamSchema (Proxy :: Proxy [a])
266instance ToParamSchema a => ToParamSchema (VP.Vector a) where toParamSchema _ = toParamSchema (Proxy :: Proxy [a])
@@ -281,35 +275,24 @@ instance ToParamSchema a => ToParamSchema (HashSet a) where
281 toParamSchema _ = toParamSchema (Proxy :: Proxy (Set a))
275 toParamSchema _ = toParamSchema (Proxy :: Proxy (Set a))
282
276
283-- |
277-- |
284−-- >>> BSL.putStrLn $ encodePretty $ toParamSchema (Proxy :: Proxy ())
278+-- >>> encode $ toParamSchema (Proxy :: Proxy ())
285−-- {
286−-- "enum": [
279+-- "{\"type\":\"string\",\"enum\":[\"_\"]}"
287−-- "_"
288−-- ],
289−-- "type": "string"
290−-- }
291instance ToParamSchema () where
280instance ToParamSchema () where
292 toParamSchema _ = mempty
281 toParamSchema _ = mempty
293− & type_ ?~ OpenApiString
282+ & type_ ?~ SwaggerString
294 & enum_ ?~ ["_"]
283 & enum_ ?~ ["_"]
295
284
296instance ToParamSchema UUID where
285instance ToParamSchema UUID where
297 toParamSchema _ = mempty
286 toParamSchema _ = mempty
298− & type_ ?~ OpenApiString
287+ & type_ ?~ SwaggerString
299 & format ?~ "uuid"
288 & format ?~ "uuid"
300
289
301-- | A configurable generic @'Schema'@ creator.
290-- | A configurable generic @'Schema'@ creator.
302--
291--
303-- >>> :set -XDeriveGeneric
292-- >>> :set -XDeriveGeneric
304-- >>> data Color = Red | Blue deriving Generic
293-- >>> data Color = Red | Blue deriving Generic
305−-- >>> BSL.putStrLn $ encodePretty $ genericToParamSchema defaultSchemaOptions (Proxy :: Proxy Color)
294+-- >>> encode $ genericToParamSchema defaultSchemaOptions (Proxy :: Proxy Color)
306−-- {
295+-- "{\"type\":\"string\",\"enum\":[\"Red\",\"Blue\"]}"
307−-- "enum": [
308−-- "Red",
309−-- "Blue"
310−-- ],
311−-- "type": "string"
312−-- }
313genericToParamSchema :: forall a t. (Generic a, GToParamSchema (Rep a)) => SchemaOptions -> Proxy a -> Schema
296genericToParamSchema :: forall a t. (Generic a, GToParamSchema (Rep a)) => SchemaOptions -> Proxy a -> Schema
314genericToParamSchema opts _ = gtoParamSchema opts (Proxy :: Proxy (Rep a)) mempty
297genericToParamSchema opts _ = gtoParamSchema opts (Proxy :: Proxy (Rep a)) mempty
315
298
@@ -339,7 +322,7 @@ instance (GEnumParamSchema f, GEnumParamSchema g) => GEnumParamSchema (f :+: g)
339
322
340instance Constructor c => GEnumParamSchema (C1 c U1) where
323instance Constructor c => GEnumParamSchema (C1 c U1) where
341 genumParamSchema opts _ s = s
324 genumParamSchema opts _ s = s
342− & type_ ?~ OpenApiString
325+ & type_ ?~ SwaggerString
343 & enum_ %~ addEnumValue tag
326 & enum_ %~ addEnumValue tag
344 where
327 where
345 tag = toJSON (constructorTagModifier opts (conName (Proxy3 :: Proxy3 c f p)))
328 tag = toJSON (constructorTagModifier opts (conName (Proxy3 :: Proxy3 c f p)))
@@ -351,4 +334,3 @@ data Proxy3 a b c = Proxy3
351
334
352-- $setup
335-- $setup
353-- >>> import Data.Aeson (encode)
336-- >>> import Data.Aeson (encode)
354−-- >>> import Data.OpenApi.Internal.Utils
src/Data/OpenApi/Internal/Schema.hs → src/Data/Swagger/Internal/Schema.hsrenamed+118−380
@@ -1,17 +1,15 @@
1−{-# LANGUAGE CPP #-}
2{-# LANGUAGE ConstraintKinds #-}
1{-# LANGUAGE ConstraintKinds #-}
3−{-# LANGUAGE DataKinds #-}
4{-# LANGUAGE DefaultSignatures #-}
2{-# LANGUAGE DefaultSignatures #-}
5{-# LANGUAGE FlexibleContexts #-}
3{-# LANGUAGE FlexibleContexts #-}
6{-# LANGUAGE FlexibleInstances #-}
4{-# LANGUAGE FlexibleInstances #-}
7{-# LANGUAGE KindSignatures #-}
5{-# LANGUAGE KindSignatures #-}
6+{-# LANGUAGE DataKinds #-}
8{-# LANGUAGE OverloadedLists #-}
7{-# LANGUAGE OverloadedLists #-}
9{-# LANGUAGE OverloadedStrings #-}
8{-# LANGUAGE OverloadedStrings #-}
10{-# LANGUAGE PackageImports #-}
9{-# LANGUAGE PackageImports #-}
11{-# LANGUAGE PolyKinds #-}
10{-# LANGUAGE PolyKinds #-}
12{-# LANGUAGE ScopedTypeVariables #-}
11{-# LANGUAGE ScopedTypeVariables #-}
13{-# LANGUAGE TupleSections #-}
12{-# LANGUAGE TupleSections #-}
14−{-# LANGUAGE TypeApplications #-}
15{-# LANGUAGE TypeFamilies #-}
13{-# LANGUAGE TypeFamilies #-}
16{-# LANGUAGE TypeOperators #-}
14{-# LANGUAGE TypeOperators #-}
17{-# LANGUAGE TypeSynonymInstances #-}
15{-# LANGUAGE TypeSynonymInstances #-}
@@ -19,7 +17,7 @@
19{-# OPTIONS_GHC -Wno-redundant-constraints #-}
17{-# OPTIONS_GHC -Wno-redundant-constraints #-}
20-- For TypeErrors
18-- For TypeErrors
21{-# OPTIONS_GHC -Wno-unticked-promoted-constructors #-}
19{-# OPTIONS_GHC -Wno-unticked-promoted-constructors #-}
22−module Data.OpenApi.Internal.Schema where
20+module Data.Swagger.Internal.Schema where
23
21
24import Prelude ()
22import Prelude ()
25import Prelude.Compat
23import Prelude.Compat
@@ -42,7 +40,6 @@ import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
42import Data.Int
40import Data.Int
43import Data.IntSet (IntSet)
41import Data.IntSet (IntSet)
44import Data.IntMap (IntMap)
42import Data.IntMap (IntMap)
45−import Data.List (sort)
46import Data.List.NonEmpty.Compat (NonEmpty)
43import Data.List.NonEmpty.Compat (NonEmpty)
47import Data.Map (Map)
44import Data.Map (Map)
48import Data.Maybe (fromMaybe)
45import Data.Maybe (fromMaybe)
@@ -62,16 +59,14 @@ import Numeric.Natural.Compat (Natural)
62import Data.Word
59import Data.Word
63import GHC.Generics
60import GHC.Generics
64import qualified Data.UUID.Types as UUID
61import qualified Data.UUID.Types as UUID
65−import Type.Reflection (Typeable, typeRep)
66
62
67−import Data.OpenApi.Aeson.Compat (keyToText, objectKeys, toInsOrdHashMap)
68−import Data.OpenApi.Declare
63+import Data.Swagger.Declare
69−import Data.OpenApi.Internal
64+import Data.Swagger.Internal
70−import Data.OpenApi.Internal.ParamSchema (ToParamSchema (..))
65+import Data.Swagger.Internal.ParamSchema (ToParamSchema(..))
71−import Data.OpenApi.Internal.TypeShape
72−import Data.OpenApi.Lens hiding (name, schema)
66+import Data.Swagger.Lens hiding (name, schema)
73−import qualified Data.OpenApi.Lens as Swagger
67+import qualified Data.Swagger.Lens as Swagger
74−import Data.OpenApi.SchemaOptions
68+import Data.Swagger.SchemaOptions
69+import Data.Swagger.Internal.TypeShape
75
70
76import qualified Data.ByteString as BS
71import qualified Data.ByteString as BS
77import qualified Data.ByteString.Lazy.Char8 as BSL
72import qualified Data.ByteString.Lazy.Char8 as BSL
@@ -102,7 +97,7 @@ rename name (NamedSchema _ schema) = NamedSchema name schema
102--
97--
103-- import Control.Lens
98-- import Control.Lens
104-- import Data.Proxy
99-- import Data.Proxy
105−-- import Data.OpenApi
100+-- import Data.Swagger
106--
101--
107-- data Coord = Coord { x :: Double, y :: Double }
102-- data Coord = Coord { x :: Double, y :: Double }
108--
103--
@@ -110,7 +105,7 @@ rename name (NamedSchema _ schema) = NamedSchema name schema
110-- declareNamedSchema _ = do
105-- declareNamedSchema _ = do
111-- doubleSchema <- declareSchemaRef (Proxy :: Proxy Double)
106-- doubleSchema <- declareSchemaRef (Proxy :: Proxy Double)
112-- return $ NamedSchema (Just \"Coord\") $ mempty
107-- return $ NamedSchema (Just \"Coord\") $ mempty
113−-- & type_ ?~ OpenApiObject
108+-- & type_ ?~ SwaggerObject
114-- & properties .~
109-- & properties .~
115-- [ (\"x\", doubleSchema)
110-- [ (\"x\", doubleSchema)
116-- , (\"y\", doubleSchema)
111-- , (\"y\", doubleSchema)
@@ -136,7 +131,7 @@ rename name (NamedSchema _ schema) = NamedSchema name schema
136--
131--
137-- instance ToSchema Coord
132-- instance ToSchema Coord
138-- @
133-- @
139−class Typeable a => ToSchema a where
134+class ToSchema a where
140 -- | Convert a type into an optionally named schema
135 -- | Convert a type into an optionally named schema
141 -- together with all used definitions.
136 -- together with all used definitions.
142 -- Note that the schema itself is included in definitions
137 -- Note that the schema itself is included in definitions
@@ -158,19 +153,13 @@ declareSchema = fmap _namedSchemaSchema . declareNamedSchema
158--
153--
159-- >>> toNamedSchema (Proxy :: Proxy String) ^. name
154-- >>> toNamedSchema (Proxy :: Proxy String) ^. name
160-- Nothing
155-- Nothing
161−-- >>> BSL.putStrLn $ encodePretty (toNamedSchema (Proxy :: Proxy String) ^. schema)
156+-- >>> BSL.putStrLn $ encode (toNamedSchema (Proxy :: Proxy String) ^. schema)
162−-- {
163−-- "type": "string"
157+-- {"type":"string"}
164−-- }
165--
158--
166-- >>> toNamedSchema (Proxy :: Proxy Day) ^. name
159-- >>> toNamedSchema (Proxy :: Proxy Day) ^. name
167-- Just "Day"
160-- Just "Day"
168−-- >>> BSL.putStrLn $ encodePretty (toNamedSchema (Proxy :: Proxy Day) ^. schema)
161+-- >>> BSL.putStrLn $ encode (toNamedSchema (Proxy :: Proxy Day) ^. schema)
169−-- {
170−-- "example": "2016-07-22",
162+-- {"example":"2016-07-22","format":"date","type":"string"}
171−-- "format": "date",
172−-- "type": "string"
173−-- }
174toNamedSchema :: ToSchema a => Proxy a -> NamedSchema
163toNamedSchema :: ToSchema a => Proxy a -> NamedSchema
175toNamedSchema = undeclare . declareNamedSchema
164toNamedSchema = undeclare . declareNamedSchema
176
165
@@ -186,35 +175,22 @@ schemaName = _namedSchemaName . toNamedSchema
186
175
187-- | Convert a type into a schema.
176-- | Convert a type into a schema.
188--
177--
189−-- >>> BSL.putStrLn $ encodePretty $ toSchema (Proxy :: Proxy Int8)
178+-- >>> BSL.putStrLn $ encode $ toSchema (Proxy :: Proxy Int8)
190−-- {
191−-- "maximum": 127,
192−-- "minimum": -128,
193−-- "type": "integer"
179+-- {"maximum":127,"minimum":-128,"type":"integer"}
194−-- }
195--
180--
196−-- >>> BSL.putStrLn $ encodePretty $ toSchema (Proxy :: Proxy [Day])
181+-- >>> BSL.putStrLn $ encode $ toSchema (Proxy :: Proxy [Day])
197−-- {
198−-- "items": {
199−-- "$ref": "#/components/schemas/Day"
182+-- {"items":{"$ref":"#/components/schemas/Day"},"type":"array"}
200−-- },
201−-- "type": "array"
202−-- }
203toSchema :: ToSchema a => Proxy a -> Schema
183toSchema :: ToSchema a => Proxy a -> Schema
204toSchema = _namedSchemaSchema . toNamedSchema
184toSchema = _namedSchemaSchema . toNamedSchema
205
185
206-- | Convert a type into a referenced schema if possible.
186-- | Convert a type into a referenced schema if possible.
207-- Only named schemas can be referenced, nameless schemas are inlined.
187-- Only named schemas can be referenced, nameless schemas are inlined.
208--
188--
209−-- >>> BSL.putStrLn $ encodePretty $ toSchemaRef (Proxy :: Proxy Integer)
189+-- >>> BSL.putStrLn $ encode $ toSchemaRef (Proxy :: Proxy Integer)
210−-- {
211−-- "type": "integer"
190+-- {"type":"integer"}
212−-- }
213--
191--
214−-- >>> BSL.putStrLn $ encodePretty $ toSchemaRef (Proxy :: Proxy Day)
192+-- >>> BSL.putStrLn $ encode $ toSchemaRef (Proxy :: Proxy Day)
215−-- {
216−-- "$ref": "#/components/schemas/Day"
193+-- {"$ref":"#/components/schemas/Day"}
217−-- }
218toSchemaRef :: ToSchema a => Proxy a -> Referenced Schema
194toSchemaRef :: ToSchema a => Proxy a -> Referenced Schema
219toSchemaRef = undeclare . declareSchemaRef
195toSchemaRef = undeclare . declareSchemaRef
220
196
@@ -282,15 +258,8 @@ inlineAllSchemas = inlineSchemasWhen (const True)
282
258
283-- | Convert a type into a schema without references.
259-- | Convert a type into a schema without references.
284--
260--
285−-- >>> BSL.putStrLn $ encodePretty $ toInlinedSchema (Proxy :: Proxy [Day])
261+-- >>> BSL.putStrLn $ encode $ toInlinedSchema (Proxy :: Proxy [Day])
286−-- {
287−-- "items": {
288−-- "example": "2016-07-22",
262+-- {"items":{"example":"2016-07-22","format":"date","type":"string"},"type":"array"}
289−-- "format": "date",
290−-- "type": "string"
291−-- },
292−-- "type": "array"
293−-- }
294--
263--
295-- __WARNING:__ @'toInlinedSchema'@ will produce infinite schema
264-- __WARNING:__ @'toInlinedSchema'@ will produce infinite schema
296-- when inlining recursive schemas.
265-- when inlining recursive schemas.
@@ -323,64 +292,19 @@ inlineNonRecursiveSchemas defs = inlineSchemasWhen nonRecursive defs
323-- | Make an unrestrictive sketch of a @'Schema'@ based on a @'ToJSON'@ instance.
292-- | Make an unrestrictive sketch of a @'Schema'@ based on a @'ToJSON'@ instance.
324-- Produced schema can be used for further refinement.
293-- Produced schema can be used for further refinement.
325--
294--
326−-- >>> BSL.putStrLn $ encodePretty $ sketchSchema "hello"
295+-- >>> BSL.putStrLn $ encode $ sketchSchema "hello"
327−-- {
328−-- "example": "hello",
296+-- {"example":"hello","type":"string"}
329−-- "type": "string"
330−-- }
331--
297--
332−-- >>> BSL.putStrLn $ encodePretty $ sketchSchema (1, 2, 3)
298+-- >>> BSL.putStrLn $ encode $ sketchSchema (1, 2, 3)
333−-- {
334−-- "example": [
335−-- 1,
336−-- 2,
337−-- 3
338−-- ],
339−-- "items": {
340−-- "type": "number"
299+-- {"example":[1,2,3],"items":{"type":"number"},"type":"array"}
341−-- },
342−-- "type": "array"
343−-- }
344--
300--
345−-- >>> BSL.putStrLn $ encodePretty $ sketchSchema ("Jack", 25)
301+-- >>> BSL.putStrLn $ encode $ sketchSchema ("Jack", 25)
346−-- {
302+-- {"example":["Jack",25],"items":[{"type":"string"},{"type":"number"}],"type":"array"}
347−-- "example": [
348−-- "Jack",
349−-- 25
350−-- ],
351−-- "items": [
352−-- {
353−-- "type": "string"
354−-- },
355−-- {
356−-- "type": "number"
357−-- }
358−-- ],
359−-- "type": "array"
360−-- }
361--
303--
362-- >>> data Person = Person { name :: String, age :: Int } deriving (Generic)
304-- >>> data Person = Person { name :: String, age :: Int } deriving (Generic)
363-- >>> instance ToJSON Person
305-- >>> instance ToJSON Person
364−-- >>> BSL.putStrLn $ encodePretty $ sketchSchema (Person "Jack" 25)
306+-- >>> BSL.putStrLn $ encode $ sketchSchema (Person "Jack" 25)
365−-- {
307+-- {"example":{"age":25,"name":"Jack"},"required":["age","name"],"type":"object","properties":{"age":{"type":"number"},"name":{"type":"string"}}}
366−-- "example": {
367−-- "age": 25,
368−-- "name": "Jack"
369−-- },
370−-- "properties": {
371−-- "age": {
372−-- "type": "number"
373−-- },
374−-- "name": {
375−-- "type": "string"
376−-- }
377−-- },
378−-- "required": [
379−-- "age",
380−-- "name"
381−-- ],
382−-- "type": "object"
383−-- }
384sketchSchema :: ToJSON a => a -> Schema
308sketchSchema :: ToJSON a => a -> Schema
385sketchSchema = sketch . toJSON
309sketchSchema = sketch . toJSON
386 where
310 where
@@ -388,15 +312,15 @@ sketchSchema = sketch . toJSON
388 sketch js@(Bool _) = go js
312 sketch js@(Bool _) = go js
389 sketch js = go js & example ?~ js
313 sketch js = go js & example ?~ js
390
314
391− go Null = mempty & type_ ?~ OpenApiNull
315+ go Null = mempty & type_ ?~ SwaggerNull
392− go (Bool _) = mempty & type_ ?~ OpenApiBoolean
316+ go (Bool _) = mempty & type_ ?~ SwaggerBoolean
393− go (String _) = mempty & type_ ?~ OpenApiString
317+ go (String _) = mempty & type_ ?~ SwaggerString
394− go (Number _) = mempty & type_ ?~ OpenApiNumber
318+ go (Number _) = mempty & type_ ?~ SwaggerNumber
395 go (Array xs) = mempty
319 go (Array xs) = mempty
396− & type_ ?~ OpenApiArray
320+ & type_ ?~ SwaggerArray
397 & items ?~ case ischema of
321 & items ?~ case ischema of
398− Just s -> OpenApiItemsObject (Inline s)
322+ Just s -> SwaggerItemsObject (Inline s)
399− _ -> OpenApiItemsArray (map Inline ys)
323+ _ -> SwaggerItemsArray (map Inline ys)
400 where
324 where
401 ys = map go (V.toList xs)
325 ys = map go (V.toList xs)
402 allSame = and ((zipWith (==)) ys (tail ys))
326 allSame = and ((zipWith (==)) ys (tail ys))
@@ -405,178 +329,64 @@ sketchSchema = sketch . toJSON
405 (z:_) | allSame -> Just z
329 (z:_) | allSame -> Just z
406 _ -> Nothing
330 _ -> Nothing
407 go (Object o) = mempty
331 go (Object o) = mempty
408− & type_ ?~ OpenApiObject
332+ & type_ ?~ SwaggerObject
409− & required .~ sort (objectKeys o)
333+ & required .~ HashMap.keys o
410− & properties .~ fmap (Inline . go) (toInsOrdHashMap o)
334+ & properties .~ fmap (Inline . go) (InsOrdHashMap.fromHashMap o)
411
335
412-- | Make a restrictive sketch of a @'Schema'@ based on a @'ToJSON'@ instance.
336-- | Make a restrictive sketch of a @'Schema'@ based on a @'ToJSON'@ instance.
413-- Produced schema uses as much constraints as possible.
337-- Produced schema uses as much constraints as possible.
414--
338--
415−-- >>> BSL.putStrLn $ encodePretty $ sketchStrictSchema "hello"
339+-- >>> BSL.putStrLn $ encode $ sketchStrictSchema "hello"
416−-- {
340+-- {"maxLength":5,"pattern":"hello","minLength":5,"type":"string","enum":["hello"]}
417−-- "enum": [
418−-- "hello"
419−-- ],
420−-- "maxLength": 5,
421−-- "minLength": 5,
422−-- "pattern": "hello",
423−-- "type": "string"
424−-- }
425--
341--
426−-- >>> BSL.putStrLn $ encodePretty $ sketchStrictSchema (1, 2, 3)
342+-- >>> BSL.putStrLn $ encode $ sketchStrictSchema (1, 2, 3)
427−-- {
343+-- {"minItems":3,"uniqueItems":true,"items":[{"maximum":1,"minimum":1,"multipleOf":1,"type":"number","enum":[1]},{"maximum":2,"minimum":2,"multipleOf":2,"type":"number","enum":[2]},{"maximum":3,"minimum":3,"multipleOf":3,"type":"number","enum":[3]}],"maxItems":3,"type":"array","enum":[[1,2,3]]}
428−-- "enum": [
429−-- [
430−-- 1,
431−-- 2,
432−-- 3
433−-- ]
434−-- ],
435−-- "items": [
436−-- {
437−-- "enum": [
438−-- 1
439−-- ],
440−-- "maximum": 1,
441−-- "minimum": 1,
442−-- "multipleOf": 1,
443−-- "type": "number"
444−-- },
445−-- {
446−-- "enum": [
447−-- 2
448−-- ],
449−-- "maximum": 2,
450−-- "minimum": 2,
451−-- "multipleOf": 2,
452−-- "type": "number"
453−-- },
454−-- {
455−-- "enum": [
456−-- 3
457−-- ],
458−-- "maximum": 3,
459−-- "minimum": 3,
460−-- "multipleOf": 3,
461−-- "type": "number"
462−-- }
463−-- ],
464−-- "maxItems": 3,
465−-- "minItems": 3,
466−-- "type": "array",
467−-- "uniqueItems": true
468−-- }
469--
344--
470−-- >>> BSL.putStrLn $ encodePretty $ sketchStrictSchema ("Jack", 25)
345+-- >>> BSL.putStrLn $ encode $ sketchStrictSchema ("Jack", 25)
471−-- {
346+-- {"minItems":2,"uniqueItems":true,"items":[{"maxLength":4,"pattern":"Jack","minLength":4,"type":"string","enum":["Jack"]},{"maximum":25,"minimum":25,"multipleOf":25,"type":"number","enum":[25]}],"maxItems":2,"type":"array","enum":[["Jack",25]]}
472−-- "enum": [
473−-- [
474−-- "Jack",
475−-- 25
476−-- ]
477−-- ],
478−-- "items": [
479−-- {
480−-- "enum": [
481−-- "Jack"
482−-- ],
483−-- "maxLength": 4,
484−-- "minLength": 4,
485−-- "pattern": "Jack",
486−-- "type": "string"
487−-- },
488−-- {
489−-- "enum": [
490−-- 25
491−-- ],
492−-- "maximum": 25,
493−-- "minimum": 25,
494−-- "multipleOf": 25,
495−-- "type": "number"
496−-- }
497−-- ],
498−-- "maxItems": 2,
499−-- "minItems": 2,
500−-- "type": "array",
501−-- "uniqueItems": true
502−-- }
503--
347--
504-- >>> data Person = Person { name :: String, age :: Int } deriving (Generic)
348-- >>> data Person = Person { name :: String, age :: Int } deriving (Generic)
505-- >>> instance ToJSON Person
349-- >>> instance ToJSON Person
506−-- >>> BSL.putStrLn $ encodePretty $ sketchStrictSchema (Person "Jack" 25)
350+-- >>> BSL.putStrLn $ encode $ sketchStrictSchema (Person "Jack" 25)
507−-- {
351+-- {"minProperties":2,"required":["age","name"],"maxProperties":2,"type":"object","enum":[{"age":25,"name":"Jack"}],"properties":{"age":{"maximum":25,"minimum":25,"multipleOf":25,"type":"number","enum":[25]},"name":{"maxLength":4,"pattern":"Jack","minLength":4,"type":"string","enum":["Jack"]}}}
508−-- "enum": [
509−-- {
510−-- "age": 25,
511−-- "name": "Jack"
512−-- }
513−-- ],
514−-- "maxProperties": 2,
515−-- "minProperties": 2,
516−-- "properties": {
517−-- "age": {
518−-- "enum": [
519−-- 25
520−-- ],
521−-- "maximum": 25,
522−-- "minimum": 25,
523−-- "multipleOf": 25,
524−-- "type": "number"
525−-- },
526−-- "name": {
527−-- "enum": [
528−-- "Jack"
529−-- ],
530−-- "maxLength": 4,
531−-- "minLength": 4,
532−-- "pattern": "Jack",
533−-- "type": "string"
534−-- }
535−-- },
536−-- "required": [
537−-- "age",
538−-- "name"
539−-- ],
540−-- "type": "object"
541−-- }
542sketchStrictSchema :: ToJSON a => a -> Schema
352sketchStrictSchema :: ToJSON a => a -> Schema
543sketchStrictSchema = go . toJSON
353sketchStrictSchema = go . toJSON
544 where
354 where
545− go Null = mempty & type_ ?~ OpenApiNull
355+ go Null = mempty & type_ ?~ SwaggerNull
546 go js@(Bool _) = mempty
356 go js@(Bool _) = mempty
547− & type_ ?~ OpenApiBoolean
357+ & type_ ?~ SwaggerBoolean
548 & enum_ ?~ [js]
358 & enum_ ?~ [js]
549 go js@(String s) = mempty
359 go js@(String s) = mempty
550− & type_ ?~ OpenApiString
360+ & type_ ?~ SwaggerString
551 & maxLength ?~ fromIntegral (T.length s)
361 & maxLength ?~ fromIntegral (T.length s)
552 & minLength ?~ fromIntegral (T.length s)
362 & minLength ?~ fromIntegral (T.length s)
553 & pattern ?~ s
363 & pattern ?~ s
554 & enum_ ?~ [js]
364 & enum_ ?~ [js]
555 go js@(Number n) = mempty
365 go js@(Number n) = mempty
556− & type_ ?~ OpenApiNumber
366+ & type_ ?~ SwaggerNumber
557 & maximum_ ?~ n
367 & maximum_ ?~ n
558 & minimum_ ?~ n
368 & minimum_ ?~ n
559 & multipleOf ?~ n
369 & multipleOf ?~ n
560 & enum_ ?~ [js]
370 & enum_ ?~ [js]
561 go js@(Array xs) = mempty
371 go js@(Array xs) = mempty
562− & type_ ?~ OpenApiArray
372+ & type_ ?~ SwaggerArray
563 & maxItems ?~ fromIntegral sz
373 & maxItems ?~ fromIntegral sz
564 & minItems ?~ fromIntegral sz
374 & minItems ?~ fromIntegral sz
565− & items ?~ OpenApiItemsArray (map (Inline . go) (V.toList xs))
375+ & items ?~ SwaggerItemsArray (map (Inline . go) (V.toList xs))
566 & uniqueItems ?~ allUnique
376 & uniqueItems ?~ allUnique
567 & enum_ ?~ [js]
377 & enum_ ?~ [js]
568 where
378 where
569 sz = length xs
379 sz = length xs
570 allUnique = sz == HashSet.size (HashSet.fromList (V.toList xs))
380 allUnique = sz == HashSet.size (HashSet.fromList (V.toList xs))
571 go js@(Object o) = mempty
381 go js@(Object o) = mempty
572− & type_ ?~ OpenApiObject
382+ & type_ ?~ SwaggerObject
573− & required .~ sort names
383+ & required .~ names
574− & properties .~ fmap (Inline . go) (toInsOrdHashMap o)
384+ & properties .~ fmap (Inline . go) (InsOrdHashMap.fromHashMap o)
575 & maxProperties ?~ fromIntegral (length names)
385 & maxProperties ?~ fromIntegral (length names)
576 & minProperties ?~ fromIntegral (length names)
386 & minProperties ?~ fromIntegral (length names)
577 & enum_ ?~ [js]
387 & enum_ ?~ [js]
578 where
388 where
579− names = objectKeys o
389+ names = HashMap.keys o
580
390
581class GToSchema (f :: * -> *) where
391class GToSchema (f :: * -> *) where
582 gdeclareNamedSchema :: SchemaOptions -> Proxy f -> Schema -> Declare (Definitions Schema) NamedSchema
392 gdeclareNamedSchema :: SchemaOptions -> Proxy f -> Schema -> Declare (Definitions Schema) NamedSchema
@@ -585,8 +395,8 @@ instance {-# OVERLAPPABLE #-} ToSchema a => ToSchema [a] where
585 declareNamedSchema _ = do
395 declareNamedSchema _ = do
586 ref <- declareSchemaRef (Proxy :: Proxy a)
396 ref <- declareSchemaRef (Proxy :: Proxy a)
587 return $ unnamed $ mempty
397 return $ unnamed $ mempty
588− & type_ ?~ OpenApiArray
398+ & type_ ?~ SwaggerArray
589− & items ?~ OpenApiItemsObject ref
399+ & items ?~ SwaggerItemsObject ref
590
400
591instance {-# OVERLAPPING #-} ToSchema String where declareNamedSchema = plain . paramSchemaToSchema
401instance {-# OVERLAPPING #-} ToSchema String where declareNamedSchema = plain . paramSchemaToSchema
592instance ToSchema Bool where declareNamedSchema = plain . paramSchemaToSchema
402instance ToSchema Bool where declareNamedSchema = plain . paramSchemaToSchema
@@ -611,7 +421,7 @@ instance ToSchema Scientific where declareNamedSchema = plain . paramSchemaToSc
611instance ToSchema Double where declareNamedSchema = plain . paramSchemaToSchema
421instance ToSchema Double where declareNamedSchema = plain . paramSchemaToSchema
612instance ToSchema Float where declareNamedSchema = plain . paramSchemaToSchema
422instance ToSchema Float where declareNamedSchema = plain . paramSchemaToSchema
613
423
614−instance (Typeable (Fixed a), HasResolution a) => ToSchema (Fixed a) where declareNamedSchema = plain . paramSchemaToSchema
424+instance HasResolution a => ToSchema (Fixed a) where declareNamedSchema = plain . paramSchemaToSchema
615
425
616instance ToSchema a => ToSchema (Maybe a) where
426instance ToSchema a => ToSchema (Maybe a) where
617 declareNamedSchema _ = declareNamedSchema (Proxy :: Proxy a)
427 declareNamedSchema _ = declareNamedSchema (Proxy :: Proxy a)
@@ -628,22 +438,16 @@ instance ToSchema UUID.UUID where
628 declareNamedSchema p = pure $ named "UUID" $ paramSchemaToSchema p
438 declareNamedSchema p = pure $ named "UUID" $ paramSchemaToSchema p
629 & example ?~ toJSON (UUID.toText UUID.nil)
439 & example ?~ toJSON (UUID.toText UUID.nil)
630
440
631−instance (ToSchema a, ToSchema b) => ToSchema (a, b) where
441+instance (ToSchema a, ToSchema b) => ToSchema (a, b)
632− declareNamedSchema = fmap unname . genericDeclareNamedSchema defaultSchemaOptions
633−instance (ToSchema a, ToSchema b, ToSchema c) => ToSchema (a, b, c) where
442+instance (ToSchema a, ToSchema b, ToSchema c) => ToSchema (a, b, c)
634− declareNamedSchema = fmap unname . genericDeclareNamedSchema defaultSchemaOptions
635−instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d) => ToSchema (a, b, c, d) where
443+instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d) => ToSchema (a, b, c, d)
636− declareNamedSchema = fmap unname . genericDeclareNamedSchema defaultSchemaOptions
637−instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d, ToSchema e) => ToSchema (a, b, c, d, e) where
444+instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d, ToSchema e) => ToSchema (a, b, c, d, e)
638− declareNamedSchema = fmap unname . genericDeclareNamedSchema defaultSchemaOptions
639−instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d, ToSchema e, ToSchema f) => ToSchema (a, b, c, d, e, f) where
445+instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d, ToSchema e, ToSchema f) => ToSchema (a, b, c, d, e, f)
640− declareNamedSchema = fmap unname . genericDeclareNamedSchema defaultSchemaOptions
641−instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d, ToSchema e, ToSchema f, ToSchema g) => ToSchema (a, b, c, d, e, f, g) where
446+instance (ToSchema a, ToSchema b, ToSchema c, ToSchema d, ToSchema e, ToSchema f, ToSchema g) => ToSchema (a, b, c, d, e, f, g)
642− declareNamedSchema = fmap unname . genericDeclareNamedSchema defaultSchemaOptions
643
447
644timeSchema :: T.Text -> Schema
448timeSchema :: T.Text -> Schema
645timeSchema fmt = mempty
449timeSchema fmt = mempty
646− & type_ ?~ OpenApiString
450+ & type_ ?~ SwaggerString
647 & format ?~ fmt
451 & format ?~ fmt
648
452
649-- | Format @"date"@ corresponds to @yyyy-mm-dd@ format.
453-- | Format @"date"@ corresponds to @yyyy-mm-dd@ format.
@@ -658,7 +462,7 @@ instance ToSchema LocalTime where
658 declareNamedSchema _ = pure $ named "LocalTime" $ timeSchema "yyyy-mm-ddThh:MM:ss"
462 declareNamedSchema _ = pure $ named "LocalTime" $ timeSchema "yyyy-mm-ddThh:MM:ss"
659 & example ?~ toJSON (LocalTime (fromGregorian 2016 7 22) (TimeOfDay 7 40 0))
463 & example ?~ toJSON (LocalTime (fromGregorian 2016 7 22) (TimeOfDay 7 40 0))
660
464
661−-- | Format @"date-time"@ corresponds to @yyyy-mm-ddThh:MM:ss(Z|+hh:MM)@ format.
465+-- | Format @"date"@ corresponds to @yyyy-mm-ddThh:MM:ss(Z|+hh:MM)@ format.
662instance ToSchema ZonedTime where
466instance ToSchema ZonedTime where
663 declareNamedSchema _ = pure $ named "ZonedTime" $ timeSchema "date-time"
467 declareNamedSchema _ = pure $ named "ZonedTime" $ timeSchema "date-time"
664 & example ?~ toJSON (ZonedTime (LocalTime (fromGregorian 2016 7 22) (TimeOfDay 7 40 0)) (hoursToTimeZone 3))
468 & example ?~ toJSON (ZonedTime (LocalTime (fromGregorian 2016 7 22) (TimeOfDay 7 40 0)) (hoursToTimeZone 3))
@@ -690,7 +494,7 @@ instance ToSchemaByteStringError BSL.ByteString => ToSchema BSL.ByteString where
690instance ToSchema IntSet where declareNamedSchema _ = declareNamedSchema (Proxy :: Proxy (Set Int))
494instance ToSchema IntSet where declareNamedSchema _ = declareNamedSchema (Proxy :: Proxy (Set Int))
691
495
692-- | NOTE: This schema does not account for the uniqueness of keys.
496-- | NOTE: This schema does not account for the uniqueness of keys.
693−instance (ToSchema a) => ToSchema (IntMap a) where
497+instance ToSchema a => ToSchema (IntMap a) where
694 declareNamedSchema _ = declareNamedSchema (Proxy :: Proxy [(Int, a)])
498 declareNamedSchema _ = declareNamedSchema (Proxy :: Proxy [(Int, a)])
695
499
696instance (ToJSONKey k, ToSchema k, ToSchema v) => ToSchema (Map k v) where
500instance (ToJSONKey k, ToSchema k, ToSchema v) => ToSchema (Map k v) where
@@ -701,7 +505,7 @@ instance (ToJSONKey k, ToSchema k, ToSchema v) => ToSchema (Map k v) where
701 declareObjectMapSchema = do
505 declareObjectMapSchema = do
702 schema <- declareSchemaRef (Proxy :: Proxy v)
506 schema <- declareSchemaRef (Proxy :: Proxy v)
703 return $ unnamed $ mempty
507 return $ unnamed $ mempty
704− & type_ ?~ OpenApiObject
508+ & type_ ?~ SwaggerObject
705 & additionalProperties ?~ AdditionalPropertiesSchema schema
509 & additionalProperties ?~ AdditionalPropertiesSchema schema
706
510
707instance (ToJSONKey k, ToSchema k, ToSchema v) => ToSchema (HashMap k v) where
511instance (ToJSONKey k, ToSchema k, ToSchema v) => ToSchema (HashMap k v) where
@@ -709,7 +513,7 @@ instance (ToJSONKey k, ToSchema k, ToSchema v) => ToSchema (HashMap k v) where
709
513
710instance {-# OVERLAPPING #-} ToSchema Object where
514instance {-# OVERLAPPING #-} ToSchema Object where
711 declareNamedSchema _ = pure $ NamedSchema (Just "Object") $ mempty
515 declareNamedSchema _ = pure $ NamedSchema (Just "Object") $ mempty
712− & type_ ?~ OpenApiObject
516+ & type_ ?~ SwaggerObject
713 & description ?~ "Arbitrary JSON object."
517 & description ?~ "Arbitrary JSON object."
714 & additionalProperties ?~ AdditionalPropertiesAllowed True
518 & additionalProperties ?~ AdditionalPropertiesAllowed True
715
519
@@ -746,15 +550,11 @@ instance ToSchema a => ToSchema (Identity a) where declareNamedSchema _ = declar
746
550
747-- | Default schema for @'Bounded'@, @'Integral'@ types.
551-- | Default schema for @'Bounded'@, @'Integral'@ types.
748--
552--
749−-- >>> BSL.putStrLn $ encodePretty $ toSchemaBoundedIntegral (Proxy :: Proxy Int16)
553+-- >>> BSL.putStrLn $ encode $ toSchemaBoundedIntegral (Proxy :: Proxy Int16)
750−-- {
751−-- "maximum": 32767,
554+-- {"maximum":32767,"minimum":-32768,"type":"integer"}
752−-- "minimum": -32768,
753−-- "type": "integer"
754−-- }
755toSchemaBoundedIntegral :: forall a. (Bounded a, Integral a) => Proxy a -> Schema
555toSchemaBoundedIntegral :: forall a. (Bounded a, Integral a) => Proxy a -> Schema
756toSchemaBoundedIntegral _ = mempty
556toSchemaBoundedIntegral _ = mempty
757− & type_ ?~ OpenApiInteger
557+ & type_ ?~ SwaggerInteger
758 & minimum_ ?~ fromInteger (toInteger (minBound :: a))
558 & minimum_ ?~ fromInteger (toInteger (minBound :: a))
759 & maximum_ ?~ fromInteger (toInteger (maxBound :: a))
559 & maximum_ ?~ fromInteger (toInteger (maxBound :: a))
760
560
@@ -783,27 +583,8 @@ genericDeclareNamedSchemaNewtype opts f proxy = genericNameSchema opts proxy <$>
783-- >>> instance ToSchema ButtonState
583-- >>> instance ToSchema ButtonState
784-- >>> instance ToJSONKey ButtonState where toJSONKey = toJSONKeyText (T.pack . show)
584-- >>> instance ToJSONKey ButtonState where toJSONKey = toJSONKeyText (T.pack . show)
785-- >>> type ImageUrl = T.Text
585-- >>> type ImageUrl = T.Text
786−-- >>> BSL.putStrLn $ encodePretty $ toSchemaBoundedEnumKeyMapping (Proxy :: Proxy (Map ButtonState ImageUrl))
586+-- >>> BSL.putStrLn $ encode $ toSchemaBoundedEnumKeyMapping (Proxy :: Proxy (Map ButtonState ImageUrl))
787−-- {
587+-- {"type":"object","properties":{"Focus":{"type":"string"},"Disabled":{"type":"string"},"Active":{"type":"string"},"Neutral":{"type":"string"},"Hover":{"type":"string"}}}
788−-- "properties": {
789−-- "Active": {
790−-- "type": "string"
791−-- },
792−-- "Disabled": {
793−-- "type": "string"
794−-- },
795−-- "Focus": {
796−-- "type": "string"
797−-- },
798−-- "Hover": {
799−-- "type": "string"
800−-- },
801−-- "Neutral": {
802−-- "type": "string"
803−-- }
804−-- },
805−-- "type": "object"
806−-- }
807--
588--
808-- Note: this is only useful when @key@ is encoded with 'ToJSONKeyText'.
589-- Note: this is only useful when @key@ is encoded with 'ToJSONKeyText'.
809-- If it is encoded with 'ToJSONKeyValue' then a regular schema for @[(key, value)]@ is used.
590-- If it is encoded with 'ToJSONKeyValue' then a regular schema for @[(key, value)]@ is used.
@@ -811,15 +592,15 @@ declareSchemaBoundedEnumKeyMapping :: forall map key value.
811 (Bounded key, Enum key, ToJSONKey key, ToSchema key, ToSchema value)
592 (Bounded key, Enum key, ToJSONKey key, ToSchema key, ToSchema value)
812 => Proxy (map key value) -> Declare (Definitions Schema) Schema
593 => Proxy (map key value) -> Declare (Definitions Schema) Schema
813declareSchemaBoundedEnumKeyMapping _ = case toJSONKey :: ToJSONKeyFunction key of
594declareSchemaBoundedEnumKeyMapping _ = case toJSONKey :: ToJSONKeyFunction key of
814− ToJSONKeyText getKey _ -> objectSchema getKey
595+ ToJSONKeyText keyToText _ -> objectSchema keyToText
815 ToJSONKeyValue _ _ -> declareSchema (Proxy :: Proxy [(key, value)])
596 ToJSONKeyValue _ _ -> declareSchema (Proxy :: Proxy [(key, value)])
816 where
597 where
817− objectSchema getKey = do
598+ objectSchema keyToText = do
818 valueRef <- declareSchemaRef (Proxy :: Proxy value)
599 valueRef <- declareSchemaRef (Proxy :: Proxy value)
819 let allKeys = [minBound..maxBound :: key]
600 let allKeys = [minBound..maxBound :: key]
820− mkPair k = (keyToText $ getKey k, valueRef)
601+ mkPair k = (keyToText k, valueRef)
821 return $ mempty
602 return $ mempty
822− & type_ ?~ OpenApiObject
603+ & type_ ?~ SwaggerObject
823 & properties .~ InsOrdHashMap.fromList (map mkPair allKeys)
604 & properties .~ InsOrdHashMap.fromList (map mkPair allKeys)
824
605
825-- | A 'Schema' for a mapping with 'Bounded' 'Enum' keys.
606-- | A 'Schema' for a mapping with 'Bounded' 'Enum' keys.
@@ -830,27 +611,8 @@ declareSchemaBoundedEnumKeyMapping _ = case toJSONKey :: ToJSONKeyFunction key o
830-- >>> instance ToSchema ButtonState
611-- >>> instance ToSchema ButtonState
831-- >>> instance ToJSONKey ButtonState where toJSONKey = toJSONKeyText (T.pack . show)
612-- >>> instance ToJSONKey ButtonState where toJSONKey = toJSONKeyText (T.pack . show)
832-- >>> type ImageUrl = T.Text
613-- >>> type ImageUrl = T.Text
833−-- >>> BSL.putStrLn $ encodePretty $ toSchemaBoundedEnumKeyMapping (Proxy :: Proxy (Map ButtonState ImageUrl))
614+-- >>> BSL.putStrLn $ encode $ toSchemaBoundedEnumKeyMapping (Proxy :: Proxy (Map ButtonState ImageUrl))
834−-- {
615+-- {"type":"object","properties":{"Focus":{"type":"string"},"Disabled":{"type":"string"},"Active":{"type":"string"},"Neutral":{"type":"string"},"Hover":{"type":"string"}}}
835−-- "properties": {
836−-- "Active": {
837−-- "type": "string"
838−-- },
839−-- "Disabled": {
840−-- "type": "string"
841−-- },
842−-- "Focus": {
843−-- "type": "string"
844−-- },
845−-- "Hover": {
846−-- "type": "string"
847−-- },
848−-- "Neutral": {
849−-- "type": "string"
850−-- }
851−-- },
852−-- "type": "object"
853−-- }
854--
616--
855-- Note: this is only useful when @key@ is encoded with 'ToJSONKeyText'.
617-- Note: this is only useful when @key@ is encoded with 'ToJSONKeyText'.
856-- If it is encoded with 'ToJSONKeyValue' then a regular schema for @[(key, value)]@ is used.
618-- If it is encoded with 'ToJSONKeyValue' then a regular schema for @[(key, value)]@ is used.
@@ -860,7 +622,7 @@ toSchemaBoundedEnumKeyMapping :: forall map key value.
860toSchemaBoundedEnumKeyMapping = flip evalDeclare mempty . declareSchemaBoundedEnumKeyMapping
622toSchemaBoundedEnumKeyMapping = flip evalDeclare mempty . declareSchemaBoundedEnumKeyMapping
861
623
862-- | A configurable generic @'Schema'@ creator.
624-- | A configurable generic @'Schema'@ creator.
863−genericDeclareSchema :: (Generic a, GToSchema (Rep a), Typeable a) =>
625+genericDeclareSchema :: (Generic a, GToSchema (Rep a)) =>
864 SchemaOptions -> Proxy a -> Declare (Definitions Schema) Schema
626 SchemaOptions -> Proxy a -> Declare (Definitions Schema) Schema
865genericDeclareSchema opts proxy = _namedSchemaSchema <$> genericDeclareNamedSchema opts proxy
627genericDeclareSchema opts proxy = _namedSchemaSchema <$> genericDeclareNamedSchema opts proxy
866
628
@@ -868,24 +630,9 @@ genericDeclareSchema opts proxy = _namedSchemaSchema <$> genericDeclareNamedSche
868-- This function applied to @'defaultSchemaOptions'@
630-- This function applied to @'defaultSchemaOptions'@
869-- is used as the default for @'declareNamedSchema'@
631-- is used as the default for @'declareNamedSchema'@
870-- when the type is an instance of @'Generic'@.
632-- when the type is an instance of @'Generic'@.
871−--
872−-- Default implementation will use the name from 'Typeable' instance, including concrete
873−-- instantioations of type variables.
874−--
875−-- For example:
876−--
877−-- >>> _namedSchemaName $ undeclare $ genericDeclareNamedSchema defaultSchemaOptions (Proxy :: Proxy (Either Int Bool))
878−-- Just "Either_Int_Bool"
879−genericDeclareNamedSchema :: forall a. (Generic a, GToSchema (Rep a), Typeable a) =>
633+genericDeclareNamedSchema :: forall a. (Generic a, GToSchema (Rep a)) =>
880 SchemaOptions -> Proxy a -> Declare (Definitions Schema) NamedSchema
634 SchemaOptions -> Proxy a -> Declare (Definitions Schema) NamedSchema
881−genericDeclareNamedSchema opts _ =
882− rename (Just $ T.pack name) <$> gdeclareNamedSchema opts (Proxy :: Proxy (Rep a)) mempty
635+genericDeclareNamedSchema opts _ = gdeclareNamedSchema opts (Proxy :: Proxy (Rep a)) mempty
883− where
884− unspace ' ' = '_'
885− unspace x = x
886− orig = fmap unspace $ show $ typeRep @a
887− name = datatypeNameModifier opts orig
888−
889
636
890-- | Derive a 'Generic'-based name for a datatype and assign it to a given 'Schema'.
637-- | Derive a 'Generic'-based name for a datatype and assign it to a given 'Schema'.
891genericNameSchema :: forall a d f.
638genericNameSchema :: forall a d f.
@@ -912,8 +659,8 @@ paramSchemaToSchema = toParamSchema
912
659
913nullarySchema :: Schema
660nullarySchema :: Schema
914nullarySchema = mempty
661nullarySchema = mempty
915− & type_ ?~ OpenApiArray
662+ & type_ ?~ SwaggerArray
916− & items ?~ OpenApiItemsArray []
663+ & items ?~ SwaggerItemsArray []
917
664
918gtoNamedSchema :: GToSchema f => SchemaOptions -> Proxy f -> NamedSchema
665gtoNamedSchema :: GToSchema f => SchemaOptions -> Proxy f -> NamedSchema
919gtoNamedSchema opts proxy = undeclare $ gdeclareNamedSchema opts proxy mempty
666gtoNamedSchema opts proxy = undeclare $ gdeclareNamedSchema opts proxy mempty
@@ -943,15 +690,12 @@ instance (Selector s, GToSchema f, GToSchema (S1 s f)) => GToSchema (C1 c (S1 s
943 | unwrapUnaryRecords opts = fieldSchema
690 | unwrapUnaryRecords opts = fieldSchema
944 | otherwise =
691 | otherwise =
945 case schema ^. items of
692 case schema ^. items of
946− Just (OpenApiItemsArray [_]) -> fieldSchema
693+ Just (SwaggerItemsArray [_]) -> fieldSchema
947 _ -> do
694 _ -> do
948− -- We have to run recordSchema instead of just using its defs,
695+ declare defs
949− -- since those can be recursive and will lead to infinite loop,
950− -- see https://github.com/biocad/openapi3/pull/37
951− NamedSchema _ schema' <- recordSchema
952− return (unnamed schema')
696+ return (unnamed schema)
953 where
697 where
954− (_, NamedSchema _ schema) = runDeclare recordSchema mempty
698+ (defs, NamedSchema _ schema) = runDeclare recordSchema mempty
955 recordSchema = gdeclareNamedSchema opts (Proxy :: Proxy (S1 s f)) s
699 recordSchema = gdeclareNamedSchema opts (Proxy :: Proxy (S1 s f)) s
956 fieldSchema = gdeclareNamedSchema opts (Proxy :: Proxy f) s
700 fieldSchema = gdeclareNamedSchema opts (Proxy :: Proxy f) s
957
701
@@ -974,10 +718,10 @@ gdeclareSchemaRef opts proxy = do
974 return $ Ref (Reference name)
718 return $ Ref (Reference name)
975 _ -> Inline <$> gdeclareSchema opts proxy
719 _ -> Inline <$> gdeclareSchema opts proxy
976
720
977−appendItem :: Referenced Schema -> Maybe OpenApiItems -> Maybe OpenApiItems
721+appendItem :: Referenced Schema -> Maybe SwaggerItems -> Maybe SwaggerItems
978−appendItem x Nothing = Just (OpenApiItemsArray [x])
722+appendItem x Nothing = Just (SwaggerItemsArray [x])
979−appendItem x (Just (OpenApiItemsArray xs)) = Just (OpenApiItemsArray (xs ++ [x]))
723+appendItem x (Just (SwaggerItemsArray xs)) = Just (SwaggerItemsArray (xs ++ [x]))
980−appendItem _ _ = error "GToSchema.appendItem: cannot append to OpenApiItemsObject"
724+appendItem _ _ = error "GToSchema.appendItem: cannot append to SwaggerItemsObject"
981
725
982withFieldSchema :: forall proxy s f. (Selector s, GToSchema f) =>
726withFieldSchema :: forall proxy s f. (Selector s, GToSchema f) =>
983 SchemaOptions -> proxy s f -> Bool -> Schema -> Declare (Definitions Schema) Schema
727 SchemaOptions -> proxy s f -> Bool -> Schema -> Declare (Definitions Schema) Schema
@@ -986,12 +730,12 @@ withFieldSchema opts _ isRequiredField schema = do
986 return $
730 return $
987 if T.null fname
731 if T.null fname
988 then schema
732 then schema
989− & type_ ?~ OpenApiArray
733+ & type_ ?~ SwaggerArray
990 & items %~ appendItem ref
734 & items %~ appendItem ref
991 & maxItems %~ Just . maybe 1 (+1) -- increment maxItems
735 & maxItems %~ Just . maybe 1 (+1) -- increment maxItems
992 & minItems %~ Just . maybe 1 (+1) -- increment minItems
736 & minItems %~ Just . maybe 1 (+1) -- increment minItems
993 else schema
737 else schema
994− & type_ ?~ OpenApiObject
738+ & type_ ?~ SwaggerObject
995 & properties . at fname ?~ ref
739 & properties . at fname ?~ ref
996 & if isRequiredField
740 & if isRequiredField
997 then required %~ (++ [fname])
741 then required %~ (++ [fname])
@@ -1026,14 +770,14 @@ gdeclareNamedSumSchema opts proxy _
1026 | otherwise = do
770 | otherwise = do
1027 (schemas, _) <- runWriterT declareSumSchema
771 (schemas, _) <- runWriterT declareSumSchema
1028 return $ unnamed $ mempty
772 return $ unnamed $ mempty
1029− & type_ ?~ OpenApiObject
773+ & type_ ?~ SwaggerObject
1030 & oneOf ?~ (snd <$> schemas)
774 & oneOf ?~ (snd <$> schemas)
1031 where
775 where
1032 declareSumSchema = gsumToSchema opts proxy
776 declareSumSchema = gsumToSchema opts proxy
1033 (sumSchemas, All allNullary) = undeclare (runWriterT declareSumSchema)
777 (sumSchemas, All allNullary) = undeclare (runWriterT declareSumSchema)
1034
778
1035 toStringTag schemas = mempty
779 toStringTag schemas = mempty
1036− & type_ ?~ OpenApiString
780+ & type_ ?~ SwaggerString
1037 & enum_ ?~ map (String . fst) sumSchemas
781 & enum_ ?~ map (String . fst) sumSchemas
1038
782
1039type AllNullary = All
783type AllNullary = All
@@ -1055,15 +799,15 @@ gsumConToSchemaWith ref opts _ = (tag, schema)
1055 case ref of
799 case ref of
1056 -- If subschema is an object and constructor is a record, we add tag directly
800 -- If subschema is an object and constructor is a record, we add tag directly
1057 -- to the record, as Aeson does it.
801 -- to the record, as Aeson does it.
1058− Just (Inline sub) | sub ^. type_ == Just OpenApiObject && isRecord -> Inline $ sub
802+ Just (Inline sub) | sub ^. type_ == Just SwaggerObject && isRecord -> Inline $ sub
1059 & required <>~ [T.pack tagField]
803 & required <>~ [T.pack tagField]
1060− & properties . at (T.pack tagField) ?~ (Inline $ mempty & type_ ?~ OpenApiString & enum_ ?~ [String tag])
804+ & properties . at (T.pack tagField) ?~ (Inline $ mempty & type_ ?~ SwaggerString & enum_ ?~ [String tag])
1061
805
1062 -- If it is not a record, we need to put subschema into "contents" field.
806 -- If it is not a record, we need to put subschema into "contents" field.
1063 _ | not isRecord -> Inline $ mempty
807 _ | not isRecord -> Inline $ mempty
1064− & type_ ?~ OpenApiObject
808+ & type_ ?~ SwaggerObject
1065 & required .~ [T.pack tagField]
809 & required .~ [T.pack tagField]
1066− & properties . at (T.pack tagField) ?~ (Inline $ mempty & type_ ?~ OpenApiString & enum_ ?~ [String tag])
810+ & properties . at (T.pack tagField) ?~ (Inline $ mempty & type_ ?~ SwaggerString & enum_ ?~ [String tag])
1067 -- If constructor is nullary, there is no content.
811 -- If constructor is nullary, there is no content.
1068 & case ref of
812 & case ref of
1069 Just r -> (properties . at (T.pack contentsField) ?~ r) . (required <>~ [T.pack contentsField])
813 Just r -> (properties . at (T.pack contentsField) ?~ r) . (required <>~ [T.pack contentsField])
@@ -1071,17 +815,17 @@ gsumConToSchemaWith ref opts _ = (tag, schema)
1071
815
1072 -- In the remaining cases we combine "tag" object and "contents" object using allOf.
816 -- In the remaining cases we combine "tag" object and "contents" object using allOf.
1073 _ -> Inline $ mempty
817 _ -> Inline $ mempty
1074− & type_ ?~ OpenApiObject
818+ & type_ ?~ SwaggerObject
1075 & allOf ?~ [Inline $ mempty
819 & allOf ?~ [Inline $ mempty
1076− & type_ ?~ OpenApiObject
820+ & type_ ?~ SwaggerObject
1077 & required .~ (T.pack tagField : if isRecord then [] else [T.pack contentsField])
821 & required .~ (T.pack tagField : if isRecord then [] else [T.pack contentsField])
1078− & properties . at (T.pack tagField) ?~ (Inline $ mempty & type_ ?~ OpenApiString & enum_ ?~ [String tag])]
822+ & properties . at (T.pack tagField) ?~ (Inline $ mempty & type_ ?~ SwaggerString & enum_ ?~ [String tag])]
1079 & if isRecord
823 & if isRecord
1080 then allOf . _Just <>~ [refOrNullary]
824 then allOf . _Just <>~ [refOrNullary]
1081− else allOf . _Just <>~ [Inline $ mempty & type_ ?~ OpenApiObject & properties . at (T.pack contentsField) ?~ refOrNullary]
825+ else allOf . _Just <>~ [Inline $ mempty & type_ ?~ SwaggerObject & properties . at (T.pack contentsField) ?~ refOrNullary]
1082 UntaggedValue -> refOrEnum -- Aeson encodes nullary constructors as strings in this case.
826 UntaggedValue -> refOrEnum -- Aeson encodes nullary constructors as strings in this case.
1083 ObjectWithSingleField -> Inline $ mempty
827 ObjectWithSingleField -> Inline $ mempty
1084− & type_ ?~ OpenApiObject
828+ & type_ ?~ SwaggerObject
1085 & required .~ [tag]
829 & required .~ [tag]
1086 & properties . at tag ?~ refOrNullary
830 & properties . at tag ?~ refOrNullary
1087 TwoElemArray -> error "unrepresentable in OpenAPI 3"
831 TwoElemArray -> error "unrepresentable in OpenAPI 3"
@@ -1089,7 +833,7 @@ gsumConToSchemaWith ref opts _ = (tag, schema)
1089 tag = T.pack (constructorTagModifier opts (conName (Proxy3 :: Proxy3 c f p)))
833 tag = T.pack (constructorTagModifier opts (conName (Proxy3 :: Proxy3 c f p)))
1090 isRecord = conIsRecord (Proxy3 :: Proxy3 c f p)
834 isRecord = conIsRecord (Proxy3 :: Proxy3 c f p)
1091 refOrNullary = fromMaybe (Inline nullarySchema) ref
835 refOrNullary = fromMaybe (Inline nullarySchema) ref
1092− refOrEnum = fromMaybe (Inline $ mempty & type_ ?~ OpenApiString & enum_ ?~ [String tag]) ref
836+ refOrEnum = fromMaybe (Inline $ mempty & type_ ?~ SwaggerString & enum_ ?~ [String tag]) ref
1093
837
1094gsumConToSchema :: (GToSchema (C1 c f), Constructor c) =>
838gsumConToSchema :: (GToSchema (C1 c f), Constructor c) =>
1095 SchemaOptions -> Proxy (C1 c f) -> Declare (Definitions Schema) [(T.Text, Referenced Schema)]
839 SchemaOptions -> Proxy (C1 c f) -> Declare (Definitions Schema) [(T.Text, Referenced Schema)]
@@ -1114,13 +858,7 @@ data Proxy2 a b = Proxy2
1114
858
1115data Proxy3 a b c = Proxy3
859data Proxy3 a b c = Proxy3
1116
860
1117−{- $setup
861+-- $setup
1118−>>> import Data.OpenApi
862+-- >>> import Data.Swagger
1119−>>> import Data.Aeson (encode)
863+-- >>> import Data.Aeson (encode)
1120−>>> import Data.Aeson.Types (toJSONKeyText)
864+-- >>> import Data.Aeson.Types (toJSONKeyText)
1121−>>> import Data.OpenApi.Internal.Utils
1122−>>> :set -XScopedTypeVariables
1123−>>> :set -XDeriveAnyClass
1124−>>> :set -XStandaloneDeriving
1125−>>> :set -XTypeApplications
1126−-}
src/Data/OpenApi/Internal/Schema/Validation.hs → src/Data/Swagger/Internal/Schema/Validation.hsrenamed+62−74
@@ -1,5 +1,4 @@
1{-# OPTIONS_GHC -Wall #-}
1{-# OPTIONS_GHC -Wall #-}
2−{-# LANGUAGE CPP #-}
3{-# LANGUAGE DataKinds #-}
2{-# LANGUAGE DataKinds #-}
4{-# LANGUAGE DeriveFunctor #-}
3{-# LANGUAGE DeriveFunctor #-}
5{-# LANGUAGE FlexibleInstances #-}
4{-# LANGUAGE FlexibleInstances #-}
@@ -15,14 +14,14 @@
15{-# LANGUAGE UndecidableInstances #-}
14{-# LANGUAGE UndecidableInstances #-}
16{-# LANGUAGE ViewPatterns #-}
15{-# LANGUAGE ViewPatterns #-}
17-- |
16-- |
18−-- Module: Data.OpenApi.Internal.Schema.Validation
17+-- Module: Data.Swagger.Internal.Schema.Validation
19-- Copyright: (c) 2015 GetShopTV
18-- Copyright: (c) 2015 GetShopTV
20-- License: BSD3
19-- License: BSD3
21-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
20-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
22-- Stability: experimental
21-- Stability: experimental
23--
22--
24-- Validate JSON values with Swagger Schema.
23-- Validate JSON values with Swagger Schema.
25−module Data.OpenApi.Internal.Schema.Validation where
24+module Data.Swagger.Internal.Schema.Validation where
26
25
27import Prelude ()
26import Prelude ()
28import Prelude.Compat
27import Prelude.Compat
@@ -32,14 +31,11 @@ import Control.Lens hiding (allOf)
32import Control.Monad (forM, forM_, when)
31import Control.Monad (forM, forM_, when)
33
32
34import Data.Aeson hiding (Result)
33import Data.Aeson hiding (Result)
35−#if MIN_VERSION_aeson(2,0,0)
34+import Data.Aeson.Encode.Pretty (encodePretty)
36−import qualified Data.Aeson.KeyMap as KeyMap
37−#endif
38import Data.Foldable (for_, sequenceA_,
35import Data.Foldable (for_, sequenceA_,
39 traverse_)
36 traverse_)
40−#if !MIN_VERSION_aeson(2,0,0)
41import Data.HashMap.Strict (HashMap)
37import Data.HashMap.Strict (HashMap)
42−#endif
38+import qualified Data.HashMap.Strict as HashMap
43import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
39import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
44import qualified "unordered-containers" Data.HashSet as HashSet
40import qualified "unordered-containers" Data.HashSet as HashSet
45import Data.Maybe (fromMaybe)
41import Data.Maybe (fromMaybe)
@@ -52,12 +48,10 @@ import qualified Data.Text.Lazy.Encoding as TL
52import Data.Vector (Vector)
48import Data.Vector (Vector)
53import qualified Data.Vector as Vector
49import qualified Data.Vector as Vector
54
50
55−import Data.OpenApi.Aeson.Compat (hasKey, keyToText, lookupKey, objectToList)
56−import Data.OpenApi.Declare
51+import Data.Swagger.Declare
57−import Data.OpenApi.Internal
52+import Data.Swagger.Internal
58−import Data.OpenApi.Internal.Schema
53+import Data.Swagger.Internal.Schema
59−import Data.OpenApi.Internal.Utils
54+import Data.Swagger.Lens
60−import Data.OpenApi.Lens
61
55
62-- | Validate @'ToJSON'@ instance matches @'ToSchema'@ for a given value.
56-- | Validate @'ToJSON'@ instance matches @'ToSchema'@ for a given value.
63-- This can be used with QuickCheck to ensure those instances are coherent:
57-- This can be used with QuickCheck to ensure those instances are coherent:
@@ -109,33 +103,33 @@ validateToJSONWithPatternChecker checker = validateJSONWithPatternChecker checke
109-- <BLANKLINE>
103-- <BLANKLINE>
110-- Swagger Schema:
104-- Swagger Schema:
111-- {
105-- {
112−-- "properties": {
113−-- "name": {
114−-- "type": "string"
115−-- },
116−-- "phone": {
117−-- "$ref": "#/components/schemas/Phone"
118−-- }
119−-- },
120-- "required": [
106-- "required": [
121-- "name",
107-- "name",
122-- "phone"
108-- "phone"
123-- ],
109-- ],
124−-- "type": "object"
110+-- "type": "object",
111+-- "properties": {
112+-- "phone": {
113+-- "$ref": "#/components/schemas/Phone"
114+-- },
115+-- "name": {
116+-- "type": "string"
117+-- }
118+-- }
125-- }
119-- }
126-- <BLANKLINE>
120-- <BLANKLINE>
127-- Swagger Description Context:
121-- Swagger Description Context:
128-- {
122-- {
129-- "Phone": {
123-- "Phone": {
124+-- "required": [
125+-- "value"
126+-- ],
127+-- "type": "object",
130-- "properties": {
128-- "properties": {
131-- "value": {
129-- "value": {
132-- "type": "string"
130-- "type": "string"
133-- }
131-- }
134−-- },
132+-- }
135−-- "required": [
136−-- "value"
137−-- ],
138−-- "type": "object"
139-- }
133-- }
140-- }
134-- }
141-- <BLANKLINE>
135-- <BLANKLINE>
@@ -321,11 +315,11 @@ validateNumber n = withConfig $ \_cfg -> withSchema $ \sch -> do
321
315
322 check maximum_ $ \m ->
316 check maximum_ $ \m ->
323 when (if exMax then (n >= m) else (n > m)) $
317 when (if exMax then (n >= m) else (n > m)) $
324− invalid ("value " ++ show n ++ " exceeds maximum (should be " ++ (if exMax then "<" else "<=") ++ show m ++ ")")
318+ invalid ("value " ++ show n ++ " exceeds maximum (should be " ++ if exMax then "<" else "<=" ++ show m ++ ")")
325
319
326 check minimum_ $ \m ->
320 check minimum_ $ \m ->
327 when (if exMin then (n <= m) else (n < m)) $
321 when (if exMin then (n <= m) else (n < m)) $
328− invalid ("value " ++ show n ++ " falls below minimum (should be " ++ (if exMin then ">" else ">=") ++ show m ++ ")")
322+ invalid ("value " ++ show n ++ " falls below minimum (should be " ++ if exMin then ">" else ">=" ++ show m ++ ")")
329
323
330 check multipleOf $ \k ->
324 check multipleOf $ \k ->
331 when (not (isInteger (n / k))) $
325 when (not (isInteger (n / k))) $
@@ -359,8 +353,8 @@ validateArray xs = do
359 invalid ("array is too short (size should be >=" ++ show n ++ ")")
353 invalid ("array is too short (size should be >=" ++ show n ++ ")")
360
354
361 check items $ \case
355 check items $ \case
362− OpenApiItemsObject itemSchema -> traverse_ (validateWithSchemaRef itemSchema) xs
356+ SwaggerItemsObject itemSchema -> traverse_ (validateWithSchemaRef itemSchema) xs
363− OpenApiItemsArray itemSchemas -> do
357+ SwaggerItemsArray itemSchemas -> do
364 when (len /= length itemSchemas) $
358 when (len /= length itemSchemas) $
365 invalid ("array size is invalid (should be exactly " ++ show (length itemSchemas) ++ ")")
359 invalid ("array size is invalid (should be exactly " ++ show (length itemSchemas) ++ ")")
366 sequenceA_ (zipWith validateWithSchemaRef itemSchemas (Vector.toList xs))
360 sequenceA_ (zipWith validateWithSchemaRef itemSchemas (Vector.toList xs))
@@ -372,16 +366,10 @@ validateArray xs = do
372 len = Vector.length xs
366 len = Vector.length xs
373 allUnique = len == HashSet.size (HashSet.fromList (Vector.toList xs))
367 allUnique = len == HashSet.size (HashSet.fromList (Vector.toList xs))
374
368
375−validateObject ::
376−#if MIN_VERSION_aeson(2,0,0)
377− KeyMap.KeyMap Value
378−#else
379− HashMap Text Value
369+validateObject :: HashMap Text Value -> Validation Schema ()
380−#endif
381− -> Validation Schema ()
382validateObject o = withSchema $ \sch ->
370validateObject o = withSchema $ \sch ->
383 case sch ^. discriminator of
371 case sch ^. discriminator of
384− Just (Discriminator pname types) -> case fromJSON <$> lookupKey pname o of
372+ Just (Discriminator pname types) -> case fromJSON <$> HashMap.lookup pname o of
385 Just (Success pvalue) ->
373 Just (Success pvalue) ->
386 let ref = fromMaybe pvalue $ InsOrdHashMap.lookup pvalue types
374 let ref = fromMaybe pvalue $ InsOrdHashMap.lookup pvalue types
387 -- TODO ref may be name or reference
375 -- TODO ref may be name or reference
@@ -400,15 +388,15 @@ validateObject o = withSchema $ \sch ->
400 validateRequired
388 validateRequired
401 validateProps
389 validateProps
402 where
390 where
403− size = fromIntegral (length o)
391+ size = fromIntegral (HashMap.size o)
404
392
405 validateRequired = withSchema $ \sch -> traverse_ validateReq (sch ^. required)
393 validateRequired = withSchema $ \sch -> traverse_ validateReq (sch ^. required)
406 validateReq n =
394 validateReq n =
407− when (not (hasKey n o)) $
395+ when (not (HashMap.member n o)) $
408 invalid ("property " ++ show n ++ " is required, but not found in " ++ show (encode o))
396 invalid ("property " ++ show n ++ " is required, but not found in " ++ show (encode o))
409
397
410 validateProps = withSchema $ \sch -> do
398 validateProps = withSchema $ \sch -> do
411− for_ (objectToList o) $ \(keyToText -> k, v) ->
399+ for_ (HashMap.toList o) $ \(k, v) ->
412 case v of
400 case v of
413 Null | not (k `elem` (sch ^. required)) -> valid -- null is fine for non-required property
401 Null | not (k `elem` (sch ^. required)) -> valid -- null is fine for non-required property
414 _ ->
402 _ ->
@@ -435,10 +423,10 @@ validateEnum val = do
435-- This is like 'inferParamSchemaTypes', but also works for objects:
423-- This is like 'inferParamSchemaTypes', but also works for objects:
436--
424--
437-- >>> inferSchemaTypes <$> decode "{\"minProperties\": 1}"
425-- >>> inferSchemaTypes <$> decode "{\"minProperties\": 1}"
438−-- Just [OpenApiObject]
426+-- Just [SwaggerObject]
439−inferSchemaTypes :: Schema -> [OpenApiType]
427+inferSchemaTypes :: Schema -> [SwaggerType]
440inferSchemaTypes sch = inferParamSchemaTypes sch ++
428inferSchemaTypes sch = inferParamSchemaTypes sch ++
441− [ OpenApiObject | any ($ sch)
429+ [ SwaggerObject | any ($ sch)
442 [ has (additionalProperties._Just)
430 [ has (additionalProperties._Just)
443 , has (maxProperties._Just)
431 , has (maxProperties._Just)
444 , has (minProperties._Just)
432 , has (minProperties._Just)
@@ -448,30 +436,30 @@ inferSchemaTypes sch = inferParamSchemaTypes sch ++
448-- | Infer schema type based on used properties.
436-- | Infer schema type based on used properties.
449--
437--
450-- >>> inferSchemaTypes <$> decode "{\"minLength\": 2}"
438-- >>> inferSchemaTypes <$> decode "{\"minLength\": 2}"
451−-- Just [OpenApiString]
439+-- Just [SwaggerString]
452--
440--
453-- >>> inferSchemaTypes <$> decode "{\"maxItems\": 0}"
441-- >>> inferSchemaTypes <$> decode "{\"maxItems\": 0}"
454−-- Just [OpenApiArray]
442+-- Just [SwaggerArray]
455--
443--
456−-- From numeric properties 'OpenApiInteger' type is inferred.
444+-- From numeric properties 'SwaggerInteger' type is inferred.
457−-- If you want 'OpenApiNumber' instead, you must specify it explicitly.
445+-- If you want 'SwaggerNumber' instead, you must specify it explicitly.
458--
446--
459-- >>> inferSchemaTypes <$> decode "{\"minimum\": 1}"
447-- >>> inferSchemaTypes <$> decode "{\"minimum\": 1}"
460−-- Just [OpenApiInteger]
448+-- Just [SwaggerInteger]
461−inferParamSchemaTypes :: Schema -> [OpenApiType]
449+inferParamSchemaTypes :: Schema -> [SwaggerType]
462inferParamSchemaTypes sch = concat
450inferParamSchemaTypes sch = concat
463− [ [ OpenApiArray | any ($ sch)
451+ [ [ SwaggerArray | any ($ sch)
464 [ has (items._Just)
452 [ has (items._Just)
465 , has (maxItems._Just)
453 , has (maxItems._Just)
466 , has (minItems._Just)
454 , has (minItems._Just)
467 , has (uniqueItems._Just) ] ]
455 , has (uniqueItems._Just) ] ]
468− , [ OpenApiInteger | any ($ sch)
456+ , [ SwaggerInteger | any ($ sch)
469 [ has (exclusiveMaximum._Just)
457 [ has (exclusiveMaximum._Just)
470 , has (exclusiveMinimum._Just)
458 , has (exclusiveMinimum._Just)
471 , has (maximum_._Just)
459 , has (maximum_._Just)
472 , has (minimum_._Just)
460 , has (minimum_._Just)
473 , has (multipleOf._Just) ] ]
461 , has (multipleOf._Just) ] ]
474− , [ OpenApiString | any ($ sch)
462+ , [ SwaggerString | any ($ sch)
475 [ has (maxLength._Just)
463 [ has (maxLength._Just)
476 , has (minLength._Just)
464 , has (minLength._Just)
477 , has (pattern._Just) ] ]
465 , has (pattern._Just) ] ]
@@ -495,13 +483,13 @@ validateSchemaType val = withSchema $ \sch ->
495
483
496 _ ->
484 _ ->
497 case (sch ^. type_, val) of
485 case (sch ^. type_, val) of
498− (Just OpenApiNull, Null) -> valid
486+ (Just SwaggerNull, Null) -> valid
499− (Just OpenApiBoolean, Bool _) -> valid
487+ (Just SwaggerBoolean, Bool _) -> valid
500− (Just OpenApiInteger, Number n) -> validateInteger n
488+ (Just SwaggerInteger, Number n) -> validateInteger n
501− (Just OpenApiNumber, Number n) -> validateNumber n
489+ (Just SwaggerNumber, Number n) -> validateNumber n
502− (Just OpenApiString, String s) -> validateString s
490+ (Just SwaggerString, String s) -> validateString s
503− (Just OpenApiArray, Array xs) -> validateArray xs
491+ (Just SwaggerArray, Array xs) -> validateArray xs
504− (Just OpenApiObject, Object o) -> validateObject o
492+ (Just SwaggerObject, Object o) -> validateObject o
505 (Nothing, Null) -> valid
493 (Nothing, Null) -> valid
506 (Nothing, Bool _) -> valid
494 (Nothing, Bool _) -> valid
507 -- Number by default
495 -- Number by default
@@ -514,11 +502,11 @@ validateSchemaType val = withSchema $ \sch ->
514validateParamSchemaType :: Value -> Validation Schema ()
502validateParamSchemaType :: Value -> Validation Schema ()
515validateParamSchemaType val = withSchema $ \sch ->
503validateParamSchemaType val = withSchema $ \sch ->
516 case (sch ^. type_, val) of
504 case (sch ^. type_, val) of
517− (Just OpenApiBoolean, Bool _) -> valid
505+ (Just SwaggerBoolean, Bool _) -> valid
518− (Just OpenApiInteger, Number n) -> validateInteger n
506+ (Just SwaggerInteger, Number n) -> validateInteger n
519− (Just OpenApiNumber, Number n) -> validateNumber n
507+ (Just SwaggerNumber, Number n) -> validateNumber n
520− (Just OpenApiString, String s) -> validateString s
508+ (Just SwaggerString, String s) -> validateString s
521− (Just OpenApiArray, Array xs) -> validateArray xs
509+ (Just SwaggerArray, Array xs) -> validateArray xs
522 (Nothing, Bool _) -> valid
510 (Nothing, Bool _) -> valid
523 -- Number by default
511 -- Number by default
524 (Nothing, Number n) -> validateNumber n
512 (Nothing, Number n) -> validateNumber n
@@ -526,11 +514,11 @@ validateParamSchemaType val = withSchema $ \sch ->
526 (Nothing, Array xs) -> validateArray xs
514 (Nothing, Array xs) -> validateArray xs
527 bad -> invalid $ "expected JSON value of type " ++ showType bad
515 bad -> invalid $ "expected JSON value of type " ++ showType bad
528
516
529−showType :: (Maybe OpenApiType, Value) -> String
517+showType :: (Maybe SwaggerType, Value) -> String
530showType (Just ty, _) = show ty
518showType (Just ty, _) = show ty
531−showType (Nothing, Null) = "OpenApiNull"
519+showType (Nothing, Null) = "SwaggerNull"
532−showType (Nothing, Bool _) = "OpenApiBoolean"
520+showType (Nothing, Bool _) = "SwaggerBoolean"
533−showType (Nothing, Number _) = "OpenApiNumber"
521+showType (Nothing, Number _) = "SwaggerNumber"
534−showType (Nothing, String _) = "OpenApiString"
522+showType (Nothing, String _) = "SwaggerString"
535−showType (Nothing, Array _) = "OpenApiArray"
523+showType (Nothing, Array _) = "SwaggerArray"
536−showType (Nothing, Object _) = "OpenApiObject"
524+showType (Nothing, Object _) = "SwaggerObject"
src/Data/OpenApi/Internal/TypeShape.hs → src/Data/Swagger/Internal/TypeShape.hsrenamed+1−1
@@ -4,7 +4,7 @@
4{-# LANGUAGE TypeOperators #-}
4{-# LANGUAGE TypeOperators #-}
5{-# LANGUAGE UndecidableInstances #-}
5{-# LANGUAGE UndecidableInstances #-}
6
6
7−module Data.OpenApi.Internal.TypeShape where
7+module Data.Swagger.Internal.TypeShape where
8
8
9import Data.Proxy
9import Data.Proxy
10import GHC.Generics
10import GHC.Generics
src/Data/OpenApi/Internal/Utils.hs → src/Data/Swagger/Internal/Utils.hsrenamed+1−6
@@ -4,7 +4,7 @@
4{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE RankNTypes #-}
5{-# LANGUAGE RankNTypes #-}
6{-# LANGUAGE TypeOperators #-}
6{-# LANGUAGE TypeOperators #-}
7−module Data.OpenApi.Internal.Utils where
7+module Data.Swagger.Internal.Utils where
8
8
9import Prelude ()
9import Prelude ()
10import Prelude.Compat
10import Prelude.Compat
@@ -13,8 +13,6 @@ import Control.Lens ((&), (%~))
13import Control.Lens.TH
13import Control.Lens.TH
14import Data.Aeson
14import Data.Aeson
15import Data.Aeson.Types
15import Data.Aeson.Types
16−import qualified Data.Aeson.Encode.Pretty as P
17−import qualified Data.ByteString.Lazy as BSL
18import Data.Char
16import Data.Char
19import Data.Data
17import Data.Data
20import Data.Hashable (Hashable)
18import Data.Hashable (Hashable)
@@ -134,6 +132,3 @@ instance SwaggerMonoid (Maybe a) where
134 swaggerMempty = Nothing
132 swaggerMempty = Nothing
135 swaggerMappend x Nothing = x
133 swaggerMappend x Nothing = x
136 swaggerMappend _ y = y
134 swaggerMappend _ y = y
137−
138−encodePretty :: ToJSON a => a -> BSL.ByteString
139−encodePretty = P.encodePretty' $ P.defConfig { P.confCompare = P.compare }
src/Data/OpenApi/Lens.hs → src/Data/Swagger/Lens.hsrenamed+20−20
@@ -10,23 +10,23 @@
10{-# LANGUAGE UndecidableInstances #-}
10{-# LANGUAGE UndecidableInstances #-}
11{-# OPTIONS_GHC -fno-warn-orphans #-}
11{-# OPTIONS_GHC -fno-warn-orphans #-}
12-- |
12-- |
13−-- Module: Data.OpenApi.Lens
13+-- Module: Data.Swagger.Lens
14-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
14-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
15-- Stability: experimental
15-- Stability: experimental
16--
16--
17-- Lenses and prisms for Swagger.
17-- Lenses and prisms for Swagger.
18−module Data.OpenApi.Lens where
18+module Data.Swagger.Lens where
19
19
20import Control.Lens
20import Control.Lens
21import Data.Aeson (Value)
21import Data.Aeson (Value)
22import Data.Scientific (Scientific)
22import Data.Scientific (Scientific)
23−import Data.OpenApi.Internal
23+import Data.Swagger.Internal
24−import Data.OpenApi.Internal.Utils
24+import Data.Swagger.Internal.Utils
25import Data.Text (Text)
25import Data.Text (Text)
26
26
27-- * Classy lenses
27-- * Classy lenses
28
28
29−makeFields ''OpenApi
29+makeFields ''Swagger
30makeFields ''Components
30makeFields ''Components
31makeFields ''Server
31makeFields ''Server
32makeFields ''RequestBody
32makeFields ''RequestBody
@@ -64,24 +64,24 @@ makePrisms ''SecuritySchemeType
64-- ** 'Referenced' prisms
64-- ** 'Referenced' prisms
65makePrisms ''Referenced
65makePrisms ''Referenced
66
66
67−-- ** 'OpenApiItems' prisms
67+-- ** 'SwaggerItems' prisms
68
68
69−_OpenApiItemsArray :: Review OpenApiItems [Referenced Schema]
69+_SwaggerItemsArray :: Review SwaggerItems [Referenced Schema]
70−_OpenApiItemsArray
70+_SwaggerItemsArray
71− = unto (\x -> OpenApiItemsArray x)
71+ = unto (\x -> SwaggerItemsArray x)
72{- \x -> case x of
72{- \x -> case x of
73− OpenApiItemsPrimitive c p -> Left (OpenApiItemsPrimitive c p)
73+ SwaggerItemsPrimitive c p -> Left (SwaggerItemsPrimitive c p)
74− OpenApiItemsObject o -> Left (OpenApiItemsObject o)
74+ SwaggerItemsObject o -> Left (SwaggerItemsObject o)
75− OpenApiItemsArray a -> Right a
75+ SwaggerItemsArray a -> Right a
76-}
76-}
77
77
78−_OpenApiItemsObject :: Review OpenApiItems (Referenced Schema)
78+_SwaggerItemsObject :: Review SwaggerItems (Referenced Schema)
79−_OpenApiItemsObject
79+_SwaggerItemsObject
80− = unto (\x -> OpenApiItemsObject x)
80+ = unto (\x -> SwaggerItemsObject x)
81{- \x -> case x of
81{- \x -> case x of
82− OpenApiItemsPrimitive c p -> Left (OpenApiItemsPrimitive c p)
82+ SwaggerItemsPrimitive c p -> Left (SwaggerItemsPrimitive c p)
83− OpenApiItemsObject o -> Right o
83+ SwaggerItemsObject o -> Right o
84− OpenApiItemsArray a -> Left (OpenApiItemsArray a)
84+ SwaggerItemsArray a -> Left (SwaggerItemsArray a)
85-}
85-}
86
86
87-- =============================================================
87-- =============================================================
@@ -99,7 +99,7 @@ instance At Responses where at n = responses . at n
99instance Ixed Operation where ix n = responses . ix n
99instance Ixed Operation where ix n = responses . ix n
100instance At Operation where at n = responses . at n
100instance At Operation where at n = responses . at n
101
101
102−instance HasType NamedSchema (Maybe OpenApiType) where type_ = schema.type_
102+instance HasType NamedSchema (Maybe SwaggerType) where type_ = schema.type_
103
103
104-- OVERLAPPABLE instances
104-- OVERLAPPABLE instances
105
105
@@ -112,7 +112,7 @@ instance
112instance
112instance
113 {-# OVERLAPPABLE #-}
113 {-# OVERLAPPABLE #-}
114 HasSchema s Schema
114 HasSchema s Schema
115− => HasItems s (Maybe OpenApiItems) where
115+ => HasItems s (Maybe SwaggerItems) where
116 items = schema.items
116 items = schema.items
117
117
118instance
118instance
src/Data/OpenApi/Operation.hs → src/Data/Swagger/Operation.hsrenamed+29−136
@@ -1,13 +1,13 @@
1{-# LANGUAGE RankNTypes #-}
1{-# LANGUAGE RankNTypes #-}
2-- |
2-- |
3−-- Module: Data.OpenApi.Operation
3+-- Module: Data.Swagger.Operation
4-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
4-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
5-- Stability: experimental
5-- Stability: experimental
6--
6--
7-- Helper traversals and functions for Swagger operations manipulations.
7-- Helper traversals and functions for Swagger operations manipulations.
8-- These might be useful when you already have Swagger specification
8-- These might be useful when you already have Swagger specification
9-- generated by something else.
9-- generated by something else.
10−module Data.OpenApi.Operation (
10+module Data.Swagger.Operation (
11 -- * Operation traversals
11 -- * Operation traversals
12 allOperations,
12 allOperations,
13 operationsOf,
13 operationsOf,
@@ -42,10 +42,10 @@ import qualified Data.Set as Set
42import Data.Text (Text)
42import Data.Text (Text)
43import Network.HTTP.Media (MediaType)
43import Network.HTTP.Media (MediaType)
44
44
45−import Data.OpenApi.Declare
45+import Data.Swagger.Declare
46−import Data.OpenApi.Internal
46+import Data.Swagger.Internal
47−import Data.OpenApi.Lens
47+import Data.Swagger.Lens
48−import Data.OpenApi.Schema
48+import Data.Swagger.Schema
49
49
50import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
50import qualified Data.HashMap.Strict.InsOrd as InsOrdHashMap
51import qualified Data.HashSet.InsOrd as InsOrdHS
51import qualified Data.HashSet.InsOrd as InsOrdHS
@@ -55,17 +55,14 @@ import qualified Data.HashSet.InsOrd as InsOrdHS
55-- >>> import Data.Proxy
55-- >>> import Data.Proxy
56-- >>> import Data.Time
56-- >>> import Data.Time
57-- >>> import qualified Data.ByteString.Lazy.Char8 as BSL
57-- >>> import qualified Data.ByteString.Lazy.Char8 as BSL
58−-- >>> import Data.OpenApi.Internal.Utils
59
58
60-- | Prepend path piece to all operations of the spec.
59-- | Prepend path piece to all operations of the spec.
61-- Leading and trailing slashes are trimmed/added automatically.
60-- Leading and trailing slashes are trimmed/added automatically.
62--
61--
63−-- >>> let api = (mempty :: OpenApi) & paths .~ [("/info", mempty)]
62+-- >>> let api = (mempty :: Swagger) & paths .~ [("/info", mempty)]
64−-- >>> BSL.putStrLn $ encodePretty $ prependPath "user/{user_id}" api ^. paths
63+-- >>> BSL.putStrLn $ encode $ prependPath "user/{user_id}" api ^. paths
65−-- {
66−-- "/user/{user_id}/info": {}
64+-- {"/user/{user_id}/info":{}}
67−-- }
68−prependPath :: FilePath -> OpenApi -> OpenApi
65+prependPath :: FilePath -> Swagger -> Swagger
69prependPath path = paths %~ InsOrdHashMap.mapKeys (path </>)
66prependPath path = paths %~ InsOrdHashMap.mapKeys (path </>)
70 where
67 where
71 x </> y = case trim y of
68 x </> y = case trim y of
@@ -75,7 +72,7 @@ prependPath path = paths %~ InsOrdHashMap.mapKeys (path </>)
75 trim = dropWhile (== '/') . dropWhileEnd (== '/')
72 trim = dropWhile (== '/') . dropWhileEnd (== '/')
76
73
77-- | All operations of a Swagger spec.
74-- | All operations of a Swagger spec.
78−allOperations :: Traversal' OpenApi Operation
75+allOperations :: Traversal' Swagger Operation
79allOperations = paths.traverse.template
76allOperations = paths.traverse.template
80
77
81-- | @'operationsOf' sub@ will traverse only those operations
78-- | @'operationsOf' sub@ will traverse only those operations
@@ -83,66 +80,13 @@ allOperations = paths.traverse.template
83-- by both path and method.
80-- by both path and method.
84--
81--
85-- >>> let ok = (mempty :: Operation) & at 200 ?~ "OK"
82-- >>> let ok = (mempty :: Operation) & at 200 ?~ "OK"
86−-- >>> let api = (mempty :: OpenApi) & paths .~ [("/user", mempty & get ?~ ok & post ?~ ok)]
83+-- >>> let api = (mempty :: Swagger) & paths .~ [("/user", mempty & get ?~ ok & post ?~ ok)]
87−-- >>> let sub = (mempty :: OpenApi) & paths .~ [("/user", mempty & get ?~ mempty)]
84+-- >>> let sub = (mempty :: Swagger) & paths .~ [("/user", mempty & get ?~ mempty)]
88−-- >>> BSL.putStrLn $ encodePretty api
85+-- >>> BSL.putStrLn $ encode api
89−-- {
86+-- {"openapi":"3.0.0","info":{"version":"","title":""},"paths":{"/user":{"get":{"responses":{"200":{"description":"OK"}}},"post":{"responses":{"200":{"description":"OK"}}}}},"components":{}}
90−-- "components": {},
91−-- "info": {
92−-- "title": "",
93−-- "version": ""
94−-- },
95−-- "openapi": "3.0.0",
96−-- "paths": {
97−-- "/user": {
98−-- "get": {
99−-- "responses": {
100−-- "200": {
101−-- "description": "OK"
102−-- }
103−-- }
104−-- },
105−-- "post": {
106−-- "responses": {
107−-- "200": {
108−-- "description": "OK"
109−-- }
110−-- }
111−-- }
112−-- }
113−-- }
114−-- }
115−-- >>> BSL.putStrLn $ encodePretty $ api & operationsOf sub . at 404 ?~ "Not found"
87+-- >>> BSL.putStrLn $ encode $ api & operationsOf sub . at 404 ?~ "Not found"
116−-- {
88+-- {"openapi":"3.0.0","info":{"version":"","title":""},"paths":{"/user":{"get":{"responses":{"404":{"description":"Not found"},"200":{"description":"OK"}}},"post":{"responses":{"200":{"description":"OK"}}}}},"components":{}}
117−-- "components": {},
118−-- "info": {
119−-- "title": "",
120−-- "version": ""
121−-- },
122−-- "openapi": "3.0.0",
123−-- "paths": {
124−-- "/user": {
125−-- "get": {
126−-- "responses": {
127−-- "200": {
128−-- "description": "OK"
129−-- },
130−-- "404": {
131−-- "description": "Not found"
132−-- }
133−-- }
134−-- },
135−-- "post": {
136−-- "responses": {
137−-- "200": {
138−-- "description": "OK"
139−-- }
140−-- }
141−-- }
142−-- }
143−-- }
144−-- }
145−operationsOf :: OpenApi -> Traversal' OpenApi Operation
89+operationsOf :: Swagger -> Traversal' Swagger Operation
146operationsOf sub = paths.itraversed.withIndex.subops
90operationsOf sub = paths.itraversed.withIndex.subops
147 where
91 where
148 -- | Traverse operations that correspond to paths and methods of the sub API.
92 -- | Traverse operations that correspond to paths and methods of the sub API.
@@ -164,12 +108,12 @@ operationsOf sub = paths.itraversed.withIndex.subops
164-- @
108-- @
165-- 'applyTags' = 'applyTagsFor' 'allOperations'
109-- 'applyTags' = 'applyTagsFor' 'allOperations'
166-- @
110-- @
167−applyTags :: [Tag] -> OpenApi -> OpenApi
111+applyTags :: [Tag] -> Swagger -> Swagger
168applyTags = applyTagsFor allOperations
112applyTags = applyTagsFor allOperations
169
113
170-- | Apply tags to a part of Swagger spec and update the global
114-- | Apply tags to a part of Swagger spec and update the global
171-- list of tags.
115-- list of tags.
172−applyTagsFor :: Traversal' OpenApi Operation -> [Tag] -> OpenApi -> OpenApi
116+applyTagsFor :: Traversal' Swagger Operation -> [Tag] -> Swagger -> Swagger
173applyTagsFor ops ts swag = swag
117applyTagsFor ops ts swag = swag
174 & ops . tags %~ (<> InsOrdHS.fromList (map _tagName ts))
118 & ops . tags %~ (<> InsOrdHS.fromList (map _tagName ts))
175 & tags %~ (<> InsOrdHS.fromList ts)
119 & tags %~ (<> InsOrdHS.fromList ts)
@@ -179,26 +123,8 @@ applyTagsFor ops ts swag = swag
179--
123--
180-- FIXME doc
124-- FIXME doc
181--
125--
182−-- >>> BSL.putStrLn $ encodePretty $ runDeclare (declareResponse "application/json" (Proxy :: Proxy Day)) mempty
126+-- >>> BSL.putStrLn $ encode $ runDeclare (declareResponse "application/json" (Proxy :: Proxy Day)) mempty
183−-- [
127+-- [{"Day":{"example":"2016-07-22","format":"date","type":"string"}},{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Day"}}}}]
184−-- {
185−-- "Day": {
186−-- "example": "2016-07-22",
187−-- "format": "date",
188−-- "type": "string"
189−-- }
190−-- },
191−-- {
192−-- "content": {
193−-- "application/json": {
194−-- "schema": {
195−-- "$ref": "#/components/schemas/Day"
196−-- }
197−-- }
198−-- },
199−-- "description": ""
200−-- }
201−-- ]
202declareResponse :: ToSchema a => MediaType -> Proxy a -> Declare (Definitions Schema) Response
128declareResponse :: ToSchema a => MediaType -> Proxy a -> Declare (Definitions Schema) Response
203declareResponse cType proxy = do
129declareResponse cType proxy = do
204 s <- declareSchemaRef proxy
130 s <- declareSchemaRef proxy
@@ -215,46 +141,13 @@ declareResponse cType proxy = do
215--
141--
216-- Example:
142-- Example:
217--
143--
218−-- >>> let api = (mempty :: OpenApi) & paths .~ [("/user", mempty & get ?~ mempty)]
144+-- >>> let api = (mempty :: Swagger) & paths .~ [("/user", mempty & get ?~ mempty)]
219-- >>> let res = declareResponse "application/json" (Proxy :: Proxy Day)
145-- >>> let res = declareResponse "application/json" (Proxy :: Proxy Day)
220−-- >>> BSL.putStrLn $ encodePretty $ api & setResponse 200 res
146+-- >>> BSL.putStrLn $ encode $ api & setResponse 200 res
221−-- {
147+-- {"openapi":"3.0.0","info":{"version":"","title":""},"paths":{"/user":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Day"}}},"description":""}}}}},"components":{"schemas":{"Day":{"example":"2016-07-22","format":"date","type":"string"}}}}
222−-- "components": {
223−-- "schemas": {
224−-- "Day": {
225−-- "example": "2016-07-22",
226−-- "format": "date",
227−-- "type": "string"
228−-- }
229−-- }
230−-- },
231−-- "info": {
232−-- "title": "",
233−-- "version": ""
234−-- },
235−-- "openapi": "3.0.0",
236−-- "paths": {
237−-- "/user": {
238−-- "get": {
239−-- "responses": {
240−-- "200": {
241−-- "content": {
242−-- "application/json": {
243−-- "schema": {
244−-- "$ref": "#/components/schemas/Day"
245−-- }
246−-- }
247−-- },
248−-- "description": ""
249−-- }
250−-- }
251−-- }
252−-- }
253−-- }
254−-- }
255--
148--
256-- See also @'setResponseWith'@.
149-- See also @'setResponseWith'@.
257−setResponse :: HttpStatusCode -> Declare (Definitions Schema) Response -> OpenApi -> OpenApi
150+setResponse :: HttpStatusCode -> Declare (Definitions Schema) Response -> Swagger -> Swagger
258setResponse = setResponseFor allOperations
151setResponse = setResponseFor allOperations
259
152
260-- | Set or update response for all operations.
153-- | Set or update response for all operations.
@@ -268,7 +161,7 @@ setResponse = setResponseFor allOperations
268-- @
161-- @
269--
162--
270-- See also @'setResponse'@.
163-- See also @'setResponse'@.
271−setResponseWith :: (Response -> Response -> Response) -> HttpStatusCode -> Declare (Definitions Schema) Response -> OpenApi -> OpenApi
164+setResponseWith :: (Response -> Response -> Response) -> HttpStatusCode -> Declare (Definitions Schema) Response -> Swagger -> Swagger
272setResponseWith = setResponseForWith allOperations
165setResponseWith = setResponseForWith allOperations
273
166
274-- | Set response for specified operations.
167-- | Set response for specified operations.
@@ -277,7 +170,7 @@ setResponseWith = setResponseForWith allOperations
277-- If the response already exists it will be overwritten.
170-- If the response already exists it will be overwritten.
278--
171--
279-- See also @'setResponseForWith'@.
172-- See also @'setResponseForWith'@.
280−setResponseFor :: Traversal' OpenApi Operation -> HttpStatusCode -> Declare (Definitions Schema) Response -> OpenApi -> OpenApi
173+setResponseFor :: Traversal' Swagger Operation -> HttpStatusCode -> Declare (Definitions Schema) Response -> Swagger -> Swagger
281setResponseFor ops code dres swag = swag
174setResponseFor ops code dres swag = swag
282 & components.schemas %~ (<> defs)
175 & components.schemas %~ (<> defs)
283 & ops . at code ?~ Inline res
176 & ops . at code ?~ Inline res
@@ -291,7 +184,7 @@ setResponseFor ops code dres swag = swag
291-- then just the new response is used.
184-- then just the new response is used.
292--
185--
293-- See also @'setResponseFor'@.
186-- See also @'setResponseFor'@.
294−setResponseForWith :: Traversal' OpenApi Operation -> (Response -> Response -> Response) -> HttpStatusCode -> Declare (Definitions Schema) Response -> OpenApi -> OpenApi
187+setResponseForWith :: Traversal' Swagger Operation -> (Response -> Response -> Response) -> HttpStatusCode -> Declare (Definitions Schema) Response -> Swagger -> Swagger
295setResponseForWith ops f code dres swag = swag
188setResponseForWith ops f code dres swag = swag
296 & components.schemas %~ (<> defs)
189 & components.schemas %~ (<> defs)
297 & ops . at code %~ Just . Inline . combine
190 & ops . at code %~ Just . Inline . combine
src/Data/OpenApi/Optics.hs → src/Data/Swagger/Optics.hsrenamed+29−74
@@ -7,7 +7,7 @@
7{-# LANGUAGE UndecidableInstances #-}
7{-# LANGUAGE UndecidableInstances #-}
8{-# OPTIONS_GHC -fno-warn-orphans #-}
8{-# OPTIONS_GHC -fno-warn-orphans #-}
9-- |
9-- |
10−-- Module: Data.OpenApi.Optics
10+-- Module: Data.Swagger.Optics
11-- Maintainer: Andrzej Rybczak <andrzej@rybczak.net>
11-- Maintainer: Andrzej Rybczak <andrzej@rybczak.net>
12-- Stability: experimental
12-- Stability: experimental
13--
13--
@@ -19,98 +19,53 @@
19-- >>> :set -XOverloadedLabels
19-- >>> :set -XOverloadedLabels
20-- >>> import qualified Data.ByteString.Lazy.Char8 as BSL
20-- >>> import qualified Data.ByteString.Lazy.Char8 as BSL
21--
21--
22−-- Example from the "Data.OpenApi" module using @optics@:
22+-- Example from the "Data.Swagger" module using @optics@:
23--
23--
24-- >>> :{
24-- >>> :{
25−-- BSL.putStrLn $ encodePretty $ (mempty :: OpenApi)
25+-- BSL.putStrLn $ encode $ (mempty :: Swagger)
26−-- & #components % #schemas .~ [ ("User", mempty & #type ?~ OpenApiString) ]
26+-- & #components % #schemas .~ [ ("User", mempty & #type ?~ SwaggerString) ]
27-- & #paths .~
27-- & #paths .~
28-- [ ("/user", mempty & #get ?~ (mempty
28-- [ ("/user", mempty & #get ?~ (mempty
29-- & at 200 ?~ ("OK" & #_Inline % #content % at "application/json" ?~ (mempty & #schema ?~ Ref (Reference "User")))
29-- & at 200 ?~ ("OK" & #_Inline % #content % at "application/json" ?~ (mempty & #schema ?~ Ref (Reference "User")))
30-- & at 404 ?~ "User info not found")) ]
30-- & at 404 ?~ "User info not found")) ]
31-- :}
31-- :}
32−-- {
32+-- {"openapi":"3.0.0","info":{"version":"","title":""},"paths":{"/user":{"get":{"responses":{"404":{"description":"User info not found"},"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"OK"}}}}},"components":{"schemas":{"User":{"type":"string"}}}}
33−-- "components": {
34−-- "schemas": {
35−-- "User": {
36−-- "type": "string"
37−-- }
38−-- }
39−-- },
40−-- "info": {
41−-- "title": "",
42−-- "version": ""
43−-- },
44−-- "openapi": "3.0.0",
45−-- "paths": {
46−-- "/user": {
47−-- "get": {
48−-- "responses": {
49−-- "200": {
50−-- "content": {
51−-- "application/json": {
52−-- "schema": {
53−-- "$ref": "#/components/schemas/User"
54−-- }
55−-- }
56−-- },
57−-- "description": "OK"
58−-- },
59−-- "404": {
60−-- "description": "User info not found"
61−-- }
62−-- }
63−-- }
64−-- }
65−-- }
66−-- }
67--
33--
68-- For convenience optics are defined as /labels/. It means that field accessor
34-- For convenience optics are defined as /labels/. It means that field accessor
69-- names can be overloaded for different types. One such common field is
35-- names can be overloaded for different types. One such common field is
70-- @#description@. Many components of a Swagger specification can have
36-- @#description@. Many components of a Swagger specification can have
71-- descriptions, and you can use the same name for them:
37-- descriptions, and you can use the same name for them:
72--
38--
73−-- >>> BSL.putStrLn $ encodePretty $ (mempty :: Response) & #description .~ "No content"
39+-- >>> BSL.putStrLn $ encode $ (mempty :: Response) & #description .~ "No content"
74−-- {
75−-- "description": "No content"
40+-- {"description":"No content"}
76−-- }
77-- >>> :{
41-- >>> :{
78−-- BSL.putStrLn $ encodePretty $ (mempty :: Schema)
42+-- BSL.putStrLn $ encode $ (mempty :: Schema)
79−-- & #type ?~ OpenApiBoolean
43+-- & #type ?~ SwaggerBoolean
80-- & #description ?~ "To be or not to be"
44-- & #description ?~ "To be or not to be"
81-- :}
45-- :}
82−-- {
83−-- "description": "To be or not to be",
46+-- {"type":"boolean","description":"To be or not to be"}
84−-- "type": "boolean"
85−-- }
86--
47--
87-- Additionally, to simplify working with @'Response'@, both @'Operation'@ and
48-- Additionally, to simplify working with @'Response'@, both @'Operation'@ and
88-- @'Responses'@ have direct access to it via @'Optics.Core.At.at'@. Example:
49-- @'Responses'@ have direct access to it via @'Optics.Core.At.at'@. Example:
89--
50--
90-- >>> :{
51-- >>> :{
91−-- BSL.putStrLn $ encodePretty $ (mempty :: Operation)
52+-- BSL.putStrLn $ encode $ (mempty :: Operation)
92-- & at 404 ?~ "Not found"
53-- & at 404 ?~ "Not found"
93-- :}
54-- :}
94−-- {
95−-- "responses": {
96−-- "404": {
97−-- "description": "Not found"
55+-- {"responses":{"404":{"description":"Not found"}}}
98−-- }
99−-- }
100−-- }
56+--
101−module Data.OpenApi.Optics () where
57+module Data.Swagger.Optics () where
102
58
103import Data.Aeson (Value)
59import Data.Aeson (Value)
104import Data.Scientific (Scientific)
60import Data.Scientific (Scientific)
105−import Data.OpenApi.Internal
61+import Data.Swagger.Internal
106−import Data.OpenApi.Internal.Utils
107import Data.Text (Text)
62import Data.Text (Text)
108import Optics.Core
63import Optics.Core
109import Optics.TH
64import Optics.TH
110
65
111-- Lenses
66-- Lenses
112
67
113−makeFieldLabels ''OpenApi
68+makeFieldLabels ''Swagger
114makeFieldLabels ''Components
69makeFieldLabels ''Components
115makeFieldLabels ''Server
70makeFieldLabels ''Server
116makeFieldLabels ''ServerVariable
71makeFieldLabels ''ServerVariable
@@ -148,30 +103,30 @@ makeFieldLabels ''Link
148makePrismLabels ''SecuritySchemeType
103makePrismLabels ''SecuritySchemeType
149makePrismLabels ''Referenced
104makePrismLabels ''Referenced
150
105
151−-- OpenApiItems prisms
106+-- SwaggerItems prisms
152
107
153instance
108instance
154 ( a ~ [Referenced Schema]
109 ( a ~ [Referenced Schema]
155 , b ~ [Referenced Schema]
110 , b ~ [Referenced Schema]
156− ) => LabelOptic "_OpenApiItemsArray"
111+ ) => LabelOptic "_SwaggerItemsArray"
157 A_Review
112 A_Review
158− OpenApiItems
113+ SwaggerItems
159− OpenApiItems
114+ SwaggerItems
160 a
115 a
161 b where
116 b where
162− labelOptic = unto (\x -> OpenApiItemsArray x)
117+ labelOptic = unto (\x -> SwaggerItemsArray x)
163 {-# INLINE labelOptic #-}
118 {-# INLINE labelOptic #-}
164
119
165instance
120instance
166 ( a ~ Referenced Schema
121 ( a ~ Referenced Schema
167 , b ~ Referenced Schema
122 , b ~ Referenced Schema
168− ) => LabelOptic "_OpenApiItemsObject"
123+ ) => LabelOptic "_SwaggerItemsObject"
169 A_Review
124 A_Review
170− OpenApiItems
125+ SwaggerItems
171− OpenApiItems
126+ SwaggerItems
172 a
127 a
173 b where
128 b where
174− labelOptic = unto (\x -> OpenApiItemsObject x)
129+ labelOptic = unto (\x -> SwaggerItemsObject x)
175 {-# INLINE labelOptic #-}
130 {-# INLINE labelOptic #-}
176
131
177-- =============================================================
132-- =============================================================
@@ -200,8 +155,8 @@ instance At Operation where
200-- #type
155-- #type
201
156
202instance
157instance
203− ( a ~ Maybe OpenApiType
158+ ( a ~ Maybe SwaggerType
204− , b ~ Maybe OpenApiType
159+ , b ~ Maybe SwaggerType
205 ) => LabelOptic "type" A_Lens NamedSchema NamedSchema a b where
160 ) => LabelOptic "type" A_Lens NamedSchema NamedSchema a b where
206 labelOptic = #schema % #type
161 labelOptic = #schema % #type
207 {-# INLINE labelOptic #-}
162 {-# INLINE labelOptic #-}
@@ -225,8 +180,8 @@ instance
225-- #items
180-- #items
226
181
227instance
182instance
228− ( a ~ Maybe OpenApiItems
183+ ( a ~ Maybe SwaggerItems
229− , b ~ Maybe OpenApiItems
184+ , b ~ Maybe SwaggerItems
230 ) => LabelOptic "items" A_Lens NamedSchema NamedSchema a b where
185 ) => LabelOptic "items" A_Lens NamedSchema NamedSchema a b where
231 labelOptic = #schema % #items
186 labelOptic = #schema % #items
232 {-# INLINE labelOptic #-}
187 {-# INLINE labelOptic #-}
src/Data/OpenApi/ParamSchema.hs → src/Data/Swagger/ParamSchema.hsrenamed+4−4
@@ -1,10 +1,10 @@
1-- |
1-- |
2−-- Module: Data.OpenApi.ParamSchema
2+-- Module: Data.Swagger.ParamSchema
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
4-- Stability: experimental
4-- Stability: experimental
5--
5--
6-- Types and functions for working with Swagger parameter schema.
6-- Types and functions for working with Swagger parameter schema.
7−module Data.OpenApi.ParamSchema (
7+module Data.Swagger.ParamSchema (
8 -- * Encoding
8 -- * Encoding
9 ToParamSchema(..),
9 ToParamSchema(..),
10
10
@@ -22,5 +22,5 @@ module Data.OpenApi.ParamSchema (
22 defaultSchemaOptions,
22 defaultSchemaOptions,
23) where
23) where
24
24
25−import Data.OpenApi.Internal.ParamSchema
25+import Data.Swagger.Internal.ParamSchema
26−import Data.OpenApi.SchemaOptions
26+import Data.Swagger.SchemaOptions
src/Data/OpenApi/Schema.hs → src/Data/Swagger/Schema.hsrenamed+4−4
@@ -1,10 +1,10 @@
1-- |
1-- |
2−-- Module: Data.OpenApi.Schema
2+-- Module: Data.Swagger.Schema
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
4-- Stability: experimental
4-- Stability: experimental
5--
5--
6-- Types and functions for working with Swagger schema.
6-- Types and functions for working with Swagger schema.
7−module Data.OpenApi.Schema (
7+module Data.Swagger.Schema (
8 -- * Encoding
8 -- * Encoding
9 ToSchema(..),
9 ToSchema(..),
10 declareSchema,
10 declareSchema,
@@ -48,5 +48,5 @@ module Data.OpenApi.Schema (
48 fromAesonOptions,
48 fromAesonOptions,
49) where
49) where
50
50
51−import Data.OpenApi.Internal.Schema
51+import Data.Swagger.Internal.Schema
52−import Data.OpenApi.SchemaOptions
52+import Data.Swagger.SchemaOptions
src/Data/OpenApi/Schema/Generator.hs → src/Data/Swagger/Schema/Generator.hsrenamed+14−16
@@ -2,7 +2,7 @@
2{-# LANGUAGE OverloadedLists #-}
2{-# LANGUAGE OverloadedLists #-}
3{-# LANGUAGE ScopedTypeVariables #-}
3{-# LANGUAGE ScopedTypeVariables #-}
4
4
5−module Data.OpenApi.Schema.Generator where
5+module Data.Swagger.Schema.Generator where
6
6
7import Prelude ()
7import Prelude ()
8import Prelude.Compat
8import Prelude.Compat
@@ -16,17 +16,15 @@ import Data.Maybe
16import Data.Proxy
16import Data.Proxy
17import Data.Scientific
17import Data.Scientific
18import qualified Data.Set as S
18import qualified Data.Set as S
19−import Data.OpenApi
19+import Data.Swagger
20−import Data.OpenApi.Declare
20+import Data.Swagger.Declare
21−import Data.OpenApi.Internal.Schema.Validation (inferSchemaTypes)
21+import Data.Swagger.Internal.Schema.Validation (inferSchemaTypes)
22import qualified Data.Text as T
22import qualified Data.Text as T
23import qualified Data.Vector as V
23import qualified Data.Vector as V
24import Test.QuickCheck (arbitrary)
24import Test.QuickCheck (arbitrary)
25import Test.QuickCheck.Gen
25import Test.QuickCheck.Gen
26import Test.QuickCheck.Property
26import Test.QuickCheck.Property
27
27
28−import Data.OpenApi.Aeson.Compat (fromInsOrdHashMap)
29−
30-- | Note: 'schemaGen' may 'error', if schema type is not specified,
28-- | Note: 'schemaGen' may 'error', if schema type is not specified,
31-- and cannot be inferred.
29-- and cannot be inferred.
32schemaGen :: Definitions Schema -> Schema -> Gen Value
30schemaGen :: Definitions Schema -> Schema -> Gen Value
@@ -41,25 +39,25 @@ schemaGen defns schema =
41 [ inferredType ] -> schemaGen defns (schema & type_ ?~ inferredType)
39 [ inferredType ] -> schemaGen defns (schema & type_ ?~ inferredType)
42 -- Gen is not MonadFail
40 -- Gen is not MonadFail
43 _ -> error "unable to infer schema type"
41 _ -> error "unable to infer schema type"
44− Just OpenApiBoolean -> Bool <$> elements [True, False]
42+ Just SwaggerBoolean -> Bool <$> elements [True, False]
45− Just OpenApiNull -> pure Null
43+ Just SwaggerNull -> pure Null
46− Just OpenApiNumber
44+ Just SwaggerNumber
47 | Just min <- schema ^. minimum_
45 | Just min <- schema ^. minimum_
48 , Just max <- schema ^. maximum_ ->
46 , Just max <- schema ^. maximum_ ->
49 Number . fromFloatDigits <$>
47 Number . fromFloatDigits <$>
50 choose (toRealFloat min, toRealFloat max :: Double)
48 choose (toRealFloat min, toRealFloat max :: Double)
51 | otherwise -> Number .fromFloatDigits <$> (arbitrary :: Gen Double)
49 | otherwise -> Number .fromFloatDigits <$> (arbitrary :: Gen Double)
52− Just OpenApiInteger
50+ Just SwaggerInteger
53 | Just min <- schema ^. minimum_
51 | Just min <- schema ^. minimum_
54 , Just max <- schema ^. maximum_ ->
52 , Just max <- schema ^. maximum_ ->
55 Number . fromInteger <$>
53 Number . fromInteger <$>
56 choose (truncate min, truncate max)
54 choose (truncate min, truncate max)
57 | otherwise -> Number . fromInteger <$> arbitrary
55 | otherwise -> Number . fromInteger <$> arbitrary
58− Just OpenApiArray
56+ Just SwaggerArray
59 | Just 0 <- schema ^. maxLength -> pure $ Array V.empty
57 | Just 0 <- schema ^. maxLength -> pure $ Array V.empty
60 | Just items <- schema ^. items ->
58 | Just items <- schema ^. items ->
61 case items of
59 case items of
62− OpenApiItemsObject ref -> do
60+ SwaggerItemsObject ref -> do
63 size <- getSize
61 size <- getSize
64 let itemSchema = dereference defns ref
62 let itemSchema = dereference defns ref
65 minLength' = fromMaybe 0 $ fromInteger <$> schema ^. minItems
63 minLength' = fromMaybe 0 $ fromInteger <$> schema ^. minItems
@@ -67,17 +65,17 @@ schemaGen defns schema =
67 arrayLength <- choose (minLength', max minLength' maxLength')
65 arrayLength <- choose (minLength', max minLength' maxLength')
68 generatedArray <- vectorOf arrayLength $ schemaGen defns itemSchema
66 generatedArray <- vectorOf arrayLength $ schemaGen defns itemSchema
69 return . Array $ V.fromList generatedArray
67 return . Array $ V.fromList generatedArray
70− OpenApiItemsArray refs ->
68+ SwaggerItemsArray refs ->
71 let itemGens = schemaGen defns . dereference defns <$> refs
69 let itemGens = schemaGen defns . dereference defns <$> refs
72 in fmap (Array . V.fromList) $ sequence itemGens
70 in fmap (Array . V.fromList) $ sequence itemGens
73− Just OpenApiString -> do
71+ Just SwaggerString -> do
74 size <- getSize
72 size <- getSize
75 let minLength' = fromMaybe 0 $ fromInteger <$> schema ^. minLength
73 let minLength' = fromMaybe 0 $ fromInteger <$> schema ^. minLength
76 let maxLength' = fromMaybe size $ fromInteger <$> schema ^. maxLength
74 let maxLength' = fromMaybe size $ fromInteger <$> schema ^. maxLength
77 length <- choose (minLength', max minLength' maxLength')
75 length <- choose (minLength', max minLength' maxLength')
78 str <- vectorOf length arbitrary
76 str <- vectorOf length arbitrary
79 return . String $ T.pack str
77 return . String $ T.pack str
80− Just OpenApiObject -> do
78+ Just SwaggerObject -> do
81 size <- getSize
79 size <- getSize
82 let props = dereference defns <$> schema ^. properties
80 let props = dereference defns <$> schema ^. properties
83 reqKeys = S.fromList $ schema ^. required
81 reqKeys = S.fromList $ schema ^. required
@@ -97,7 +95,7 @@ schemaGen defns schema =
97 return . M.fromList $ zip additionalKeys (repeat . schemaGen defns $ dereference defns addlSchema)
95 return . M.fromList $ zip additionalKeys (repeat . schemaGen defns $ dereference defns addlSchema)
98 _ -> return []
96 _ -> return []
99 x <- sequence $ gens <> additionalGens
97 x <- sequence $ gens <> additionalGens
100− return . Object $ fromInsOrdHashMap x
98+ return . Object $ M.toHashMap x
101
99
102dereference :: Definitions a -> Referenced a -> a
100dereference :: Definitions a -> Referenced a -> a
103dereference _ (Inline a) = a
101dereference _ (Inline a) = a
src/Data/OpenApi/Schema/Validation.hs → src/Data/Swagger/Schema/Validation.hsrenamed+7−7
@@ -1,10 +1,10 @@
1-- |
1-- |
2−-- Module: Data.OpenApi.Schema.Validation
2+-- Module: Data.Swagger.Schema.Validation
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
3-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
4-- Stability: experimental
4-- Stability: experimental
5--
5--
6-- Validate JSON values with Swagger Schema.
6-- Validate JSON values with Swagger Schema.
7−module Data.OpenApi.Schema.Validation (
7+module Data.Swagger.Schema.Validation (
8 -- * How to use validation
8 -- * How to use validation
9 -- $howto
9 -- $howto
10
10
@@ -29,13 +29,13 @@ module Data.OpenApi.Schema.Validation (
29 validateJSONWithPatternChecker,
29 validateJSONWithPatternChecker,
30) where
30) where
31
31
32−import Data.OpenApi.Internal.Schema.Validation
32+import Data.Swagger.Internal.Schema.Validation
33
33
34-- $setup
34-- $setup
35-- >>> import Control.Lens
35-- >>> import Control.Lens
36-- >>> import Data.Aeson
36-- >>> import Data.Aeson
37-- >>> import Data.Proxy
37-- >>> import Data.Proxy
38−-- >>> import Data.OpenApi
38+-- >>> import Data.Swagger
39-- >>> import GHC.Generics
39-- >>> import GHC.Generics
40-- >>> :set -XDeriveGeneric
40-- >>> :set -XDeriveGeneric
41
41
@@ -71,11 +71,11 @@ import Data.OpenApi.Internal.Schema.Validation
71-- generally fails for @null@ JSON:
71-- generally fails for @null@ JSON:
72--
72--
73-- >>> validateToJSON (Nothing :: Maybe String)
73-- >>> validateToJSON (Nothing :: Maybe String)
74−-- ["expected JSON value of type OpenApiString"]
74+-- ["expected JSON value of type SwaggerString"]
75-- >>> validateToJSON ([Just "hello", Nothing] :: [Maybe String])
75-- >>> validateToJSON ([Just "hello", Nothing] :: [Maybe String])
76−-- ["expected JSON value of type OpenApiString"]
76+-- ["expected JSON value of type SwaggerString"]
77-- >>> validateToJSON (123, Nothing :: Maybe String)
77-- >>> validateToJSON (123, Nothing :: Maybe String)
78−-- ["expected JSON value of type OpenApiString"]
78+-- ["expected JSON value of type SwaggerString"]
79--
79--
80-- However, when @'Maybe' a@ is a type of a record field,
80-- However, when @'Maybe' a@ is a type of a record field,
81-- validation takes @'required'@ property of the @'Schema'@
81-- validation takes @'required'@ property of the @'Schema'@
src/Data/OpenApi/SchemaOptions.hs → src/Data/Swagger/SchemaOptions.hsrenamed+2−2
@@ -1,11 +1,11 @@
1{-# LANGUAGE RecordWildCards #-}
1{-# LANGUAGE RecordWildCards #-}
2-- |
2-- |
3−-- Module: Data.OpenApi.SchemaOptions
3+-- Module: Data.Swagger.SchemaOptions
4-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
4-- Maintainer: Nickolay Kudasov <nickolay@getshoptv.com>
5-- Stability: experimental
5-- Stability: experimental
6--
6--
7-- Generic deriving options for @'ToParamSchema'@ and @'ToSchema'@.
7-- Generic deriving options for @'ToParamSchema'@ and @'ToSchema'@.
8−module Data.OpenApi.SchemaOptions where
8+module Data.Swagger.SchemaOptions where
9
9
10import qualified Data.Aeson.Types as Aeson
10import qualified Data.Aeson.Types as Aeson
11
11
stack.yaml+1−1
@@ -1,4 +1,4 @@
1−resolver: lts-16.31
1+resolver: lts-15.1
2packages:
2packages:
3- '.'
3- '.'
4extra-deps:
4extra-deps:
test/Data/OpenApi/CommonTestTypes.hs → test/Data/Swagger/CommonTestTypes.hsrenamed+2−125
@@ -2,7 +2,7 @@
2{-# LANGUAGE QuasiQuotes #-}
2{-# LANGUAGE QuasiQuotes #-}
3{-# LANGUAGE ScopedTypeVariables #-}
3{-# LANGUAGE ScopedTypeVariables #-}
4
4
5−module Data.OpenApi.CommonTestTypes where
5+module Data.Swagger.CommonTestTypes where
6
6
7import Prelude ()
7import Prelude ()
8import Prelude.Compat
8import Prelude.Compat
@@ -18,7 +18,7 @@ import qualified Data.Text as Text
18import Data.Word
18import Data.Word
19import GHC.Generics
19import GHC.Generics
20
20
21−import Data.OpenApi
21+import Data.Swagger
22
22
23-- ========================================================================
23-- ========================================================================
24-- Unit type
24-- Unit type
@@ -863,129 +863,6 @@ singleMaybeFieldSchemaJSON = [aesonQQ|
863}
863}
864|]
864|]
865
865
866−-- ========================================================================
867−-- Natural Language (single field data with recursive fields)
868−-- ========================================================================
869−
870−data Predicate
871− = PredicateNoun Noun
872− | PredicateOmitted Omitted
873− deriving (Eq, Ord, Read, Show, Generic)
874−instance ToJSON Predicate
875−instance ToSchema Predicate
876−
877−data Noun
878− = Noun
879− { nounSurf :: LangWord
880− , nounModify :: [Modifier]
881− }
882− deriving (Eq, Ord, Read, Show, Generic)
883−instance ToJSON Noun
884−instance ToSchema Noun
885−
886−data LangWord
887− = LangWord
888− { langWordSurf :: String
889− , langWordBase :: String
890− }
891− deriving (Eq, Ord, Read, Show, Generic)
892−instance ToJSON LangWord
893−instance ToSchema LangWord
894−
895−data Modifier
896− = ModifierNoun Noun
897− | ModifierOmitted Omitted
898− deriving (Eq, Ord, Read, Show, Generic)
899−instance ToJSON Modifier
900−instance ToSchema Modifier
901−
902−newtype Omitted
903− = Omitted
904− { omittedModify :: [Modifier]
905− }
906− deriving (Eq, Ord, Read, Show, Generic)
907−instance ToJSON Omitted
908−instance ToSchema Omitted
909−
910−predicateSchemaDeclareJSON :: Value
911−predicateSchemaDeclareJSON = [aesonQQ|
912−[
913− {
914− "Predicate": {
915− "oneOf": [
916− {
917− "properties": {
918− "contents": { "$ref": "#/components/schemas/Noun" },
919− "tag": { "enum": ["PredicateNoun"], "type": "string" }
920− },
921− "required": ["tag", "contents"],
922− "type": "object"
923− },
924− {
925− "properties": {
926− "contents": { "$ref": "#/components/schemas/Omitted" },
927− "tag": { "enum": ["PredicateOmitted"], "type": "string" }
928− },
929− "required": ["tag", "contents"],
930− "type": "object"
931− }
932− ],
933− "type": "object"
934− },
935− "Noun": {
936− "properties": {
937− "nounModify": {
938− "items": { "$ref": "#/components/schemas/Modifier" },
939− "type": "array"
940− },
941− "nounSurf": { "$ref": "#/components/schemas/LangWord" }
942− },
943− "required": ["nounSurf", "nounModify"],
944− "type": "object"
945− },
946− "LangWord": {
947− "properties": {
948− "langWordBase": { "type": "string" },
949− "langWordSurf": { "type": "string" }
950− },
951− "required": ["langWordSurf", "langWordBase"],
952− "type": "object"
953− },
954− "Modifier": {
955− "oneOf": [
956− {
957− "properties": {
958− "contents": { "$ref": "#/components/schemas/Noun" },
959− "tag": { "enum": ["ModifierNoun"], "type": "string" }
960− },
961− "required": ["tag", "contents"],
962− "type": "object"
963− },
964− {
965− "properties": {
966− "contents": { "$ref": "#/components/schemas/Omitted" },
967− "tag": { "enum": ["ModifierOmitted"], "type": "string" }
968− },
969− "required": ["tag", "contents"],
970− "type": "object"
971− }
972− ],
973− "type": "object"
974− },
975− "Omitted": {
976− "properties": {
977− "omittedModify": {
978− "items": { "$ref": "#/components/schemas/Modifier" },
979− "type": "array"
980− }
981− },
982− "required": ["omittedModify"],
983− "type": "object"
984− }
985− },
986− { "$ref": "#/components/schemas/Predicate" }
987−]
988−|]
989
866
990-- ========================================================================
867-- ========================================================================
991-- TimeOfDay
868-- TimeOfDay
test/Data/OpenApi/ParamSchemaSpec.hs → test/Data/Swagger/ParamSchemaSpec.hsrenamed+3−3
@@ -4,7 +4,7 @@
4{-# LANGUAGE TemplateHaskell #-}
4{-# LANGUAGE TemplateHaskell #-}
5{-# LANGUAGE QuasiQuotes #-}
5{-# LANGUAGE QuasiQuotes #-}
6{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE OverloadedStrings #-}
7−module Data.OpenApi.ParamSchemaSpec where
7+module Data.Swagger.ParamSchemaSpec where
8
8
9import Data.Aeson
9import Data.Aeson
10import Data.Aeson.QQ.Simple
10import Data.Aeson.QQ.Simple
@@ -12,9 +12,9 @@ import Data.Char
12import Data.Proxy
12import Data.Proxy
13import GHC.Generics
13import GHC.Generics
14
14
15−import Data.OpenApi
15+import Data.Swagger
16
16
17−import Data.OpenApi.CommonTestTypes
17+import Data.Swagger.CommonTestTypes
18import SpecCommon
18import SpecCommon
19import Test.Hspec
19import Test.Hspec
20import Data.Time.LocalTime
20import Data.Time.LocalTime
test/Data/OpenApi/Schema/GeneratorSpec.hs → test/Data/Swagger/Schema/GeneratorSpec.hsrenamed+7−7
@@ -1,13 +1,13 @@
1{-# LANGUAGE OverloadedLists #-}
1{-# LANGUAGE OverloadedLists #-}
2{-# LANGUAGE OverloadedStrings #-}
2{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE PackageImports #-}
3{-# LANGUAGE PackageImports #-}
4−module Data.OpenApi.Schema.GeneratorSpec where
4+module Data.Swagger.Schema.GeneratorSpec where
5
5
6import Prelude ()
6import Prelude ()
7import Prelude.Compat
7import Prelude.Compat
8
8
9−import Data.OpenApi
9+import Data.Swagger
10−import Data.OpenApi.Schema.Generator
10+import Data.Swagger.Schema.Generator
11
11
12import Control.Lens.Operators
12import Control.Lens.Operators
13import Data.Aeson
13import Data.Aeson
@@ -103,7 +103,7 @@ instance FromJSON WrongType where
103instance ToSchema WrongType where
103instance ToSchema WrongType where
104 declareNamedSchema _ = return . NamedSchema (Just "WrongType") $
104 declareNamedSchema _ = return . NamedSchema (Just "WrongType") $
105 mempty
105 mempty
106− & type_ ?~ OpenApiObject
106+ & type_ ?~ SwaggerObject
107
107
108
108
109data MissingRequired = MissingRequired
109data MissingRequired = MissingRequired
@@ -123,7 +123,7 @@ instance ToSchema MissingRequired where
123 boolSchema <- declareSchemaRef (Proxy :: Proxy Bool)
123 boolSchema <- declareSchemaRef (Proxy :: Proxy Bool)
124 return . NamedSchema (Just "MissingRequired") $
124 return . NamedSchema (Just "MissingRequired") $
125 mempty
125 mempty
126− & type_ ?~ OpenApiObject
126+ & type_ ?~ SwaggerObject
127 & properties .~ [("propA", stringSchema)
127 & properties .~ [("propA", stringSchema)
128 ,("propB", boolSchema)
128 ,("propB", boolSchema)
129 ]
129 ]
@@ -145,7 +145,7 @@ instance ToSchema MissingProperty where
145 stringSchema <- declareSchemaRef (Proxy :: Proxy String)
145 stringSchema <- declareSchemaRef (Proxy :: Proxy String)
146 return . NamedSchema (Just "MissingProperty") $
146 return . NamedSchema (Just "MissingProperty") $
147 mempty
147 mempty
148− & type_ ?~ OpenApiObject
148+ & type_ ?~ SwaggerObject
149 & properties .~ [("propC", stringSchema)]
149 & properties .~ [("propC", stringSchema)]
150 & required .~ ["propC"]
150 & required .~ ["propC"]
151
151
@@ -163,6 +163,6 @@ instance ToSchema WrongPropType where
163 boolSchema <- declareSchemaRef (Proxy :: Proxy Bool)
163 boolSchema <- declareSchemaRef (Proxy :: Proxy Bool)
164 return . NamedSchema (Just "WrongPropType") $
164 return . NamedSchema (Just "WrongPropType") $
165 mempty
165 mempty
166− & type_ ?~ OpenApiObject
166+ & type_ ?~ SwaggerObject
167 & properties .~ [("propE", boolSchema)]
167 & properties .~ [("propE", boolSchema)]
168 & required .~ ["propE"]
168 & required .~ ["propE"]
test/Data/OpenApi/Schema/ValidationSpec.hs → test/Data/Swagger/Schema/ValidationSpec.hsrenamed+10−27
@@ -1,18 +1,13 @@
1−{-# LANGUAGE CPP #-}
2{-# LANGUAGE DeriveGeneric #-}
1{-# LANGUAGE DeriveGeneric #-}
3{-# LANGUAGE PackageImports #-}
2{-# LANGUAGE PackageImports #-}
4{-# LANGUAGE RecordWildCards #-}
3{-# LANGUAGE RecordWildCards #-}
5{-# LANGUAGE ScopedTypeVariables #-}
4{-# LANGUAGE ScopedTypeVariables #-}
6{-# OPTIONS_GHC -fno-warn-orphans #-}
5{-# OPTIONS_GHC -fno-warn-orphans #-}
7−module Data.OpenApi.Schema.ValidationSpec where
6+module Data.Swagger.Schema.ValidationSpec where
8
7
9import Control.Applicative
8import Control.Applicative
10import Control.Lens ((&), (.~), (?~))
9import Control.Lens ((&), (.~), (?~))
11import Data.Aeson
10import Data.Aeson
12−#if MIN_VERSION_aeson(2,0,0)
13−import qualified Data.Aeson.Key as Key
14−import qualified Data.Aeson.KeyMap as KeyMap
15−#endif
16import Data.Aeson.Types
11import Data.Aeson.Types
17import Data.Hashable (Hashable)
12import Data.Hashable (Hashable)
18import Data.HashMap.Strict (HashMap)
13import Data.HashMap.Strict (HashMap)
@@ -33,9 +28,8 @@ import Data.Version (Version)
33import Data.Word
28import Data.Word
34import GHC.Generics
29import GHC.Generics
35
30
36−import Data.OpenApi
31+import Data.Swagger
37−import Data.OpenApi.Declare
32+import Data.Swagger.Declare
38−import Data.OpenApi.Aeson.Compat (stringToKey)
39
33
40import Test.Hspec
34import Test.Hspec
41import Test.Hspec.QuickCheck
35import Test.Hspec.QuickCheck
@@ -130,9 +124,9 @@ instance Arbitrary Person where
130
124
131invalidPersonToJSON :: Person -> Value
125invalidPersonToJSON :: Person -> Value
132invalidPersonToJSON Person{..} = object
126invalidPersonToJSON Person{..} = object
133− [ stringToKey "personName" .= toJSON name
127+ [ T.pack "personName" .= toJSON name
134− , stringToKey "personPhone" .= toJSON phone
128+ , T.pack "personPhone" .= toJSON phone
135− , stringToKey "personEmail" .= toJSON email
129+ , T.pack "personEmail" .= toJSON email
136 ]
130 ]
137
131
138-- ========================================================================
132-- ========================================================================
@@ -196,7 +190,7 @@ instance Arbitrary MyRoseTree where
196data Light = NoLight | LightFreq Double | LightColor Color deriving (Show, Generic)
190data Light = NoLight | LightFreq Double | LightColor Color deriving (Show, Generic)
197
191
198instance ToSchema Light where
192instance ToSchema Light where
199− declareNamedSchema = genericDeclareNamedSchema defaultSchemaOptions { Data.OpenApi.sumEncoding = ObjectWithSingleField }
193+ declareNamedSchema = genericDeclareNamedSchema defaultSchemaOptions { Data.Swagger.sumEncoding = ObjectWithSingleField }
200
194
201instance ToJSON Light where
195instance ToJSON Light where
202 toJSON = genericToJSON defaultOptions { Data.Aeson.Types.sumEncoding = ObjectWithSingleField }
196 toJSON = genericToJSON defaultOptions { Data.Aeson.Types.sumEncoding = ObjectWithSingleField }
@@ -221,7 +215,7 @@ instance ToJSON LightTaggedObject where
221
215
222instance ToSchema LightTaggedObject where
216instance ToSchema LightTaggedObject where
223 declareNamedSchema _ =
217 declareNamedSchema _ =
224− genericDeclareNamedSchema defaultSchemaOptions { Data.OpenApi.sumEncoding = defaultTaggedObject } (Proxy :: Proxy Light)
218+ genericDeclareNamedSchema defaultSchemaOptions { Data.Swagger.sumEncoding = defaultTaggedObject } (Proxy :: Proxy Light)
225
219
226instance Arbitrary LightTaggedObject where
220instance Arbitrary LightTaggedObject where
227 arbitrary = LightTaggedObject <$> arbitrary
221 arbitrary = LightTaggedObject <$> arbitrary
@@ -234,7 +228,7 @@ instance ToJSON LightUntaggedValue where
234
228
235instance ToSchema LightUntaggedValue where
229instance ToSchema LightUntaggedValue where
236 declareNamedSchema _ =
230 declareNamedSchema _ =
237− genericDeclareNamedSchema defaultSchemaOptions { Data.OpenApi.sumEncoding = UntaggedValue } (Proxy :: Proxy Light)
231+ genericDeclareNamedSchema defaultSchemaOptions { Data.Swagger.sumEncoding = UntaggedValue } (Proxy :: Proxy Light)
238
232
239instance Arbitrary LightUntaggedValue where
233instance Arbitrary LightUntaggedValue where
240 arbitrary = LightUntaggedValue <$> arbitrary
234 arbitrary = LightUntaggedValue <$> arbitrary
@@ -283,7 +277,7 @@ instance ToJSON FreeForm where
283
277
284instance ToSchema FreeForm where
278instance ToSchema FreeForm where
285 declareNamedSchema _ = pure $ NamedSchema (Just $ T.pack "FreeForm") $ mempty
279 declareNamedSchema _ = pure $ NamedSchema (Just $ T.pack "FreeForm") $ mempty
286− & type_ ?~ OpenApiObject
280+ & type_ ?~ SwaggerObject
287 & additionalProperties ?~ AdditionalPropertiesAllowed True
281 & additionalProperties ?~ AdditionalPropertiesAllowed True
288
282
289instance Arbitrary FreeForm where
283instance Arbitrary FreeForm where
@@ -301,8 +295,6 @@ instance Eq ZonedTime where
301-- Arbitrary instance for Data.Aeson.Value
295-- Arbitrary instance for Data.Aeson.Value
302-- ========================================================================
296-- ========================================================================
303
297
304−-- These instances were introduces in aeson upstream in 2.0.3
305−#if !MIN_VERSION_aeson(2,0,3)
306instance Arbitrary Value where
298instance Arbitrary Value where
307 -- Weights are almost random
299 -- Weights are almost random
308 -- Uniform oneof tends not to build complex objects cause of recursive call.
300 -- Uniform oneof tends not to build complex objects cause of recursive call.
@@ -313,12 +305,3 @@ instance Arbitrary Value where
313 , (3, Number <$> arbitrary)
305 , (3, Number <$> arbitrary)
314 , (3, Bool <$> arbitrary)
306 , (3, Bool <$> arbitrary)
315 , (1, return Null) ]
307 , (1, return Null) ]
316−
317−#if MIN_VERSION_aeson(2,0,0)
318−instance Arbitrary v => Arbitrary (KeyMap.KeyMap v) where
319− arbitrary = KeyMap.fromList <$> arbitrary
320−
321−instance Arbitrary Key.Key where
322− arbitrary = Key.fromText <$> arbitrary
323−#endif
324−#endif
test/Data/OpenApi/SchemaSpec.hs → test/Data/Swagger/SchemaSpec.hsrenamed+4−8
@@ -2,7 +2,7 @@
2{-# LANGUAGE ScopedTypeVariables #-}
2{-# LANGUAGE ScopedTypeVariables #-}
3{-# LANGUAGE TemplateHaskell #-}
3{-# LANGUAGE TemplateHaskell #-}
4{-# LANGUAGE QuasiQuotes #-}
4{-# LANGUAGE QuasiQuotes #-}
5−module Data.OpenApi.SchemaSpec where
5+module Data.Swagger.SchemaSpec where
6
6
7import Prelude ()
7import Prelude ()
8import Prelude.Compat
8import Prelude.Compat
@@ -14,10 +14,10 @@ import Data.Proxy
14import Data.Set (Set)
14import Data.Set (Set)
15import qualified Data.Text as Text
15import qualified Data.Text as Text
16
16
17−import Data.OpenApi
17+import Data.Swagger
18−import Data.OpenApi.Declare
18+import Data.Swagger.Declare
19
19
20−import Data.OpenApi.CommonTestTypes
20+import Data.Swagger.CommonTestTypes
21import SpecCommon
21import SpecCommon
22import Test.Hspec
22import Test.Hspec
23
23
@@ -59,9 +59,6 @@ checkInlinedRecSchema proxy js = inlineNonRecursiveSchemas defs s <=> js
59 where
59 where
60 (defs, s) = runDeclare (declareSchema proxy) mempty
60 (defs, s) = runDeclare (declareSchema proxy) mempty
61
61
62−checkToSchemaDeclare :: (HasCallStack, ToSchema a) => Proxy a -> Value -> Spec
63−checkToSchemaDeclare proxy js = runDeclare (declareSchemaRef proxy) mempty <=> js
64−
65spec :: Spec
62spec :: Spec
66spec = do
63spec = do
67 describe "Generic ToSchema" $ do
64 describe "Generic ToSchema" $ do
@@ -81,7 +78,6 @@ spec = do
81 context "UserId (non-record newtype)" $ checkToSchema (Proxy :: Proxy UserId) userIdSchemaJSON
78 context "UserId (non-record newtype)" $ checkToSchema (Proxy :: Proxy UserId) userIdSchemaJSON
82 context "Player (unary record)" $ checkToSchema (Proxy :: Proxy Player) playerSchemaJSON
79 context "Player (unary record)" $ checkToSchema (Proxy :: Proxy Player) playerSchemaJSON
83 context "SingleMaybeField (unary record with Maybe)" $ checkToSchema (Proxy :: Proxy SingleMaybeField) singleMaybeFieldSchemaJSON
80 context "SingleMaybeField (unary record with Maybe)" $ checkToSchema (Proxy :: Proxy SingleMaybeField) singleMaybeFieldSchemaJSON
84− context "Natural Language (single field data with recursive fields)" $ checkToSchemaDeclare (Proxy :: Proxy Predicate) predicateSchemaDeclareJSON
85 context "Players (inlining schema)" $ checkToSchema (Proxy :: Proxy Players) playersSchemaJSON
81 context "Players (inlining schema)" $ checkToSchema (Proxy :: Proxy Players) playersSchemaJSON
86 context "MyRoseTree (datatypeNameModifier)" $ checkToSchema (Proxy :: Proxy MyRoseTree) myRoseTreeSchemaJSON
82 context "MyRoseTree (datatypeNameModifier)" $ checkToSchema (Proxy :: Proxy MyRoseTree) myRoseTreeSchemaJSON
87 context "MyRoseTree' (datatypeNameModifier)" $ checkToSchema (Proxy :: Proxy MyRoseTree') myRoseTreeSchemaJSON'
83 context "MyRoseTree' (datatypeNameModifier)" $ checkToSchema (Proxy :: Proxy MyRoseTree') myRoseTreeSchemaJSON'
test/Data/OpenApiSpec.hs → test/Data/SwaggerSpec.hsrenamed+36−52
@@ -2,7 +2,7 @@
2{-# LANGUAGE OverloadedStrings #-}
2{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE ScopedTypeVariables #-}
3{-# LANGUAGE ScopedTypeVariables #-}
4{-# LANGUAGE QuasiQuotes #-}
4{-# LANGUAGE QuasiQuotes #-}
5−module Data.OpenApiSpec where
5+module Data.SwaggerSpec where
6
6
7import Prelude ()
7import Prelude ()
8import Prelude.Compat
8import Prelude.Compat
@@ -15,7 +15,7 @@ import Data.HashMap.Strict (HashMap)
15import qualified Data.HashSet.InsOrd as InsOrdHS
15import qualified Data.HashSet.InsOrd as InsOrdHS
16import Data.Text (Text)
16import Data.Text (Text)
17
17
18−import Data.OpenApi
18+import Data.Swagger
19import SpecCommon
19import SpecCommon
20import Test.Hspec hiding (example)
20import Test.Hspec hiding (example)
21
21
@@ -42,13 +42,9 @@ spec = do
42 context "Todo Example" $ swaggerExample <=> swaggerExampleJSON
42 context "Todo Example" $ swaggerExample <=> swaggerExampleJSON
43 context "PetStore Example" $ do
43 context "PetStore Example" $ do
44 it "decodes successfully" $ do
44 it "decodes successfully" $ do
45− fromJSON petstoreExampleJSON `shouldSatisfy` (\x -> case x of Success (_ :: OpenApi) -> True; _ -> False)
45+ fromJSON petstoreExampleJSON `shouldSatisfy` (\x -> case x of Success (_ :: Swagger) -> True; _ -> False)
46 it "roundtrips: fmap toJSON . fromJSON" $ do
46 it "roundtrips: fmap toJSON . fromJSON" $ do
47− (toJSON :: OpenApi -> Value) <$> fromJSON petstoreExampleJSON `shouldBe` Success petstoreExampleJSON
47+ (toJSON :: Swagger -> Value) <$> fromJSON petstoreExampleJSON `shouldBe` Success petstoreExampleJSON
48− context "Security schemes" $ do
49− it "merged correctly" $ do
50− let merged = oAuth2SecurityDefinitionsReadOpenApi <> oAuth2SecurityDefinitionsWriteOpenApi
51− merged `shouldBe` oAuth2SecurityDefinitionsOpenApi
52
48
53main :: IO ()
49main :: IO ()
54main = hspec spec
50main = hspec spec
@@ -136,15 +132,15 @@ operationExample = mempty
136 & description ?~ "ID of pet that needs to be updated"
132 & description ?~ "ID of pet that needs to be updated"
137 & required ?~ True
133 & required ?~ True
138 & in_ .~ ParamPath
134 & in_ .~ ParamPath
139− & schema ?~ Inline (mempty & type_ ?~ OpenApiString))]
135+ & schema ?~ Inline (mempty & type_ ?~ SwaggerString))]
140 & requestBody ?~ Inline (
136 & requestBody ?~ Inline (
141 mempty & content . at "application/x-www-form-urlencoded" ?~ (mempty & schema ?~ (Inline (mempty
137 mempty & content . at "application/x-www-form-urlencoded" ?~ (mempty & schema ?~ (Inline (mempty
142 & properties . at "petId" ?~ Inline (mempty
138 & properties . at "petId" ?~ Inline (mempty
143 & description ?~ "Updated name of the pet"
139 & description ?~ "Updated name of the pet"
144− & type_ ?~ OpenApiString)
140+ & type_ ?~ SwaggerString)
145 & properties . at "status" ?~ Inline (mempty
141 & properties . at "status" ?~ Inline (mempty
146 & description ?~ "Updated status of the pet"
142 & description ?~ "Updated status of the pet"
147− & type_ ?~ OpenApiString)))))
143+ & type_ ?~ SwaggerString)))))
148 & at 200 ?~ "Pet updated."
144 & at 200 ?~ "Pet updated."
149 & at 405 ?~ "Invalid input"
145 & at 405 ?~ "Invalid input"
150 & security .~ [SecurityRequirement [("petstore_auth", ["write:pets", "read:pets"])]]
146 & security .~ [SecurityRequirement [("petstore_auth", ["write:pets", "read:pets"])]]
@@ -212,7 +208,7 @@ operationExampleJSON = [aesonQQ|
212
208
213schemaPrimitiveExample :: Schema
209schemaPrimitiveExample :: Schema
214schemaPrimitiveExample = mempty
210schemaPrimitiveExample = mempty
215− & type_ ?~ OpenApiString
211+ & type_ ?~ SwaggerString
216 & format ?~ "email"
212 & format ?~ "email"
217
213
218schemaPrimitiveExampleJSON :: Value
214schemaPrimitiveExampleJSON :: Value
@@ -225,14 +221,14 @@ schemaPrimitiveExampleJSON = [aesonQQ|
225
221
226schemaSimpleModelExample :: Schema
222schemaSimpleModelExample :: Schema
227schemaSimpleModelExample = mempty
223schemaSimpleModelExample = mempty
228− & type_ ?~ OpenApiObject
224+ & type_ ?~ SwaggerObject
229 & required .~ [ "name" ]
225 & required .~ [ "name" ]
230 & properties .~
226 & properties .~
231− [ ("name", Inline (mempty & type_ ?~ OpenApiString))
227+ [ ("name", Inline (mempty & type_ ?~ SwaggerString))
232 , ("address", Ref (Reference "Address"))
228 , ("address", Ref (Reference "Address"))
233 , ("age", Inline $ mempty
229 , ("age", Inline $ mempty
234 & minimum_ ?~ 0
230 & minimum_ ?~ 0
235− & type_ ?~ OpenApiInteger
231+ & type_ ?~ SwaggerInteger
236 & format ?~ "int32" ) ]
232 & format ?~ "int32" ) ]
237
233
238schemaSimpleModelExampleJSON :: Value
234schemaSimpleModelExampleJSON :: Value
@@ -257,8 +253,8 @@ schemaSimpleModelExampleJSON = [aesonQQ|
257
253
258schemaModelDictExample :: Schema
254schemaModelDictExample :: Schema
259schemaModelDictExample = mempty
255schemaModelDictExample = mempty
260− & type_ ?~ OpenApiObject
256+ & type_ ?~ SwaggerObject
261− & additionalProperties ?~ AdditionalPropertiesSchema (Inline (mempty & type_ ?~ OpenApiString))
257+ & additionalProperties ?~ AdditionalPropertiesSchema (Inline (mempty & type_ ?~ SwaggerString))
262
258
263schemaModelDictExampleJSON :: Value
259schemaModelDictExampleJSON :: Value
264schemaModelDictExampleJSON = [aesonQQ|
260schemaModelDictExampleJSON = [aesonQQ|
@@ -272,7 +268,7 @@ schemaModelDictExampleJSON = [aesonQQ|
272
268
273schemaAdditionalExample :: Schema
269schemaAdditionalExample :: Schema
274schemaAdditionalExample = mempty
270schemaAdditionalExample = mempty
275− & type_ ?~ OpenApiObject
271+ & type_ ?~ SwaggerObject
276 & additionalProperties ?~ AdditionalPropertiesAllowed True
272 & additionalProperties ?~ AdditionalPropertiesAllowed True
277
273
278schemaAdditionalExampleJSON :: Value
274schemaAdditionalExampleJSON :: Value
@@ -285,13 +281,13 @@ schemaAdditionalExampleJSON = [aesonQQ|
285
281
286schemaWithExampleExample :: Schema
282schemaWithExampleExample :: Schema
287schemaWithExampleExample = mempty
283schemaWithExampleExample = mempty
288− & type_ ?~ OpenApiObject
284+ & type_ ?~ SwaggerObject
289 & properties .~
285 & properties .~
290 [ ("id", Inline $ mempty
286 [ ("id", Inline $ mempty
291− & type_ ?~ OpenApiInteger
287+ & type_ ?~ SwaggerInteger
292 & format ?~ "int64" )
288 & format ?~ "int64" )
293 , ("name", Inline $ mempty
289 , ("name", Inline $ mempty
294− & type_ ?~ OpenApiString) ]
290+ & type_ ?~ SwaggerString) ]
295 & required .~ [ "name" ]
291 & required .~ [ "name" ]
296 & example ?~ [aesonQQ|
292 & example ?~ [aesonQQ|
297 {
293 {
@@ -330,19 +326,19 @@ schemaWithExampleExampleJSON = [aesonQQ|
330definitionsExample :: HashMap Text Schema
326definitionsExample :: HashMap Text Schema
331definitionsExample =
327definitionsExample =
332 [ ("Category", mempty
328 [ ("Category", mempty
333− & type_ ?~ OpenApiObject
329+ & type_ ?~ SwaggerObject
334 & properties .~
330 & properties .~
335 [ ("id", Inline $ mempty
331 [ ("id", Inline $ mempty
336− & type_ ?~ OpenApiInteger
332+ & type_ ?~ SwaggerInteger
337 & format ?~ "int64")
333 & format ?~ "int64")
338− , ("name", Inline (mempty & type_ ?~ OpenApiString)) ] )
334+ , ("name", Inline (mempty & type_ ?~ SwaggerString)) ] )
339 , ("Tag", mempty
335 , ("Tag", mempty
340− & type_ ?~ OpenApiObject
336+ & type_ ?~ SwaggerObject
341 & properties .~
337 & properties .~
342 [ ("id", Inline $ mempty
338 [ ("id", Inline $ mempty
343− & type_ ?~ OpenApiInteger
339+ & type_ ?~ SwaggerInteger
344 & format ?~ "int64")
340 & format ?~ "int64")
345− , ("name", Inline (mempty & type_ ?~ OpenApiString)) ] ) ]
341+ , ("name", Inline (mempty & type_ ?~ SwaggerString)) ] ) ]
346
342
347definitionsExampleJSON :: Value
343definitionsExampleJSON :: Value
348definitionsExampleJSON = [aesonQQ|
344definitionsExampleJSON = [aesonQQ|
@@ -386,7 +382,7 @@ paramsDefinitionExample =
386 & required ?~ True
382 & required ?~ True
387 & in_ .~ ParamQuery
383 & in_ .~ ParamQuery
388 & schema ?~ Inline (mempty
384 & schema ?~ Inline (mempty
389− & type_ ?~ OpenApiInteger
385+ & type_ ?~ SwaggerInteger
390 & format ?~ "int32" ))
386 & format ?~ "int32" ))
391 , ("limitParam", mempty
387 , ("limitParam", mempty
392 & name .~ "limit"
388 & name .~ "limit"
@@ -394,7 +390,7 @@ paramsDefinitionExample =
394 & required ?~ True
390 & required ?~ True
395 & in_ .~ ParamQuery
391 & in_ .~ ParamQuery
396 & schema ?~ Inline (mempty
392 & schema ?~ Inline (mempty
397− & type_ ?~ OpenApiInteger
393+ & type_ ?~ SwaggerInteger
398 & format ?~ "int32" )) ]
394 & format ?~ "int32" )) ]
399
395
400paramsDefinitionExampleJSON :: Value
396paramsDefinitionExampleJSON :: Value
@@ -445,7 +441,7 @@ responsesDefinitionExampleJSON = [aesonQQ|
445|]
441|]
446
442
447-- =======================================================================
443-- =======================================================================
448−-- Security Definition object
444+-- Responses Definition object
449-- =======================================================================
445-- =======================================================================
450
446
451securityDefinitionsExample :: SecurityDefinitions
447securityDefinitionsExample :: SecurityDefinitions
@@ -531,23 +527,11 @@ oAuth2SecurityDefinitionsExampleJSON = [aesonQQ|
531}
527}
532|]
528|]
533
529
534−oAuth2SecurityDefinitionsReadOpenApi :: OpenApi
535−oAuth2SecurityDefinitionsReadOpenApi =
536− mempty & components . securitySchemes .~ oAuth2SecurityDefinitionsReadExample
537−
538−oAuth2SecurityDefinitionsWriteOpenApi :: OpenApi
539−oAuth2SecurityDefinitionsWriteOpenApi =
540− mempty & components . securitySchemes .~ oAuth2SecurityDefinitionsWriteExample
541−
542−oAuth2SecurityDefinitionsOpenApi :: OpenApi
543−oAuth2SecurityDefinitionsOpenApi =
544− mempty & components . securitySchemes .~ oAuth2SecurityDefinitionsExample
545−
546-- =======================================================================
530-- =======================================================================
547-- Swagger object
531-- Swagger object
548-- =======================================================================
532-- =======================================================================
549
533
550−emptyPathsFieldExample :: OpenApi
534+emptyPathsFieldExample :: Swagger
551emptyPathsFieldExample = mempty
535emptyPathsFieldExample = mempty
552
536
553emptyPathsFieldExampleJSON :: Value
537emptyPathsFieldExampleJSON :: Value
@@ -560,7 +544,7 @@ emptyPathsFieldExampleJSON = [aesonQQ|
560}
544}
561|]
545|]
562
546
563−swaggerExample :: OpenApi
547+swaggerExample :: Swagger
564swaggerExample = mempty
548swaggerExample = mempty
565 -- & basePath ?~ "/"
549 -- & basePath ?~ "/"
566 -- & schemes ?~ [Http]
550 -- & schemes ?~ [Http]
@@ -575,7 +559,7 @@ swaggerExample = mempty
575 & description .~ "OK"
559 & description .~ "OK"
576 & content . at "application/json" ?~ (mempty
560 & content . at "application/json" ?~ (mempty
577 & schema ?~ Inline (mempty
561 & schema ?~ Inline (mempty
578− & type_ ?~ OpenApiObject
562+ & type_ ?~ SwaggerObject
579 & example ?~ [aesonQQ|
563 & example ?~ [aesonQQ|
580 {
564 {
581 "created": 100,
565 "created": 100,
@@ -584,9 +568,9 @@ swaggerExample = mempty
584 & description ?~ "This is some real Todo right here"
568 & description ?~ "This is some real Todo right here"
585 & properties .~
569 & properties .~
586 [ ("created", Inline $ mempty
570 [ ("created", Inline $ mempty
587− & type_ ?~ OpenApiInteger
571+ & type_ ?~ SwaggerInteger
588 & format ?~ "int32")
572 & format ?~ "int32")
589− , ("description", Inline (mempty & type_ ?~ OpenApiString))])))
573+ , ("description", Inline (mempty & type_ ?~ SwaggerString))])))
590 & parameters .~
574 & parameters .~
591 [ Inline $ mempty
575 [ Inline $ mempty
592 & required ?~ True
576 & required ?~ True
@@ -594,7 +578,7 @@ swaggerExample = mempty
594 & description ?~ "TodoId param"
578 & description ?~ "TodoId param"
595 & in_ .~ ParamPath
579 & in_ .~ ParamPath
596 & schema ?~ Inline (mempty
580 & schema ?~ Inline (mempty
597− & type_ ?~ OpenApiString ) ]
581+ & type_ ?~ SwaggerString ) ]
598 & tags .~ InsOrdHS.fromList [ "todo" ] ))
582 & tags .~ InsOrdHS.fromList [ "todo" ] ))
599
583
600swaggerExampleJSON :: Value
584swaggerExampleJSON :: Value
@@ -933,14 +917,14 @@ petstoreExampleJSON = [aesonQQ|
933
917
934compositionSchemaExample :: Schema
918compositionSchemaExample :: Schema
935compositionSchemaExample = mempty
919compositionSchemaExample = mempty
936− & type_ ?~ OpenApiObject
920+ & type_ ?~ SwaggerObject
937− & Data.OpenApi.allOf ?~ [
921+ & Data.Swagger.allOf ?~ [
938 Ref (Reference "Other")
922 Ref (Reference "Other")
939 , Inline (mempty
923 , Inline (mempty
940− & type_ ?~ OpenApiObject
924+ & type_ ?~ SwaggerObject
941 & properties .~
925 & properties .~
942 [ ("greet", Inline $ mempty
926 [ ("greet", Inline $ mempty
943− & type_ ?~ OpenApiString) ])
927+ & type_ ?~ SwaggerString) ])
944 ]
928 ]
945
929
946compositionSchemaExampleJSON :: Value
930compositionSchemaExampleJSON :: Value
test/SpecCommon.hs+8
@@ -8,6 +8,14 @@ import qualified Data.Vector as Vector
8
8
9import Test.Hspec
9import Test.Hspec
10
10
11+isSubJSON :: Value -> Value -> Bool
12+isSubJSON Null _ = True
13+isSubJSON (Object x) (Object y) = HashMap.keys x == HashMap.keys i && F.and i
14+ where
15+ i = HashMap.intersectionWith isSubJSON x y
16+isSubJSON (Array xs) (Array ys) = Vector.length xs == Vector.length ys && F.and (Vector.zipWith isSubJSON xs ys)
17+isSubJSON x y = x == y
18+
11(<=>) :: (Eq a, Show a, ToJSON a, FromJSON a, HasCallStack) => a -> Value -> Spec
19(<=>) :: (Eq a, Show a, ToJSON a, FromJSON a, HasCallStack) => a -> Value -> Spec
12x <=> js = do
20x <=> js = do
13 it "encodes correctly" $ do
21 it "encodes correctly" $ do