util-belt 0.0.9

utility belt

This is a utility package which can simplify a lot of common and repetitive tasks.
It contains different utility functions.
to install it use pip install util-belt and pip will install the latest version of the package

List of functionalities

1. file utilities

   1. list to text
      to save a list to text file for later use you can do it using the
      list_to_txt() funtion in the file_utils module.

      example

      from util_belt.file_utils import list_to_txt
      
      my_list = [3,5,6,7]
      list_to_txt(my_list , file_dest = './list.txt')
      
      

      file_dest parameter is the file path where the list should be saved at.
      By default it is the current directory and the file name is list.txt
      you can change that to any file path you want. the funtion will save your list
      to a file with out worrying about details in file handling.
      

      Currently this library can only save simple lists or 1D lists

   2. file from list
      to get a list saved in a txt file use list_from_txt function in the file_utils module
      

      Example

      from util_belt.file_utils import list_from_txt
      
      my_list = list_from_txt('Documents/my_list.txt')
      
      

   Currently this library can only save and retrieve simple lists or 1D lists.
   it will inlude more flexiblity and functionalities in the next update
   

2. display utilities

   1. pretty print an array
      this functionality could be accessd at the display_util module
      it helps us print a numpy array beatifuly

      Example

      from util_belt.display_utils import pretty_array
      three_d_array = np.random.randint(0, 10, size=(2,7,12))
      
      pretty_array(three_d_array,colorify = False,axis=0)
      

      The colorify parameter determines if the display should be colorful (by default it is flase).
      The axis parameter determines on which axis of the array should the different bands of color applied(by defualt it is 0). the out put from the above example looks like as follows:

      / 6 0 4 3 5 8 4 7 9 1 4 3 /
     / 9 6 2 1 0 6 4 3 4 9 4 6 /
    / 6 3 5 1 4 9 8 9 9 0 8 4 /
   / 5 7 3 6 9 9 6 7 1 6 4 5 /
  / 6 2 1 6 5 6 4 0 8 9 1 2 /
 / 7 2 6 7 0 1 4 7 5 0 7 7 /

       / 7 3 5 1 5 7 2 4 5 6 1 5 /
      / 9 2 2 1 5 6 5 2 4 4 6 9 /
     / 4 1 6 8 6 0 2 6 8 4 0 7 /
    / 3 8 9 3 9 8 9 7 8 1 8 8 /
   / 4 5 7 7 0 5 4 5 5 1 4 7 /
  / 9 6 1 6 2 5 8 8 4 9 5 2 /
 / 7 2 8 2 7 7 3 4 3 1 0 9 /

The origin or the [0][0][0] in this display starts from the bottom left corner.
Then the first axis (height) increases from bottom to top (like a Z axis in typical 3D cartesian plane)
The second axis (rows) increases away from the origin point along the diagonal line
The third axis (columns) increases horizentaly to the right.
This can be shown in the diagram below

first axis

|    second axis
|   /
|  /
| /
|/_________ third axis

if there is any issue,a bug or recommendation report on https://github.com/kellemNegasi/util_belt