gamla

גamla is a functional programming library for python which is performant and supports async.

Installation

pip install gamla

Debugging anonymous compositions

gamla.compose(x, y, z) produces a new function which doesn't have a proper name. If x raises an exception, it is sometimes hard to figure out where this occurred. To overcome this, set the env variable GAMLA_DEBUG_MODE (to anything). This will cause the composition functions to give a name for the anonymous composition. The name would be a concatenation of its constituents' names, e.g. x_of_y_of_z. The name is given in a way that persists to the stack exceptions.

This is turned on only by flag because it incurs significant overhead so things might get slow.

Mixing asynchronous and synchronous code

Most functions in this lib will work seamlessly with async and regular functions, and allow the developer to focus on the logic instead of deciding where to place an await.

For example:

import asyncio

import gamla


def increment(i):
    return i + 1


async def increment_async(i):
    asyncio.sleep(1)
    return i + 1


async def run():
    mixed_composition = gamla.compose_left(increment, increment_async, increment)
    return await mixed_composition(0)  # returns 3!

Migrating from `toolz`

The main problems - toolz is slow and does not support async functions.

Why is it slow?

It uses the expensive inspect module to look at a function’s arguments, and doing so at each run. This happens not only on curried functions, but in compositions as well.

Why does `gamla` not suffer from this problem?

Two reasons:

It does no longer support binary signatures on things like map, so it doesn’t need to infer anything (these are higher order functions in gamla).
The gamla.curry function pays for the signature inspection in advance, and remembers its results.

Function mapping and common gotchas (written in blood):

curried.(filter|map|valmap|itemmap|keymap) -> gamla.$1 (make sure the call is with a single argument)
toolz.identity -> gamla.identity
toolz.contains -> `gamla.contains
toolz.lt -> gamla.greater_than
toolz.gt -> gamla.less_than
toolz.ge -> gamla.less_equals
toolz.le -> gamla.greater_equals
toolz.filter(None) -> gamla.filter(gamla.identity)
toolz.excepts(a, b, c) -> gamla.excepts(a, c, b)
toolz.excepts(a, b) -> gamla.excepts(a, gamla.just(None), b) (following the “data-last” currying convention)

Releasing a new version

Create a pypi account.
Download twine and give it your pypi credentials.
Get pypi permissions for the project from its owner.
python setup.py sdist bdist_wheel; twine upload dist/*; rm -rf dist;

Release files for gamla 39

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gamla 39
File	Size	Uploaded
gamla-39.tar.gz	21.2 kB	Nov 4, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for gamla 39
File	Interpreter	ABI	Platform	Reset
gamla-39-py3-none-any.whl 213.7 kB Nov 4, 2020	Python 3	none	any	Details

Total release size: 234.9 kB

Release files / gamla-39.tar.gz

Download URL	gamla-39.tar.gz
Size	21.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`545c186b2cf0ad4a6576f446e182c7fbf1b8068562a02ddb06f5fb25826b662b`
BLAKE2b-256 checksum How to use checksums	`87265cf3cbef86c952a27c80aa45149dc0b7e49df711dbe68d45968556248406`
Upload date	Nov 4, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.4.2 requests/2.23.0 setuptools/49.3.1 requests-toolbelt/0.8.0 tqdm/4.48.2 CPython/3.8.6`

Release files / gamla-39-py3-none-any.whl

Download URL	gamla-39-py3-none-any.whl
Size	213.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`088fdad01f15be5c4035ed5371049ddee39f956b3c44c0453b749287a179021f`
BLAKE2b-256 checksum How to use checksums	`ff8413711eb0c2b5fb31c02883a58f603e052dd6cc244f44d06f1193b9fdefe4`
Upload date	Nov 4, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.4.2 requests/2.23.0 setuptools/49.3.1 requests-toolbelt/0.8.0 tqdm/4.48.2 CPython/3.8.6`