xlwings-utils 25.0.7__py3-none-any.whl → 25.0.7.post1__py3-none-any.whl

xlwings_utils/xlwings_utils.py

@@ -290,6 +290,11 @@ class block:
         self.number_of_rows = number_of_rows
         self.number_of_columns = number_of_columns
 
+    def __eq__(self,other):
+        if isinstance(other, block):
+            return self.value == other.value
+        return False
+
     @classmethod
     def from_value(cls, value, column_like=False):
         """
@@ -297,18 +302,12 @@ class block:
 
         Parameters
         ----------
-        value : scaler, list of scalars, list of lists of scalars or block
+        value : scalar, list of scalars, list of lists of scalars or block
             value to be used in block, possibly expanded to a list of lists of scalars
 
         column_like : boolean
             if value is a list of scalars, values is interpreted as a column if True, as a row otherwise
 
-        number_of_rows : int
-            if given, expand or shrink to the given number of rows
-
-        number_of_columns : int
-            if given, expand or shrink to the given number of columns
-
         Returns
         -------
         block : block
@@ -328,7 +327,7 @@ class block:
             for column, item in enumerate(row_contents, 1):
                 if item and not (isinstance(item, float) and math.isnan(item)):
                     bl.dict[row, column] = item
-                    bl._number_of_columns = max(bl.number_of_columns, column)
+                bl._number_of_columns = max(bl.number_of_columns, column)
         return bl
 
     @classmethod
@@ -341,19 +340,12 @@ class block:
         rng : xlwings.Range
             range to be used be used in block
 
-        number_of_rows : int
-            if given, expand or shrink to the given number of rows
-
-        number_of_columns : int
-            if given, expand or shrink to the given number of columns
-
         Returns
         -------
         block : block
         """
         number_of_rows, number_of_columns = rng.shape
-        bl = cls.from_value(rng.value, column_like=(number_of_columns == 1))
-        return bl
+        return cls.from_value(rng.value, column_like=(number_of_columns == 1))
 
     @classmethod
     def from_xlrd_sheet(cls, sheet):
@@ -365,12 +357,6 @@ class block:
         sheet : xlrd sheet
             sheet to be used be used in block
 
-        number_of_rows : int
-            if given, expand or shrink to the given number of rows
-
-        number_of_columns : int
-            if given, expand or shrink to the given number of columns
-
         Returns
         -------
         block : block
@@ -380,6 +366,18 @@ class block:
 
     @classmethod
     def from_openpyxl_sheet(cls, sheet):
+        """
+        makes a block from an openpyxl sheet
+
+        Parameters
+        ----------
+        sheet : xlrd sheet
+            sheet to be used be used in block
+
+        Returns
+        -------
+        block : block
+        """
         v = [[cell.value for cell in row] for row in sheet.iter_rows()]
         return cls.from_value(v)
 
@@ -393,12 +391,6 @@ class block:
         filename : str
             file to be used be used in block
 
-        number_of_rows : int
-            if given, expand or shrink to the given number of rows
-
-        number_of_columns : int
-            if given, expand or shrink to the given number of columns
-
         Returns
         -------
         block : block
@@ -417,12 +409,6 @@ class block:
         df : pandas dataframe
             dataframe to be used be used in block
 
-        number_of_rows : int
-            if given, expand or shrink to the given number of rows
-
-        number_of_columns : int
-            if given, expand or shrink to the given number of columns
-
         Returns
         -------
         block : block
@@ -432,18 +418,12 @@ class block:
 
     def to_openpyxl_sheet(self, sheet):
         """
-        makes a block from a given openpyxl sheet
+        appends a block to a given openpyxl sheet
 
         Parameters
         ----------
         sheet: openpyxl sheet
-            sheet to be used be used in block
-
-        number_of_rows : int
-            if given, expand or shrink to the given number of rows
-
-        number_of_columns : int
-            if given, expand or shrink to the given number of columns
+            sheet to be used be used
 
         Returns
         -------
@@ -474,8 +454,8 @@ class block:
             number_of_columns = self.number_of_columns
         bl = block(number_of_rows=number_of_rows, number_of_columns=number_of_columns)
         for (row, column), value in self.dict.items():
-            if row <= number_of_columns and column <= number_of_columns:
-                bl.dict[row, column] = value
+            if row <= number_of_rows and column <= number_of_columns:
+                bl[row, column] = value
         return bl
 
     @property
@@ -488,7 +468,11 @@ class block:
             raise IndexError(f"row must be between 1 and {self.number_of_rows} not {row}")
         if column < 1 or column > self.number_of_columns:
             raise IndexError(f"column must be between 1 and {self.number_of_columns} not {column}")
-        self.dict[row, column] = value
+        if value is None:
+            if (row,column) in self.dict:
+                del self.dict[row,column]
+        else:
+            self.dict[row, column] = value
 
     def __getitem__(self, row_column):
         row, column = row_column
@@ -562,7 +546,7 @@ class block:
         if column > self.number_of_columns:
             raise ValueError(f"{name}={column} > number_of_columns={self.number_of_columns}")
 
-    def transpose(self):
+    def transposed(self):
         """
         transpose block
 
@@ -827,7 +811,16 @@ class block:
 
     def decode_to_files(self):
         """
-        decode the block with encoded file(s) to individual pyoidide files
+        decode the block with encoded file(s) to individual pyoidide file(s)
+        
+        Returns
+        -------
+        count : int
+            number of files decoded
+        
+        Note
+        ----
+        if the block does not contain an encode file, the method just returns 0
         """
         count = 0
         for column in range(1, self.number_of_columns + 1):

{xlwings_utils-25.0.7.dist-info → xlwings_utils-25.0.7.post1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xlwings_utils
-Version: 25.0.7
+Version: 25.0.7.post1
 Summary: xlwings_utils
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/xlwings_utils

xlwings_utils-25.0.7.post1.dist-info/RECORD

@@ -0,0 +1,6 @@
+xlwings_utils/__init__.py,sha256=FdaRztevSu5akGL7KBUBRzqwLMRTdvVUuS2Kfp2f1Uc,68
+xlwings_utils/xlwings_utils.py,sha256=6uy2FTJH96N6I5LNzY_ZRMmCU239v6hdD9wEvtapeIU,28199
+xlwings_utils-25.0.7.post1.dist-info/METADATA,sha256=o94CnW04WADOZdVqgikjP9EqLWXKpOTveMKJER2UnNg,12424
+xlwings_utils-25.0.7.post1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xlwings_utils-25.0.7.post1.dist-info/top_level.txt,sha256=kf5SEv0gZiRObPhUoYcc1O_iX_wwTOPeUIYvzyYeAM4,14
+xlwings_utils-25.0.7.post1.dist-info/RECORD,,

xlwings_utils-25.0.7.dist-info/RECORD

@@ -1,6 +0,0 @@
-xlwings_utils/__init__.py,sha256=FdaRztevSu5akGL7KBUBRzqwLMRTdvVUuS2Kfp2f1Uc,68
-xlwings_utils/xlwings_utils.py,sha256=e8Lo40ceG0kSzSuytOpIT3cvJ_bhZRxLC2x69EE6k9Y,28725
-xlwings_utils-25.0.7.dist-info/METADATA,sha256=NVLthhuk58Inh4nNVC9Bvue1VEUXuRUYdjJYKlhEqyA,12418
-xlwings_utils-25.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-xlwings_utils-25.0.7.dist-info/top_level.txt,sha256=kf5SEv0gZiRObPhUoYcc1O_iX_wwTOPeUIYvzyYeAM4,14
-xlwings_utils-25.0.7.dist-info/RECORD,,