istr-python 1.1.4__tar.gz → 1.1.5__tar.gz

{istr_python-1.1.4/istr_python.egg-info → istr_python-1.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: istr-python
-Version: 1.1.4
+Version: 1.1.5
 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
@@ -362,7 +362,7 @@ istr.is_odd(5) ==> True
 ```
 #### test for square
 
-It is possible to test whether the value is a perfect  square (provided the istr can be interpreted as an int) with the `is_square` method, e.g.
+It is possible to test whether the value is a perfect square (provided the istr can be interpreted as an int) with the `is_square` method, e.g.
 
 ```
 istr(4).is_square() ==> True
@@ -372,7 +372,33 @@ It is also possible to test for square of an ordinary int:
 ```
 istr.is_square(4) ==> True
 istr.is_square(5) ==> False
+
+#### test for cube
+
+It is possible to test whether the value is a perfect cube (provided the istr can be interpreted as an int) with the `is_cube` method, e.g.
+
+```
+istr(27).is_cube() ==> True
+istr(28).is_cube()) ==> False
+```
+It is also possible to test for cube of an ordinary int:
+```
+istr.is_cube(27) ==> True
+istr.is_cube(28 ==> False
+
+#### test for power of
+
+It is possible to test whether the value is a perfect power of a given exponent (provided the istr can be interpreted as an int) with the `is_power_of` method, e.g.
+
 ```
+istr(81).is_power_of(4) ==> True
+istr(82).is_power_of(4) ==> False
+```
+It is also possible to test for power of of an ordinary int:
+```
+istr.is_power_of(81, 4) ==> True
+istr.is_power_of(82, 4) ==> False
+
 #### test for prime
 
 It is possible to test whether the value is a prime number (provided the istr can be interpreted as an int) with the `is_prime` method, e.g.
@@ -558,8 +584,30 @@ istr.digits('3-') ==> istr('34567879')
 istr.digits('X-') ==> istr('XYZ')
 ```
 
+#### Decomposing to and composing from letter variables
+
+When we have an istr, we can decompose the value into individual one letter (global) variables with the `decompose()` method.
+E.g.
+
+```
+istr(485).decompose("abc")
+```
+will set the global variables `a`,  `b` and `c` to be set to `istr(4)`. `istr(8)` and` istr(5)`.
+Note that the length of the letters specifier must be the same as the length of the istr. Furthermore, multiple values for the same variables result in a ValueError.
+
+With `istr.compose()`, an istr can be constructed from individual (global) variables.
+E.g.
+
+```
+x = 3
+y = 9
+z = 6
+test = istr.compose("xyz")
+```
+Now, `test` will be `istr(396)` .
 
 #### Subclassing istr
+
 When a class is derived from istr, all methods will return that newly derived class. 
 
 E.g.