File: README.rst

package info (click to toggle)
immer 0.8.1%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 5,132 kB
  • sloc: cpp: 27,932; python: 534; makefile: 227; lisp: 175; sh: 114; javascript: 64
file content (42 lines) | stat: -rw-r--r-- 1,287 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

Python bindings
===============

This library includes experimental bindings that provide efficient immutable
vectors for the Python language.  They were developed as part of the
research for the `ICFP'17 paper`_.  The interface is quite
**incomplete**, yet you can already do some things like:

.. literalinclude:: ../extra/python/example.py
   :language: python
   :start-after: intro/start
   :end-before:  intro/end
..

    **Do you want to help** making these bindings complete and production
    ready?  Drop a line at `immer@sinusoid.al
    <mailto:immer@sinusoid.al>`_ or `open an issue on GitHub
    <https://github.com/arximboldi/immer>`_

Installation
------------
::

    pip install --user git+https://github.com/arximboldi/immer.git

Benchmarks
----------

The library includes a set of benchmarks that compare it to
`pyrsistent <https://github.com/tobgu/pyrsistent>`_.  You can see the
results in the `ICFP'17 paper`_.  If you want to run them yourself,
you need to install some dependencies::

     pip install --user pytest-benchmark pyrsistent

Then you need to clone the `project repository
<https://github.com/arximboldi/immer>`_ and from its root, run::

     pytest extra/python/benchmark

.. _ICFP'17 paper: https://public.sinusoid.es/misc/immer/immer-icfp17.pdf