Merge branch 'thugeyy' of https://github.com/thugeyy/All-In-One-Python-Projects into thugeyy

Author: thugeyy

.github/ISSUE_TEMPLATE/PROJECT_SUGGESTION_TEMPLATE.md

@@ -0,0 +1,25 @@
+---
+name: Project Suggestion
+about: Propose an idea for a new project
+title: ""
+labels: "Project Suggestion"
+assignees: ""
+---
+
+### 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/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: "Bug Report"
+about: "Report a bug or issue."
+title: "Bug Report Title"
+labels: ["bug", "help wanted"]
+---
+
+## Description
+Please describe the bug you encountered, including steps to reproduce it.
+
+## Steps to Reproduce
+1. Step 1
+2. Step 2
+3. Step 3 ...
+
+## Expected Behavior
+What did you expect to happen?
+
+## Actual Behavior
+What actually happened?
+
+## Additional Context
+Add any other context about the problem, screenshots, or logs that might be helpful.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,27 @@
+blank_issues_enabled: false 
+contact: false 
+
+templates:
+  - name: "Project Suggestion"
+    description: "Propose an idea for a new project."
+    title: "Project Suggestion Title"
+    labels: ["Project Suggestion"]
+  
+  - name: "Bug Report"
+    description: "Report a bug or issue."
+    title: "Bug Report Title"
+    labels: ["bug", "help wanted"]
+  
+  - name: "Feature Request"
+    description: "Request a new feature or enhancement."
+    title: "Feature Request Title"
+    labels: ["feature", "enhancement"]
+
+  - name: "Other"
+    description: "Use this template for any other issues or inquiries."
+    title: "Other Issue Title"
+    labels: ["question", "others"]
+
+choose_template:
+  title: "Choose an Issue Template"
+  description: "Please select one of the templates below to create your issue."

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,15 @@
+---
+name: "Feature Request"
+about: "Request a new feature or enhancement."
+title: "Feature Request Title"
+labels: ["feature", "enhancement"]
+---
+
+## Feature Description
+Please describe the feature you would like to request.
+
+## Use Cases
+How will this feature be used? Please provide examples.
+
+## Additional Context
+Add any other context about the feature request, including design ideas or potential impacts.

.github/ISSUE_TEMPLATE/other_issue.md

@@ -0,0 +1,15 @@
+---
+name: "Other"
+about: "Use this template for any other issues or inquiries."
+title: "Other Issue Title"
+labels: ["question", "other"]
+---
+
+## Description
+Please provide a detailed description of your inquiry or issue.
+
+## Context
+Add any relevant context or background information that may help in addressing your request.
+
+## Additional Information
+If applicable, include any additional information, screenshots, or references.

.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/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,80 @@
+name: Welcome Comments
+
+permissions:
+  actions: write
+  attestations: write
+  checks: write
+  contents: write
+  deployments: write
+  id-token: write
+  issues: write
+  discussions: write
+  packages: write
+  pages: write
+  pull-requests: write
+  repository-projects: write
+  security-events: write
+  statuses: write
+
+on:
+  issues:
+    types: [opened, closed]
+  pull_request_target:
+    types: [opened, closed]
+
+jobs:
+  welcomer:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Auto Welcome on Issues or PRs
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const author = context.payload.sender.login;
+            const commentBody = (message) => `👋 @${author} 👋\n\n${message}`;
+
+            if (context.eventName === 'issues') {
+              const issue = context.payload.issue;
+
+              if (context.payload.action === 'opened') {
+                const message = `We're thrilled to see you opening an issue! Your input is valuable to us. Don’t forget to fill out our issue template for the best experience. We will look into it soon.`;
+                github.rest.issues.createComment({
+                  issue_number: issue.number,
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  body: commentBody(message),
+                });
+              } else if (context.payload.action === 'closed') {
+                const message = `Thanks for closing the issue! We appreciate your updates.`;
+                github.rest.issues.createComment({
+                  issue_number: issue.number,
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  body: commentBody(message),
+                });
+              }
+            } else if (context.eventName === 'pull_request_target') {
+              const pr = context.payload.pull_request;
+
+              if (context.payload.action === 'opened') {
+                const message = `We're delighted to have your pull request! Please take a moment to check our contributing guidelines and ensure you've filled out the PR template for a smooth process. We will review it soon.`;
+                github.rest.issues.createComment({
+                  issue_number: pr.number,
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  body: commentBody(message),
+                });
+              } else if (context.payload.action === 'closed') {
+            		const message = pr.merged 
+                  ? `🎉 You've just merged your pull request! We're excited to have you in our community. Keep up the fantastic contributions to the project!`
+                  : `Thanks for closing the pull request! Your contributions are valuable to us.`;
+                
+                github.rest.issues.createComment({
+                  issue_number: pr.number,
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  body: commentBody(message),
+                });
+              }
+            }

Geographic Distance/README.md

@@ -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
+```