Forked Composition, Equality, and More

Forked Composition

Proc compositions work by passing the result of one proc call as input to the next—this is known as piping. Here's a simple composition to illustrate how piping works in practice:

core.echo("hello")
| type.string.upcase
| type.string.reverse

Calling this composition returns "OLLEH" as the result.

In large compositions this can get unwieldy. This release includes a new core.pipe proc that lets you use the same piping semantics while breaking large compositions into more organized parts. For example, the result of the composition above might need to be stored in the key-value store:

core.echo("hello")
| type.string.upcase
| type.string.reverse
| keyv.set(bucket: "some-bucket", key: "some-key")

It might be more readable to separate the string manipulation logic from the interation with the key-value store. This is now possible with core.pipe:

core.echo("hello")
| core.pipe {
    type.string.upcase
    | type.string.reverse
  }
| keyv.set(bucket: "some-bucket", key: "some-key")

Similarly, it's sometimes desired to perform some work without modifying the input to the next proc call. The new core.fork proc can be used to create a completely isolated fork within a composition:

core.echo("hello")
| core.fork {
    keyv.transform(bucket: "some-bucket", key: "call-count", set: 0) {
      math.add(value: 1)
    }
  }
| type.string.upcase

When called, the key-value store counter is incremented in an isolated fork before passing the original input to type.string.upcase. The result of composition is "HELLO". If we were to use core.pipe instead of core.fork, the return value of keyv.transform would replace the original input of "hello".

Equality Checks

All built-in types now include a proc for checking equality, including:

• type.array.equal
• type.hash.equal
• type.number.equal
• type.string.equal

Every equal proc returns true if the value matches the input, or false otherwise:

type.number.equal(1, value: 2)

Other Improvements

• Even number check. Adds a new type.number.even proc that returns true or false if a given number is even or odd respectively.

• Break strings into characters. Adds a new type.string.characters proc that breaks a given string into a character array.

• Remove characters from a string. Adds a new type.string.chomp proc that removes characters from the start or end of a string.

• Downcase a string. Adds a new type.string.downcase proc that downcases every character in a string to be lowercase.

• Check if a string is empty. Adds a new type.string.empty proc that returns true if a given string only contains whitespace.

• Get a string's length. Adds a new type.string.length proc that returns the length of a given string as an integer.

• Swap the casing of a string. Adds a new type.string.swapcase proc that swaps the casing of a given string.