From 6dd9e7e786007abe10566d230e8c5389e8e182d1 Mon Sep 17 00:00:00 2001 From: Matthew Treinish Date: Wed, 26 Jul 2023 13:23:03 -0400 Subject: [PATCH] Add a section to Python docs about page for rustworkx-core (#944) * 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 --- 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 b5f1d17ccc..26ec65d001 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 c4647fff48..26487b1063 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