1. Added method for query min/max element from a container.

2. Added menthod for lower and upper bounds of a given number.

Author: Sarbojit2019

lowerupperbound.py

@@ -0,0 +1,106 @@
+
+def lower_bound(container, num):
+    '''
+        @Brief: Method is to find lower bound of a given number 'num' in given container
+        
+        Description: lower_bound() function returns index of the greatest value less than or equal to 'num' 
+                     from given container
+        Examples : 
+            1) lower_bound([],12) -> 0th index : 
+                    Returns first index of the container
+            2) lower_bound([10,2,3,4,7,11],1) -> 0th index : 
+                    In case container does not have any number smaller than 'num' it returns 0th 
+            3) lower_bound([1,2,3,90,4,7,11],12) -> 6
+                    11 is the largest value less than 'num'(12) hence function returns 6th as container index
+            4) lower_bound([1,2,3,90,4,7,11],11) -> 6
+                    11 is the largest value less than equal to 'num'(11) hence function returns 6th as container index
+
+        Practical scenarios :
+            1) Function can be used to find smallest deviation from given input
+            2) In case of error margine one can use the function to see how close results to expected value 
+    '''
+    foundLowerBound = False
+    index = 0
+    lowerBoundIdx = 0
+    for ele in container:
+        if ele <= num:
+            if not foundLowerBound:
+                lowerBoundIdx = index 
+                foundLowerBound = True
+            elif container[lowerBoundIdx] < ele:
+                lowerBoundIdx = index
+        index = index + 1
+    return lowerBoundIdx
+
+def upper_bound(container, num):
+    '''
+        @Brief: Method is to find upper bound of a given number 'num' in given container
+        
+        Description: upper_bound() function returns index of the smallest value greater than or equal to 'num' 
+                     from given container
+        Examples : 
+            1) upper_bound([],12) -> 0th index : 
+                    Returns first index of the container
+            2) upper_bound([10,2,3,4,7,11],100) -> 0th index : 
+                    In case container does not have any number greater than 'num' it returns 0th 
+            3) upper_bound([1,2,3,90,4,7,11],12) -> 3
+                    90 is the largest value less than 'num'(12) hence function returns 3rd as container index
+            4) upper_bound([1,2,3,90,4,7,11],11) -> 6
+                    11 is the smallest value greater than equal to 'num'(11) hence function returns 6th as container index
+
+        Practical scenarios :
+            1) Function can be used to find deviation from given input
+            2) In case of error margine one can use the function to see how close results to expected value 
+    '''
+    foundUpperBound = False
+    index = 0
+    upperBoundIdx = 0
+    for ele in container:
+        if ele >= num:
+            if not foundUpperBound:
+                upperBoundIdx = index 
+                foundUpperBound = True
+            elif container[upperBoundIdx] > ele:
+                upperBoundIdx = index
+        index = index + 1
+    return upperBoundIdx
+
+def lower_upper_bound(container, num):
+    '''
+        @Brief: Method is to find lower and upper bound of a given number 'num' in given container
+        
+        Description: lower_upper_bound() function returns tuple of lower_bound and upper_bound of a given number
+                    lower_bound : Greatest number smaller than 'num'
+                    upper_bound : Smallest number greater than 'num'
+        Example:
+            lower_upper_bound([1,2,3,90,4,7,11],12) -> (6,3) 
+                Lower bound is at 6th index and upper boud is at 3rd index
+
+        Practical scenarios :
+            1) It is more useful when one needs to find out closest range of a number
+
+    '''
+    foundUpperBound = False
+    foundLowerBound = False
+    index = 0
+    upperBoundIdx = 0
+    lowerBoundIdx = 0
+    for ele in container:
+        if ele < num:
+            if not foundLowerBound:
+                lowerBoundIdx = index 
+                foundLowerBound = True
+            elif container[lowerBoundIdx] < ele:
+                lowerBoundIdx = index
+        elif ele > num:
+            if not foundUpperBound:
+                upperBoundIdx = index 
+                foundUpperBound = True
+            elif container[upperBoundIdx] > ele :
+                upperBoundIdx = index
+        else:
+            lowerBoundIdx = index
+            upperBoundIdx = index
+
+        index = index + 1
+    return (lowerBoundIdx,upperBoundIdx)

maxmin.py

@@ -0,0 +1,84 @@
+def min_element(*args):
+    '''
+        @Brief: Method is to find minimum element from the given input
+        
+        Description: min_element() is a generic function with variable arguments. 
+                    It finds minimum element from different containers. 
+        Examples : 
+            1) min_element([1,2,3,4,5]) -> 1
+            2) min_element([1,2,3,4],{-1,-2,3,4}) -> -1
+            3) min_element([1,2,3,-10,200], -1000) -> -1000
+        Practical scenarios :
+            1) Using two differnet library APIs and one returns list and other returns a set, 
+            today we don't have any ways to find min element from both container
+            2) Program has multiple lists and need to find min from all the lists, 
+            today to find min all list objects has to get merged and then min() will be performed
+    '''
+    if not isinstance(args[0], (int,float,list,set,tuple)):
+        return
+
+    foundMin = False
+    for arg in args:
+        if isinstance(arg, (int,float)):
+            lowest = arg
+        else:
+            lowest = min(arg)
+
+        if foundMin == False:
+            minimum = lowest
+            foundMin = True            
+        elif lowest < minimum:
+            minimum = lowest
+
+    return minimum
+
+def max_element(*args):
+    '''
+        @Brief: Method is to find maximum element from the given input
+        
+        Description: max_element() is a generic function with variable arguments. 
+                    It finds maximum element from different containers. 
+        Examples : 
+            1) max_element([1,2,3,4,5]) -> 5
+            2) max_element([1,2,3,4],{-1,-2,3,4}) -> 4
+            3) max_element([1,2,3,-10,200], 100) -> 200
+        Practical scenarios :
+            1) Using two differnet library APIs and one returns list and other returns a set, 
+            today we don't have any ways to find max element from both container
+            2) Program has multiple lists and need to find max from all the lists, 
+            today to find max all list objects has to get merged and then max() will be performed
+    '''
+    if not isinstance(args[0], (int,float,list,set)):
+        return
+
+    foundMax = False
+    for arg in args:
+        if isinstance(arg, (int,float)):
+            highest = arg
+        else:
+            highest = max(arg)
+
+        if foundMax == False:
+            maximum = highest
+            foundMax = True
+        elif highest > maximum:
+            maximum = highest
+
+    return maximum
+
+def minmax_element(*args):
+    '''
+        @Brief: Method is to find minmax elements from the given input container
+        
+        Description: minmax_element() is a generic function with variable arguments. 
+                    It finds minimum and maximum element from different/multiple containers and
+                    returns a tuple (min,max). 
+        Examples : 
+            1) minmax_element([1,2,3,4,5]) -> (1,5)
+            2) minmax_element([1,2,3,4],{-1,-2,3,4}) -> (-1,4)
+            3) minmax_element([1,2,3,-10,200], 100) -> (-10,200)
+        Practical scenarios :
+            1) It is very usefull when application needs max and min element. Python does not have a 
+            single function which queries multiple containers and get min and max element from it. 
+    '''    
+    return (min_element(*args),max_element(*args))

test.py

@@ -0,0 +1,61 @@
+
+import maxmin as Mm
+import lowerupperbound as Lu
+
+#================ Feature : max/min element : Test start =======================#
+'''
+Test case to find minimum from different containers
+'''
+# Find and print minimum element from multiple containers 
+print(Mm.min_element([1,2,3,4],[-1,2,3,4],(9,-10)))
+
+# Find minimum from multiple integer elements  
+a,b,c,d = 1,10,-1,5
+print(Mm.min_element(a,b,c,d))
+
+
+'''
+Test case to find maximum from different containers
+'''
+# Find and print maximum element from multiple containers 
+print(Mm.max_element([1,2,3,4],[-1,2,3,4],(9,-10)))
+
+# Find maximum from multiple integer elements
+a,b,c,d = 1,10,-1,50
+print(Mm.max_element(a,b,c,d))
+
+'''
+Test case to find minimum and maximum from different containers
+'''
+# Find and print minimum and maximum element from multiple containers 
+print(Mm.minmax_element([1,2,3,4],[-1,2,3,4],(9,-10)))
+
+# Find minimum and maximum from multiple integer elements
+a,b,c,d = 1,11,-7,15
+print(Mm.minmax_element(a,b,c,d))
+
+
+#================ Feature : lower/upper bounds : Test start =======================#
+
+'''
+Find lower and upper bounds of a given number in a given series
+'''
+
+#Find lower bound of a number from an empty container
+print(Lu.lower_bound([],12))
+
+#Find lower bound of a number from an container where all numbers are greater than the number
+print(Lu.lower_bound([10,2,3,4,7,11],1))
+
+# Find lower bound of a number when number itself is spresent in the list
+print(Lu.lower_bound([1,2,3,90,4,7,11],11))
+
+#Find lower bound 
+print(Lu.lower_bound([1,2,3,90,4,7,11],12))
+
+
+# Find lower and upper bound of a number in the given list where number is present 
+print(Lu.lower_upper_bound([1,2,3,90,4,7,11],11))
+
+# Find lower and upper bound of a number
+print(Lu.lower_upper_bound([1,2,3,90,4,70,10],11))