istr-python 1.1.36__tar.gz → 1.1.37.post0__tar.gz

{istr_python-1.1.36 → istr_python-1.1.37.post0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: istr-python
-Version: 1.1.36
+Version: 1.1.37.post0
 Summary: istr - strings you can count on
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/istr
@@ -797,6 +797,16 @@ It is also possible to apply `prod` on an istr:
 `istr(1234).prod()` is `istr(24)`
 `istr("123").prod(start=4)` is `istr(24)`
 
+#### sum to get sum of an iterable
+
+The method `sum` can be used to return the sum of an iterable (including an istr), very much like the builtin sum function. 
+Thus, `istr.sum(range(1,5))` is `istr('10')`
+And `istr.sum("123", start=4)` is also `istr('10')`.
+
+It is also possible to apply `sum` on an istr:
+`istr(1234).sum()` is `istr('10')`
+`istr("123").prod(start=4)` is `istr('10')`
+
 #### sumprod to get the sum of products of iterables
 
 The class method `istr.sumprod()`, is equivalent to `math.sumprod()`, but applies istr to both iterables.
@@ -828,15 +838,15 @@ Note that the result will always be istr-ed, except when the result is None.
 
 Examples:
 ```
-istr(1234).getitem(2) ==> 2
+istr(1234).getitem(2) ==> 3
 istr(1234).getitem(-2) ==> 3
 istr(1234).getitem(5) ==> istr('')
 istr(1234).getitem(5, '0') ==> istr('0')
 istr(1234).getitem(5, None) ==> None
 ```
-This method can also be used with an str. E.g.:
+This method can also be used with a str. E.g.:
 ```
-istr.getitem('1234', 2) ==> 2
+istr.getitem('1234', 2) ==> 3
 istr.getitem('1234', -2) ==> 3
 istr.getitem('1234', 5) ==> istr('')
 istr.getitem('1234',5, '0') ==> istr('0')
@@ -844,6 +854,12 @@ istr.getitem('1234',5, None) ==> None
 ```
 Note that this method has the advantage that it can accept an istr as index, in contrast to normal indexing.
 
+#### long square root
+The method `long_sqrt` gives a list of  the lines of a long square root. Both the result (root) and the original number, possibly with a trailing 0 are returned, along with the calculated values.
+  E.g. `istr.long_sqrt(123 ** 2)` results in
+
+`[istr('123'), istr('015129'), istr('1'), istr('51'), istr('44'), istr('729'), istr('729'), istr('0')]`
+
 #### generate istr with digits
 
 The class method `digits` can be used to return an istr of digits according to a given specification.

{istr_python-1.1.36 → istr_python-1.1.37.post0}/README.md

@@ -784,6 +784,16 @@ It is also possible to apply `prod` on an istr:
 `istr(1234).prod()` is `istr(24)`
 `istr("123").prod(start=4)` is `istr(24)`
 
+#### sum to get sum of an iterable
+
+The method `sum` can be used to return the sum of an iterable (including an istr), very much like the builtin sum function. 
+Thus, `istr.sum(range(1,5))` is `istr('10')`
+And `istr.sum("123", start=4)` is also `istr('10')`.
+
+It is also possible to apply `sum` on an istr:
+`istr(1234).sum()` is `istr('10')`
+`istr("123").prod(start=4)` is `istr('10')`
+
 #### sumprod to get the sum of products of iterables
 
 The class method `istr.sumprod()`, is equivalent to `math.sumprod()`, but applies istr to both iterables.
@@ -815,15 +825,15 @@ Note that the result will always be istr-ed, except when the result is None.
 
 Examples:
 ```
-istr(1234).getitem(2) ==> 2
+istr(1234).getitem(2) ==> 3
 istr(1234).getitem(-2) ==> 3
 istr(1234).getitem(5) ==> istr('')
 istr(1234).getitem(5, '0') ==> istr('0')
 istr(1234).getitem(5, None) ==> None
 ```
-This method can also be used with an str. E.g.:
+This method can also be used with a str. E.g.:
 ```
-istr.getitem('1234', 2) ==> 2
+istr.getitem('1234', 2) ==> 3
 istr.getitem('1234', -2) ==> 3
 istr.getitem('1234', 5) ==> istr('')
 istr.getitem('1234',5, '0') ==> istr('0')
@@ -831,6 +841,12 @@ istr.getitem('1234',5, None) ==> None
 ```
 Note that this method has the advantage that it can accept an istr as index, in contrast to normal indexing.
 
+#### long square root
+The method `long_sqrt` gives a list of  the lines of a long square root. Both the result (root) and the original number, possibly with a trailing 0 are returned, along with the calculated values.
+  E.g. `istr.long_sqrt(123 ** 2)` results in
+
+`[istr('123'), istr('015129'), istr('1'), istr('51'), istr('44'), istr('729'), istr('729'), istr('0')]`
+
 #### generate istr with digits
 
 The class method `digits` can be used to return an istr of digits according to a given specification.

{istr_python-1.1.36 → istr_python-1.1.37.post0}/istr/istr.py

@@ -5,7 +5,7 @@
 #    |_||___/ \__||_|
 # strings you can count on
 
-__version__ = "1.1.36"
+__version__ = "1.1.37"
 import functools
 import itertools
 import types
@@ -841,6 +841,9 @@ class istr(str):
 
     def prod(self, *, start=1):
         return math.prod(self, start=istr(start))
+        
+    def sum(self, / , start=0):
+        return sum(istr(self), start=int(start))
 
     @classmethod
     def sumprod(cls, p, q, /, strict=True):
@@ -852,6 +855,42 @@ class istr(str):
     def enumerate(cls, iterable, start=0):
         for i, value in enumerate(iterable, int(start)):
             yield cls(i), value
+            
+    def long_sqrt(self):
+        """
+        this function does long squre root and returns all the lines to be written.
+        (modified from a ChatGPT code suggestion)
+        returns root, number (possibly with an extra 0) and the lines below the number, all istr-ed
+        """
+        number=istr(istr.interpret_as_str(self))
+        lines = []
+
+        if len(number)%2==1:
+            number = "0" | number
+    
+        pairs=list(istr.batched(number,2,join=True))
+        root = istr(0)
+        remainder = 0
+    
+        for pair in pairs:
+            dividend = remainder * 100 + pair
+    
+            x = 0
+            for d in range(10):
+                if (20 * root + d) * d <= dividend:
+                    x = d
+                else:
+                    break
+    
+            trial = (20 * root + x) * x
+            remainder = dividend - trial
+    
+            root = root * 10 + x
+            lines.append(dividend)
+            lines.append(trial)
+        lines.append(remainder)
+        return [root]+[number]+ lines[1:]  # ignore the first dividend
+                
 
     def this_base(self):
         return self._this_base

{istr_python-1.1.36 → istr_python-1.1.37.post0}/istr_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: istr-python
-Version: 1.1.36
+Version: 1.1.37.post0
 Summary: istr - strings you can count on
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/istr
@@ -797,6 +797,16 @@ It is also possible to apply `prod` on an istr:
 `istr(1234).prod()` is `istr(24)`
 `istr("123").prod(start=4)` is `istr(24)`
 
+#### sum to get sum of an iterable
+
+The method `sum` can be used to return the sum of an iterable (including an istr), very much like the builtin sum function. 
+Thus, `istr.sum(range(1,5))` is `istr('10')`
+And `istr.sum("123", start=4)` is also `istr('10')`.
+
+It is also possible to apply `sum` on an istr:
+`istr(1234).sum()` is `istr('10')`
+`istr("123").prod(start=4)` is `istr('10')`
+
 #### sumprod to get the sum of products of iterables
 
 The class method `istr.sumprod()`, is equivalent to `math.sumprod()`, but applies istr to both iterables.
@@ -828,15 +838,15 @@ Note that the result will always be istr-ed, except when the result is None.
 
 Examples:
 ```
-istr(1234).getitem(2) ==> 2
+istr(1234).getitem(2) ==> 3
 istr(1234).getitem(-2) ==> 3
 istr(1234).getitem(5) ==> istr('')
 istr(1234).getitem(5, '0') ==> istr('0')
 istr(1234).getitem(5, None) ==> None
 ```
-This method can also be used with an str. E.g.:
+This method can also be used with a str. E.g.:
 ```
-istr.getitem('1234', 2) ==> 2
+istr.getitem('1234', 2) ==> 3
 istr.getitem('1234', -2) ==> 3
 istr.getitem('1234', 5) ==> istr('')
 istr.getitem('1234',5, '0') ==> istr('0')
@@ -844,6 +854,12 @@ istr.getitem('1234',5, None) ==> None
 ```
 Note that this method has the advantage that it can accept an istr as index, in contrast to normal indexing.
 
+#### long square root
+The method `long_sqrt` gives a list of  the lines of a long square root. Both the result (root) and the original number, possibly with a trailing 0 are returned, along with the calculated values.
+  E.g. `istr.long_sqrt(123 ** 2)` results in
+
+`[istr('123'), istr('015129'), istr('1'), istr('51'), istr('44'), istr('729'), istr('729'), istr('0')]`
+
 #### generate istr with digits
 
 The class method `digits` can be used to return an istr of digits according to a given specification.

{istr_python-1.1.36 → istr_python-1.1.37.post0}/pyproject.toml

@@ -10,7 +10,7 @@ authors = [
     { name = "Ruud van der Ham", email = "rt.van.der.ham@gmail.com" },
 ]
 description = "istr - strings you can count on"
-version = "1.1.36"
+version = "1.1.37.post0"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = []

{istr_python-1.1.36 → istr_python-1.1.37.post0}/tests/test_istr.py

@@ -1066,6 +1066,12 @@ def test_is_triangular():
     assert istr(424581).is_triangular()
     assert not istr(424582).is_triangular()
     assert istr.is_triangular(424581)
+    
+def test_sum():
+    assert istr(1234).sum() == istr('10')
+    assert istr.sum('1234') == istr('10')
+    assert istr.sum(1234) == istr('10') 
+    assert istr.sum(1234, 5) == istr('15') 
 
 
 def test_prod():
@@ -1211,7 +1217,14 @@ def test_compose():
     assert istr(":=") == ":="
     assert istr("=") == "="
 
-
+def test_long_sqrt():
+    lines=istr.long_sqrt(1234**2)
+    assert lines==[istr('1234'), istr('01522756'), istr('1'), istr('52'), istr('44'), istr('827'), istr('729'), istr('9856'), istr('9856'), istr('0')]
+    lines=istr.long_sqrt(1234**2+1)
+    assert lines==[istr('1234'), istr('01522757'), istr('1'), istr('52'), istr('44'), istr('827'), istr('729'), istr('9857'), istr('9856'), istr('1')]
+    lines=istr(1234**2).long_sqrt()
+    assert lines==[istr('1234'), istr('01522756'), istr('1'), istr('52'), istr('44'), istr('827'), istr('729'), istr('9856'), istr('9856'), istr('0')]    
+    
 if __name__ == "__main__":
     pytest.main(["-vv", "-s", "-x", __file__])