jacinda: Functional, expression-oriented data processing language

[ agpl, data, interpreters, language, library, program, text ] [ Propose Tags ]

APL meets AWK. A command-line tool for summarizing and reporting, powered by Rust's regex library.


[Skip to Readme]

Flags

Manual Flags

NameDescriptionDefault
cross

Enable to ease cross-compiling

Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.0.0, 0.2.0.0, 0.2.1.0, 0.3.0.0, 0.3.1.0, 1.0.0.0, 1.1.0.0, 1.2.0.0, 2.0.0.0, 2.0.1.0, 2.0.2.0, 3.0.0.0, 3.0.1.0, 3.0.1.1, 3.0.2.0, 3.1.0.0, 3.1.0.1, 3.1.1.0, 3.1.1.1, 3.2.0.0, 3.2.0.1
Change log CHANGELOG.md
Dependencies array, base (>=4.11.0.0 && <5), bytestring (>=0.11.2.0), containers (>=0.6.0.1), deepseq, directory, filepath, jacinda, lazy-csv, microlens, microlens-mtl (>=0.1.8.0), mtl, optparse-applicative (>=0.14.1.0), prettyprinter (>=1.7.0), recursion (>=1.0.0.0), regex-rure (>=0.1.2.0), split, text, transformers, vector (>=0.12.2.0) [details]
License AGPL-3.0-only
Author Vanessa McHale
Maintainer vamchale@gmail.com
Category Language, Interpreters, Text, Data
Bug tracker https://github.com/vmchale/jacinda/issues
Source repo head: git clone https://github.com/vmchale/jacinda
Uploaded by vmchale at 2024-06-04T14:32:39Z
Distributions NixOS:3.1.1.1
Executables ja
Downloads 951 total (90 in the last 30 days)
Rating 2.25 (votes: 2) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2024-06-04 [all 2 reports]

Readme for jacinda-3.1.0.1

[back to package description]

Jacinda is a functional pattern sifting language, a smaller AWK.

Installation

Releases

There are binaries for some platforms on the releases page.

If you are on Mac, you will need to install *-librure.dylib as well.

From Source

First, install Rust's regex library. You'll need to put librure.so or librure.dylib etc. in the appropriate place.

If you have cabal and GHC installed (perhaps via ghcup):

cabal install jacinda

Editor Support

There is a vim plugin and a VSCode extension.

Usefulness

Unix uses record separators in many places; we can display one entry in the PATH variable with:

echo $PATH | ja -F: "{|[x+'\n'+y]|>\`$}"

Many Unix tools output much information separated with spaces. We use regular expressions to match relevant lines and then select the field with the data itself, viz.

otool -l $(locate libpng.dylib) | ja '{`1 ~ /^name/}{`2}'

To get the value of a variable (say, PATH) from the output of printenv:

printenv | ja -F= '{%/^PATH/}{`2}'

Rosetta

Replace

NF == 1 && $1 != "}" {
  haveversion[$1] = 1
}
END {
  for (i in haveversion)
    printf "have-%s = yes\n", i
}

with

(sprintf 'have-%s = yes')" ~.{nf=1 & `1 != '}'}{`1}

Documentation

See the guide, which contains a tutorial on some of the features as well as examples.

The manpages document the builtins and provide a syntax reference.

Status

Missing Features & Bugs

  • No nested dfns
  • No list literal syntax
  • Postfix :f and :i are handled poorly
  • Streams of functions don't work
  • Higher-order functions are subtly broken

Intentionally missing features:

  • No loops

Advantages

Contributing

I have rewritten the code several times so forking and applying patches is fraught!

Bug reports are welcome contributions.