1
1
rust-numpy
2
2
===========
3
- [ ![ Actions Status] ( https://github.com/pyo3 /rust-numpy/workflows/CI/badge.svg )] ( https://github.com/pyo3 /rust-numpy/actions )
4
- [ ![ Crate] ( http ://meritbadge.herokuapp.com/ numpy)] ( https://crates.io/crates/numpy )
5
- [ ![ minimum rustc 1.41] ( https://img.shields.io/badge/rustc-1.41+-blue.svg )] ( https://rust-lang.github.io/rfcs/2495-min-rust-version.html )
3
+ [ ![ Actions Status] ( https://github.com/PyO3 /rust-numpy/workflows/CI/badge.svg )] ( https://github.com/PyO3 /rust-numpy/actions )
4
+ [ ![ Crate] ( https ://img.shields.io/crates/v/ numpy.svg )] ( https://crates.io/crates/numpy )
5
+ [ ![ Minimum rustc 1.41] ( https://img.shields.io/badge/rustc-1.41+-blue.svg )] ( https://rust-lang.github.io/rfcs/2495-min-rust-version.html )
6
6
7
- Rust bindings for the NumPy C-API
7
+ Rust bindings for the NumPy C-API.
8
8
9
9
## API documentation
10
10
- [ Latest release (possibly broken)] ( https://docs.rs/numpy )
11
- - [ Current Master ] ( https://pyo3.github.io/rust-numpy )
11
+ - [ Current main ] ( https://pyo3.github.io/rust-numpy )
12
12
13
13
14
14
## Requirements
15
15
- Rust >= 1.41.1
16
- - Basically, our MSRV follows the one of [ PyO3] ( https://github.com/PyO3/pyo3 ) .
16
+ - Basically, our MSRV follows the one of [ PyO3] ( https://github.com/PyO3/pyo3 )
17
17
- Python >= 3.6
18
18
- Python 3.5 support is dropped from 0.13
19
19
- Some Rust libraries
20
- - [ ndarray] ( https://github.com/bluss /ndarray ) for rust -side matrix library
21
- - [ PyO3] ( https://github.com/PyO3/pyo3 ) for cpython binding
22
- - and more (see [ Cargo.toml] ( Cargo.toml ) )
23
- - [ numpy] ( http ://www. numpy.org/) installed in your python environments (e.g., via ` pip install numpy ` )
24
- - We recommend ` numpy >= 1.16.0 ` , though older version may work.
25
-
26
- ** Note**
27
- Starting from 0.3, rust-numpy migrated from rust-cpython to pyo3 .
20
+ - [ ndarray] ( https://github.com/rust-ndarray /ndarray ) for Rust -side matrix library
21
+ - [ PyO3] ( https://github.com/PyO3/pyo3 ) for Python bindings
22
+ - And more (see [ Cargo.toml] ( Cargo.toml ) )
23
+ - [ numpy] ( https ://numpy.org/) installed in your Python environments (e.g., via ` pip install numpy ` )
24
+ - We recommend ` numpy >= 1.16.0 ` , though older versions may work
25
+
26
+ ** Note: **
27
+ Starting from 0.3, rust-numpy migrated from rust-cpython to PyO3 .
28
28
If you want to use rust-cpython, use version 0.2.1 from crates.io.
29
29
30
30
31
- ## Python2 Support
32
- Version 0.5.0 is the last version that supports Python2 .
31
+ ## Python 2 support
32
+ Version 0.5.0 is the last version that supports Python 2 .
33
33
34
- If you want to compile this library with Python2 , please use 0.5.0 from crates.io.
34
+ If you want to compile this library with Python 2 , please use 0.5.0 from crates.io.
35
35
36
36
In addition, you have to add a feature flag in ` Cargo.toml ` like
37
37
``` toml
38
38
[dependencies .numpy ]
39
39
version = " 0.5.0"
40
40
features = [" python2" ]
41
41
```
42
- .
43
42
44
- You can also automatically specify python version in ` setup.py ` ,
43
+ You can also automatically specify the Python version in ` setup.py ` ,
45
44
using [ setuptools-rust] ( https://github.com/PyO3/setuptools-rust ) .
46
45
47
46
@@ -50,7 +49,7 @@ using [setuptools-rust](https://github.com/PyO3/setuptools-rust).
50
49
This crate uses types from ` ndarray ` in its public API. ` ndarray ` is re-exported
51
50
in the crate root so that you do not need to specify it as a direct dependency.
52
51
53
- Furthermore, this crate is compatible multiple versions of ` ndarray ` and therefore depends
52
+ Furthermore, this crate is compatible with multiple versions of ` ndarray ` and therefore depends
54
53
on a range of semver-incompatible versions, currently ` >= 0.13, < 0.16 ` . Cargo does not
55
54
automatically choose a single version of ` ndarray ` by itself if you depend directly or indirectly
56
55
on anything but that exact range. It can therefore be necessary to manually unify these dependencies.
@@ -108,7 +107,7 @@ fn main() -> PyResult<()> {
108
107
109
108
### Write a Python module in Rust
110
109
111
- Please see [ simple-extension] ( https://github.com/PyO3/rust-numpy/tree/main/examples/simple-extension )
110
+ Please see the [ simple-extension] ( https://github.com/PyO3/rust-numpy/tree/main/examples/simple-extension )
112
111
directory for the complete example.
113
112
Also, we have an example project with [ ndarray-linalg] ( https://github.com/PyO3/rust-numpy/tree/main/examples/linalg ) .
114
113
@@ -168,11 +167,11 @@ fn rust_ext(_py: Python<'_>, m: &PyModule) -> PyResult<()> {
168
167
}
169
168
```
170
169
171
- ## Conributing
172
- We welcome [ issues] ( https://github.com/rust-numpy /rust-numpy/issues )
173
- and [ pull requests] ( https://github.com/rust-numpy /rust-numpy/pulls ) .
170
+ ## Contributing
171
+ We welcome [ issues] ( https://github.com/PyO3 /rust-numpy/issues )
172
+ and [ pull requests] ( https://github.com/PyO3 /rust-numpy/pulls ) .
174
173
175
- PyO3's [ contrinbuting .md] ( https://github.com/PyO3/pyo3/blob/main/Contributing.md )
174
+ PyO3's [ Contributing .md] ( https://github.com/PyO3/pyo3/blob/main/Contributing.md )
176
175
is a nice guide for starting.
177
- Also, we have a [ gitter ] ( https://gitter.im/PyO3/Lobby ) channel for communicating.
176
+ Also, we have a [ Gitter ] ( https://gitter.im/PyO3/Lobby ) channel for communicating.
178
177
0 commit comments