Merge pull request #676 from atlanhq/APP-6839

APP-6839: Migrate to `uv`

Author: Aryamanz29

.dockerignore

@@ -0,0 +1,67 @@
+# Python files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+.venv/
+pip-log.txt
+pip-delete-this-directory.txt
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.log
+.git
+.mypy_cache
+.pytest_cache
+.hypothesis
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Documentation
+docs/
+*.md
+*.rst
+
+# Tests
+tests/
+test/
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+.travis.yml
+
+# Package build
+build/
+dist/
+*.egg-info/
+
+# Development
+.env
+.env.*
+requirements-dev.txt
+
+# Temporary files
+tmp/
+temp/
+.tmp/

.github/workflows/pyatlan-pr.yaml

@@ -22,6 +22,9 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
       - uses: pypa/[email protected]
         with:
             # Since we used pytest for dev
@@ -56,22 +59,21 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
       - name: Install dependencies
-        run: |
-          python -m pip install --no-cache-dir --upgrade pip setuptools
-          if [ -f requirements.txt ]; then pip install --no-cache-dir -r requirements.txt; fi
-          if [ -f requirements-dev.txt ]; then pip install --no-cache-dir -r requirements-dev.txt; fi
+        run: uv sync --extra dev
 
       - name: QA checks (ruff-format, ruff-lint, mypy)
-        run: |
-          ./qa-checks
+        run: uv run ./qa-checks
 
       - name: Run unit tests
         env: # Test tenant environment variables
           ATLAN_API_KEY: ${{ secrets.ATLAN_API_KEY }}
           ATLAN_BASE_URL: ${{ secrets.ATLAN_BASE_URL }}
         # Run with `pytest-sugar` for enhancing the overall test report output
-        run: pytest tests/unit --force-sugar
+        run: uv run pytest tests/unit --force-sugar
 
       - name: Prepare integration tests distribution
         id: distribute-integration-test-files
@@ -102,11 +104,11 @@ jobs:
           # https://github.com/actions/setup-python/issues/160"
           python-version: "3.9"
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
       - name: Install dependencies
-        run: |
-          python -m pip install --no-cache-dir --upgrade pip setuptools
-          if [ -f requirements.txt ]; then pip install --no-cache-dir -r requirements.txt; fi
-          if [ -f requirements-dev.txt ]; then pip install --no-cache-dir -r requirements-dev.txt; fi
+        run: uv sync --extra dev
 
       - name: Run integration tests
         env: # Test tenant environment variables
@@ -118,4 +120,4 @@ jobs:
           timeout_minutes: 10 # Maximum time per test job; otherwise, the job will fail
           # Run the integration test file using `pytest-timer` plugin
           # to display only the durations of the 10 slowest tests with `pytest-sugar`
-          command: pytest ${{ matrix.test_file }} -p name_of_plugin --timer-top-n 10 --force-sugar
+          command: uv run pytest ${{ matrix.test_file }} -p name_of_plugin --timer-top-n 10 --force-sugar

.github/workflows/pyatlan-publish.yaml

@@ -28,23 +28,22 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: '3.9'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install build
+        run: uv sync --extra dev
       - name: check tag
         id: check-tag
-        run: python check_tag.py
-      - name: Build package
-        run: python -m build
-      - name: Publish package
-        uses: pypa/[email protected]
-        with:
-          user: __token__
-          password: ${{ secrets.PYPI_API_TOKEN }}
+        run: uv run python check_tag.py
+      - name: Build and publish to PyPI
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          uv build
+          uv publish
       - name: Build Lambda layer
         run: |
-          pip install --target=python .
+          uv pip install --target=python .
       - uses: actions/upload-artifact@v4
         with:
           name: lambda-layer
@@ -62,15 +61,7 @@ jobs:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-      - name: Login to Docker Hub
-        uses: docker/login-action@v3
-        with:
-          username: ${{ vars.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
-      - name: Copy logging.conf
-        run: |
-          mkdir -p ./containers/base
-          cp ./pyatlan/logging.conf ./containers/base/
+
       - name: Set image tag from file
         id: set-image-tag
         run: |
@@ -83,7 +74,9 @@ jobs:
           push: true
           tags: |
             ghcr.io/atlanhq/atlan-python:${{ env.IMAGE_TAG }}
-            cedocker1/pyatlan:${{ env.IMAGE_TAG }}
-          context: ./containers
-          file: ./containers/Dockerfile
+            ghcr.io/atlanhq/atlan-python:latest
+          context: .
+          file: ./Dockerfile
           build-args: VERSION=${{ env.IMAGE_TAG }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/pyatlan-test-cron.yaml

@@ -20,15 +20,14 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
-          if [ -f requirements-dev.txt ]; then pip install -r requirements-dev.txt; fi
+        run: uv sync --extra dev
 
-      - name: QA checks (black, flake8, mypy)
-        run: |
-          ./qa-checks
+      - name: QA checks (ruff-format, ruff-lint, mypy)
+        run: uv run ./qa-checks
 
       - name: Test with pytest
         env: # Or as an environment variable
@@ -37,5 +36,5 @@ jobs:
         # Run the integration test suite using the `pytest-timer` plugin
         # to display only the durations of the 25 slowest tests with `pytest-sugar`
         run: |
-          pytest tests/unit
-          pytest tests/integration  -p name_of_plugin --timer-top-n 25
+          uv run pytest tests/unit
+          uv run pytest tests/integration  -p name_of_plugin --timer-top-n 25

.pre-commit-config.yaml

@@ -7,6 +7,7 @@ repos:
       - id: trailing-whitespace
       - id: debug-statements
 
+  # Use uv to run formatting and QA tools
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.9.7
     hooks:
@@ -15,3 +16,12 @@ repos:
         name: ruff-check-autofix
         args: ["check", "--select", "I", "--fix", "--silent"]
       - id: ruff-format
+  - repo: local
+    hooks:
+      - id: qa-checks
+        name: qa-checks
+        entry: uv run ./qa-checks
+        language: system
+        types: [python]
+        pass_filenames: false
+        stages: [manual]

Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.11-slim
+
+ARG VERSION
+
+# Install uv for faster package management
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+# Install pyatlan from PyPI
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv pip install --system --no-cache-dir pyatlan==${VERSION}
+
+# Set working directory
+WORKDIR /app
+
+CMD ["python"]

HISTORY.md

@@ -1,3 +1,14 @@
+## 7.1.2 (July 11, 2025)
+
+### QOL Improvements
+
+- Fixed `suggestions_test` integration test.
+- Generated latest typedefs models.
+- Updated Dockerfile to use `python:3.11-slim`.
+- Migrated SDK to use [`uv`](https://docs.astral.sh/uv) for development, building, and publishing the SDK.
+- Added `delete_type:HARD` optional parameter to `AssetClient.purge_by_guid()` method.
+- Made `FluentSearch` usage in `get_by_*()` methods consistent with `GET` API (return `active` and `archived` assets).
+
 ## 7.1.1 (June 30, 2025)
 
 ### QOL Improvements