Files

T

dimgigov a9ad83c509 fix: general equality (=) for all types, add type predicates & collection fns, test suite docs

- Fix: = now uses cljEqual/cljMultiEqual instead of numeric-only cljNumEq,
  so (= :a :a), (= "a" "a"), (= [1 2] [1 2]), (= nil nil) etc return true
- Fix: ns forms inside unwrapped (do ...) are skipped instead of emitting
  broken Nim comments inside cljRepr()
- Fix: defmacro forms go to defs section, not wrapped in discard cljRepr()
- Add 18 type predicates: keyword?, symbol?, string?, number?, integer?,
  float?, vector?, map?, set?, list?, seq?, coll?, sequential?, fn?,
  boolean?, true?, false?, some?
- Add collection fns: second, ffirst, nfirst, peek, pop
- Add keyword/symbol ops: keyword, symbol, name, namespace, key, val
- Update eval interpreter = to handle structural collection equality
- Add test_single.py + test_vals.clj for Clojure test suite runner
- Add docs/en/07 and docs/bg/07 for cross-dialect test suite compatibility
- Update README with test suite documentation link

2026-05-09 12:17:10 +03:00

3.1 KiB

Raw Blame History

← Back to Index

Clojure Test Suite Compatibility

Clojure/Nim participates in the cross-dialect jank-lang/clojure-test-suite — the standard Clojure compliance test suite that validates behavior across all Clojure dialects.

Supported Dialects

The Clojure Test Suite is officially maintained for these dialects:

Dialect	Status	Runtime
Clojure (JVM)	✅ Official	JVM
ClojureScript	✅ Official	JavaScript / Node.js
Babashka	✅ Official	GraalVM native-image
Clojure CLR	✅ Official	.NET CLR
Basilisp	✅ Official	Python
Clojure/Nim	🚀 Candidate	Nim → C → Native

Quick Start

1. Clone the Test Suite

git clone https://github.com/jank-lang/clojure-test-suite.git /tmp/clojure-test-suite

2. Run Individual Tests

Use test_single.py to run a specific test file:

python3 test_single.py /tmp/clojure-test-suite/test/clojure/core_test/nil_qmark.cljc

3. Run a Batch

python3 test_single.py
# Runs: zipmap, zero_qmark, with_out_str

Edit the test_single.py file to add more test files to the batch list.

Test Format

Each test file is a .cljc (cross-platform Clojure/ClojureScript) file with a standard structure:

(ns clojure.core-test.nil-qmark
  (:require [clojure.test :as t :refer [are deftest is testing]]
            [clojure.core-test.portability :refer [when-var-exists]]))

(when-var-exists nil?
  (deftest test-nil?
    (testing "common"
      (are [in ex] (= (nil? in) ex)
        nil   true
        0     false
        false false
        ""    false))))

Reader Conditional Handling

Clojure/Nim's test_single.py pre-processes .cljc files, stripping #? and #?@ reader conditionals and extracting the :default branch:

;; Before
#?(:cljs :refer-macros :default :refer)

;; After
:refer

;; Before  
#?@(:cljs [] :default [1 2 3])

;; After
[1 2 3]

This follows the standard cross-dialect convention — each dialect resolves :default per its platform.

Current Test Scope

The test suite covers 212+ clojure.core functions and 8 clojure.string functions. Clojure/Nim is working toward full compliance.

See the Roadmap for implementation status.

Dialect-Specific Test Setup

For reference, here are links to the official dialect setup guides for running the test suite on other platforms:

Dialect	Setup Guide
Clojure (JVM)	clojure.md
ClojureScript	clojurescript.md
Babashka	babashka.md
Clojure CLR	clojureclr.md
Basilisp	basilisp.md
Clojure/Nim	This document

Last updated: 2026-05-09

3.1 KiB Raw Blame History