Skip to main content

No project description provided

Project description

Build Status

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

  1. 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).
  2. 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

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

Project details


Release history Release notifications | RSS feed

This version

43

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gamla-43.tar.gz (22.0 kB view details)

Uploaded Source

Built Distribution

gamla-43-py3-none-any.whl (120.8 kB view details)

Uploaded Python 3

File details

Details for the file gamla-43.tar.gz.

File metadata

  • Download URL: gamla-43.tar.gz
  • Upload date:
  • Size: 22.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

File hashes

Hashes for gamla-43.tar.gz
Algorithm Hash digest
SHA256 95cabd921e75e0a1e9f45a0c7bb493997401554a5aaf976ef425e7f538ed60f0
MD5 fa80a91e2f9fae969682fc4374e6289a
BLAKE2b-256 771785141adf2b6d1e5a420d2e380c3019dcafccab0d6ee55b10d07caec165ac

See more details on using hashes here.

File details

Details for the file gamla-43-py3-none-any.whl.

File metadata

  • Download URL: gamla-43-py3-none-any.whl
  • Upload date:
  • Size: 120.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

File hashes

Hashes for gamla-43-py3-none-any.whl
Algorithm Hash digest
SHA256 b29088c54b9dbbc4052076d042b8a2a3e4205e3b087da2edb5e64c8bff0bf29d
MD5 f843b1b7a1bf22de9c78eb3141fb3ac7
BLAKE2b-256 1ad25156a83be6ae4f7fb1cb5c76fd31d8e41a692131ced6094b7b3d3a56b4bf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page