Clojure

Dev Changelog

The official changelog tracks deltas between major stable versions. This page gathers the interim dev release announcements during development.

Release 1.9

1.9.0-beta2 (Oct 6, 2017)

1.9.0-beta2 includes the following changes since 1.9.0-beta1:

  • CLJ-700 - (fix) contains?, get, and find broken for transient collections

  • CLJ-2247 - (regression) restore and doc last match semantics of {min,max}-key

  • CLJ-2239 - (regression) fix Guava javadoc location

  • Updated dep to spec.alpha 0.1.134 - see changes

1.9.0-beta1 (Sep 18, 2017)

1.9.0-beta1 includes the following changes since 1.9.0-alpha20:

  • CLJ-2077 - Clojure can’t be loaded from the boot classpath under java 9

1.9.0-alpha20 (Sep 7, 2017)

1.9.0-alpha20 includes the following changes since 1.9.0-alpha19:

  • CLJ-1074 - (new) add new ## reader macro for symbolic values, and read/print support for double vals ##Inf, ##-Inf, ##NaN

  • CLJ-1454 - (new) add swap-vals! and reset-vals! that return both old and new values

  • CLJ-2184 - (errors) propagate meta in doto forms to improve error reporting

  • CLJ-2210 - (perf) cache class derivation in compiler to improve compiler performance

  • CLJ-2070 - (perf) clojure.core/delay - improve performance

  • CLJ-1917 - (perf) reducing seq over string should call String/length outside of loop

  • CLJ-1901 - (perf) amap - should call alength only once

  • CLJ-99 - (perf) min-key and max-key - evaluate k on each arg at most once

  • CLJ-2188 - (perf) slurp - mark return type as String

  • CLJ-2108 - (startup time) delay loading of spec and core specs (still more to do on this)

  • CLJ-2204 - (security) disable serialization of proxy classes to avoid potential issue when deserializing

  • CLJ-2048 - (fix) specify type to avoid ClassCastException when stack trace is elided by JVM

  • CLJ-1887 - (fix) IPersistentVector.length() - implement missing method

  • CLJ-1841 - (fix) bean - iterator was broken

  • CLJ-1714 - (fix) using a class in a type hint shouldn’t load the class

  • CLJ-1398 - (fix) clojure.java.javadoc/javadoc - update doc urls

  • CLJ-1371 - (fix) Numbers.divide(Object, Object) - add checks for NaN

  • CLJ-1358 - (fix) doc - does not expand special cases properly (try, catch)

  • CLJ-1705 - (fix) vector-of - fix NullPointerException if given unrecognized type

  • CLJ-2170 - (doc) fix improperly located docstrings

  • CLJ-2156 - (doc) clojure.java.io/copy - doc char[] support

  • CLJ-2051 - (doc) clojure.instant/validated docstring - fix typo

  • CLJ-2104 - (doc) clojure.pprint docstring - fix typo

  • CLJ-2028 - (doc) filter, filterv, remove, take-while - fix docstrings

  • CLJ-1873 - (doc) require, data-readers - add .cljc files to docstrings

  • CLJ-1159 - (doc) clojure.java.io/delete-file - improve docstring

  • CLJ-2039 - (doc) deftype - fix typo in docstring

  • CLJ-1918 - (doc) await - improve docstring re shutdown-agents

  • CLJ-1837 - (doc) index-of, last-index-of - clarify docstrings

  • CLJ-1826 - (doc) drop-last - fix docstring

  • CLJ-1859 - (doc) zero?, pos?, neg? - fix docstrings

1.9.0-alpha19 (Aug 24, 2017)

  • Make the default import set public in RT

1.9.0-alpha18 (Aug 23, 2017)

  • Can now bind reader-resolver to an impl of LispReader$Resolver to control the reader’s use of namespace interactions when resolving autoresolved keywords and maps.

  • Tighten autoresolved keywords and autoresolved namespace map syntax to support only aliases, as originally intended

  • Updated to use core.specs.alpha 0.1.24

1.9.0-alpha17 (May 26, 2017)

  • CLJ-1793 - Clear 'this' before calls in tail position

  • CLJ-2091 clojure.lang.APersistentVector#hashCode is not thread-safe

  • CLJ-1860 Make -0.0 hash consistent with 0.0

  • CLJ-2141 Return only true/false from qualified-* predicates

  • CLJ-2142 Fix check for duplicate keys with namespace map syntax

  • CLJ-2128 spec error during macroexpand no longer throws compiler exception with location

  • Updated to use spec.alpha 0.1.123

1.9.0-alpha16 (Apr 27, 2017)

1.9.0-alpha16 includes the following changes since 1.9.0-alpha15:

  • The namespaces clojure.spec, clojure.spec.gen, clojure.spec.test have been moved to the external library spec.alpha which Clojure includes via dependency

  • These namespaces have been changed and now have an appended ".alpha": clojure.spec.alpha, clojure.spec.gen.alpha, clojure.spec.test.alpha

  • All keyword constants in clojure.spec (like :clojure.spec/invalid) follow the same namespace change (now :clojure.spec.alpha/invalid)

  • spec-related system properties related to assertions did NOT change

  • The specs for clojure.core itself in namespace clojure.core.specs have been moved to the external library core.specs.alpha which Clojure now depends on

  • The clojure.core.specs namespace has changed to clojure.core.specs.alpha. All qualified spec names in that namespace follow the same namespace change (most people were not using these directly)

In most cases, you should be able to update your usage of Clojure 1.9.0-alphaX to Clojure 1.9.0-alpha16 by:

  1. Updating your Clojure dependency to [org.clojure/clojure "1.9.0-alpha16"] - this will automatically pull in the 2 additional downstream libraries

  2. Changing your namespace declarations in namespaces that declare or use specs to:

(:require [clojure.spec.alpha :as s]
          [clojure.spec.gen.alpha :as gen]
          [clojure.spec.test.alpha :as stest])

1.9/spec split (Apr 26, 2017)

We are moving spec out of the Clojure repo/artifact and into a library to make it easier to evolve spec independently from Clojure. While we consider spec to be an essential part of Clojure 1.9, there are a number of design concerns to resolve before it can be finalized. This allows us to move towards a production Clojure release (1.9) that depends on an alpha version of spec. Users can also pick up newer versions of the spec alpha library as desired. Additionally, this is a first step towards increased support for leveraging dependencies within Clojure.

We will be creating two new contrib libraries that will contain the following (renamed) namespaces:

org.clojure/spec.alpha
    clojure.spec.alpha          (previously clojure.spec)
    clojure.spec.gen.alpha      (previously clojure.spec.gen)
    clojure.spec.test.alpha     (previously clojure.spec.test)

org.clojure/core.specs.alpha
    clojure.core.specs.alpha    (previously clojure.core.specs)

In most cases, we expect that users have aliased their reference to the spec namespaces and updating to the changed namespaces will only require a single change at the point of the require.

How will ClojureScript’s spec implementation change?

ClojureScript will also change namespace names to match Clojure. Eventually, the ClojureScript implementation may move out of ClojureScript and into the spec.alpha library - this is still under discussion.

Why do the libraries and namespaces end in alpha?

The "alpha" indicates that the spec API and implementation is still subject to change.

What will happen when the spec api is no longer considered alpha?

At that point we expect to release a non-alpha version of the spec library (with non-alpha namespaces). Users may immediately begin to use that version of spec along with whatever version of Clojure it depends on. Clojure itself will depend on it at some later point. Timing of all these actions is TBD.

Will the library support Clojure 1.8 or older versions?

No. spec uses new functions in Clojure 1.9 and it has never been a goal to provide spec for older versions. Rather, we are trying to accelerate the release of a stable Clojure 1.9 so that users can migrate forward to a stable production release with access to an alpha version of spec, and access to ongoing updated versions as they become available.

1.9.0-alpha15 (Mar 14, 2017)

1.9.0-alpha15 includes the following changes since 1.9.0-alpha14:

  • CLJ-2043 - s/form of conformer is broken

  • CLJ-2035 - s/form of collection specs are broken

  • CLJ-2100 - s/form of s/nilable should include the original spec, not the resolved spec

Specs:

  • CLJ-2062 - added specs for import and refer-clojure

  • CLJ-2114 - ::defn-args spec incorrectly parses map body as a prepost rather than function body

  • CLJ-2055 - binding-form spec parses symbol-only maps incorrectly

Infrastructure:

  • CLJ-2113 - Clojure maven build updated

1.9.0-alpha14 (Oct 28, 2016)

1.9.0-alpha14 includes the following changes since 1.9.0-alpha13:

  • NEW into now has a 0-arity (returns []) and 1-arity (returns the coll you pass)

  • NEW halt-when is a transducer that ends transduction when pred is satisfied. It takes an optional fn that will be invoked with the completed result so far and the input that triggered the predicate.

  • CLJ-2042 - clojure.spec/form of clojure.spec/? now resolves pred

  • CLJ-2024 - clojure.spec.test/check now fully resolves aliased fspecs

  • CLJ-2032 - fixed confusing error if fspec is missing :args spec

  • CLJ-2027 - fixed 1.9 regression with printing of bean instances

  • CLJ-1790 - fixed error extending protocols to Java arrays

  • CLJ-1242 - = on sorted sets or maps with incompatible comparators now returns false rather than throws

1.9.0-alpha13 (Sept 26, 2016)

1.9.0-alpha13 includes the following changes since 1.9.0-alpha12:

  • s/conform of nilable was always returning the passed value, not the conformed value

  • s/nilable now creates a generator that returns nil 10% of the time (instead of 50% of the time)

  • s/nilable now delays realizing the predicate spec until first use (better for creating recursive specs)

  • clojure.spec.gen now provides a dynload version of clojure.test.check.generators/frequency

1.9.0-alpha12 (Sept 7, 2016)

1.9.0-alpha12 includes the following changes since 1.9.0-alpha11:

  • spec performance has been improved for many use cases

  • spec explain printer is now pluggable via the dynamic var clojure.spec/explain-out which should be a function that takes an explain-data and prints to out

  • when a macro spec fails during macroexpand, throw ex-info with explain-data payload rather than IllegalArgumentException

  • pprint prints maps with namespace literal syntax when print-namespace-maps is true

  • CLJ-1988 - coll-of, every extended to conform sequences properly

  • CLJ-2004 - multi-spec form was missing retag

  • CLJ-2006 - fix old function name in docstring

  • CLJ-2008 - omit macros from checkable-syms

  • CLJ-2012 - fix ns spec on gen-class signatures to allow class names

  • CLJ-1224 - record instances now cache hasheq and hashCode like maps

  • CLJ-1673 - clojure.repl/dir-fn now works on namespace aliases

1.9.0-alpha11 (Aug 19, 2016)

1.9.0-alpha11 includes the following changes since 1.9.0-alpha10:

Clojure now has specs for the following clojure.core macros: let, if-let, when-let, defn, defn-, fn, and ns. Because macro specs are checked during macroexpansion invalid syntax in these macros will now fail at compile time whereas some errors were caught at runtime and some were not caught at all.

  • CLJ-1914 - Fixed race condition in concurrent range realization

  • CLJ-1870 - Fixed reloading a defmulti removes metadata on the var

  • CLJ-1744 - Clear unused locals, which can prevent memory leaks in some cases

  • CLJ-1423 - Allow vars to be invoked with infinite arglists (also, faster)

  • CLJ-1993 - Added print-namespace-maps dynamic var that controls whether to use namespace map syntax for maps with keys from the same namespace. The default is false, but standard REPL bindings set this to true.

  • CLJ-1985 - Fixed with-gen of conformer losing unform fn

  • Fixed clojure.spec.test/check to skip spec’ed macros

  • Fixed regression from 1.9.0-alpha8 where type hints within destructuring were lost

  • Fixed clojure.spec/merge docstring to note merge doesn’t flow conformed values

  • Fixed regex ops to use gen overrides if they are used

1.9.0-alpha10 (Jul 11, 2016)

1.9.0-alpha10 includes the following changes since 1.9.0-alpha9:

  • NEW clojure.core/any? - a predicate that matches anything. any? has built-in gen support. The :clojure.spec/any spec has been removed. Additionally, gen support has been added for some?.

  • keys* will now gen

  • gen overrides (see c.s/gen, c.s./exercise, c.s.t/check, c.s.t/instrument) now expect no-arg functions that return gens, rather than gens

  • CLJ-1977 - fix regression from alpha9 in data conversion of Throwable when stack trace is empty

1.9.0-alpha9 (Jul 5, 2016)

1.9.0-alpha9 includes the following changes since 1.9.0-alpha8:

  • NEW clojure.spec/assert - a facility for adding spec assertions to your code. See the docs for compile-asserts and assert for more details.

  • clojure.spec/merge - now merges rather than flows in conform/unform

  • clojure.spec.test/instrument now reports the caller that caused an :args spec failure and ignores spec’ed macros

  • clojure.spec.test - test, test-fn, testable-syms renamed to check, check-fn, and checkable-syms to better reflect their purpose. Additionally, some of the return value structure of check has been further improved.

  • clojure.core/Throwable→map formerly returned StackTraceElements which were later handled by the printer. Now the StackTraceElements are converted to data such that the return value is pure Clojure data, as intended.

1.9.0-alpha8 (Jun 28, 16)

1.9.0-alpha8 includes the following changes since 1.9.0-alpha7:

The collection spec support has been greatly enhanced, with new controls for conforming, generation, counts, distinct elements and collection kinds. See the docs for every, every-kv, coll-of and map-of for details.

instrumenting and testing has been streamlined and made more composable, with powerful new features for spec and gen overrides, stubbing, and mocking. See the docs for these functions in clojure.spec.test: instrument, test, enumerate-ns and summarize-results.

Namespaced keyword reader format, printing and destructuring have been enhanced for lifting namespaces up for keys, supporting more succinct use of fully-qualified keywords. Updated docs will be added to clojure.org soon.

Many utilities have been added, for keys spec merging, fn exercising, Java 1.8 timestamps, bounded-count and more.

Changelog:

clojure.spec:

  • [changed] map-of - now conforms all values and optionally all keys, has additional kind, count, gen options

  • [changed] coll-of - now conforms all elements, has additional kind, count, gen options. No longer takes init-coll param.

  • [added] every - validates a collection by sampling, with many additional options

  • [added] every-kv - validates a map by sampling, with many additional options

  • [added] merge

  • [changed] gen overrides can now be specified by either name or path

  • [changed] fspec generator - creates a function that generates return values according to the :ret spec and ignores :fn spec

  • [added] explain-out - produces an explain output string from an explain-data result

  • [changed] explain-data - output is now a vector of problems with a :path element, not a map keyed by path

  • [added] get-spec - for looking up a spec in the registry by keyword or symbol

  • [removed] fn-spec - see get-spec

  • [added] exercise-fn - given a spec’ed function, returns generated args and the return value

  • All instrument functions moved to clojure.spec.test

clojure.spec.test:

  • [changed] instrument - previously took a var, now takes either a symbol, namespace symbol, or a collection of symbols or namespaces, plus many new options for stubbing or mocking. Check the docstring for more info.

  • [removed] instrument-ns - see instrument

  • [removed] instrument-all - see instrument

  • [changed] unstrument - previously took a var, now takes a symbol, namespace symbol, or collection of symbol or namespaces

  • [removed] unstrument-ns - see unstrument

  • [removed] unstrument-all - see unstrument

  • [added] instrumentable-syms - syms that can be instrumented

  • [added] with-instrument-disabled - disable instrument’s checking of calls within a scope

  • [changed] check-var renamed to test and has a different signature, check docs

  • [changed] run-tests - see test

  • [changed] run-all-tests - see test

  • [changed] check-fn - renamed to test-fn

  • [added] abbrev-result - returns a briefer description of a test

  • [added] summarize-result - returns a summary of many tests

  • [added] testable-syms - syms that can be tested

  • [added] enumerate-namespace - provides symbols for vars in namespaces

clojure.core:

  • [changed] - inst-ms now works with java.time.Instant instances when Clojure is used with Java 8

  • [added] bounded-count - if coll is counted? returns its count, else counts at most first n elements of coll using its seq

1.9.0-alpha7 (Jun 15, 2016)

1.9.0-alpha7 includes the following changes since 1.9.0-alpha6 (all BREAKING vs alpha5/6):

clojure.core: - long? ⇒ int? - now checks for all Java fixed precision integer types (byte,short,integer,long) - pos-long? ⇒ pos-int? - neg-long? ⇒ neg-int? - nat-long? ⇒ nat-int?

clojure.spec: - long-in-range? ⇒ int-in-range? - long-in ⇒ int-in

If you are interested in checking specifically for long?, please use #(instance? Long %).

Sorry for the switcheroo and welcome to alphatown!

1.9.0-alpha6 (Jun 14, 2016)

1.9.0-alpha6 includes the following changes since 1.9.0-alpha5:

  • & regex op now fails fast when regex passes but preds do not

  • returns from alt/or are now map entries (supporting key/val) rather than 2-element vector

  • [BREAKING] fn-specs was renamed to fn-spec and returns either the registered fspec or nil

  • fspec now accepts ifn?, not fn?

  • fspec impl supports keyword lookup of its :args, :ret, and :fn specs

  • fix fspec describe which was missing keys and improve describe of :args/ret/fn specs

  • instrument now checks only the :args spec of a var - use the clojure.spec.test functions to test :ret and :fn specs

  • Added generator support for bytes? and uri? which were accidentally left out in alpha5

1.9.0-alpha5 (Jun 7, 2016)

1.9.0-alpha5 includes the following changes since 1.9.0-alpha4:

Fixes: - doc was printing "Spec" when none existed - fix ? explain

New predicates in core (all also now have built-in generator support in spec): - seqable? - boolean? - long?, pos-long?, neg-long?, nat-long? - double?, bigdec? - ident?, simple-ident?, qualified-ident? - simple-symbol?, qualified-symbol? - simple-keyword?, qualified-keyword? - bytes? (for byte[]) - indexed? - inst? (and new inst-ms) - uuid? - uri?

New in spec: - unform - given a spec and a conformed value, returns the unconformed value - New preds: long-in-range?, inst-in-range? - New specs (with gen support): long-in, inst-in, double-in

1.9.0-alpha4 (May 31, 2016)

1.9.0-alpha4 includes the following changes since 1.9.0-alpha3:

  • fix describe empty cat

  • improve update-in perf

  • optimize seq (&) destructuring

1.9.0-alpha3 (May 26, 2016)

1.9.0-alpha3 includes the following changes since 1.9.0-alpha2:

  • Macro fdef specs should no longer spec the implicit &form or &env [BREAKING CHANGE]

  • multi-spec includes dispatch values in path

  • multi-spec no longer requires special default method

  • fix for rep* bug

  • added explain-str (explain that returns a string)

  • improved s/+ explain

  • explain output tweaked

  • fix test reporting

1.9.0-alpha2 (May 25, 2016)

1.9.0-alpha2 includes the following changes since 1.9.0-alpha1:

  • Better describe for s/+

  • Capture recursion-limit on gen call

  • explain-data now contains :in key for the input path

  • CLJ-1931 - with-gen throws AbstractMethodError

1.9.0-alpha1 (May 24, 2016)

1.9.0-alpha1 includes the first release of clojure.spec.

A usage guide for spec is now available: https://clojure.org/guides/spec.