Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/strojure/ring-lib
Opinionated implementations for Clojure ring handler.
https://github.com/strojure/ring-lib
clojure optimization ring-handler ring-middleware
Last synced: 18 days ago
JSON representation
Opinionated implementations for Clojure ring handler.
- Host: GitHub
- URL: https://github.com/strojure/ring-lib
- Owner: strojure
- License: unlicense
- Created: 2023-01-17T15:11:19.000Z (almost 2 years ago)
- Default Branch: default
- Last Pushed: 2023-03-28T13:43:06.000Z (almost 2 years ago)
- Last Synced: 2024-12-05T22:34:06.663Z (28 days ago)
- Topics: clojure, optimization, ring-handler, ring-middleware
- Language: Clojure
- Homepage:
- Size: 53.7 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ring-lib
Opinionated implementations for Clojure ring handler.
[](https://clojars.org/com.github.strojure/ring-lib)
[](https://cljdoc.org/d/com.github.strojure/ring-lib)
[](https://github.com/strojure/ring-lib/actions/workflows/tests.yml)
## Motivation
Being not satisfied with some decisions/implementations in existing Ring
libraries.
## API
### Middlewares
Some middlewares in this library does not provide `wrap-middleware` function.
There are middleware builder functions in `strojure.ring-lib.middleware.core`
namespace:
```clojure
(require '[strojure.ring-lib.middleware.core :as mw]
'[strojure.ring-lib.middleware.params :as params])
(-> handler
(mw/wrap-request (params/params-request-fn {})))
```
#### csp
The implementation of Content Security Policy ([CSP]).
- Supports static CSP headers and headers with nonce.
- Renders policy from Clojure map.
- Follows recommendations for nonce generation.
- Configurable usage of report-only CSP header.
- Handles report URI endpoint.
[CSP]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
#### cookies
The alternative implementation of the
[cookies](https://github.com/ring-clojure/ring/blob/master/ring-core/src/ring/middleware/cookies.clj)
middleware.
- Lazy evaluation of the `:cookies` key in request.
- Avoids destructuring of the options map in every request.
#### params
The alternative implementation of the
[params](https://github.com/ring-clojure/ring/blob/master/ring-core/src/ring/middleware/params.clj)
middleware.
- Name dependent detection if param is single value or collection, by default
only names with `[]` suffix has collection value.
- Lazy evaluation of request keys.
- Allows to customize param names with collection values.
- Allows to define coercion function for param names, i.e. to keywordize them.
- Adds `:form-params` which is `:query-params` for GET requests and
`:body-params` for POST request with “application/x-www-form-urlencoded”
content type.
- Adds `:path-or-query-params` which contains params from URL but not body.
- Does not add `:params` as merge of everything else because it is considered confusing.
- Optimized for performance.
## Benchmarks
- [middleware.params](doc/benchmark/middleware_params.clj)
- [util.codec](doc/benchmark/util_codec.clj)
- [util.headers](doc/benchmark/util_headers.clj)
---
Authored by [Sergey Trofimov](https://github.com/serioga).
[](UNLICENSE)