Skip to content

Commit db9343d

Browse files
committed
Updated docs.
1 parent adaf64e commit db9343d

File tree

3 files changed

+14
-15
lines changed

3 files changed

+14
-15
lines changed

domdf_python_tools/doctools.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -305,6 +305,8 @@ def _do_prettify(obj: Type, base: Type, new_docstrings: Dict[str, str]):
305305
:param new_docstrings:
306306
307307
:return:
308+
309+
.. versionadded:: 0.8.0
308310
"""
309311

310312
for attr_name in new_docstrings:
@@ -328,7 +330,7 @@ def prettify_docstrings(obj: Type) -> Type:
328330
329331
:return: The object
330332
331-
Default :func:`dir` implementation.
333+
.. versionadded:: 0.8.0
332334
"""
333335

334336
repr_docstring = f"Return a string representation of the :class:`~{obj.__module__}.{obj.__name__}`."

domdf_python_tools/stringlist.py

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@
33
# stringlist.py
44
"""
55
A list of strings that represent lines in a multiline string.
6+
7+
.. versionchanged:: 0.8.0
8+
9+
String moved to :mod:`domdf_python_tools.typing`.
10+
It will be removed from this module in 1.0.0
611
"""
712
#
813
# Copyright © 2020 Dominic Davis-Foster <[email protected]>
@@ -31,7 +36,6 @@
3136
from domdf_python_tools.typing import String
3237
from domdf_python_tools.utils import convert_indents
3338

34-
# Will be removed in 1.0
3539
String = String
3640

3741
__all__ = ["Indent", "StringList"]

domdf_python_tools/typing.py

Lines changed: 6 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -158,20 +158,7 @@ def loads(
158158
# Copyright © 2000 BeOpen.com . All rights reserved.
159159
# Copyright © 1995-2000 Corporation for National Research Initiatives . All rights reserved.
160160
# Copyright © 1991-1995 Stichting Mathematisch Centrum . All rights reserved.
161-
#
162-
163-
# if domdf_python_tools.DOCUMENTING:
164-
# WrapperDescriptorType = ''
165-
# """
166-
# The type of methods of some built-in data types and base classes such as
167-
# :meth:`object.__init__` or :meth:`object.__lt__`.
168-
# """
169-
#
170-
# MethodWrapperType = ''
171-
# MethodDescriptorType = ''
172-
# ClassMethodDescriptorType = ''
173161

174-
# else:
175162
WrapperDescriptorType = type(object.__init__)
176163
MethodWrapperType = type(object().__str__)
177164
MethodDescriptorType = type(str.join)
@@ -182,6 +169,10 @@ def loads(
182169
class String(Protocol):
183170
"""
184171
:class:`~typing.Protocol` for classes that implement ``__str__``.
172+
173+
.. versionchanged:: 0.8.0
174+
175+
Moved from :mod:`domdf_python_tools.stringlist`.
185176
"""
186177

187178
def __str__(self) -> str:
@@ -194,6 +185,8 @@ class HasHead(Protocol):
194185
:class:`typing.Protocol` for classes that have a ``head``.
195186
196187
This includes :class:`pandas.DataFrame` and :class:`pandas.Series`.
188+
189+
.. versionadded:: 0.8.0
197190
"""
198191

199192
def head(self: "FrameOrSeries", n: int = 5) -> "FrameOrSeries":

0 commit comments

Comments
 (0)