Jar-packaged version of Swagger-UI for ring-based clojure web-apps (and other JVM apps).
Add the following dependency to your project.clj
file:
[metosin/ring-swagger-ui "2.0.17"]
and you have full Swagger-UI ready in /swagger-ui
on classpath.
You can override the index.html
-page by putting a new page into your local resources/swagger-ui
-directory.
The default URI for the api-docs is /api/api-docs
but this can be changed by copying resources/swagger-ui/conf.js
to your projects
resources dir and editing it.
You might also be interested in Ring-Swagger.
It provides a ring handler (ring.swagger.ui/swagger-ui
) which can be used to create ring handler to serve the Swagger-ui.
The handler will dynamically serve conf.js
with provided options so you can define api-docs path from Clojure.
Example using Compojure-api and setting custom urls for swagger-docs and swagger-ui.
(defapi app
(ring.swagger.ui/swagger-ui
"/swagger-ui"
:api-url "/swagger-docs")
(compojure.api.swagger/swagger-docs
"/swagger-docs"
:title "Sample Api"
:description "Compojure Api sample application")
...)
git submodule init
git submodule update
pushd ext/swagger-ui
git fetch
git checkout <new tag>
popd
git add ext/swagger-ui # Update submodule to point into new swagger-ui
vim project.clj README.md # Edit version
git add project.clj README.md
git commit -m "New version"
git tag -m "v2.y.z"
git push --tags origin master # Push new tags and master
lein do clean, install
Copyright 2011-2013 Wordnik, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Copyright © 2014 Metosin Oy
Distributed under the Eclipse Public License, the same as Clojure.
Can you improve this documentation? These fine people already did:
Tommi Reiman & Juho TeperiEdit on GitHub
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close