Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a section to Python docs about page for rustworkx-core #944

Merged
merged 2 commits into from
Jul 26, 2023
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
mtreinish marked this conversation as resolved.
Show resolved Hide resolved
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 rustworkx the Python
mtreinish marked this conversation as resolved.
Show resolved Hide resolved
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
---------------

Expand Down
9 changes: 7 additions & 2 deletions rustworkx-core/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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

Expand Down