MapProxy 3.1.3__tar.gz → 4.0.0__tar.gz

{MapProxy-3.1.3 → mapproxy-4.0.0}/CHANGES.txt

@@ -1,3 +1,35 @@
+4.0.0 2025-03-21
+~~~~~~~~~~~~~~~~
+
+Breaking:
+  - Removed legacy seed configuration.
+  - Removed Python 3.8 support.
+  - Removed riak support as the client library is not maintained anymore. If you rely on the riak support you have to
+    continue to use version 3.1.3 with Python 3.8.
+
+Improvements:
+
+  - The tile removal and refresh code is improved by simplifying the usage of `remove_timestamp` and `before_timestamp`
+    and complementing them by new `remove_all` and `refresh_all` parameters.
+  - Add a default logging config to the docker images.
+  - Add environment variables to the docker images to enable and configure multiapp support.
+  - Added a docker compose file to make it easy to run & build docker images and to use as reference.
+  - Updated and improved the documentation about usage of the docker images.
+
+Maintenance:
+
+  - Use python build instead of invoking setup.py.
+  - Removal of the six library.
+  - Removed array initializers in function signatures.
+
+Fixes:
+
+  - Added `AdminstrativeArea` to WMTS serviceprovider metadata.
+  - Fixed spelling & grammar in seed.rst.
+  - Fixed problem with combined usage of `coverage` and the `remove_all` cache config parameters.
+  - Fixed missing dimension parameters in the `remove_tile` functions of various caches.
+
+
 3.1.3 2024-11-26
 ~~~~~~~~~~~~~~~~
 

{MapProxy-3.1.3 → mapproxy-4.0.0}/MapProxy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: MapProxy
-Version: 3.1.3
+Version: 4.0.0
 Summary: An accelerating proxy for tile and web map services
 Home-page: https://mapproxy.org
 Author: Oliver Tonnhofer
@@ -8,11 +8,9 @@ Author-email: olt@omniscale.de
 Maintainer: terrestris GmbH & Co. KG
 Maintainer-email: info@terrestris.de
 License: Apache Software License 2.0
-Platform: UNKNOWN
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -24,6 +22,24 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 License-File: COPYING.txt
 License-File: AUTHORS.txt
+Requires-Dist: PyYAML>=3.0
+Requires-Dist: future
+Requires-Dist: pyproj>=2
+Requires-Dist: jsonschema>=4
+Requires-Dist: werkzeug<4
+Requires-Dist: Pillow!=2.4.0,!=8.3.0,!=8.3.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: requires-dist
+Dynamic: summary
 
 MapProxy is an open source proxy for geospatial data. It caches, accelerates and transforms data from existing map services and serves any desktop or web GIS client.
 
@@ -37,6 +53,38 @@ The documentation is available at: http://mapproxy.github.io/mapproxy/latest/
 
 Changes
 -------
+4.0.0 2025-03-21
+~~~~~~~~~~~~~~~~
+
+Breaking:
+  - Removed legacy seed configuration.
+  - Removed Python 3.8 support.
+  - Removed riak support as the client library is not maintained anymore. If you rely on the riak support you have to
+    continue to use version 3.1.3 with Python 3.8.
+
+Improvements:
+
+  - The tile removal and refresh code is improved by simplifying the usage of `remove_timestamp` and `before_timestamp`
+    and complementing them by new `remove_all` and `refresh_all` parameters.
+  - Add a default logging config to the docker images.
+  - Add environment variables to the docker images to enable and configure multiapp support.
+  - Added a docker compose file to make it easy to run & build docker images and to use as reference.
+  - Updated and improved the documentation about usage of the docker images.
+
+Maintenance:
+
+  - Use python build instead of invoking setup.py.
+  - Removal of the six library.
+  - Removed array initializers in function signatures.
+
+Fixes:
+
+  - Added `AdminstrativeArea` to WMTS serviceprovider metadata.
+  - Fixed spelling & grammar in seed.rst.
+  - Fixed problem with combined usage of `coverage` and the `remove_all` cache config parameters.
+  - Fixed missing dimension parameters in the `remove_tile` functions of various caches.
+
+
 3.1.3 2024-11-26
 ~~~~~~~~~~~~~~~~
 
@@ -127,31 +175,7 @@ Fixes:
   - Fix gh-pages workflow
 
 
-2.2.0 2024-07-24
-~~~~~~~~~~~~~~~~
-
-Improvements:
-
-  - Add timeout to SQLite connect for geopackages. This helps against locking exceptions
-  - Improvement of documentation, typos, wrong cli commands, old python2 stuff
-  - The WMTS capabilites will now advertise the WMS GetLegendGraphic as a LegendURL if both services are active
-  - It is possible now to configure LegendURLs that should be shown in the WMTS capabilities
-  - A new method for plugins to intercept and modify requests made to MapProxy was added.
-
-Maintenance:
-
-  - Removal of debian package information
-  - Fix docs workflow
-
-Fixes:
-
-  - Remove import of the packaging library that does not appear in the `install_requires`
-  - Only install and use `importlib_resources` in python 3.8
-
-
 
 Older changes
 -------------
 See https://raw.github.com/mapproxy/mapproxy/master/CHANGES.txt
-
-

{MapProxy-3.1.3 → mapproxy-4.0.0}/MapProxy.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ COPYING.txt
 LICENSE.txt
 MANIFEST.in
 README.md
+pyproject.toml
 requirements-tests.txt
 setup.py
 MapProxy.egg-info/PKG-INFO
@@ -90,7 +91,6 @@ mapproxy/cache/meta.py
 mapproxy/cache/path.py
 mapproxy/cache/redis.py
 mapproxy/cache/renderd.py
-mapproxy/cache/riak.py
 mapproxy/cache/s3.py
 mapproxy/cache/tile.py
 mapproxy/client/__init__.py
@@ -400,7 +400,6 @@ mapproxy/test/system/fixture/renderd_client.yaml
 mapproxy/test/system/fixture/scalehints.yaml
 mapproxy/test/system/fixture/seed.yaml
 mapproxy/test/system/fixture/seed_mapproxy.yaml
-mapproxy/test/system/fixture/seed_old.yaml
 mapproxy/test/system/fixture/seed_timeouts.yaml
 mapproxy/test/system/fixture/seed_timeouts_mapproxy.yaml
 mapproxy/test/system/fixture/seedonly.yaml
@@ -438,7 +437,6 @@ mapproxy/test/unit/test_cache_couchdb.py
 mapproxy/test/unit/test_cache_geopackage.py
 mapproxy/test/unit/test_cache_mbtile.py
 mapproxy/test/unit/test_cache_redis.py
-mapproxy/test/unit/test_cache_riak.py
 mapproxy/test/unit/test_cache_s3.py
 mapproxy/test/unit/test_cache_tile.py
 mapproxy/test/unit/test_client.py

{MapProxy-3.1.3 → mapproxy-4.0.0}/MapProxy.egg-info/entry_points.txt

@@ -1,4 +1,3 @@
 [console_scripts]
 mapproxy-seed = mapproxy.seed.script:main
 mapproxy-util = mapproxy.script.util:main
-

{MapProxy-3.1.3 → mapproxy-4.0.0}/MapProxy.egg-info/requires.txt

@@ -1,9 +1,6 @@
-Pillow!=2.4.0,!=8.3.0,!=8.3.1
 PyYAML>=3.0
 future
-jsonschema>=4
 pyproj>=2
+jsonschema>=4
 werkzeug<4
-
-[:python_version <= "3.8"]
-importlib_resources
+Pillow!=2.4.0,!=8.3.0,!=8.3.1

{MapProxy-3.1.3 → mapproxy-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: MapProxy
-Version: 3.1.3
+Version: 4.0.0
 Summary: An accelerating proxy for tile and web map services
 Home-page: https://mapproxy.org
 Author: Oliver Tonnhofer
@@ -8,11 +8,9 @@ Author-email: olt@omniscale.de
 Maintainer: terrestris GmbH & Co. KG
 Maintainer-email: info@terrestris.de
 License: Apache Software License 2.0
-Platform: UNKNOWN
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -24,6 +22,24 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 License-File: COPYING.txt
 License-File: AUTHORS.txt
+Requires-Dist: PyYAML>=3.0
+Requires-Dist: future
+Requires-Dist: pyproj>=2
+Requires-Dist: jsonschema>=4
+Requires-Dist: werkzeug<4
+Requires-Dist: Pillow!=2.4.0,!=8.3.0,!=8.3.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: requires-dist
+Dynamic: summary
 
 MapProxy is an open source proxy for geospatial data. It caches, accelerates and transforms data from existing map services and serves any desktop or web GIS client.
 
@@ -37,6 +53,38 @@ The documentation is available at: http://mapproxy.github.io/mapproxy/latest/
 
 Changes
 -------
+4.0.0 2025-03-21
+~~~~~~~~~~~~~~~~
+
+Breaking:
+  - Removed legacy seed configuration.
+  - Removed Python 3.8 support.
+  - Removed riak support as the client library is not maintained anymore. If you rely on the riak support you have to
+    continue to use version 3.1.3 with Python 3.8.
+
+Improvements:
+
+  - The tile removal and refresh code is improved by simplifying the usage of `remove_timestamp` and `before_timestamp`
+    and complementing them by new `remove_all` and `refresh_all` parameters.
+  - Add a default logging config to the docker images.
+  - Add environment variables to the docker images to enable and configure multiapp support.
+  - Added a docker compose file to make it easy to run & build docker images and to use as reference.
+  - Updated and improved the documentation about usage of the docker images.
+
+Maintenance:
+
+  - Use python build instead of invoking setup.py.
+  - Removal of the six library.
+  - Removed array initializers in function signatures.
+
+Fixes:
+
+  - Added `AdminstrativeArea` to WMTS serviceprovider metadata.
+  - Fixed spelling & grammar in seed.rst.
+  - Fixed problem with combined usage of `coverage` and the `remove_all` cache config parameters.
+  - Fixed missing dimension parameters in the `remove_tile` functions of various caches.
+
+
 3.1.3 2024-11-26
 ~~~~~~~~~~~~~~~~
 
@@ -127,31 +175,7 @@ Fixes:
   - Fix gh-pages workflow
 
 
-2.2.0 2024-07-24
-~~~~~~~~~~~~~~~~
-
-Improvements:
-
-  - Add timeout to SQLite connect for geopackages. This helps against locking exceptions
-  - Improvement of documentation, typos, wrong cli commands, old python2 stuff
-  - The WMTS capabilites will now advertise the WMS GetLegendGraphic as a LegendURL if both services are active
-  - It is possible now to configure LegendURLs that should be shown in the WMTS capabilities
-  - A new method for plugins to intercept and modify requests made to MapProxy was added.
-
-Maintenance:
-
-  - Removal of debian package information
-  - Fix docs workflow
-
-Fixes:
-
-  - Remove import of the packaging library that does not appear in the `install_requires`
-  - Only install and use `importlib_resources` in python 3.8
-
-
 
 Older changes
 -------------
 See https://raw.github.com/mapproxy/mapproxy/master/CHANGES.txt
-
-

{MapProxy-3.1.3 → mapproxy-4.0.0}/doc/auth.rst

@@ -93,7 +93,8 @@ Here is a more elaborate example that denies requests to all layers that start w
           environ['mapproxy.authorize'] = self.authorize
           return self.app(environ, start_response)
 
-      def authorize(self, service, layers=[], environ=None, **kw):
+      def authorize(self, service, layers=None, environ=None, **kw):
+          layers = layers or None
           allowed = denied = False
           if service.startswith('wms.'):
               auth_layers = {}

{MapProxy-3.1.3 → mapproxy-4.0.0}/doc/caches.rst

@@ -317,61 +317,14 @@ MapProxy will place the JSON document for tile z=3, x=1, y=2 at ``http://localho
 
 The ``_attachments``-part is the internal structure of CouchDB where the tile itself is stored. You can access the tile directly at: ``http://localhost:9999/mywms_tiles/mygrid-3-1-2/tile``.
 
+
 .. _cache_riak:
 
 ``riak``
 ========
 
-.. versionadded:: 1.6.0
-
-Store tiles in a `Riak <http://basho.com/riak/>`_ cluster. MapProxy creates keys with binary data as value and timestamps as user defined metadata.
-This backend is good for very large caches which can be distributed over many nodes. Data can be distributed over multiple nodes providing a fault-tolernt and high-available storage. A Riak cluster is masterless and each node can handle read and write requests.
-
-Requirements
-------------
-
-You will need the `Python Riak client <https://pypi.org/project/riak>`_ version 2.4.2 or older. You can install it in the usual way, for example with ``pip install riak==2.4.2``. Environments with older version must be upgraded with ``pip install -U riak==2.4.2``. Python library depends on packages `python-dev`, `libffi-dev` and `libssl-dev`.
-
-Configuration
--------------
-
-Available options:
+Support dropped after version 3.1.3 of MapProxy.
 
-``nodes``:
-    A list of riak nodes. Each node needs a ``host`` and optionally a ``pb_port`` and an ``http_port`` if the ports differ from the default. Defaults to single localhost node.
-
-``protocol``:
-    Communication protocol. Allowed options is ``http``, ``https`` and ``pbc``. Defaults to ``pbc``.
-
-``bucket``:
-    The name of the bucket MapProxy uses for this cache. The bucket is the namespace for the tiles and must be unique for each cache. Defaults to cache name suffixed with grid name (e.g. ``mycache_webmercator``).
-
-``default_ports``:
-    Default ``pb`` and ``http`` ports for ``pbc`` and ``http`` protocols. Will be used as the default for each defined node.
-
-``secondary_index``:
-    If ``true`` enables secondary index for tiles. This improves seed cleanup performance but requires that Riak uses LevelDB as the backend. Refer to the Riak documentation. Defaults to ``false``.
-
-Example
--------
-
-.. code-block:: yaml
-
-  myriakcache:
-    sources: [mywms]
-    grids: [mygrid]
-    cache:
-      type: riak
-      nodes:
-        - host: 1.example.org
-          pb_port: 9999
-        - host: 1.example.org
-        - host: 1.example.org
-      protocol: pbc
-      bucket: myriakcachetiles
-      default_ports:
-        pb: 8087
-        http: 8098
 
 .. _cache_redis:
 

{MapProxy-3.1.3 → mapproxy-4.0.0}/doc/deployment.rst

@@ -285,11 +285,11 @@ MultiMapProxy
 
 .. versionadded:: 1.2.0
 
-You can run multiple MapProxy instances (configurations) within one process with the MultiMapProxy application.
+You can run multiple MapProxy apps (configurations) within one process with MultiMapProxy.
 
 MultiMapProxy can dynamically load configurations. You can put all configurations into one directory and MapProxy maps each file to a URL: ``conf/proj1.yaml`` is available at ``http://hostname/proj1/``.
 
-Each configuration will be loaded on demand and MapProxy caches each loaded instance. The configuration will be reloaded if the file changes.
+Each configuration will be loaded on demand and MapProxy caches each loaded app. The configuration will be reloaded if the file changes.
 
 MultiMapProxy as the following options:
 
@@ -308,5 +308,5 @@ There is a ``make_wsgi_app`` function in the ``mapproxy.multiapp`` package that
 .. code-block:: python
 
   from mapproxy.multiapp import make_wsgi_app
-  application = make_wsgi_app('/path/to.projects', allow_listing=True)
+  application = make_wsgi_app('/path/to.configs', allow_listing=True)
 

{MapProxy-3.1.3 → mapproxy-4.0.0}/doc/install.rst

@@ -5,7 +5,7 @@ This tutorial guides you to the MapProxy installation process on Unix systems. F
 
 This tutorial was created and tested with Debian and Ubuntu, if you're installing MapProxy on a different system you might need to change some package names.
 
-MapProxy is `registered at the Python Package Index <https://pypi.org/project/MapProxy/>`_ (PyPI). If you have Python 3.8 or higher, you can install MapProxy with::
+MapProxy is `registered at the Python Package Index <https://pypi.org/project/MapProxy/>`_ (PyPI). If you have Python 3.9 or higher, you can install MapProxy with::
 
   python -m pip install MapProxy
 
@@ -39,7 +39,7 @@ This will change the ``PATH`` for your `current` session.
 Install Dependencies
 --------------------
 
-MapProxy is written in Python, thus you will need a working Python installation. MapProxy works with Python 3.8 or higher, which should already be installed with most Linux distributions.
+MapProxy is written in Python, thus you will need a working Python installation. MapProxy works with Python 3.9 or higher, which should already be installed with most Linux distributions.
 
 MapProxy requires a few third-party libraries that are required to run. There are different ways to install each dependency. Read :ref:`dependency_details` for a list of all required and optional dependencies.
 

mapproxy-4.0.0/doc/install_docker.rst

@@ -0,0 +1,110 @@
+Installation via Docker
+========================
+
+MapProxy has its own official docker images.
+These are currently hosted on the GitHub container registry and can be found here:
+
+  -  https://github.com/mapproxy/mapproxy/pkgs/container/mapproxy%2Fmapproxy
+
+Currently we have 6 different images for every release, named e.g.
+
+  - ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0
+  - ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-alpine
+
+  - ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-dev
+  - ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-alpine-dev
+
+  - ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-nginx
+  - ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-alpine-nginx
+
+The alpine variants use alpine base images and are functionally the same as the other images.
+
+The first ones comes with everything installed, but no HTTP WebServer running. These can be used for seeding tasks or as
+base images for implementing custom setups. As they have no WebServer running they are not used normally.
+
+The images ending with ``-dev``, start the integrated webserver mapproxy provides through
+``mapproxy-util serve-develop``. These should not be used in a production environment!
+
+The images ending with ``-nginx``, come bundled with a preconfigured `nginx`_ HTTP Server, that lets you use MapProxy
+instantly in a production environment.
+
+See the quickstart section below for a configuration / example on how to use those images.
+
+There are also several unofficial Docker images available on `Docker Hub`_ that provide ready-to-use containers for
+MapProxy.
+
+.. _`Docker Hub`: https://hub.docker.com/search?q=mapproxy
+
+The community has very good experiences with the following ones:
+
+- https://hub.docker.com/repository/docker/justb4/mapproxy/general (`github just4b <https://github.com/justb4/docker-mapproxy>`_)
+- https://hub.docker.com/r/kartoza/mapproxy (`github kartoza <https://github.com/kartoza/docker-mapproxy>`_)
+
+There are also images available that already include binaries for `MapServer` or `Mapnik`:
+
+- https://github.com/justb4/docker-mapproxy-mapserver
+- https://github.com/justb4/docker-mapproxy-mapserver-mapnik
+
+
+Quickstart
+----------
+
+The mapproxy repository includes an `example docker compose file <https://github.com/mapproxy/mapproxy/blob/master/docker-compose.yaml>`_
+ that you can use to run one of the images or as a reference for the most commonly used options.
+
+Create a directory (e.g. `mapproxyconfig`) for your configuration files. Put your configs into that folder.
+If you do not supply a mapproxy config file the image will create a default seed.yaml and mapproxy.yaml for you.
+
+Then pull the image that you want to use, for example:
+
+.. code-block:: sh
+
+  docker pull ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-nginx
+
+And then run the image like this:
+
+.. code-block:: sh
+
+  docker run --rm --name "mapproxy" -p 80:80 -v `pwd`/mapproxyconfig/mapproxy.yaml:/mapproxy/config/mapproxy.yaml ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-nginx
+
+Afterwards, the `MapProxy` instance is running on http://localhost/mapproxy/demo/
+
+
+Configuration
+-------------
+
+
+Volume-Mounts
+~~~~~~~~~~~~~
+
+- ``/mapproxy/config/mapproxy.yaml``: MapProxy Config
+- ``/mapproxy/config/logging.ini``: Logging-Configuration
+- ``/mapproxy/config/cache_data``: Cache Data dir. Make sure that this directory is writable for the mapproxy image.
+    This can be achieved with `chmod -R a+r cache_data`
+
+
+Environment Variables
+~~~~~~~~~~~~~~~~~~~~~
+
+- ``MULTIAPP_MAPPROXY``: **This can only be used in nginx images.** If set to ``true``, MapProxy will start in multi app
+    mode and will run all configurations in the ``/mapproxy/config/apps`` directory as different apps. Default
+    is ``false``.
+- ``MULTIAPP_ALLOW_LISTINGS``: In multi app mode if set to ``true``, MapProxy lists all available apps on the root page.
+    Default is ``false``.
+
+
+Build your own image
+--------------------
+
+There exist 2 docker files in this repository. One for the debian based images (`Dockerfile`) and one for the alpine
+based images (`Dockerfile-alpine`). Both are multistage and have different targets:
+
+- `base` for the plain image that does not start a webserver
+- `development` for the development image that starts the dev server
+- `nginx` for the nginx image that uses nginx to run mapproxy
+
+So if you want to build the alpine nginx image, the command would look like this:
+
+.. code-block:: sh
+
+  docker build -f Dockerfile-alpine --target nginx -t ghcr.io/mapproxy/mapproxy/mapproxy:latest-alpine-nginx .

{MapProxy-3.1.3 → mapproxy-4.0.0}/doc/install_windows.rst

@@ -1,7 +1,7 @@
 Installation on Windows
 =======================
 
-At first you need a working Python installation. You can download Python from: https://www.python.org/download/. MapProxy requires Python 3.8 or higher.
+At first you need a working Python installation. You can download Python from: https://www.python.org/download/. MapProxy requires Python 3.9 or higher.
 
 Virtualenv
 ----------
@@ -88,7 +88,7 @@ Platform dependent packages
 
 ``pip`` downloads all packages from https://pypi.org/, but not all platform combinations might be available as a binary package, especially if you run a 64bit version of Python.
 
-If you run into trouble during installation, because it is trying to compile something (e.g. complaining about ``vcvarsall.bat``), you should look at Christoph Gohlke's `Unofficial Windows Binaries for Python Extension Packages <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_. This is a reliable site for binary packages for Python. You need to download the right package: The ``cpxx`` code refers to the Python version (e.g. ``cp38`` for Python 3.8); ``win32`` for 32bit Python installations and ``amd64`` for 64bit.
+If you run into trouble during installation, because it is trying to compile something (e.g. complaining about ``vcvarsall.bat``), you should look at Christoph Gohlke's `Unofficial Windows Binaries for Python Extension Packages <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_. This is a reliable site for binary packages for Python. You need to download the right package: The ``cpxx`` code refers to the Python version (e.g. ``cp39`` for Python 3.9); ``win32`` for 32bit Python installations and ``amd64`` for 64bit.
 
 You can install the ``.whl``, ``.zip`` or ``.exe`` packages with ``pip``::