rpy2


Namerpy2 JSON
Version 3.6.3 PyPI version JSON
download
home_pageNone
SummaryPython interface to the R language (embedded R)
upload_time2025-09-04 22:50:08
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements cffi jinja2 pytz tzlocal packaging
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Python -> R bridge

[![pypi](https://img.shields.io/pypi/v/rpy2.svg?style=flat-square)](https://pypi.python.org/pypi/rpy2)
[![Codecov](https://codecov.io/gh/rpy2/rpy2/branch/master/graph/badge.svg)](https://codecov.io/gh/rpy2/rpy2)
[![GH Actions](https://github.com/rpy2/rpy2/workflows/Python%20package/badge.svg)](https://github.com/rpy2/rpy2/actions?query=workflow%3A%22Python+package%22)

![PyPI - Downloads](https://img.shields.io/pypi/dm/rpy2?style=flat&label=pypi)
![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/rpy2?label=conda-forge)

The project's webpage is here: https://rpy2.github.io/


# Installation

Released versions can be installed from a package repository (default
being pypi) using pip:

```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]'
```

## Installation for rpy2 developers

If a developer, the package can be installed from its source tree.
`rpy2` is a namespace package with its consituting parts in different
"sub-packages".

To install from the source tree, just enter:

```bash
pip install ./rpy2-rinterface/ ./rpy2-robjects/ .
```

Various optional dependencies can be specified through dependency groups.
For example:

```bash
pip install ./rpy2-rinterface'[all]' ./rpy2-robjects'[all]' '.[all]'
```

`rpy2-rinterface` contains the binding to R's C API. Building from
source require a compilation toolchain / developper tools installed,
and you will have to figure out how to have them installed on your
system by yourself. The CI pipeline builds binary wheels for Linux,
MacOS, and Windows. Watching how things are set up there is pretty
much all documentation from the package maintainers on the matter.


## 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 rpy2-rinterface/ rpy2-robjects/
```

For code coverage, do:

```bash
pytest --cov=rpy2.rinterface_lib \
       --cov=rpy2.rinterface \
       --cov=rpy2.ipython \
       --cov=rpy2.robject \
       rpy2-rinterface/ rpy2-robjects/
```

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.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "rpy2",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Laurent Gautier <lgautier@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/cb/f3/65c33deae8311b2d62bb268961cb49c6dd45f188d765dc411a3517f56bcf/rpy2-3.6.3.tar.gz",
    "platform": null,
    "description": "# Python -> R bridge\n\n[![pypi](https://img.shields.io/pypi/v/rpy2.svg?style=flat-square)](https://pypi.python.org/pypi/rpy2)\n[![Codecov](https://codecov.io/gh/rpy2/rpy2/branch/master/graph/badge.svg)](https://codecov.io/gh/rpy2/rpy2)\n[![GH Actions](https://github.com/rpy2/rpy2/workflows/Python%20package/badge.svg)](https://github.com/rpy2/rpy2/actions?query=workflow%3A%22Python+package%22)\n\n![PyPI - Downloads](https://img.shields.io/pypi/dm/rpy2?style=flat&label=pypi)\n![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/rpy2?label=conda-forge)\n\nThe project's webpage is here: https://rpy2.github.io/\n\n\n# Installation\n\nReleased versions can be installed from a package repository (default\nbeing pypi) using pip:\n\n```bash\npip install rpy2\n```\n\nThe package has optional depencies providing\nspecific functionalities not otherwise required to use the rest of rpy2.\n\nFor example, to be able to run the unit tests:\n```bash\npip install 'rpy2[test]'\n```\n\nTo install all optional dependencies (numpy, pandas, ipython), use:\n\n```bash\npip install 'rpy2[all]'\n```\n\n## Installation for rpy2 developers\n\nIf a developer, the package can be installed from its source tree.\n`rpy2` is a namespace package with its consituting parts in different\n\"sub-packages\".\n\nTo install from the source tree, just enter:\n\n```bash\npip install ./rpy2-rinterface/ ./rpy2-robjects/ .\n```\n\nVarious optional dependencies can be specified through dependency groups.\nFor example:\n\n```bash\npip install ./rpy2-rinterface'[all]' ./rpy2-robjects'[all]' '.[all]'\n```\n\n`rpy2-rinterface` contains the binding to R's C API. Building from\nsource require a compilation toolchain / developper tools installed,\nand you will have to figure out how to have them installed on your\nsystem by yourself. The CI pipeline builds binary wheels for Linux,\nMacOS, and Windows. Watching how things are set up there is pretty\nmuch all documentation from the package maintainers on the matter.\n\n\n## Issues loading shared C libraries\n\nWhenever R is in not installed in a system location, the system might not\nknow where to find the R shared library.\n\nIf `R` is in the `PATH`, that is entering `R` on the command line successfully starts\nan R terminal, but rpy2 does not work because of missing C libraries, try the following\nbefore starting Python:\n\n\n```bash\nexport LD_LIBRARY_PATH=\"$(python -m rpy2.situation LD_LIBRARY_PATH)\":${LD_LIBRARY_PATH}\n```\n\n\n# Documentation\n\nDocumentation is available either in the source tree (`doc/`),\nor [online](https://rpy2.github.io/doc.html).\n\n\n## Testing\n\n`rpy2` uses `pytest`, with the plugin `pytest-cov` for code coverage. To\ntest the package from the source tree, either to check and installation\non your system or before submitting a pull request, do:\n\n```bash\npytest rpy2-rinterface/ rpy2-robjects/\n```\n\nFor code coverage, do:\n\n```bash\npytest --cov=rpy2.rinterface_lib \\\n       --cov=rpy2.rinterface \\\n       --cov=rpy2.ipython \\\n       --cov=rpy2.robject \\\n       rpy2-rinterface/ rpy2-robjects/\n```\n\nFor more options, such as how to run specify tests, please refer to the `pytest`\ndocumentation.\n\n\n# License\n\nRPy2 can be used under the terms of the GNU\nGeneral Public License Version 2 or later (see the file\ngpl-2.0.txt). This is the very same license R itself is released under.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python interface to the R language (embedded R)",
    "version": "3.6.3",
    "project_urls": {
        "Documentation": "https://rpy2.github.io/doc.html",
        "Homepage": "https://rpy2.github.io",
        "Source": "https://github.com/rpy2/rpy2",
        "Tracker": "https://github.com/rpy2/rpy2/issue"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "c926a176651fc898e95150ef3be124db57296ebea17fb5c98b799fb0fc6fcda8",
                "md5": "b7c1619f54852d8b68a5a344d3dba5f6",
                "sha256": "be2832f58aaac1990e9f8bde6fa56e3492775247a723d3fdff634f6c8a7f5cd3"
            },
            "downloads": -1,
            "filename": "rpy2-3.6.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b7c1619f54852d8b68a5a344d3dba5f6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 9896,
            "upload_time": "2025-09-04T22:50:07",
            "upload_time_iso_8601": "2025-09-04T22:50:07.523877Z",
            "url": "https://files.pythonhosted.org/packages/c9/26/a176651fc898e95150ef3be124db57296ebea17fb5c98b799fb0fc6fcda8/rpy2-3.6.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cbf365c33deae8311b2d62bb268961cb49c6dd45f188d765dc411a3517f56bcf",
                "md5": "9118233a02bf150beaa503d1ce64bb73",
                "sha256": "942618a12521963006d22e88aaa4d481a923821c03a1742c99beee722eb0fc5a"
            },
            "downloads": -1,
            "filename": "rpy2-3.6.3.tar.gz",
            "has_sig": false,
            "md5_digest": "9118233a02bf150beaa503d1ce64bb73",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 53111,
            "upload_time": "2025-09-04T22:50:08",
            "upload_time_iso_8601": "2025-09-04T22:50:08.565113Z",
            "url": "https://files.pythonhosted.org/packages/cb/f3/65c33deae8311b2d62bb268961cb49c6dd45f188d765dc411a3517f56bcf/rpy2-3.6.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-04 22:50:08",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "rpy2",
    "github_project": "rpy2",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "cffi",
            "specs": [
                [
                    ">=",
                    "1.10.0"
                ]
            ]
        },
        {
            "name": "jinja2",
            "specs": []
        },
        {
            "name": "pytz",
            "specs": []
        },
        {
            "name": "tzlocal",
            "specs": []
        },
        {
            "name": "packaging",
            "specs": []
        }
    ],
    "lcname": "rpy2"
}
        
Elapsed time: 3.28419s