Optional typing in Clojure, as a library.
Latest stable release is 0.6.0.
Leiningen dependency information:
[org.clojure/core.typed "0.6.0"]
...
; for very recent releases
:repositories {"sonatype-oss-public" "https://oss.sonatype.org/content/groups/public/"}
; for slim jars, follow version string with: :classifier "slim"Maven dependency information:
<dependency>
<groupId>org.clojure</groupId>
<artifactId>core.typed</artifactId>
<version>0.6.0</version>
<!-- slim jar -->
<!-- <classifier>slim</classifier> -->
</dependency>The default jars contain AOT files for faster loading. If jar size is a concern, consider using the slim jar in production.
core.typed supports Clojure 1.9.0 and JDK 1.7+.
Tldr; here is a complete project using core.typed.
With the core.typed JAR in your classpath, run the following code to enable automatic type checking. This is how to start with Leiningen.
:injections [(require 'clojure.core.typed)
(clojure.core.typed/install)]Next add the following ns metadata to the file you are working with.
(ns test.core
{:lang :core.typed})Save the file and run (require 'test.core :reload). This should type check the file automatically.
It's useful to also import clojure.core.typed to annotate expressions.
(ns test.core
{:lang :core.typed}
(:require [clojure.core.typed :as t]))
(t/ann f [t/Any :-> t/Int])
(defn f [x]
(t/cast t/Int x))Expressions evaluated via eval will also be type checked if the following is true at runtime:
(= :core.typed (:lang (meta *ns*))).
core.typed can observe your tests running and generate appropriate annotations for your functions.
First, call (clojure.core.typed/prepare-infer-ns) in the namespace you wish
to infer.
Then, run the relevant tests, ensuring you don't accidentally re-load the instrumented namespace.
Finally, call (clojure.core.typed/runtime-infer) to insert core.typed annotations
in your file, or (clojure.core.typed/spec-infer) for clojure.spec annotations.
Use the core.typed mailing list for core.typed discussion, or try #typed-clojure on Freenode (the main developer is ambrosebs).
See wiki.
(clojure.core.typed/ann v t) gives var v the static type t.
(clojure.core.typed/ann-form f t) ensures form f is of the static type t.
(clojure.core.typed/check-ns) type checks the current namespace.
(clojure.core.typed/cf t) type checks the form t.
core.async Rock-paper-scissors
The ClojureScript checker has not followed the last year of upstream changes, so it does not work. If you would like to help update the checker, please post on the mailing list.
- Typed Clojure Contributor Code of Conduct
- Contributing guidelines
- GitHub Project
- Bug Tracker
- Continuous Integration
- Compatibility Test Matrix
Thanks to the following people for contributing to core.typed:
- Stephen Compall (S11001001)
- Andrew Brehaut (brehaut)
- Christopher Spencer (cspencer)
- Reid McKenzie (arrdem)
- Di Xu (xudifsd)
- Nicola Mometto (Bronsa)
- Chas Emerick (cemerick)
- Jake Goulding (shepmaster)
- Andy Fingerhut
- Aravind K N (arav93)
- Allen Rohner (arohner)
- Minori Yamashita (ympbyc)
- Kyle Kingsbury (aphyr)
- Nathan Sorenson
- Tobias Kortkamp (t6)
- Alejandro Gomez (dialelo)
- Piotr Jarzemski (kazuhiro)
Development is sponsored (via crowdfunding) by
YourKit is kindly supporting core.typed and other open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products:
Copyright © Ambrose Bonnaire-Sergeant, Rich Hickey & contributors.
Licensed under the EPL (see the file epl-v10.html).