Changelog

Fireworks: A color printer for Clojure, ClojureScript, and Babashka.

For a list of breaking changes, check here

0.10.2

2024-11-8

Fixed

• Bug with printing js Arrays

Changed

• Bumps lasertag dep to 0.8.2

0.10.1

2024-11-7

Fixed

• Bug with printing lambda fns

Changed

• Bumps lasertag dep to 0.8.1

0.10.0

2024-11-6

Added

• Support for labeling and printing volatiles
• Support for labeling and printing transient data structures

Breaking changes

• Rename :lamda-label to :lambda-label in theme syntax

0.9.0

2024-11-3

Added

• Supports proper labelling of more Java classes such as java.util.Hashmap

Changed

• Bumps lasertag dep to 0.7.0
• Internal refactoring of fireworks.truncate

Removed

• Unused fireworks.alert namespace

0.8.1

Fixes

• Fixes empty map bug

Added

• Exposes :margin-top and :margin-bottom options

Changed

• Increase depth of caught-exception (in fireworks.core/formatted) stack trace preview to 12 frames

0.8.0

2024-10-23

Added

• Add "Universal Neutral" theme that works on both light and dark backgrounds

• Add :when option that works on both light and dark backgrounds

• Add :legacy-terminal? option

Changed

• Undocumented the folowing options:

  • :enable-terminal-truecolor?
  • :enable-terminal-italics?
  • :enable-terminal-font-weights?

• All the above are now true by default. User should now only set :legacy-terminal? to true if they want truecolor conversion for a terminal that doesn't support trucolor.

• Moved cljc visual regression testing to visual_test/

Removed

• :evaled-form-coll-limit option

0.7.1

2024-10-16

Changed

• Bump version of Bling dep

0.7.0

2024-10-16

Fixed

• Fixes array-map entry order

Added

• Add support for :single-line-coll-length-limit option

• Add support for :label-length-limit option

• Add separate shadow-cljs project for cljc visual regression testing in test/fireworks/visual

0.7.1

2024-10-16

Changed

• Bump version of Bling dep

0.7.0

2024-10-16

Fixed

• Fixes array-map entry order

Added

• Add support for :single-line-coll-length-limit option

• Add support for :label-length-limit option

• Add separate shadow-cljs project for cljc visual regression testing in test/fireworks/visual

0.6.5

2024-10-09

Fixed

• Fixes printing of map entries

0.6.4

2024-09-09

Changed

• Update fireworks.pp namespace to latest version of me.flowthing/pp (2024-09-09.69).

Fixed

• Printing in :pp mode now displays converted map entries correctly

;; Before:
(? :pp (into [] {:a "foo"})) => [:a "foo"]

;; After:
(? :pp (into [] {:a "foo"})) => [[:a "foo"]] 

0.6.3

2024-09-01

Changed

• Update bling dep to [io.github.paintparty/bling "0.1.1"]

0.6.2

2024-08-25

Added

• :fw/debug? call-site option for printing diagnostic info about state and config.
• :fw/print-config? call-site option for printing merged config options.

Fixed

• Override theme resolution when no theme is provided in config.edn
• Syntax coloring for labels in cljs

0.6.1

2024-08-23

Fixed

• Logic bug in :trace mode.
• Various syntax coloring inconsistencies across stock themes

0.6.0

2024-08-20

Added

• bling lib added as dep for formatting of warnings and errors
• Added support for hiding a given data structure's brackets via metadata ala: ^{:fw/hide-brackets? true}

Changed

• Tweaked error and warning templates.
• fireworks.core/? now has 0, 1, 2, and 3 arities.
• fireworks.core/? now accepts a leading "flag" argument which determines the functionality. This should be a keyword, one of the following:
  • :result
  • :comment
  • :file
  • :log
  • :log-
  • :pp
  • :pp-
  • :trace
  • :data.

Removed

• ::fireworks.specs.tokens/color-tuple (no longer needed).
• Removed the following macros and fns, as their respective functionality is now provided by an optional leading keyword argument to ?:
  • ?-
  • ?--
  • ?log
  • ?log-
  • ?pp
  • ?pp-
  • ?l
  • ?i
  • ?trace
  • p-data

0.5.0

2024-07-6

Added

• :enable-terminal-font-weights as config option for enabling bold font weight in terminal environments which support it.
• ?i macro for printing the info, then the result.
• ?l macro for printing the label, then the result.
• ?trace macro for tracing ->, ->>, 'some->', 'some->>'.
• ?> macro for sending values to tap>, then returning value.

Changed

• Use pprint if label for printing is a map.
• Remove trailing bracket on form-to-be-evaled labels.
• Shortened truncation syntax within colls which exceed :print-level
• ?- macro now prints just the result.
• ?-- macro now prints just a label, for user commentary.
• ?log- macro now just prints the result, and returns the result.
• Removed following macros: ?println, ?print, ?prn, ?pr, functionality replaced by :print-with call-site option

Fixed

• Bug with clojure.core/max arity, if maps are empty.
• Bug with :non-coll-result-length-limit config.
• Colorization of metadata (kv gaps) in terminal context
• Bug with :non-coll-mapkey-length-limit config.

Removed

• ?log-- macro.

0.4.0

2024-05-22

Added

• :metadata and :metadata2 tokens in theme -> [:theme :classes]

Changed

• Metadata maps now formatted with left-justified values. In all stock themes, they are styled monotone, in a contrasting color, with all keys styled bold.

Fixed

• Invalid user-theme warning.

0.3.0

2024-05-03

Added

• Multiple variants of print-and-return macros - see readme for more info.

Changed

• Evaled forms are now printed in monotone (themeable) color, and always truncated
• File info is now printed as:
  • evaled form or user-supplied label (Optional)
  • namespace-info
  • linebreak
  • result.
• fireworks.core/?> is now a "tap> and return" macro. It just taps the value and returns the result (no printing).
• When using ?, ?-, or ?-- in ClojureScript, and the resulting value is a native js data structure, the result is printed with js/console.log.
• Significant refactoring of fireworks.truncate namespace.

0.2.0

2024-03-02

Added

• Relax length limit for non-coll result display values #3
• Added :non-coll-result-length-limit config option
• Added :non-coll-depth-1-length-limit config option

Changed

• Rename fireworks.core/p* -> fireworks.core/p-data
• Rename config option :mapkey-value-width-limit -> :non-coll-mapkey-length-limit
• Rename config option :value-width-limit -> :non-coll-length-limit
• Update dependency coordinates for typetag

0.1.1

2024-03-02

Fixed

• Ability to change theme at call site via :mood.
• #1 :metadata-position :block bug for non-coll values.

0.1.0

2024-03-01

Initial Release

Breaking changes

0.10.0

• Rename :lamda-label to :lambda-label in theme syntax

0.8.0

• If no theme (or invalid theme) is provided, "Universal Neutral" is used, which works on both light and dark backgrounds.

0.6.0

• Removed the following macros and fns, as their respective functionality is now provided by an optional leading keyword argument to ?:
  • ?-
  • ?--
  • ?log
  • ?log-
  • ?pp
  • ?pp-
  • ?l
  • ?i
  • ?trace
  • p-data

0.5.0

• Use pprint if label for printing is a map.
• Remove trailing bracket on form-to-be-evaled labels.
• Shortened truncation syntax within colls which exceed :print-level
• ?- macro now prints just the result.
• ?-- macro now prints just a label, for user commentary.
• ?log- macro now just prints the result, and returns the result.
• Removed macros : ?println, ?print, ?prn, ?pr

0.4.0

• Metadata maps now formatted with left-justified values.

0.3.0

• File info is now printed as:

  • evaled form or user-supplied label (Optional)
  • namespace-info
  • linebreak
  • result.

• fireworks.core/?> is now a "tap> and return" macro. It just taps the value and returns the result (no printing).

0.2.0

• Rename fireworks.core/p* -> fireworks.core/p-data
• Rename config option :mapkey-value-width-limit -> :non-coll-mapkey-length-limit
• Rename config option :value-width-limit -> :non-coll-length-limit