Skip to content

Commit 6dd9e7e

Browse files
mtreinishenavarro51
authored andcommitted
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 <[email protected]> --------- Co-authored-by: Edwin Navarro <[email protected]>
1 parent fcbc81b commit 6dd9e7e

File tree

2 files changed

+27
-3
lines changed

2 files changed

+27
-3
lines changed

docs/source/index.rst

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ rustworkx Documentation
44

55
.. note::
66

7-
The project has been renamed to **rustworkx**. You can still use the legavcy
7+
The project has been renamed to **rustworkx**. You can still use the legacy
88
retworkx name for now but starting in the 1.0.0 release the retworkx name
99
will no longer be supported.
1010

@@ -35,6 +35,25 @@ MacOS on x86_64, and arm64, and Windows 32bit and 64bit systems. However, if
3535
you are not running on one of these platforms, you will need a rust compiler
3636
to install rustworkx.
3737

38+
rustworkx-core
39+
--------------
40+
41+
In addition to the Python library, as part of rustworkx a standalone Rust library
42+
is also included. This library provides a generic interface for Rust users
43+
that wish to use the same graph algorithm implementations exposed in the Python
44+
library. This library, rustworkx-core, is used to build the Python rustworkx
45+
library but can be used for any Rust application that needs the same graph
46+
functionality that rustworkx provides.
47+
48+
You can find more details on rustworkx-core here:
49+
50+
https://crates.io/crates/rustworkx-core
51+
52+
and the documentation for the library is hosted here:
53+
54+
https://docs.rs/rustworkx-core/0.13.0/rustworkx_core/
55+
56+
3857
Project history
3958
---------------
4059

rustworkx-core/README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,12 @@
77
> If you're using retworkx-core 0.11.0 you will need to change your requirement
88
> and use statements to use the new crate name
99
10-
This crate contains the rust library rustworkx-core. This library is part of the
10+
rustworkx-core is a graph algorithm library that is built on top of
11+
[petgraph](https://github.com/petgraph/petgraph). It offers additional
12+
algorithms and functionality on top of the core data structures offered in
13+
the petgraph library.
14+
15+
This crate contains the Rust library rustworkx-core. This library is part of the
1116
rustworkx project. However while the larger rustworkx project is a Python library
1217
that offers a general purpose high performance graph library written in Rust,
1318
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
1823
Python layer. However, many of the algorithms (and to a lesser extent data
1924
structures) needed for rustworkx are not available in petgraph. For places
2025
where these algorithms are implemented in a generic way the rustworkx-core
21-
crate exposes it for rust users.
26+
crate exposes it for Rust users.
2227

2328
## Usage
2429

0 commit comments

Comments
 (0)