codereport / jellyfish

A fork of Jelly (recreational programming language inspired by J) that fixes bugs I have run into and extends the language.

🪼 Jellyfish 🪼

Jellyfish is an extension of the Jelly programming language created by Dennis Mitchell. Please visit his repo for the original documentation. This repo will focus on fixes and extensions as well as additional documention when I think it may be helpful.

Note that the primary way I interact with Jelly(fish) is through the Jello REPL. This allows you to write Jello keywords instead of Jelly atoms. It also visually diagrams the combinator trees that are implicitly created from the monadic, dyadic and multichains. You can find the Jello repo here.

Installing

git clone -q https://github.com/codereport/jellyfish.git
cd jellyfish
pip3 install --upgrade --user .

Using

The intended way of using Jellyfish is through the Jello REPL.

Differences

Additions

Atoms

• ṕ (Q's prior)
• É (dual to odd? i.e. even?)
• ① (bits aka bit_count, pop_count or ones_count)
• ḳ (Uiua's keep and BQN/APL's compress/replicate)
• Ḿ (Q's maxs)
• Ṕ (Uiua's partition - we are calling it part)
• Ꝑ (adding part_by - a generalization of part)
• ≤ (less than equal to)
• ≥ (greater than equal to)
• Œɠ (previously group_len, this is a quick similar to key)
• Ď (Q's differ)

Chains

• D₂: previously spelled l f₁ : g₂ : r h₁ and now g₂ f₁ h₁

Changes

• Ḣ: head does not modify the underlying sequence
• Ṫ: last does not modify the underlying sequence
• ÐṀ: max_by returns a single value instead of list

Deletions

• Œɠ: delete group_len; it can now be spelled len group

Fixes

• Ẓ: isprime was broken, now fixed

jellyfish's Issues

You should use launch.json to debug jellyfish

It was a bit painful to watch you do printf debugging on one of the streams.

for more info see https://code.visualstudio.com/docs/python/debugging#_initialize-configurations

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python Debugger: Current File with Arguments",
            "type": "debugpy",
            "request": "launch",
            "program": "jelly/__main__.py",
            "console": "integratedTerminal",
            "args": "eun 'µ‘Θ,,' 1 10"
        }
    ]
}

BUG: `iota is_prime`

BUG: `(+ * r) scan maxr`

FEATURE: Missing atoms

These are the major things missing from Jelly(fish):

Major

• Uiua's ⊜ (partition) modifier -> part & part_with
  • note that Uiua's ⊜ is a mask cut and part & part_with are predicate cuts
• Q's prior (a 2-wise reduce)
• BQN's ⌾ (under)
  • although maybe there is no real need because everything is a single character atom
• Uiua's ▽ (keep) / BQN's / (replicate)

Minor

• BQN's ⊒ (occurrence count)
• [ ] Dyalog APL's ≠ (unique mask)
  • Turns out Jelly has this "ŒQ" (distinct sieve)
• Q maxs
• #7

FEATURE: Q `differ`

https://code.kx.com/q4m3/A_Built-in_Functions/#a24-differ