Merge remote-tracking branch 'origin/main'

Author: JawadSher

.github/workflows/pylint.yml

@@ -0,0 +1,23 @@
+name: Pylint
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10"]
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pylint
+    - name: Analysing the code with pylint
+      run: |
+        pylint $(git ls-files '*.py')

.github/workflows/python-package-conda.yml

@@ -0,0 +1,34 @@
+name: Python Package using Conda
+
+on: [push]
+
+jobs:
+  build-linux:
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 5
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python 3.10
+      uses: actions/setup-python@v3
+      with:
+        python-version: '3.10'
+    - name: Add conda to system path
+      run: |
+        # $CONDA is an environment variable pointing to the root of the miniconda directory
+        echo $CONDA/bin >> $GITHUB_PATH
+    - name: Install dependencies
+      run: |
+        conda env update --file environment.yml --name base
+    - name: Lint with flake8
+      run: |
+        conda install flake8
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with pytest
+      run: |
+        conda install pytest
+        pytest

.github/workflows/python-publish.yml

@@ -0,0 +1,39 @@
+# This workflow will upload a Python Package using Twine when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v3
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+    - name: Build package
+      run: python -m build
+    - name: Publish package
+      uses: pypa/gh-action-pypi-publish@27b31702a0e7fc50959f5ad993c78deac1bdfc29
+      with:
+        user: __token__
+        password: ${{ secrets.PYPI_API_TOKEN }}

Project 1 - Number Guessing Game/README.md

@@ -0,0 +1,31 @@
+## Number Guessing Game Explanation
+
+This Python script implements a simple number guessing game where the user has to guess a randomly generated number within a certain number of rounds.
+
+### How it Works
+
+- The script starts by importing necessary modules: `random` for generating random numbers and `time` for implementing a countdown.
+- A random number between 0 and 99 is generated using `random.randint(0, 99)`.
+- The user is prompted to input the number of rounds they want to play.
+- If the input number of rounds is 0, the script prompts the user to enter a valid number of rounds.
+- Otherwise, a countdown of 3 seconds is initiated using `time.sleep(1)` and displayed on the console.
+- After the countdown, the game begins with the specified number of rounds.
+- In each round, the user is prompted to guess the number.
+- Feedback is provided to the user based on their guess:
+  - If the guess is higher than the random number, the script informs the user that their input is greater.
+  - If the guess is lower than the random number, the script informs the user that their input is less.
+  - If the guess is equal to the random number, the script congratulates the user and ends the game.
+- The number of rounds remaining is decremented after each guess, and the user is informed about it.
+- The game continues until either the user guesses the correct number or runs out of rounds.
+
+### How to Use
+
+1. Clone the repository or download the Python script.
+   ```
+   https://github.com/JawadSher/Python-Projects-Beginner-to-Advance/tree/main/Project%201%20-%20Number%20Guessing%20Game
+3. Run the script using Python 3.x.
+4. Enter the desired number of rounds when prompted.
+5. Follow the instructions to guess the random number within the specified rounds.
+
+Enjoy playing the number guessing game!
+