other.guess_the_number_search
=============================

.. py:module:: other.guess_the_number_search

.. autoapi-nested-parse::

   guess the number using lower,higher and the value to find or guess

   solution works by dividing lower and higher of number guessed

   suppose lower is 0, higher is 1000 and the number to guess is 355

   >>> guess_the_number(10, 1000, 17)
   started...
   guess the number : 17
   details : [505, 257, 133, 71, 40, 25, 17]



Functions
---------

.. autoapisummary::

   other.guess_the_number_search.get_avg
   other.guess_the_number_search.guess_the_number
   other.guess_the_number_search.main
   other.guess_the_number_search.temp_input_value


Module Contents
---------------

.. py:function:: get_avg(number_1: int, number_2: int) -> int

   Return the mid-number(whole) of two integers a and b

   >>> get_avg(10, 15)
   12

   >>> get_avg(20, 300)
   160

   >>> get_avg("abcd", 300)
   Traceback (most recent call last):
       ...
   TypeError: can only concatenate str (not "int") to str

   >>> get_avg(10.5,50.25)
   30


.. py:function:: guess_the_number(lower: int, higher: int, to_guess: int) -> None

   The `guess_the_number` function that guess the number by some operations
   and using inner functions

   >>> guess_the_number(10, 1000, 17)
   started...
   guess the number : 17
   details : [505, 257, 133, 71, 40, 25, 17]

   >>> guess_the_number(-10000, 10000, 7)
   started...
   guess the number : 7
   details : [0, 5000, 2500, 1250, 625, 312, 156, 78, 39, 19, 9, 4, 6, 7]

   >>> guess_the_number(10, 1000, "a")
   Traceback (most recent call last):
       ...
   AssertionError: argument values must be type of "int"

   >>> guess_the_number(10, 1000, 5)
   Traceback (most recent call last):
       ...
   ValueError: guess value must be within the range of lower and higher value

   >>> guess_the_number(10000, 100, 5)
   Traceback (most recent call last):
       ...
   ValueError: argument value for lower and higher must be(lower > higher)


.. py:function:: main() -> None

   starting point or function of script


.. py:function:: temp_input_value(min_val: int = 10, max_val: int = 1000, option: bool = True) -> int

   Temporary input values for tests

   >>> temp_input_value(option=True)
   10

   >>> temp_input_value(option=False)
   1000

   >>> temp_input_value(min_val=100, option=True)
   100

   >>> temp_input_value(min_val=100, max_val=50)
   Traceback (most recent call last):
       ...
   ValueError: Invalid value for min_val or max_val (min_value < max_value)

   >>> temp_input_value("ten","fifty",1)
   Traceback (most recent call last):
       ...
   AssertionError: Invalid type of value(s) specified to function!

   >>> temp_input_value(min_val=-100, max_val=500)
   -100

   >>> temp_input_value(min_val=-5100, max_val=-100)
   -5100