A python graph library implemented in Rust

These details have not been verified by PyPI

Project links

Project description

retworkx

You can see the full rendered docs at: https://retworkx.readthedocs.io/en/latest/index.html

retworkx is a rust graph library interface to python3. For right now it's scope is as a replacement for qiskit-terra's previous (and current) networkx usage (hence the name). The scope might grow or change over time, but to start it's just about building a DAG and operating on it with the performance and safety that Rust provides.

Installing retworkx

retworkx is published on pypi so on x86_64, i686, ppc64le, and aarch64 Linux systems, x86_64 on Mac OSX, and 32 and 64 bit Windows installing is as simple as running:

pip install retworkx

This will install a precompiled version of retworkx into your python environment.

However, if there are no precompiled binaries published for your system you'll have to compile the code. The source package is also published on pypi so you can also run the above command to install it. However, there are 2 preconditions for this to work, first you need to have cargo/rustc nightly in your PATH. You can use rustup to make this step simpler. Secondly, you need to have setuptools-rust installed in your python environment. This can can be done by simply running:

pip install setuptools-rust

prior to running:

pip install retworkx

If you have rust nightly properly installed pip will compile retworkx for your local system and it should run just as the prebuilt binaries would.

Building from source

The first step for building retworkx from source is to clone it locally with:

git clone https://github.com/Qiskit/retworkx.git

retworkx uses PyO3 and setuptools-rust to build the python interface. Unfortunately, this means you need to use nightly rust because PyO3 only works with nightly at this point. You can use rustup to install rust nightly.

Once you have nightly rust and cargo installed you can easily install retworkx into your python environment using pip. Once you have a local clone of the repo, change your current working directory to the root of the repo. To set the compiler for retworkx to nightly rust using rustup, run the following from this directory:

rustup override set nightly

(MacOS users shoud instead run rustup default nightly to enable nightly rust globally.)

Then, you can install retworkx into your python env with:

pip install .

Assuming your current working directory is still the root of the repo. Otherwise you can run:

pip install $PATH_TO_REPO_ROOT

which will install it the same way. Then retworkx is installed inyour local python environment. There are 2 things to note when doing this though, first if you try to run python from the repo root using this method it will not work as you expect. There is a name conflict in the repo root because of the local python package shim used in building the package. Simply run your python scripts or programs using retworkx outside of the repo root. The second issue is that any local changes you make to the rust code will not be reflected live in the python you'll need to recompile the source by rerunning pip install to have any changes reflected in your python environment.

Using retworkx

Once you have retworkx installed you can use it by importing retworkx. All the functions and the PyDAG class are off the root of the package. For example, building a DAG and adding 2 nodes with an edge between them would be:

import retworkx

my_dag = retworkx.PyDAG()
# add_node(), add_child(), and add_parent() return the node index
# The sole argument here can be any python object
root_node = my_dag.add_node("MyRoot")
# The second and third arguments can be any python object
my_dag.add_child(root_node, "AChild", ["EdgeData"])

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

0.15.1

Jun 28, 2024

0.15.0

Jun 27, 2024

0.14.2

Mar 12, 2024

0.14.1

Feb 22, 2024

0.14.0

Jan 23, 2024

0.13.2

Oct 3, 2023

0.13.1

Jul 31, 2023

0.13.0

Jun 7, 2023

0.12.1

Nov 23, 2022

0.12.0

Oct 7, 2022

0.11.0

Jan 19, 2022

0.10.2

Sep 8, 2021

0.10.1

Aug 25, 2021

0.10.0

Aug 25, 2021

0.9.0

Jun 1, 2021

0.8.0

Mar 2, 2021

0.7.2

Dec 14, 2020

0.7.1

Dec 3, 2020

0.7.0

Dec 3, 2020

0.6.0

Nov 12, 2020

0.5.0

Sep 18, 2020

0.4.0

Jul 17, 2020

0.3.4

Apr 27, 2020

This version

0.3.3

Mar 18, 2020

0.3.2

Mar 13, 2020

0.3.1

Mar 6, 2020

0.3.0

Feb 20, 2020

0.2.0

Feb 10, 2020

0.1.1

Jan 31, 2020

0.1.0

Jan 27, 2020

0.0.10

Sep 18, 2019

0.0.9

May 31, 2019

0.0.8

May 22, 2019

0.0.7

May 16, 2019

0.0.6

May 15, 2019

0.0.5

May 14, 2019

0.0.3

May 13, 2019

0.0.2

May 13, 2019

0.0.1

May 11, 2019

Download files

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

Source Distribution

retworkx-0.3.3.tar.gz (14.9 kB view details)

Uploaded Mar 18, 2020 Source

Built Distributions

retworkx-0.3.3-cp38-cp38-win_amd64.whl (165.5 kB view details)

Uploaded Mar 18, 2020 CPython 3.8 Windows x86-64

retworkx-0.3.3-cp38-cp38-win32.whl (154.1 kB view details)

Uploaded Mar 18, 2020 CPython 3.8 Windows x86

retworkx-0.3.3-cp38-cp38-manylinux2014_ppc64le.whl (949.7 kB view details)

Uploaded Mar 18, 2020 CPython 3.8

retworkx-0.3.3-cp38-cp38-manylinux2014_aarch64.whl (769.3 kB view details)

Uploaded Mar 18, 2020 CPython 3.8

retworkx-0.3.3-cp38-cp38-manylinux2010_x86_64.whl (783.5 kB view details)

Uploaded Mar 18, 2020 CPython 3.8 manylinux: glibc 2.12+ x86-64

retworkx-0.3.3-cp38-cp38-manylinux2010_i686.whl (861.1 kB view details)

Uploaded Mar 18, 2020 CPython 3.8 manylinux: glibc 2.12+ i686

retworkx-0.3.3-cp38-cp38-manylinux1_x86_64.whl (783.4 kB view details)

Uploaded Mar 18, 2020 CPython 3.8

retworkx-0.3.3-cp38-cp38-manylinux1_i686.whl (861.1 kB view details)

Uploaded Mar 18, 2020 CPython 3.8

retworkx-0.3.3-cp38-cp38-macosx_10_15_x86_64.whl (209.3 kB view details)

Uploaded Mar 18, 2020 CPython 3.8 macOS 10.15+ x86-64

retworkx-0.3.3-cp38-cp38-macosx_10_13_x86_64.whl (210.1 kB view details)

Uploaded Mar 19, 2020 CPython 3.8 macOS 10.13+ x86-64

retworkx-0.3.3-cp37-cp37m-win_amd64.whl (165.5 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m Windows x86-64

retworkx-0.3.3-cp37-cp37m-win32.whl (154.1 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m Windows x86

retworkx-0.3.3-cp37-cp37m-manylinux2014_ppc64le.whl (949.7 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m

retworkx-0.3.3-cp37-cp37m-manylinux2014_aarch64.whl (769.3 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m

retworkx-0.3.3-cp37-cp37m-manylinux2010_x86_64.whl (783.5 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m manylinux: glibc 2.12+ x86-64

retworkx-0.3.3-cp37-cp37m-manylinux2010_i686.whl (861.1 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m manylinux: glibc 2.12+ i686

retworkx-0.3.3-cp37-cp37m-manylinux1_x86_64.whl (783.5 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m

retworkx-0.3.3-cp37-cp37m-manylinux1_i686.whl (861.1 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m

retworkx-0.3.3-cp37-cp37m-macosx_10_15_x86_64.whl (209.3 kB view details)

Uploaded Mar 18, 2020 CPython 3.7m macOS 10.15+ x86-64

retworkx-0.3.3-cp37-cp37m-macosx_10_13_intel.whl (210.1 kB view details)

Uploaded Mar 19, 2020 CPython 3.7m macOS 10.13+ intel

retworkx-0.3.3-cp36-cp36m-win_amd64.whl (165.7 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m Windows x86-64

retworkx-0.3.3-cp36-cp36m-win32.whl (154.4 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m Windows x86

retworkx-0.3.3-cp36-cp36m-manylinux2014_ppc64le.whl (949.8 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m

retworkx-0.3.3-cp36-cp36m-manylinux2014_aarch64.whl (769.5 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m

retworkx-0.3.3-cp36-cp36m-manylinux2010_x86_64.whl (783.7 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m manylinux: glibc 2.12+ x86-64

retworkx-0.3.3-cp36-cp36m-manylinux2010_i686.whl (861.2 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m manylinux: glibc 2.12+ i686

retworkx-0.3.3-cp36-cp36m-manylinux1_x86_64.whl (783.7 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m

retworkx-0.3.3-cp36-cp36m-manylinux1_i686.whl (861.2 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m

retworkx-0.3.3-cp36-cp36m-macosx_10_15_x86_64.whl (209.5 kB view details)

Uploaded Mar 18, 2020 CPython 3.6m macOS 10.15+ x86-64

retworkx-0.3.3-cp36-cp36m-macosx_10_13_intel.whl (210.2 kB view details)

Uploaded Mar 19, 2020 CPython 3.6m macOS 10.13+ intel

retworkx-0.3.3-cp35-cp35m-win_amd64.whl (165.7 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m Windows x86-64

retworkx-0.3.3-cp35-cp35m-win32.whl (154.4 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m Windows x86

retworkx-0.3.3-cp35-cp35m-manylinux2014_ppc64le.whl (949.6 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m

retworkx-0.3.3-cp35-cp35m-manylinux2014_aarch64.whl (769.3 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m

retworkx-0.3.3-cp35-cp35m-manylinux2010_x86_64.whl (783.6 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m manylinux: glibc 2.12+ x86-64

retworkx-0.3.3-cp35-cp35m-manylinux2010_i686.whl (861.2 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m manylinux: glibc 2.12+ i686

retworkx-0.3.3-cp35-cp35m-manylinux1_x86_64.whl (783.6 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m

retworkx-0.3.3-cp35-cp35m-manylinux1_i686.whl (861.2 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m

retworkx-0.3.3-cp35-cp35m-macosx_10_13_intel.whl (210.1 kB view details)

Uploaded Mar 19, 2020 CPython 3.5m macOS 10.13+ intel

retworkx-0.3.3-cp35-cp35m-macosx_10_9_x86_64.whl (209.3 kB view details)

Uploaded Mar 18, 2020 CPython 3.5m macOS 10.9+ x86-64

File details

Details for the file retworkx-0.3.3.tar.gz.

File metadata

Download URL: retworkx-0.3.3.tar.gz
Upload date: Mar 18, 2020
Size: 14.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.6

File hashes

Hashes for retworkx-0.3.3.tar.gz
Algorithm	Hash digest
SHA256	`8721724b9d3d9e89034f3b9cbaa791283875932573b5c562a0b5968a2288744d`
MD5	`485d999f71cc4b5ee8bce99e70a81458`
BLAKE2b-256	`d4af128220eaade755d8e1d24aa10dec7a4f42b621651fd261ad9d67ebf33287`

Algorithm	Hash digest
SHA256	`4b9ac066b649730344f61840409993cc798ec8a382090cb1f1c051ea8b5adca3`
MD5	`f8ae2eaa58aa633c422d1e2551904fb2`
BLAKE2b-256	`1a05e24e497792e07bbdd0fb5207fbe0f1b0e7d296f11673e86f79db1c44b28f`

Algorithm	Hash digest
SHA256	`52afcbb6eab2404be7c2546068ce32d606034e098e71b33d0a386f147fb5435e`
MD5	`3dca90932ad1760c9bd3a0e9a2462ba2`
BLAKE2b-256	`3ec58fe22972fe13a6ff85b381ffc295747a212ea40e56288376303721118743`

Algorithm	Hash digest
SHA256	`027f2a55a0c9443d2b2d6f50b5970fa6872e8e631882a8f30e628543282497a1`
MD5	`572ddea12294b9a0ab9d2b39e73cb783`
BLAKE2b-256	`e18debd3517e7c0f2d5c7a5d8dcb9795f64ed743597f3eca654806844ecffa85`

Algorithm	Hash digest
SHA256	`9901029071bf5e973a7249a53103580a3d5fb78eb6f3ec0af7abdd2d2b71080c`
MD5	`aca6b9bc55ada6d2bed7baaa380797ac`
BLAKE2b-256	`0c1d7117cb92dc348ce87f718447f10d58717210d851cfdd431923ee0170a9bb`

Algorithm	Hash digest
SHA256	`b35bc5246850fc8117d8941fdfb7008b85ffb3c3585323a7ab0613a6c87dbd27`
MD5	`6db62fd6616d1adabfee9edca4d030de`
BLAKE2b-256	`aac23ad73f244e3ec103a58744e5ca0ed5e6527d98acec12bc24a49f94dafb46`

Algorithm	Hash digest
SHA256	`76cdc605e22c6e3382937aa1d85af93062aa3535ce5f8f6cec06ec7a0010151d`
MD5	`d4884f18650b203909bb82067b649931`
BLAKE2b-256	`51277d91e611c11f99f9d46eefaa1de13619d2f145197936a368ec3f2c010a56`

Algorithm	Hash digest
SHA256	`3b28dcc64b45030f0a029fecf8536009f9d4124206d7ffd1654c103da35d3a3a`
MD5	`82aef24b50cd3745115b9f954f50501d`
BLAKE2b-256	`8af1030fc285f1dbfc8f43ff4f87fbd304bad4fd418e45de8506058eb3ccac5d`

Algorithm	Hash digest
SHA256	`1a2f4387b869678220c8ccaa539e4c9e4a0e4793190111c4b882647886d532ad`
MD5	`9239b01dc4d37181c686673db3f8004e`
BLAKE2b-256	`a1159d9508c59fa7a83bb031e2baf96f4c88ae19376be522762d9d6e84629c75`

Algorithm	Hash digest
SHA256	`a2fd5de46880303c7a2c85e1beec6564d233fd22aacf89c84a362f38a3ea9160`
MD5	`1df835134a2ffb237e901eb7371fbd5c`
BLAKE2b-256	`9dc1d8f46db8d926c5f59e08f569942268cd293b6f9c126c454a9ba77e6f30fb`

Algorithm	Hash digest
SHA256	`d2a27bc86ee4f4819492fee4b1abce8b357c7298e6ebea05883a8f5dd4240d35`
MD5	`d7258dcefd489ab3c9780a2bdd7010ce`
BLAKE2b-256	`92d0dfbb55ec2850b76f399c05ac44149af111d348928e1f7ab5ae10a40bb500`

Algorithm	Hash digest
SHA256	`464549714f947b0b7087a3f4a4ac50ea6435a59c94588e3d29925fa8d162bc9f`
MD5	`d96a8bc3bd670a056d51c26907831118`
BLAKE2b-256	`201dab33f6110de2ce1ec82daca66e01d80c79511f143b86d7ec3f5900da85f3`

Algorithm	Hash digest
SHA256	`0e51067a5538a56bb6a9e0fc1f1d9dd88493dae75cd7d822ef2f93a94301b6e0`
MD5	`4ec8ecab2a2c75d4420e3fc0c1e4b31d`
BLAKE2b-256	`9f59211918d3b607854397f2a9af37e3a3029f22be95b1b7d25d17697c86537c`

Algorithm	Hash digest
SHA256	`94407ec1cd23c776cc31903bdba23b5929a4b0bb7dd3fbc0b6a59ba51e4f23e9`
MD5	`068fc33b793be621cff4c07e02a15f74`
BLAKE2b-256	`4b47518ae0a09d4c7a3853cca53de8db07fdd4e1fe87c7db8998d84eb575ede1`

Algorithm	Hash digest
SHA256	`92b1c7c09e44f543593d1218ba13f2394606802213a69796b08c7d0957dda25f`
MD5	`f7281f73bc8ee1d230e375a99d4df238`
BLAKE2b-256	`683bcf930abe27e1a3916febb80d35935b2e6e4266ce549d5663aca0504dc488`

Algorithm	Hash digest
SHA256	`feb30644af1a6ca4b3e6fff537a777bbbed85c8f141096740f049298a03e7fbd`
MD5	`53696034766edf7115d0f55cf5c8c9d3`
BLAKE2b-256	`b01de7325c6ec691498b8c433a7ec2a3618ed503c077adc53403a67b87b98f94`

Algorithm	Hash digest
SHA256	`24dc9c2229e9a98d9e454ec798fd30b14d73ecd82d57f2683455a86274f68f64`
MD5	`a5ae996f3206bd04dbcfcf5957d49408`
BLAKE2b-256	`b82532105c51002d25943aed6661d19dcceb70280c0d30b24bae0af6f728eb57`

Algorithm	Hash digest
SHA256	`95abec20ef4f162707dc483a4f50576b227d74c7cde87f4956ec4e2048bbf827`
MD5	`052fd6d5b3ff44507d0c17d05a179163`
BLAKE2b-256	`21e4e6bf69d2af63069e264cf0ef535353aa55caf9fdf99d22d4d6fa62b15b95`

Algorithm	Hash digest
SHA256	`9bca6058c798471ec9f52b61c1b2bda99d5b418362fd218f1d0924ca5abdfc79`
MD5	`18033f94d27918c339d1514356fbdebd`
BLAKE2b-256	`147f6b21fe12b07c1e0c798ad23e90e612419bdfa753744aa51e95c0c8c1a957`

Algorithm	Hash digest
SHA256	`ae981cad1c4171f74646afca50aeee30839d75967520cce1d0daf3a3b24d6e81`
MD5	`aa8d7c60a0203a4990e7c0404ba03361`
BLAKE2b-256	`655c658121e53dcfd363f4f5ed6dfe74e1f8b91a21e5a9661d103479a05425b3`

Algorithm	Hash digest
SHA256	`cab561430cb4332181fc3e682a3a46779171395c382d591185a46948a957ef5f`
MD5	`d8244a61c449ece2f78f59ef83b80b6b`
BLAKE2b-256	`c5b7897bc31f2c31b8b43a705cf981b4dcc3063f7fde868b1a42f7ecf6c259f0`

retworkx 0.3.3

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

retworkx

Installing retworkx

Building from source

Using retworkx

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

Algorithm	Hash digest
SHA256	`47d0bec76af4f4cb469c0ac88d8b28775a8b941036275c60ed86c2f7c35a46cb`
MD5	`70ca9cd77100649973af22c853159475`
BLAKE2b-256	`81d53184f07c2023f1e91a886f77127990018d7827b530e528f1063607b14f7f`

Algorithm	Hash digest
SHA256	`a50ec232734354bbbb1b2f1a01c5b0e878664b45b9cdc76d2f79886dddfe6692`
MD5	`a16d9c4c6c9d7e17f9c0a44461da60c7`
BLAKE2b-256	`6a503a698b00ed758636bfe720e92f6bc6362ba9e7a27d1e85c55d249adefb22`

Algorithm	Hash digest
SHA256	`75e738d07e22ee7146c89c2c717a93d20b873cd4c154e6f68a368d0445bd5156`
MD5	`06c69f6b7de944dfe6f8a0bb654390e3`
BLAKE2b-256	`fe0e98312b60bb5fb35ffe2760b43da68d5616f740ad66c19c87ce8315feaf71`

Algorithm	Hash digest
SHA256	`8603b157023f249915425d74120d98da1a41e9225b51421a4a7157ba0d4ccef2`
MD5	`5d4acfc47e782d02abc013158368e226`
BLAKE2b-256	`7539e92670dd41aa3b4b50109e0d4eb4721ba0eb5b72ac1599120cdfb6561379`

Algorithm	Hash digest
SHA256	`952aa7fe06f6bb93c7346dc270f47b7798f15f73755e9f6bc3a85ec0de6d7df5`
MD5	`d7d1c7262247bedf133d6d22a9a4b1de`
BLAKE2b-256	`7125012f14ce065d0b8a679781407491c69e716b2d53be406443a493bf6b7483`

Algorithm	Hash digest
SHA256	`73aa518f72633234534d959eda0d669c3ae22847167de56d3438aee818ebf2e0`
MD5	`d99876722d580193ca9b6870b5afdf8e`
BLAKE2b-256	`406d47d4f1aab08004afad51e04e3b2654d74adcb1cd031b4a93b4a447bd3a0c`

Algorithm	Hash digest
SHA256	`9fe0eb869dce0c208ac052353cc2114a0d9f2cb532cf9465341512378e4d00ea`
MD5	`b57f09140e4dc15e7105e7cb4ce1675b`
BLAKE2b-256	`5d6534ea72207ea396a035078f3283930c8d65d73d922a4f011061bd0993c2c3`

Algorithm	Hash digest
SHA256	`0def593d981867fdea6d216c27209b97526bfbddd871e3c260a93728d8ff7060`
MD5	`2e42e707ac0119c9bf08fdb5eff7562e`
BLAKE2b-256	`1c10f50bd23952d80eb938e543622568abf81b1d5844429ea5d58c775154efe9`

Algorithm	Hash digest
SHA256	`22acfbb3d8d1c4adc0e2036b5846b3bef94c57bdab6e47ca604385cb036eb507`
MD5	`f502ba4f8f213e8938a03cc6da1ad299`
BLAKE2b-256	`951adfc8a597bf5d516684a65cba1bfc1048d512ff96310baf3a0ca8b36752db`

Algorithm	Hash digest
SHA256	`5224432a2a3ee5fb578be5ba34aded030bd681d06eeceb6e77af50f9595b3590`
MD5	`60f73b082618ddaa23684588241541e6`
BLAKE2b-256	`b10a18405f8a8b32eb4f4eb6e1490532f21aa1cfad13e734111492c8a059b868`