Skip to content

CHANGELOG.md

Latest commit

 

History

History
89 lines (70 loc) · 4.64 KB

CHANGELOG.md

File metadata and controls

89 lines (70 loc) · 4.64 KB

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