Changelog

All notable changes to the infix library will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.0] - 2026-04-27

Added

• _+_ macro: terse alias for infix. Mirrors the textbook operand-operator-operand notation (□ ⊕ □) while staying ASCII and home-row. All infix features (arrow lambdas, fn(args), grouping) work through it. (#11)

  (_+_ 3 + 4)               ;; => 7
  (_+_ 2 * 3 + 4 * 2)       ;; => 14
  ((_+_ x => x * x) 5)      ;; => 25
  (_+_ count([1 2 3]) + 1)  ;; => 4
  

[1.0.1] - 2026-04-27

Fixed

• Early return: (return nil) and (return false) no longer re-throw — infix-defn now distinguishes "no return value" from "returned a falsy value" by checking key presence in ex-data. (#1)
• Vector literals as fn(args) arguments: count([1 2 3]) and similar now preserve the vector container instead of coercing it to a seq, so (map inc, [1 2 3]) and friends work as expected. (#3)
• Nested fn(args) inside let-binding RHS: (let [n count(xs)] …) and operator-headed nesting like (let [t (/ count(xs) 2)] …) are now transformed correctly inside infix-defn. The transform-function-calls pass is now context-aware (:expression vs :call) and protects let-style binding vectors. (#3)
• Single-form arrow-lambda bodies: (infix x => (max x 5)) and curried (infix x => (infix y => x + y)) no longer go through the infix parser, which had been mangling pre-formed Clojure expressions. (#5)
• Redundant parentheses: (infix ((((3 + 4))))) etc. now evaluate correctly. The grouping detector deliberately leaves the thunk-call idiom ((fn [] 5)) intact — only literals, vectors, infix expressions, and chains that bottom out in those are unwrapped. (#8)

Added

• CI: GitHub Actions test workflow with hardened defaults — explicit permissions: contents: read and SHA-pinned actions (including the third-party DeLaGuardo/setup-clojure) so a moving tag cannot inject new code into the build. (#9)

[1.0-rc1] - 2025-04-01

Added

• Core Infix Operations: Complete arithmetic, comparison, and boolean operators

  • Arithmetic: + - * / with proper precedence
  • Comparison: = not= < <= > >=
  • Boolean: and or not with short-circuiting
  • Threading: -> ->> some-> some->> as infix operators

• Arrow Lambda Syntax: Clean anonymous function syntax

  • Single parameter: x => x * 2
  • Multi-parameter: (x y) => x + y
  • Complex expressions: x => x * x + 1
  • Smart disambiguation from threading operators

• Function Definitions: infix-defn macro with full feature support

  • Support for docstrings: (infix-defn name "doc" [params] body)
  • Early return mechanism with return statement
  • Multiple return points and guard clause patterns
  • Complex expressions with all operators

• Function Call Syntax: Familiar fn(args) transformation

  • Function calls: max(3, 5) → (max 3 5)
  • Method calls: .method(obj, arg) → (.method obj arg)
  • Integration with infix operators
  • Threading support: obj -> .method() -> .other()

• Complete OOP Interop: Full Java object support

  • Method calls: obj.method(args) → (.method obj args)
  • Method chaining: obj -> .method1() -> .method2()
  • Object creation: ClassName(args) → (new ClassName args)
  • Alternative syntax: ClassName.new(args)
  • Constructor chaining: StringBuilder("hi") -> .append("!")

Technical Features

• Robust Parser: Shunting Yard algorithm with smart function detection
• Proper Precedence: Mathematical precedence with threading macros as lowest
• Comprehensive Testing: 100+ tests covering all features and edge cases
• Full Integration: All features work together seamlessly
• Zero Learning Curve: Optional enhancement that doesn't change Clojure semantics

Project Setup

• Multi-format Support: deps.edn, project.clj, and pom.xml configurations
• Maven Coordinates: com.flexiana/infix "1.0-rc1"
• License: Apache License 2.0 (same as Clojure)
• Documentation: Comprehensive README with examples and usage patterns

Release Candidate Status

This release candidate includes all planned features for version 1.0. The library is feature-complete and ready for production use. The API is stable and no breaking changes are expected for the 1.0 release.

[Unreleased] - Future Features

Planned for v1.1+

• Collection operators: in, not-in
• Enhanced comma handling
• Nested function call improvements
• Advanced error messages
• Performance optimizations