From 69ab37f515e448039ee33249ad4eedebf598d52b Mon Sep 17 00:00:00 2001 From: "mergify[bot]" <37929162+mergify[bot]@users.noreply.github.com> Date: Wed, 26 Jul 2023 17:51:30 +0000 Subject: [PATCH] Add a section to Python docs about page for rustworkx-core (#944) (#945) * Add a section to Python docs about page for rustworkx-core The main page explaining the rustworkx library in the Python docs previously didn't make any mention of rustworkx-core. While in general the Python side is built on top of rustworkx-core and the vast majority of the users of the Python library don't need to know about the pure Rust library inside, it is still good to highlight its existence in case anyone finds the Python library but is really interested in consuming it from Rust. This commit just adds a small subsection to the about page explaining the existence of rustworkx-core, its purpose, and where you can find mroe information about it. * Apply suggestions from code review Co-authored-by: Edwin Navarro --------- Co-authored-by: Edwin Navarro (cherry picked from commit 2a16d21ad22cbe5f7fa1f836a7198dfd3faece35) Co-authored-by: Matthew Treinish --- docs/source/index.rst | 21 ++++++++++++++++++++- rustworkx-core/README.md | 9 +++++++-- 2 files changed, 27 insertions(+), 3 deletions(-) diff --git a/docs/source/index.rst b/docs/source/index.rst index b5f1d17cc..26ec65d00 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -4,7 +4,7 @@ rustworkx Documentation .. note:: - The project has been renamed to **rustworkx**. You can still use the legavcy + The project has been renamed to **rustworkx**. You can still use the legacy retworkx name for now but starting in the 1.0.0 release the retworkx name will no longer be supported. @@ -35,6 +35,25 @@ MacOS on x86_64, and arm64, and Windows 32bit and 64bit systems. However, if you are not running on one of these platforms, you will need a rust compiler to install rustworkx. +rustworkx-core +-------------- + +In addition to the Python library, as part of rustworkx a standalone Rust library +is also included. This library provides a generic interface for Rust users +that wish to use the same graph algorithm implementations exposed in the Python +library. This library, rustworkx-core, is used to build the Python rustworkx +library but can be used for any Rust application that needs the same graph +functionality that rustworkx provides. + +You can find more details on rustworkx-core here: + +https://crates.io/crates/rustworkx-core + +and the documentation for the library is hosted here: + +https://docs.rs/rustworkx-core/0.13.0/rustworkx_core/ + + Project history --------------- diff --git a/rustworkx-core/README.md b/rustworkx-core/README.md index c4647fff4..26487b106 100644 --- a/rustworkx-core/README.md +++ b/rustworkx-core/README.md @@ -7,7 +7,12 @@ > If you're using retworkx-core 0.11.0 you will need to change your requirement > and use statements to use the new crate name -This crate contains the rust library rustworkx-core. This library is part of the +rustworkx-core is a graph algorithm library that is built on top of +[petgraph](https://github.com/petgraph/petgraph). It offers additional +algorithms and functionality on top of the core data structures offered in +the petgraph library. + +This crate contains the Rust library rustworkx-core. This library is part of the rustworkx project. However while the larger rustworkx project is a Python library that offers a general purpose high performance graph library written in Rust, rustworkx-core is a pure rust library that offers a stable rust API for any @@ -18,7 +23,7 @@ At it's core rustworkx is built on top of the Python layer. However, many of the algorithms (and to a lesser extent data structures) needed for rustworkx are not available in petgraph. For places where these algorithms are implemented in a generic way the rustworkx-core -crate exposes it for rust users. +crate exposes it for Rust users. ## Usage