jacinda: Functional, expression-oriented data processing language

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Warnings:

[option-o2] 'ghc-options: -O2' is rarely needed. Check that it is giving a real benefit and not just imposing longer compile times on your users.
[missing-upper-bounds] On library 'jacinda-lib', these packages miss upper bounds: - bytestring - text - prettyprinter - containers - array - mtl - transformers - regex-rure - microlens - directory - filepath - microlens-mtl - vector - split - deepseq - lazy-csv Please add them. There is more information at https://pvp.haskell.org/
[missing-upper-bounds] On executable 'ja', these packages miss upper bounds: - optparse-applicative Please add them. There is more information at https://pvp.haskell.org/

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

[Skip to Readme]

Properties

Versions	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, 3.3.0.1, 3.3.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), 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-12-13T22:06:54Z

library jacinda:jacinda-lib

Modules

A
File
Jacinda
- Jacinda.Regex
Parser
Ty

Flags

Manual Flags

Name	Description	Default
cross	Enable to ease cross-compiling	Disabled

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

Downloads

jacinda-3.3.0.1.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

vmchale

For package maintainers and hackage trustees

edit package information

Readme for jacinda-3.3.0.1

[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.

Nix

Jacinda is available as a Nix package (thanks to Lukas Epple, who is the maintainer).

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 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

Rust's regular expressions
- extensively documented with Unicode support
Deduplicate builtin

Contributing

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

Bug reports are welcome contributions.