Metadata-Version: 2.3
Name: tilecloud-chain
Version: 1.23.1
Summary: Tools to generate tiles from WMS or Mapnik, to S3, Berkeley DB, MBTiles, or local filesystem in WMTS layout using Amazon cloud services.
License: BSD-2-Clause
Keywords: gis,tilecloud,chain
Author: Camptocamp
Author-email: info@camptocamp.com
Requires-Python: >=3.10
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Pyramid
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Typing :: Typed
Requires-Dist: Jinja2
Requires-Dist: Paste
Requires-Dist: PyYAML
Requires-Dist: Shapely
Requires-Dist: aiofiles
Requires-Dist: aiohttp
Requires-Dist: asyncpg
Requires-Dist: azure-storage-blob
Requires-Dist: c2cwsgiutils[broadcast,debug,oauth2,standard]
Requires-Dist: certifi
Requires-Dist: jsonschema
Requires-Dist: jsonschema-validator-new
Requires-Dist: nest-asyncio
Requires-Dist: psutil
Requires-Dist: psycopg[binary]
Requires-Dist: pyproj
Requires-Dist: pyramid
Requires-Dist: pyramid-mako
Requires-Dist: pytest-asyncio
Requires-Dist: python-dateutil
Requires-Dist: sqlalchemy[asyncio]
Requires-Dist: tilecloud[aws,azure,redis,wsgi]
Requires-Dist: waitress
Project-URL: Bug Tracker, https://github.com/camptocamp/tilecloud-chain/issues
Project-URL: Repository, https://github.com/camptocamp/tilecloud-chain
Description-Content-Type: text/markdown

# TileCloud-chain

TileCloud Chain is a comprehensive toolset for managing tile generation workflows. It supports various source and destination formats, making it a versatile solution for map tile management.

## Sources

- Web Map Service (WMS)
- Mapnik rendering engine

## Destination Formats and Storage

- Web Map Tile Service (WMTS) layout
- Amazon S3 storage
- Azure Blob storage
- Local filesystem

## Key Features

- Tile generation with configurable parameters
- Automatic removal of empty tiles
- Geographic filtering (bbox and geometry-based)
- MetaTile support for efficient generation
- Legend image generation
- GetCapabilities document
- OpenLayers demo page
- Empty tile detection via hashing
- Cache synchronization
- Post-processing capabilities

## Legacy Support

Note: The following features are maintained for backward compatibility:

- Berkeley DB integration
- SQLite (MBTiles) support
- Mapnik rendering (Python 3 update pending)

## Visual Preview

The admin interface with PostgreSQL queue integration:

![TileCloud Chain Admin Interface](./admin-screenshot.png)

## Getting Started

Create a configuration file at `tilegeneration/config.yaml`.

Reference the [example configuration](https://github.com/camptocamp/tilecloud-chain/blob/master/example/tilegeneration/config.yaml).

## Support Policy

Only the latest release receives active support. Versions prior to 1.11 contain security vulnerabilities and should not be used.

## Development

### Building

```bash
make build
```

### Quality Assurance

```bash
make prospector
```

### Testing

```bash
make tests
```

## Documentation

- [Usage Guide](https://github.com/camptocamp/tilecloud-chain/blob/master/tilecloud_chain/USAGE.rst)
- [Configuration Reference](https://github.com/camptocamp/tilecloud-chain/blob/master/tilecloud_chain/CONFIG.md)

## Contributing

Set up pre-commit hooks:

```bash
pip install pre-commit
pre-commit install --allow-missing-config
```

