rename as_popo to unwrap; add recursive arg

tomlkit/items.py

@@ -426,7 +426,7 @@ def as_string(self) -> str:
         """The TOML representation"""
         raise NotImplementedError()
 
-    def as_ppo(self):
+    def unwrap(self, recursive: bool = True):
         """Returns as pure python object (ppo)"""
         raise NotImplementedError()
 
@@ -550,7 +550,7 @@ def __init__(self, _: int, trivia: Trivia, raw: str) -> None:
         if re.match(r"^[+\-]\d+$", raw):
             self._sign = True
 
-    def as_ppo(self) -> int:
+    def unwrap(self, recursive: bool = True) -> int:
         return int(self)
 
     @property
@@ -621,7 +621,7 @@ def __init__(self, _: float, trivia: Trivia, raw: str) -> None:
         if re.match(r"^[+\-].+$", raw):
             self._sign = True
 
-    def as_ppo(self) -> float:
+    def unwrap(self, recursive: bool = True) -> float:
         return float(self)
 
     @property
@@ -685,7 +685,7 @@ def __init__(self, t: int, trivia: Trivia) -> None:
 
         self._value = bool(t)
 
-    def as_ppo(self) -> bool:
+    def unwrap(self, recursive: bool = True) -> bool:
         return bool(self)
 
     @property
@@ -770,7 +770,7 @@ def __init__(
 
         self._raw = raw
 
-    def as_ppo(self) -> datetime:
+    def unwrap(self, recursive: bool = True) -> datetime:
         (year, month, day, hour, minute, second, microsecond, tzinfo, _, _) = self._getstate()
         return datetime(year, month, day, hour, minute, second, microsecond, tzinfo)
 
@@ -868,7 +868,7 @@ def __init__(
 
         self._raw = raw
 
-    def as_ppo(self) -> date:
+    def unwrap(self, recursive: bool = True) -> date:
         (year, month, day, _, _) = self._getstate()
         return date(year, month, day)
 
@@ -941,7 +941,7 @@ def __init__(
 
         self._raw = raw
 
-    def as_ppo(self) -> datetime:
+    def unwrap(self, recursive: bool = True) -> datetime:
         (hour, minute, second, microsecond, tzinfo, _, _) = self._getstate()
         return time(hour, minute, second, microsecond, tzinfo)
 
@@ -1228,7 +1228,7 @@ def __init__(self, value: "container.Container", trivia: Trivia):
             if k is not None:
                 dict.__setitem__(self, k.key, v)
 
-    def as_ppo(self):
+    def unwrap(self, recursive: bool = True):
         pass
 
     @property
@@ -1553,7 +1553,7 @@ def __init__(self, t: StringType, _: str, original: str, trivia: Trivia) -> None
         self._t = t
         self._original = original
 
-    def as_ppo(self) -> str:
+    def unwrap(self, recursive: bool = True) -> str:
         return self.as_string()
 
     @property