Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/build-docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ jobs:
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: astral-sh/setup-uv@v10.2.0
- uses: astral-sh/setup-uv@v10.3.2
with:
python-version: "3.12"
- name: Install Dependencies
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ jobs:

steps:
- uses: "actions/checkout@v4"
- uses: "astral-sh/setup-uv@v10.2.0"
- uses: "astral-sh/setup-uv@v10.3.2"
- name: Build
run: uv build
- name: Publish
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ jobs:
steps:
- uses: actions/checkout@v4
- name: Install uv and set up Python ${{ matrix.python-version }}
uses: astral-sh/setup-uv@v10.2.0
uses: astral-sh/setup-uv@v10.3.2
with:
python-version: ${{ matrix.python-version }}
enable-cache: true
Expand All @@ -43,7 +43,7 @@ jobs:
steps:
- uses: actions/checkout@v4
- name: Install uv
uses: astral-sh/setup-uv@v10.2.0
uses: astral-sh/setup-uv@v10.3.2
- name: get coverage files
uses: actions/download-artifact@v8
with:
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,10 +66,10 @@ installed when you install SQLAlchemy-file.
$ pip install sqlalchemy-file
```

### Poetry
### uv

```shell
$ poetry add sqlalchemy-file
$ uv add sqlalchemy-file
```

### Optional dependencies (extras)
Expand All @@ -87,7 +87,7 @@ $ pip install "sqlalchemy-file[local,pillow]"
```

```shell
$ poetry add "sqlalchemy-file[all]"
$ uv add "sqlalchemy-file[all]"
```

Without the matching extra you get an explicit `ImportError` telling you which extra to install
Expand Down
2 changes: 1 addition & 1 deletion docs/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.7.0] - 2026-10-22
## [0.7.0] - 2026-10-24

---

Expand Down
24 changes: 21 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ The key features are:
## Requirements

A recent and currently supported version of Python (right
now, <a href="https://www.python.org/downloads/" class="external-link" target="_blank">Python supports versions 3.7 and
now, <a href="https://www.python.org/downloads/" class="external-link" target="_blank">Python supports versions 3.11 and
above</a>).

As **SQLAlchemy-file** is based on **Apache Libcloud** and **SQLAlchemy**, it requires them. They will be automatically
Expand All @@ -67,10 +67,28 @@ installed when you install SQLAlchemy-file.
$ pip install sqlalchemy-file
```

### Poetry
### uv

```shell
$ poetry add sqlalchemy-file
$ uv add sqlalchemy-file
```

### Optional dependencies (extras)

Some features need third-party packages that are **not** installed by default:

| Extra | Installs | Required for |
|--------------------------------|---------------------------------------------|---------------------------------------------------------------------|
| `sqlalchemy-file[pillow]` | `Pillow` | `ImageField`, `ImageValidator`, `ThumbnailGenerator` |
| `sqlalchemy-file[local]` | `fasteners` | `LocalStorageDriver` backend (required by libcloud's local storage) |
| `sqlalchemy-file[all]` | `Pillow` + `fasteners` | Everything above |

```shell
$ pip install "sqlalchemy-file[local,pillow]"
```

```shell
$ uv add "sqlalchemy-file[all]"
```

## Example
Expand Down
4 changes: 2 additions & 2 deletions docs/tutorial/quick-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@ You can simply install **SQLAlchemy-file** from the PyPi:
$ pip install sqlalchemy-file
```

### Poetry
### uv

```shell
$ poetry add sqlalchemy-file
$ uv add sqlalchemy-file
```

## Usage
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ conflicts = [
{ group = "sqla21" },
],
]
# sqla21 default so plain `uv sync` tests the 2.1 series. sqla20 is opt-in;
# sqla21 default so plain `uv sync` tests the 2.1 series. sqla20 is opt-in.
# conflicting groups require `uv run --no-default-groups --group sqla20 ...`.
default-groups = ["dev", "lint", "test", "cov", "docs", "sqla21"]

Expand Down
2 changes: 1 addition & 1 deletion sqlalchemy_file/__init__.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
__version__ = "0.7.0.rc1"
__version__ = "0.7.0"

from .file import File as File
from .types import FileField as FileField
Expand Down
Loading