CLN: avoid doctests which produce warnings

we cannot ignore them nicely

Author: gdementen

larray/core/array.py

@@ -7722,31 +7722,37 @@ def growth_rate(self, axis=-1, d=1, label='upper') -> 'Array':
 
         Examples
         --------
-        >>> data = [[4, 5, 4, 0, 0, 4, 6], [2, 4, 3, 6, 6, 3, 9]]
-        >>> a = Array(data, "sex=M,F; year=2015..2021")
+        >>> data = [[4, 5, 4, 6, 9], [2, 4, 3, 0, 0]]
+        >>> a = Array(data, "sex=F,M; year=2017..2021")
         >>> a
-        sex\year  2015  2016  2017  2018  2019  2020  2021
-               M     4     5     4     0     0     4     6
-               F     2     4     3     6     6     3     9
+        sex\year  2017  2018  2019  2020  2021
+               F     4     5     4     6     9
+               M     2     4     3     0     0
         >>> a.growth_rate()
-        sex\year  2016   2017  2018  2019  2020  2021
-               M  0.25   -0.2  -1.0   0.0   inf   0.5
-               F   1.0  -0.25   1.0   0.0  -0.5   2.0
+        sex\year  2018   2019  2020  2021
+               F  0.25   -0.2   0.5   0.5
+               M   1.0  -0.25  -1.0   0.0
         >>> a.growth_rate(label='lower')
-        sex\year  2015   2016  2017  2018  2019  2020
-               M  0.25   -0.2  -1.0   0.0   inf   0.5
-               F   1.0  -0.25   1.0   0.0  -0.5   2.0
+        sex\year  2017   2018  2019  2020
+               F  0.25   -0.2   0.5   0.5
+               M   1.0  -0.25  -1.0   0.0
         >>> a.growth_rate(d=2)
-        sex\year  2017  2018  2019  2020  2021
-               M   0.0  -1.0  -1.0   inf   inf
-               F   0.5   0.5   1.0  -0.5   0.5
+        sex\year  2019  2020  2021
+               F   0.0   0.2  1.25
+               M   0.5  -1.0  -1.0
+
+        It works on any axis, not just time-based axes
+
         >>> a.growth_rate('sex')
-        sex\year  2015  2016   2017  2018  2019   2020  2021
-               F  -0.5  -0.2  -0.25   inf   inf  -0.25   0.5
+        sex\year  2017  2018   2019  2020  2021
+               M  -0.5  -0.2  -0.25  -1.0  -1.0
+
+        Or part of axes
+
         >>> a.growth_rate(a.year[2017:])
-        sex\year  2018  2019  2020  2021
-               M  -1.0   0.0   inf   0.5
-               F   1.0   0.0  -0.5   2.0
+        sex\year  2018   2019  2020  2021
+               F  0.25   -0.2   0.5   0.5
+               M   1.0  -0.25  -1.0   0.0
         """
         if isinstance(axis, Group):
             array = self[axis]

larray/core/checked.py

@@ -383,13 +383,15 @@ class CheckedSession(Session, AbstractCheckedSession, metaclass=ModelMetaclass):
         dtype: int32
         memory used: 968 bytes
 
-        >>> # note that it still possible to add undeclared variables to a checked session
-        >>> # but this must be done with caution.
-        >>> m.undeclared_var = 'undeclared_var'
+        It is possible to add undeclared variables to a checked session
+        but this will print a warning:
+
+        >>> m.undeclared_var = 'my_value'                   # doctest: +SKIP
+        UserWarning: 'undeclared_var' is not declared in 'ModelVariables'
 
         >>> # ==== output ====
         >>> # save all variables in an HDF5 file
-        >>> m.save(f'{variant_name}.h5', display=True)
+        >>> m.save(f'{variant_name}.h5', display=True)      # doctest: +SKIP
         dumping birth_rate ... done
         dumping births ... done
         dumping mortality_rate ... done