1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
Metadata-Version: 2.1
Name: rpy2
Version: 3.5.17
Summary: Python interface to the R language (embedded R)
Author-email: Laurent Gautier <lgautier@gmail.com>
License: GPLv2+
Project-URL: Homepage, https://rpy2.github.io
Project-URL: Documentation, https://rpy2.github.io/doc.html
Project-URL: Source, https://github.com/rpy2/rpy2
Project-URL: Tracker, https://github.com/rpy2/rpy2/issue
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: cffi>=1.15.1
Requires-Dist: jinja2
Requires-Dist: tzlocal
Requires-Dist: packaging; platform_system == "Windows"
Requires-Dist: typing-extensions; python_version < "3.8"
Requires-Dist: backports.zoneinfo; python_version < "3.9"
Provides-Extra: doc
Requires-Dist: ipykernel; extra == "doc"
Requires-Dist: jupytext; extra == "doc"
Requires-Dist: multipledispatch; extra == "doc"
Requires-Dist: nbconvert; extra == "doc"
Requires-Dist: numpy; extra == "doc"
Requires-Dist: pandas; extra == "doc"
Requires-Dist: pygraphviz; extra == "doc"
Requires-Dist: sphinx; extra == "doc"
Provides-Extra: test-minimal
Requires-Dist: pytest>=8; extra == "test-minimal"
Requires-Dist: coverage; extra == "test-minimal"
Requires-Dist: pytest-cov; extra == "test-minimal"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: ipython; extra == "test"
Requires-Dist: numpy>=1.26; python_version >= "3.9" and extra == "test"
Requires-Dist: numpy<1.26; python_version < "3.9" and extra == "test"
Requires-Dist: pandas>=1.3.5; python_version >= "3.10" and extra == "test"
Requires-Dist: pandas; python_version < "3.10" and extra == "test"
Provides-Extra: numpy
Requires-Dist: numpy>=1.26; python_version >= "3.9" and extra == "numpy"
Requires-Dist: numpy<1.26; python_version < "3.9" and extra == "numpy"
Provides-Extra: pandas
Requires-Dist: numpy>=1.26; python_version >= "3.9" and extra == "pandas"
Requires-Dist: numpy<1.26; python_version < "3.9" and extra == "pandas"
Requires-Dist: pandas>=1.3.5; python_version >= "3.10" and extra == "pandas"
Requires-Dist: pandas; python_version < "3.10" and extra == "pandas"
Provides-Extra: types
Requires-Dist: mypy; extra == "types"
Requires-Dist: types-tzlocal; extra == "types"
Provides-Extra: all
Requires-Dist: pytest; extra == "all"
Requires-Dist: ipython; extra == "all"
Requires-Dist: numpy>=1.26; python_version >= "3.9" and extra == "all"
Requires-Dist: numpy<1.26; python_version < "3.9" and extra == "all"
Requires-Dist: pandas>=1.3.5; python_version >= "3.10" and extra == "all"
Requires-Dist: pandas; python_version < "3.10" and extra == "all"
# Python -> R bridge
[](https://pypi.python.org/pypi/rpy2)
[](https://codecov.io/gh/rpy2/rpy2)
[](https://github.com/rpy2/rpy2/actions?query=workflow%3A%22Python+package%22)
The project's webpage is here: https://rpy2.github.io/
# Installation
`pip` should work out of the box:
```bash
pip install rpy2
```
The package has optional depencies providing
specific functionalities not otherwise required to use the rest of rpy2.
For example, to be able to run the unit tests:
```bash
pip install rpy2[test]
```
To install all optional dependencies (numpy, pandas, ipython), use:
```bash
pip install rpy2[all]
```
The package is known to compile on Linux, MacOSX
(provided that developper tools are installed, and you are ready
figure out how by yourself). The situation is currently a little
more complicated on Windows. Check the issue tracker.
In case you find yourself with this source without any idea
of what it takes to compile anything on your platform, try first
```bash
python setup.py install
```
## Issues loading shared C libraries
Whenever R is in not installed in a system location, the system might not
know where to find the R shared library.
If `R` is in the `PATH`, that is entering `R` on the command line successfully starts
an R terminal, but rpy2 does not work because of missing C libraries, try the following
before starting Python:
```bash
export LD_LIBRARY_PATH="$(python -m rpy2.situation LD_LIBRARY_PATH)":${LD_LIBRARY_PATH}
```
# Documentation
Documentation is available either in the source tree (`doc/`),
or [online](https://rpy2.github.io/doc.html).
## Testing
`rpy2` uses `pytest`, with the plugin `pytest-cov` for code coverage. To
test the package from the source tree, either to check and installation
on your system or before submitting a pull request, do:
```bash
pytest tests/
```
For code coverage, do:
```bash
pytest --cov=rpy2.rinterface_lib \
--cov=rpy2.rinterface \
--cov=rpy2.ipython \
--cov=rpy2.robject \
tests
```
For more options, such as how to run specify tests, please refer to the `pytest`
documentation.
# License
RPy2 can be used under the terms of the GNU
General Public License Version 2 or later (see the file
gpl-2.0.txt). This is the very same license R itself is released under.
|
