Commit graph

433 commits

Author SHA1 Message Date
Stig Brautaset
0fff06ec6b
Correct "effects" to "affects" in comments & docs
Their usage is commonly confused, but "affect" is usually a verb and
"effect" is usually a noun. In this case we want the verb. See also
https://www.merriam-webster.com/grammar/affect-vs-effect-usage-difference
2023-10-13 21:10:20 +01:00
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