jacinda: Functional, expression-oriented data processing language

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

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


[Skip to Readme]

library jacinda:jacinda-lib

Modules

[Last Documentation]

  • A
  • File
  • Jacinda
    • Jacinda.Regex
  • Parser
    • Parser.Rw
  • Ty
    • Ty.Const

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

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

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, 3.3.0.0
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), 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
Revised Revision 2 made by vmchale at 2024-10-19T02:31:00Z
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-10-09T22:21:26Z
Distributions NixOS:3.2.0.0
Executables ja
Downloads 1008 total (96 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-10-10 [all 2 reports]

Readme for jacinda-3.2.0.0

[back to package description]

Jacinda is a functional pattern filtering language, inspired by 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 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}'

Documentation

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

The manpages document the builtins and provide a syntax reference.

See the rosetta showing AWK alongside, or the [examples][./EXAMPLES.md] for its own capabilities.

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.