Merge branch 'king04aman:main' into feature/crypto-tracker

Author: aafaris

.github/PROJECT_SUGGESTION_TEMPLATE.md

@@ -0,0 +1,17 @@
+### Project Suggestion Title
+_A concise title for your project suggestion._
+
+### Description
+_Provide a detailed description of the project idea or feature you would like to propose._
+
+### Benefits
+_Explain how this project or feature would benefit the community or improve the existing repository._
+
+### Implementation Ideas
+_Offer any initial thoughts on how the project could be implemented, including potential technologies or approaches._
+
+### Additional Context
+_Include any other relevant information, links, or references that might help._
+
+### Suggested Contributors
+_If you have specific contributors in mind who might be interested in this project, please list them here._

.github/pull_request_template.md

@@ -0,0 +1,14 @@
+### Developer Checklist
+- [ ] Adhered to the guidelines outlined in the README & Contributing file.
+- [ ] Maintained the correct directory structure (e.g., ProjectName/...yourfiles).
+- [ ] Please ensure to include a README file for enhanced project clarity.
+- [ ] Starred ⭐ the repository (optional).
+
+### Summary
+###### _Please provide a brief summary here._
+
+### Screenshot
+###### _Attach any relevant screenshots or GIFs here._
+
+### Live Project Link
+###### _Include a link to the live project here._

.github/workflows/contributors.yml

@@ -0,0 +1,15 @@
+name: Contributors
+
+on:
+  schedule:
+    - cron: '0 0 * * *'
+
+jobs:
+  contributors:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: wow-actions/contributors-list@v1
+        with:
+          GITHUB_TOKEN: ${{ secrets.ACTION_TOKEN }}
+          round: true
+          svgPath: CONTRIBUTORS.svg

.github/workflows/generate-project-list.yml

@@ -0,0 +1,67 @@
+name: Generate Project List
+
+on:
+  schedule:
+    - cron: 0 0 * * *
+  push:
+    branches:
+      - main
+
+jobs:
+  generate-list:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.ACTION_TOKEN }}
+          persist-credentials: true
+
+      - name: Fetch latest changes
+        run: git fetch origin
+
+      - name: Merge changes
+        run: |
+          git merge origin/main || echo "No new changes to merge or merge conflict"
+
+      - name: Generate project list
+        run: |
+          exclude_dirs=(.github)
+          exclude_files=("LICENSE" "README.md" "CONTRIBUTING.md" "Example README.md" "CODE_OF_CONDUCT.md" "PROJECTS.md")
+
+          projects=()
+          for dir in */; do
+            if [[ ! " ${exclude_dirs[@]} " =~ " ${dir%/} " ]]; then
+              projects+=("$dir")
+            fi
+          done
+
+          echo "# Project List" > PROJECTS.md
+          echo "" >> PROJECTS.md
+
+          for project in "${projects[@]}"; do
+            project_name=${project%/}
+            safe_project_name=${project_name// /%20}
+            echo "* [$project_name](https://github.com/king04aman/All-In-One-Python-Projects/tree/main/$safe_project_name)" >> PROJECTS.md
+          done
+
+          for file in "${exclude_files[@]}"; do
+            sed -i "/$file/d" PROJECTS.md
+          done
+
+          # Debug output to check the content of PROJECTS.md
+          cat PROJECTS.md
+
+      - name: Commit project list
+        run: |
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git config --global user.name "github-actions[bot]"
+          git add PROJECTS.md
+          if ! git diff --cached --exit-code; then
+            git commit -m "Update project list"
+            git push --force-with-lease
+          else
+            echo "No changes to commit."
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.ACTION_TOKEN }}

.github/workflows/welcome.yml

@@ -0,0 +1,37 @@
+name: New Contributor Welcome
+
+permissions:
+  issues: write
+  pull-requests: write
+
+on:
+  pull_request:
+    types: [opened, closed]
+  issues:
+    types: [opened]
+
+jobs:
+  greet_new_contributor:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: wow-actions/[email protected]
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          FIRST_ISSUE_REACTIONS: "+1, hooray, rocket, heart"
+          FIRST_ISSUE: >
+            👋 Greetings @{{ author }}!
+            
+            We're thrilled to see you opening your first issue! Your input is invaluable to us. Don’t forget to adhere to our issue template for the best experience.
+
+          FIRST_PR: >
+            👋 Welcome aboard, @{{ author }}!
+            
+            We're delighted to have your first pull request! Please take a moment to check our contributing guidelines to ensure a smooth process.
+
+          FIRST_PR_MERGED: >
+            🎉 Kudos @{{ author }}!
+            
+            You've just merged your first pull request! We're excited to have you in our community. Keep up the fantastic contributions!
+          STAR_MESSAGE: If you enjoy this project, please consider ⭐ starring ⭐ our repository!
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

CONTRIBUTORS.svg

@@ -0,0 +1,83 @@
+# Geographic Distance and Travel Time Calculator
+
+This Python script calculates the geodesic distance between two geographic coordinates and estimates travel time based on a given average speed. It uses the geopy library to compute distances.
+
+## Features
+
+-   Input coordinates for two locations (latitude and longitude) interactively.
+-   Calculate the distance between the two coordinates in kilometers.
+-   Estimate the travel time based on a given average speed (in km/h).
+
+## Prerequisites
+
+-   Python 3.x installed on your system.
+
+## Setup
+
+1. Clone the repository
+
+    ```bash
+    git clone https://github.com/king04aman/All-In-One-Python-Projects.git
+    cd All-In-One-Python-Projects/Geographic Distance
+    ```
+
+2. Create and activate a virtual environment
+
+-   For macOS/Linux:
+
+    ```bash
+    python3 -m venv venv
+    source venv/bin/activate
+    ```
+
+-   For Windows:
+
+    ```bash
+    python -m venv venv
+    venv\Scripts\activate
+    ```
+
+3. Install the required dependencies
+
+    The required packages are listed in requirements.txt. Install them using the following command:
+
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+    Note: The main dependency is geopy for calculating distances based on geodesic coordinates.
+
+## Usage
+
+1. Run the script:
+
+    ```bash
+    python geographic_distance.py
+    ```
+
+2. Enter the coordinates (latitude and longitude) of the two locations when prompted.
+3. Enter the average speed in km/h to calculate the travel time.
+
+    Example input:
+
+    ```
+    Enter the latitude and longitude of the first location (lat1, lon1) Example: 40.7128, -74.006: 52.5200, 13.4050
+    Enter the latitude and longitude of the second location (lat2, lon2) Example: 37.7749, -122.4194: 48.8566, 2.3522
+    Enter the average speed in km/h Example: 60: 80
+    ```
+
+    Example output:
+
+    ```
+    Distance between the two coordinates: 878.84 kilometers
+    Estimated travel time: 10.99 hours
+    ```
+
+## Requirements
+
+Here’s a list of Python dependencies in requirements.txt:
+
+```
+geopy==2.2.0
+pytest==8.3.3
+```

Geographic Distance/README.md

@@ -0,0 +1,49 @@
+from geopy.distance import geodesic
+
+
+def calculate_distance_and_time(coord1, coord2, avg_speed):
+    """
+    Calculate the distance between two coordinates and estimate travel time.
+    :param coord1: Tuple containing the latitude and longitude of the first location (lat1, lon1)
+    :param coord2: Tuple containing the latitude and longitude of the second location (lat2, lon2)
+    :param avg_speed: Average speed in km/h for estimating travel time
+    :return: Distance in kilometers and estimated travel time in hours
+    """
+
+    # Calculate geodesic distance
+    distance = geodesic(coord1, coord2).kilometers
+    # Estimate travel time (distance / speed)
+    travel_time = distance / avg_speed
+
+    return distance, travel_time
+
+
+def main():
+    # Coordinates (latitude, longitude)
+    try:
+        coord1 = tuple(map(float, input('Enter the latitude and longitude of the first location (lat1, lon1) Example: 40.7128, -74.006: ').split(',')))
+        coord2 = tuple(map(float, input('Enter the latitude and longitude of the second location (lat2, lon2) Example: 37.7749, -122.4194: ').split(',')))
+    except ValueError as e:
+        raise ValueError("Coordinates must be in the format 'lat, lon'") from e
+
+    if not all(-90 <= x <= 90 for x in (coord1[0], coord2[0])) or not all(-180 <= x <= 180 for x in (coord1[1], coord2[1])):
+        raise ValueError('Invalid coordinates')
+
+    # Speed in km/h (e.g., driving speed)
+    try:
+        avg_speed = float(input('Enter the average speed in km/h Example: 60: '))
+    except ValueError as e:
+        raise ValueError('Average speed must be a number') from e
+
+    if avg_speed <= 0:
+        raise ValueError('Average speed must be greater than 0.')
+
+    # Calculate the distance and travel time
+    distance, travel_time = calculate_distance_and_time(coord1, coord2, avg_speed)
+
+    print(f'Distance between the two coordinates: {distance:.2f} kilometers')
+    print(f'Estimated travel time: {travel_time:.2f} hours')
+
+
+if __name__ == '__main__':
+    main()

Geographic Distance/geographic_distance.py

@@ -0,0 +1,2 @@
+geopy==2.4.1
+pytest==8.3.3

Geographic Distance/requirements.txt

@@ -0,0 +1 @@
+python-3.12.7