ENH: New boundary inputs

Dockerfile

@@ -2,7 +2,7 @@ FROM quay.io/condaforge/miniforge3
 
 # if you forked pandas, you can pass in your own GitHub username to use your fork
 # i.e. gh_username=myname
-ARG gh_username=pandas-dev
+ARG gh_username=hewittk
 ARG pandas_home="/home/pandas"
 
 # Avoid warnings by switching to noninteractive

doc/source/whatsnew/v1.3.0.rst

@@ -139,6 +139,10 @@ Other enhancements
 - :meth:`pandas.read_stata` and :class:`StataReader` support reading data from compressed files.
 - Add support for parsing ``ISO 8601``-like timestamps with negative signs to :meth:`pandas.Timedelta` (:issue:`37172`)
 - Add support for unary operators in :class:`FloatingArray` (:issue:`38749`)
+- :class:`RangeIndex` can now be constructed by passing a ``range`` object directly e.g. ``pd.RangeIndex(range(3))`` (:issue:`12067`)
+- :meth:`round` being enabled for the nullable integer and floating dtypes (:issue:`38844`)
+- :meth:`pandas.read_csv` and :meth:`pandas.read_json` expose the argument ``encoding_errors`` to control how encoding errors are handled (:issue:`39450`)
+- Add consistency of arguments in `series.between` and `datetimelike.validate_endpoints` to have ``["left", "right", "neither", "both"]` as standard argument values for both methods (:issue:`40628`)
 
 .. ---------------------------------------------------------------------------
 

pandas/core/arrays/datetimelike.py

@@ -1812,11 +1812,12 @@ def validate_periods(periods):
 
 def validate_endpoints(closed):
     """
-    Check that the `closed` argument is among [None, "left", "right"]
+    Check that the `closed` argument is among ["neither", "left", "right",
+    None, or backwards compatibility argument of True, False, or None]
 
     Parameters
     ----------
-    closed : {None, "left", "right"}
+    closed : {"neither", "left", "right", "both"}
 
     Returns
     -------
@@ -1830,16 +1831,21 @@ def validate_endpoints(closed):
     left_closed = False
     right_closed = False
 
-    if closed is None:
+    if closed == "both" or closed is True or closed is None:
         left_closed = True
         right_closed = True
     elif closed == "left":
         left_closed = True
     elif closed == "right":
         right_closed = True
+    elif closed == "neither" or closed is False:
+        left_closed = False
+        right_closed = False
     else:
-        raise ValueError("Closed has to be either 'left', 'right' or None")
-
+        raise ValueError(
+            "Closed has to be either 'left', 'right', 'neither', 'both' or "
+            "None, or a boolean value"
+        )
     return left_closed, right_closed
 
 

pandas/core/series.py

@@ -4670,7 +4670,7 @@ def isin(self, values) -> Series:
             self, method="isin"
         )
 
-    def between(self, left, right, inclusive=True) -> Series:
+    def between(self, left, right, inclusive="both") -> Series:
         """
         Return boolean Series equivalent to left <= series <= right.
 
@@ -4684,7 +4684,8 @@ def between(self, left, right, inclusive=True) -> Series:
             Left boundary.
         right : scalar or list-like
             Right boundary.
-        inclusive : bool, default True
+        inclusive : str or boolean, default "both"
+
             Include boundaries.
 
         Returns
@@ -4736,12 +4737,24 @@ def between(self, left, right, inclusive=True) -> Series:
         3    False
         dtype: bool
         """
-        if inclusive:
+
+        if inclusive == "both" or inclusive is True:
             lmask = self >= left
             rmask = self <= right
-        else:
+        elif inclusive == "left":
+            lmask = self >= left
+            rmask = self < right
+        elif inclusive == "right":
+            lmask = self > left
+            rmask = self <= right
+        elif inclusive == "neither" or inclusive is False:
             lmask = self > left
             rmask = self < right
+        else:
+            raise ValueError(
+                "Inclusive has to be either string of 'both','left', 'right', "
+                "or 'neither', or a boolean value"
+            )
 
         return lmask & rmask
 

pandas/tests/series/methods/test_between.py

@@ -1,4 +1,5 @@
 import numpy as np
+import pytest
 
 from pandas import (
     Series,
@@ -38,3 +39,12 @@ def test_between_period_values(self):
         result = ser.between(left, right)
         expected = (ser >= left) & (ser <= right)
         tm.assert_series_equal(result, expected)
+
+    def test_between_inclusive_is_boolean_string(self):
+        msg_1 = "Inclusive has to be either string of 'both','left', "
+        msg_2 = "'right', or 'neither', or a boolean value"
+        msg = msg_1 + msg_2
+        with pytest.raises(ValueError, match=msg):
+            ser = Series(period_range("2000-01-01", periods=10, freq="D"))
+            left, right = ser[[2, 7]]
+            assert ser.between(left, right, 8)