Commit graph

432 commits

Author SHA1 Message Date
Stig Brautaset
f4a8013388
Fix link to Jira in the documentation
The existing links didn't work for me, but the new links do.
2023-10-09 14:03:36 +01:00
Juho Teperi
15e0c95cb6 0.7.0-alpha7 2023-10-03 13:34:36 +03:00
Juho Teperi
d4a85c40e6 Revert group id change
Per discussions in Slack, changing the group id causes too much problems
2023-10-03 13:06:23 +03:00
Joel Kaasinen
35264dc130 doc: update all references metosin/reitit => fi.metosin/reitit 2023-09-11 11:04:36 +03:00
Joel Kaasinen
7352358662 feat: rename openapi :content-types keyword, split for req & resp 2023-09-08 15:17:35 +03:00
Joel Kaasinen
38547e4ad2 doc: update openapi & coercion docs 2023-08-28 15:44:16 +03:00
Tommi Reiman
b0c810a981
Merge pull request #628 from metosin/openapi-parameters
Openapi parameters
2023-08-24 09:25:46 +03:00
Tommi Reiman
81dfe45b72 fix example 2023-08-18 15:17:01 +03:00
Tommi Reiman
12f0970e39 fix example 2023-08-18 15:04:47 +03:00
Juho Teperi
4a182588b4 Release 0.7.0-alpha5 2023-06-14 16:06:20 +03:00
Tommi Reiman
b1404ada6d top-level :request coercion & stuff 2023-05-28 16:49:08 +03:00
Tommi Reiman
ce06214014 welcome 2-phase schema compilation
1) use `:update-paths` to handle data in certain (loose) paths differently
  - accumulate schemas in all relevant routers into vector
  - we do not know the coercion here (ring/http have special handling of data, e.g. http-methods)

2) run coercion compiler for the model to merge the effective model
  - schema + malli = should work ok, spec = best effort

3) publish final schemas into compiled route data
2023-05-21 20:32:40 +03:00
Tommi Reiman
d45dd151b7 document meta-merge 2023-05-21 18:11:42 +03:00
Tommi Reiman
b3383b0396 0.7.3-alpha4 2023-05-17 18:23:05 +03:00
Joel Kaasinen
ed1230d1cf doc: openapi.md: annotating schemas 2023-05-16 17:02:06 +03:00
Juho Teperi
0b6ed62738 Release 0.7.0-alpha3 2023-05-05 12:57:31 +03:00
Juho Teperi
e204d4ff1b Release 0.7.0-alpha2 2023-05-04 15:20:31 +03:00
Joel Kaasinen
253f379fd0 doc: use examples/ring-{malli,spec}-swagger in doc/ring/openapi.md 2023-05-03 17:17:25 +03:00
Joel Kaasinen
bafc9b757f doc: remove examples/ring-swagger
... it's the same as ring-spec-swagger. Let's keep the pair
ring-spec-swagger and ring-malli-swagger.
2023-05-03 17:17:22 +03:00
Joel Kaasinen
bcbdd05a6f
Merge pull request #617 from metosin/openapi-docs
doc: mention reitit-openapi in cljdoc
2023-05-03 17:12:47 +03:00
Joel Kaasinen
8db7598141 doc: mention reitit-openapi in cljdoc 2023-05-03 16:40:49 +03:00
Tommi Reiman
3336880b01 0.7.0-alpha1 2023-05-03 10:25:01 +03:00
Joel Kaasinen
be0d066f5d doc: document OpenAPI3 multiple examples 2023-04-19 11:03:15 +03:00
Juho Teperi
dad8f530a6 Add example and update docs 2023-03-24 11:32:22 +02:00
Joel Kaasinen
9a99ed96b2 doc: link to examples/ring-malli-swagger from doc/ring/openapi.md 2023-03-16 10:19:30 +02:00
Joel Kaasinen
bf8d0ba1ef doc: don't say :multipart only works with spec 2023-03-16 10:18:28 +02:00
Joel Kaasinen
83b747c7c6 doc: mention :multipart in doc/ring/coercion.md 2023-03-16 09:39:34 +02:00
Joel Kaasinen
0c82ce0e4d
Merge pull request #588 from metosin/openapi
Initial Openapi3 support
2023-03-15 09:34:16 +02:00
Joel Kaasinen
7defd98808 doc: Swagger-UI 5.0.0-alpha.0 has OpenAPI 3.1 support
mention in docs, use in http-swagger example
2023-03-10 14:34:05 +02:00
Joel Kaasinen
304b77cb7d doc: mention lack of swagger-ui support for openapi 3.1 2023-03-10 13:53:10 +02:00
Joel Kaasinen
3fa50ea0f6 doc: mark openapi support as alpha 2023-03-10 10:17:42 +02:00
Joel Kaasinen
8df8bf06cc doc: initial docs for openapi support & per-content-type coercion 2023-03-08 11:23:18 +02:00
dgb23
11534551da
Update composing_routers.md
I wondered how one would wrap a ring handler that can be recreated at runtime without restarting the server. @ikitommi suggested to use the recently added `reloading-ring-handler` as a starting point.

I propose a small example here that illustrates the pattern.
2023-03-07 00:13:15 +01:00
Tommi Reiman
ae138c6dec updated release guide 2023-02-21 15:54:52 +02:00
Tommi Reiman
47f1ee0c84 0.6.0 2023-02-21 15:17:00 +02:00
bplubell
e175dc76c9 Fix incorrect ring-router doc references
It looks like documentation references to `ring-router` are left-overs
from early README examples - I couldn't find any code that ever used the
name. The Ring router named `reitit.ring/router`.

While it didn't take too long for me to realize why my `ring-router` was
not working, I had to look the examples to figure out the name of the
function was just `router` - which was confusing since the section
header stated `reitit-router`.
2023-01-31 15:51:31 -08:00
Tommi Reiman
98a4d9b447 :meta-merge-fn -> :meta-merge 2023-01-21 10:56:42 +02:00
Tommi Reiman
42e988e518
Merge branch 'master' into support-operationid 2023-01-09 17:27:00 +02:00
Paulo Feodrippe
fc73d02e01 add :meta-merge-fn option 2022-08-11 07:55:15 -04:00
Tommi Reiman
3dff4c84aa 0.5.18 2022-04-05 21:38:04 +03:00
Zachary Teo
053ac5b961 Balance parenthesis in docs 2022-03-30 21:36:05 +08:00
Tommi Reiman
f0405adc02 0.5.17 2022-03-10 20:15:43 +02:00
Tommi Reiman
382661a6c4 0.5.16 2022-02-15 16:55:08 +02:00
Tommi Reiman
d0f7126491 add support for malli-lite 2022-02-14 16:45:14 +02:00
Tommi Reiman
060e593414 dev guide 2022-02-12 22:42:10 +02:00
Michael Salihi
673f6dec72
Replace with when-let since no else branches 2021-12-09 10:48:59 +01:00
Juho Teperi
f537be56b7
Merge pull request #510 from devurandom/patch-1
Link to #134 from parameters-middleware refactoring note
2021-11-03 12:19:15 +02:00
zengxinhui
59f4bf285a duplicate r/routes output
Perhaps this is not needed as the same output is shown above close.
Or the `nil`s need to be removed to match actual output. See PR513 https://github.com/metosin/reitit/pull/513
2021-11-03 12:17:30 +02:00
Juho Teperi
143bf06290
Merge pull request #515 from zengxinhui/patch-1
update r/routes output
2021-11-03 12:14:59 +02:00
Michael Salihi
6c835e6e09
Replace if-let by when-let since no else branches
for the recursive match by path example.
2021-10-13 18:50:20 +02:00
zengxinhui
f3a686026f
update r/routes output
`nil` should not be there.
2021-10-13 02:54:40 -04:00
zengxinhui
04225b0eff
update r/routes output
The `nil`s are not there and need to be removed.
2021-10-13 02:41:07 -04:00
mike
1737e19214
Fix typo in Swagger doc 2021-10-05 12:51:21 -05:00
Dennis Schridde
ef0aeaa7c4
Link to #134 from parameters-middleware refactoring note 2021-10-01 01:44:36 +02:00
Tommi Reiman
8694d312f8 0.5.15 2021-08-05 18:46:29 +03:00
Tommi Reiman
db84daca95 0.5.14 2021-08-03 13:41:27 +03:00
Phil Hofmann
478ee18a32 improve some docs 2021-07-27 18:33:17 +02:00
Timo Kramer
38ec679207 Extend the docs to mention the operationID 2021-05-29 11:48:57 +02:00
Ronny Løvtangen
1494641ab8
Update content_negotiation.md
Not 100% sure, but looks like it should be :date-format, not :data-format here, based on the example in the section above.
2021-04-24 22:20:16 +02:00
Miikka Koskinen
caa571cd66
Update development.md 2021-04-23 17:55:47 +03:00
Miikka Koskinen
2638041e0c
Update development.md 2021-04-23 17:53:53 +03:00
Miikka Koskinen
51a26ed052 Release 0.5.13 2021-04-23 17:41:40 +03:00
Zaymon
388f825d4d
Update README.md 2021-04-12 13:39:15 +10:00
Miikka Koskinen
d0e83fed41 Merge remote-tracking branch 'origin/master' into feature/update-static-handler-docs 2021-04-09 14:49:56 +03:00
Natxo Cabré
722bd8950f removed blank line 2021-03-12 13:33:47 +01:00
Natxo Cabré
1e76ea8114 fixed malli create example 2021-03-12 13:24:28 +01:00
Natxo Cabré
26c4ebc645 defined router var so the merged route tree example returns the commented data structure 2021-03-12 12:57:13 +01:00
Natxo Cabré
c5bb467402 fix route_conflicts link 2021-03-12 12:50:51 +01:00
Natxo Cabré
5831f2f4f6 fixed typo in explicitely 2021-03-12 12:45:55 +01:00
Miikka Koskinen
fb5eb1ff98
Update development.md 2021-03-05 20:45:28 +02:00
Miikka Koskinen
8567550ad9 Document serving static resources from the file system 2021-03-02 08:39:51 +02:00
Miikka Koskinen
b6d9707b53 Copy file & resource handler docstring update to docs 2021-03-02 08:28:36 +02:00
Kari Marttila
60fee31733 Missing curly brace in documentation - I noticed this while trying the example in REPL 2021-02-20 21:00:59 +02:00
Tommi Reiman
f43a8311fc 0.5.12 2021-02-04 20:40:25 +02:00
Tommi Reiman
0ecc2fb9a7
Merge pull request #456 from raphaelsaunier/fix/relative-urls-in-doc
Fix relative links in documentation
2021-01-10 18:10:53 +02:00
Tommi Reiman
b4099169be 0..5.11 with updated deps 2020-12-27 22:50:02 +02:00
Steven Deobald
7fb720ef36 Handle nil for lower-case
- when "_method" is actually empty, we need to avoid trying to
  do string manipulation on nil from params.
2020-12-15 19:29:50 -06:00
Steven Deobald
a3b251449b Downcase hidden methods in RESTful example
- this documentation is mildly confusing when combined with hiccup's
  `form-to` since hiccup forcibly transforms the method specified in
  its convenience syntax: `(form-to [:delete "/my-url"] ... )` into an
  upper-case string:
  80e48352dd/src/hiccup/form.clj (L130)

- it's also common to get an upper-case string from elsewhere so it
  seems best to wrap the hidden `_method` in `lower-case`.
2020-12-15 15:48:00 -06:00
Raphaël Saunier
c539c53ae2 Fix broken links in documentation 2020-12-01 10:00:20 +01:00
Teodor Heggelund
d1b8e1b98b Link to docs for Malli coercion 2020-11-01 16:49:03 +01:00
Tommi Reiman
0b2c4d0d8e 0.5.10 2020-10-22 00:10:52 +03:00
Tommi Reiman
dbf3751815 0.5.9 2020-10-19 10:46:38 +03:00
Tommi Reiman
ff647f3a2c 0.5.8 2020-10-19 08:31:29 +03:00
Tommi Reiman
8c3ad99276 0.5.7 2020-10-18 20:43:24 +03:00
Kimmo Koskinen
b51374fec2
Update example, :params -> :parameters 2020-10-14 10:08:20 +03:00
Tommi Reiman
5e290db106 0.5.6 2020-09-26 16:08:34 +03:00
Pertti Kellomäki
8ae0a4ccd4
Update basics.md
My pet peeve ;-)
Few = hardly any.
A few  = a couple
Some = a few or maybe more.
2020-09-04 21:49:56 +03:00
Kevin Liu
218cd4be69
Fix rfe/start! example arity
The second arg should be the on-navigate callback and the opts should be the third arg.
2020-08-16 19:54:20 -07:00
Miikka Koskinen
afd0af83be Point to cljdoc for documentation
Fixing all the links in CHANGELOG.md would have been too much work, so I
just left them as-is. I've converted the pages under
https://metosin.github.io/reitit/ to redirects, so the links should
work anyway.

Closes https://github.com/metosin/reitit/issues/426
2020-07-28 13:15:10 +03:00
Miikka Koskinen
aa833ac200
Merge pull request #418 from Koura/fix-docs-wording
Improve wording for interceptors documentation
2020-07-24 14:02:50 +03:00
Tommi Reiman
43e1a520d6 0.5.5 2020-07-15 11:28:11 +03:00
Tommi Reiman
274d527d2f 0.5.4 (with latest malli) 2020-07-13 11:08:19 +03:00
tjalkane
807b75f7c0 Improve wording for interceptors documentation 2020-07-10 15:46:28 +03:00
Tommi Reiman
56cbd67abd 0.5.3 2020-07-09 22:06:04 +03:00
J Hacksworth
bb4a7502fb Fix link in default_middleware.md
"Content Negotation" was moved to its own page. This commit adds a
section with a link to the new page, similar to the way the "Exception
Handling" section is presented.
2020-06-02 10:45:26 -04:00
Tommi Reiman
e30e739a15 0.5.2 2020-05-27 08:32:38 +03:00
Tommi Reiman
e649ed22b9 New options for malli coercion 2020-05-26 08:09:35 +03:00
Peter Nagy
efe07e3d5d
fix negation -> negotiation middleware
that was a funny typo!
2020-05-21 22:19:32 +02:00
Tommi Reiman
50f0120e8c 0.5.1 2020-05-18 15:00:28 +03:00
Tommi Reiman
500a4cc809 0.5.0 2020-05-17 18:42:33 +03:00