Rpy2

==============

New features
------------

- :func:`rpy2.rinterface.evalr_expr_with_visible` to evaluate
an expression and return the visibility status of the
value returned.

- More events in the intialization and termination of an
embedded R logged by :mod:`rpy2.rinterface_lib.embedded.logger`
at `INFO` and `DEBUG` levels.

- :meth:`rpy2.robjects.R.__call__` has 2 named arguments "visible" and
"print_r_warnings" to handle R "invisible" results and print R warnings
at the end of the evaluation. Invisible results happen when doing
`rpy2.robjects.r("x <- 1")`. R will return the value of x "invisibly".
The default are `invisible is True` and `print_r_warnings is True`.


Bugs fixed
----------

- "R magic" cells are now show R warnings at the end of the
evaluation of an R cell (issue 226).

Changes
-------

- Evaluating a string as R code using :meth:`rpy2.robjects.R.__call__`
(e.g., `rpy2.robjects.r("1+2")`) now shows R warnings at the end
of the evaluation by default.

- :meth:`rpy2.robjects.R.__call__` returns the results invisibly by default
(see section "New features" for this release).

==============

New features
------------

- :class:`pandas.Categorical` objects are now converted to R
`factor` objects.

Bugs fixed
----------

- :mod:`pandas` 2.0 makes API-breaking changes that made
conversion fail (issue 1013).

- The default converter for R magic was dropping R factors
to :mod:`numpy` arrays of integers rather than convert them
to pandas :class:`Category` (issue 1010).

Changes
-------

- The fix for issue 1010 (see above) changes the numpy conversion
for R factors. It returns an arrays with the level factors rather
than the integer codes for the levels.

- :func:`rpy2.rojects.pandas2ri.py2rpy_categoryseries` raises a
:class:`DeprecationWarning`.

==============

New features
------------

- :mod:`rpy2.situation` reports cffi interface type information.

- The ipython/jupyter R magic can now have `jpeg` as a default graphics format
for static figures in addition to `png` and `svg`.

Bugs fixed
----------

- Building the path to the R shared library was incorrectly
using the output of `R CMD config LIBnn` (issue 982).

- R started raising warnings when calling `formals` on `BUILTINSXP` R objects.
Internal functions in :mod:`rpy.robjects.functions` calling `formals` no
longer propagate the warnings.

=============

New features
------------

- Type hints in :mod:`rpy2` are now checked with `mypy`.

Bugs fixed
----------

- Building the path to the R shared library was incorrectly
using the output of `R CMD config LIBnn` (issue 982).

- R started raising warnings when calling `formals` on `SPECIALSXP` R objects.
Internal functions :mod:`rpy.robjects.functions` calling `formals` no longer
propagate the warnings.

- The :mod:`numpy` converter was not turning `NA_character_` into
`None` (issue 979).

- :mod:`rpy2.situation` included an eager `import rpy2` that could cause a version
mismatch error with some build/install toolchain (issue 984). The import is now
lazy/delayed.

- Installation targets `pandas`, `all`, and `test` now specify `pandas>=1.2.0`
(which should limit frequencies of issues like 998).

Changes
-------

- :class:`rpy2.robjects.conversion.Converter` objects are no longer functioning context
managers. An exception is now raised when trying to use it that way.
The feature was introduced with rpy2-3.5.7 but it does not guarantee the locality
of a context manager and can result in permanently changed conversion rules.
The method :meth:`rpy2.robjects.conversion.Converter.context` should be used instead.

=============

New features
------------

- Default value for the interactivity status of the embedded R
as initialization is now a private variable
`_DEFAULT_R_INTERACTIVE` in :mod:`rpy2.rinterface_lib.embedded`.

Bugs fixed
----------

- :func:`rpy2.rinterface.initr_checkenv` (aliased to
:func:`rpy2.rinterface.initr`) did not include
initialization parameters for `interactive`, `_want_setcallbacks`,
and `_c_stack_limit` (issue 976).

- The numpy converter was not listing R objects of type `CHARSXP` as
vectors. This make R `NA_character_` values wrapped in `rpy2` Python
objects to be passed as-is (issue 983).

=============

New features
------------

- :class:`rpy2.robjects.conversion.Converter` objects are now also context
managers. This makes the use of :func:`rpy2.robjects.conversion.localconverter`
unnecessary as a converter can now be used directly with a Python `with`
statement. The documentation was updated accordingly.

Bugs fixed
----------

- Building the C-extension could fail when the C compiler is not
C99-compatible or requires to be specified C99 compatibility
(issue 963).

- With the "R magic", converters in a local namespace were inadvertently
skipped (the local namespace was not searched).

- Calling :func:`rpy2.rinterface.rternalize` before the embedded R is
initialized was ending with a segfault. It is now raising an
:class:`rpy2.rinterface_lib/embedded/RNotReady` (issue 971).

Changes
-------

- The default for the :class:`contextvars.ContextVar` holding
conversion rules (:obj:`rpy2.robjects.conversion.converter`)
is now a dummy converter raising errors about missing
conversion rules. This behavior helps with troubleshooting
Python code using multithreading without fetching the context
(see issue 965).

- A warning is now issued when trying to convert a `DataFrame` with
duplicate indexes (issue 811).