# workers-py

**Repository Path**: mirrors_cloudflare/workers-py

## Basic Information

- **Project Name**: workers-py
- **Description**: Write Cloudflare Workers in 100% Python via Pyodide.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-16
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# workers-py

A set of libraries and tools for Python Workers.


## Pywrangler

A CLI tool for managing vendored packages in a Python Workers project.

### Installation

On Linux, you may be able to install the tool globally by running:

```
uv tool install workers-py
```

Alternatively, you can add `workers-py` to your pyproject.toml:

```
[dependency-groups]
dev = ["workers-py"]
```

Then run via `uv run pywrangler`.

### Usage

```bash
uv run pywrangler --help
uv run pywrangler sync
```

### Development

To run the CLI tool while developing it, install it globally:

```
uv tool install -e .
```

Then run it via `pywrangler`.

Alternatively, you can add `workers-py` to your pyproject.toml:

```
[dependency-groups]
dev = ["workers-py"]

[tool.uv.sources]
workers-py = { path = "../workers-py" }
```

Then run via `uv run pywrangler`.

#### Lint

```
uv run ruff check --fix
uv run ruff format
```

#### Tests

```
$ uv cache clean
$ uv run pytest
$ uv run pytest tests/test_cli.py::test_sync_command_handles_missing_pyproject -v # Specific test
```