Modernize Build System and CI/CD with uv and PEP Standards (#123)

* build: migrate to uv, pin Python 3.10, and remove pip-tools

- Replace imperative setup.py with declarative pyproject.toml (PEP 621)
- Adopt PEP 517/518 compliant build system using hatchling
- Pin `requires-python = ">=3.10"` to align with Build CI defaults
- Remove pip-tools as uv natively handles locking and syncing
- Initialize uv.lock for deterministic and faster dependency resolution
- Reorganize dev dependencies into [dependency-groups]

* refactor: update version references to use standardized __version__

- Update ipinfo/handler_utils.py to use __version__ instead of SDK_VERSION
- Remove legacy version imports in setup.py to follow PEP 517
- Ensure User-Agent strings reflect the standardized version attribute
- Align internal API with PEP 396 module versioning conventions

* ci: fully integrate GitHub Actions with uv project workflow

- Replace legacy `uv pip install` with `uv sync --all-groups` for locked dev environments
- Remove manual `requirements.txt` installation in favor of pyproject.toml discovery
- Clean up `uv build` by removing unnecessary `--no-build-isolation` flag
- Leverage `astral-sh/setup-uv` caching for faster test and publish runs

* ci: optimize uv setup by pinning version and narrowing cache glob

* Simplify workflows

* Revert .gitignore change

* Remove useless info in pyproject.toml

* Remove unnecessary setup.py and requirements files

* Drop Python 3.9

* Update uv.lock

---------

Co-authored-by: Silvano Cerza <silvanocerza@gmail.com>

Author: abstract-333

.github/workflows/cd_pypi.yml

@@ -3,11 +3,10 @@ name: Release Python Package to pypi
 on:
   push:
     tags:
-      - 'v*'
+      - "v*"
 
 jobs:
   publish:
-
     runs-on: ubuntu-latest
 
     environment:
@@ -18,19 +17,19 @@ jobs:
       id-token: write
 
     steps:
-    - name: Checkout
-      uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v6
 
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: '3.10'
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.10"
 
-    - name: Install dependencies
-      run: pip install -r requirements.txt
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
 
-    - name: Build package
-      run: python setup.py sdist bdist_wheel
+      - name: Build package
+        run: uv build
 
-    - name: Publish package
-      uses: pypa/gh-action-pypi-publish@release/v1
+      - name: Publish package
+        run: uv publish

.github/workflows/test.yaml

@@ -13,19 +13,22 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements.txt
+        run: uv sync --all-groups
+
       - name: Run tests
-        run: pytest
+        run: uv run pytest
         env:
           IPINFO_TOKEN: ${{ secrets.IPINFO_TOKEN }}

ipinfo/handler_utils.py

@@ -7,7 +7,7 @@
 import os
 import sys
 
-from .version import SDK_VERSION
+from .version import __version__ as SDK_VERSION
 
 # Base URL to make requests against.
 API_URL = "https://ipinfo.io"

ipinfo/version.py

@@ -1 +1 @@
-SDK_VERSION = "5.4.1"
+__version__ = "5.4.1"

pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "ipinfo"
+dynamic = ["version"]
+description = "Official Python library for IPInfo"
+readme = "README.md"
+authors = [
+    { name = "IPinfo", email = "support@ipinfo.io" }
+]
+license = { text = "Apache License 2.0" }
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.18.4",
+    "cachetools==4.2.0",
+    "aiohttp>=3.12.14,<=4",
+]
+
+[project.urls]
+Homepage = "https://github.com/ipinfo/python"
+Documentation = "https://ipinfo.io/developers"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+path = "ipinfo/version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["ipinfo"]
+
+[dependency-groups]
+dev = [
+    "pytest==8.4.1",
+    "pytest-asyncio==1.1.0",
+    "black==22.6.0",
+]