Merge pull request #8 from eoda-dev/dev

Dev

Author: crazycapivara

.github/workflows/deploy-docs.yml

@@ -0,0 +1,53 @@
+name: Build and deploy docs
+
+on:
+  push:
+    branches:
+      - main
+      - dev
+  pull_request:
+    branches:
+      - "*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install package
+        run: pip install -e .
+
+      - name: Install dependencies
+        run: pip install -r requirements.docs.txt
+
+      - name: Build docs
+        run: mkdocs build -d dist
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+  deploy:
+    needs: build
+    if: github.ref == 'refs/heads/main'
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/pytest.yml

@@ -0,0 +1,31 @@
+name: Test package
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # You can test your matrix by printing the current Python version
+      - name: Display Python version
+        run: python -c "import sys; print(sys.version)"
+
+      - name: Install package
+        run: pip install -e .
+
+      - name: Install dev dependencies
+        run: pip install -r requirements.dev.txt
+
+      - name: Test package
+        run: pytest

README.md

@@ -1,4 +1,38 @@
-# OpenLayers for Python
+# py-openlayers: OpenLayers for Python
+
+[![Release](https://img.shields.io/github/v/release/eoda-dev/py-openlayers)](https://img.shields.io/github/v/release/eoda-dev/py-openlayers)
+[![pypi](https://img.shields.io/pypi/v/openlayers.svg)](https://pypi.python.org/pypi/openlayers)
+[![License](https://img.shields.io/github/license/eoda-dev/py-openlayers)](https://img.shields.io/github/license/eoda-dev/py-openlayers)
+[![OpenLayers JS](https://img.shields.io/badge/OpenLayers-v10.5.0-blue.svg)](https://github.com/openlayers/openlayers/releases//tag/v10.5.0)
+
+Provides Python bindings for [Openlayers](https://openlayers.org/), a high-performance, full-featured web mapping library that displays maps from various sources and formats. It makes it a easy to create interactive maps in [Marimo](https://marimo.io/) and [Jupyter](https://jupyter.org/) notebbooks with a few lines of code in a pydantic way.
+
+## Features
+
+### Tiled Layers
+
+Pull tiles from OSM, CartoDB, MapTiler and any other XYZ source.
+
+
+### Vector Layers
+
+Render vector data from GeoJSON, TopoJSON, KML, GML and other formats. 
+
+### Controls
+
+Add geocoding, draw, full screen and other controls to your map.
+
+### WebGL
+
+Render large data sets using WebGL.
+
+### PMTiles
+
+Render PMTiles from vector and raster sources.
+
+### Interactions
+
+Drag and drop GPX, GeoJSON, KML or TopoJSON files on to the map. Modify, draw and select features.
 
 ## Installation
 
@@ -7,3 +41,21 @@ uv init
 
 uv add "git+https://github.com/eoda-dev/py-openlayers@main"
 ```
+
+## Quickstart
+
+```python
+import openlayers as ol
+
+# Jupyter or Marimo
+m = ol.MapWidget()
+m # Display map
+
+# Standalone
+m = ol.Map()
+m.save()
+```
+
+## Note
+
+The documentation is still in an early stage, more examples will be added as soon as possible.

TODOS.md

@@ -0,0 +1,5 @@
+# TODOS
+
+## STAC layers
+
+https://openlayers.org/en/latest/examples/stac-item.html

docs/api/basemaps.md

@@ -0,0 +1,7 @@
+# Basemaps
+
+::: openlayers.basemaps.BasemapLayer
+
+::: openlayers.basemaps.CartoBasemapLayer
+
+::: openlayers.basemaps.MapTilerBasemapLayer

docs/api/controls.md

@@ -0,0 +1,3 @@
+# Controls
+
+::: openlayers.controls

docs/api/express.md

@@ -0,0 +1,3 @@
+# OpenLayersExpress
+
+::: openlayers.express.GeoJSONLayer

docs/api/geopandas.md

@@ -0,0 +1,5 @@
+# GeoPandas
+
+::: openlayers.geopandas.OLAccessor
+
+::: openlayers.geopandas.GeoDataFrame

docs/api/layers.md

@@ -0,0 +1,15 @@
+# Layers
+
+::: openlayers.layers.Layer
+
+::: openlayers.layers.VectorLayer
+
+::: openlayers.layers.VectorTileLayer
+
+::: openlayers.layers.TileLayer
+
+::: openlayers.layers.WebGLVectorLayer
+
+::: openlayers.layers.WebGLVectorTileLayer
+
+::: openlayers.layers.WebGLTileLayer

docs/api/map.md

@@ -0,0 +1,8 @@
+# Map
+
+::: openlayers.Map
+
+::: openlayers.view.View
+
+::: openlayers.MapWidget
+