Delete unnecessary code files

Author: Pulkit1822

binary_divisibility/binary_divisibility.md

@@ -0,0 +1,26 @@
+## Summary
+This function checks if a given list of binary numbers is divisible by 5.
+
+## Example Usage
+```python
+binary_numbers = "101,110,111,1001"
+result = check_binary_divisibility(binary_numbers)
+print(result)
+```
+
+## Code Analysis
+### Inputs
+- `bin_numbers`: a string containing a comma-separated list of binary numbers.
+___
+### Flow
+1. Split the `bin_numbers` string into individual binary numbers using the comma as a delimiter.
+2. Iterate over each binary number.
+3. Convert each binary number to its decimal equivalent using `int(num, 2)`.
+4. Check if the decimal number is divisible by 5 using the modulo operator `%`.
+5. If the number is divisible by 5, add it to the `divisible_by_5` list.
+6. Join the numbers in the `divisible_by_5` list with commas using `','.join(divisible_by_5)`.
+7. Return the resulting string.
+___
+### Outputs
+- A string containing the binary numbers from the input list that are divisible by 5.
+___

binary_divisibility.py renamed to binary_divisibility/binary_divisibility.py

@@ -0,0 +1,25 @@
+## Summary
+This code defines a function named `calculate_average` that calculates the average of a given number of students' marks.
+
+## Example Usage
+```python
+average = calculate_average(3)
+print(average)
+```
+This code will prompt the user to enter the marks of 3 students, calculate their average, and then print the result.
+
+## Code Analysis
+### Inputs
+- `num_students`: an integer representing the number of students for which the average needs to be calculated.
+___
+### Flow
+1. Initialize `total_marks` variable to 0.
+2. Iterate `num_students` times:
+   - Prompt the user to enter a student's mark.
+   - Add the entered mark to `total_marks`.
+3. Calculate the average by dividing `total_marks` by `num_students`.
+4. Return the calculated average.
+___
+### Outputs
+- `average`: a float representing the average of the students' marks.
+___

calculate_average/calculate_average.md

@@ -0,0 +1,27 @@
+## Summary
+This code defines a function called `calculate_distance` that takes a list of movements as input and calculates the distance traveled based on those movements. The function uses a dictionary to keep track of the current position, with 'x' and 'y' coordinates. It iterates over each movement in the list, extracting the direction and number of steps. It then updates the position accordingly by adding or subtracting the steps from the 'x' or 'y' coordinate. Finally, it calculates the distance from the origin using the Pythagorean theorem and returns the rounded value.
+
+## Example Usage
+```python
+movements = ["UP 5", "RIGHT 3", "DOWN 2", "LEFT 1"]
+distance = calculate_distance(movements)
+print(distance)  # Output: 5
+```
+
+## Code Analysis
+### Inputs
+- `movements` (list): A list of strings representing the movements. Each string consists of a direction ('UP', 'DOWN', 'LEFT', or 'RIGHT') followed by the number of steps to take.
+___
+### Flow
+1. Initialize the `position` dictionary with 'x' and 'y' coordinates set to 0.
+2. Iterate over each `move` in the `movements` list.
+3. Split the `move` string into `direction` and `steps`.
+4. Convert `steps` to an integer.
+5. Based on the `direction`, update the `position` dictionary by adding or subtracting the `steps` from the corresponding coordinate.
+6. Calculate the distance from the origin using the Pythagorean theorem: square the 'x' coordinate, square the 'y' coordinate, sum the squares, and take the square root.
+7. Round the distance to the nearest integer.
+8. Return the calculated distance.
+___
+### Outputs
+- `distance` (int): The calculated distance traveled based on the given movements.
+___

calculate_average.py renamed to calculate_average/calculate_average.py

@@ -0,0 +1,28 @@
+## Summary
+This function calculates the electricity bill based on the number of units consumed.
+
+## Example Usage
+```python
+bill = calculate_electricity_bill(100)
+print(bill)
+```
+Output:
+```
+82.5
+```
+
+## Code Analysis
+### Inputs
+- units: an integer representing the number of units consumed
+___
+### Flow
+1. Check if the number of units is less than or equal to 50. If true, calculate the bill by multiplying the units by 0.50.
+2. If the number of units is greater than 50, check if it is less than or equal to 150. If true, calculate the bill by adding the cost of the first 50 units (50 * 0.50) to the cost of the remaining units ((units - 50) * 0.75).
+3. If the number of units is greater than 150, check if it is less than or equal to 250. If true, calculate the bill by adding the cost of the first 50 units (50 * 0.50), the cost of the next 100 units (100 * 0.75), and the cost of the remaining units ((units - 150) * 1.20).
+4. If the number of units is greater than 250, calculate the bill by adding the cost of the first 50 units (50 * 0.50), the cost of the next 100 units (100 * 0.75), the cost of the next 100 units (100 * 1.20), and the cost of the remaining units ((units - 250) * 1.50).
+5. Calculate the surcharge by multiplying the bill by 0.20.
+6. Calculate the total bill by adding the bill and the surcharge.
+___
+### Outputs
+- total_bill: a float representing the total electricity bill, including the surcharge.
+___

calculate_distance/calculate_distance.md

@@ -0,0 +1,24 @@
+## Summary
+This code defines a function named `calculate_gross_salary` that calculates the gross salary based on the given basic salary. It takes the basic salary as input and calculates the house rent allowance (HRA), dearness allowance (DA), net salary, provident fund (PPF) deduction, and gross salary. The function then prints the calculated values.
+
+## Example Usage
+```python
+calculate_gross_salary(15000)
+```
+This will calculate the gross salary for a basic salary of 15000 and print the breakdown of the salary components.
+
+## Code Analysis
+### Inputs
+- `basic_salary` (numeric): The basic salary of an employee.
+___
+### Flow
+1. The function checks if the `basic_salary` is less than or equal to 10000. If true, it calculates the HRA as 20% of the `basic_salary` and the DA as 80% of the `basic_salary`.
+2. If the `basic_salary` is greater than 10000 but less than or equal to 20000, it calculates the HRA as 25% of the `basic_salary` and the DA as 90% of the `basic_salary`.
+3. If the `basic_salary` is greater than 20000, it calculates the HRA as 30% of the `basic_salary` and the DA as 95% of the `basic_salary`.
+4. The function then calculates the net salary by adding the `basic_salary`, HRA, and DA.
+5. It calculates the PPF deduction as 10% of the net salary.
+6. Finally, it calculates the gross salary by subtracting the PPF deduction from the net salary.
+___
+### Outputs
+- The function prints the breakdown of the salary components, including the basic salary, DA, HRA, net salary, PPF deduction, and gross salary.
+___

calculate_distance.py renamed to calculate_distance/calculate_distance.py

@@ -0,0 +1,23 @@
+## Summary
+The `check_character_type` function checks the type of a given character and prints a corresponding message.
+
+## Example Usage
+```python
+check_character_type('A')
+```
+Output: "The character 'A' is an alphabet."
+
+## Code Analysis
+### Inputs
+- `char` (string): The character to be checked.
+___
+### Flow
+1. Check if the character is an alphabet using the `isalpha()` method.
+2. If it is an alphabet, print a message stating that.
+3. If not, check if the character is a digit using the `isdigit()` method.
+4. If it is a digit, print a message stating that.
+5. If neither an alphabet nor a digit, print a message stating that the character is a special symbol.
+___
+### Outputs
+- None
+___

calculate_electricity_bill/calculate_electricity_bill.md

@@ -0,0 +1,23 @@
+## Summary
+The `main` function prompts the user to enter their age, checks if they are eligible to vote using the `check_voting_eligibility` function, and prints a corresponding message.
+
+## Example Usage
+```python
+Enter your age: 20
+You have the right to vote.
+```
+
+## Code Analysis
+### Inputs
+- `age` (integer): the age of the user
+___
+### Flow
+1. Prompt the user to enter their age.
+2. Convert the input to an integer and assign it to the variable `age`.
+3. Call the `check_voting_eligibility` function with the `age` as an argument.
+4. If the return value is `True`, print "You have the right to vote."
+5. If the return value is `False`, print "You do not have the right to vote."
+___
+### Outputs
+- None
+___

calculate_electricity_bill.py renamed to calculate_electricity_bill/calculate_electricity_bill.py

@@ -0,0 +1,29 @@
+## Summary
+This code defines a function called `determine_triangle_type` that takes three arguments representing the lengths of the sides of a triangle. The function determines the type of the triangle (equilateral, isosceles, or scalene) based on the lengths of the sides and prints the result.
+
+## Example Usage
+```python
+determine_triangle_type(5, 5, 5)
+# Output: Equilateral triangle
+
+determine_triangle_type(5, 5, 6)
+# Output: Isosceles triangle
+
+determine_triangle_type(3, 4, 5)
+# Output: Scalene triangle
+```
+
+## Code Analysis
+### Inputs
+- `side1`: an integer representing the length of the first side of the triangle.
+- `side2`: an integer representing the length of the second side of the triangle.
+- `side3`: an integer representing the length of the third side of the triangle.
+___
+### Flow
+1. Check if all sides are equal (`side1 == side2 == side3`). If true, print "Equilateral triangle".
+2. If the above condition is false, check if any two sides are equal (`side1 == side2` or `side2 == side3` or `side1 == side3`). If true, print "Isosceles triangle".
+3. If both conditions above are false, print "Scalene triangle".
+___
+### Outputs
+- The function does not return any value. It prints the type of the triangle based on the lengths of its sides.
+___

calculate_gross_salary/calculate_gross_salary.md

@@ -0,0 +1,31 @@
+## Summary
+This function finds the largest and smallest numbers among a given set of numbers.
+
+## Example Usage
+```python
+find_smallest_and_largest(5)
+```
+Enter a number: 10
+Enter a number: 5
+Enter a number: 8
+Enter a number: 3
+Enter a number: 12
+The largest number is: 12
+The smallest number is: 3
+
+## Code Analysis
+### Inputs
+- `n` (integer): The number of numbers to be entered.
+___
+### Flow
+1. Initialize the variables `largest` and `smallest` to negative infinity and positive infinity respectively.
+2. Iterate `n` times.
+3. Prompt the user to enter a number.
+4. Check if the entered number is larger than the current `largest` number. If so, update `largest` with the entered number.
+5. Check if the entered number is smaller than the current `smallest` number. If so, update `smallest` with the entered number.
+6. Print the largest and smallest numbers.
+___
+### Outputs
+- The largest number among the entered numbers.
+- The smallest number among the entered numbers.
+___

calculate_gross_salary.py renamed to calculate_gross_salary/calculate_gross_salary.py

@@ -0,0 +1,24 @@
+## Code Explanation
+
+The provided Python code snippet is a part of a script that takes a user's input, splits the input into individual string integers, converts them to integers, and prints each one. If a value cannot be converted to an integer, it prints a message indicating that the value is not an integer.
+
+### Inputs
+
+The code snippet takes a string input from the user, which should contain integers separated by spaces.
+
+### Flow
+
+1. The code prompts the user to enter integers separated by spaces.
+2. The input string is split into individual string integers using the `split()` method.
+3. Each string integer is converted to an integer using the `int()` function.
+4. If the conversion is successful, the integer is printed.
+5. If the conversion fails (i.e., the string cannot be converted to an integer), a message indicating that the value is not an integer is printed.
+
+### Outputs
+
+The code snippet prints each integer value entered by the user on a separate line. If a value cannot be converted to an integer, it prints a message indicating that the value is not an integer.
+
+### Usage example
+
+```python
+Enter integers separated by spaces: 10 20 30 abc 40

character_checker/character_checker.md

@@ -0,0 +1,25 @@
+## Summary
+This function checks if a given year is a leap year.
+
+## Example Usage
+```python
+is_leap_year(2000)
+# Output: True
+
+is_leap_year(1900)
+# Output: False
+```
+
+## Code Analysis
+### Inputs
+- year: an integer representing the year to be checked
+___
+### Flow
+1. Check if the year is divisible by 400. If it is, return True.
+2. If the year is not divisible by 400, check if it is not divisible by 100 and divisible by 4. If it is, return True.
+3. If none of the above conditions are met, return False.
+___
+### Outputs
+- True if the year is a leap year
+- False if the year is not a leap year
+___

character_checker.py renamed to character_checker/character_checker.py

@@ -0,0 +1,27 @@
+## Summary
+The `find_largest_of_four` function takes four numbers as input and returns the largest number among them.
+
+## Example Usage
+```python
+largest = find_largest_of_four(5, 10, 3, 8)
+print(largest)  # Output: 10
+```
+
+## Code Analysis
+### Inputs
+- `num1`: The first number to compare.
+- `num2`: The second number to compare.
+- `num3`: The third number to compare.
+- `num4`: The fourth number to compare.
+___
+### Flow
+1. The function takes four numbers as input.
+2. It compares each number with the others using multiple `>=` conditions.
+3. If the first number is greater than or equal to all the other numbers, it is returned as the largest.
+4. If the second number is greater than or equal to all the other numbers, it is returned as the largest.
+5. If the third number is greater than or equal to all the other numbers, it is returned as the largest.
+6. If none of the above conditions are met, the fourth number is returned as the largest.
+___
+### Outputs
+- The largest number among the four input numbers.
+___

check_number_range/check_number_range.md

@@ -0,0 +1,26 @@
+## Summary
+The `find_roots` function calculates the roots of a quadratic equation using the quadratic formula. It determines whether the roots are real or complex based on the discriminant value.
+
+## Example Usage
+```python
+roots = find_roots(1, -3, 2)
+print(roots)
+```
+
+## Code Analysis
+### Inputs
+- `a`: the coefficient of the quadratic term
+- `b`: the coefficient of the linear term
+- `c`: the constant term
+___
+### Flow
+1. Calculate the discriminant using the formula `b**2 - 4*a*c`.
+2. If the discriminant is greater than 0, there are two distinct real roots. Calculate the roots using the quadratic formula: `(-b + sqrt(discriminant)) / (2*a)` and `(-b - sqrt(discriminant)) / (2*a)`.
+3. If the discriminant is equal to 0, there is one real root. Calculate the root using the formula `-b / (2*a)`.
+4. If the discriminant is less than 0, there are complex roots. Calculate the real and imaginary parts of the roots using the formulas `-b / (2*a)` and `sqrt(-discriminant) / (2*a)`, respectively.
+___
+### Outputs
+- If the discriminant is greater than 0, the function returns a tuple containing the two distinct real roots.
+- If the discriminant is equal to 0, the function returns a tuple containing the single real root.
+- If the discriminant is less than 0, the function returns a tuple containing the complex roots in the form of `(real_part + imaginary_part * 1j, real_part - imaginary_part * 1j)`.
+___

check_number_range.py renamed to check_number_range/check_number_range.py

@@ -0,0 +1,26 @@
+## Summary
+The `determine_winner` function determines the winner of a rock-paper-scissors game between two players.
+
+## Example Usage
+```python
+result = determine_winner("rock", "scissors")
+print(result)
+```
+Output:
+```
+Player 1 wins.
+```
+
+## Code Analysis
+### Inputs
+- `player1` (string): The choice of player 1 (either "rock", "paper", or "scissors").
+- `player2` (string): The choice of player 2 (either "rock", "paper", or "scissors").
+___
+### Flow
+1. If `player1` and `player2` have the same choice, return "It's a tie."
+2. If `player1` has "rock" and `player2` has "scissors", or if `player1` has "scissors" and `player2` has "paper", or if `player1` has "paper" and `player2` has "rock", return "Player 1 wins."
+3. Otherwise, return "Player 2 wins."
+___
+### Outputs
+- The function returns a string indicating the winner of the rock-paper-scissors game.
+___