geoservercloud 0.3.1.dev1__tar.gz → 0.3.1.dev4__tar.gz

geoservercloud-0.3.1.dev4/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.1
+Name: geoservercloud
+Version: 0.3.1.dev4
+Summary: Lightweight Python client to interact with GeoServer Cloud REST API, GeoServer ACL and OGC services
+License: BSD-2-Clause
+Author: Camptocamp
+Author-email: info@camptocamp.com
+Requires-Python: >=3.9
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: OWSLib
+Requires-Dist: jsonschema
+Requires-Dist: pytest-mock
+Requires-Dist: requests
+Requires-Dist: types-requests
+Requires-Dist: types-xmltodict
+Requires-Dist: xmltodict
+Description-Content-Type: text/markdown
+
+# python-geoservercloud
+
+## Installation
+
+From PyPI:
+
+```shell
+pip install geoservercloud
+```
+
+From git repository:
+
+```shell
+poetry install
+```
+
+## Quick start
+
+```python
+from geoservercloud import GeoServerCloud
+geoserver = GeoServerCloud(
+    url="http://localhost:9090/geoserver/cloud/",
+    user="admin",
+    password="geoserver",
+)
+geoserver.create_workspace("newworkspace")
+```
+
+## About
+
+Lightweight Python client to interact with GeoServer Cloud REST API, GeoServer ACL and OGC services.
+Intended use cases are listed below.
+
+### Programmatic setup of a GeoServer catalog
+
+For example, creating a workspace, connecting to a PostGIS datastore and publishing a PG layer:
+
+```python
+geoserver.create_workspace("example")
+geoserver.create_pg_datastore(
+    workspace="example",
+    datastore="example_store",
+    pg_host="localhost",
+    pg_port=5432,
+    pg_db="database",
+    pg_user="user",
+    pg_password="password"
+)
+geoserver.create_feature_type(
+    layer="layer_example"
+    workspace="example",
+    datastore="example_store",
+    title={
+        "en":"Layer title",
+        "fr": "Titre de la couche",
+        "default": "Default title",
+    },
+)
+```
+
+### Testing
+
+Automatic tests of GeoServer functionalities with `pytest`, for example before upgrading.
+The example below tests the fallback mechanism for internationalized layer titles in the GetCapabilities document.
+
+```python
+@pytest.mark.parametrize(
+    "language,expected_title",
+    [
+        (
+            "en",
+            "Layer title",
+        ),
+        (
+            "fr",
+            "Titre de la couche",
+        ),
+        (
+            "de,en",
+            "Layer title",
+        ),
+        (
+            None,
+            "Default title",
+        ),
+    ],
+)
+def test_i18n_layer_title(geoserver, language, expected_title):
+    capabilities = geoserver.get_wms_layers(
+        workspace="example",
+        accept_languages=language,
+    )
+    layer = capabilities.get("Layer")
+    assert layer.get("Title") == expected_title
+```
+

geoservercloud-0.3.1.dev4/README.md

@@ -0,0 +1,95 @@
+# python-geoservercloud
+
+## Installation
+
+From PyPI:
+
+```shell
+pip install geoservercloud
+```
+
+From git repository:
+
+```shell
+poetry install
+```
+
+## Quick start
+
+```python
+from geoservercloud import GeoServerCloud
+geoserver = GeoServerCloud(
+    url="http://localhost:9090/geoserver/cloud/",
+    user="admin",
+    password="geoserver",
+)
+geoserver.create_workspace("newworkspace")
+```
+
+## About
+
+Lightweight Python client to interact with GeoServer Cloud REST API, GeoServer ACL and OGC services.
+Intended use cases are listed below.
+
+### Programmatic setup of a GeoServer catalog
+
+For example, creating a workspace, connecting to a PostGIS datastore and publishing a PG layer:
+
+```python
+geoserver.create_workspace("example")
+geoserver.create_pg_datastore(
+    workspace="example",
+    datastore="example_store",
+    pg_host="localhost",
+    pg_port=5432,
+    pg_db="database",
+    pg_user="user",
+    pg_password="password"
+)
+geoserver.create_feature_type(
+    layer="layer_example"
+    workspace="example",
+    datastore="example_store",
+    title={
+        "en":"Layer title",
+        "fr": "Titre de la couche",
+        "default": "Default title",
+    },
+)
+```
+
+### Testing
+
+Automatic tests of GeoServer functionalities with `pytest`, for example before upgrading.
+The example below tests the fallback mechanism for internationalized layer titles in the GetCapabilities document.
+
+```python
+@pytest.mark.parametrize(
+    "language,expected_title",
+    [
+        (
+            "en",
+            "Layer title",
+        ),
+        (
+            "fr",
+            "Titre de la couche",
+        ),
+        (
+            "de,en",
+            "Layer title",
+        ),
+        (
+            None,
+            "Default title",
+        ),
+    ],
+)
+def test_i18n_layer_title(geoserver, language, expected_title):
+    capabilities = geoserver.get_wms_layers(
+        workspace="example",
+        accept_languages=language,
+    )
+    layer = capabilities.get("Layer")
+    assert layer.get("Title") == expected_title
+```

geoservercloud-0.3.1.dev4/geoservercloud/__init__.py

@@ -0,0 +1,4 @@
+from .geoservercloud import GeoServerCloud
+from .geoservercloudsync import GeoServerCloudSync
+
+__all__: list[str] = ["GeoServerCloud", "GeoServerCloudSync"]