Merge entrypoint-ify: Modernize for Sopel 8

Author: RustyBower

.coveragerc

@@ -3,28 +3,49 @@ name: Upload Python Package
 
 on:
   release:
-    types: [created]
-  workflow_dispatch:
+    types: [published]
 
-jobs:
-  deploy:
+permissions:
+  contents: read
 
+jobs:
+  build:
     runs-on: ubuntu-latest
-
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
+
       - name: Set up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
-      - name: Install dependencies
+          python-version: '3.12'
+
+      - name: Install build tooling
         run: |
           python -m pip install --upgrade pip
-          pip install setuptools wheel twine
-      - name: Build and publish
-        env:
-          TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
-          TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
-        run: |
-          python setup.py sdist bdist_wheel
-          twine upload dist/*
+          python -m pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: built-distributions
+          path: dist/
+
+  upload:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: built-distributions
+          path: dist/
+
+      - name: Publish package
+        uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/python-publish.yml

@@ -2,45 +2,33 @@ name: Python Tests
 
 on:
   push:
-    branches: [ master ]
+    branches: [master]
   pull_request:
-    branches: [ master ]
+    branches: [master]
   workflow_dispatch:
 
 jobs:
-  build:
-
+  test:
+    runs-on: ubuntu-latest
     strategy:
       matrix:
-        os: [ubuntu-latest]
-        python-version: [3.7, 3.8, 3.9]
-        include:
-          - python-version: 3.6
-            os: ubuntu-20.04
-
-    runs-on: ${{ matrix.os }}
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
 
     steps:
-    - uses: actions/checkout@v2
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
-      with:
-        python-version: ${{ matrix.python-version }}
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install flake8 pytest
-        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
-        if [ -f tests/requirements.txt ]; then pip install -r tests/requirements.txt; fi
-    - name: Install sopel-weather
-      run: |
-        python -m pip install -e .
-    - name: Lint with flake8
-      run: |
-        # 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: |
-        #pytest
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install flake8 pytest
+          python -m pip install -e .
+
+      - name: Lint with flake8
+        run: |
+          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+          flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics

.github/workflows/python-tests.yml

@@ -0,0 +1,3 @@
+{
+  "esbonio.sphinx.confDir": ""
+}

.vscode/settings.json

@@ -0,0 +1,79 @@
+# sopel-weather
+
+A weather lookup plugin for Sopel IRC bots.
+
+> **Note:** This package was previously published as `sopel-modules.weather`.
+> Please update your dependencies to use `sopel-weather` instead.
+
+## Installation
+
+```bash
+pip install sopel-weather
+```
+
+## Configuration
+
+You can automatically configure this plugin using `sopel configure --plugins`.
+
+Or configure manually in `~/.sopel/default.cfg`:
+
+```ini
+[weather]
+geocoords_provider = locationiq_us
+geocoords_api_key = YOUR_LOCATIONIQ_API_KEY
+weather_provider = openmeteo
+weather_api_key = dummy
+```
+
+## Usage
+
+### Current Weather
+
+```
+.weather              # Uses your saved location
+.weather seattle, us
+.weather london
+```
+
+Example output:
+```
+Paris, Ile-de-France, FR: 6°C (42°F), Clear, Humidity: 83%, UV Index: 0, Gentle breeze 4.0m/s (↗)
+```
+
+### Forecast
+
+```
+.forecast              # Uses your saved location
+.forecast seattle, us
+.forecast london
+```
+
+### Set Your Location
+
+```
+.setlocation london    # Set by city name
+.setlocation 98101     # Set by US zip code
+```
+
+## API Keys Required
+
+### GeoCoords Provider
+- [LocationIQ](https://locationiq.com/) - Free tier available
+
+### Weather Providers
+
+- **Open-Meteo** - No API key required (use any string)
+  - https://open-meteo.com/
+- **OpenWeatherMap** - Free tier available
+  - https://openweathermap.org/
+- **Pirate Weather** - Drop-in Dark Sky replacement
+  - https://pirateweather.net/
+
+## Requirements
+
+- Sopel 8.0+
+- Python 3.8+
+
+## License
+
+MIT License