search

geopython / pywps

PyWPS is an implementation of the Web Processing Service standard from the Open Geospatial Consortium. PyWPS is written in Python.
https://pywps.org
MIT License
175 stars 117 forks source link

Documentation outdated #669

Open sehHeiden opened 1 year ago

sehHeiden commented 1 year ago

Description

I tried to start using PyWPS. I had some problems I want to hint at at the documentation at the website documentation. Background: For a study project I shall get a cost path algorithm running with pywps.

First of all, the documentation refers to PyWPS 4.3, while the version in pypi is 4.5.2. Additionally, it is asked to install python-gdal on Ubuntu. When I checked correctly it exists for Ubuntu 18.04 only. I could not install pywps with the pip command $ sudo pip install -e git+https://github.com/geopython/pywps.git@master#egg=pywps-dev. But I could install the version from pypi, which is not listed in the documentation. Then I wanted to test my installation with pywps-flask. Flask is not listed in the requirements of pywps perhaps that is a good idea. When I you refer to pywps-flask on several sites.

Travis-ci linked is: https://travis-ci.org/github/geopython/pywps. Which is not the current version. The last build attempt was about a year old.

I could not get pywps-flask running. I used the method mentioned on pypi. I to install pywps-flask I needed the https link instead of the git link. Even after turning of the firewall. Then I tried to run it, but it looks to me, that the versions of pywps and pywps-flask do not match? The stacktrace shows that: pywps-flask\processes\area.py tries to import temp_dir from pywps.pywpsserver. But my installation of pywps 4.5.2 does not find any modul pywpsserver. While am I at it: pycharm shows a warning for pywps-flask/demp.py because pywps.configuration is not added in the init.py. pyflask\process\feature_count.py try to import from pywps.app.basic import xpath_ns. With xpath_ns is not existing. pywps-flask\processes\grass_buffer.py uses grasses. Which should be hinted how to get it?

Environment

IceflowRE commented 1 year ago

The documentation is very much outdated and also lacking information everywhere. There is not even a step by step tutorial to setup a production server. Just use apache, oh and also here the links to installation and configuration, but they are not helping. Everywhere is pyflask used as an example, but also said do not use in production.

Configuration documentation and the sample file are also contradict to each other.

outputpath and outputurl must correspond. outputpath is the name of the resulting target directory, where all output data files are stored (with unique names). outputurl is the corresponding full URL, which is targeting to outputpath directory.

Example: outputpath=/var/www/wps/outputs shall correspond with outputurl=http://foo.bar/wps/outputs

Meanwhile the example:

outputurl=/data/ outputpath=/tmp/outputs/

At this point, some should consider this as abandonware.