Spec: add more commonpractices
@practicalli-johnny ci sta già lavorando.
Dal 12/9/2025.
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
Update Practicalli Clojure spec section to include more common practices, especially in organising specs and Generative tests
https://practical.li/clojure/clojure-spec/organising-specs/
Commercial experiences
- Statsbomb (kafka)
- Griffin (db abstraction & generative testing)
- Billie (web)
Community
Where do you put the specs?
For domain, I prefer one or more namespaces dedicated to this (consider two layers - one for types, one for attributes) and included via :as-alias
For functions, in a foo.specs namespace
How do you validate the domain constructs? Via pre-/postconditions, within the functions via s/valid?, with s/fdefs and instrumentation or with custom validators?
s/valid? for data validation from public inputs
s/fdef / instrumentation for tests of functions
How do you report spec failures? Just the error or with explain or expound?
for internal stuff, probably s/explain
for public stuff, consider expound or custom
Do you validate at dev-time only or also in production?
for user-side inputs, production
for catching your own programming errors, dev-time only
What libs/tools do you use other than plain spec?
test.chuck
- Lingua principale
- Makefile
- Stelle
- 117
- Fork
- 36
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di practicalli/clojure
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
practicalli/clojure#381 ·
-
Clojure on windowsAperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 75/100
practicalli/clojure#298 ·
-
feat: Clojure fundamentals video seriesForse di nuovo libera @practicalli-johnny l’ha presa 201 giorni fa e non c’è nessuna pull request aperta. Apertavideo
practicalli/clojure#478 · 1 assegnatario ·
-
Update: hotload libs in Clojure 1.12Forse di nuovo libera @practicalli-johnny l’ha presa 439 giorni fa e non c’è nessuna pull request aperta. Aperta
practicalli/clojure#476 · 1 assegnatario ·
-
docs: project template design - root and custom directoriesForse di nuovo libera @practicalli-johnny l’ha presa 504 giorni fa e non c’è nessuna pull request aperta. Aperta
practicalli/clojure#474 · 1 assegnatario ·