- tools

⚠️WARNING⚠️ Jth is still very much a work in progress.

• Many ideas around how the language should work are up in the air.
• Many bugs exist in the implementation.

Basic tools for jth.

Note that by convention, functions that operate on the stack (by taking and returning an array) are suffixed with "$".

Installation

Dependencies: node/npm

Install with command:

npm install jth-tools

In-File Usage

identity$

Returns current stack

import { identity$ } from "jth-tools";
1 2 3 identity$!! @!!; /*prints "1 2 3"*/

clear$

Clears current stack

import { clear$ } from "jth-tools";
1 2 3 clear$!! @!!; /*prints ""*/

collect$

Converts current stack int an array

import { collect$ } from "jth-tools";
1 2 3 collect$!! @!!; /*prints "[1,2,3]"*/

repeat$

Repeats current stack

import { repeat$ } from "jth-tools";
1 2 3 repeat$!! @!!; /*prints "1 2 3 1 2 3"*/

repeat$

Duplicates last item on stack

import { dupe$ } from "jth-tools";
1 2 3 dupe$!! @!!; /*prints "1 2 3 3"*/

if$

Keeps last item if truthy

import { if$ } from "jth-tools";
1 2 3 if$!! @!!; /*prints "1 2 3"*/
1 2 0 if$!! @!!; /*prints "1 2"*/

ifElse$

Keeps all items if last is truthy. Removes all items otherwise.

import { ifElse$ } from "jth-tools";
1 2 3 ifElse$!! @!!; /*prints "1 2 3"*/
1 2 0 if$!! @!!; /*prints ""*/

equal$

Replaces stack with true if all items are equal. Replaces stack with false otherwise.

import { equal$ } from "jth-tools";
1 2 3 3 equal$!! @!!; /*prints "true"*/
1 2 3 4 if$!! @!!; /*prints "false"*/

and$

Keep items on stack unless a falsy one is encountered.

import { and$ } from "jth-tools";
1 2 3 and$!! @!!; /*prints "1 2 3"*/
1 0 3 and$!! @!!; /*prints ""*/

or$

Pops items from stack until a truthy one is encountered.

import { or$ } from "jth-tools";
1 2 3 4 and$!! @!!; /*prints "1 2 3 4"*/
1 0 3 0 and$!! @!!; /*prints "1 0 3"*/

reverse$

Reverse the current stack.

import { reverse$ } from "jth-tools";
1 2 3 reverse$!! @!!; /*prints "3 2 1"*/
1 2 3 reverse$!! reverse$!! @!!; /_prints "1 2 3"_/

first$

Replace items on stack with first item

import { first$ } from "jth-tools";
1 2 3 first$!! @!!; /*prints "1"*/

dropFirst$

Drop first item on stack

import { dropFirst$ } from "jth-tools";
1 2 3 dropFirst$!! @!!; /*prints "2 3"*/

last$

Replace items on stack with last item

import { last$ } from "jth-tools";
1 2 3 last$!! @!!; /_prints "3"_/

dropLast$

Drop last item on stack

import { dropLast$ } from "jth-tools";
1 2 3 dropLast$!! @!!; /*prints "1 2"*/

map$

Apply map to stack

import { map$ } from "jth-tools";
1 2 3 (x=>x**x) map$!! @!!; /*prints "1 4 27"*/

filter$

Apply filter to stack

import { filter$ } from "jth-tools";
1 2 3 (x=>x*%2) filter$!! @!!; /*prints "1 3"*/

to$

Add integers in the range (m, n) to the stack

import { to$ } from "jth-tools";
4 10 to$!! @!!; /*prints "5 6 7 8 9"*/

fromTo$

Add integers in the range [m, n) to the stack

import { fromTo$ } from "jth-tools";
4 10 fromTo$!! @!!; /*prints "4 5 6 7 8 9"*/

toInc$

Add integers in the range (m, n] to the stack

import { toInc$ } from "jth-tools";
4 10 toInc$!! @!!; /*prints "5 6 7 8 9 10"*/

fromToInc$

Add integers in the range [m, n] to the stack

import { fromToInc$ } from "jth-tools";
4 10 fromToInc$!! @!!; /*prints "4 5 6 7 8 9 10"*/