is one of\"\n\t@echo \" html to make standalone HTML files\"\n\t@echo \" dirhtml to make HTML files named index.html in directories\"\n\t@echo \" singlehtml to make a single large HTML file\"\n\t@echo \" pickle to make pickle files\"\n\t@echo \" json to make JSON files\"\n\t@echo \" htmlhelp to make HTML files and a HTML help project\"\n\t@echo \" qthelp to make HTML files and a qthelp project\"\n\t@echo \" devhelp to make HTML files and a Devhelp project\"\n\t@echo \" epub to make an epub\"\n\t@echo \" latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter\"\n\t@echo \" latexpdf to make LaTeX files and run them through pdflatex\"\n\t@echo \" text to make text files\"\n\t@echo \" man to make manual pages\"\n\t@echo \" texinfo to make Texinfo files\"\n\t@echo \" info to make Texinfo files and run them through makeinfo\"\n\t@echo \" gettext to make PO message catalogs\"\n\t@echo \" changes to make an overview of all changed/added/deprecated items\"\n\t@echo \" linkcheck to check all external links for integrity\"\n\t@echo \" doctest to run all doctests embedded in the documentation (if enabled)\"\n\nclean:\n\t-rm -rf $(BUILDDIR)/*\n\nhtml:\n\tmkdir -p $(BUILDDIR)\n\t$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html\n\t@echo\n\t@echo \"Build finished. The HTML pages are in $(BUILDDIR)/html.\"\n\ndirhtml:\n\t$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml\n\t@echo\n\t@echo \"Build finished. The HTML pages are in $(BUILDDIR)/dirhtml.\"\n\nsinglehtml:\n\t$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml\n\t@echo\n\t@echo \"Build finished. The HTML page is in $(BUILDDIR)/singlehtml.\"\n\npickle:\n\t$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle\n\t@echo\n\t@echo \"Build finished; now you can process the pickle files.\"\n\njson:\n\t$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json\n\t@echo\n\t@echo \"Build finished; now you can process the JSON files.\"\n\nhtmlhelp:\n\t$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp\n\t@echo\n\t@echo \"Build finished; now you can run HTML Help Workshop with the\" \\\n\t \".hhp project file in $(BUILDDIR)/htmlhelp.\"\n\nqthelp:\n\t$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp\n\t@echo\n\t@echo \"Build finished; now you can run \"qcollectiongenerator\" with the\" \\\n\t \".qhcp project file in $(BUILDDIR)/qthelp, like this:\"\n\t@echo \"# qcollectiongenerator $(BUILDDIR)/qthelp/pycsw.qhcp\"\n\t@echo \"To view the help file:\"\n\t@echo \"# assistant -collectionFile $(BUILDDIR)/qthelp/pycsw.qhc\"\n\ndevhelp:\n\t$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp\n\t@echo\n\t@echo \"Build finished.\"\n\t@echo \"To view the help file:\"\n\t@echo \"# mkdir -p $$HOME/.local/share/devhelp/pycsw\"\n\t@echo \"# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/pycsw\"\n\t@echo \"# devhelp\"\n\nepub:\n\t$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub\n\t@echo\n\t@echo \"Build finished. The epub file is in $(BUILDDIR)/epub.\"\n\nlatex:\n\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex\n\t@echo\n\t@echo \"Build finished; the LaTeX files are in $(BUILDDIR)/latex.\"\n\t@echo \"Run \\`make' in that directory to run these through (pdf)latex\" \\\n\t \"(use \\`make latexpdf' here to do that automatically).\"\n\nlatexpdf:\n\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex\n\t@echo \"Running LaTeX files through pdflatex...\"\n\t$(MAKE) -C $(BUILDDIR)/latex all-pdf\n\t@echo \"pdflatex finished; the PDF files are in $(BUILDDIR)/latex.\"\n\ntext:\n\t$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text\n\t@echo\n\t@echo \"Build finished. The text files are in $(BUILDDIR)/text.\"\n\nman:\n\t$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man\n\t@echo\n\t@echo \"Build finished. The manual pages are in $(BUILDDIR)/man.\"\n\ntexinfo:\n\t$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo\n\t@echo\n\t@echo \"Build finished. The Texinfo files are in $(BUILDDIR)/texinfo.\"\n\t@echo \"Run \\`make' in that directory to run these through makeinfo\" \\\n\t \"(use \\`make info' here to do that automatically).\"\n\ninfo:\n\t$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo\n\t@echo \"Running Texinfo files through makeinfo...\"\n\tmake -C $(BUILDDIR)/texinfo info\n\t@echo \"makeinfo finished; the Info files are in $(BUILDDIR)/texinfo.\"\n\ngettext:\n\t$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale\n\t@echo\n\t@echo \"Build finished. The message catalogs are in $(BUILDDIR)/locale.\"\n\nchanges:\n\t$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes\n\t@echo\n\t@echo \"The overview file is in $(BUILDDIR)/changes.\"\n\nlinkcheck:\n\t$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck\n\t@echo\n\t@echo \"Link check complete; look for any errors in the above output \" \\\n\t \"or in $(BUILDDIR)/linkcheck/output.txt.\"\n\ndoctest:\n\t$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest\n\t@echo \"Testing of doctests in the sources finished, look at the \" \\\n\t \"results in $(BUILDDIR)/doctest/output.txt.\"\n"
},
{
"path": "docs/_static/favicon/browserconfig.xml",
"content": "\n\n \n \n \n #2d89ef\n \n \n\n"
},
{
"path": "docs/_templates/indexsidebar.html",
"content": "\n ![\"pycsw\"](\"https://raw.githubusercontent.com/geopython/pycsw/master/docs/_static/logo/logo-horizontal.png\")
\n
\n\n pycsw is Certified OGC Compliant and is an OGC Reference Implementation
\n \n ![\"DOI\"](\"https://zenodo.org/badge/2367090.svg\")
\n
\n \n ![\"This](\"https://portal.ogc.org/public_ogc/compliance/OGC_Certified_Badge.png\")
\n
\n \n ![\"This](\"https://portal.ogc.org/public_ogc/compliance/badge.php?s=CAT%203.0&r=1&n=1\")
\n
\n \n ![\"This](\"https://portal.ogc.org/public_ogc/compliance/badge.php?s=CAT%202.0.2&r=1&n=1\")
\n
\n \n ![\"This](\"https://portal.ogc.org/public_ogc/compliance/badge.php?s=georss%201.0&r=1&n=1\")
\n
\n\n ![\"OSGeo](\"https://raw.githubusercontent.com/OSGeo/osgeo/master/incubation/project/OSGeo_project.png\")
\n
\n\n\n \n
\n"
},
{
"path": "docs/_templates/layout.html",
"content": "{% extends \"!layout.html\" %}\n\n{%- block extrahead %}\n{{ super() }}\n\n\n\n{% endblock %}\n\n{% block relbar1 %}\n\n\n\n{{ super() }}\n{% endblock %}\n\n{% block footer %}\n\n\n{% endblock %}\n"
},
{
"path": "docs/administration.rst",
"content": ".. _administration:\n\nAdministration\n==============\n\npycsw administration is handled by the ``pycsw-admin.py`` utility. ``pycsw-admin.py``\nis installed as part of the pycsw install process and should be available in your\nPATH.\n\n.. note::\n Run ``pycsw-admin.py --help`` to see all administration operations and parameters\n\nMetadata Repository Setup\n-------------------------\n\npycsw supports the following databases:\n\n- SQLite3\n- PostgreSQL (without PostGIS)\n- PostgreSQL with PostGIS enabled\n- MySQL\n\n.. note::\n The easiest and fastest way to deploy pycsw is to use SQLite3 as the backend. To use an SQLite\n in-memory database, in the pycsw configuration, set `repository.database` to ``sqlite://``.\n\n.. note::\n PostgreSQL support includes support for PostGIS functions if enabled\n\n.. note::\n If PostGIS is activated before setting up the pycsw/PostgreSQL database, then native PostGIS geometries will be enabled.\n\nTo expose your geospatial metadata via pycsw, perform the following actions:\n\n- setup the database\n- import metadata\n- publish the repository\n\nSupported Information Models\n----------------------------\n\nBy default, pycsw's API supports the core OGC API - Records and CSW Record information models. From\nthe database perspective, the pycsw metadata model is loosely based on ISO 19115 and is\nable to transform to other formats as part of transformation during OGC API - Records/CSW requests.\n\n.. note::\n See :ref:`profiles` for information on enabling profiles\n\n.. note::\n See :ref:`metadata-model-reference` for detailed information on pycsw's internal metadata model\n\nSetting up the Database\n-----------------------\n\n.. code-block:: bash\n\n pycsw-admin.py setup-repository --config default.yml\n\nThis will create the necessary tables and values for the repository.\n\nThe database created is an `OGC SFSQL`_ compliant database, and can be used with any implementing software. For example, to use with `GDAL`_:\n\n.. code-block:: bash\n\n ogrinfo /path/to/records.db\n INFO: Open of 'records.db'\n using driver 'SQLite' successful.\n 1: records (Polygon)\n ogrinfo -al /path/to/records.db\n # lots of output\n\n.. note::\n If PostGIS is detected, the ``pycsw-admin.py`` script does not create the SFSQL tables as they are already in the database.\n\n\nLoading Records\n----------------\n\n.. code-block:: bash\n\n pycsw-admin.py load-records --config default.yml --path /path/to/records\n\nThis will import all ``*.xml`` records from ``/path/to/records`` into the database specified in ``default.yml`` (``repository.database``). Passing ``-r`` to the script will process ``/path/to/records`` recursively. Passing ``-y`` to the script will force overwrite existing metadata with the same identifier. Note that ``-p`` accepts either a directory path or single file.\n\n.. note::\n Records can also be imported using CSW-T (see :ref:`transactions`).\n\nExporting the Repository\n------------------------\n\n.. code-block:: bash\n\n pycsw-admin.py export-records --config default.yml --path /path/to/output_dir\n\nThis will write each record in the database specified in ``default.yml`` (``repository.database``) to an XML document on disk, in directory ``/path/to/output_dir``.\n\nOptimizing the Database\n-----------------------\n\n.. code-block:: bash\n\n pycsw-admin.py optimize-db --config default.yml\n pycsw-admin.py rebuild-db-indexes --config default.yml\n\n.. note::\n This feature is relevant only for PostgreSQL and MySQL\n\nDeleting Records from the Repository\n------------------------------------\n\n.. code-block:: bash\n\n pycsw-admin.py delete-records --config default.yml\n\nThis will empty the repository of all records.\n\nDatabase Specific Notes\n-----------------------\n\nPostgreSQL\n^^^^^^^^^^\n\n- To enable PostgreSQL support, the database user must be able to create functions within the database.\n- `PostgreSQL Full Text Search`_ is supported for ``csw:AnyText`` based queries. pycsw creates a tsvector column based on the text from anytext column. Then pycsw creates a GIN index against the anytext_tsvector column. This is created automatically in ``pycsw.core.repository.setup``. Any query against the OGC API - Records ``q`` parameter or CSW `csw:AnyText` or `apiso:AnyText` will process using PostgreSQL FTS handling\n\nPostGIS\n^^^^^^^\n\n- pycsw makes use of PostGIS spatial functions and native geometry data type.\n- It is advised to install the PostGIS extension before setting up the pycsw database\n- If PostGIS is detected, the ``pycsw-admin.py`` script will create both a native geometry column and a WKT column, as well as a trigger to keep both synchronized\n- In case PostGIS gets disabled, pycsw will continue to work with the `WKT`_ column\n- In case of migration from plain PostgreSQL database to PostGIS, the spatial functions of PostGIS will be used automatically\n- When migrating from plain PostgreSQL database to PostGIS, in order to enable native geometry support, a \"GEOMETRY\" column named \"wkb_geometry\" needs to be created manually (along with the update trigger in ``pycsw.core.repository.setup``). Also the native geometries must be filled manually from the `WKT`_ field. Next versions of pycsw will automate this process\n\n.. _custom_repository:\n\nMapping to an Existing Repository\n---------------------------------\n\npycsw supports publishing metadata from an existing repository. To enable this functionality, the default database\nmappings must be modified to represent the existing database columns mapping to the abstract core model (the default\nmappings are in ``pycsw/core/config.py:StaticContext.md_core_model``).\n\nTo override the default settings:\n\n- define a custom database mapping based on ``etc/mappings.py``\n- in ``default.yml``, set ``repository.mappings`` to the location of the mappings.py file:\n\n.. code-block:: yaml\n\n repository:\n ...\n mappings: path/to/mappings.py\n\nNote you can also reference mappings as a Python object as a dotted path:\n\n.. code-block:: yaml\n\n repository:\n ...\n mappings: path.to.pycsw_mappings\n\n\nSee the :ref:`geonode`, :ref:`hhypermap`, and :ref:`odc` for further examples.\n\n.. _existing-repository-requirements:\n\nExisting Repository Requirements\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\npycsw requires certain repository attributes and semantics to exist in any repository to operate as follows:\n\n- ``pycsw:Identifier``: unique identifier\n- ``pycsw:Typename``: typename for the metadata; typically the value of the root element tag (e.g. ``csw:Record``, ``gmd:MD_Metadata``)\n- ``pycsw:Schema``: schema for the metadata; typically the target namespace (e.g. ``http://www.opengis.net/cat/csw/2.0.2``, ``http://www.isotc211.org/2005/gmd``)\n- ``pycsw:InsertDate``: date of insertion\n- ``pycsw:XML``: full XML representation (deprecated; will be removed in a future release)\n- ``pycsw:Metadata``: full metadata representation\n- ``pycsw:MetadataType``: media type of metadata representation\n- ``pycsw:AnyText``: bag of XML element text values, used for full text search. Realized with the following design pattern:\n\n - capture all XML element and attribute values\n - store in repository\n- ``pycsw:BoundingBox``: string of `WKT`_ or `EWKT`_ geometry\n\nThe following repository semantics exist if the attributes are specified:\n\n- ``pycsw:Keywords``: comma delimited list of keywords\n- ``pycsw:Themes``: Text field of JSON list of objects with properties ``concepts``, ``scheme``\n\n.. code-block:: json\n\n [\n {\n \"concepts\": [\n {\n \"id\": \"atmosphericComposition\"\n },\n {\n \"id\": \"pollution\"\n },\n {\n \"id\": \"observationPlatform\"\n },\n {\n \"id\": \"rocketSounding\"\n }\n ],\n \"scheme\": \"https://wis.wmo.int/2012/codelists/WMOCodeLists.xml#WMO_CategoryCode\"\n }\n ]\n\n- ``pycsw:Contacts``: Text field of JSON list of objects with properties as per the OGC API - Records party definition\n\n.. code-block:: json\n\n [\n {\n \"name\": \"contact\",\n \"individual\": \"Lastname, Firstname\",\n \"positionName\": \"Position Title\",\n \"contactInfo\": {\n \"phone\": {\n \"office\": \"+xx-xxx-xxx-xxxx\"\n },\n \"email\": {\n \"office\": \"you@example.org\"\n },\n \"address\": {\n \"office\": {\n \"deliveryPoint\": \"Mailing Address\",\n \"city\": \"City\",\n \"administrativeArea\": \"Administrative Area\",\n \"postalCode\": \"Zip or Postal Code\",\n \"country\": \"COuntry\"\n },\n \"onlineResource\": {\n \"href\": \"Contact URL\"\n }\n },\n \"hoursOfService\": \"Hours of Service\",\n \"contactInstructions\": \"During hours of service. Off on weekends\",\n \"url\": {\n \"rel\": \"canonical\",\n \"type\": \"text/html\",\n \"href\": \"https://example.org\"\n }\n },\n \"roles\": [\n {\n \"name\": \"pointOfContact\"\n }\n ]\n }\n ]\n\n- ``pycsw:Links``: Text field of JSON list of objects with properties ``name``, ``description``, ``protocol``, ``url``\n\n.. code-block:: json\n\n [\n {\n \"name\": \"foo\",\n \"description\": \"bar\",\n \"protocol\": \"OGC:WMS\",\n \"url\": \"https://example.org/wms\"\n }\n ]\n\n.. note::\n The ``pycsw:Links`` field should be a text type, not a JSON object type\n\n- ``pycsw:Bands``: Text field of JSON list of dicts with properties: ``name``, ``units``, ``min``, ``max``\n\n.. code-block:: json\n\n [\n {\n \"name\": \"B1\",\n \"units\": \"nm\",\n \"min\": 0.1,\n \"max\": 0.333\n }\n ]\n\n.. note::\n The ``pycsw:Bands`` field should be a text type, not a JSON object type\n\nValues of mappings can be derived from the following mechanisms:\n\n- text fields\n- Python datetime.datetime or datetime.date objects\n- Python functions \n\nFurther information is provided in ``pycsw/config.py:MD_CORE_MODEL``.\n\n\n.. note::\n See :ref:`metadata-model-reference` for detailed information on pycsw's internal metadata model\n\nUsing a SQL View as the repository table\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nIf your pre-existing database stores information in a normalized fashion, *i.e.* distributed on multiple tables rather\nthan on a single table (which is what pycsw expects by default), you have the option to create a DB view and use that\nas pycsw's repository.\n\nAs a practical example, lets say you have a `CKAN`_ project which you would like to also provide pycsw integration with.\nCKAN stores dataset-related information over multiple tables:\n\n- ``package`` - has base metadata fields for each dataset;\n- ``package_extra`` - additional custom metadata fields, depending on the user's metadata schema;\n- ``package_tag`` - dataset_related keywords;\n- ``tag`` - dataset_related keywords;\n- ``group`` - details about a dataset's owner organization;\n- etc.\n\nOne way to adapt such a DB structure to be able to integrate with pycsw is to create a `PostgreSQL Materialized View`_.\nFor example:\n\n.. code-block:: SQL\n\n CREATE MATERIALIZED VIEW IF NOT EXISTS my_pycsw_view AS\n WITH cte_extras AS (\n SELECT\n p.id,\n p.title,\n g.title AS org_name,\n json_object_agg(pe.key, pe.value) AS extras,\n array_agg(DISTINCT t.name) AS tags\n -- remaining columns omitted for brevity\n FROM package AS p\n JOIN package_extra AS pe ON p.id = pe.package_id\n JOIN \"group\" AS g ON p.owner_org = g.id\n JOIN package_tag AS pt ON p.id = pt.package_id\n JOIN tag AS t on pt.tag_id = t.id\n WHERE p.state = 'active'\n AND p.private = false\n GROUP BY p.id, g.title\n )\n SELECT\n c.id AS identifier,\n c.title AS title,\n c.org_name AS organization,\n ST_GeomFromGeoJSON(c.extras->>'spatial')::geometry(Polygon, 4326) AS geom,\n c.extras->>'reference_date' AS date,\n concat_ws(', ', VARIADIC c.tags) AS keywords\n -- remaining columns omitted for brevity\n FROM cte_extras AS c\n WITH DATA;\n\nCreating this SQL view in the database means that all we now have the CKAN dataset information all on a single flat\ntable, ready for pycsw to integrate with.\n\nA crucial setup that is required in order for SQL Views to be usable by pycsw is to include the additional\n``column_constraints`` property in your custom mappings. This property is used to specify which column(s) should\nfunction as the primary key of the SQL View:\n\n.. code-block:: python\n\n # contents of my_custom_pycsw_mappings.py\n from sqlalchemy.schema import PrimaryKeyConstraint\n\n MD_CORE_MODEL = {\n \"column_constraints\": (PrimaryKeyConstraint(\"identifier\"),),\n \"typename\": \"pycsw:CoreMetadata\",\n \"outputschema\": \"http://pycsw.org/metadata\",\n \"mappings\": {\n \"pycsw:Identifier\": \"identifier\",\n # remaining mappings omitted for brevity\n\nThe above code snippet demonstrates how you could instruct sqlalchemy, which is what pycsw uses to interface with\nthe DB, that the ``identifier`` column of the SQL view should be assumed to be the primary key of the table.\n\nFinally, we can configure pycsw with the path to the custom mappings and the name of the SQL view:\n\n.. code-block:: yaml\n\n # file: pycsw.yml\n\n repository:\n database: postgresql://${DB_USERNAME}:${DB_PASSWORD}@${DB_HOST}/${DB_NAME}\n mappings: /path/to/my_custom_pycsw_mappings.py\n table: my_pycsw_view\n\n\n.. _`GDAL`: https://www.gdal.org\n.. _`OGC SFSQL`: https://www.ogc.org/standards/sfs\n.. _`WKT`: https://en.wikipedia.org/wiki/Well-known_text\n.. _`EWKT`: https://en.wikipedia.org/wiki/Well-known_text#Variations\n.. _`PostgreSQL Full Text Search`: https://www.postgresql.org/docs/current/textsearch.html\n.. _`CKAN`: https://ckan.org/\n.. _`PostgreSQL Materialized View`: https://www.postgresql.org/docs/current/sql-creatematerializedview.html\n"
},
{
"path": "docs/api.rst",
"content": ".. _api:\n\nAPI\n===\n\nPython applications can integrate pycsw into their custom workflows. This\nallows for seamless integate within frameworks such as Flask and Django.\n\nBelow are examples of where using the API (as opposed to the default WSGI/CGI\nservices could be used:\n\n- configuration based on a Python dict, or stored in a database\n- downstream request environment / framework (Flask, Django)\n- authentication or authorization logic\n- forcing CSW version 2.0.2 as default\n\nOGC API - Records Flask Example\n-------------------------------\n\nSee https://github.com/geopython/pycsw/blob/master/pycsw/wsgi_flask.py for how\nto implement a Flask wrapper atop all pycsw supported APIs. Note the use of\nFlask blueprints to enable integration with downstream Flask applications.\n\nSimple Flask blueprint example\n------------------------------\n\n.. code-block:: python\n\n from flask import Flask, redirect\n\n from pycsw.wsgi_flask import BLUEPRINT as pycsw_blueprint\n\n app = Flask(__name__, static_url_path='/static')\n\n app.url_map.strict_slashes = False\n app.register_blueprint(pycsw_blueprint, url_prefix='/oapi')\n\n @app.route('/')\n def hello_world():\n return \"Hello, World!\"\n\n\nIn the above example, all pycsw endpoints are made available under ``http://localhost:8000/oapi``.\n\nSimple CSW Flask Example\n------------------------\n\n.. code-block:: python\n\n import logging\n\n from flask import Flask, request\n\n from pycsw import __version__ as pycsw_version\n from pycsw.server import Csw\n\n LOGGER = logging.getLogger(__name__)\n APP = Flask(__name__)\n \n @APP.route('/csw')\n def csw_wrapper():\n \"\"\"CSW wrapper\"\"\"\n\n LOGGER.info('Running pycsw %s', pycsw_version)\n\n pycsw_config = some_dict # really comes from somewhere\n\n # initialize pycsw\n # pycsw_config: dict of the pycsw configuration\n #\n # env: dict of (HTTP) environment (defaults to os.environ)\n # \n # version: defaults to '3.0.0'\n my_csw = Csw(pycsw_config, request.environ, version='2.0.2')\n\n # dispatch the request\n http_status_code, response = my_csw.dispatch_wsgi()\n\n return response, http_status_code, {'Content-type': csw.contenttype}\n"
},
{
"path": "docs/ckan.rst",
"content": ".. _ckan:\n\nCKAN Configuration\n==================\n\nCKAN (https://ckan.org) is a powerful data management system that makes data accessible – by providing tools to streamline publishing, sharing, finding and using data. CKAN is aimed at data publishers (national and regional governments, companies and organizations) wanting to make their data open and available.\n\n`ckanext-spatial`_ is CKAN's geospatial extension. The extension adds a spatial field to the default CKAN dataset schema, using PostGIS as the backend. This allows to perform spatial queries and display the dataset extent on the frontend. It also provides harvesters to import geospatial metadata into CKAN from other sources, as well as commands to support the CSW standard. Finally, it also includes plugins to preview spatial formats such as GeoJSON.\n\nCKAN Setup\n----------\n\nInstallation and configuration Instructions are provided as part of the ckanext-spatial `documentation`_.\n\n.. _`ckanext-spatial`: https://github.com/ckan/ckanext-spatial\n.. _`documentation`: https://docs.ckan.org/projects/ckanext-spatial/en/latest/csw.html\n"
},
{
"path": "docs/committers.rst",
"content": ".. _committers:\n\nCommitters\n==========\n\n.. include:: ../COMMITTERS.txt\n"
},
{
"path": "docs/conf.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2026 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n#\n# pycsw documentation build configuration file, created by\n# sphinx-quickstart on Fri Aug 2 19:48:50 2013.\n#\n# This file is execfile()d with the current directory set to its containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\n\nimport sys\nfrom unittest.mock import MagicMock\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#sys.path.insert(0, os.path.abspath('.'))\n\n# -- General configuration -----------------------------------------------------\n\n# locale \nlocale_dirs = ['locale/']\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be extensions\n# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.\nextensions = []\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = ['_templates']\n\n# The suffix of source filenames.\nsource_suffix = {'.rst': 'restructuredtext'}\n\nlocale_dirs = ['locale/'] # path is example but recommended.\n\n# The encoding of source files.\n#source_encoding = 'utf-8-sig'\n\n# The master toctree document.\nmaster_doc = 'index'\n\n# General information about the project.\nproject = u'pycsw'\nauthors = u'Tom Kralidis'\nlicense = u'This work is licensed under a Creative Commons Attribution 4.0 International License'\ncopyright = u'2010-2026, ' + authors + ' ' + license\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The short X.Y version.\nversion = '3.0-dev'\n# The full version, including alpha/beta/rc tags.\nrelease = version\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#language = None\n\n# There are two options for replacing |today|: either, you set today to some\n# non-false value, then it is used:\n#today = ''\n# Else, today_fmt is used as the format for a strftime call.\ntoday_fmt = '%Y-%m-%d'\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\nexclude_patterns = ['_build']\n\n# The reST default role (used for this markup: `text`) to use for all documents.\n#default_role = None\n\n# If true, '()' will be appended to :func: etc. cross-reference text.\n#add_function_parentheses = True\n\n# If true, the current module name will be prepended to all description\n# unit titles (such as .. function::).\n#add_module_names = True\n\n# If true, sectionauthor and moduleauthor directives will be shown in the\n# output. They are ignored by default.\nshow_authors = True\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = 'sphinx'\n\n# A list of ignored prefixes for module index sorting.\n#modindex_common_prefix = []\n\n\n# -- Options for HTML output ---------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages. See the documentation for\n# a list of builtin themes.\nhtml_theme = 'classic'\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further. For a list of options available for each theme, see the\n# documentation.\nhtml_theme_options = {\n 'sidebarbgcolor': '#356aa0',\n 'sidebarlinkcolor': '#ffffff',\n 'relbarlinkcolor': '#ffffff',\n 'footerbgcolor': '#356aa0'\n}\n\n# Add any paths that contain custom themes here, relative to this directory.\n#html_theme_path = []\n\n# The name for this set of Sphinx documents. If None, it defaults to\n# \" v documentation\".\n#html_title = 'Documentation'\n\n# A shorter title for the navigation bar. Default is the same as html_title.\n#html_short_title = None\n\n# The name of an image file (relative to this directory) to place at the top\n# of the sidebar.\n#html_logo = None\n\n# The name of an image file (within the static path) to use as favicon of the\n# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32\n# pixels large.\nhtml_favicon = '_static/favicon/favicon.ico'\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = ['_static']\n\n# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,\n# using the given strftime format.\nhtml_last_updated_fmt = '%Y-%m-%dT%H:%M:%SZ'\n\n# If true, SmartyPants will be used to convert quotes and dashes to\n# typographically correct entities.\n#html_use_smartypants = True\n\n# Custom sidebar templates, maps document names to template names.\nhtml_sidebars = {\n #'index':'indexsidebar.html',\n '**': ['indexsidebar.html']\n}\n\n# Additional templates that should be rendered to pages, maps page names to\n# template names.\n#html_additional_pages = {}\n\n# If false, no module index is generated.\n#html_domain_indices = True\n\n# If false, no index is generated.\nhtml_use_index = False\n\n# If true, the index is split into individual pages for each letter.\n#html_split_index = False\n\n# If true, links to the reST sources are added to the pages.\n#html_show_sourcelink = True\n\n# If true, \"Created using Sphinx\" is shown in the HTML footer. Default is True.\n#html_show_sphinx = True\n\n# If true, \"(C) Copyright ...\" is shown in the HTML footer. Default is True.\n#html_show_copyright = True\n\n# If true, an OpenSearch description file will be output, and all pages will\n# contain a tag referring to it. The value of this option must be the\n# base URL from which the finished HTML is served.\n#html_use_opensearch = ''\n\n# This is the file name suffix for HTML files (e.g. \".xhtml\").\n#html_file_suffix = None\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = 'pycswdoc'\n\n\n# -- Options for LaTeX output --------------------------------------------------\n\nlatex_elements = {\n# The paper size ('letterpaper' or 'a4paper').\n#'papersize': 'letterpaper',\n\n# The font size ('10pt', '11pt' or '12pt').\n#'pointsize': '10pt',\n\n# Additional stuff for the LaTeX preamble.\n#'preamble': '',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title, author, documentclass [howto/manual]).\nlatex_documents = [\n ('index', 'pycsw.tex', u'pycsw Documentation',\n authors, 'manual'),\n]\n\n# The name of an image file (relative to this directory) to place at the top of\n# the title page.\n#latex_logo = None\n\n# For \"manual\" documents, if this is true, then toplevel headings are parts,\n# not chapters.\n#latex_use_parts = False\n\n# If true, show page references after internal links.\n#latex_show_pagerefs = False\n\n# If true, show URL addresses after external links.\n#latex_show_urls = False\n\n# Documents to append as an appendix to all manuals.\n#latex_appendices = []\n\n# If false, no module index is generated.\n#latex_domain_indices = True\n\n\n# -- Options for manual page output --------------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [\n ('index', 'pycsw', u'pycsw Documentation',\n [authors], 1)\n]\n\n# If true, show URL addresses after external links.\n#man_show_urls = False\n\n\n# -- Options for Texinfo output ------------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n# dir menu entry, description, category)\ntexinfo_documents = [\n ('index', 'pycsw', u'pycsw Documentation',\n authors, 'pycsw', 'One line description of project.',\n 'Miscellaneous'),\n]\n\n# Documents to append as an appendix to all manuals.\n#texinfo_appendices = []\n\n# If false, no module index is generated.\n#texinfo_domain_indices = True\n\n# How to display URL addresses: 'footnote', 'no', or 'inline'.\n#texinfo_show_urls = 'footnote'\n\n\n# -- Options for Epub output ---------------------------------------------------\n\n# Bibliographic Dublin Core info.\nepub_title = u'pycsw'\nepub_author = authors\nepub_publisher = authors\nepub_copyright = copyright\n\n# The language of the text. It defaults to the language option\n# or en if the language is not set.\n#epub_language = ''\n\n# The scheme of the identifier. Typical schemes are ISBN or URL.\n#epub_scheme = ''\n\n# The unique identifier of the text. This can be a ISBN number\n# or the project homepage.\n#epub_identifier = ''\n\n# A unique identification for the text.\n#epub_uid = ''\n\n# A tuple containing the cover image and cover page html template filenames.\n#epub_cover = ()\n\n# HTML files that should be inserted before the pages created by sphinx.\n# The format is a list of tuples containing the path and title.\n#epub_pre_files = []\n\n# HTML files shat should be inserted after the pages created by sphinx.\n# The format is a list of tuples containing the path and title.\n#epub_post_files = []\n\n# A list of files that should not be packed into the epub file.\n#epub_exclude_files = []\n\n# The depth of the table of contents in toc.ncx.\n#epub_tocdepth = 3\n\n# Allow duplicate toc entries.\n#epub_tocdup = True\n\n# mock out imports with C extensions for building on readthedocs.io\n\nclass Mock(MagicMock):\n @classmethod\n def __getattr__(cls, name):\n return MagicMock()\n\nMOCK_MODULES = ['shapely']\nsys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)\n\n"
},
{
"path": "docs/configuration.rst",
"content": ".. _configuration:\n\nConfiguration\n=============\n\npycsw's runtime configuration is defined by ``default.yml``. pycsw ships with a `sample configuration`_ (``default-sample.yml``). Copy the file to ``default.yml`` and edit the following:\n\n**server**\n\n- **home**: the full filesystem path to pycsw\n- **url**: the URL of the resulting service\n- **mimetype**: the MIME type when returning HTTP responses\n- **language**: the ISO 639-1 language and ISO 3166-1 alpha2 country code of the service (e.g. ``en-CA``, ``fr-CA``, ``en-US``)\n- **encoding**: the content type encoding (e.g. ``ISO-8859-1``, see https://docs.python.org/2/library/codecs.html#standard-encodings). Default value is 'UTF-8'\n- **maxrecords**: the maximum number of records to return by default. This value is enforced if a CSW's client's ``maxRecords`` parameter is greater than ``server.maxrecords`` to limit capacity. See :ref:`maxrecords-handling` for more information\n- **level**: the logging level (see https://docs.python.org/library/logging.html#logging-levels)\n- **logfile**: the full file path to the logfile\n- **ogc_schemas_base**: base URL of OGC XML schemas tree file structure (default is http://schemas.opengis.net)\n- **federatedcatalogues**: arrray of distributed catalogue endpoints to be used for distributed searching, if requested by the client (see :ref:`distributedsearching`)\n- **pretty_print**: whether to pretty print the output (``true`` or ``false``). Default is ``false``\n- **gzip_compresslevel**: gzip compression level, lowest is ``1``, highest is ``9``. Default is off. **NOTE**: if gzip compression is already enabled via your web server, do not enable this directive (or else the server will try to compress the response twice, resulting in degraded performance)\n- **domainquerytype**: for GetDomain operations, how to output domain values. Accepted values are ``list`` and ``range`` (min/max). Default is ``list``\n- **domaincounts**: for GetDomain operations, whether to provide frequency counts for values. Accepted values are ``true`` and ``False``. Default is ``false``\n- **smtp_host**: SMTP host for processing ``csw:ResponseHandler`` parameter via outgoing email requests (default is ``localhost``)\n- **smtp_user**: SMTP user name related to the account (default is '')\n- **smtp_pass**: SMTP password related to the account (default is '')\n- **smtp_ssl**: Option to choose between SMTP and SMTP_SSL. To enable it, set the value to ``true`` (default is ``false``)\n- **spatial_ranking**: parameter that enables (``true`` or ``false``) ranking of spatial query results as per `K.J. Lanfear 2006 - A Spatial Overlay Ranking Method for a Geospatial Search of Text Objects `_.\n- **workers**: set the number of workers used by the wsgi server when lunching pycsw using the provided docker/entrypoint.py. If not set, it will use 2 workers as Default.\n\n**profiles**\n\n- list of profiles to load at runtime (default is none). See :ref:`profiles`\n\n**manager**\n\n- **transactions**: whether to enable transactions (``true`` or ``false``). Default is ``false`` (see :ref:`transactions`)\n- **allowed_ips**: comma delimited list of IP addresses (e.g. 192.168.0.103), wildcards (e.g. 192.168.0.*) or CIDR notations (e.g. 192.168.100.0/24) allowed to perform transactions (see :ref:`transactions`)\n- **csw_harvest_pagesize**: when harvesting other CSW servers, the number of records per request to page by (default is 10)\n\n**pubsub**\n\n- **broker**: Publish-Subscribe definition\n\n**pubsub.broker**\n\n- **show_link**: whether to display as a link in the landing page (``true`` or ``false``)\n- **type**: type of broker\n- **url**: endpoint of broker\n\n.. note::\n\n See :ref:`pubsub` for configuring your instance with Pub/Sub capability.\n\n**metadata**\n\n**metadata.identification**\n\n- **title**: the title of the service\n- **description**: some descriptive text about the service\n- **keywords**: list of keywords about the service\n- **keywords_type**: keyword type as per the `ISO 19115 MD_KeywordTypeCode codelist `_). Accepted values are ``discipline``, ``temporal``, ``place``, ``theme``, ``stratum``\n- **fees**: fees associated with the service\n- **accessconstraints**: access constraints associated with the service\n\n**metadata.provider**\n\n- **name**: the name of the service provider\n- **url**: the URL of the service provider\n\n**metadata.contact**\n\n- **name**: the name of the provider contact\n- **position**: the position title of the provider contact\n- **address**: the address of the provider contact\n- **city**: the city of the provider contact\n- **stateorprovince**: the province or territory of the provider contact\n- **postalcode**: the postal code of the provider contact (enclose in quotes)\n- **country**: the country of the provider contact\n- **phone**: the phone number of the provider contact (enclose in quotes)\n- **fax**: the facsimile number of the provider contact (enclose in quotes)\n- **email**: the email address of the provider contact\n- **url**: the URL to more information about the provider contact\n- **hours**: the hours of service to contact the provider\n- **instructions**: the how to contact the provider contact\n- **role**: the role of the provider contact as per the `ISO 19115 CI_RoleCode codelist `_). Accepted values are ``author``, ``processor``, ``publisher``, ``custodian``, ``pointOfContact``, ``distributor``, ``user``, ``resourceProvider``, ``originator``, ``owner``, ``principalInvestigator``\n\n**repository**\n\n- **database**: the full file path to the metadata database, in database URL format (see https://docs.sqlalchemy.org/en/latest/core/engines.html#database-urls)\n- **table**: the table name for metadata records (default is ``records``). If you are using PostgreSQL with a DB schema other than ``public``, qualify the table like ``myschema.table``\n- **mappings**: custom repository mappings (see :ref:`custom_repository`)\n- **source**: the source of this repository only if not local (e.g. :ref:`geonode`, :ref:`odc`). Supported values are ``geonode``, ``odc``\n- **filter**: server side database filter to apply as mask to all CSW requests (see :ref:`repofilters`)\n- **max_retries**: max number of retry attempts when connecting to records-repository database\n- **stable_sort**: enables stable sorting by appending an identifier sort as the last sortable. Default is ``false``\n- **facets**: comma-separated list of facetable properties for search results\n\n.. note::\n\n See :ref:`administration` for connecting your metadata repository and supported information models.\n\n.. _maxrecords-handling:\n\nMaxRecords Handling\n-------------------\n\nThe The following describes how ``maxRecords`` is handled by the configuration when handling OGC API - Records items or CSW ``GetRecords`` requests:\n\n.. csv-table::\n :header: server.maxrecords,OGC API - Records limit/CSW GetRecords.maxRecords,Result\n\n none set,none passed,10 (CSW default)\n 20,14,20\n 20,none passed,20\n none set,100,100\n 20,200,20\n\n.. _alternate-configurations:\n\nUsing environment variables in configuration files\n--------------------------------------------------\n\npycsw configuration supports using system environment variables, which can be helpful\nfor deploying into `12 factor `_ environments for example.\n\nBelow is an example of how to integrate system environment variables in pycsw:\n\n.. code-block:: yaml\n\n repository:\n database: ${PYCSW_REPOSITORY_DATABASE_URI}\n table: ${MY_TABLE}\n\n\nAlternate Configurations\n------------------------\n\nBy default, pycsw loads ``default.yml`` at runtime. To load an alternate configuration, modify ``csw.py`` to point to the desired configuration. Alternatively, pycsw supports explicitly specifiying a configuration by appending ``config=/path/to/default.yml`` to the base URL of the service (e.g. ``http://localhost/pycsw/csw.py?config=tests/suites/default/default.yml&service=CSW&version=2.0.2&request=GetCapabilities``). When the ``config`` parameter is passed by a CSW client, pycsw will override the default configuration location and subsequent settings with those of the specified configuration.\n\nThis also provides the functionality to deploy numerous CSW servers with a single pycsw installation.\n\nHiding the Location\n^^^^^^^^^^^^^^^^^^^\n\nSome deployments with alternate configurations prefer not to advertise the base URL with the ``config=`` approach. In this case, there are many options to advertise the base URL.\n\nEnvironment Variables\n~~~~~~~~~~~~~~~~~~~~~\n\npycsw supports the following environment variables:\n\n- ``PYCSW_CONFIG``: specifies the filepath to a pycsw configuraiton\n\n\nConfiguration file location\n^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nOne option is using Apache's ``Alias`` and ``SetEnvIf`` directives. For example, given the base URL ``http://localhost/pycsw/csw.py?config=foo.yml``, set the following in your Apache configuration:\n\n.. code-block:: none\n\n Alias /pycsw/csw-foo.py /var/www/pycsw/csw.py\n SetEnvIf Request_URI \"/pycsw/csw-foo.py\" PYCSW_CONFIG=/var/www/pycsw/csw-foo.yml.\n\n.. note::\n\n Apache must be restarted after changes to configuration\n\npycsw will use the configuration as set in the ``PYCSW_CONFIG`` environment variable in the same manner as if it was specified in the base URL. Note that the configuration value ``server.url`` value must match the ``Request_URI`` value so as to advertise correctly in pycsw's Capabilities XML.\n\nWrapper Script\n~~~~~~~~~~~~~~\n\nAnother option is to write a simple wrapper (e.g. ``csw-foo.sh``), which provides the same functionality and can be deployed without restarting Apache:\n\n.. code-block:: bash\n\n #!/bin/sh\n\n export PYCSW_CONFIG=/var/www/pycsw/csw-foo.yml\n\n /var/www/pycsw/csw.py\n\n\n\n.. _`sample configuration`: https://github.com/geopython/pycsw/blob/master/default-sample.yml\n"
},
{
"path": "docs/contributing.rst",
"content": ".. _contributing:\n\n.. include:: ../CONTRIBUTING.rst\n"
},
{
"path": "docs/csw-support.rst",
"content": ".. _csw-support:\n\nCSW Support\n===========\n\nVersions\n--------\n\npycsw supports both CSW 2.0.2 and 3.0.0 versions by default. In alignment with\nthe CSW specifications, the default version returned is the latest supported\nversion. That is, pycsw will always behave like a 3.0.0 CSW unless the client\nexplicitly requests a 2.0.2 CSW.\n\nThe sample URLs below provide examples of how requests behaves against\nvarious/missing/default version parameters.\n\n.. code-block:: bash\n\n http://localhost/csw # returns 3.0.0 Capabilities\n http://localhost/csw?service=CSW&request=GetCapabilities # returns 3.0.0 Capabilities\n http://localhost/csw?service=CSW&version=2.0.2&request=GetCapabilities # returns 2.0.2 Capabilities\n http://localhost/csw?service=CSW&version=3.0.0&request=GetCapabilities # returns 3.0.0 Capabilities\n\nRequest Examples\n----------------\n\nThe best place to look for sample requests is within the `tests/` directory,\nwhich provides numerous examples of all supported APIs and requests.\n\nAdditional examples:\n\n- `Data.gov CSW HowTo v2.0`_\n- `pycsw Quickstart on OSGeoLive`_\n\n.. _`pycsw Quickstart on OSGeoLive`: https://live.osgeo.org/en/quickstart/pycsw_quickstart.html\n.. _`Data.gov CSW HowTo v2.0`: https://gist.github.com/kalxas/6ecb06d61cdd487dc7f9\n"
},
{
"path": "docs/distributedsearching.rst",
"content": ".. _distributedsearching:\n\nDistributed Searching\n=====================\n\n.. note::\n\n - in CSW mode, distributed search must be configured against remote CSW services\n - in OGC API - Records mode, distributed search must be configured against remote OGC API - Records services\n\n.. note::\n\n Your server must be able to make outgoing HTTP requests for this functionality.\n\nCSW 2 / 3\n---------\n\npycsw has the ability to perform distributed searching against other CSW servers. Distributed searching is disabled by default; to enable, ``federatedcatalogues`` must be set. A CSW client must issue a GetRecords request with ``csw:DistributedSearch`` specified, along with an optional ``hopCount`` attribute (see subclause 10.8.4.13 of the CSW specification). When enabled, pycsw will search all specified catalogues and return a unified set of search results to the client. Due to the distributed nature of this functionality, requests will take extra time to process compared to queries against the local repository.\n\nScenario: Federated Search\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\npycsw deployment with 3 configurations (CSW-1, CSW-2, CSW-3), subsequently providing three (3) endpoints. Each endpoint is based on an opaque metadata repository (based on theme/place/discipline, etc.). Goal is to perform a single search against all endpoints.\n \npycsw realizes this functionality by supporting :ref:`alternate configurations `, and exposes the additional CSW endpoint(s) with the following design pattern:\n \nCSW-1: ``http://localhost/pycsw/csw.py?config=CSW-1.yml``\n \nCSW-2: ``http://localhost/pycsw/csw.py?config=CSW-2.yml``\n \nCSW-3: ``http://localhost/pycsw/csw.py?config=CSW-3.yml``\n \n...where the ``*.yml`` configuration files are configured for each respective metadata repository. The above CSW endpoints can be interacted with as usual.\n \nTo federate the discovery of the three (3) portals into a unified search, pycsw realizes this functionality by deploying an additional configuration which acts as the superset of CSW-1, CSW-2, CSW-3:\n\nCSW-all: ``http://localhost/pycsw/csw.py?config=CSW-all.yml``\n\nThis allows the client to invoke one (1) CSW GetRecords request, in which the CSW endpoint spawns the same GetRecords request to 1..n distributed CSW endpoints. Distributed CSW endpoints are advertised in CSW Capabilities XML via ``ows:Constraint``:\n\n.. code-block:: xml\n\n \n ... \n \n http://localhost/pycsw/csw.py?config=CSW-1.yml\n http://localhost/pycsw/csw.py?config=CSW-2.yml\n http://localhost/pycsw/csw.py?config=CSW-3.yml\n \n ...\n \n\n...which advertises which CSW endpoint(s) the CSW server will spawn if a distributed search is requested by the client.\n \nin the CSW-all configuration:\n\n.. code-block:: yaml\n\n federatedcatalogues:\n - id: fedcat01\n type: CSW\n title: Federated catalogue 1\n url: http://localhost/pycsw/csw.py?config=CSW-1.yml\n - id: fedcat02\n type: CSW\n title: Federated catalogue 2\n url: http://localhost/pycsw/csw.py?config=CSW-2.yml\n - id: fedcat03\n type: CSW\n title: Federated catalogue 3\n url: http://localhost/pycsw/csw.py?config=CSW-3.yml\n \nAt which point a CSW client request to CSW-all with ``distributedsearch=TRUE``, while specifying an optional ``hopCount``. Query network topology:\n\n.. code-block:: none \n\n AnyClient\n ^\n |\n v\n CSW-all\n ^ \n |\n v\n /-------------\\\n ^ ^ ^\n | | |\n v v v\n CSW-1 CSW-2 CSW-3\n \nAs a result, a pycsw deployment in this scenario may be approached on a per 'theme' basis, or at an aggregate level.\n \nAll interaction in this scenario is local to the pycsw installation, so network performance would not be problematic.\n \nA very important facet of distributed search is as per Annex B of OGC:CSW 2.0.2. Given that all the CSW endpoints are managed locally, duplicates and infinite looping are not deemed to present an issue.\n\nOGC API - Records\n-----------------\n\nExperimental support for distibuted searching is available in pycsw's OGC API - Records support to allow for searching remote services. The implementation uses the same approach as described above, operating in OGC API - Records mode as per `OGC API - Records - Part 4: Federated Search`_ (draft).\n\n.. note::\n\n The ``federatedcatalogues`` directives must point to an OGC API - Records **collections** endpoint.\n\n.. code-block:: yaml\n\n federatedcatalogues:\n - id: fedcat01\n type: OARec\n title: Federated catalogue 1\n url: https://example.org/collections/collection1\n - id: fedcat02\n type: OARec\n title: Federated catalogue 2\n url: https://example.org/collections/collection2\n \nWith the above configured, a distributed search can be invoked as follows:\n\nhttp://localhost/collections/metadata:main/items?distributedSearch=true\n\nSTAC API\n--------\n\nExperimental support for distibuted searching is available in pycsw's STAC API support to allow for searching remote services. The implementation uses the same approach as described above.\n\n.. note::\n\n The ``federatedcatalogues`` directives must point to a STAC API endpoint.\n\n.. code-block:: yaml\n\n federatedcatalogues:\n - id: fedcat03\n type: STAC-API\n title: Copernicus Data Space Ecosystem (CDSE) asset-level STAC catalogue\n url: https://stac.dataspace.copernicus.eu/v1\n collections:\n - daymet-annual-pr\n\n\n.. note::\n\n To constrain STAC API distributed search to specific collections, define one to many in the `collections` (array) directive.\n\n\nWith the above configured, a distributed search can be invoked as follows:\n\nhttp://localhost/stac/search?distributedSearch=true\n\n.. _`OGC API - Records - Part 4: Federated Search`: https://github.com/opengeospatial/ogcapi-records/blob/master/extensions/federated-search/document.adoc\n"
},
{
"path": "docs/docker.rst",
"content": "Docker\n======\n\nInstallation\n------------\n\npycsw provides an official `Docker`_ image which is made available on both the `geopython Docker Hub`_ and our `GitHub Container Registry`_. \n\nEither ``IMAGE`` can be called with the ``docker`` command, ``geopython/pycsw`` from DockerHub or ``ghcr.io/geophython/pycsw`` from the GitHub Container Registry. Examples below use ``geopython/pygeoapi``. \n\nAssuming you already have docker installed, you can get a pycsw instance up and running run with the default built-in configuration:\n\n.. code-block:: bash\n\n docker run -p 8000:8000 geopython/pycsw \n \n # or\n \n docker run -p 8000:8000 ghcr.io/geopython/pycsw\n\n...then browse to http://localhost:8000\n \nDocker will retrieve the pycsw image (if needed) and then\nstart a new container listening on port 8000.\n\nThe default configuration will run pycsw with an sqlite repository backend\nloaded with some test data from the CITE test suite. You can use this to take\npycsw for a test drive.\n\n\nInspect logs\n------------\n\nThe default configuration for the docker image outputs logs to stdout. This is\ncommon practice with docker containers and enables the inspection of logs\nwith the ``docker logs`` command::\n\n # run a pycsw container in the background\n docker run \\\n --name pycsw-test \\\n --publish 8000:8000 \\\n --detach \\\n geopython/pycsw\n\n # inspect logs\n docker logs pycsw-test\n\n.. note::\n\n In order to have pycsw logs being sent to standard output you must set\n ``server.logfile=`` in the pycsw configuration file.\n\n\nUsing pycsw-admin.py\n--------------------\n\n``pycsw-admin.py`` can be executed on a running container by\nusing ``docker exec``::\n\n docker exec -ti pycsw-admin.py --help\n\n\nRunning custom pycsw containers\n-------------------------------\n\npycsw configuration\n^^^^^^^^^^^^^^^^^^^\n\nIt is possible to supply a custom configuration file for pycsw as a bind \nmount or as a docker secret (in the case of docker swarm). The configuration \nfile is searched at the value of the ``PYCSW_CONFIG`` environmental variable,\nwhich defaults to ``/etc/pycsw/pycsw.yml``. \n\nSupplying the configuration file via bind mount::\n\n docker run \\\n --name pycsw \\\n --detach \\\n --volume :/etc/pycsw/pycsw.yml \\\n --publish 8000:8000 \\\n geopython/pycsw\n\nSupplying the configuration file via docker secrets::\n\n # first create a docker secret with the pycsw config file\n docker secret create pycsw-config \n docker service create \\\n --name pycsw \\\n --secret src=pycsw-config,target=/etc/pycsw/pycsw.yml \\\n --publish 8000:8000\n geopython/pycsw\n\n\nsqlite repositories\n^^^^^^^^^^^^^^^^^^^\n\nThe default database repository is the CITE database that is used for running \npycsw's test suites. Docker volumes may be used to specify a custom sqlite\ndatabase path. It should be mounted under ``/var/lib/pycsw``::\n\n # first create a docker volume for persisting the database when\n # destroying containers\n docker volume create pycsw-db-data\n docker run \\\n --volume db-data:/var/lib/pycsw \\\n --detach \\\n --publish 8000:8000\n geopython/pycsw\n\n\nPostgreSQL repositories\n^^^^^^^^^^^^^^^^^^^^^^^\n\nSpecifying a PostgreSQL repository is just a matter of configuring a custom\npycsw.yml file with the correct specification.\n\nCheck `pycsw's GitHub repository`_ for an example of a docker compose/stack\nfile that spins up a postgis database together with a pycsw instance.\n\n\nSetting up a development environment with docker\n------------------------------------------------\n\nWorking on pycsw's code using docker enables an isolated environment that\nhelps ensuring reproducibility while at the same time keeping your base\nsystem free from pycsw related dependencies. This can be achieved by:\n\n* Cloning pycsw's repository locally;\n* Starting up a docker container with appropriately set up bind mounts. In\n addition, the pycsw docker image supports a ``reload`` flag that turns on\n automatic reloading of the gunicorn web server whenever the code changes;\n* Installing the development dependencies by using ``docker exec`` with the\n root user;\n\nThe following instructions set up a fully working development environment::\n\n # clone pycsw's repo\n git clone https://github.com/geopython/pycsw.git\n\n # start a container for development\n cd pycsw\n docker run \\\n --name pycsw-dev \\\n --detach \\\n --volume ${PWD}/pycsw:/usr/lib/python3.7/site-packages/pycsw \\\n --volume ${PWD}/docs:/home/pycsw/docs \\\n --volume ${PWD}/LICENSE.txt:/home/pycsw/LICENSE.txt \\\n --volume ${PWD}/COMMITTERS.txt:/home/pycsw/COMMITTERS.txt \\\n --volume ${PWD}/CONTRIBUTING.rst:/home/pycsw/CONTRIBUTING.rst \\\n --volume ${PWD}/pycsw/plugins:/home/pycsw/pycsw/plugins \\\n --publish 8000:8000 \\\n geopython/pycsw --reload\n\n # install additional dependencies used in tests and docs\n docker exec \\\n -ti \\\n --user root \\\n pycsw-dev pip3 install -r pycsw/requirements-dev.txt\n\n # run tests (for example unit tests)\n docker exec -ti pycsw-dev pytest -m unit pycsw\n\n # build docs\n docker exec -ti pycsw-dev sh -c \"cd pycsw/docs && make html\"\n\n.. note::\n\n The pycsw image uses a specific Python version and does\n not install pycsw in editable mode. As such it is not possible to\n use ``tox``.\n\nSince the docs directory is bind mounted from your host machine into the\ncontainer, after building the docs you may inspect their content visually, for\nexample by running::\n\n firefox docs/_build/html/index.html\n\nDocker Compose\n==============\n\nFor `Docker Compose`_ deployment, run the following in ``docker/compose``:\n\n.. code-block:: bash\n\n PYCSW_DOCKER_IMAGE=latest docker compose up\n\n\n.. note::\n\n The ``PYCSW_DOCKER_IMAGE`` setting is required to set the Docker image version/tag.\n\n\nScaling\n-------\n\nTo scale via Docker Compose, run the following in ``docker/compose``:\n\n.. code-block:: bash\n\n PYCSW_DOCKER_IMAGE=latest docker compose -f docker-compose.scale.yml up\n\n.. note::\n\n In ``docker/compose/docker-compose.scale.yml``, adjust the ``services.pycsw.deploy``\n and services.pycsw.ports values to scale accordingly. The port range specified must\n match the number of replicas defined.\n\nKubernetes\n==========\n\nFor `Kubernetes`_ orchestration, run the following in ``docker/kubernetes``:\n\n.. code-block:: bash\n\n make up\n make open\n\n\nHelm\n====\n\nFor Kubernetes deployment via `Helm`_, run the following in ``docker/helm``:\n\n.. code-block:: bash\n\n helm install pycsw .\n minikube service pycsw --url\n\n\n.. _`Docker`: https://www.docker.com\n.. _`geopython Docker Hub`: https://hub.docker.com/r/geopython/pycsw\n.. _`GitHub Container Registry`: https://github.com/geopython/pycsw/pkgs/container/pycsw\n.. _pycsw's GitHub repository: https://github.com/geopython/pycsw/tree/master/docker\n.. _`Docker Compose`: https://docs.docker.com/compose\n.. _`Kubernetes`: https://kubernetes.io/\n.. _`Helm`: https://helm.sh\n"
},
{
"path": "docs/geonode.rst",
"content": ".. _geonode:\n\nGeoNode Configuration\n======================\n\nGeoNode (https://geonode.org/) is a platform for the management and publication of geospatial data. It brings together mature and stable open-source software projects under a consistent and easy-to-use interface allowing users, with little training, to quickly and easily share data and create interactive maps. GeoNode provides a cost-effective and scalable tool for developing information management systems. GeoNode uses CSW as a cataloguing mechanism to query and present geospatial metadata.\n\npycsw supports binding to an existing GeoNode repository for metadata query. The binding is read-only (transactions are not in scope, as GeoNode manages repository metadata changes in the application proper).\n\nGeoNode Setup\n-------------\n\npycsw is enabled and configured by default in GeoNode, so there are no additional steps required once GeoNode is setup. See the ``CATALOGUE`` and ``PYCSW`` `settings.py entries`_ at for customizing pycsw within GeoNode.\n\nThe GeoNode plugin is managed outside of pycsw within the GeoNode project.\n\n.. _`settings.py entries`: https://docs.geonode.org/en/master/basic/settings/index.html\n"
},
{
"path": "docs/hhypermap.rst",
"content": ".. _hhypermap:\n\nHHypermap-Registry Configuration\n================================\n\nHHypermap (Harvard Hypermap) Registry (https://github.com/cga-harvard/Hypermap-Registry) is an application that manages OWS, Esri REST, and other types of map service harvesting, and maintains uptime statistics for services and layers. HHypermap Registry will publish to HHypermap Search (based on Lucene) which provides a fast search and visualization environment for spatio-temporal materials.\n\nHHypermap uses CSW as a cataloguing mechanism to ingest, query and present geospatial metadata.\n\npycsw supports binding to an existing HHypermap repository for metadata query.\n\nHHypermap Setup\n---------------\n\npycsw is enabled and configured by default in HHypermap, so there are no additional steps required once HHypermap is setup. See the ``REGISTRY_PYCSW`` `hypermap/settings.py entries`_ for customizing pycsw within HHypermap.\n\nThe HHypermap plugin is managed outside of pycsw within the HHypermap project. HHypermap settings must ensure that ``REGISTRY_PYCSW['repository']['source']`` is set to ``hypermap.search.pycsw_repository``.\n\n.. _`hypermap/settings.py entries`: https://github.com/cga-harvard/Hypermap-Registry/blob/master/hypermap/settings.py\n"
},
{
"path": "docs/html-templating.rst",
"content": ".. _html-templating:\n\nHTML Templating\n===============\n\npycsw uses `Jinja`_ as its templating engine to render HTML and `Flask`_ to provide route paths of the API that returns HTTP responses. For complete details on how to use these modules, refer to the `Jinja documentation`_ and the `Flask documentation`_.\n\nThe default pycsw configuration has ``server.templates`` commented out and defaults to the pycsw ``pycsw/templates`` and ``pycsw/static`` folder. To point to a different set of template configuration, you can edit your configuration as follows:\n\n.. code-block:: yaml\n\n server:\n templates:\n path: /path/to/jinja2/templates/folder # jinja2 template HTML files\n static: /path/to/static/folder # css, js, images and other static files referenced by the template\n\n**Note:** the URL path to your static folder will always be ``/static`` in your deployed web instance of pycsw.\n\nYour templates folder should mimic the same file names and structure of the default pycsw templates. Otherwise, you will need to modify ``api.py`` accordingly.\n\nNote that you need only copy and edit the templates you are interested in updating. For example,\nif you are only interested in updating the ``landing_page.html`` template, then create your own version\nof only that same file. When pycsw detects that a custom HTML template is being used,\nit will look for the custom template in ``server.templates.path``. If it does not exist, pycsw\nwill render the default HTML template for the given endpoint/request.\n\nLinking to a static file in your HTML templates can be done using Jinja syntax and the exposed ``config['server']['url']``:\n\n.. code-block:: html\n\n \n \n \n \n \n ![](\"{{ "\\"{{")
\n\n.. _`Jinja`: https://palletsprojects.com/p/jinja/\n.. _`Jinja documentation`: https://jinja.palletsprojects.com\n.. _`Flask`: https://palletsprojects.com/p/flask/\n.. _`Flask documentation`: https://flask.palletsprojects.com\n"
},
{
"path": "docs/index.rst",
"content": ".. _index:\n\n=============================\npycsw |release| Documentation\n=============================\n\n.. image:: https://zenodo.org/badge/2367090.svg\n :target: https://zenodo.org/badge/latestdoi/2367090\n\n:Author: Tom Kralidis\n:Contact: tomkralidis at gmail.com\n:Release: |release|\n:Date: |today|\n\n.. toctree::\n :maxdepth: 2\n\n introduction\n installation\n docker\n configuration\n administration\n metadata-model-reference\n oarec-support\n csw-support\n pubsub\n stac\n distributedsearching\n sru\n opensearch\n oaipmh\n json\n soap\n sitemaps\n transactions\n repofilters\n profiles\n repositories\n outputschemas\n xslt\n html-templating\n geonode\n hhypermap\n odc\n ckan\n api\n testing\n migration-guide\n tools\n support\n contributing\n license\n committers\n"
},
{
"path": "docs/installation.rst",
"content": ".. _installation:\n\nInstallation\n============\n\nSystem Requirements\n-------------------\n\npycsw is written in `Python `_, and works with (tested) Python 3.\n\npycsw requires the following Python supporting libraries:\n\n- `lxml`_ for XML support\n- `SQLAlchemy`_ for database bindings\n- `pyproj`_ for coordinate transformations\n- `PyYAML`_ for configuration management\n- `Shapely`_ for spatial query / geometry support\n- `OWSLib`_ for CSW client and metadata parser\n- `xmltodict`_ for working with XML similar to working with JSON\n- `geolinks`_ for dealing with geospatial links\n\nOGC API - Records\n^^^^^^^^^^^^^^^^^\n\nOGC API - Records support additionally requires the following:\n\n- `Flask`_ for pycsw's default OGC API - Records endpoint\n- `pygeofilter`_ for CQL parsing\n\n.. note::\n\n You can install these dependencies via `pip`_\n\n.. note::\n\n For :ref:`GeoNode ` or :ref:`Open Data Catalog ` or :ref:`HHypermap ` deployments, SQLAlchemy is not required\n\nInstalling from Source\n----------------------\n\n`Download `_ the latest stable version or fetch from Git.\n\nFor Developers and the Truly Impatient\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThe 4 minute install:\n\n.. code-block:: bash\n\n virtualenv pycsw && cd pycsw && . bin/activate\n git clone https://github.com/geopython/pycsw.git && cd pycsw\n pip3 install -e . && pip3 install -r requirements-standalone.txt\n cp default-sample.yml default.yml\n vi default.yml\n # adjust paths in\n # server.home\n # repository.database\n # set server.url to http://localhost:8000/\n # start server - CSW 2/3, OAI-PMH, OpenSearch, SRU (all endpoints at /)\n python3 pycsw/wsgi.py\n curl http://localhost:8000/?service=CSW&version=2.0.2&request=GetCapabilities\n\nTo enable OGC API - Records as well as the abovementioned search standards:\n\n.. code-block:: bash\n\n # configure which config file to use\n export PYCSW_CONFIG=default.yml\n # start server - OGC API - Records and all services (various endpoints below)\n python3 pycsw/wsgi_flask.py\n # OGC API - Records\n curl http://localhost:8000\n # OpenAPI document\n curl http://localhost:8000/openapi\n # OGC CSW 3\n curl http://localhost:8000/csw\n # OGC CSW 2\n curl http://localhost:8000/csw?service=CSW&version=2.0.2&request=GetCapabilities\n # OAI-PMH\n curl http://localhost:8000/oaipmh\n # OpenSearch\n curl http://localhost:8000/opensearch\n # SRU\n curl http://localhost:8000/sru\n\n\nThe Quick and Dirty Way\n^^^^^^^^^^^^^^^^^^^^^^^\n\n.. code-block:: bash\n\n git clone https://github.com/geopython/pycsw.git\n\nEnsure that CGI is enabled for the install directory. For example, on Apache, if pycsw is installed in ``/srv/www/htdocs/pycsw`` (where the URL will be ``http://host/pycsw/csw.py``), add the following to ``httpd.conf``:\n\n.. code-block:: none\n\n \n Options +FollowSymLinks +ExecCGI\n Allow from all\n AddHandler cgi-script .py\n \n\n.. note::\n If pycsw is installed in ``cgi-bin``, this should work as expected. In this case, the :ref:`tests ` application must be moved to a different location to serve static HTML documents.\n\nMake sure, you have all the dependencies from ``requirements.txt and requirements-standalone.txt``\n\nThe Clean and Proper Way\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. code-block:: bash\n\n git clone https://github.com/geopython/pycsw.git\n cd pycsw\n python3 setup.py build\n python3 setup.py install\n\nAt this point, pycsw is installed as a library and requires a CGI ``csw.py``\nor WSGI ``pycsw/wsgi.py`` script to be served into your web server environment\n(see below for WSGI configuration/deployment).\n\n.. _pypi:\n\nInstalling from the Python Package Index (PyPI)\n-----------------------------------------------\n\n.. code-block:: bash\n\n pip3 install pycsw\n\n.. _opensuse:\n\nInstalling from OpenSUSE Build Service\n--------------------------------------\n\nIn order to install the pycsw package in openSUSE Leap (stable distribution), one can run the following commands as user ``root``:\n\n.. code-block:: bash\n\n zypper -ar https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.2/ GEO\n zypper refresh\n zypper install python-pycsw pycsw-cgi\n\n\nIn order to install the pycsw package in openSUSE Tumbleweed (rolling distribution), one can run the following commands as user ``root``:\n\n.. code-block:: bash\n\n zypper -ar https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Tumbleweed/ GEO\n zypper refresh\n zypper install python-pycsw pycsw-cgi\n\nAn alternative method is to use the `One-Click Installer `_.\n\n.. _ubuntu:\n\nInstalling on Ubuntu/Mint\n-------------------------\n\nIn order to install the most recent pycsw release to an Ubuntu-based distribution, one can use the UbuntuGIS Unstable repository by running the following commands:\n\n.. code-block:: bash\n\n sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable\n sudo apt-get update\n sudo apt-get install python-pycsw pycsw-cgi\n\nAlternatively, one can use the UbuntuGIS Stable repository which includes older but very well tested versions:\n\n sudo add-apt-repository ppa:ubuntugis/ppa\n sudo apt-get update\n sudo apt-get install python-pycsw pycsw-cgi\n\n.. note::\n Since Ubuntu 16.04 LTS Xenial release, pycsw is included by default in the official Multiverse repository.\n\nRunning on Windows\n------------------\n\nFor Windows installs, change the first line of ``csw.py`` to:\n\n.. code-block:: python\n\n #!/Users/USERNAME/AppData/Local/Programs/Python/Python36/python -u\n\n.. note::\n The use of ``-u`` is required to properly output gzip-compressed responses.\n\n.. note::\n ``USERNAME`` should match your username, and the Python version should match with your install (e.g. ``Python36``).\n \n.. Tip::\n \n `MS4W `__ (MapServer for Windows) as of its version 4.0 release includes pycsw,\n Apache's mod_wsgi, Python 3.7, and many other tools, all ready to use out of the box. After installing,\n you will find your local pycsw catalogue endpoint, and steps for further configuration, on your\n browser's localhost page. You can read more about pycsw inside MS4W `here `__.\n\nSecurity\n--------\n\nBy default, ``default.yml`` is at the root of the pycsw install. If pycsw is setup outside an HTTP server's ``cgi-bin`` area, this file could be read. The following options protect the configuration:\n\n- move ``default.yml`` to a non HTTP accessible area, and modify ``csw.py`` to point to the updated location\n- configure web server to deny access to the configuration. For example, in Apache, add the following to ``httpd.conf``:\n\n.. code-block:: none\n\n \n order allow,deny\n deny from all\n \n\n\nRunning on WSGI\n---------------\n\npycsw supports the `Web Server Gateway Interface`_ (WSGI). To run pycsw in\nWSGI mode, use ``pycsw/wsgi.py`` in your WSGI server environment.\n\n.. note::\n\n ``mod_wsgi`` supports only the version of Python it was compiled with. If the target server\n already supports WSGI applications, pycsw will need to use the same Python version.\n `WSGIDaemonProcess`_ provides a ``python-path`` directive that may allow a virtualenv created from the Python version ``mod_wsgi`` uses.\n\nBelow is an example of configuring with Apache:\n\n.. code-block:: none\n\n WSGIDaemonProcess host1 home=/var/www/pycsw processes=2\n WSGIProcessGroup host1\n WSGIScriptAlias /pycsw-wsgi /var/www/pycsw/wsgi.py\n \n Order deny,allow\n Allow from all\n \n\n\nor use the `WSGI reference implementation`_:\n\n.. code-block:: bash\n\n python3 ./pycsw/wsgi.py\n Serving on port 8000...\n\nwhich will publish pycsw to ``http://localhost:8000/``\n\n.. _`lxml`: https://lxml.de/\n.. _`SQLAlchemy`: https://www.sqlalchemy.org/\n.. _`Shapely`: https://toblerity.github.io/shapely/\n.. _`pyproj`: https://code.google.com/p/pyproj/\n.. _`OWSLib`: https://geopython.github.io/OWSLib\n.. _`xmltodict`: https://github.com/martinblech/xmltodict\n.. _`geolinks`: https://github.com/geopython/geolinks\n.. _`Flask`: https://flask.palletsprojects.com\n.. _`pygeofilter`: https://github.com/geopython/pygeofilter\n.. _`PyYAML`: https://pyyaml.org\n.. _`pip`: https://pip.pypa.io/en/stable\n.. _`Web Server Gateway Interface`: https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface\n.. _`WSGIDaemonProcess`: https://code.google.com/p/modwsgi/wiki/ConfigurationDirectives#WSGIDaemonProcess\n.. _`WSGI reference implementation`: https://docs.python.org/library/wsgiref.html\n"
},
{
"path": "docs/introduction.rst",
"content": ".. _introduction:\n\nIntroduction\n============\n\npycsw is an OGC API - Records and OGC CSW server implementation written in Python.\n\nFeatures\n========\n\n- implements `OGC API - Records - Part 1: Core`_\n- implements `OGC API - Records - Part 2: Facets`_\n- implements `OGC API - Records - Part 3: Create, Replace, Update, Delete, Harvest`_\n- implements `OGC API - Records - Part 4: Federated Search`_\n- implements `OGC API - Features - Part 3: Filtering`_\n- implements `STAC API`_\n- implements `Common Query Language (CQL2)`_\n- certified OGC `Compliant`_ and OGC Reference Implementation for both CSW 2.0.2 and CSW 3.0.0\n- harvesting support for WMS, WFS, WCS, WPS, WAF, CSW, SOS\n- implements `INSPIRE Discovery Services 3.0`_\n- implements `ISO Metadata Application Profile 1.0.0`_\n- implements `FGDC CSDGM Application Profile for CSW 2.0`_\n- implements the Search/Retrieval via URL (`SRU`_) search protocol\n- implements Full Text Search capabilities\n- implements OGC OpenSearch Geo and Time Extensions\n- implements Open Archives Initiative Protocol for Metadata Harvesting\n- implements Pub/Sub capability via `OGC API Publish-Subscribe Workflow - Part 1: Core`_\n- supports ISO, Dublin Core, DIF, FGDC, Atom, GM03 and DataCite metadata models\n- CGI or WSGI deployment\n- simple YAML configuration\n- transactional capabilities (OGC API - Records and CSW-T)\n- flexible repository configuration\n- `GeoNode`_ connectivity\n- `HHypermap`_ connectivity\n- `Open Data Catalog`_ connectivity\n- `CKAN`_ connectivity\n- federated catalogue distributed searching\n- realtime XML Schema validation\n- extensible profile plugin architecture\n\nStandards Support\n-----------------\n\n.. csv-table::\n :header: Standard,Version(s)\n\n `OGC API - Records - Part 1: Core`_,1.0\n `OGC API - Features - Part 3: Filtering`_,draft\n \"`OGC API - Features - Part 4: Create, Replace, Update and Delete`_\",draft\n `OGC API Publish-Subscribe Workflow - Part 1: Core`_,draft\n `OGC CSW`_,2.0.2/3.0.0\n `OGC Filter`_,1.1.0/2.0.0\n `OGC OWS Common`_,1.0.0/2.0.0\n `OGC GML`_,3.1.1\n `OGC SFSQL`_,1.2.1\n `OGC GeoRSS`_,1.0\n `Dublin Core`_,1.1\n `SOAP`_,1.2\n `ISO 19115`_,2003\n `ISO 19139`_,2007\n `ISO 19119`_,2005\n `NASA DIF`_,9.7\n `FGDC CSDGM`_,1998\n `GM03`_,2.1\n `SRU`_,1.1\n `OGC OpenSearch`_,1.0\n `OAI-PMH`_,2.0\n `DataCite`_,4.3\n\nOGC API - Records support\n-------------------------\n\n- Part 1: Core\n\nOGC API - Features support\n--------------------------\n\n- Part 3: Filtering\n- Part 4: Create, Replace, Update and Delete\n\nCQL\n---\n\n- Common Query Language (CQL2)\n\nSupported Output Formats\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n- JSON (default)\n- XML\n\nSupported Filters\n^^^^^^^^^^^^^^^^^\n\n- q\n- datetime\n- filter / filter-lang (CQL)\n- bbox\n- all properties (``property=value``)\n\nPaging\n^^^^^^\n\n- limit\n- offset\n\nCSW Support\n-----------\n\nSupported Operations\n^^^^^^^^^^^^^^^^^^^^\n\n.. csv-table::\n :header: Request,Optionality,Supported,HTTP method binding(s)\n\n GetCapabilities,mandatory,yes,GET (KVP) / POST (XML) / SOAP\n DescribeRecord,mandatory,yes,GET (KVP) / POST (XML) / SOAP\n GetRecords,mandatory,yes,GET (KVP) / POST (XML) / SOAP\n GetRecordById,optional,yes,GET (KVP) / POST (XML) / SOAP\n GetRepositoryItem,optional,yes,GET (KVP)\n GetDomain,optional,yes,GET (KVP) / POST (XML) / SOAP\n Harvest,optional,yes,GET (KVP) / POST (XML) / SOAP\n UnHarvest,optional,no,\n Transaction,optional,yes,POST (XML) / SOAP\n\n.. note::\n\n Asynchronous processing supported for GetRecords and Harvest requests (via ``csw:ResponseHandler``)\n\n.. note::\n\n Supported Harvest Resource Types are listed in :ref:`transactions`\n\nSupported Output Formats\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n- XML (default)\n- JSON\n\nSupported Output Schemas\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n- Dublin Core\n- ISO 19139\n- FGDC CSDGM\n- NASA DIF\n- Atom\n- GM03\n- DataCite\n\nSupported Sorting Functionality\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n- ogc:SortBy\n- ascending or descending\n- aspatial (queryable properties)\n- spatial (geometric area)\n\nSupported Filters\n^^^^^^^^^^^^^^^^^\n\nFull Text Search\n^^^^^^^^^^^^^^^^\n\n- csw:AnyText\n\nGeometry Operands\n^^^^^^^^^^^^^^^^^\n\n- gml:Point\n- gml:LineString\n- gml:Polygon\n- gml:Envelope\n\n.. note::\n\n Coordinate transformations are supported\n\nSpatial Operators\n^^^^^^^^^^^^^^^^^\n\n- BBOX\n- Beyond\n- Contains\n- Crosses\n- Disjoint\n- DWithin\n- Equals\n- Intersects\n- Overlaps\n- Touches\n- Within\n\nLogical Operators\n^^^^^^^^^^^^^^^^^\n\n- Between\n- EqualTo\n- LessThanEqualTo\n- GreaterThan\n- Like\n- LessThan\n- GreaterThanEqualTo\n- NotEqualTo\n- NullCheck\n\nFunctions\n^^^^^^^^^\n- length\n- lower\n- ltrim\n- rtrim\n- trim\n- upper\n\nOAI-PMH Support\n---------------\n\nSupported Operations\n^^^^^^^^^^^^^^^^^^^^\n\n- GetRecord\n- Identify\n- ListIdentifiers\n- ListMetadataFormats\n- ListRecords\n- ListSets\n\nSupported Filters\n^^^^^^^^^^^^^^^^^\n\n- from\n- until\n- set\n\nPaging\n^^^^^^\n\n- resumptionToken\n\n.. _`OGC API - Records - Part 1: Core`: https://docs.ogc.org/is/20-004r1/20-004r1.html\n.. _`OGC API - Records - Part 2: Facets`: https://docs.ogc.org/DRAFTS/25-013.html\n.. _`OGC API - Records - Part 3: Create, Replace, Update, Delete, Harvest`: https://docs.ogc.org/DRAFTS/25-015.html\n.. _`OGC API - Records - Part 4: Federated Search`: https://github.com/opengeospatial/ogcapi-records/blob/master/extensions/federated-search/document.adoc\n.. _`OGC API - Features - Part 3: Filtering`: http://docs.ogc.org/DRAFTS/19-079.html\n.. _`Common Query Language (CQL2)`: https://docs.ogc.org/DRAFTS/21-065.html\n.. _`OGC CSW`: https://www.ogc.org/standards/cat\n.. _`ISO Metadata Application Profile 1.0.0`: https://portal.ogc.org/files/?artifact_id=21460\n.. _`OGC Filter`: https://www.ogc.org/standards/filter\n.. _`OGC OWS Common`: https://www.ogc.org/standards/common\n.. _`OGC GML`: https://www.ogc.org/standards/gml\n.. _`OGC SFSQL`: https://www.ogc.org/standards/sfs\n.. _`Dublin Core`: https://www.dublincore.org/\n.. _`OGC CITE CSW`: https://github.com/opengeospatial/ets-csw202\n.. _`OGC GeoRSS`: http://docs.opengeospatial.org/cs/17-002r1/17-002r1.html\n.. _`SOAP`: https://www.w3.org/TR/soap/\n.. _`INSPIRE Discovery Services 3.0`: https://inspire.jrc.ec.europa.eu/documents/Network_Services/TechnicalGuidance_DiscoveryServices_v3.0.pdf\n.. _`ISO 19115`: https://www.iso.org/iso/catalogue_detail.htm?csnumber=26020\n.. _`ISO 19139`: https://www.iso.org/iso/catalogue_detail.htm?csnumber=32557\n.. _`ISO 19119`: https://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=39890\n.. _`NASA DIF`: https://earthdata.nasa.gov/esdis/eso/standards-and-references/directory-interchange-format-dif-standard\n.. _`FGDC CSDGM`: https://www.fgdc.gov/metadata/csdgm-standard\n.. _`FGDC CSDGM Application Profile for CSW 2.0`: https://portal.ogc.org/files/?artifact_id=16936\n.. _`SRU`: https://www.loc.gov/standards/sru\n.. _`OGC OpenSearch`: https://www.ogc.org/standards/opensearchgeo\n.. _`GeoNode`: https://geonode.org/\n.. _`HHypermap`: https://github.com/cga-harvard/HHypermap\n.. _`Open Data Catalog`: https://github.com/azavea/Open-Data-Catalog/\n.. _`CKAN`: https://ckan.org/\n.. _`Compliant`: https://www.ogc.org/resource/products/details/?pid=1374\n.. _`OAI-PMH`: https://www.openarchives.org/pmh/\n.. _`GM03`: https://www.geocat.admin.ch/en/dokumentation/gm03.html\n.. _`OGC API - Features - Part 4: Create, Replace, Update and Delete`: https://cnn.com\n.. _`DataCite`: https://schema.datacite.org/meta/kernel-4.3/\n.. _`OGC API Publish-Subscribe Workflow - Part 1: Core`: https://docs.ogc.org/DRAFTS/25-030.html\n.. _`STAC API`: https://github.com/radiantearth/stac-api-spec\n\n"
},
{
"path": "docs/json.rst",
"content": ".. _json:\n\nJSON Support\n============\n\nOGC API - Records\n-----------------\n\npycsw fully supports the OGC API - Records JSON conformance class, which is the default\nrepresentation provided.\n\nCSW\n---\n\npycsw supports JSON support for ``DescribeRecord``, ``GetRecords`` and ``GetRecordById`` requests. Adding ``outputFormat=application/json`` to your CSW request will return the response as a JSON representation.\n\n"
},
{
"path": "docs/license.rst",
"content": ".. _license:\n\nLicense\n=======\n\n.. include:: ../LICENSE.txt\n\nDocumentation\n-------------\n\nThe documentation is released under the `Creative Commons Attribution 4.0 International (CC BY 4.0)`_ license.\n\n.. _`Creative Commons Attribution 4.0 International (CC BY 4.0)`: https://creativecommons.org/licenses/by/4.0\n"
},
{
"path": "docs/locale/el/LC_MESSAGES/.gitkeep",
"content": ""
},
{
"path": "docs/locale/fr/LC_MESSAGES/.gitkeep",
"content": ""
},
{
"path": "docs/locale/zh/LC_MESSAGES/administration.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 09:34+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../administration.rst:4\nmsgid \"Administration\"\nmsgstr \"管理\"\n\n#: ../../administration.rst:6\nmsgid \"\"\n\"pycsw administration is handled by the ``pycsw-admin.py`` utility. ``pycsw-\"\n\"admin.py`` is installed as part of the pycsw install process and should be \"\n\"available in your PATH.\"\nmsgstr \"\"\n\"pycsw 管理由 ``pycsw-admin.py`` 实用程序处理。 ``pycsw-admin.py`` 是作为 pycsw \"\n\"安装过程的一部分安装的，可在PATH 中可用。\"\n\n#: ../../administration.rst:11\nmsgid \"\"\n\"Run ``pycsw-admin.py --help`` to see all administration operations and \"\n\"parameters\"\nmsgstr \"运行 ``pycsw-admin.py -h`` 以查看所有的管理操作与参数\"\n\n#: ../../administration.rst:14\nmsgid \"Metadata Repository Setup\"\nmsgstr \"元数据存储库设置\"\n\n#: ../../administration.rst:16\nmsgid \"pycsw supports the following databases:\"\nmsgstr \"pycsw支持以下数据库：\"\n\n#: ../../administration.rst:18\nmsgid \"SQLite3\"\nmsgstr \"SQLite3\"\n\n#: ../../administration.rst:19\nmsgid \"PostgreSQL (without PostGIS)\"\nmsgstr \"PostgreSQL (无 PostGIS)\"\n\n#: ../../administration.rst:20\nmsgid \"PostgreSQL with PostGIS enabled\"\nmsgstr \"启用 PostGIS 的 PostgreSQL\"\n\n#: ../../administration.rst:21\nmsgid \"MySQL\"\nmsgstr \"MySQL\"\n\n#: ../../administration.rst:24\nmsgid \"\"\n\"The easiest and fastest way to deploy pycsw is to use SQLite3 as the backend.\"\nmsgstr \"部署 pycsw 最简单、最快的方法是使用 SQLite3 作为后端。\"\n\n#: ../../administration.rst:27\nmsgid \"PostgreSQL support includes support for PostGIS functions if enabled\"\nmsgstr \"PostgreSQL 支持包括对 PostGIS 功能的支持（如果启用）\"\n\n#: ../../administration.rst:30\nmsgid \"\"\n\"If PostGIS is activated before setting up the pycsw/PostgreSQL database, then \"\n\"native PostGIS geometries will be enabled.\"\nmsgstr \"\"\n\"如果在设置 pycsw/PostgreSQL 数据库之前激活 PostGIS，则将启用本机 PostGIS \"\n\"geometries。\"\n\n#: ../../administration.rst:32\nmsgid \"\"\n\"To expose your geospatial metadata via pycsw, perform the following actions:\"\nmsgstr \"通过 pycsw 发布地理空间元数据，执行以下操作：\"\n\n#: ../../administration.rst:34\nmsgid \"setup the database\"\nmsgstr \"创建数据库\"\n\n#: ../../administration.rst:35\nmsgid \"import metadata\"\nmsgstr \"导入元数据\"\n\n#: ../../administration.rst:36\nmsgid \"publish the repository\"\nmsgstr \"存储库发布\"\n\n#: ../../administration.rst:39\nmsgid \"Supported Information Models\"\nmsgstr \"支持的信息模型\"\n\n#: ../../administration.rst:41\nmsgid \"\"\n\"By default, pycsw's API supports the core OARec and CSW Record information \"\n\"models. From the database perspective, the pycsw metadata model is loosely \"\n\"based on ISO 19115 and is able to transform to other formats as part of \"\n\"transformation during OARec/CSW requests.\"\nmsgstr \"\"\n\"默认情况下，pycsw 的 API 支持核心是 OARec 和 CSW Record 信息模型。从数据库的角度\"\n\"来看，pycsw 元数据模型松散地基于 ISO 19115，并且能够在 OARec/CSW 请求期间转换为\"\n\"其他格式作为转换的一部分。\"\n\n#: ../../administration.rst:46\nmsgid \"See :ref:`profiles` for information on enabling profiles\"\nmsgstr \"请参见 :ref:`profiles` 查看有关配置文件的信息\"\n\n#: ../../administration.rst:49\nmsgid \"Setting up the Database\"\nmsgstr \"创建数据库\"\n\n#: ../../administration.rst:55\nmsgid \"This will create the necessary tables and values for the repository.\"\nmsgstr \"这将为存储库创建必要的表与值。\"\n\n#: ../../administration.rst:57\nmsgid \"\"\n\"The database created is an `OGC SFSQL`_ compliant database, and can be used \"\n\"with any implementing software. For example, to use with `GDAL`_:\"\nmsgstr \"\"\n\"创建的数据库是兼容 `OGC SFSQL`_ 的，此数据库可应用于任何实现（相关标准的）软件。\"\n\"例如， `OGR`_ :创建的数据库是符合“OGC SFSQL”的数据库，可与任何实施软件一起使用。\"\n\"例如，与 `GDAL`_ 一起使用：\"\n\n#: ../../administration.rst:69\nmsgid \"\"\n\"If PostGIS is detected, the ``pycsw-admin.py`` script does not create the SFSQL \"\n\"tables as they are already in the database.\"\nmsgstr \"\"\n\"如检测到PostGIS， pycsw-admin.py 脚本就不会再创建 SFSQL 表，因为数据库中已经存在\"\n\"了。\"\n\n#: ../../administration.rst:73\nmsgid \"Loading Records\"\nmsgstr \"加载记录\"\n\n#: ../../administration.rst:79\nmsgid \"\"\n\"This will import all ``*.xml`` records from ``/path/to/records`` into the \"\n\"database specified in ``default.yml`` (``repository.database``). Passing ``-\"\n\"r`` to the script will process ``/path/to/records`` recursively. Passing ``-\"\n\"y`` to the script will force overwrite existing metadata with the same \"\n\"identifier. Note that ``-p`` accepts either a directory path or single file.\"\nmsgstr \"\"\n\"这时所有的 ``*.xml`` 记录就会从 ``/path/to/records`` 导入到 ``default.yml`` 中指\"\n\"定的数据库 (``repository.database``)。将 ``-r`` 传递到脚本中， 程序 ``/path/to/\"\n\"records`` 就会递归运行。将 ``-y`` 传递到脚本中， 程序 ``/path/to/records`` 将强\"\n\"制替换现有的相同元数据标识符。请注意， ``-p`` 只能接受一个目录路径或单个文件。\"\n\n#: ../../administration.rst:82\nmsgid \"Records can also be imported using CSW-T (see :ref:`transactions`).\"\nmsgstr \"记录也可以使用 CSW-T导入 （请查看 :ref:`transactions` ）。\"\n\n#: ../../administration.rst:85\nmsgid \"Exporting the Repository\"\nmsgstr \"导出数据库\"\n\n#: ../../administration.rst:91\nmsgid \"\"\n\"This will write each record in the database specified in ``default.yml`` \"\n\"(``repository.database``) to an XML document on disk, in directory ``/path/to/\"\n\"output_dir``.\"\nmsgstr \"\"\n\"这会将 ``default.yml`` (``repository.database``) 中指定的数据库的每条记录写入磁\"\n\"盘上的 ``/path/to/output_dir`` 目录中的 XML 文档。\"\n\n#: ../../administration.rst:94\nmsgid \"Optimizing the Database\"\nmsgstr \"优化数据库\"\n\n#: ../../administration.rst:102\nmsgid \"This feature is relevant only for PostgreSQL and MySQL\"\nmsgstr \"此特性只适用于 PostgreSQL和MySQL\"\n\n#: ../../administration.rst:105\nmsgid \"Deleting Records from the Repository\"\nmsgstr \"从存储库中删除记录\"\n\n#: ../../administration.rst:111\nmsgid \"This will empty the repository of all records.\"\nmsgstr \"数据库中的所有记录都会被清空。\"\n\n#: ../../administration.rst:114\nmsgid \"Database Specific Notes\"\nmsgstr \"数据库特别需要注意的是\"\n\n#: ../../administration.rst:117\nmsgid \"PostgreSQL\"\nmsgstr \"PostgreSQL\"\n\n#: ../../administration.rst:119\nmsgid \"\"\n\"To enable the database user must be able to create functions within the database.\"\nmsgstr \"\"\n\"在PostgreSQL支持下，用户必须在数据\"\n\n#: ../../administration.rst:120\nmsgid \"\"\n\"`PostgreSQL Full Text Search`_ is supported for ``csw:AnyText`` based queries. \"\n\"pycsw creates a tsvector column based on the text from anytext column. Then \"\n\"pycsw creates a GIN index against the anytext_tsvector column. This is created \"\n\"automatically in ``pycsw.core.repository.setup``. Any query against OARec's ``q`` \"\n\"parameter or CSW `csw:AnyText` or `apiso:AnyText` will process using PostgreSQL \"\n\"FTS handling\"\nmsgstr \"\"\n\"`PostgreSQL Full Text Search`_ (全文搜索)支持基于 ``csw:AnyText`` （任意文本）的\"\n\"查询。pycsw创建的tsvector栏是基于文本anytext栏。然而pycsw针对\"\n\"anytext_tsvector（任意文本）栏创建了GIN索引。这在 ``pycsw.core.repository.setup`` 是自\"\n\"动生成的。任何针对 `csw:AnyText` or `apiso:AnyText` 的查询都是使用PostgreSQL FT\"\n\"进行处理\"\n\n#: ../../administration.rst:123\nmsgid \"PostGIS\"\nmsgstr \"PostGIS\"\n\n#: ../../administration.rst:125\nmsgid \"\"\n\"pycsw makes use of PostGIS spatial functions and native geometry data type.\"\nmsgstr \"pycsw使用的是PostGIS空间功能和本地 geometry数据类型.\"\n\n#: ../../administration.rst:126\nmsgid \"\"\n\"It is advised to install the PostGIS extension before setting up the pycsw \"\n\"database\"\nmsgstr \"建议在创建pycsw数据库前先安装PostGIS扩展信息\"\n\n#: ../../administration.rst:127\nmsgid \"\"\n\"If PostGIS is detected, the ``pycsw-admin.py`` script will create both a native \"\n\"geometry column and a WKT column, as well as a trigger to keep both synchronized\"\nmsgstr \"\"\n\"如果PostGIS被监测到，脚本pycsw-admin.py既会在本地 geometry栏创建，也会在WKT栏创\"\n\"建，以及触发器，来保持两者的同步。\"\n\n#: ../../administration.rst:128\nmsgid \"\"\n\"In case PostGIS gets disabled, pycsw will continue to work with the `WKT`_ \"\n\"column\"\nmsgstr \"一旦PostGIS被禁用，pycsw将继续与 `WKT`_ 栏一起运行\"\n\n#: ../../administration.rst:129\nmsgid \"\"\n\"In case of migration from plain PostgreSQL database to PostGIS, the spatial \"\n\"functions of PostGIS will be used automatically\"\nmsgstr \"如果plain PostgreSQL数据库移入PostGIS中，PostGIS的空间功能将自行启动\"\n\n#: ../../administration.rst:130\nmsgid \"\"\n\"When migrating from plain PostgreSQL database to PostGIS, in order to enable \"\n\"native geometry support, a \\\"GEOMETRY\\\" column named \\\"wkb_geometry\\\" needs to \"\n\"be created manually (along with the update trigger in ``pycsw.core.repository.\"\n\"setup``). Also the native geometries must be filled manually from the `WKT`_ \"\n\"field. Next versions of pycsw will automate this process\"\nmsgstr \"\"\n\"当从普通的数据库plain PostgreSQL移入PostGIS时， 为了启用本地geometry支持，需要手\"\n\"动创建一个名为 \\\"wkb_geometry\\\" 的 \\\"GEOMETRY\\\" 列（随着 ``pycsw.core.repository.\"\n\"setup`` 一起更新）。本地geometries也必须在 `WKT`_ 中手动填充。pycsw的下一个版\"\n\"本就会将此过程自动化运行\"\n\n#: ../../administration.rst:135\nmsgid \"Mapping to an Existing Repository\"\nmsgstr \"映射到现有的存储库\"\n\n#: ../../administration.rst:137\nmsgid \"\"\n\"pycsw supports publishing metadata from an existing repository. To enable this \"\n\"functionality, the default database mappings must be modified to represent the \"\n\"existing database columns mapping to the abstract core model (the default \"\n\"mappings are in ``pycsw/config.py:MD_CORE_MODEL``).\"\nmsgstr \"\"\n\"pycsw支持在现在的存储库中发布元数据。为了启用此功能，必须修改默认数据库映射以表\"\n\"示映射到抽象核心模型的现有数据库列（默认的眏射方式在 ``pycsw/config.py:\"\n\"MD_CORE_MODEL`` 中）\"\n\n#: ../../administration.rst:139\nmsgid \"To override the default settings:\"\nmsgstr \"覆盖默认的配置：\"\n\n#: ../../administration.rst:141\nmsgid \"define a custom database mapping based on ``etc/mappings.py``\"\nmsgstr \"定于基于 ``etc/mappings.py`` 数据库映射\"\n\n#: ../../administration.rst:142\nmsgid \"\"\n\"in ``default.yml``, set ``repository.mappings`` to the location of the mappings.\"\n\"py file:\"\nmsgstr \"\"\n\"在 ``default.yml`` 中，设置 ``repository.mappings`` 为 mappings.py 文件的位置：\"\n\n#: ../../administration.rst:150\nmsgid \"Note you can also reference mappings as a Python object as a dotted path:\"\nmsgstr \"注意，还可以将映射作为Python对象引用为虚线路径：\"\n\n#: ../../administration.rst:159\nmsgid \"\"\n\"See the :ref:`geonode`, :ref:`hhypermap`, and :ref:`odc` for further examples.\"\nmsgstr \"请参照 :ref:`geonode` ， :ref:`hhypermap` 和 :ref:`odc` 查看更多示例。\"\n\n#: ../../administration.rst:162\nmsgid \"Existing Repository Requirements\"\nmsgstr \"现有的存储需求\"\n\n#: ../../administration.rst:164\nmsgid \"\"\n\"pycsw requires certain repository attributes and semantics to exist in any \"\n\"repository to operate as follows:\"\nmsgstr \"pycsw需要在任何存储库中存在某些存储库属性和语义，以便按照以下方式操作:\"\n\n#: ../../administration.rst:166\nmsgid \"``pycsw:Identifier``: unique identifier\"\nmsgstr \"``pycsw:Identifier``：唯一的标识符\"\n\n#: ../../administration.rst:167\nmsgid \"\"\n\"``pycsw:Typename``: typename for the metadata; typically the value of the root \"\n\"element tag (e.g. ``csw:Record``, ``gmd:MD_Metadata``)\"\nmsgstr \"\"\n\"``pycsw:Typename``: 元数据的类型名；典型的根标签值（例如 ``csw:Record`` , ``gmd:\"\n\"MD_Metadata`` ）\"\n\n#: ../../administration.rst:168\nmsgid \"\"\n\"``pycsw:Schema``: schema for the metadata; typically the target namespace (e.g. \"\n\"``http://www.opengis.net/cat/csw/2.0.2``, ``http://www.isotc211.org/2005/gmd``)\"\nmsgstr \"\"\n\"``pycsw:Schema``: 元数据图表；典型的目标名称空间（例如 ``http://www.opengis.net/\"\n\"cat/csw/2.0.2`` , ``http://www.isotc211.org/2005/gmd`` ）\"\n\n#: ../../administration.rst:169\nmsgid \"``pycsw:InsertDate``: date of insertion\"\nmsgstr \"``pycsw:InsertDate`` : 插入日期\"\n\n#: ../../administration.rst:170\nmsgid \"``pycsw:XML``: full XML representation\"\nmsgstr \"``pycsw:XML`` :完整的XML表现形式\"\n\n#: ../../administration.rst:171\nmsgid \"\"\n\"``pycsw:AnyText``: bag of XML element text values, used for full text search. \"\n\"Realized with the following design pattern:\"\nmsgstr \"\"\n\"``pycsw:AnyText`` : XML元素文件值包，用于完整的文本搜索。采用以下设计模式实现：\"\n\n#: ../../administration.rst:173\nmsgid \"capture all XML element and attribute values\"\nmsgstr \"获取所有的XML元素与属性值\"\n\n#: ../../administration.rst:174\nmsgid \"store in repository\"\nmsgstr \"存储数据库\"\n\n#: ../../administration.rst:175\nmsgid \"``pycsw:BoundingBox``: string of `WKT`_ or `EWKT`_ geometry\"\nmsgstr \"``pycsw:BoundingBox`` ： `WKT`_ or `EWKT`_ geometry字符串\"\n\n#: ../../administration.rst:177\nmsgid \"The following repository semantics exist if the attributes are specified:\"\nmsgstr \"如果指定了属性，则存在以下存储库语义：\"\n\n#: ../../administration.rst:179\nmsgid \"``pycsw:Keywords``: comma delimited list of keywords\"\nmsgstr \"``pycsw:Keywords`` ： 以逗号分隔的关键字列表\"\n\n#: ../../administration.rst:180\nmsgid \"\"\n\"``pycsw:Links``: Text field of JSON list of objects with properties ``name``, \"\n\"``description``, ``protocol``, ``url``\"\nmsgstr \"\"\n\"``pycsw:Links``：具有属性 ``name``，``description``，``protocol``，``url`` 的对\"\n\"象的JSON列表的文本字段\"\n\n#: ../../administration.rst:194\nmsgid \"The ``pycsw:Links`` field should be a text type, not a JSON object type\"\nmsgstr \"``pycsw:Links`` 字段应该是文本类型，而不是 JSON 对象类型\"\n\n#: ../../administration.rst:196\nmsgid \"\"\n\"``pycsw:Bands``: Text field of JSON list of dicts with properties: ``name``, \"\n\"``units``, ``min``, ``max``\"\nmsgstr \"\"\n\"``pycsw:Bands``：具有属性的 JSON 列表的文本字段：``name``，``units``，``min``，\"\n\"``max``\"\n\n#: ../../administration.rst:210\nmsgid \"The ``pycsw:Bands`` field should be a text type, not a JSON object type\"\nmsgstr \"``pycsw:Bands`` 字段应该是文本类型，而不是 JSON 对象类型\"\n\n#: ../../administration.rst:212\nmsgid \"Values of mappings can be derived from the following mechanisms:\"\nmsgstr \"映射值由以下的结构获得：\"\n\n#: ../../administration.rst:214\nmsgid \"text fields\"\nmsgstr \"文本域\"\n\n#: ../../administration.rst:215\nmsgid \"Python datetime.datetime or datetime.date objects\"\nmsgstr \"Python ``datetime.datetime`` 或 ``datetime.date`` 对象\"\n\n#: ../../administration.rst:216\nmsgid \"Python functions\"\nmsgstr \"Python 功能\"\n\n#: ../../administration.rst:218\nmsgid \"Further information is provided in ``pycsw/config.py:MD_CORE_MODEL``.\"\nmsgstr \"在 ``pycsw/config.py:MD_CORE_MODEL`` 中可获得更多资料。\"\n\n#~ msgid \"By default, pycsw supports the ``csw:Record`` information model.\"\n#~ msgstr \"默认情况下，pycsw支持 ``csw:Record`` 信息模型。\"\n\n#~ msgid \"\"\n#~ \"``pycsw:Links``: structure of links in the format \\\"name,description,\"\n#~ \"protocol,url[^,,,[^,,,]]\\\"\"\n#~ msgstr \"\"\n#~ \"``pycsw:Links`` ： 链接的格式结构 \\\"name,description,protocol,url[^,,,\"\n#~ \"[^,,,]]\\\" \"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/api.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2015, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2016.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.1-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 09:44+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../api.rst:4\nmsgid \"API\"\nmsgstr \"API\"\n\n#: ../../api.rst:6\nmsgid \"\"\n\"Python applications can integrate pycsw into their custom workflows. \"\n\"This allows for seamless integate within frameworks such as Flask and \"\n\"Django.\"\nmsgstr \"\"\n\"Python应用可以在自己的工作流中集成 pycsw 。这样就允许在 Flask与 Django 这\"\n\"样的框架中无缝集成。\"\n\n#: ../../api.rst:9\nmsgid \"\"\n\"Below are examples of where using the API (as opposed to the default \"\n\"WSGI/CGI services could be used:\"\nmsgstr \"下面是一些使用API的示例（相对于默认的WSGI/CGI服务，可以使用:\"\n\n#: ../../api.rst:12\nmsgid \"configuration based on a Python dict, or stored in a database\"\nmsgstr \"基于Python字典 进行配置，或存储在数据库中\"\n\n#: ../../api.rst:13\nmsgid \"downstream request environment / framework (Flask, Django)\"\nmsgstr \"下游请求环境/框架（Flask，Django）\"\n\n#: ../../api.rst:14\nmsgid \"authentication or authorization logic\"\nmsgstr \"认证或授权逻辑\"\n\n#: ../../api.rst:15\nmsgid \"forcing CSW version 2.0.2 as default\"\nmsgstr \"强制使用 CSW 版本2.0.2作为默认值\"\n\n#: ../../api.rst:18\nmsgid \"OARec Flask Example\"\nmsgstr \"OARec Flask 示例\"\n\n#: ../../api.rst:20\nmsgid \"\"\n\"See https://github.com/geopython/pycsw/blob/master/pycsw/wsgi_flask.py \"\n\"for how to implement a Flask wrapper atop all pycsw supported APIs. \"\n\"Note the use of Flask blueprints to enable integration with downstream \"\n\"Flask applications.\"\nmsgstr \"\"\n\"请参阅 https://github.com/geopython/pycsw/blob/master/pycsw/wsgi_flask.\"\n\"py 了解如何在所有 pycsw 支持的 API 上实现 Flask 包装器。请注意使用 Flask \"\n\"蓝图来实现与下游 Flask 应用程序的集成。\"\n\n#: ../../api.rst:25\nmsgid \"Simple Flask blueprint example\"\nmsgstr \"简单的 Flask 蓝图示例\"\n\n#: ../../api.rst:43\nmsgid \"\"\n\"In the above example, all pycsw endpoints are made available under \"\n\"``http://localhost:8000/oapi``.\"\nmsgstr \"\"\n\"在上面的示例中，所有 pycsw 端点都在 http://localhost:8000/oapi 下可用。\"\n\n#: ../../api.rst:46\nmsgid \"Simple CSW Flask Example\"\nmsgstr \"简单的 CSW Flask 示例\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/ckan.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 09:48+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../ckan.rst:4\nmsgid \"CKAN Configuration\"\nmsgstr \"CKAN配置\"\n\n#: ../../ckan.rst:6\nmsgid \"\"\n\"CKAN (https://ckan.org) is a powerful data management system that makes \"\n\"data accessible – by providing tools to streamline publishing, sharing, \"\n\"finding and using data. CKAN is aimed at data publishers (national and \"\n\"regional governments, companies and organizations) wanting to make their \"\n\"data open and available.\"\nmsgstr \"\"\n\"CKAN (http://ckan.org)是一个功能强大的数据管理系统，该系统提高了数据可访\"\n\"问性，通过提供工具来简化发布、共享、发现和使用数据。CKAN的目的在于使他们\"\n\"变成数据开放并可用的数据发布者（国家和地方政府、公司和组织）。\"\n\n#: ../../ckan.rst:8\nmsgid \"\"\n\"`ckanext-spatial`_ is CKAN's geospatial extension. The extension adds a \"\n\"spatial field to the default CKAN dataset schema, using PostGIS as the \"\n\"backend. This allows to perform spatial queries and display the dataset \"\n\"extent on the frontend. It also provides harvesters to import geospatial \"\n\"metadata into CKAN from other sources, as well as commands to support \"\n\"the CSW standard. Finally, it also includes plugins to preview spatial \"\n\"formats such as GeoJSON.\"\nmsgstr \"\"\n\"`ckanext 空间`_ 是 CKAN 的地理空间扩展。此功能扩展将空间的字段添加到默认\"\n\"的 CKAN 数据集架构中，使用 PostGIS 作为后端。这允许执行空间查询并在前端显\"\n\"示数据集范围。它还提供了将地理空间元数据从其他来源导入 CKAN 的采集器，以\"\n\"及支持 CSW 标准的命令。最后，它还包括用于预览空间格式的插件，例如 \"\n\"GeoJSON。\"\n\n#: ../../ckan.rst:11\nmsgid \"CKAN Setup\"\nmsgstr \"CKAN设置\"\n\n#: ../../ckan.rst:13\nmsgid \"\"\n\"Installation and configuration Instructions are provided as part of the \"\n\"ckanext-spatial `documentation`_.\"\nmsgstr \"安装和配置说明作为 ckanext-spatial `documentation`_ 的一部分提供。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/committers.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2016-05-28 11:27+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 09:50+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=UTF-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.3.4\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../committers.rst:4\nmsgid \"Committers\"\nmsgstr \"提交者，执行者，管理员\"\n\n#: ../../../COMMITTERS.txt:2\nmsgid \"Login(s)\"\nmsgstr \"登录\"\n\n#: ../../../COMMITTERS.txt:2\nmsgid \"Name\"\nmsgstr \"名字\"\n\n#: ../../../COMMITTERS.txt:2\nmsgid \"Email / Contact\"\nmsgstr \"联系方式/邮件\"\n\n#: ../../../COMMITTERS.txt:2\nmsgid \"Area(s)\"\nmsgstr \"区域\"\n\n#: ../../../COMMITTERS.txt:4\nmsgid \"tomkralidis\"\nmsgstr \"tomkralidis\"\n\n#: ../../../COMMITTERS.txt:4\nmsgid \"Tom Kralidis\"\nmsgstr \"Tom Kralidis\"\n\n#: ../../../COMMITTERS.txt:4\nmsgid \"tomkralidis at gmail.com\"\nmsgstr \"tomkralidis at gmail.com\"\n\n#: ../../../COMMITTERS.txt:4 ../../../COMMITTERS.txt:7\nmsgid \"Overall\"\nmsgstr \"总计\"\n\n#: ../../../COMMITTERS.txt:5\nmsgid \"kalxas\"\nmsgstr \"kalxas\"\n\n#: ../../../COMMITTERS.txt:5\nmsgid \"Angelos Tzotsos\"\nmsgstr \"Angelos Tzotsos\"\n\n#: ../../../COMMITTERS.txt:5\nmsgid \"tzotsos at gmail.com\"\nmsgstr \"tzotsos at gmail.com\"\n\n#: ../../../COMMITTERS.txt:5\nmsgid \"INSPIRE, APISO profiles, Packaging\"\nmsgstr \"INSPIRE, APISO profiles, Packaging\"\n\n#: ../../../COMMITTERS.txt:6\nmsgid \"adamhinz\"\nmsgstr \"adamhinz\"\n\n#: ../../../COMMITTERS.txt:6\nmsgid \"Adam Hinz\"\nmsgstr \"Adam Hinz\"\n\n#: ../../../COMMITTERS.txt:6\nmsgid \"hinz dot adam at gmail.com\"\nmsgstr \"hinz dot adam at gmail.com\"\n\n#: ../../../COMMITTERS.txt:6\nmsgid \"WSGI/Server Deployment\"\nmsgstr \"WSGI/服务器部署\"\n\n#: ../../../COMMITTERS.txt:7\nmsgid \"ricardogsilva\"\nmsgstr \"ricardogsilva\"\n\n#: ../../../COMMITTERS.txt:7\nmsgid \"Ricardo Garcia Silva\"\nmsgstr \"Ricardo Garcia Silva\"\n\n#: ../../../COMMITTERS.txt:7\nmsgid \"ricardo.garcia.silva at gmail.com\"\nmsgstr \"ricardo.garcia.silva at gmail.com\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/configuration.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 10:27+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../configuration.rst:4\nmsgid \"Configuration\"\nmsgstr \"配置\"\n\n#: ../../configuration.rst:6\nmsgid \"\"\n\"pycsw's runtime configuration is defined by ``default.yml``. pycsw ships with \"\n\"a `sample configuration`_ (``default-sample.yml``). Copy the file to ``default.\"\n.yml`` and edit the following:\"\nmsgstr \"\"\n\"pycsw 的运行配置写为此格式 ``default.yml`` 。 pycsw 还有一个示例配置 \"\n\"( ``default-sample.yml`` )。 将文件复制到 ``default.yml`` 并编辑以下内容：\"\n\n#: ../../configuration.rst:8\nmsgid \"**[server]**\"\nmsgstr \"**[server]**\"\n\n#: ../../configuration.rst:10\nmsgid \"**home**: the full filesystem path to pycsw\"\nmsgstr \"**home**: pycsw 的完整文件系统路径\"\n\n#: ../../configuration.rst:11\nmsgid \"**url**: the URL of the resulting service\"\nmsgstr \"**url**: 生成服务器的网址\"\n\n#: ../../configuration.rst:12\nmsgid \"**mimetype**: the MIME type when returning HTTP responses\"\nmsgstr \"**mimetype**： 当HTTP响应时的MIME型\"\n\n#: ../../configuration.rst:13\nmsgid \"\"\n\"**language**: the ISO 639-1 language and ISO 3166-1 alpha2 country code of the \"\n\"service (e.g. ``en-CA``, ``fr-CA``, ``en-US``)\"\nmsgstr \"\"\n\"**language**: ISO 639-1 语言和 ISO 3166-1 α2服务器上的国家/地区代码 （例如 ``en-\"\n\"CA`` 、``fr-CA``、 ``EN-US`` ）\"\n\n#: ../../configuration.rst:14\nmsgid \"\"\n\"**encoding**: the content type encoding (e.g. ``ISO-8859-1``, see https://docs.\"\n\"python.org/2/library/codecs.html#standard-encodings). Default value is 'UTF-8'\"\nmsgstr \"\"\n\"**encoding**: 编码的内容类别 (例如 ``ISO-8859-1``，见 https://docs.python.org/2/\"\n\"library/codecs.html#standard-encodings ) 。 默认值是 'UTF-8'\"\n\n#: ../../configuration.rst:15\nmsgid \"\"\n\"**maxrecords**: the maximum number of records to return by default. This value \"\n\"is enforced if a CSW's client's ``maxRecords`` parameter is greater than \"\n\"``server.maxrecords`` to limit capacity. See :ref:`maxrecords-handling` for \"\n\"more information\"\nmsgstr \"\"\n\"**maxrecords**: 默认情况下再次浏览记录的最大数目。如果CSW客户端的 \"\n\"``maxRecords`` 参数大于 ``server.maxrecords`` ，此值就会被强制性限制。 请参见 :\"\n\"ref:`maxrecords-handling` 的详细信息\"\n\n#: ../../configuration.rst:16\nmsgid \"\"\n\"**loglevel**: the logging level (see https://docs.python.org/library/logging.\"\n\"html#logging-levels)\"\nmsgstr \"\"\n\"**loglevel**：日志级别（参见 https://docs.python.org/library/logging.\"\n\"html#logging-levels）\"\n\n#: ../../configuration.rst:17\nmsgid \"**logfile**: the full file path to the logfile\"\nmsgstr \"**logfile**：日志文件的完整文件系统路径\"\n\n#: ../../configuration.rst:18\nmsgid \"\"\n\"**ogc_schemas_base**: base URL of OGC XML schemas tree file structure (default \"\n\"is http://schemas.opengis.net)\"\nmsgstr \"\"\n\"**ogc_schemas_base**: OGC XML 模型文件结构树的网址库 (默认 http://schemas.\"\n\"opengis.net)\"\n\n#: ../../configuration.rst:19\nmsgid \"\"\n\"**federatedcatalogues**: comma delimited list of CSW endpoints to be used for \"\n\"distributed searching, if requested by the client (see :ref:\"\n\"`distributedsearching`)\"\nmsgstr \"\"\n\"**federatedcatalogues**: 如果客户端有用户请求加入时， CSW端以逗号分隔的列表就会\"\n\"用于分布式搜索 (请参阅 :ref:`distributedsearching` )\"\n\n#: ../../configuration.rst:20\nmsgid \"\"\n\"**pretty_print**: whether to pretty print the output (``true`` or ``false``). \"\n\"Default is ``false``\"\nmsgstr \"\"\n\"**pretty_print**: 输出的（ ``true`` or ``false`` ）来确认是否要优质打印。 默认值\"\n\"为 ``false``\"\n\n#: ../../configuration.rst:21\nmsgid \"\"\n\"**gzip_compresslevel**: gzip compression level, lowest is ``1``, highest is \"\n\"``9``. Default is off. **NOTE**: if gzip compression is already enabled via \"\n\"your web server, do not enable this directive (or else the server will try to \"\n\"compress the response twice, resulting in degraded performance)\"\nmsgstr \"\"\n\"**gzip_compresslevel**：gzip 压缩级别，最低为 ``1``，最高为 ``9``。默认为关闭。 \"\n\"**注意**：如果 gzip 压缩已通过您的 Web 服务器启用，请不要启用此指令（否则服务器\"\n\"将尝试压缩响应两次，从而导致性能下降）\"\n\n#: ../../configuration.rst:22\nmsgid \"\"\n\"**domainquerytype**: for GetDomain operations, how to output domain values. \"\n\"Accepted values are ``list`` and ``range`` (min/max). Default is ``list``\"\nmsgstr \"\"\n\"**domainquerytype**: 在GetDomain中应当如何输出域值。 公认的域值有 ``list`` 和 \"\n\"``range`` （最小/最大）。默认值是 ``list`` \"\n\n#: ../../configuration.rst:23\nmsgid \"\"\n\"**domaincounts**: for GetDomain operations, whether to provide frequency counts \"\n\"for values. Accepted values are ``true`` and ``False``. Default is ``false``\"\nmsgstr \"\"\n\"**domaincounts**：在GetDomain中，是否要提供频率计数值的操作。目前的值有 \"\n\"``true`` 和 ``false`` 。默认值为 ``false``\"\n\n#: ../../configuration.rst:24\nmsgid \"\"\n\"**profiles**: comma delimited list of profiles to load at runtime (default is \"\n\"none). See :ref:`profiles`\"\nmsgstr \"\"\n\"**profiles**: 是否在运行时加载以逗号分隔的配置文件列表（默认为无）。 请参见 :\"\n\"ref:`profiles`\"\n\n#: ../../configuration.rst:25\nmsgid \"\"\n\"**smtp_host**: SMTP host for processing ``csw:ResponseHandler`` parameter via \"\n\"outgoing email requests (default is ``localhost``)\"\nmsgstr \"\"\n\"**smtp_host**： SMTP 主机（默认为' 本地主机 '）通过发送电子邮件请求的方式处理 \"\n\"``csw:ResponseHandler`` 参数\"\n\n#: ../../configuration.rst:26\nmsgid \"\"\n\"**spatial_ranking**: parameter that enables (``true`` or ``false``) ranking of \"\n\"spatial query results as per `K.J. Lanfear 2006 - A Spatial Overlay Ranking \"\n\"Method for a Geospatial Search of Text Objects `_.\"\nmsgstr \"\"\n\"**spatial_ranking**: 是否在对空间搜索的结果进行排名的一项参数（ ``true`` 或 \"\n\"``false`` ），此排名参数在每 `K.J. Lanfear 2006 文本对象空间搜索的一个空间覆盖排\"\n\"名方法 `_ 。\"\n\n#: ../../configuration.rst:27\nmsgid \"\"\n\"**workers**: set the number of workers used by the wsgi server when lunching \"\n\"pycsw using the provided docker/entrypoint.py. If not set, it will use 2 \"\n\"workers as Default.\"\nmsgstr \"\"\n\"**workers**：使用提供的 docker/entrypoint.py 设置午餐 pycsw 时 wsgi 服务器使用的\"\n\"工人数量。如果未设置，它将使用 2 个工人作为默认值。\"\n\n#: ../../configuration.rst:29\nmsgid \"**[manager]**\"\nmsgstr \"**[manager]**\"\n\n#: ../../configuration.rst:31\nmsgid \"\"\n\"**transactions**: whether to enable transactions (``true`` or ``false``). \"\n\"Default is ``false`` (see :ref:`transactions`)\"\nmsgstr \"\"\n\"**transactions**: 是否可以交易 （ ``true`` 或 ``false`` ）。 默认值为否 (请参\"\n\"阅 :ref:`transactions` )\"\n\n#: ../../configuration.rst:32\nmsgid \"\"\n\"**allowed_ips**: comma delimited list of IP addresses (e.g. 192.168.0.103), \"\n\"wildcards (e.g. 192.168.0.*) or CIDR notations (e.g. 192.168.100.0/24) allowed \"\n\"to perform transactions (see :ref:`transactions`)\"\nmsgstr \"\"\n\"**allowed_ips**: IP 地址 (如 192.168.0.103)、 通配符 (如 192.168.0.*) 或 CIDR 表\"\n\"示法 (例如 192.168.100.0/24) 以逗号分隔的列表允许执行交易 (请参见 :ref:\"\n\"`transactions` ）\"\n\n#: ../../configuration.rst:33\nmsgid \"\"\n\"**csw_harvest_pagesize**: when harvesting other CSW servers, the number of \"\n\"records per request to page by (default is 10)\"\nmsgstr \"\"\n\"**csw_harvest_pagesize**: 当收集其它CSW服务器时，每项请求的记录数都会显示在各页\"\n\"中 （每页默认的数量为 10）\"\n\n#: ../../configuration.rst:35\nmsgid \"**[metadata:main]**\"\nmsgstr \"**[metadata:main]**\"\n\n#: ../../configuration.rst:37\nmsgid \"**identification_title**: the title of the service\"\nmsgstr \"**identification_title**： 服务项目标题\"\n\n#: ../../configuration.rst:38\nmsgid \"**identification_abstract**: some descriptive text about the service\"\nmsgstr \"**identification_abstract**: 一些有关该服务的描述性文本\"\n\n#: ../../configuration.rst:39\nmsgid \"\"\n\"**identification_keywords**: comma delimited list of keywords about the service\"\nmsgstr \"**identification_keywords**: 以逗号分隔的服务器有关的关键字列表\"\n\n#: ../../configuration.rst:40\nmsgid \"\"\n\"**identification_keywords_type**: keyword type as per the `ISO 19115 \"\n\"MD_KeywordTypeCode codelist `_). Accepted values are ``discipline``, \"\n\"``temporal``, ``place``, ``theme``, ``stratum``\"\nmsgstr \"\"\n\"**identification_keywords_type**: 每 `ISO 19115 MD_KeywordTypeCode codelist \"\n\"`_ )的关键字类型。接受的值是 ``纪律``, ``时间``, ``地点\"\n\"``, ``主题``, ``地层``\"\n\n#: ../../configuration.rst:41\nmsgid \"**identification_fees**: fees associated with the service\"\nmsgstr \"**identification_fees**: 与服务有关的费用\"\n\n#: ../../configuration.rst:42\nmsgid \"\"\n\"**identification_accessconstraints**: access constraints associated with the \"\n\"service\"\nmsgstr \"**identification_accessconstraints**: 访问与该服务相关的限制条目\"\n\n#: ../../configuration.rst:43\nmsgid \"**provider_name**: the name of the service provider\"\nmsgstr \"**provider_name**: 服务提供者的名字\"\n\n#: ../../configuration.rst:44\nmsgid \"**provider_url**: the URL of the service provider\"\nmsgstr \"**provider_url**: 服务提供者的网址\"\n\n#: ../../configuration.rst:45\nmsgid \"**contact_name**: the name of the provider contact\"\nmsgstr \"**provider_name**: 服务提供者联系人\"\n\n#: ../../configuration.rst:46\nmsgid \"**contact_position**: the position title of the provider contact\"\nmsgstr \"**contact_position**:提供者联系人的职位名称\"\n\n#: ../../configuration.rst:47\nmsgid \"**contact_address**: the address of the provider contact\"\nmsgstr \"**contact_address**: 提供者联系人的地址\"\n\n#: ../../configuration.rst:48\nmsgid \"**contact_city**: the city of the provider contact\"\nmsgstr \"**contact_city**：提供者联系人所在城市\"\n\n#: ../../configuration.rst:49\nmsgid \"\"\n\"**contact_stateorprovince**: the province or territory of the provider contact\"\nmsgstr \"**contact_stateorprovince**: 提供者联系人所在省份或更详细地址\"\n\n#: ../../configuration.rst:50\nmsgid \"**contact_postalcode**: the postal code of the provider contact\"\nmsgstr \"**contact_postalcode**: 提供者联系人所在地区的邮政编码\"\n\n#: ../../configuration.rst:51\nmsgid \"**contact_country**: the country of the provider contact\"\nmsgstr \"**contact_country**: 提供者联系人所在国籍\"\n\n#: ../../configuration.rst:52\nmsgid \"**contact_phone**: the phone number of the provider contact\"\nmsgstr \"**contact_phone**: 提供者联系人的电话号码\"\n\n#: ../../configuration.rst:53\nmsgid \"**contact_fax**: the facsimile number of the provider contact\"\nmsgstr \"**contact_fax**: 提供者联系人的传真号码\"\n\n#: ../../configuration.rst:54\nmsgid \"**contact_email**: the email address of the provider contact\"\nmsgstr \"**contact_email**: 提供者联系人的电子邮件地址\"\n\n#: ../../configuration.rst:55\nmsgid \"**contact_url**: the URL to more information about the provider contact\"\nmsgstr \"**contact_url**: 提供者联系人的详细URL\"\n\n#: ../../configuration.rst:56\nmsgid \"**contact_hours**: the hours of service to contact the provider\"\nmsgstr \"**contact_hours**: 提供者联系人的服务时间\"\n\n#: ../../configuration.rst:57\nmsgid \"**contact_instructions**: the how to contact the provider contact\"\nmsgstr \"**contact_instructions**: 如何与提供者取得联系\"\n\n#: ../../configuration.rst:58\nmsgid \"\"\n\"**contact_role**: the role of the provider contact as per the `ISO 19115 \"\n\"CI_RoleCode codelist `_). Accepted values are ``author``, \"\n\"``processor``, ``publisher``, ``custodian``, ``pointOfContact``, \"\n\"``distributor``, ``user``, ``resourceProvider``, ``originator``, ``owner``, \"\n\"``principalInvestigator``\"\nmsgstr \"\"\n\"**contact_role**: 在 `ISO 19115 CI_RoleCode codelist `_ )有每位提供者联系人\"\n\"的职务。可接受的值包括 ``作者``、``处理器``、``发布者``、``保管人``、\"\n\"``pointOfContact``、``分发者``、``用户``、``资源提供者``，``发起人``，``所有者\"\n\"``，``主要调查员``\"\n\n#: ../../configuration.rst:60\nmsgid \"**[repository]**\"\nmsgstr \"**[repository]**\"\n\n#: ../../configuration.rst:62\nmsgid \"\"\n\"**database**: the full file path to the metadata database, in database URL \"\n\"format (see https://docs.sqlalchemy.org/en/latest/core/engines.html#database-\"\n\"urls)\"\nmsgstr \"\"\n\"**database**：元数据库中完整的文件路径，采用数据库URL格式（见 http://docs.\"\n\"sqlalchemy.org/en/latest/core/engines.html#database-urls ）\"\n\n#: ../../configuration.rst:63\nmsgid \"\"\n\"**table**: the table name for metadata records (default is ``records``). If \"\n\"you are using PostgreSQL with a DB schema other than ``public``, qualify the \"\n\"table like ``myschema.table``\"\nmsgstr \"\"\n\"**table**：元数据记录的表名（默认为 ``records``）。如果在使用除了 ``public`` 以\"\n\"外的DB模式PostgreSQL，表格就会被限定，如 ``myschema.table``\"\n\n#: ../../configuration.rst:64\nmsgid \"**mappings**: custom repository mappings (see :ref:`custom_repository`)\"\nmsgstr \"**mappings**：自定义的映射库（请参见 :ref:`custom_repository` ）\"\n\n#: ../../configuration.rst:65\nmsgid \"\"\n\"**source**: the source of this repository only if not local (e.g. :ref:\"\n\"`geonode`, :ref:`odc`). Supported values are ``geonode``, ``odc``\"\nmsgstr \"\"\n\"**source**：不在本地的数据库源（例如：请参考 :ref:`geonode` ， :ref:`odc` ）。现\"\n\"有值为`geonode`，`odc`\"\n\n#: ../../configuration.rst:66\nmsgid \"\"\n\"**filter**: server side database filter to apply as mask to all CSW requests \"\n\"(see :ref:`repofilters`)\"\nmsgstr \"\"\n\"**filter**：服务器端的数据库过滤器，适用所有CSW请求掩码（请参阅： :ref:\"\n\"`repofilters`）\"\n\n#: ../../configuration.rst:67\nmsgid \"\"\n\"**max_retries**: max number of retry attempts when connecting to records-\"\n\"repository database\"\nmsgstr \"**max_retries**：连接到记录存储库数据库时的最大重试次数\"\n\n#: ../../configuration.rst:71\nmsgid \"\"\n\"See :ref:`administration` for connecting your metadata repository and supported \"\n\"information models.\"\nmsgstr \"请参阅： :ref:`administration` ，用于连接元数据信息库和支持信息模型。\"\n\n#: ../../configuration.rst:76\nmsgid \"MaxRecords Handling\"\nmsgstr \"MaxRecords 处理\"\n\n#: ../../configuration.rst:78\nmsgid \"\"\n\"The The following describes how ``maxRecords`` is handled by the configuration \"\n\"when handling OARec items or CSW ``GetRecords`` requests:\"\nmsgstr \"\"\n\"以下描述了在处理 OARec 项目或 CSW 的 ``GetRecords`` 请求时配置如何处理 \"\n\"``maxRecords`` ：\"\n\n#: ../../configuration.rst:1\nmsgid \"server.maxrecords\"\nmsgstr \"server.maxrecords\"\n\n#: ../../configuration.rst:1\nmsgid \"OARec limit/CSW GetRecords.maxRecords\"\nmsgstr \"OARec 限制/CSW GetRecords.maxRecords\"\n\n#: ../../configuration.rst:1\nmsgid \"Result\"\nmsgstr \"结果\"\n\n#: ../../configuration.rst:1\nmsgid \"none set\"\nmsgstr \"未设定\"\n\n#: ../../configuration.rst:1\nmsgid \"none passed\"\nmsgstr \"未通过\"\n\n#: ../../configuration.rst:1\nmsgid \"10 (CSW default)\"\nmsgstr \"10 （CSW 默认值）\"\n\n#: ../../configuration.rst:1\nmsgid \"20\"\nmsgstr \"20\"\n\n#: ../../configuration.rst:1\nmsgid \"14\"\nmsgstr \"14\"\n\n#: ../../configuration.rst:1\nmsgid \"100\"\nmsgstr \"100\"\n\n#: ../../configuration.rst:1\nmsgid \"200\"\nmsgstr \"200\"\n\n#: ../../configuration.rst:92\nmsgid \"Using environment variables in configuration files\"\nmsgstr \"在配置文件中使用环境变量\"\n\n#: ../../configuration.rst:94\nmsgid \"\"\n\"pycsw configuration supports using system environment variables, which can be \"\n\"helpful for deploying into `12 factor `_ environments \"\n\"for example.\"\nmsgstr \"\"\n\"pycsw 配置支持使用系统环境变量，例如有助于部署到 `12 factor `_ 环境中。\"\n\n#: ../../configuration.rst:97\nmsgid \"\"\n\"Below is an example of how to integrate system environment variables in pycsw:\"\nmsgstr \"下面是一个如何在pycsw中集成系统环境变量的例子：\"\n\n#: ../../configuration.rst:107\nmsgid \"Alternate Configurations\"\nmsgstr \"备用配置\"\n\n#: ../../configuration.rst:109\nmsgid \"\"\n\"By default, pycsw loads ``default.yml`` at runtime. To load an alternate \"\n\"configuration, modify ``csw.py`` to point to the desired configuration. \"\n\"Alternatively, pycsw supports explicitly specifiying a configuration by \"\n\"appending ``config=/path/to/default.yml`` to the base URL of the service (e.g. \"\n\"``http://localhost/pycsw/csw.py?config=tests/suites/default/default.\"\n.yml&service=CSW&version=2.0.2&request=GetCapabilities``). When the ``config`` \"\n\"parameter is passed by a CSW client, pycsw will override the default \"\n\"configuration location and subsequent settings with those of the specified \"\n\"configuration.\"\nmsgstr \"\"\n\"默认情况下，pycsw在运行时加载的是 ``default.yml`` 。要加载备用配置，请修改 \"\n\"``csw.py`` 以指向所需的配置。另外，pycsw还可以通过附加 ``config=/path/to/\"\n\"default.yml`` 到服务器的基础URL来显式定义配置，例如 ``http://localhost/pycsw/\"\n\"csw.py?config=tests/suites/default/default.\"\n.yml&service=CSW&version=2.0.2&request=GetCapabilities`` 。当 ``config`` 参数通过\"\n\"CSW客户端时，pycsw就会覆盖默认的配置所在地址，并且用这些指定的配置来完成接下来的\"\n\"一系列设置。\"\n\n#: ../../configuration.rst:111\nmsgid \"\"\n\"This also provides the functionality to deploy numerous CSW servers with a \"\n\"single pycsw installation.\"\nmsgstr \"这还提供了通过单个 pycsw 安装部署大量 CSW 服务器的功能。\"\n\n#: ../../configuration.rst:114\nmsgid \"Hiding the Location\"\nmsgstr \"隐藏的位置\"\n\n#: ../../configuration.rst:116\nmsgid \"\"\n\"Some deployments with alternate configurations prefer not to advertise the base \"\n\"URL with the ``config=`` approach. In this case, there are many options to \"\n\"advertise the base URL.\"\nmsgstr \"\"\n\"一些具有备用配置的部署不喜欢使用 config= 方法公布基 URL。 在这种情况下，有许多选\"\n\"项可以宣传基 URL。\"\n\n#: ../../configuration.rst:119\nmsgid \"Environment Variables\"\nmsgstr \"环境变量\"\n\n#: ../../configuration.rst:121\nmsgid \"pycsw supports the following environment variables:\"\nmsgstr \"pycsw 支持以下环境变量：\"\n\n#: ../../configuration.rst:123\nmsgid \"``PYCSW_CONFIG``: specifies the filepath to a pycsw configuraiton\"\nmsgstr \"``PYCSW CONFIG``: 指定 pycsw 配置的文件路径\"\n\n#: ../../configuration.rst:127\nmsgid \"Configuration file location\"\nmsgstr \"配置文件位置\"\n\n#: ../../configuration.rst:129\nmsgid \"\"\n\"One option is using Apache's ``Alias`` and ``SetEnvIf`` directives. For \"\n\"example, given the base URL ``http://localhost/pycsw/csw.py?config=foo.yml``, \"\n\"set the following in your Apache configuration:\"\nmsgstr \"\"\n\"有一种选择是使用 Apache 的 ``Alias`` 和 ``SetEnvIf`` 指令。 例如，可以指定基 \"\n\"URL ``http://localhost/pycsw/csw.py?config=foo.yml`` ，在 Apache 的 ``httpd.\"\n\"conf`` 下配置以下指令:\"\n\n#: ../../configuration.rst:138\nmsgid \"Apache must be restarted after changes to configuration\"\nmsgstr \"更改配置后必须重新启动 Apache\"\n\n#: ../../configuration.rst:140\nmsgid \"\"\n\"pycsw will use the configuration as set in the ``PYCSW_CONFIG`` environment \"\n\"variable in the same manner as if it was specified in the base URL. Note that \"\n\"the configuration value ``server.url`` value must match the ``Request_URI`` \"\n\"value so as to advertise correctly in pycsw's Capabilities XML.\"\nmsgstr \"\"\n\"pycsw 将以同样的方式配置设置 ``PYCSW_CONFIG`` 的环境变量，就如同它在基 URL 中指\"\n\"定了一样。 请注意，配置值 ``server.url`` 值必须匹配 ``Request_URI`` 值，这样在 \"\n\"pycsw 的功能 XML 中就可以做正确声明了。\"\n\n#: ../../configuration.rst:143\nmsgid \"Wrapper Script\"\nmsgstr \"包装器脚本\"\n\n#: ../../configuration.rst:145\nmsgid \"\"\n\"Another option is to write a simple wrapper (e.g. ``csw-foo.sh``), which \"\n\"provides the same functionality and can be deployed without restarting Apache:\"\nmsgstr \"\"\n\"另一个选择是编写一个简单的包装器 (如 ``csw-foo.sh`` )，也会有相同的功能，而且无\"\n\"需重新启动 Apache 也可以部署:\"\n\n#~ msgid \"\"\n#~ \"**gzip_compresslevel**: gzip compression level, lowest is ``1``, highest is \"\n#~ \"``9``. Default is off\"\n#~ msgstr \"\"\n#~ \"**gzip_compresslevel**: 压缩级别，最低是 ``1`` ，最高是 ``9`` 。 默认值是不\"\n#~ \"压缩\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/contributing.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 15:36+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../../CONTRIBUTING.rst:2\nmsgid \"Contributing to pycsw\"\nmsgstr \"pycsw的贡献\"\n\n#: ../../../CONTRIBUTING.rst:4\nmsgid \"\"\n\"The pycsw project openly welcomes contributions (bug reports, bug fixes, \"\n\"code enhancements/features, etc.). This document will outline some \"\n\"guidelines on contributing to pycsw. As well, the pycsw `community \"\n\"`_ is a great place to get an idea of how \"\n\"to connect and participate in pycsw community and development.\"\nmsgstr \"\"\n\"Pycsw 项目是开源的，欢迎贡献 （bug 报告、 bug 修复、 代码增强功能等）。此\"\n\"篇文章将概述pycsw 的一些作用。 pycsw `community `_ ，就是提供一些建议，应该如何连接和参与 pycsw 社区，并如何更\"\n\"好地发展。\"\n\n#: ../../../CONTRIBUTING.rst:9\nmsgid \"pycsw has the following modes of contribution:\"\nmsgstr \"以下是几项pycsw做出的贡献:\"\n\n#: ../../../CONTRIBUTING.rst:11 ../../../CONTRIBUTING.rst:25\nmsgid \"GitHub Commit Access\"\nmsgstr \"GitHub 提交修改的权限\"\n\n#: ../../../CONTRIBUTING.rst:12 ../../../CONTRIBUTING.rst:33\nmsgid \"GitHub Pull Requests\"\nmsgstr \"GitHub 的请求\"\n\n#: ../../../CONTRIBUTING.rst:15\nmsgid \"Code of Conduct\"\nmsgstr \"行为准则\"\n\n#: ../../../CONTRIBUTING.rst:17\nmsgid \"\"\n\"Contributors to this project are expected to act respectfully toward \"\n\"others in accordance with the `OSGeo Code of Conduct `_.\"\nmsgstr \"\"\n\"本项目的贡献者应按照`OSGeo 行为准则`_ 以尊重他人的方式行事。\"\n\n#: ../../../CONTRIBUTING.rst:20\nmsgid \"Contributions and Licensing\"\nmsgstr \"贡献和许可\"\n\n#: ../../../CONTRIBUTING.rst:22\nmsgid \"\"\n\"Contributors are asked to confirm that they comply with project `license \"\n\"`_ \"\n\"guidelines.\"\nmsgstr \"\"\n\"贡献者应当符合 `许可证 `_ 准则。\"\n\n#: ../../../CONTRIBUTING.rst:27\nmsgid \"\"\n\"proposals to provide developers with GitHub commit access shall be \"\n\"emailed to the pycsw-devel `mailing list`_. Proposals shall be approved \"\n\"by the pycsw development team. Committers shall be added by the project \"\n\"admin\"\nmsgstr \"\"\n\"建议开发人员提供 GitHub 的提交访问权限，此权限应通过电子邮件发送到pycsw-\"\n\"devel `mailing list`_。希望 pycsw 开发团队可以允许。应由项目管理员处添加\"\n\"访问者\"\n\n#: ../../../CONTRIBUTING.rst:28\nmsgid \"removal of commit access shall be handled in the same manner\"\nmsgstr \"应以同样的方式解除提交访问权限\"\n\n#: ../../../CONTRIBUTING.rst:29\nmsgid \"\"\n\"each committer must send an email to the pycsw mailing list agreeing to \"\n\"the license guidelines (see `Contributions and Licensing Agreement \"\n\"Template <#contributions-and-licensing-agreement-template>`_). **This \"\n\"is only required once**\"\nmsgstr \"\"\n\"每个提交的用户必须发送电子邮件到 pycsw 邮件列表中，前得是同意许可证准则 \"\n\"（见 `贡献和许可协议模板 <#contributions-and-licensing-agreement-\"\n\"template>`_ ）。**只需一次即可**\"\n\n#: ../../../CONTRIBUTING.rst:30\nmsgid \"\"\n\"each committer shall be listed in https://github.com/geopython/pycsw/\"\n\"blob/master/COMMITTERS.txt\"\nmsgstr \"\"\n\"每个提交的用户会显示在 https://github.com/geopython/pycsw/blob/master/\"\n\"COMMITTERS.txt 列表中\"\n\n#: ../../../CONTRIBUTING.rst:35\nmsgid \"\"\n\"pull requests can provide agreement to license guidelines as text in the \"\n\"pull request or via email to the pycsw `mailing list`_ (see \"\n\"`Contributions and Licensing Agreement Template <#contributions-and-\"\n\"licensing-agreement-template>`_). **This is only required for a \"\n\"contributor's first pull request. Subsequent pull requests do not \"\n\"require this step**\"\nmsgstr \"\"\n\"pull 请求可以提供协议许可准则，在pull请求时可作为文本，也可以电邮至 \"\n\"pycsw 邮件列表 （见 `贡献和许可协议模板<#contributions-and-licensing-\"\n\"agreement-template>`_ ）。**这只需要在第一次Pull请求时使用。后续的请求不\"\n\"需要此步骤**\"\n\n#: ../../../CONTRIBUTING.rst:36\nmsgid \"\"\n\"pull requests may include copyright in the source code header by the \"\n\"contributor if the contribution is significant or the contributor wants \"\n\"to claim copyright on their contribution\"\nmsgstr \"\"\n\"如果有重大贡献或贡献者想要申请版权专利，pull请求可以将源代码设置权限\"\n\n#: ../../../CONTRIBUTING.rst:37\nmsgid \"\"\n\"all contributors shall be listed at https://github.com/geopython/pycsw/\"\n\"graphs/contributors\"\nmsgstr \"\"\n\"所有贡献者均在 https://github.com/geopython/pycsw/graphs/contributors 列\"\n\"表中\"\n\n#: ../../../CONTRIBUTING.rst:38\nmsgid \"\"\n\"unclaimed copyright, by default, is assigned to the main copyright \"\n\"holders as specified in https://github.com/geopython/pycsw/blob/master/\"\n\"LICENSE.txt\"\nmsgstr \"\"\n\"若无人声明版权所属，在默认情况下，会指定分配给主要的版权持有人，在 \"\n\"https://github.com/geopython/pycsw/blob/master/LICENSE.txt 中强调指出\"\n\n#: ../../../CONTRIBUTING.rst:41\nmsgid \"Contributions and Licensing Agreement Template\"\nmsgstr \"贡献和许可协议模板\"\n\n#: ../../../CONTRIBUTING.rst:43\nmsgid \"\"\n\"``Hi all, I'd like to contribute to pycsw. I confirm that my contributions to pycsw will be \"\n\"compatible with the pycsw license guidelines at the time of contribution.\"\n\"``\"\nmsgstr \"\"\n\"``大家好，我愿意在pycsw贡献 。我\"\n\"确认对pycsw的贡献将与pycsw 许可指南兼容。``\"\n\n#: ../../../CONTRIBUTING.rst:49\nmsgid \"GitHub\"\nmsgstr \"GitHub\"\n\n#: ../../../CONTRIBUTING.rst:51\nmsgid \"\"\n\"Code, tests, documentation, wiki and issue tracking are all managed on \"\n\"GitHub. Make sure you have a `GitHub account `_.\"\nmsgstr \"\"\n\"代码，测试，文档，wiki和问题都在GitHub上进行追踪管理，以确保每个人均有一\"\n\"个自己的 `GitHub的账户 `_ 。\"\n\n#: ../../../CONTRIBUTING.rst:55\nmsgid \"Code Overview\"\nmsgstr \"代码概览\"\n\n#: ../../../CONTRIBUTING.rst:57\nmsgid \"\"\n\"the pycsw `wiki `_ documents an overview of the codebase\"\nmsgstr \"\"\n\"在pycsw `维基 `_ 有详细的代码库概述\"\n\n#: ../../../CONTRIBUTING.rst:60\nmsgid \"Documentation\"\nmsgstr \"说明文件\"\n\n#: ../../../CONTRIBUTING.rst:62\nmsgid \"documentation is managed in ``docs/``, in reStructuredText format\"\nmsgstr \"文档在 ``docs/`` 中管理，以 reStructuredText 格式\"\n\n#: ../../../CONTRIBUTING.rst:63\nmsgid \"`Sphinx`_ is used to generate the documentation\"\nmsgstr \"`Sphinx`_ 作用是生成文档\"\n\n#: ../../../CONTRIBUTING.rst:64\nmsgid \"\"\n\"See the `reStructuredText Primer `_ on rST markup and syntax.\"\nmsgstr \"\"\n\"请参阅关于 rST 标记和语法的 `reStructuredText Primer `_。\"\n\n#: ../../../CONTRIBUTING.rst:67\nmsgid \"Bugs\"\nmsgstr \"漏洞\"\n\n#: ../../../CONTRIBUTING.rst:69\nmsgid \"\"\n\"pycsw's `issue tracker `_ is \"\n\"the place to report bugs or request enhancements. To submit a bug be \"\n\"sure to specify the pycsw version you are using, the appropriate \"\n\"component, a description of how to reproduce the bug, as well as what \"\n\"version of Python and platform. For convenience, you can run ``pycsw-\"\n\"admin.py get-sysprof`` and copy/paste the output into your issue.\"\nmsgstr \"\"\n\"pycsw 的 `问题跟踪器 `_ ，是报\"\n\"告错误或要求改进的地方。当提交出现的错误时，一定要指定正在使用的pycsw版\"\n\"本，相应的组件，如何操作显示的错误信息，以及Python和平台的版本。为方便起\"\n\"见，可运行 ``pycsw-admin.py -c get_sysprof``，并将输出信息复制、粘贴到问\"\n\"题中。\"\n\n#: ../../../CONTRIBUTING.rst:72\nmsgid \"Forking pycsw\"\nmsgstr \"分叉pycsw\"\n\n#: ../../../CONTRIBUTING.rst:74\nmsgid \"\"\n\"Contributions are most easily managed via GitHub pull requests. `Fork \"\n\"`_ pycsw into your own GitHub \"\n\"repository to be able to commit your work and submit pull requests.\"\nmsgstr \"\"\n\"通过 GitHub pull 请求后，贡献是最容易管理的。'Fork ' _ pycsw 放到自己 GitHub 存储库中，这样可以轻松地提\"\n\"交工作，并提交pull请求。\"\n\n#: ../../../CONTRIBUTING.rst:78\nmsgid \"Development\"\nmsgstr \"开发\"\n\n#: ../../../CONTRIBUTING.rst:81\nmsgid \"GitHub Commit Guidelines\"\nmsgstr \"GitHub 提交指南\"\n\n#: ../../../CONTRIBUTING.rst:83\nmsgid \"enhancements and bug fixes should be identified with a GitHub issue\"\nmsgstr \"增强和 bug 修复应该等同于 GitHub 问题\"\n\n#: ../../../CONTRIBUTING.rst:84\nmsgid \"\"\n\"commits should be granular enough for other developers to understand the \"\n\"nature / implications of the change(s)\"\nmsgstr \"提交时粒数应该足够量，为方便其他开发人员了解自然/变化的影响（S）\"\n\n#: ../../../CONTRIBUTING.rst:85\nmsgid \"\"\n\"non-trivial Git commits shall be associated with a GitHub issue. As \"\n\"documentation can always be improved, tickets need not be opened for \"\n\"improving the docs\"\nmsgstr \"\"\n\"若是重大事件的 Git 提交应与 GitHub 问题部门取得联系。以文档格式是可以修改\"\n\"的，但修改文档的tickets则是不必公开的\"\n\n#: ../../../CONTRIBUTING.rst:86\nmsgid \"Git commits shall include a description of changes\"\nmsgstr \"Git 提交应包括更改说明\"\n\n#: ../../../CONTRIBUTING.rst:87\nmsgid \"\"\n\"Git commits shall include the GitHub issue number (i.e. ``#1234``) in \"\n\"the Git commit log message\"\nmsgstr \"Git 提交应在Git 提交日志中写入 GitHub 问题编号 (例如 ``#1234`` )\"\n\n#: ../../../CONTRIBUTING.rst:88\nmsgid \"\"\n\"all enhancements or bug fixes must successfully pass all :ref:`ogc-cite` \"\n\"tests before they are committed\"\nmsgstr \"\"\n\"在提交之前，所有应改进的或错误修改的必须通过所有 :ref:`ogc-cite` 测试\"\n\n#: ../../../CONTRIBUTING.rst:89\nmsgid \"\"\n\"all enhancements or bug fixes must successfully pass all :ref:`tests` \"\n\"tests before they are committed\"\nmsgstr \"在提交之前，所有应改进的或错误修改的必须通过所有 :ref:`tests` 测试\"\n\n#: ../../../CONTRIBUTING.rst:90\nmsgid \"\"\n\"enhancements which can be demonstrated from the pycsw :ref:`tests` \"\n\"should be accompanied by example CSW request XML\"\nmsgstr \"pycsw加强的部分请参考 :ref:`tests` ，应附有像CSW的 请求 XML\"\n\n#: ../../../CONTRIBUTING.rst:93\nmsgid \"Coding Guidelines\"\nmsgstr \"编码准则\"\n\n#: ../../../CONTRIBUTING.rst:95\nmsgid \"pycsw instead of PyCSW, pyCSW, Pycsw\"\nmsgstr \"写法应是pycsw，而不是 PyCSW, pyCSW，Pycsw\"\n\n#: ../../../CONTRIBUTING.rst:96\nmsgid \"always code with `PEP 8`_ conventions\"\nmsgstr \"应是 `PEP 8`_ 公约代码\"\n\n#: ../../../CONTRIBUTING.rst:97\nmsgid \"\"\n\"always run source code through `flake8`_ and `pylint`_, using all pylint \"\n\"defaults except for ``C0111``. ``sbin/pycsw-pylint.sh`` is included for \"\n\"convenience\"\nmsgstr \"\"\n\"始终通过 `flake8`_ 和 `pylint`_ 运行源代码，使用除 `C0111` 之外的所有 \"\n\"pylint 默认值。为方便起见，包含了``sbin/pycsw-pylint.sh``\"\n\n#: ../../../CONTRIBUTING.rst:98\nmsgid \"\"\n\"for exceptions which make their way to OGC ``ExceptionReport`` XML, \"\n\"always specify the appropriate ``locator`` and ``code`` parameters\"\nmsgstr \"\"\n\"除了OGC ``ExceptionReport`` XML运行方式为个别例外，通常会指定合适的 ``定\"\n\"位器`` 和 ``代码`` 参数\"\n\n#: ../../../CONTRIBUTING.rst:102\nmsgid \"Submitting a Pull Request\"\nmsgstr \"提交pull请求\"\n\n#: ../../../CONTRIBUTING.rst:104\nmsgid \"\"\n\"This section will guide you through steps of working on pycsw. This \"\n\"section assumes you have forked pycsw into your own GitHub repository.\"\nmsgstr \"\"\n\"这一节将指导操作pycsw的步骤。本节假定在自己GitHub资料库中，有分叉的 \"\n\"pycsw。\"\n\n#: ../../../CONTRIBUTING.rst:128\nmsgid \"\"\n\"Your changes are now visible on your pycsw repository on GitHub. You \"\n\"are now ready to create a pull request. A member of the pycsw team will \"\n\"review the pull request and provide feedback / suggestions if required. \"\n\"If changes are required, make them against the same branch and push as \"\n\"per above (all changes to the branch in the pull request apply).\"\nmsgstr \"\"\n\"更改在 GitHub自己的 pycsw 存储库为可见状态。现在要创建pull请求。Pycsw的团\"\n\"队成员将审查你的pull请求，若有需要，团队成员会提供反馈建议。如果需要改\"\n\"动，要另立分支，并push以上步骤 （pull请求中所有更改的分支）。\"\n\n#: ../../../CONTRIBUTING.rst:132\nmsgid \"\"\n\"The pull request will then be merged by the pycsw team. You can then \"\n\"delete your local branch (on GitHub), and then update your own \"\n\"repository to ensure your pycsw repository is up to date with pycsw \"\n\"master:\"\nmsgstr \"\"\n\"然后pycsw 团队将合并pull请求。可删除掉本地的分支（在 GitHub)，更新自己的\"\n\"库，以确保pycsw 存储库与pycsw总站是同步的:\"\n\n#~ msgid \"\"\n#~ \"for trivial commits that do not need `Travis CI `_ to run, include ``[ci skip]`` as part of the \"\n#~ \"commit message\"\n#~ msgstr \"\"\n#~ \"如果是一些琐碎的提交，就像是 ``[ci skip]`` 也是做为提交消息的一部分，\"\n#~ \"则不需要运行 `Travis CI `_ \"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/csw-support.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2015, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2016.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.1-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2018-12-05 22:08+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 10:38+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.6.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../csw-support.rst:4\nmsgid \"CSW Support\"\nmsgstr \"CSW支持\"\n\n#: ../../csw-support.rst:7\nmsgid \"Versions\"\nmsgstr \"版本\"\n\n#: ../../csw-support.rst:9\nmsgid \"\"\n\"pycsw supports both CSW 2.0.2 and 3.0.0 versions by default. In \"\n\"alignment with the CSW specifications, the default version returned is \"\n\"the latest supported version. That is, pycsw will always behave like a \"\n\"3.0.0 CSW unless the client explicitly requests a 2.0.2 CSW.\"\nmsgstr \"\"\n\"pycsw默认支持CSW 2.0.2和3.0.0版本。根据CSW规范，返回的默认版本是受支持的\"\n\"最新版本。也就是说，除非客户机明确地请求一个2.0.2 CSW，否则pycsw的行为始\"\n\"终类似于一个3.0.0 CSW.\"\n\n#: ../../csw-support.rst:14\nmsgid \"\"\n\"The sample URLs below provide examples of how requests behaves against \"\n\"various/missing/default version parameters.\"\nmsgstr \"下面的示例 URLs提供了请求对不同/丢失/默认版本参数的行为的示例。\"\n\n#: ../../csw-support.rst:25\nmsgid \"Request Examples\"\nmsgstr \"请求实例\"\n\n#: ../../csw-support.rst:27\nmsgid \"\"\n\"The best place to look for sample requests is within the `tests/` \"\n\"directory, which provides numerous examples of all supported APIs and \"\n\"requests.\"\nmsgstr \"\"\n\"查找示例请求的最佳位置是在 `tests/` 目录中，该目录提供了所有支持的 APIs\"\n\"和请求的许多示例。\"\n\n#: ../../csw-support.rst:30\nmsgid \"Additional examples:\"\nmsgstr \"额外的实例:\"\n\n#: ../../csw-support.rst:32\nmsgid \"`Data.gov CSW HowTo v2.0`_\"\nmsgstr \"`Data.gov CSW HowTo v2.0`_\"\n\n#: ../../csw-support.rst:33\nmsgid \"`pycsw Quickstart on OSGeoLive`_\"\nmsgstr \"`pycsw Quickstart on OSGeoLive`_\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/distributedsearching.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 10:43+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../distributedsearching.rst:4\nmsgid \"Distributed Searching\"\nmsgstr \"分布式搜索\"\n\n#: ../../distributedsearching.rst:8\nmsgid \"\"\n\"Distributed search is supported for CSW 2/3 APIs. OARec support will be implemented following \"\n\"guidance from the OARec specification once available.\"\nmsgstr \"CSW 2/3 API 支持分布式搜索。一旦可用，OARec 支持将按照 OARec 规范的指导实施。\"\n\n#: ../../distributedsearching.rst:13\nmsgid \"Your server must be able to make outgoing HTTP requests for this functionality.\"\nmsgstr \"此功能的作用就是可以使你的服务器传出HTTP请求。\"\n\n#: ../../distributedsearching.rst:15\nmsgid \"\"\n\"pycsw has the ability to perform distributed searching against other CSW servers. Distributed \"\n\"searching is disabled by default; to enable, ``server.federatedcatalogues`` must be set. A CSW \"\n\"client must issue a GetRecords request with ``csw:DistributedSearch`` specified, along with an \"\n\"optional ``hopCount`` attribute (see subclause 10.8.4.13 of the CSW specification). When enabled, \"\n\"pycsw will search all specified catalogues and return a unified set of search results to the \"\n\"client. Due to the distributed nature of this functionality, requests will take extra time to \"\n\"process compared to queries against the local repository.\"\nmsgstr \"\"\n\"pycsw与其它CSW服务器不同的是，它有能力自己实现分布式搜索。此分布式搜索默认为禁用；若想启用，必须设置 \"\n\"``server.federatedcatalogues`` 。CSW客户端会发出一个 ``Getrecords`` 指定性请求 ``csw:\"\n\"DistributedSearch`` ，以及一个可选的 ``hopCount`` 属性（见CSW规范中第10.8.4.13 ）。当启用时，pycsw会\"\n\"搜索所有指定的目录并会将一组统一的搜索结果返回给客户端。由于此功能的分布式性质，若要查询本地存储库，\"\n\"请求可能会需要更多的时间来处理。\"\n\n#: ../../distributedsearching.rst:18\nmsgid \"Scenario: Federated Search\"\nmsgstr \"场景：联合搜索\"\n\n#: ../../distributedsearching.rst:20\nmsgid \"\"\n\"pycsw deployment with 3 configurations (CSW-1, CSW-2, CSW-3), subsequently providing three (3) \"\n\"endpoints. Each endpoint is based on an opaque metadata repository (based on theme/place/\"\n\"discipline, etc.). Goal is to perform a single search against all endpoints.\"\nmsgstr \"\"\n\"pycsw部署共有3项配置（CSW-1，CSW-2，CSW-3），同时也会提供3个端点。每个端点是基于一个不透明的元数据信\"\n\"息库（基于主题/地点/学科等）。目标是执行对所有端点一对一的搜索。\"\n\n#: ../../distributedsearching.rst:22\nmsgid \"\"\n\"pycsw realizes this functionality by supporting :ref:`alternate configurations `, and exposes the additional CSW endpoint(s) with the following design pattern:\"\nmsgstr \"\"\n\"pycsw 通过支持 :ref:`alternate configuration ` 来实现此功能，并使用以下设计\"\n\"模式公开额外的 CSW 端点：\"\n\n#: ../../distributedsearching.rst:24\nmsgid \"CSW-1: ``http://localhost/pycsw/csw.py?config=CSW-1.yml``\"\nmsgstr \"CSW-1: ``http://localhost/pycsw/csw.py?config=CSW-1.yml``\"\n\n#: ../../distributedsearching.rst:26\nmsgid \"CSW-2: ``http://localhost/pycsw/csw.py?config=CSW-2.yml``\"\nmsgstr \"CSW-2: ``http://localhost/pycsw/csw.py?config=CSW-2.yml``\"\n\n#: ../../distributedsearching.rst:28\nmsgid \"CSW-3: ``http://localhost/pycsw/csw.py?config=CSW-3.yml``\"\nmsgstr \"CSW-3: ``http://localhost/pycsw/csw.py?config=CSW-3.yml``\"\n\n#: ../../distributedsearching.rst:30\nmsgid \"\"\n\"...where the ``*.yml`` configuration files are configured for each respective metadata repository. \"\n\"The above CSW endpoints can be interacted with as usual.\"\nmsgstr \"\"\n\"只要有 ``*.yml`` 配置文件，就可以为每个元数据存储库进行配置。以上的CSW端点也可以像往常一样进行交互。\"\n\n#: ../../distributedsearching.rst:32\nmsgid \"\"\n\"To federate the discovery of the three (3) portals into a unified search, pycsw realizes this \"\n\"functionality by deploying an additional configuration which acts as the superset of CSW-1, CSW-2, \"\n\"CSW-3:\"\nmsgstr \"\"\n\"将这3个门户联合成统一的搜索，pycsw就可以通过部署超集的CSW-1、 CSW-2、 CSW-3 这些附加配置来实现此功\"\n\"能：\"\n\n#: ../../distributedsearching.rst:34\nmsgid \"CSW-all: ``http://localhost/pycsw/csw.py?config=CSW-all.yml``\"\nmsgstr \"所有的CSW: ``http://localhost/pycsw/csw.py?config=CSW-all.yml``\"\n\n#: ../../distributedsearching.rst:36\nmsgid \"\"\n\"This allows the client to invoke one (1) CSW GetRecords request, in which the CSW endpoint spawns \"\n\"the same GetRecords request to 1..n distributed CSW endpoints. Distributed CSW endpoints are \"\n\"advertised in CSW Capabilities XML via ``ows:Constraint``:\"\nmsgstr \"\"\n\"这允许客户端调用 1 CSW GetRecords 请求，其中CSW端点就会生成相同的GetRecords请求，从1到n分布各个CSW 终\"\n\"结点。分布式CSW端点通过 'ows:Constraint' 在CSW功能 XML上发布广告：\"\n\n#: ../../distributedsearching.rst:50\nmsgid \"\"\n\"...which advertises which CSW endpoint(s) the CSW server will spawn if a distributed search is \"\n\"requested by the client.\"\nmsgstr \"...如果客户端请求分布式搜索，它会通告 CSW 服务器将生成哪些 CSW 端点。\"\n\n#: ../../distributedsearching.rst:52\nmsgid \"in the CSW-all configuration:\"\nmsgstr \"在 CSW-all 配置中：\"\n\n#: ../../distributedsearching.rst:60\nmsgid \"\"\n\"At which point a CSW client request to CSW-all with ``distributedsearch=TRUE``, while specifying an \"\n\"optional ``hopCount``. Query network topology:\"\nmsgstr \"\"\n\"当指定选项 ``hopCount`` 时，CSW客户端就会用 ``distributedsearch=TRUE`` 请求所有的CSW。 查询网络拓扑：\"\n\n#: ../../distributedsearching.rst:78\nmsgid \"\"\n\"As a result, a pycsw deployment in this scenario may be approached on a per 'theme' basis, or at an \"\n\"aggregate level.\"\nmsgstr \"因此，在这个场景中，pycsw 部署就会深入每个 '主题' 的基础部分或总体水平。\"\n\n#: ../../distributedsearching.rst:80\nmsgid \"\"\n\"All interaction in this scenario is local to the pycsw installation, so network performance would \"\n\"not be problematic.\"\nmsgstr \"在这个场景中的所有交互都是在本地pycsw 安装的，所以网络性能的好与坏是不会产生影响的。\"\n\n#: ../../distributedsearching.rst:82\nmsgid \"\"\n\"A very important facet of distributed search is as per Annex B of OGC:CSW 2.0.2. Given that all the \"\n\"CSW endpoints are managed locally, duplicates and infinite looping are not deemed to present an \"\n\"issue.\"\nmsgstr \"\"\n\"分布式搜索的一个非常重要的方面是根据 OGC:CSW 2.0.2 的附件 B。鉴于所有 CSW 端点都在本地管理，重复和无\"\n\"限循环不被视为存在问题。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/docker.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2015, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2018.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.3-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 10:56+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../docker.rst:2\nmsgid \"Docker\"\nmsgstr \"Docker\"\n\n#: ../../docker.rst:5\nmsgid \"Installation\"\nmsgstr \"安装\"\n\n#: ../../docker.rst:7\nmsgid \"\"\n\"pycsw provides an official `Docker`_ image which is made available on both the \"\n\"`geopython Docker Hub`_ and our `GitHub Container Registry`_.\"\nmsgstr \"\"\n\"pycsw 提供了一个官方的 `Docker`_ 镜像，可在 `geopython Docker Hub`_ 和 `GitHub \"\n\"Container Registry`_ 上使用。\"\n\n#: ../../docker.rst:9\nmsgid \"\"\n\"Either ``IMAGE`` can be called with the ``docker`` command, ``geopython/pycsw`` from \"\n\"DockerHub or ``ghcr.io/geophython/pycsw`` from the GitHub Container Registry. \"\n\"Examples below use ``geopython/pygeoapi``.\"\nmsgstr \"\"\n\"可以使用 docker 命令、DockerHub 中的 geopython/pycsw 或 GitHub 容器注册表中的 ghcr.\"\n\"io/geophython/pycsw 调用 IMAGE 。下面的示例使用 ``geopython/pygeoapi``。\"\n\n#: ../../docker.rst:11\nmsgid \"\"\n\"Assuming you already have docker installed, you can get a pycsw instance up and \"\n\"running run with the default built-in configuration:\"\nmsgstr \"假设已经安装了docker，可以通过发出以下命令来启动和运行pycsw实例:\"\n\n#: ../../docker.rst:21\nmsgid \"...then browse to http://localhost:8000\"\nmsgstr \"...然后浏览到 http://localhost:8000\"\n\n#: ../../docker.rst:23\nmsgid \"\"\n\"Docker will retrieve the pycsw image (if needed) and then start a new container \"\n\"listening on port 8000.\"\nmsgstr \"Docker 将检索 pycsw 映像（如果需要），然后在端口 8000 上启动一个新容器。\"\n\n#: ../../docker.rst:26\nmsgid \"\"\n\"The default configuration will run pycsw with an sqlite repository backend loaded \"\n\"with some test data from the CITE test suite. You can use this to take pycsw for a \"\n\"test drive.\"\nmsgstr \"\"\n\"默认配置将运行pycsw, sqlite存储库后端装载来自CITE测试套件的一些测试数据。可使用它来测\"\n\"试pycsw。\"\n\n#: ../../docker.rst:32\nmsgid \"Inspect logs\"\nmsgstr \"检查日志\"\n\n#: ../../docker.rst:34\nmsgid \"\"\n\"The default configuration for the docker image outputs logs to stdout. This is \"\n\"common practice with docker containers and enables the inspection of logs with the \"\n\"``docker logs`` command::\"\nmsgstr \"\"\n\"docker 映像的默认配置将日志输出到标准输出。这是 docker 容器的常见做法，可以使用 \"\n\"docker logs 命令检查日志::\"\n\n#: ../../docker.rst:50\nmsgid \"\"\n\"In order to have pycsw logs being sent to standard output you must set ``server.\"\n\"logfile=`` in the pycsw configuration file.\"\nmsgstr \"\"\n\"为了将pycsw日志发送到标准输出，必须在pycsw配置文件中设置 ``server.logfile=`` 。\"\n\n#: ../../docker.rst:55\nmsgid \"Using pycsw-admin.py\"\nmsgstr \"使用 pycsw-admin.py\"\n\n#: ../../docker.rst:57\nmsgid \"\"\n\"``pycsw-admin.py`` can be executed on a running container by using ``docker exec``::\"\nmsgstr \"``pycsw-admin.py`` 可以使用 ``docker exec`` 在正在运行的容器上执行::\"\n\n#: ../../docker.rst:64\nmsgid \"Running custom pycsw containers\"\nmsgstr \"运行自定义PysCW容器\"\n\n#: ../../docker.rst:67\nmsgid \"pycsw configuration\"\nmsgstr \"pycsw 配置\"\n\n#: ../../docker.rst:69\nmsgid \"\"\n\"It is possible to supply a custom configuration file for pycsw as a bind mount or as \"\n\"a docker secret (in the case of docker swarm). The configuration file is searched at \"\n\"the value of the ``PYCSW_CONFIG`` environmental variable, which defaults to ``/etc/\"\n\"pycsw/pycsw.yml``.\"\nmsgstr \"\"\n\"可以为pycsw提供自定义配置文件作为绑定安装或作为docker秘密（在docker群集的情况下）。配\"\n\"置文件在 ``PYCSW_CONFIG`` 环境变量的值处进行搜索，该环境变量默认为 ``/etc/pycsw/\"\n\"pycsw.yml`` 。\"\n\n#: ../../docker.rst:74\nmsgid \"Supplying the configuration file via bind mount::\"\nmsgstr \"通过绑定挂载提供配置文件::\"\n\n#: ../../docker.rst:83\nmsgid \"Supplying the configuration file via docker secrets::\"\nmsgstr \"通过docker 机密提供配置文件::\"\n\n#: ../../docker.rst:95\nmsgid \"sqlite repositories\"\nmsgstr \"sqlite 存储库\"\n\n#: ../../docker.rst:97\nmsgid \"\"\n\"The default database repository is the CITE database that is used for running \"\n\"pycsw's test suites. Docker volumes may be used to specify a custom sqlite database \"\n\"path. It should be mounted under ``/var/lib/pycsw``::\"\nmsgstr \"\"\n\"默认的数据库存储库是用于运行pycsw测试套件的CITE数据库。Docker卷可以用来指定自定义\"\n\"sqlite数据库路径。它应该安装在 ``/var/lib/pycsw``::\"\n\n#: ../../docker.rst:112\nmsgid \"PostgreSQL repositories\"\nmsgstr \"PostgreSQL存储库\"\n\n#: ../../docker.rst:114\nmsgid \"\"\n\"Specifying a PostgreSQL repository is just a matter of configuring a custom pycsw.\"\n.yml file with the correct specification.\"\nmsgstr \"指定PostgreSQL存储库只是用正确的规范配置自定义pycsw.yml 文件的问题。\"\n\n#: ../../docker.rst:117\nmsgid \"\"\n\"Check `pycsw's github repository`_ for an example of a docker-compose/stack file \"\n\"that spins up a postgis database together with a pycsw instance.\"\nmsgstr \"\"\n\"查看 `pycsw's github repository`_ ，例如 docker-compose/stack文件，该文件将postgis数\"\n\"据库与pycsw实例一起旋转。\"\n\n#: ../../docker.rst:122\nmsgid \"Setting up a development environment with docker\"\nmsgstr \"用docker建立开发环境\"\n\n#: ../../docker.rst:124\nmsgid \"\"\n\"Working on pycsw's code using docker enables an isolated environment that helps \"\n\"ensuring reproducibility while at the same time keeping your base system free from \"\n\"pycsw related dependencies. This can be achieved by:\"\nmsgstr \"\"\n\"使用docker处理pycsw的代码可以实现一个隔离的环境，它有助于确保可重现性,同时使基本系统\"\n\"免受pycsw相关依赖项的影响。这可以通过以下方式实现:\"\n\n#: ../../docker.rst:128\nmsgid \"Cloning pycsw's repository locally;\"\nmsgstr \"在本地克隆 pycsw 的仓库；\"\n\n#: ../../docker.rst:129\nmsgid \"\"\n\"Starting up a docker container with appropriately set up bind mounts. In addition, \"\n\"the pycsw docker image supports a ``reload`` flag that turns on automatic reloading \"\n\"of the gunicorn web server whenever the code changes;\"\nmsgstr \"\"\n\"使用适当的绑定安装启动docker容器。此外，pycsw docker映像支持 ``reload`` 标志，当代码\"\n\"发生变化时，该标志将自动重新加载gunicorn web服务器;\"\n\n#: ../../docker.rst:132\nmsgid \"\"\n\"Installing the development dependencies by using ``docker exec`` with the root user;\"\nmsgstr \"与root用户一起使用 ``docker exec`` 安装开发依赖项;\"\n\n#: ../../docker.rst:135\nmsgid \"The following instructions set up a fully working development environment::\"\nmsgstr \"以下说明建立了一个完整工作的开发环境:\"\n\n#: ../../docker.rst:169\nmsgid \"\"\n\"Please note that the pycsw image only uses python 3.5 and that it also does not \"\n\"install pycsw in editable mode. As such it is not possible to use ``tox``.\"\nmsgstr \"\"\n\"请注意，pycsw映像只使用python 3.5，而且它也不以可编辑模式安装pycsw。因此，不可能使用 \"\n\"``tox``。\"\n\n#: ../../docker.rst:173\nmsgid \"\"\n\"Since the docs directory is bind mounted from your host machine into the container, \"\n\"after building the docs you may inspect their content visually, for example by \"\n\"running::\"\nmsgstr \"\"\n\"由于docs目录是从主机绑定到容器中的，所以在构建docs之后，可以可视化地检查内容，例如，\"\n\"通过运行::\"\n\n#: ../../docker.rst:180\nmsgid \"Kubernetes\"\nmsgstr \"Kubernetes\"\n\n#: ../../docker.rst:182\nmsgid \"For `Kubernetes`_ orchestration, run the following in ``docker/kubernetes``:\"\nmsgstr \"对于 `Kubernetes`_ 编排，在 `docker/kubernetes` 中运行以下命令：\"\n\n#: ../../docker.rst:191\nmsgid \"Helm\"\nmsgstr \"Helm\"\n\n#: ../../docker.rst:193\nmsgid \"For Kubernetes deployment via `Helm`_, run the following in ``docker/helm``:\"\nmsgstr \"对于通过 `Helm`_ 部署 Kubernetes，在 `docker/helm` 中运行以下命令：\"\n\n#~ msgid \"\"\n#~ \"pycsw is available as a Docker image. The image is hosted on the `Docker Hub`_.\"\n#~ msgstr \"pycsw可用作 Docker图像。图像被寄存在 `Docker Hub`_. 上。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/geonode.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 10:58+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../geonode.rst:4\nmsgid \"GeoNode Configuration\"\nmsgstr \"GeoNode配置\"\n\n#: ../../geonode.rst:6\nmsgid \"\"\n\"GeoNode (https://geonode.org/) is a platform for the management and publication \"\n\"of geospatial data. It brings together mature and stable open-source software \"\n\"projects under a consistent and easy-to-use interface allowing users, with \"\n\"little training, to quickly and easily share data and create interactive maps. \"\n\"GeoNode provides a cost-effective and scalable tool for developing information \"\n\"management systems. GeoNode uses CSW as a cataloguing mechanism to query and \"\n\"present geospatial metadata.\"\nmsgstr \"\"\n\"GeoNode (https://geonode.org/) 是一个用于管理和发布地理空间数据的平台。它将成熟\"\n\"稳定的开源软件项目汇集在一致且易于使用的界面下，使用户无需培训即可快速轻松地共享\"\n\"数据并创建交互式地图。 GeoNode 为开发信息管理系统提供了一种经济高效且可扩展的工\"\n\"具。GeoNode 使用 CSW 作为编目机制来查询和呈现地理空间元数据。\"\n\n#: ../../geonode.rst:8\nmsgid \"\"\n\"pycsw supports binding to an existing GeoNode repository for metadata query. \"\n\"The binding is read-only (transactions are not in scope, as GeoNode manages \"\n\"repository metadata changes in the application proper).\"\nmsgstr \"\"\n\"pycsw绑定到现有GeoNode库，此库用于元数据查询。此绑定是只读文件（交易不在范围内，\"\n\"GeoNode在适当的应用程序中管理库元数据）。\"\n\n#: ../../geonode.rst:11\nmsgid \"GeoNode Setup\"\nmsgstr \"GeoNode设置\"\n\n#: ../../geonode.rst:13\nmsgid \"\"\n\"pycsw is enabled and configured by default in GeoNode, so there are no \"\n\"additional steps required once GeoNode is setup. See the ``CATALOGUE`` and \"\n\"``PYCSW`` `settings.py entries`_ at for customizing pycsw within GeoNode.\"\nmsgstr \"\"\n\"pycsw 在 GeoNode 中默认启用和配置，因此设置 GeoNode 后无需执行其他步骤。有关在 \"\n\"GeoNode 中自定义 pycsw，请参阅 ``CATALOGUE`` 和 ``PYCSW`` `settings.py 条目`_。\"\n\n#: ../../geonode.rst:15\nmsgid \"The GeoNode plugin is managed outside of pycsw within the GeoNode project.\"\nmsgstr \"GeoNode插件不是由 GeoNode 项目中的 pycsw 管理。\"\n\n#~ msgid \"\"\n#~ \"pycsw is enabled and configured by default in GeoNode, so there are no \"\n#~ \"additional steps required once GeoNode is setup. See the ``CATALOGUE`` and \"\n#~ \"``PYCSW`` `settings.py entries`_ at http://docs.geonode.org/en/latest/\"\n#~ \"developers/reference/django-apps.html#id1 for customizing pycsw within \"\n#~ \"GeoNode.\"\n#~ msgstr \"\"\n#~ \"在GeoNode中，pycsw 的启用和配置都是默认的，所以GeoNode的安装程序不需要额外步\"\n#~ \"骤的。若想定制GeoNode-pycsw，请参见 http://docs.geonode.org/en/latest/\"\n#~ \"developers/reference/django-apps.html#id1 中 ``CATALOGUE`` 和 ``PYCSW`` \"\n#~ \"`settings.py entries`_ 。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/hhypermap.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2015, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2016.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 11:01+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../hhypermap.rst:4\nmsgid \"HHypermap-Registry Configuration\"\nmsgstr \"HHypermap-注册表配置 \"\n\n#: ../../hhypermap.rst:6\nmsgid \"\"\n\"HHypermap (Harvard Hypermap) Registry (https://github.com/cga-harvard/\"\n\"Hypermap-Registry) is an application that manages OWS, Esri REST, and \"\n\"other types of map service harvesting, and maintains uptime statistics \"\n\"for services and layers. HHypermap Registry will publish to HHypermap \"\n\"Search (based on Lucene) which provides a fast search and visualization \"\n\"environment for spatio-temporal materials.\"\nmsgstr \"\"\n\"HHypermap (Harvard Hypermap) Registry (https://github.com/cga-harvard/\"\n\"Hypermap-Registry) 是一个应用程序，用于管理 OWS、Esri REST 和其他类型的地\"\n\"图服务采集，并维护服务和图层的正常运行时间统计信息。HHypermap Registry 将\"\n\"发布到 HHypermap Search（基于 Lucene），为时空材料提供快速搜索和可视化环\"\n\"境。\"\n\n#: ../../hhypermap.rst:8\nmsgid \"\"\n\"HHypermap uses CSW as a cataloguing mechanism to ingest, query and \"\n\"present geospatial metadata.\"\nmsgstr \"HHypermap使用CSW作为摄取、查询、地理空间元数据显示的编目。\"\n\n#: ../../hhypermap.rst:10\nmsgid \"\"\n\"pycsw supports binding to an existing HHypermap repository for metadata \"\n\"query.\"\nmsgstr \"为元数据查询，将pycsw绑定到已有的HHypermap存储库。\"\n\n#: ../../hhypermap.rst:13\nmsgid \"HHypermap Setup\"\nmsgstr \"HHypermap设置\"\n\n#: ../../hhypermap.rst:15\nmsgid \"\"\n\"pycsw is enabled and configured by default in HHypermap, so there are no \"\n\"additional steps required once HHypermap is setup. See the \"\n\"``REGISTRY_PYCSW`` `hypermap/settings.py entries`_ for customizing pycsw \"\n\"within HHypermap.\"\nmsgstr \"\"\n\"pycsw 在 HHypermap 中默认启用和配置，因此一旦设置 HHypermap，就不需要额外\"\n\"的步骤。有关在 HHypermap 中自定义 pycsw 的信息，请参阅 `REGISTRY_PYCSW` \"\n\"`hypermap/settings.py 条目`_。\"\n\n#: ../../hhypermap.rst:17\nmsgid \"\"\n\"The HHypermap plugin is managed outside of pycsw within the HHypermap \"\n\"project. HHypermap settings must ensure that \"\n\"``REGISTRY_PYCSW['repository']['source']`` is set to``hypermap.search.\"\n\"pycsw_repository``.\"\nmsgstr \"\"\n\"HHypermap插件是在HHypermap 项目之外的 pycsw之外进行管理的。HHypermap设置\"\n\"必须确保 ``REGISTRY_PYCSW['repository']['source']`` 被设置为 ``hypermap.\"\n\"search.pycsw_repository``。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/index.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2018-12-05 22:08+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 11:02+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.6.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../index.rst:5\nmsgid \"pycsw |release| Documentation\"\nmsgstr \"pycsw 发布 文档\"\n\n#: ../../index.rst\nmsgid \"Author\"\nmsgstr \"作者\"\n\n#: ../../index.rst:7\nmsgid \"Tom Kralidis\"\nmsgstr \"Tom Kralidis\"\n\n#: ../../index.rst\nmsgid \"Contact\"\nmsgstr \"联系\"\n\n#: ../../index.rst:8\nmsgid \"tomkralidis at gmail.com\"\nmsgstr \"tomkralidis at gmail.com\"\n\n#: ../../index.rst\nmsgid \"Release\"\nmsgstr \"发布\"\n\n#: ../../index.rst:9\nmsgid \"|release|\"\nmsgstr \"|发布|\"\n\n#: ../../index.rst\nmsgid \"Date\"\nmsgstr \"日期\"\n\n#: ../../index.rst:10\nmsgid \"|today|\"\nmsgstr \"|今天|\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/installation.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 11:10+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../installation.rst:4\nmsgid \"Installation\"\nmsgstr \"安装\"\n\n#: ../../installation.rst:7\nmsgid \"System Requirements\"\nmsgstr \"系统要求\"\n\n#: ../../installation.rst:9\nmsgid \"\"\n\"pycsw is written in `Python `_, and works with (tested) \"\n\"Python 3.\"\nmsgstr \"\"\n\"pycsw 由 `Python `_ 编写，可与（经过测试的）Python 3 一起使\"\n\"用。\"\n\n#: ../../installation.rst:11\nmsgid \"pycsw requires the following Python supporting libraries:\"\nmsgstr \"pycsw 是由以下Python库支撑的:\"\n\n#: ../../installation.rst:13\nmsgid \"`lxml`_ for XML support\"\nmsgstr \"`lxml`_ 用于XML 支撑\"\n\n#: ../../installation.rst:14\nmsgid \"`SQLAlchemy`_ for database bindings\"\nmsgstr \"`SQLAlchemy`_ 用于数据库绑定\"\n\n#: ../../installation.rst:15\nmsgid \"`pyproj`_ for coordinate transformations\"\nmsgstr \"`pyproj`_ 用于变换坐标\"\n\n#: ../../installation.rst:16\nmsgid \"`Shapely`_ for spatial query / geometry support\"\nmsgstr \"`Shapely`_ 用于空间查询/ 几何支持\"\n\n#: ../../installation.rst:17\nmsgid \"`OWSLib`_ for CSW client and metadata parser\"\nmsgstr \"`OWSLib`_ 用于CSW客户端和元数据分析\"\n\n#: ../../installation.rst:18\nmsgid \"`xmltodict`_ for working with XML similar to working with JSON\"\nmsgstr \"`xmltodict`_ ，来像使用 JSON 一样使用 XML\"\n\n#: ../../installation.rst:19\nmsgid \"`geolinks`_ for dealing with geospatial links\"\nmsgstr \"`geolinks`_ 处理 地理空间链接\"\n\n#: ../../installation.rst:22\nmsgid \"OGC API - Records\"\nmsgstr \"OGC API - 记录\"\n\n#: ../../installation.rst:24\nmsgid \"OGC API - Records support additionally requires the following:\"\nmsgstr \"OGC API - 记录支持还需要以下内容：\"\n\n#: ../../installation.rst:26\nmsgid \"`Flask`_ for pycsw's default OARec endpoint\"\nmsgstr \"`Flask`_ 用于 pycsw 的默认 OARec 端点\"\n\n#: ../../installation.rst:27\nmsgid \"`pygeofilter`_ for CQL parsing\"\nmsgstr \"`pygeofilter`_ 用于 CQL 解析\"\n\n#: ../../installation.rst:28\nmsgid \"`PyYAML`_ for OpenAPI document handling\"\nmsgstr \"`PyYAML`_ 用于 OpenAPI 文档处理\"\n\n#: ../../installation.rst:32\nmsgid \"You can install these dependencies via `pip`_\"\nmsgstr \"可以通过 `pip`_ 安装这些依赖项\"\n\n#: ../../installation.rst:36\nmsgid \"\"\n\"For :ref:`GeoNode ` or :ref:`Open Data Catalog ` or :ref:\"\n\"`HHypermap ` deployments, SQLAlchemy is not required\"\nmsgstr \"\"\n\"对于 :ref:`GeoNode ` 或 :ref:`Open Data Catalog ` ，或 :ref:\"\n\"`HHypermap ` 部署，SQLAlchemy 不是必需的\"\n\n#: ../../installation.rst:39\nmsgid \"Installing from Source\"\nmsgstr \"从源代码安装\"\n\n#: ../../installation.rst:41\nmsgid \"\"\n\"`Download `_ the latest stable version or fetch from \"\n\"Git.\"\nmsgstr \"`下载 `_ 最新稳定版本，或从 Git 获取。\"\n\n#: ../../installation.rst:44\nmsgid \"For Developers and the Truly Impatient\"\nmsgstr \"为开发人员和真正Impatient\"\n\n#: ../../installation.rst:46\nmsgid \"The 4 minute install:\"\nmsgstr \"安装需要4分钟:\"\n\n#: ../../installation.rst:63\nmsgid \"To enable OGC API - Records as well as the abovementioned search standards:\"\nmsgstr \"要启用 OGC API - 记录以及上述搜索标准：\"\n\n#: ../../installation.rst:84\nmsgid \"The Quick and Dirty Way\"\nmsgstr \"快速但并非完善的方式\"\n\n#: ../../installation.rst:90\nmsgid \"\"\n\"Ensure that CGI is enabled for the install directory. For example, on Apache, \"\n\"if pycsw is installed in ``/srv/www/htdocs/pycsw`` (where the URL will be \"\n\"``http://host/pycsw/csw.py``), add the following to ``httpd.conf``:\"\nmsgstr \"\"\n\"确保在安装目录中 CGI已启用。 例如，对 Apache，如果 pycsw 安装在 ``/srv/www/\"\n\"htdocs/pycsw`` （这时，URL 就会在 ``http://host/pycsw/csw.py`` ），将以下信息添加\"\n\"至 ``httpd.conf`` :\"\n\n#: ../../installation.rst:101\nmsgid \"\"\n\"If pycsw is installed in ``cgi-bin``, this should work as expected. In this \"\n\"case, the :ref:`tests ` application must be moved to a different location \"\n\"to serve static HTML documents.\"\nmsgstr \"\"\n\"如果 pycsw安装在 ``cgi-bin`` 下，工作就能预期进行。在这种情况下， :ref:\"\n\"`tests` 应用程序就必须转移到其它位置，成为静态的 HTML 文件。\"\n\n#: ../../installation.rst:103\nmsgid \"\"\n\"Make sure, you have all the dependencies from ``requirements.txt and \"\n\"requirements-standalone.txt``\"\nmsgstr \"\"\n\"请确保已从 ``requirements.txt and requirements-standalone.txt`` 获得所有\"\n\"dependencies\"\n\n#: ../../installation.rst:106\nmsgid \"The Clean and Proper Way\"\nmsgstr \"适当的方式\"\n\n#: ../../installation.rst:115\nmsgid \"\"\n\"At this point, pycsw is installed as a library and requires a CGI ``csw.py`` or \"\n\"WSGI ``pycsw/wsgi.py`` script to be served into your web server environment (see \"\n\"below for WSGI configuration/deployment).\"\nmsgstr \"\"\n\"在这一点上，pycsw 安装库将 CGI 'csw.py '或 WSGI' pycsw/wsgi.py ' 脚本发送到您的 \"\n\"web 服务器环境 （参见下文 WSGI 配置/部署）。\"\n\n#: ../../installation.rst:122\nmsgid \"Installing from the Python Package Index (PyPI)\"\nmsgstr \"从 Python 包索引 (PyPI) 安装\"\n\n#: ../../installation.rst:131\nmsgid \"Installing from OpenSUSE Build Service\"\nmsgstr \"从 OpenSUSE 生成服务安装\"\n\n#: ../../installation.rst:133\nmsgid \"\"\n\"In order to install the pycsw package in openSUSE Leap (stable distribution), \"\n\"one can run the following commands as user ``root``:\"\nmsgstr \"\"\n\"若要在 openSUSE Leap (稳定版本) 安装 pycsw 包，就可以以用户 ``root`` 身份运行以下\"\n\"命令:\"\n\n#: ../../installation.rst:142\nmsgid \"\"\n\"In order to install the pycsw package in openSUSE Tumbleweed (rolling \"\n\"distribution), one can run the following commands as user ``root``:\"\nmsgstr \"\"\n\"若要在 openSUSE Tumbleweed (滚动版本) 安装 pycsw 包，就可以以用户 ``root`` 身份运\"\n\"行以下命令:\"\n\n#: ../../installation.rst:150\nmsgid \"\"\n\"An alternative method is to use the `One-Click Installer `_.\"\nmsgstr \"\"\n\"另一种方法是使用 `一键式安装程序 `_ 。\"\n\n#: ../../installation.rst:155\nmsgid \"Installing on Ubuntu/Mint\"\nmsgstr \"在 Ubuntu/Mint系统上安装\"\n\n#: ../../installation.rst:157\nmsgid \"\"\n\"In order to install the most recent pycsw release to an Ubuntu-based \"\n\"distribution, one can use the UbuntuGIS Unstable repository by running the \"\n\"following commands:\"\nmsgstr \"\"\n\"为了在基于 Ubuntu 的发行版安装最新的 pycsw，可以运行以下命令来使用 UbuntuGIS 非稳\"\n\"定版本:\"\n\n#: ../../installation.rst:165\nmsgid \"\"\n\"Alternatively, one can use the UbuntuGIS Stable repository which includes older \"\n\"but very well tested versions:\"\nmsgstr \"或者，可以使用UbuntuGIS Stable存储库，其中包含较老但经过良好测试的版本:\"\n\n#: ../../installation.rst:167\nmsgid \"\"\n\"sudo add-apt-repository ppa:ubuntugis/ppa sudo apt-get update sudo apt-get \"\n\"install python-pycsw pycsw-cgi\"\nmsgstr \"\"\n\"sudo add-apt-repository ppa:ubuntugis/ppa sudo apt-get update sudo apt-get \"\n\"install python-pycsw pycsw-cgi\"\n\n#: ../../installation.rst:172\nmsgid \"\"\n\"Since Ubuntu 16.04 LTS Xenial release, pycsw is included by default in the \"\n\"official Multiverse repository.\"\nmsgstr \"自从Ubuntu 16.04LTS Xenial发布以来，pycsw默认包含在官方的多版本存储库中。\"\n\n#: ../../installation.rst:175\nmsgid \"Running on Windows\"\nmsgstr \"在 Windows 上运行\"\n\n#: ../../installation.rst:177\nmsgid \"For Windows installs, change the first line of ``csw.py`` to:\"\nmsgstr \"对于Windows 安装，更改 ``csw.py`` 的第一行:\"\n\n#: ../../installation.rst:184\nmsgid \"The use of ``-u`` is required to properly output gzip-compressed responses.\"\nmsgstr \"使用 ``-u`` 需要正确输出 gzip 压缩响应。\"\n\n#: ../../installation.rst:187\nmsgid \"\"\n\"``USERNAME`` should match your username, and the Python version should match \"\n\"with your install (e.g. ``Python36``).\"\nmsgstr \"\"\n\"``USERNAME`` 应该匹配用户名，并且 Python 版本应该和你的安装匹配（例如 \"\n\"``Python36``）。\"\n\n#: ../../installation.rst:191\nmsgid \"\"\n\"`MS4W `__ (MapServer for Windows) as of its version 4.0 \"\n\"release includes pycsw, Apache's mod_wsgi, Python 3.7, and many other tools, all \"\n\"ready to use out of the box. After installing, you will find your local pycsw \"\n\"catalogue endpoint, and steps for further configuration, on your browser's \"\n\"localhost page. You can read more about pycsw inside MS4W `here `__.\"\nmsgstr \"\"\n\"`MS4W `__ (MapServer for Windows) 从 4.0 版开始包括 pycsw、\"\n\"Apache 的 mod_wsgi、Python 3.7 和许多其他工具，所有这些工具都可以开箱即用。安装\"\n\"后，将在浏览器的 localhost 页面上找到本地 pycsw 目录端点以及进一步配置的步骤。可\"\n\"以在此处`__阅读更多关于 MS4W 中 \"\n\"pycsw 的信息。\"\n\n#: ../../installation.rst:197\nmsgid \"Security\"\nmsgstr \"安全性\"\n\n#: ../../installation.rst:199\nmsgid \"\"\n\"By default, ``default.yml`` is at the root of the pycsw install. If pycsw is \"\n\"setup outside an HTTP server's ``cgi-bin`` area, this file could be read. The \"\n\"following options protect the configuration:\"\nmsgstr \"\"\n\"默认情况下， ``default.yml`` 是 pycsw 安装的根目录。 如果 pycsw 设置在 HTTP 服务\"\n\"器 ``cgi-bin`` 区域以外，此文件就可以被读取。 以下是几项保护配置的选项:\"\n\n#: ../../installation.rst:201\nmsgid \"\"\n\"move ``default.yml`` to a non HTTP accessible area, and modify ``csw.py`` to \"\n\"point to the updated location\"\nmsgstr \"\"\n\"将 ``default.yml`` 移动到非 HTTP 可访问的区域，并修改 ``csw.py`` 以指向更新的位置\"\n\n#: ../../installation.rst:202\nmsgid \"\"\n\"configure web server to deny access to the configuration. For example, in \"\n\"Apache, add the following to ``httpd.conf``:\"\nmsgstr \"\"\n\"配置 web 服务器，拒绝对配置的访问。 例如，在 Apache 中，在 ``httpd.conf`` 下添加\"\n\"以下内容:\"\n\n#: ../../installation.rst:213\nmsgid \"Running on WSGI\"\nmsgstr \"在 WSGI 上运行\"\n\n#: ../../installation.rst:215\nmsgid \"\"\n\"pycsw supports the `Web Server Gateway Interface`_ (WSGI). To run pycsw in WSGI \"\n\"mode, use ``pycsw/wsgi.py`` in your WSGI server environment.\"\nmsgstr \"\"\n\"pycsw 支持 `Web Server Gateway Interface`_ (WSGI)。 在 WSGI 模式下运行 pycsw，在 \"\n\"WSGI 服务器环境中使用 ``pycsw/wsgi.py`` 。\"\n\n#: ../../installation.rst:220\nmsgid \"\"\n\"``mod_wsgi`` supports only the version of python it was compiled with. If the \"\n\"target server already supports WSGI applications, pycsw will need to use the \"\n\"same python version. `WSGIDaemonProcess`_ provides a ``python-path`` directive \"\n\"that may allow a virtualenv created from the python version ``mod_wsgi`` uses.\"\nmsgstr \"\"\n\"``mod_wsgi`` 只支持已编译的python版本。如果目标服务器支持 WSGI 应用，pycsw也是相\"\n\"同的 python 版本。`WSGIDaemonProcess`_ 提供 ``python-path`` 指令，其允许从 \"\n\"python 版本 ``mod_wsgi`` 进行virtualenv 的创建。\"\n\n#: ../../installation.rst:224\nmsgid \"Below is an example of configuring with Apache:\"\nmsgstr \"以下是使用 Apache 进行配置的示例：\"\n\n#: ../../installation.rst:237\nmsgid \"or use the `WSGI reference implementation`_:\"\nmsgstr \"或者使用 `WSGI 参考实例`_ :\"\n\n#: ../../installation.rst:244\nmsgid \"which will publish pycsw to ``http://localhost:8000/``\"\nmsgstr \"将pycsw发布到 ``http://localhost:8000/``\"\n\n#~ msgid \"`six`_ for Python 2/3 compatibility\"\n#~ msgstr \"`six`_ 用于处理 Python 2/3 兼容性\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/introduction.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 11:22+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../introduction.rst:4\nmsgid \"Introduction\"\nmsgstr \"引言\"\n\n#: ../../introduction.rst:6\nmsgid \"pycsw is an OARec and OGC CSW server implementation written in Python.\"\nmsgstr \"pycsw 是用 Python 编写的 OARec 和 OGC CSW 服务器实现。\"\n\n#: ../../introduction.rst:9\nmsgid \"Features\"\nmsgstr \"特性\"\n\n#: ../../introduction.rst:11\nmsgid \"implements `OGC API - Records - Part 1: Core`_\"\nmsgstr \"实现`OGC API - 记录 - 第 1 部分：核心`_\"\n\n#: ../../introduction.rst:12\nmsgid \"\"\n\"certified OGC `Compliant`_ and OGC Reference Implementation for both CSW \"\n\"2.0.2 and CSW 3.0.0\"\nmsgstr \"CSW 2.0.2与 CSW 3.0.0 认证 OGC `Compliant`_ 与 OGC 参考实现\"\n\n#: ../../introduction.rst:13\nmsgid \"harvesting support for WMS, WFS, WCS, WPS, WAF, CSW, SOS\"\nmsgstr \"WMS、WFS、WCS、WPS、WAF、CSW、SOS得到支持\"\n\n#: ../../introduction.rst:14\nmsgid \"implements `INSPIRE Discovery Services 3.0`_\"\nmsgstr \"实现了 `INSPIRE Discovery Services 3.0`_\"\n\n#: ../../introduction.rst:15\nmsgid \"implements `ISO Metadata Application Profile 1.0.0`_\"\nmsgstr \"实现了 `ISO Metadata Application Profile 1.0.0`_\"\n\n#: ../../introduction.rst:16\nmsgid \"implements `FGDC CSDGM Application Profile for CSW 2.0`_\"\nmsgstr \"实现了 `FGDC CSDGM Application Profile for CSW 2.0`_ \"\n\n#: ../../introduction.rst:17\nmsgid \"implements the Search/Retrieval via URL (`SRU`_) search protocol\"\nmsgstr \"实现了通过URL ( `SRU`_ ) 查找接口进行查找或抓取\"\n\n#: ../../introduction.rst:18\nmsgid \"implements Full Text Search capabilities\"\nmsgstr \"实现了全文检索的功能\"\n\n#: ../../introduction.rst:19\nmsgid \"implements OGC OpenSearch Geo and Time Extensions\"\nmsgstr \"实现了 OGC 开放搜索与时空扩展\"\n\n#: ../../introduction.rst:20\nmsgid \"implements Open Archives Initiative Protocol for Metadata Harvesting\"\nmsgstr \"支持元数据主动文档开放协议\"\n\n#: ../../introduction.rst:21\nmsgid \"supports ISO, Dublin Core, DIF, FGDC, Atom and GM03 metadata models\"\nmsgstr \"支持 ISO、Dublin Core、DIF、FGDC，Atom与 GM03 元数据模型\"\n\n#: ../../introduction.rst:22\nmsgid \"CGI or WSGI deployment\"\nmsgstr \"CGI或WSCI部署\"\n\n#: ../../introduction.rst:23\nmsgid \"simple configuration\"\nmsgstr \"简单配置\"\n\n#: ../../introduction.rst:24\nmsgid \"transactional capabilities (CSW-T)\"\nmsgstr \"事务功能（CSW-T））\"\n\n#: ../../introduction.rst:25\nmsgid \"flexible repository configuration\"\nmsgstr \"灵活的存储配置\"\n\n#: ../../introduction.rst:26\nmsgid \"`GeoNode`_ connectivity\"\nmsgstr \"`GeoNode`_ 的连接\"\n\n#: ../../introduction.rst:27\nmsgid \"`HHypermap`_ connectivity\"\nmsgstr \"`HHypermap`_ 的连接\"\n\n#: ../../introduction.rst:28\nmsgid \"`Open Data Catalog`_ connectivity\"\nmsgstr \"`Open Data Catalog`_ 的连接\"\n\n#: ../../introduction.rst:29\nmsgid \"`CKAN`_ connectivity\"\nmsgstr \"`CKAN`_ 的连接\"\n\n#: ../../introduction.rst:30\nmsgid \"federated catalogue distributed searching\"\nmsgstr \"联合目录分布式搜索\"\n\n#: ../../introduction.rst:31\nmsgid \"realtime XML Schema validation\"\nmsgstr \"实时XML Schema验证\"\n\n#: ../../introduction.rst:32\nmsgid \"extensible profile plugin architecture\"\nmsgstr \"可扩展的配置文件插件架构\"\n\n#: ../../introduction.rst:35\nmsgid \"Standards Support\"\nmsgstr \"支持的标准\"\n\n#: ../../introduction.rst:1\nmsgid \"Standard\"\nmsgstr \"标准\"\n\n#: ../../introduction.rst:1\nmsgid \"Version(s)\"\nmsgstr \"版本\"\n\n#: ../../introduction.rst:1\nmsgid \"`OGC API - Records - Part 1: Core`_\"\nmsgstr \"`OGC API - Records - Part 1: Core`_\"\n\n#: ../../introduction.rst:1\nmsgid \"1.0\"\nmsgstr \"1.0\"\n\n#: ../../introduction.rst:1\nmsgid \"\"\n\"`OGC API - Features - Part 3: Filtering and the Common Query Language \"\n\"(CQL)`_\"\nmsgstr \"\"\n\"`OGC API - Features - Part 3: Filtering and the Common Query Language \"\n\"(CQL)`_\"\n\n#: ../../introduction.rst:1\nmsgid \"draft\"\nmsgstr \"草稿\"\n\n#: ../../introduction.rst:1\nmsgid \"`OGC CSW`_\"\nmsgstr \"`OGC CSW`_\"\n\n#: ../../introduction.rst:1\nmsgid \"2.0.2/3.0.0\"\nmsgstr \"2.0.2/3.0.0\"\n\n#: ../../introduction.rst:1\nmsgid \"`OGC Filter`_\"\nmsgstr \"`OGC Filte`_\"\n\n#: ../../introduction.rst:1\nmsgid \"1.1.0/2.0.0\"\nmsgstr \"1.1.0/2.0.0\"\n\n#: ../../introduction.rst:1\nmsgid \"`OGC OWS Common`_\"\nmsgstr \"`OGC OWS Common`_\"\n\n#: ../../introduction.rst:1\nmsgid \"1.0.0/2.0.0\"\nmsgstr \"1.0.0/2.0.0\"\n\n#: ../../introduction.rst:1\nmsgid \"`OGC GML`_\"\nmsgstr \"`OGC GML`_\"\n\n#: ../../introduction.rst:1\nmsgid \"3.1.1\"\nmsgstr \"3.1.1\"\n\n#: ../../introduction.rst:1\nmsgid \"`OGC SFSQL`_\"\nmsgstr \"`OGC SFSQL`_\"\n\n#: ../../introduction.rst:1\nmsgid \"1.2.1\"\nmsgstr \"1.2.1\"\n\n#: ../../introduction.rst:1\nmsgid \"`Dublin Core`_\"\nmsgstr \"`Dublin Core`_\"\n\n#: ../../introduction.rst:1\nmsgid \"1.1\"\nmsgstr \"1.1\"\n\n#: ../../introduction.rst:1\nmsgid \"`SOAP`_\"\nmsgstr \"`SOAP`_\"\n\n#: ../../introduction.rst:1\nmsgid \"1.2\"\nmsgstr \"1.2\"\n\n#: ../../introduction.rst:1\nmsgid \"`ISO 19115`_\"\nmsgstr \"`ISO 19115`_\"\n\n#: ../../introduction.rst:1\nmsgid \"2003\"\nmsgstr \"2003\"\n\n#: ../../introduction.rst:1\nmsgid \"`ISO 19139`_\"\nmsgstr \"`ISO 19139`_\"\n\n#: ../../introduction.rst:1\nmsgid \"2007\"\nmsgstr \"2007\"\n\n#: ../../introduction.rst:1\nmsgid \"`ISO 19119`_\"\nmsgstr \"`ISO 19119`_\"\n\n#: ../../introduction.rst:1\nmsgid \"2005\"\nmsgstr \"2005\"\n\n#: ../../introduction.rst:1\nmsgid \"`NASA DIF`_\"\nmsgstr \"`NASA DIF`_\"\n\n#: ../../introduction.rst:1\nmsgid \"9.7\"\nmsgstr \"9.7\"\n\n#: ../../introduction.rst:1\nmsgid \"`FGDC CSDGM`_\"\nmsgstr \"`FGDC CSDGM`_\"\n\n#: ../../introduction.rst:1\nmsgid \"1998\"\nmsgstr \"1998\"\n\n#: ../../introduction.rst:1\nmsgid \"`GM03`_\"\nmsgstr \"`GM03`_\"\n\n#: ../../introduction.rst:1\nmsgid \"2.1\"\nmsgstr \"2.1\"\n\n#: ../../introduction.rst:1\nmsgid \"`SRU`_\"\nmsgstr \"`SRU`_\"\n\n#: ../../introduction.rst:1\nmsgid \"`OGC OpenSearch`_\"\nmsgstr \"`OGC OpenSearch`_\"\n\n#: ../../introduction.rst:1\nmsgid \"`OAI-PMH`_\"\nmsgstr \"`OAI-PMH`_\"\n\n#: ../../introduction.rst:1\nmsgid \"2.0\"\nmsgstr \"2.0\"\n\n#: ../../introduction.rst:60\nmsgid \"OGC API - Records support\"\nmsgstr \"OGC API - 记录支持\"\n\n#: ../../introduction.rst:62\nmsgid \"Part 1: Core\"\nmsgstr \"第 1 部分：核心\"\n\n#: ../../introduction.rst:65\nmsgid \"OGC API - Features support\"\nmsgstr \"OGC API - 功能支持\"\n\n#: ../../introduction.rst:67\nmsgid \"Part 3: Filtering and the Common Query Language (CQL)\"\nmsgstr \"第 3 部分：过滤和通用查询语言 (CQL)\"\n\n#: ../../introduction.rst:70 ../../introduction.rst:118\nmsgid \"Supported Output Formats\"\nmsgstr \"支持的输出格式\"\n\n#: ../../introduction.rst:72\nmsgid \"JSON (default)\"\nmsgstr \"JSON（默认）\"\n\n#: ../../introduction.rst:73\nmsgid \"XML\"\nmsgstr \"XML\"\n\n#: ../../introduction.rst:76 ../../introduction.rst:142\nmsgid \"Supported Filters\"\nmsgstr \"支持的过滤器\"\n\n#: ../../introduction.rst:78\nmsgid \"q\"\nmsgstr \"q\"\n\n#: ../../introduction.rst:79\nmsgid \"datetime\"\nmsgstr \"时区\"\n\n#: ../../introduction.rst:80\nmsgid \"filter (CQL)\"\nmsgstr \"过滤器 (CQL)\"\n\n#: ../../introduction.rst:81\nmsgid \"bbox\"\nmsgstr \"bbox\"\n\n#: ../../introduction.rst:82\nmsgid \"all properties (``property=value``)\"\nmsgstr \"所有属性（``property=value``）\"\n\n#: ../../introduction.rst:85\nmsgid \"Paging\"\nmsgstr \"分页\"\n\n#: ../../introduction.rst:87\nmsgid \"limit\"\nmsgstr \"限度\"\n\n#: ../../introduction.rst:88\nmsgid \"startindex\"\nmsgstr \"startindex\"\n\n#: ../../introduction.rst:91\nmsgid \"CSW Support\"\nmsgstr \"CSW支持\"\n\n#: ../../introduction.rst:94\nmsgid \"Supported Operations\"\nmsgstr \"支持的操作\"\n\n#: ../../introduction.rst:1\nmsgid \"Request\"\nmsgstr \"请求\"\n\n#: ../../introduction.rst:1\nmsgid \"Optionality\"\nmsgstr \"可选性\"\n\n#: ../../introduction.rst:1\nmsgid \"Supported\"\nmsgstr \"支持\"\n\n#: ../../introduction.rst:1\nmsgid \"HTTP method binding(s)\"\nmsgstr \"HTTP方法绑定\"\n\n#: ../../introduction.rst:1\nmsgid \"GetCapabilities\"\nmsgstr \"功能\"\n\n#: ../../introduction.rst:1\nmsgid \"mandatory\"\nmsgstr \"强制性的\"\n\n#: ../../introduction.rst:1\nmsgid \"yes\"\nmsgstr \"是\"\n\n#: ../../introduction.rst:1\nmsgid \"GET (KVP) / POST (XML) / SOAP\"\nmsgstr \"GET (KVP) / POST (XML) / SOAP\"\n\n#: ../../introduction.rst:1\nmsgid \"DescribeRecord\"\nmsgstr \"记录详述\"\n\n#: ../../introduction.rst:1\nmsgid \"GetRecords\"\nmsgstr \"获取记录\"\n\n#: ../../introduction.rst:1\nmsgid \"GetRecordById\"\nmsgstr \"GetRecordById\"\n\n#: ../../introduction.rst:1\nmsgid \"optional\"\nmsgstr \"选项\"\n\n#: ../../introduction.rst:1\nmsgid \"GetRepositoryItem\"\nmsgstr \"项目库获取\"\n\n#: ../../introduction.rst:1\nmsgid \"GET (KVP)\"\nmsgstr \"KVP获取\"\n\n#: ../../introduction.rst:1\nmsgid \"GetDomain\"\nmsgstr \"GetDomain\"\n\n#: ../../introduction.rst:1\nmsgid \"Harvest\"\nmsgstr \"获取\"\n\n#: ../../introduction.rst:1\nmsgid \"UnHarvest\"\nmsgstr \"未收获\"\n\n#: ../../introduction.rst:1\nmsgid \"no\"\nmsgstr \"否\"\n\n#: ../../introduction.rst:1\nmsgid \"Transaction\"\nmsgstr \"订单\"\n\n#: ../../introduction.rst:1\nmsgid \"POST (XML) / SOAP\"\nmsgstr \"POST (XML) / SOAP\"\n\n#: ../../introduction.rst:111\nmsgid \"\"\n\"Asynchronous processing supported for GetRecords and Harvest requests (via \"\n\"``csw:ResponseHandler``)\"\nmsgstr \"异步处理支持 GetRecords 和获取请求 （通过 ' csw:ResponseHandler ')\"\n\n#: ../../introduction.rst:115\nmsgid \"Supported Harvest Resource Types are listed in :ref:`transactions`\"\nmsgstr \"获取资源类型请参考: :ref:`transactions` 中列表\"\n\n#: ../../introduction.rst:120\nmsgid \"XML (default)\"\nmsgstr \"XML （默认值）\"\n\n#: ../../introduction.rst:121\nmsgid \"JSON\"\nmsgstr \"JSON代码\"\n\n#: ../../introduction.rst:124\nmsgid \"Supported Output Schemas\"\nmsgstr \"支持的输出模式\"\n\n#: ../../introduction.rst:126\nmsgid \"Dublin Core\"\nmsgstr \"Dublin Core\"\n\n#: ../../introduction.rst:127\nmsgid \"ISO 19139\"\nmsgstr \"ISO 19139\"\n\n#: ../../introduction.rst:128\nmsgid \"FGDC CSDGM\"\nmsgstr \"FGDC CSDGM\"\n\n#: ../../introduction.rst:129\nmsgid \"NASA DIF\"\nmsgstr \"NASA DIF\"\n\n#: ../../introduction.rst:130\nmsgid \"Atom\"\nmsgstr \"Atom\"\n\n#: ../../introduction.rst:131\nmsgid \"GM03\"\nmsgstr \"GM03\"\n\n#: ../../introduction.rst:134\nmsgid \"Supported Sorting Functionality\"\nmsgstr \"支持排序功能\"\n\n#: ../../introduction.rst:136\nmsgid \"ogc:SortBy\"\nmsgstr \"ogc:SortBy\"\n\n#: ../../introduction.rst:137\nmsgid \"ascending or descending\"\nmsgstr \"升序或降序\"\n\n#: ../../introduction.rst:138\nmsgid \"aspatial (queryable properties)\"\nmsgstr \"非空间 （可查询属性）\"\n\n#: ../../introduction.rst:139\nmsgid \"spatial (geometric area)\"\nmsgstr \"空间 （几何区域）\"\n\n#: ../../introduction.rst:145\nmsgid \"Full Text Search\"\nmsgstr \"全文检索\"\n\n#: ../../introduction.rst:147\nmsgid \"csw:AnyText\"\nmsgstr \"csw:任意文章\"\n\n#: ../../introduction.rst:150\nmsgid \"Geometry Operands\"\nmsgstr \"几何操作\"\n\n#: ../../introduction.rst:152\nmsgid \"gml:Point\"\nmsgstr \"gml:点\"\n\n#: ../../introduction.rst:153\nmsgid \"gml:LineString\"\nmsgstr \"gml:线\"\n\n#: ../../introduction.rst:154\nmsgid \"gml:Polygon\"\nmsgstr \"gml:面\"\n\n#: ../../introduction.rst:155\nmsgid \"gml:Envelope\"\nmsgstr \"gml:外框\"\n\n#: ../../introduction.rst:159\nmsgid \"Coordinate transformations are supported\"\nmsgstr \"坐标变换\"\n\n#: ../../introduction.rst:162\nmsgid \"Spatial Operators\"\nmsgstr \"空间操作\"\n\n#: ../../introduction.rst:164\nmsgid \"BBOX\"\nmsgstr \"BBOX\"\n\n#: ../../introduction.rst:165\nmsgid \"Beyond\"\nmsgstr \"以外\"\n\n#: ../../introduction.rst:166\nmsgid \"Contains\"\nmsgstr \"包括\"\n\n#: ../../introduction.rst:167\nmsgid \"Crosses\"\nmsgstr \"交叉\"\n\n#: ../../introduction.rst:168\nmsgid \"Disjoint\"\nmsgstr \"不相交\"\n\n#: ../../introduction.rst:169\nmsgid \"DWithin\"\nmsgstr \"DWithin\"\n\n#: ../../introduction.rst:170\nmsgid \"Equals\"\nmsgstr \"等于\"\n\n#: ../../introduction.rst:171\nmsgid \"Intersects\"\nmsgstr \"相交\"\n\n#: ../../introduction.rst:172\nmsgid \"Overlaps\"\nmsgstr \"重叠\"\n\n#: ../../introduction.rst:173\nmsgid \"Touches\"\nmsgstr \"触动\"\n\n#: ../../introduction.rst:174\nmsgid \"Within\"\nmsgstr \"内\"\n\n#: ../../introduction.rst:177\nmsgid \"Logical Operators\"\nmsgstr \"逻辑运算符\"\n\n#: ../../introduction.rst:179\nmsgid \"Between\"\nmsgstr \"两者之间\"\n\n#: ../../introduction.rst:180\nmsgid \"EqualTo\"\nmsgstr \"等于\"\n\n#: ../../introduction.rst:181\nmsgid \"LessThanEqualTo\"\nmsgstr \"小于等于\"\n\n#: ../../introduction.rst:182\nmsgid \"GreaterThan\"\nmsgstr \"大于\"\n\n#: ../../introduction.rst:183\nmsgid \"Like\"\nmsgstr \"似\"\n\n#: ../../introduction.rst:184\nmsgid \"LessThan\"\nmsgstr \"小于\"\n\n#: ../../introduction.rst:185\nmsgid \"GreaterThanEqualTo\"\nmsgstr \"大于等于\"\n\n#: ../../introduction.rst:186\nmsgid \"NotEqualTo\"\nmsgstr \"不等于\"\n\n#: ../../introduction.rst:187\nmsgid \"NullCheck\"\nmsgstr \"零检验\"\n\n#: ../../introduction.rst:190\nmsgid \"Functions\"\nmsgstr \"功能\"\n\n#: ../../introduction.rst:191\nmsgid \"length\"\nmsgstr \"长度\"\n\n#: ../../introduction.rst:192\nmsgid \"lower\"\nmsgstr \"低于\"\n\n#: ../../introduction.rst:193\nmsgid \"ltrim\"\nmsgstr \"ltrim\"\n\n#: ../../introduction.rst:194\nmsgid \"rtrim\"\nmsgstr \"rtrim\"\n\n#: ../../introduction.rst:195\nmsgid \"trim\"\nmsgstr \"trim\"\n\n#: ../../introduction.rst:196\nmsgid \"upper\"\nmsgstr \"上部\"\n\n#~ msgid \"Python 2 and 3 compatible\"\n#~ msgstr \"Python 2和3兼容\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/json.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2015, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2016.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 11:25+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_TW\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../json.rst:4\nmsgid \"JSON Support\"\nmsgstr \"对JSON的支持\"\n\n#: ../../json.rst:7\nmsgid \"OARec\"\nmsgstr \"OARec\"\n\n#: ../../json.rst:9\nmsgid \"\"\n\"pycsw fully supports the OARec JSON conformance class, which is the \"\n\"default representation provided.\"\nmsgstr \"pycsw 完全支持 OARec JSON 一致性类，这是提供的默认表示。\"\n\n#: ../../json.rst:13\nmsgid \"CSW\"\nmsgstr \"CSW\"\n\n#: ../../json.rst:15\nmsgid \"\"\n\"pycsw supports JSON support for ``DescribeRecord``, ``GetRecords`` and \"\n\"``GetRecordById`` requests. Adding ``outputFormat=application/json`` to \"\n\"your CSW request will return the response as a JSON representation.\"\nmsgstr \"\"\n\"pycsw 对JSON 的支持包括 ``DescribeRecord``, ``GetRecords`` 和 \"\n\"``GetRecordById`` 的请求。 在CSW请示中添加 ``outputFormat=application/\"\n\"json`` 会返回JSON格式表达的响应。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/license.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 13:33+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../license.rst:4\nmsgid \"License\"\nmsgstr \"授权\"\n\n#: ../../../LICENSE.txt:2\nmsgid \"The MIT License (MIT)\"\nmsgstr \"MIT 许可证 (MIT)\"\n\n#: ../../../LICENSE.txt:4\nmsgid \"\"\n\"Copyright © 2010-2022 Tom Kralidis Copyright © 2011-2021 Angelos Tzotsos Copyright © 2012-2015 \"\n\"Adam Hinz Copyright © 2015-2021 Ricardo Garcia Silva\"\nmsgstr \"\"\n\"版权 © 2010-2022 Tom Kralidis 版权所有 © 2011-2021 Angelos Tzotsos 版权所有 © 2012-2015 Adam \"\n\"Hinz 版权所有 © 2015-2021 Ricardo Garcia Silva\"\n\n#: ../../../LICENSE.txt:9\nmsgid \"\"\n\"Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated \"\n\"documentation files (the \\\"Software\\\"), to deal in the Software without restriction, including without \"\n\"limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the \"\n\"Software, and to permit persons to whom the Software is furnished to do so, subject to the following \"\n\"conditions:\"\nmsgstr \"\"\n\"特此授予权限，此软件是免费的，任何人都可获得本软件副本及相关文档文件 （\\\"软件\\\"），处理软件也不受限制，包括使\"\n\"用、 复制、 修改、 合并、 发布、 分发、 二次许可，或复印件转卖。给予授权的人应符合以下条件︰\"\n\n#: ../../../LICENSE.txt:16\nmsgid \"\"\n\"The above copyright notice and this permission notice shall be included in all copies or substantial portions \"\n\"of the Software.\"\nmsgstr \"上面的版权声明和许可声明应列入所有副本或软件的重要部分。\"\n\n#: ../../../LICENSE.txt:19\nmsgid \"\"\n\"THE SOFTWARE IS PROVIDED \\\"AS IS\\\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT \"\n\"LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO \"\n\"EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN \"\n\"AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE \"\n\"OR OTHER DEALINGS IN THE SOFTWARE.\"\nmsgstr \"\"\n\"该软件为“原版”，不做任何担保（明文或暗文的担保），包括对适销性、特定用途和非侵权性的保证。在任何情况下，不论是\"\n\"合同，侵权或其他，软件使用或其他交易。作者或版权持有者是法律责任的任何索赔、损害赔偿或其他责任。\"\n\n#: ../../license.rst:9\nmsgid \"Documentation\"\nmsgstr \"说明文件\"\n\n#: ../../license.rst:11\nmsgid \"\"\n\"The documentation is released under the `Creative Commons Attribution 4.0 International (CC BY 4.0)`_ license.\"\nmsgstr \"该文档是 `知识共享署名4.0国际发布（CC BY 4.0）`_ 许可证下发的。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/migration-guide.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2015, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2016.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.1-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 13:40+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../migration-guide.rst:4\nmsgid \"pycsw Migration Guide\"\nmsgstr \"pycsw 迁移指南\"\n\n#: ../../migration-guide.rst:6\nmsgid \"\"\n\"This page provides migration support across pycsw versions over time to \"\n\"help with pycsw change management.\"\nmsgstr \"此页面提供跨 pycsw 版本的迁移支持，以帮助进行 pycsw 变更管理。\"\n\n#: ../../migration-guide.rst:10\nmsgid \"pycsw 2.x to 3.0 Migration\"\nmsgstr \"pycsw 2.x 到 3.0 的迁移\"\n\n#: ../../migration-guide.rst:12\nmsgid \"\"\n\"the default endpoint for standalone deployments is now powered by \"\n\"``pycsw/wsgi_flask.py`` (based on Flask) which supports ALL pycsw \"\n\"supported APIs. Make sure to use ``requirements-standalone.txt`` on top \"\n\"of ``requirements.txt`` to install Flask along with other standalone \"\n\"requirements\"\nmsgstr \"\"\n\"独立部署的默认端点现在由 ``pycsw/wsgi_flask.py``（基于 Flask）提供支持，\"\n\"它支持所有 pycsw 支持的 API。确保在 ``requirements.txt`` 之上使用 \"\n\"``requirements-standalone.txt`` 来安装 Flask 以及其他独立需求\"\n\n#: ../../migration-guide.rst:13\nmsgid \"\"\n\"the previously used ``pycsw/wsgi.py`` can still be used for CSW only \"\n\"deployments or for applications that need to integrate pycsw as a \"\n\"library (e.g. Django applications). PyPI installations still use \"\n\"``requirements.txt`` which does not install Flask by default\"\nmsgstr \"\"\n\"以前使用的 ``pycsw/wsgi.py`` 仍然可以用于仅 CSW 部署或需要将 pycsw 集成为\"\n\"库的应用程序（例如 Django 应用程序）。PyPI 安装仍然使用``requirements.\"\n\"txt``，默认情况下不安装 Flask\"\n\n#: ../../migration-guide.rst:14\nmsgid \"the default endpoint ``/`` is now OARec\"\nmsgstr \"默认端点 ``/`` 现在是 OARec\"\n\n#: ../../migration-guide.rst:15\nmsgid \"the CSW endpoint is now ``/csw``\"\nmsgstr \"CSW 端点现在是 ``/csw``\"\n\n#: ../../migration-guide.rst:16\nmsgid \"the OAI-PMH endpoint is now ``/oaipmh``\"\nmsgstr \"OAI-PMH 端点现在是 ``/oaipmh``\"\n\n#: ../../migration-guide.rst:17\nmsgid \"the OpenSearch endpoint is now ``/opensearch``\"\nmsgstr \"OpenSearch 端点现在是 ``/opensearch``\"\n\n#: ../../migration-guide.rst:18\nmsgid \"the SRU endpoint is now ``/sru``\"\nmsgstr \"SRU 端点现在是 ``/sru``\"\n\n#: ../../migration-guide.rst:19\nmsgid \"the ``pycsw-admin.py`` syntax has been updated\"\nmsgstr \"pycsw-admin.py 语法已更新\"\n\n#: ../../migration-guide.rst:21\nmsgid \"\"\n\"the ``-c`` flag has been replaced by subcommands (i.e. ``pycsw-admin.py -\"\n\"c load_records`` -> ``pycsw-admin.py load-records``)\"\nmsgstr \"\"\n\"``-c`` 标志已被子命令替换（即 ``pycsw-admin.py -c load_records`` -> \"\n\"``pycsw-admin.py load-records``）\"\n\n#: ../../migration-guide.rst:22\nmsgid \"\"\n\"subcommands have been slugified (i.e. ``load_records`` -> ``load-\"\n\"records``)\"\nmsgstr \"子命令已被 slugified（即 ``load_records`` -> ``load-records``）\"\n\n#: ../../migration-guide.rst:23\nmsgid \"consult ``--help`` to use the updated CLI syntax\"\nmsgstr \"请参阅 ``--help`` 以使用更新的 CLI 语法\"\n\n#: ../../migration-guide.rst:26\nmsgid \"pycsw 1.x to 2.0 Migration\"\nmsgstr \"pycsw 1.x到2.0的迁移\"\n\n#: ../../migration-guide.rst:28\nmsgid \"\"\n\"the default CSW version is now 3.0.0. CSW clients need to explicitly \"\n\"specify ``version=2.0.2`` for CSW 2 behaviour. Also, pycsw \"\n\"administrators can use a WSGI wrapper to the pycsw API to force \"\n\"``version=2.0.2`` on init of ``pycsw.server.Csw`` from the server. See :\"\n\"ref:`csw-support` for more information.\"\nmsgstr \"\"\n\"默认的 CSW 版本现在是 3.0.0。CSW 客户端需要为 CSW 2 行为显式指定 \"\n\"``version=2.0.2``。此外，pycsw 管理员可以使用 pycsw API 的 WSGI 包装器来\"\n\"强制从服务器初始化 ``pycsw.server.Csw`` 的``version=2.0.2``。更多信息参\"\n\"见:ref:`csw-support`。\"\n\n#: ../../migration-guide.rst:33\nmsgid \"\"\n\"``pycsw.server.Csw.dispatch_wsgi()`` previously returned the response \"\n\"content as a string. 2.0.0 introduces a compatability break to \"\n\"additionally return the HTTP status code along with the response as a \"\n\"list\"\nmsgstr \"\"\n\"``pycsw.server.Csw.dispatch_wsgi()`` 之前将响应内容作为字符串返回。2.0.0 \"\n\"引入了一个兼容性中断，以额外返回 HTTP 状态代码以及响应作为列表\"\n\n#: ../../migration-guide.rst:58\nmsgid \"See :ref:`api` for more information.\"\nmsgstr \"更多信息参见:ref:`api`。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/oaipmh.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 13:43+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../oaipmh.rst:4\nmsgid \"OAI-PMH Support\"\nmsgstr \"OAI-PMH支持\"\n\n#: ../../oaipmh.rst:6\nmsgid \"\"\n\"pycsw supports the `The Open Archives Initiative Protocol for Metadata \"\n\"Harvesting`_ (OAI-PMH) standard.\"\nmsgstr \"\"\n\"pycsw 支持 `The Open Archives Initiative Protocol for Metadata \"\n\"Harvesting`_ (OAI-PMH) 标准。\"\n\n#: ../../oaipmh.rst:8\nmsgid \"\"\n\"OAI-PMH OpenSearch support is enabled by default. There are two ways to \"\n\"access OAI-PMH depending on the deployment pattern chosen.\"\nmsgstr \"\"\n\"OAI-PMH OpenSearch 支持默认启用。根据选择的部署模式，有两种访问 OAI-PMH \"\n\"的方法。\"\n\n#: ../../oaipmh.rst:12\nmsgid \"OARec deployment\"\nmsgstr \"OARec 部署\"\n\n#: ../../oaipmh.rst:19\nmsgid \"CSW legacy deployment\"\nmsgstr \"CSW 遗留部署\"\n\n#: ../../oaipmh.rst:21\nmsgid \"\"\n\"HTTP requests must be specified with ``mode=oaipmh`` in the base URL for \"\n\"OAI-PMH requests, e.g.:\"\nmsgstr \"\"\n\"HTTP 请求必须在 OAI-PMH 请求的基本 URL 中使用 ``mode=oaipmh`` 指定，例\"\n\"如： \"\n\n#: ../../oaipmh.rst:27\nmsgid \"\"\n\"See http://www.openarchives.org/OAI/openarchivesprotocol.html for more \"\n\"information on OAI-PMH as well as request / reponse examples.\"\nmsgstr \"\"\n\"有关 OAI-PMH 以及请求/响应示例的更多信息，请参见 http://www.openarchives.\"\n\"org/OAI/openarchivesprotocol.html。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/oarec-support.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2022, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2022.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 3.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 13:46+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=UTF-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../oarec-support.rst:4\nmsgid \"OGC API - Records Support\"\nmsgstr \"OGC API - 记录支持\"\n\n#: ../../oarec-support.rst:7\nmsgid \"Versions\"\nmsgstr \"版本\"\n\n#: ../../oarec-support.rst:9\nmsgid \"\"\n\"pycsw supports `OGC API - Records - Part 1: Core, version 1.0`_ (OARec) \"\n\"by default.\"\nmsgstr \"\"\n\"pycsw 默认支持 `OGC API - Records - Part 1: Core, version 1.0`_ (OARec)。\"\n\n#: ../../oarec-support.rst:12\nmsgid \"Request Examples\"\nmsgstr \"请求示例\"\n\n#: ../../oarec-support.rst:14\nmsgid \"\"\n\"As the OGC successor to CSW, OARec is a change in paradigm rooted in \"\n\"lowering the barrier to entry, being webby/of the web, and focusing on \"\n\"developer experience/adoption. JSON and HTML output formats are both \"\n\"supported via the ``f`` parameter.\"\nmsgstr \"\"\n\"作为 CSW 的 OGC 继任者，OARec 是一种范式变革，其根源在于降低准入门槛、成\"\n\"为 webby/web 并专注于开发人员体验/采用。JSON 和 HTML 输出格式都通过 \"\n\"``f`` 参数支持。\"\n\n#: ../../oarec-support.rst:77\nmsgid \"Virtual Collections\"\nmsgstr \"虚拟馆藏\"\n\n#: ../../oarec-support.rst:79\nmsgid \"\"\n\"In OGC API - Records, pycsw's global repository is named `metadata:\"\n\"main`, which serves all metadata records from a given pycsw \"\n\"configuration.\"\nmsgstr \"\"\n\"在OGC API-Records中，pycsw的全局存储库名为 `metadata:main`，为给定pycsw配\"\n\"置中的所有元数据记录提供服务。\"\n\n#: ../../oarec-support.rst:82\nmsgid \"\"\n\"OGC API - Records support exposes parent metadata as distinct \"\n\"collections, reducing the barrier for users querying on a specific \"\n\"collection, for multiple collections. This functionality is implemented \"\n\"by default and does not require additional setup/configuration by the \"\n\"user. More information on this feature can be found in `RFC 10: OGC API \"\n\"- Records virtual collections support`_.\"\nmsgstr \"\"\n\"OGC API - 记录支持将父元数据公开为不同的集合，从而减少用户查询特定集合和\"\n\"多个集合的障碍。此功能是默认实现的，不需要用户进行额外的设置/配置。有关此\"\n\"功能的更多信息，请参阅 `RFC 10：OGC API - 记录虚拟集合支持`_。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/odc.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2016-12-17 17:33+0800\\n\"\n\"PO-Revision-Date: 2018-12-05 10:32+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Generated-By: Babel 2.3.4\\n\"\n\"Language: zh\\n\"\n\"X-Generator: Poedit 2.0.6\\n\"\n\n#: ../../odc.rst:4\nmsgid \"Open Data Catalog Configuration\"\nmsgstr \"开放性数据目录配置\"\n\n#: ../../odc.rst:6\nmsgid \"\"\n\"Open Data Catalog (https://github.com/azavea/Open-Data-Catalog/) is an \"\n\"open data catalog based on Django, Python and PostgreSQL. It was \"\n\"originally developed for OpenDataPhilly.org, a portal that provides \"\n\"access to open data sets, applications, and APIs related to the \"\n\"Philadelphia region. The Open Data Catalog is a generalized version of \"\n\"the original source code with a simple skin. It is intended to display \"\n\"information and links to publicly available data in an easily searchable \"\n\"format. The code also includes options for data owners to submit data \"\n\"for consideration and for registered public users to nominate a type of \"\n\"data they would like to see openly available to the public.\"\nmsgstr \"\"\n\"开放数据目录（https://github.com/azavea/open-data-catalog/）是一种基于\"\n\"Django，Python和PostgreSQL的。它最初为opendataphilly.org（一个门户网站）\"\n\"提供开放的数据集，应用程序，并其API与费城地区相关。开放数据目录是一个通用\"\n\"的原始版本的源代码，其皮肤也很简易。它以显示信息为主，以检索便宜为主。该\"\n\"代码还包括数据所有者提交的数据代码，会指定一种数据类型供注册的公共用户参\"\n\"考，他们很乐意为公众公开信息。\"\n\n#: ../../odc.rst:8\nmsgid \"\"\n\"pycsw supports binding to an existing Open Data Catalog repository for \"\n\"metadata query. The binding is read-only (transactions are not in \"\n\"scope, as Open Data Catalog manages repository metadata changes in the \"\n\"application proper).\"\nmsgstr \"\"\n\"pycsw绑定到用于元数据查询的现有公开数据目录库。此绑定是只读文件（交易不在\"\n\"范围内，Open Data Catalog在适当的应用程序中管理元数据库）\"\n\n#: ../../odc.rst:11\nmsgid \"Open Data Catalog Setup\"\nmsgstr \"开放数据目录设置\"\n\n#: ../../odc.rst:13\nmsgid \"\"\n\"Open Data Catalog provides CSW functionality using pycsw out of the box \"\n\"(installing ODC will also install pycsw). Settings are defined in \"\n\"https://github.com/azavea/Open-Data-Catalog/blob/master/OpenDataCatalog/\"\n\"settings.py#L165.\"\nmsgstr \"\"\n\"开放数据目录提供了CSW功能，pycsw无需设置，开箱即用（安装ODC需安装pycsw）。\"\n\"设置在 https://github.com/azavea/Open-Data-Catalog/blob/master/OpenDataCatalog/settings.py#L165 中。\"\n\n#: ../../odc.rst:15\nmsgid \"\"\n\"ODC settings must ensure that ``REGISTRY_PYCSW['repository']['source']`` \"\n\"is set to``hypermap.search.pycsw_repository``.\"\nmsgstr \"\"\n\"ODC设置必须确保 ``REGISTRY_PYCSW['repository']['source']`` 被设置为\"\n\"``hypermap.search.pycsw_repository`` .\"\n\n#: ../../odc.rst:17\nmsgid \"\"\n\"At this point, pycsw is able to read from the Open Data Catalog \"\n\"repository using the Django ORM.\"\nmsgstr \"在这一点上，pycsw 可以用 Django 的 ORM 从数据目录库中读取。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/opensearch.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 13:56+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../opensearch.rst:4\nmsgid \"OpenSearch Support\"\nmsgstr \"OpenSearch支撑\"\n\n#: ../../opensearch.rst:6\nmsgid \"\"\n\"pycsw OpenSearch support is enabled by default. There are two ways to \"\n\"access OpenSearch depending on the deployment pattern chosen.\"\nmsgstr \"\"\n\"pycsw OpenSearch 支持默认启用。 根据选择的部署模式，有两种访问 \"\n\"OpenSearch 的方法。\"\n\n#: ../../opensearch.rst:10\nmsgid \"OARec deployment\"\nmsgstr \"OARec 部署\"\n\n#: ../../opensearch.rst:17\nmsgid \"CSW legacy deployment\"\nmsgstr \"CSW 遗留部署\"\n\n#: ../../opensearch.rst:19\nmsgid \"\"\n\"HTTP requests must be specified with ``mode=opensearch`` in the base URL \"\n\"for OpenSearch requests, e.g.:\"\nmsgstr \"\"\n\"HTTP请求必须在OpenSearch要求的基准URL中指定 ``mode=opensearch`` ，例如：\"\n\n#: ../../opensearch.rst:25\nmsgid \"\"\n\"This will return the Description document which can then be \"\n\"`autodiscovered `_.\"\nmsgstr \"\"\n\"这将返回描述文档 `autodiscovered `_。\"\n\n#: ../../opensearch.rst:28\nmsgid \"OGC OpenSearch Geo and Time Extensions 1.0\"\nmsgstr \"OGC OpenSearch 地理和时间扩展 1.0\"\n\n#: ../../opensearch.rst:30\nmsgid \"\"\n\"pycsw supports the `OGC OpenSearch Geo and Time Extensions 1.0`_ \"\n\"standard via the following conformance classes:\"\nmsgstr \"\"\n\"pycsw 通过以下一致性类支持 `OGC OpenSearch Geo and Time Extensions 1.0`_ \"\n\"标准：\"\n\n#: ../../opensearch.rst:32\nmsgid \"\"\n\"Core (GeoSpatial Service) ``{searchTerms}``, ``{geo:box}``, \"\n\"``{startIndex}``, ``{count}``\"\nmsgstr \"\"\n\"核心（地理空间服务） ``{searchTerms}`` ， ``{geo:box}`` ，``{startIndex}\"\n\"`` ， ``{count}``\"\n\n#: ../../opensearch.rst:33\nmsgid \"Temporal Search core ``{time:start}``, ``{time:end}``\"\nmsgstr \"时间搜索核心 ``{time:start}`` ， ``{time:end}``\"\n\n#: ../../opensearch.rst:36 ../../opensearch.rst:50\nmsgid \"Supported Query Parameters\"\nmsgstr \"支持的查询参数\"\n\n#: ../../opensearch.rst:38\nmsgid \"``q``\"\nmsgstr \"``q``\"\n\n#: ../../opensearch.rst:39\nmsgid \"``time``\"\nmsgstr \"``time``\"\n\n#: ../../opensearch.rst:40\nmsgid \"``bbox``\"\nmsgstr \"``bbox``\"\n\n#: ../../opensearch.rst:43\nmsgid \"OGC OpenSearch Extension for Earth Observation\"\nmsgstr \"用于地球观测的 OGC OpenSearch 扩展\"\n\n#: ../../opensearch.rst:45\nmsgid \"\"\n\"pycsw supports the `OGC OpenSearch Extension for Earth Observation`_ \"\n\"standard via the following conformance classes:\"\nmsgstr \"\"\n\"pycsw 通过以下一致性类支持 `OGC OpenSearch Extension for Earth \"\n\"Observation`_ 标准：\"\n\n#: ../../opensearch.rst:47\nmsgid \"Core\"\nmsgstr \"核心\"\n\n#: ../../opensearch.rst:52\nmsgid \"``eo:cloudCover``\"\nmsgstr \"``eo:cloudCover``\"\n\n#: ../../opensearch.rst:53\nmsgid \"``eo:instrument``\"\nmsgstr \"``eo:instrument``\"\n\n#: ../../opensearch.rst:54 ../../opensearch.rst:71\nmsgid \"``eo:orbitDirection``\"\nmsgstr \"``eo:orbitDirection``\"\n\n#: ../../opensearch.rst:55 ../../opensearch.rst:70\nmsgid \"``eo:orbitNumber``\"\nmsgstr \"``eo:orbitNumber``\"\n\n#: ../../opensearch.rst:56\nmsgid \"``eo:platform``\"\nmsgstr \"``eo:platform``\"\n\n#: ../../opensearch.rst:57 ../../opensearch.rst:73\nmsgid \"``eo:processingLevel``\"\nmsgstr \"``eo:processingLevel``\"\n\n#: ../../opensearch.rst:58 ../../opensearch.rst:69\nmsgid \"``eo:productType``\"\nmsgstr \"``eo:productType``\"\n\n#: ../../opensearch.rst:59\nmsgid \"``eo:sensorType``\"\nmsgstr \"``eo:sensorType``\"\n\n#: ../../opensearch.rst:60 ../../opensearch.rst:72\nmsgid \"``eo:snowCover``\"\nmsgstr \"``eo:snowCover``\"\n\n#: ../../opensearch.rst:61\nmsgid \"``eo:spectralRange``\"\nmsgstr \"``eo:spectralRange``\"\n\n#: ../../opensearch.rst:64\nmsgid \"Mapping of non-19115 Queryable Mappings\"\nmsgstr \"非 19115 可查询映射的映射\"\n\n#: ../../opensearch.rst:66\nmsgid \"\"\n\"The following queryables are implemented as faceted keywords given they \"\n\"are not implemented in generic geospatial metadata standards:\"\nmsgstr \"\"\n\"鉴于以下可查询对象未在通用地理空间元数据标准中实现，它们被实现为分面关键\"\n\"字：\"\n\n#: ../../opensearch.rst:75\nmsgid \"\"\n\"This means metadata ingested into pycsw must have these fields \"\n\"implemented as keywords, as per the examples below:\"\nmsgstr \"\"\n\"这意味着提取到 pycsw 中的元数据必须将这些字段实现为关键字，如下例所示：\"\n\n#: ../../opensearch.rst:108\nmsgid \"OpenSearch Temporal Queries Implementation\"\nmsgstr \"OpenSearch 时态查询实现\"\n\n#: ../../opensearch.rst:110\nmsgid \"\"\n\"By default, pycsw's OpenSearch temporal support will query the Dublin \"\n\"Core ``dc:date`` property as a time instant/single point in time. To \"\n\"enable temporal extent search, set ``profiles=apiso`` which will query \"\n\"the temporal extents of a metadata record (``apiso:TempExtent_begin`` \"\n\"and ``apiso:TempExtent_end``).\"\nmsgstr \"\"\n\"默认情况下，pycsw 的 OpenSearch 时间支持将查询 Dublin Core ``dc:date`` 属\"\n\"性作为时间瞬间/单个时间点。要启用时间范围搜索，请设置 \"\n\"``profiles=apiso``，它将查询元数据记录的时间范围（ （``apiso:\"\n\"TempExtent_begin``和 ``apiso:TempExtent_end``）。\"\n\n#: ../../opensearch.rst:114\nmsgid \"\"\n\"At the HTTP API level, time is supported via either ``time=t1/t2`` or \"\n\"``start=t1&stop=t2``. If the ``time`` parameter is present, it will \"\n\"override the ``start`` and ``stop`` parameters respectively.\"\nmsgstr \"\"\n\"在 HTTP API 级别，时间通过 ``time=t1/t2`` 或 ``start=t1&stop=t2`` 来支\"\n\"持。如果存在 ``time`` 参数，将分别覆盖 ``start`` 和 ``stop`` 参数。\"\n\n#~ msgid \"OpenSearch support is enabled by default.\"\n#~ msgstr \"OpenSearch启动是默认的。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/outputschemas.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2018-12-05 20:36+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 13:59+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.6.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../outputschemas.rst:4\nmsgid \"Output Schema Plugins\"\nmsgstr \"输出模式插件\"\n\n#: ../../outputschemas.rst:7\nmsgid \"Overview\"\nmsgstr \"视图\"\n\n#: ../../outputschemas.rst:9\nmsgid \"\"\n\"pycsw allows for extending the implementation of output schemas to the \"\n\"core standard. outputschemas allow for a client to request metadata in \"\n\"a specific format (ISO, Dublin Core, FGDC, NASA DIF Atom and GM03 are \"\n\"default).\"\nmsgstr \"\"\n\"pycsw 允许将输出模式的实现扩展到核心标准。输出模式允许客户端以特定格式请\"\n\"求元数据（默认为 ISO、都柏林核心、FGDC、NASA DIF Atom 和 GM03）。\"\n\n#: ../../outputschemas.rst:11\nmsgid \"\"\n\"All outputschemas must be placed in the ``pycsw/plugins/outputschemas`` \"\n\"directory.\"\nmsgstr \"所有输出模式必须放在 ``pycsw/plugins/outputschemas`` 目录中。\"\n\n#: ../../outputschemas.rst:14\nmsgid \"Requirements\"\nmsgstr \"要求\"\n\n#: ../../outputschemas.rst:29\nmsgid \"Implementing a new outputschema\"\nmsgstr \"实施新的输出架构\"\n\n#: ../../outputschemas.rst:31\nmsgid \"\"\n\"Create a file in ``pycsw/plugins/outputschemas``, which defines the \"\n\"following:\"\nmsgstr \"\"\n\"在 ``pycsw/plugins/outputschemas`` 中创建一个文件，定义了以下内容：\"\n\n#: ../../outputschemas.rst:33\nmsgid \"\"\n\"``NAMESPACE``: the default namespace of the outputschema which will be \"\n\"advertised\"\nmsgstr \"``NAMESPACE``：将被公布的输出模式的默认命名空间\"\n\n#: ../../outputschemas.rst:34\nmsgid \"``NAMESPACE``: dict of all applicable namespaces to outputschema\"\nmsgstr \"``NAMESPACE``：输出模式的所有适用命名空间的字典\"\n\n#: ../../outputschemas.rst:35\nmsgid \"\"\n\"``XPATH_MAPPINGS``: dict of pycsw core queryables mapped to the \"\n\"equivalent XPath of the outputschema\"\nmsgstr \" ``XPATH_MAPPINGS`` : pycsw 核心查询目录映射到输出空间的等效XPath\"\n\n#: ../../outputschemas.rst:36\nmsgid \"\"\n\"``write_record``: function which returns a record as an ``lxml.etree.\"\n\"Element`` object\"\nmsgstr \"``write_record``：将记录作为``lxml.etree.Element``对象返回的函数\"\n\n#: ../../outputschemas.rst:38\nmsgid \"\"\n\"Add the name of the file to ``__init__.py:__all__``. The new \"\n\"outputschema is now supported in pycsw.\"\nmsgstr \"\"\n\"将文件名添加到 ``__init__.py:__all__`` 。新的输出架构就在 pycsw中。\"\n\n#: ../../outputschemas.rst:41\nmsgid \"Testing\"\nmsgstr \"测试\"\n\n#: ../../outputschemas.rst:43\nmsgid \"\"\n\"New outputschemas must add examples to the :ref:`tests` interface, which \"\n\"must provide example requests specific to the profile.\"\nmsgstr \"\"\n\"新的输出模式必须向 :ref:`tests` 接口添加示例，该接口必须提供特定于配置文\"\n\"件的示例请求。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/profiles.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2018-12-05 20:36+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 15:44+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.6.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../profiles.rst:4\nmsgid \"Profile Plugins\"\nmsgstr \"配置文件的插件\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:7\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:35\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:7 ../../profiles.rst:7\nmsgid \"Overview\"\nmsgstr \"视图\"\n\n#: ../../profiles.rst:9\nmsgid \"\"\n\"pycsw allows for the implementation of profiles to the core standard. \"\n\"Profiles allow specification of additional metadata format types (i.e. ISO \"\n\"19139:2007, NASA DIF, INSPIRE, etc.) to the repository, which can be queried \"\n\"and presented to the client. pycsw supports a plugin architecture which \"\n\"allows for runtime loading of Python code.\"\nmsgstr \"\"\n\"pycsw 使配置文件达到核心标准。配置文件允许其余元数据格式类型 (例如ISO \"\n\"19139:2007, NASA DIF, INSPIRE等) 特定到存储库，此配置文件可以查询，也可以提交\"\n\"给客户端。pycsw 支持插件体系结构，也支持运行时加载的 Python 代码。\"\n\n#: ../../profiles.rst:11\nmsgid \"All profiles must be placed in the ``pycsw/plugins/profiles`` directory.\"\nmsgstr \"所有的配置文件必须放在 ``pycsw/plugins/profiles`` 目录中。\"\n\n#: ../../profiles.rst:14\nmsgid \"Requirements\"\nmsgstr \"要求\"\n\n#: ../../profiles.rst:30\nmsgid \"Abstract Base Class Definition\"\nmsgstr \"抽象基类定义\"\n\n#: ../../profiles.rst:32\nmsgid \"\"\n\"All profile code must be instantiated as a subclass of ``profile.Profile``. \"\n\"Below is an example to add a ``Foo`` profile:\"\nmsgstr \"\"\n\"配置文件的所有代码须实例化为 ``profile.Profile`` 。下面是一个添加配置文件 \"\n\"``Foo`` 的示例：\"\n\n#: ../../profiles.rst:53\nmsgid \"\"\n\"Your profile plugin class (``FooProfile``) must implement all methods as per \"\n\"``profile.Profile``. Profile methods must always return ``lxml.etree.\"\n\"Element`` types, or ``None``.\"\nmsgstr \"\"\n\"配置插件类 ( ``FooProfile`` ) 必须按照 ``profile.Profile`` 完成所有的配置工\"\n\"作。配置文件方法须保持 ``lxml.etree.Element`` 类型或 ``None``。\"\n\n#: ../../profiles.rst:56\nmsgid \"Enabling Profiles\"\nmsgstr \"启用配置文件\"\n\n#: ../../profiles.rst:58\nmsgid \"\"\n\"All profiles are disabled by default. To specify profiles at runtime, set \"\n\"the ``server.profiles`` value in the :ref:`configuration` to the name of the \"\n\"package (in the ``pycsw/plugins/profiles`` directory). To enable multiple \"\n\"profiles, specify as a comma separated value (see :ref:`configuration`).\"\nmsgstr \"\"\n\"所有配置文件默认是不可用的。若要指定在运行时的配置文件，在参考文件 :ref:\"\n\"`configuration` 中设置 ``server.profiles`` 值（在 ``pycsw/plugins/profiles`` \"\n\"目录中）。若要启用多个配置文件，请指定值（以逗号分隔） (请参见 :ref:\"\n\"`configuration` )。\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:27\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:27 ../../profiles.rst:61\nmsgid \"Testing\"\nmsgstr \"测试\"\n\n#: ../../profiles.rst:63\nmsgid \"\"\n\"Profiles must add examples to the :ref:`tests` interface, which must provide \"\n\"example requests specific to the profile.\"\nmsgstr \"\"\n\"配置文件必须添加到 :ref:`tests` 接口，此接口须提供特定于该配置文件的示例请求。\"\n\n#: ../../profiles.rst:66\nmsgid \"Supported Profiles\"\nmsgstr \"支持的配置文件\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:4\nmsgid \"ISO Metadata Application Profile (1.0.0)\"\nmsgstr \"ISO 元数据应用程序配置文件 (1.0.0)\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:8\nmsgid \"\"\n\"The ISO Metadata Application Profile (APISO) is a profile of CSW 2.0.2 which \"\n\"enables discovery of geospatial metadata following ISO 19139:2007 and ISO \"\n\"19119:2005/PDAM 1.\"\nmsgstr \"\"\n\"ISO 元数据应用程序配置文件 (APISO) 是CSW 2.0.2的配置文件，是继地理空间元数据 \"\n\"ISO 19139:2007 和 ISO 19119:2005 之后开发的文件。\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:11\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:40\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:11\nmsgid \"Configuration\"\nmsgstr \"配置\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:13\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:13\nmsgid \"No extra configuration is required.\"\nmsgstr \"不需要其余配置。\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:16\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:16\nmsgid \"Querying\"\nmsgstr \"查询\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:18\nmsgid \"**typename**: ``gmd:MD_Metadata``\"\nmsgstr \"**类型名**：``gmd:MD_Metadata``\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:19\nmsgid \"**outputschema**: ``http://www.isotc211.org/2005/gmd``\"\nmsgstr \"**输出模式**：``http://www.isotc211.org/2005/gmd``\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:22\nmsgid \"Enabling APISO Support\"\nmsgstr \"启用 APISO 支持\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:24\nmsgid \"\"\n\"To enable APISO support, add ``apiso`` to ``server.profiles`` as specified \"\n\"in :ref:`configuration`.\"\nmsgstr \"\"\n\"要启用 APISO 支持，请将 ``apiso`` 添加到 ``server.profiles`` 中，如 :ref:\"\n\"`configuration` 中指定的那样。\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:29\nmsgid \"\"\n\"A testing interface is available in ``tests/index.html`` which contains tests \"\n\"specific to APISO to demonstrate functionality. See :ref:`tests` for more \"\n\"information.\"\nmsgstr \"\"\n\"``tests/index.html`` 中提供了一个测试接口，其中包含特定于 APISO 的测试以演示功\"\n\"能。更多信息参见:ref:`tests`。\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:32\nmsgid \"INSPIRE Extension\"\nmsgstr \"启发扩展\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:37\nmsgid \"\"\n\"APISO includes an extension for enabling `INSPIRE Discovery Services 3.0`_ \"\n\"support. To enable the INSPIRE extension to APISO, create a ``[metadata:\"\n\"inspire]`` section in the main configuration with ``enabled`` set to ``true``.\"\nmsgstr \"\"\n\"APISO 包括启用 `INSPIRE Discovery Services 3.0`_ 的扩展。 若要启用 INSPIRE扩展\"\n\"到 APISO，需要用 ``enabled`` set to ``true`` 在主要的配置中创建 ``[metadata:\"\n\"inspire]`` 部分。\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:42\nmsgid \"**[metadata:inspire]**\"\nmsgstr \"**[元数据：inspire]**\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:44\nmsgid \"\"\n\"**enabled**: whether to enable the INSPIRE extension (``true`` or ``false``)\"\nmsgstr \"**启用**: 是否启用INSPIRE扩展 （ ``true`` 或 ``false``）\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:45\nmsgid \"\"\n\"**languages_supported**: supported languages (see http://inspire.ec.europa.eu/\"\n\"schemas/common/1.0/enums/enum_eng.xsd, simpleType ``euLanguageISO6392B``)\"\nmsgstr \"\"\n\"**支持的语言**： （见 http://inspire.ec.europa.eu/schemas/common/1.0/enums/\"\n\"enum_eng.xsd ，simpleType ``euLanguageISO6392B`` ）\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:46\nmsgid \"\"\n\"**default_language**: the default language (see http://inspire.ec.europa.eu/\"\n\"schemas/common/1.0/enums/enum_eng.xsd, simpleType ``euLanguageISO6392B``)\"\nmsgstr \"\"\n\"**默认语言**：（见 http://inspire.ec.europa.eu/schemas/common/1.0/enums/\"\n\"enum_eng.xsd，simpleType ' euLanguageISO6392B '）\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:47\nmsgid \"**date**: date of INSPIRE metadata offering (in `ISO 8601`_ format)\"\nmsgstr \"**date**: INSPIRE元数据的日期 （ `ISO 8601`_ 格式）\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:48\nmsgid \"\"\n\"**gemet_keywords**: a comma-seperated keyword list of `GEMET INSPIRE theme \"\n\"keywords`_ about the service (see http://inspire.ec.europa.eu/schemas/\"\n\"common/1.0/enums/enum_eng.xsd, complexType ``inspireTheme_eng``)\"\nmsgstr \"\"\n\"**gemet_keywords**: 关于服务的，以逗号分隔的关键字列表 `GEMET INSPIRE 主题关键\"\n\"词`_ （参见 http://inspire.ec.europa.eu/schemas/common/1.0/enums/enum_eng.\"\n\"xsd，complexType ``inspireTheme_eng`` ）\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:49\nmsgid \"\"\n\"**conformity_service**: the level of INSPIRE conformance for spatial data \"\n\"sets and services (``conformant``, ``notConformant``, ``notEvaluated``)\"\nmsgstr \"\"\n\"conformity_service: 以空间数据集和服务 (``conformant``, ``notConformant``, \"\n\"``notEvaluated``)为目标的INSPIRE级别\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:50\nmsgid \"\"\n\"**contact_organization**: the organization name responsible for the INSPIRE \"\n\"metadata\"\nmsgstr \"contact_organization: 负责 INSPIRE元数据的组织名称\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:51\nmsgid \"\"\n\"**contact_email**: the email address of entity responsible for the INSPIRE \"\n\"metadata\"\nmsgstr \"contact_email: 负责 INSPIRE元数据实体的电子邮件地址\"\n\n#: ../../../pycsw/plugins/profiles/apiso/docs/apiso.rst:52\nmsgid \"\"\n\"**temp_extent**: temporal extent of the service (in `ISO 8601`_ format). \"\n\"Either a single date (i.e. ``yyyy-mm-dd``), or an extent (i.e. ``yyyy-mm-dd/\"\n\"yyyy-mm-dd``)\"\nmsgstr \"\"\n\"**temp_extent**: （ `ISO 8601`_ 格式）服务时间。 单个日期 ( ``yyyy-mm-dd`` ) \"\n\"或多数以 ( ``yyyy-mm-dd/yyyy-mm-dd`` )\"\n\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:4\nmsgid \"CSW-ebRIM Registry Service - Part 1: ebRIM profile of CSW\"\nmsgstr \"CSW-ebRIM注册服务-第一部分: CSW的ebRIM 配置文件\"\n\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:8\nmsgid \"\"\n\"The CSW-ebRIM Registry Service is a profile of CSW 2.0.2 which enables \"\n\"discovery of geospatial metadata following the ebXML information model.\"\nmsgstr \"\"\n\"CSW-ebRIM注册服务是CSW 2.0.2的配置文件，是继ebXML 信息模型之后的地理空间元数据\"\n\"配置文件。\"\n\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:18\nmsgid \"**typename**: ``rim:RegistryObject``\"\nmsgstr \"类型名称: ' rim: RegistryObject '\"\n\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:19\nmsgid \"**outputschema**: ``urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0``\"\nmsgstr \"输出模式: ' urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0'\"\n\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:22\nmsgid \"Enabling ebRIM Support\"\nmsgstr \"启用 ebRIM 支持\"\n\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:24\nmsgid \"\"\n\"To enable ebRIM support, add ``ebrim`` to ``server.profiles`` as specified \"\n\"in :ref:`configuration`.\"\nmsgstr \"\"\n\"若要启用 ebRIM 支持，需添加 ``ebrim`` 到 ``server.profiles`` ，以 作为指定的 :\"\n\"ref:`configuration`。\"\n\n#: ../../../pycsw/plugins/profiles/ebrim/docs/ebrim.rst:29\nmsgid \"\"\n\"A testing interface is available in ``tests/index.html`` which contains tests \"\n\"specific to ebRIM to demonstrate functionality. See :ref:`tests` for more \"\n\"information.\"\nmsgstr \"\"\n\"测试接口在 ``tests/index.html`` 可用，其包含特定于ebRIM演示功能的测试。请参\"\n\"见 :ref:`tests` 及其它更多信息。\"\n\n#~ msgid \"typename\"\n#~ msgstr \"类型名称\"\n\n#~ msgid \"outputschema\"\n#~ msgstr \"输出模式\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/repofilters.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:22+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../repofilters.rst:4\nmsgid \"Repository Filters\"\nmsgstr \"存储库中的筛选器\"\n\n#: ../../repofilters.rst:6\nmsgid \"\"\n\"pycsw has the ability to perform server side repository / database filters as a \"\n\"means to mask all requests to query against a specific subset of the metadata \"\n\"repository, thus providing the ability to deploy multiple pycsw instances \"\n\"pointing to the same database in different ways via the ``repository.filter`` \"\n\"configuration option.\"\nmsgstr \"\"\n\"pycsw 能够执行服务器端存储库/数据库过滤器，以屏蔽所有查询以查询元数据存储库的特\"\n\"定子集的请求，从而提供通过 ` 以不同方式部署指向同一数据库的多个 pycsw 实例的能\"\n\"力 `repository.filter` 配置选项。\"\n\n#: ../../repofilters.rst:8\nmsgid \"\"\n\"Repository filters are a convenient way to subset your repository at the server \"\n\"level without the hassle of creating proper database views. For large \"\n\"repositories, it may be better to subset at the database level for performance.\"\nmsgstr \"\"\n\"存储库过滤器是一种在服务器级别对存储库进行子集化的便捷方式，无需创建适当的数据库\"\n\"视图。对于大型存储库，最好在数据库级别进行子集化以提高性能。\"\n\n#: ../../repofilters.rst:11\nmsgid \"Scenario: One Database, Many Views\"\nmsgstr \"场景 ︰ 一个数据库，很多种视角\"\n\n#: ../../repofilters.rst:13\nmsgid \"Imagine a sample database table of records (subset below for brevity):\"\nmsgstr \"想象一个示例数据库记录表（为简洁起见，下面的子集）：\"\n\n#: ../../repofilters.rst:1\nmsgid \"identifier\"\nmsgstr \"标识符\"\n\n#: ../../repofilters.rst:1\nmsgid \"parentidentifier\"\nmsgstr \"父标识符\"\n\n#: ../../repofilters.rst:1\nmsgid \"title\"\nmsgstr \"标题\"\n\n#: ../../repofilters.rst:1\nmsgid \"abstract\"\nmsgstr \"摘要\"\n\n#: ../../repofilters.rst:1\nmsgid \"1\"\nmsgstr \"1\"\n\n#: ../../repofilters.rst:1\nmsgid \"33\"\nmsgstr \"33\"\n\n#: ../../repofilters.rst:1\nmsgid \"foo1\"\nmsgstr \"foo1\"\n\n#: ../../repofilters.rst:1\nmsgid \"bar1\"\nmsgstr \"bar1\"\n\n#: ../../repofilters.rst:1\nmsgid \"2\"\nmsgstr \"2\"\n\n#: ../../repofilters.rst:1\nmsgid \"foo2\"\nmsgstr \"foo2\"\n\n#: ../../repofilters.rst:1\nmsgid \"bar2\"\nmsgstr \"bar2\"\n\n#: ../../repofilters.rst:1\nmsgid \"3\"\nmsgstr \"3\"\n\n#: ../../repofilters.rst:1\nmsgid \"55\"\nmsgstr \"55\"\n\n#: ../../repofilters.rst:1\nmsgid \"foo3\"\nmsgstr \"foo3\"\n\n#: ../../repofilters.rst:1\nmsgid \"bar3\"\nmsgstr \"bar3\"\n\n#: ../../repofilters.rst:1\nmsgid \"4\"\nmsgstr \"4\"\n\n#: ../../repofilters.rst:1\nmsgid \"5\"\nmsgstr \"5\"\n\n#: ../../repofilters.rst:1\nmsgid \"21\"\nmsgstr \"21\"\n\n#: ../../repofilters.rst:1\nmsgid \"foo5\"\nmsgstr \"foo5\"\n\n#: ../../repofilters.rst:1\nmsgid \"bar5\"\nmsgstr \"bar5\"\n\n#: ../../repofilters.rst:1\nmsgid \"foo6\"\nmsgstr \"foo6\"\n\n#: ../../repofilters.rst:1\nmsgid \"bar6\"\nmsgstr \"bar6\"\n\n#: ../../repofilters.rst:25\nmsgid \"\"\n\"A default pycsw instance (with no ``repository.filters`` option) will always \"\n\"process requests against the entire table. So a CSW `GetRecords` filter like:\"\nmsgstr \"\"\n\"默认的 pycsw 实例（没有 ``repository.filters`` 选项）将始终处理针对整个表的请\"\n\"求。因此 CSW `GetRecords` 过滤器如：\"\n\n#: ../../repofilters.rst:36\nmsgid \"...will return:\"\nmsgstr \"...将返回：\"\n\n#: ../../repofilters.rst:44\nmsgid \"\"\n\"Suppose you wanted to deploy another pycsw instance which serves metadata from \"\n\"the same database, but only from a specific subset. Here we set the \"\n\"``repository.filter`` option:\"\nmsgstr \"\"\n\"假设想部署另一个 pycsw 实例，该实例提供来自同一数据库的元数据，但仅来自特定子\"\n\"集。在这里，设置了 ``repository.filter`` 选项：\"\n\n#: ../../repofilters.rst:52 ../../repofilters.rst:67\nmsgid \"\"\n\"The same CSW `GetRecords` filter as per above then yields the following results:\"\nmsgstr \"依上述所说，同一CSW `GetRecords` 过滤器将得到以下结果：\"\n\n#: ../../repofilters.rst:59\nmsgid \"Another example:\"\nmsgstr \"另一个例子：\"\n\n#: ../../repofilters.rst:74\nmsgid \"\"\n\"The ``repository.filter`` option accepts all core queryables set in the pycsw \"\n\"core model (see ``pycsw.config.StaticContext.md_core_model`` for the complete \"\n\"list).\"\nmsgstr \"\"\n\"该 ``repository.filter`` 选项功能是在pycsw核心模式中接收所有核心查询设置（见\"\n\"``pycsw.config.StaticContext.md_core_model`` 的完整列表）。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/repositories.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2015, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2016.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.1-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:23+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../repositories.rst:4\nmsgid \"Repository Plugins\"\nmsgstr \"库插件\"\n\n#: ../../repositories.rst:7\nmsgid \"Overview\"\nmsgstr \"概述\"\n\n#: ../../repositories.rst:9\nmsgid \"\"\n\"pycsw allows for the implementation of custom repositories in order to connect to a backend different from the pycsw's default. This is especially useful when downstream applications manage their \"\n\"own metadata model/database/document store and want pycsw to connect to it directly instead of using pycsw's default model, thus creating duplicate repositories which then require syncronization/\"\n\"accounting. Repository plugins enable a single metadata backend which is independent from the pycsw setup. pycsw thereby becomes a pure wrapper around a given backend in providing OARec, CSW and \"\n\"other APIs atop a given application.\"\nmsgstr \"\"\n\"pycsw 允许实现自定义存储库，以便连接到与 pycsw 默认不同的后端。当下游应用程序管理自己的元数据模型/数据库/文档存储并希望 pycsw 直接连接到它而不是使用 pycsw 的默认模型时，这尤其有用，从而创建了需要同步/\"\n\"记帐的重复存储库。存储库插件启用独立于 pycsw 设置的单个元数据后端。因此，pycsw 成为给定后端的纯包装器，在给定应用程序之上提供 OARec、CSW 和其他 API。\"\n\n#: ../../repositories.rst:11\nmsgid \"All outputschemas must be placed in the ``pycsw/plugins/outputschemas`` directory.\"\nmsgstr \"所有输出模式必须放在 ``pycsw/plugins/outputschemas`` 目录中。\"\n\n#: ../../repositories.rst:14\nmsgid \"Requirements\"\nmsgstr \"要求\"\n\n#: ../../repositories.rst:16\nmsgid \"Repository plugins:\"\nmsgstr \"存储库插件：\"\n\n#: ../../repositories.rst:18\nmsgid \"can be developed and referenced / connected external to pycsw\"\nmsgstr \"可以在PYCSW外部开发和引用/连接\"\n\n#: ../../repositories.rst:19\nmsgid \"must be accessible within the ``PYTHONPATH`` of a given application\"\nmsgstr \"必须在给定应用程序的 ``PYTHONPATH`` 内访问\"\n\n#: ../../repositories.rst:20\nmsgid \"must implement pycsw's ``pycsw.core.repository.Repository`` properties and methods\"\nmsgstr \"必须实现 pycsw's ``pycsw.core.repository.Repository`` 属性和方法\"\n\n#: ../../repositories.rst:21\nmsgid \"must be specified in the pycsw :ref:`configuration` as a class reference (e.g. ``path.to.repo_plugin.MyRepository``)\"\nmsgstr \"必须在 pycsw :ref:`configuration` 中指定为类引用(例如(e.g. ``path.to.repo_plugin.MyRepository`` )\"\n\n#: ../../repositories.rst:22\nmsgid \"must minimally implement the ``query_insert``, ``query_domain``, ``query_ids``, and ``query`` methods\"\nmsgstr \"必须最低限度地实现 ``query_insert``, ``query_domain``, ``query_ids``, and ``query`` 方法\"\n\n#: ../../repositories.rst:25\nmsgid \"Configuration\"\nmsgstr \"配置\"\n\n#: ../../repositories.rst:27\nmsgid \"set pycsw's ``repository.source`` setting to the class which implements the custom repository:\"\nmsgstr \"设置pycsw的``repository.source``，成为实现自定义存储库的类：\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/sitemaps.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2015-11-23 21:42+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:24+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=UTF-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../sitemaps.rst:4\nmsgid \"XML Sitemaps\"\nmsgstr \"XML网站地图\"\n\n#: ../../sitemaps.rst:6\nmsgid \"`XML Sitemaps`_ can be generated by running:\"\nmsgstr \"`XML Sitemaps`_ 可以通过运行生成：\"\n\n#: ../../sitemaps.rst:12\nmsgid \"\"\n\"The ``sitemap.xml`` file should be saved to an an area on your web server \"\n\"(parallel to or above your pycsw install location) to enable web crawlers \"\n\"to index your repository.\"\nmsgstr \"\"\n\"``sitemap.xml`` 文件应该保存到网络服务器上的一个区域（平行于或高于你的 \"\n\"pycsw 安装位置），以使网络爬虫能够索引你的存储库。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/soap.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:26+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../soap.rst:4\nmsgid \"SOAP\"\nmsgstr \"简单对象访问协议\"\n\n#: ../../soap.rst:6\nmsgid \"\"\n\"pycsw's CSW implementation supports handling of SOAP encoded requests and \"\n\"responses as per subclause 10.3.2 of OGC:CSW 2.0.2. SOAP request examples can \"\n\"be found in ``tests/index.html``.\"\nmsgstr \"\"\n\"pycsw 的 CSW 实现支持按照 OGC:CSW 2.0.2 的子条款 10.3.2 处理 SOAP 编码的请求和响\"\n\"应。SOAP 请求示例可以在 ``tests/index.html`` 中找到。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/sru.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:28+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../sru.rst:4\nmsgid \"Search/Retrieval via URL (SRU) Support\"\nmsgstr \"通过 URL (SRU) 支持搜索/检索\"\n\n#: ../../sru.rst:6\nmsgid \"\"\n\"pycsw supports the `Search/Retrieval via URL`_ search protocol \"\n\"implementation as per subclause 8.4 of the OpenGIS Catalogue Service \"\n\"Implementation Specification.\"\nmsgstr \"\"\n\"根据 OpenGIS 目录服务实现规范的第 8.4 条，pycsw 支持 `通过 URL 搜索/检索`_ \"\n\"搜索协议实现。\"\n\n#: ../../sru.rst:8\nmsgid \"\"\n\"SRU support is enabled by default. There are two ways to access SRU \"\n\"depending on the deployment pattern chosen.\"\nmsgstr \"SRU 支持默认启用。根据所选的部署模式，有两种访问 SRU 的方法。\"\n\n#: ../../sru.rst:12\nmsgid \"OARec deployment\"\nmsgstr \"OARec 部署\"\n\n#: ../../sru.rst:19\nmsgid \"CSW legacy deployment\"\nmsgstr \"CSW 遗留部署\"\n\n#: ../../sru.rst:21\nmsgid \"\"\n\"HTTP GET requests must be specified with ``mode=sru`` for SRU requests, e.\"\n\"g.:\"\nmsgstr \"对于 SRU 请求，HTTP GET 请求必须使用 ``mode=sru`` 指定，例如：\"\n\n#: ../../sru.rst:27\nmsgid \"\"\n\"See https://www.loc.gov/standards/sru/misc/simple.html for example SRU \"\n\"requests.\"\nmsgstr \"\"\n\"有关 SRU 请求的示例，请参见 https://www.loc.gov/standards/sru/misc/simple.\"\n\"html。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/stac.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) 2010-2022, Tom Kralidis This work is licensed under a\n# Creative Commons Attribution 4.0 International License\n# This file is distributed under the same license as the pycsw package.\n# FIRST AUTHOR , 2022.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 3.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:31+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=UTF-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../stac.rst:4\nmsgid \"SpatioTemporal Asset Catalog (STAC) API Support\"\nmsgstr \"时空资产目录 (STAC) API 支持\"\n\n#: ../../stac.rst:7\nmsgid \"Versions\"\nmsgstr \"版本\"\n\n#: ../../stac.rst:9\nmsgid \"\"\n\"pycsw supports `SpatioTemporal Asset Catalog API version v1.0.0`_ \"\n\"by default.\"\nmsgstr \"\"\n\"pycsw 默认支持 `SpatioTemporal Asset Catalog API version v1.0.0`_。\"\n\n#: ../../stac.rst:11\nmsgid \"pycsw implements provides STAC support in the following manner:\"\nmsgstr \"pycsw 实现以下列方式提供 STAC 支持：\"\n\n#: ../../stac.rst:13\nmsgid \"a pycsw repository is equivalent to a STAC collection\"\nmsgstr \"pycsw 存储库相当于一个 STAC 集合\"\n\n#: ../../stac.rst:14\nmsgid \"pycsw metadata records are equivalent to STAC items\"\nmsgstr \"pycsw 元数据记录等同于 STAC 项\"\n\n#: ../../stac.rst:16\nmsgid \"\"\n\"The STAC specification is designed with the same principles as OGC API - \"\n\"Records.\"\nmsgstr \"STAC 规范的设计原则与 OGC API - Records 相同。\"\n\n#: ../../stac.rst:19\nmsgid \"Request Examples\"\nmsgstr \"请求示例\"\n\n#: ../../stac.rst:21\nmsgid \"\"\n\"As the OGC successor to CSW, OARec is a change in paradigm rooted in \"\n\"lowering the barrier to entry, being webby/of the web, and focusing on \"\n\"developer experience/adoption. JSON and HTML output formats are both \"\n\"supported via the ``f`` parameter.\"\nmsgstr \"\"\n\"作为 CSW 的 OGC 继任者，OARec 是一种范式变革，其根源在于降低准入门槛、成\"\n\"为 webby/web 并专注于开发人员体验/采用。JSON 和 HTML 输出格式都通过 \"\n\"``f`` 参数支持。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/support.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:32+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../support.rst:4\nmsgid \"Support\"\nmsgstr \"技术支持\"\n\n#: ../../support.rst:7\nmsgid \"Community\"\nmsgstr \"团队\"\n\n#: ../../support.rst:9\nmsgid \"\"\n\"Please see the `Community`_ page for information on the pycsw community, \"\n\"getting support, and how to get involved.\"\nmsgstr \"\"\n\"有关 pycsw 社区、获得支持以及如何参与的信息，请参阅 `Community`_ 页面。\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/testing.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-10 10:12+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../testing.rst:4\nmsgid \"Testing\"\nmsgstr \"测试\"\n\n#: ../../testing.rst:6\nmsgid \"pycsw uses `pytest`_ for managing its automated tests.\"\nmsgstr \"pycsw 使用 `pytest`_ 来管理其自动化测试。\"\n\n#: ../../testing.rst:9\nmsgid \"OGC API - Records\"\nmsgstr \"OGC API - 记录\"\n\n#: ../../testing.rst:11\nmsgid \"\"\n\"Tests for OGC API - Records are located in ``tests/unittests/test_oarec.py``. \"\n\"They can be run as follows:\"\nmsgstr \"\"\n\"OGC API 的测试 - 记录位于 ``tests/unittests/test_oarec.py`` 中。可以按如下方式运\"\n\"行：\"\n\n#: ../../testing.rst:20\nmsgid \"OGC CSW\"\nmsgstr \"OGC CSW\"\n\n#: ../../testing.rst:22\nmsgid \"\"\n\"There are a number of test suites that perform mostly functional testing. These \"\n\"tests ensure that pycsw is compliant with the various supported standards. There \"\n\"is also a growing set of unit tests. These focus on smaller scope testing, in \"\n\"order to verify that individual bits of code are working as expected.\"\nmsgstr \"\"\n\"有许多测试套件主要执行功能测试。这些测试确保 pycsw 符合各种支持的标准。还有越来越\"\n\"多的单元测试。专注于较小范围的测试，以验证各个代码位是否按预期工作。\"\n\n#: ../../testing.rst:28\nmsgid \"\"\n\"Tests can be run locally as part of the development cycle. They are also run on \"\n\"pycsw's `GitHub Actions`_ continuous integration setup against all pushes and \"\n\"pull requests to the code repository.\"\nmsgstr \"\"\n\"测试可以作为开发周期的一部分在本地运行。它们还在 pycsw 的 `GitHub Actions`_ 持续\"\n\"集成设置上运行，针对所有对代码存储库的推送和拉取请求。\"\n\n#: ../../testing.rst:36\nmsgid \"OGC CITE\"\nmsgstr \"OGC引用\"\n\n#: ../../testing.rst:38\nmsgid \"\"\n\"In addition to pycsw's own tests, all public releases are also tested via the \"\n\"OGC `Compliance & Interoperability Testing & Evaluation Initiative`_ (CITE). The \"\n\"pycsw `wiki`_ documents CITE testing procedures and status.\"\nmsgstr \"\"\n\"除了 pycsw 自己的测试之外，所有公开版本还通过 OGC `Compliance & Interoperability \"\n\"Testing & Evaluation Initiative`_ (CITE) 进行测试。pycsw `wiki`_ 记录了 CITE 测试\"\n\"程序和状态。\"\n\n#: ../../testing.rst:44\nmsgid \"Functional test suites\"\nmsgstr \"功能测试套件\"\n\n#: ../../testing.rst:46\nmsgid \"\"\n\"Currently most of pycsw's tests are `functional tests`_. This means that each \"\n\"test case is based on the requirements mandated by the specifications of the \"\n\"various standards that pycsw implements. These tests focus on making sure that \"\n\"pycsw works as expected.\"\nmsgstr \"\"\n\"目前大部分 pycsw 的测试都是`功能测试`_。这意味着每个测试用例都基于 pycsw 实施的各\"\n\"种标准的规范所规定的要求。这些测试的重点是确保 pycsw 按预期工作。\"\n\n#: ../../testing.rst:51\nmsgid \"Each test follows the same workflow:\"\nmsgstr \"每个测试都遵循相同的工作流程：\"\n\n#: ../../testing.rst:53\nmsgid \"\"\n\"Create a new pycsw instance with a custom configuration and data repository for \"\n\"each suite of tests;\"\nmsgstr \"为每个测试套件创建一个新的pycsw实例，该实例具有自定义配置和数据存储库;\"\n\n#: ../../testing.rst:56\nmsgid \"Perform a series of GET and POST requests to the running pycsw instance;\"\nmsgstr \"对正在运行的 pycsw 实例执行一系列 GET 和 POST 请求；\"\n\n#: ../../testing.rst:58\nmsgid \"\"\n\"Compare the results of each request against a previously prepared expected \"\n\"result. If the test result matches the expected outcome the test passes, \"\n\"otherwise it fails.\"\nmsgstr \"\"\n\"将每个请求的结果与预先准备的预期结果进行比较。如果测试结果与预期结果一致，则测试\"\n\"通过，否则失败.\"\n\n#: ../../testing.rst:63\nmsgid \"\"\n\"A number of different test suites exist under ``tests/functionaltests/suites``. \"\n\"Each suite specifies the following structure:\"\nmsgstr \"\"\n\"在 ``tests/functionaltests/suites`` 下存在许多不同的测试套件。每个套件指定以下结\"\n\"构:\"\n\n#: ../../testing.rst:66\nmsgid \"\"\n\"A mandatory ``default.yml`` file with the pycsw configuration that must be used \"\n\"by the test suite;\"\nmsgstr \"测试套件必须使用的带有 pycsw 配置的强制 ``default.yml`` 文件；\"\n\n#: ../../testing.rst:69\nmsgid \"\"\n\"A mandatory ``expected/`` directory containing the expected results for each \"\n\"request;\"\nmsgstr \"包含每个请求的预期结果的强制性 ``expected/`` 目录;\"\n\n#: ../../testing.rst:72\nmsgid \"\"\n\"An optional ``data/`` directory that contains ``.xml`` files with testing data \"\n\"that is to be loaded into the suite's database before running the tests. The \"\n\"presence of this directory and its contents have the following meaning for tests:\"\nmsgstr \"\"\n\"一个可选的 ``data/`` 目录，包含 ``.xml`` 文件，其中包含要在运行测试之前加载到套件\"\n\"数据库中的测试数据。该目录及其内容的存在对测试具有以下意义:\"\n\n#: ../../testing.rst:77\nmsgid \"\"\n\"If ``data/`` directory is present and contains files, they will be loaded into a \"\n\"new database for running the tests of the suite;\"\nmsgstr \"\"\n\"如果 ``data/`` 目录存在并且包含文件，它们将被加载到一个新的数据库中，用于运行套件\"\n\"的测试;\"\n\n#: ../../testing.rst:80\nmsgid \"\"\n\"If ``data/`` directory is present and does not contain any data files, a new \"\n\"empty database is used in the tests;\"\nmsgstr \"如果存在 ``data/`` 目录并且不包含任何数据文件，则在测试中使用新的空数据库;\"\n\n#: ../../testing.rst:83\nmsgid \"\"\n\"If ``data/`` directory is absent, the suite will use a database populated with \"\n\"test data from the ``CITE`` suite.\"\nmsgstr \"\"\n\"如果 ``data/`` 目录不存在，套件将使用填充有 ``CITE`` 套件的测试数据的数据库.\"\n\n#: ../../testing.rst:86\nmsgid \"\"\n\"An optional ``get/requests.txt`` file that holds request parameters used for \"\n\"making HTTP GET requests.\"\nmsgstr \"\"\n\"一个可选的 ``get/requests.txt`` 文件，其中保存用于生成HTTP GET请求的请求参数.\"\n\n#: ../../testing.rst:89\nmsgid \"Each line in the file must be formatted with the following scheme:\"\nmsgstr \"文件中的每一行必须用以下方案格式化:\"\n\n#: ../../testing.rst:91\nmsgid \"test_id,request_query_string\"\nmsgstr \"test_id,request_query_string\"\n\n#: ../../testing.rst:93 ../../testing.rst:111\nmsgid \"For example:\"\nmsgstr \"例如：\"\n\n#: ../../testing.rst:95\nmsgid \"TestGetCapabilities,service=CSW&version=2.0.2&request=GetCapabilities\"\nmsgstr \"TestGetCapabilities,service=CSW&version=2.0.2&request=GetCapabilities\"\n\n#: ../../testing.rst:97\nmsgid \"\"\n\"When tests are run, the *test_id* is used for naming each test and for finding \"\n\"the expected result.\"\nmsgstr \"运行测试时，*test_id* 用于命名每个测试并查找预期结果。\"\n\n#: ../../testing.rst:100\nmsgid \"\"\n\"An optional ``post/`` directory that holds ``.xml`` files used for making HTTP \"\n\"POST requests\"\nmsgstr \"一个可选的 ``post/`` 目录，它包含用于制作HTTP POST请求的 ``.xml`` 文件\"\n\n#: ../../testing.rst:105\nmsgid \"Test identifiers\"\nmsgstr \"测试标识符\"\n\n#: ../../testing.rst:107\nmsgid \"Each test has an identifier that is built using the following rule:\"\nmsgstr \"每个测试都有一个标识符，该标识符是使用以下规则构建的:\"\n\n#: ../../testing.rst:109\nmsgid \"[__]\"\nmsgstr \"[__]\"\n\n#: ../../testing.rst:113\nmsgid \"test_suites[default_post_GetRecords-end]\"\nmsgstr \"test_suites[default_post_GetRecords-end]\"\n\n#: ../../testing.rst:117\nmsgid \"Functional tests' implementation\"\nmsgstr \"功能测试的实现\"\n\n#: ../../testing.rst:119\nmsgid \"\"\n\"Functional tests are generated for each suite directory present under `tests/\"\n\"functionaltests/suites`. Test generation uses pytest's `pytest_generate_tests`_ \"\n\"function. This function is implemented in `tests/functionaltests/conftest.py`. \"\n\"It provides an automatic parametrization of the `tests/functionaltests/\"\n\"test_suites_functional:test_suites` function. This parametrization causes the \"\n\"generation of a test for each of the GET and POST requests defined in a suite's \"\n\"directory.\"\nmsgstr \"\"\n\"对 `tests/functionaltests/suites` 下出现的每个套件目录生成功能测试。测试生成使用\"\n\"pytest's `pytest_generate_tests`_ 功能。这个功能在 `tests/functionaltests/\"\n\"conftest.py` 中实现。它提供了 `tests/functionaltests/test_suites_functional:\"\n\"test_suites` 功能的自动参数化。此参数化导致为套件目录中定义的每个 GET 和 POST 请\"\n\"求生成测试。\"\n\n#: ../../testing.rst:129\nmsgid \"Adding New Tests\"\nmsgstr \"添加新测试\"\n\n#: ../../testing.rst:131\nmsgid \"To add tests to an existing suite:\"\nmsgstr \"在现有套件中添加测试：\"\n\n#: ../../testing.rst:133\nmsgid \"\"\n\"for HTTP POST tests, add XML documents to ``tests/functionaltests/suites//\"\n\"post``\"\nmsgstr \"\"\n\"对于HTTP POST测试，在 ``tests/functionaltests/suites//post`` 添加XML文档\"\n\n#: ../../testing.rst:135\nmsgid \"\"\n\"for HTTP GET tests, add tests (one per line) to ``tests/functionaltests/suites/\"\n\"/get/requests.txt``\"\nmsgstr \"\"\n\"对于HTTP GET测试，在 ``tests/functionaltests/suites//get/requests.txt`` 中\"\n\"添加测试（每行的第一项）\"\n\n#: ../../testing.rst:138\nmsgid \"To add a new test suite:\"\nmsgstr \"添加新的测试套件：\"\n\n#: ../../testing.rst:140\nmsgid \"\"\n\"Create a new directory under ``tests/functionaltests/suites`` (e.g. ``foo``)\"\nmsgstr \"在 ``tests/functionaltests/suites`` （如 ``foo`` )下创建一个新目录\"\n\n#: ../../testing.rst:141\nmsgid \"Create a new configuration in ``tests/suites/foo/default.yml``\"\nmsgstr \"在 ``tests/suites/foo/default.yml`` 创建一个新的配置\"\n\n#: ../../testing.rst:142\nmsgid \"Populate HTTP POST requests in ``tests/suites/foo/post``\"\nmsgstr \"在 ``tests/suites/foo/post`` 填写HTTP POST请求\"\n\n#: ../../testing.rst:143\nmsgid \"Populate HTTP GET requests in ``tests/suites/foo/get/requests.txt``\"\nmsgstr \"在 ``tests/suites/foo/get/requests.txt`` 填写HTTP GET请求\"\n\n#: ../../testing.rst:144\nmsgid \"\"\n\"If the test suite requires test data, create ``tests/suites/foo/data`` and store \"\n\"XML files there. These will be inserted in the test catalogue at test runtime\"\nmsgstr \"\"\n\"如果需要测试组件的测试数据，创建 ``tests/suites/foo/data``，以存储XML文件。这会在\"\n\"运行时插入到测试目录\"\n\n#: ../../testing.rst:147\nmsgid \"Use pytest or tox as described above in order to run the tests\"\nmsgstr \"使用如上所述的pytest或者 tox来运行测试\"\n\n#: ../../testing.rst:149\nmsgid \"\"\n\"The new test suite database will be created automatically and used as part of \"\n\"tests.\"\nmsgstr \"新的测试套件数据库将自动创建，并且会成为测试的一部分。\"\n\n#: ../../testing.rst:154\nmsgid \"Unit tests\"\nmsgstr \"单元测试\"\n\n#: ../../testing.rst:156\nmsgid \"\"\n\"pycsw also features unit tests. These deal with testing the expected behaviour \"\n\"of individual functions.\"\nmsgstr \"pycsw 还具有单元测试功能。这些处理测试单个函数的预期行为。\"\n\n#: ../../testing.rst:159\nmsgid \"\"\n\"The usual implementation of unit tests is to import the function/method under \"\n\"test, run it with a set of known arguments and assert that the result matches \"\n\"the expected outcome.\"\nmsgstr \"\"\n\"单元测试的通常实现是导入被测函数/方法，使用一组已知参数运行它，并断言结果与预期结\"\n\"果匹配。\"\n\n#: ../../testing.rst:163\nmsgid \"Unit tests are defined in `pycsw/tests/unittests/`.\"\nmsgstr \"单元测试在 `pycsw/tests/unittests/` 中定义。\"\n\n#: ../../testing.rst:165\nmsgid \"\"\n\"pycsw's unit tests are marked with the `unit` marker. This makes it easy to run \"\n\"them in isolation:\"\nmsgstr \"pycsw 的单元测试用 `unit` 标记。这使得单独运行它们变得容易：\"\n\n#: ../../testing.rst:176\nmsgid \"Running tests\"\nmsgstr \"运行测试\"\n\n#: ../../testing.rst:178\nmsgid \"\"\n\"Since pycsw uses `pytest`_, tests are run with the ``py.test`` runner. A basic \"\n\"test run can be made with:\"\nmsgstr \"\"\n\"由于 pycsw 使用 `pytest`_，测试使用 ``py.test`` 运行程序运行。可以使用以下方法进\"\n\"行基本测试运行：\"\n\n#: ../../testing.rst:185\nmsgid \"\"\n\"This command will run all tests and report on the number of successes, failures \"\n\"and also the time it took to run them. The `py.test` command accepts several \"\n\"additional parameters that can be used in order to customize the execution of \"\n\"tests. Look into `pytest's invocation documentation`_ for a more complete \"\n\"description. You can also get a description of the available parameters by \"\n\"running:\"\nmsgstr \"\"\n\"这个命令将运行所有测试，并报告成功、失败次数以及运行它们所花费的时间。`py.test` \"\n\"命令接受几个额外的参数，这些参数可用于自定义测试的执行。查看 `pytest's \"\n\"invocation documentation`_，以获得更完整的描述。还可以通过运行来获得可用参数的描\"\n\"述：\"\n\n#: ../../testing.rst:198\nmsgid \"Running specific suites and test cases\"\nmsgstr \"运行特定套件和测试用例\"\n\n#: ../../testing.rst:200\nmsgid \"\"\n\"py.test allows tagging tests with markers. These can be used to selectively run \"\n\"some tests. pycsw uses two markers:\"\nmsgstr \"\"\n\"py.test 允许标记测试。这些可以用来选择性地运行一些测试。 pycsw 使用两个标记：\"\n\n#: ../../testing.rst:203\nmsgid \"``unit`` - run only inut tests\"\nmsgstr \"``unit`` - 只运行inut测试\"\n\n#: ../../testing.rst:204\nmsgid \"``functional``- run onyl functional tests\"\nmsgstr \"``functional``- 只运行功能测试\"\n\n#: ../../testing.rst:206\nmsgid \"Markers can be specified by using the ``-m `` flag.\"\nmsgstr \"标记可以通过使用 ``-m `` 标志来指定。\"\n\n#: ../../testing.rst:212\nmsgid \"\"\n\"You can also use the ``-k `` flag to select which tests to run. \"\n\"Since each test's name includes the suite name, http method and an identifier \"\n\"for the test, it is easy to run only certain tests.\"\nmsgstr \"\"\n\"您还可以使用 ``-k `` 标志来选择要运行哪些测试。由于每个测试的名\"\n\"称都包含套件名称、http方法和测试的标识符，因此仅运行某些测试很容易。\"\n\n#: ../../testing.rst:223\nmsgid \"The ``-m`` and ``-k`` flags can be combined.\"\nmsgstr \"``-m`` and ``-k`` 标志可以组合起来。\"\n\n#: ../../testing.rst:227\nmsgid \"Exiting fast\"\nmsgstr \"快速退出\"\n\n#: ../../testing.rst:229\nmsgid \"\"\n\"The ``--exitfirst`` (or ``-x``) flag can be used to stop the test runner \"\n\"immediately as soon as a test case fails.\"\nmsgstr \"\"\n\"``--exitfirst`` (or ``-x`` ) 标志可用于在测试用例失败时立即停止测试运行程序。\"\n\n#: ../../testing.rst:238\nmsgid \"Seeing more output\"\nmsgstr \"看到更多的输出\"\n\n#: ../../testing.rst:240\nmsgid \"There are three main ways to get more output from running tests:\"\nmsgstr \"从运行测试中获得更多输出的主要方法有三种:\"\n\n#: ../../testing.rst:242\nmsgid \"The ``--verbose`` (or ``-v``) flag;\"\nmsgstr \"``--verbose`` (or ``-v`` ) 标志;\"\n\n#: ../../testing.rst:244\nmsgid \"\"\n\"The ``--capture=no`` flag - Messages sent to stdout by a test are not suppressed;\"\nmsgstr \"测试发送到stdout的 ``--capture=no`` flag - Messages不会被抑制;\"\n\n#: ../../testing.rst:247\nmsgid \"\"\n\"The ``--pycsw-loglevel`` flag - Sets the log level of the pycsw instance under \"\n\"test. Set this value to ``debug`` in order to see all debug messages sent by \"\n\"pycsw while processing a request.\"\nmsgstr \"\"\n\"``--pycsw-loglevel`` 标志 - 设置被测试的pycsw实例的日志级别。将此值设置为 \"\n\"``debug`` ，以便查看pycsw在处理请求时发送的所有调试消息。\"\n\n#: ../../testing.rst:260\nmsgid \"Comparing results with difflib instead of XML c14n\"\nmsgstr \"将结果与difflib而不是XML c14n进行比较\"\n\n#: ../../testing.rst:262\nmsgid \"\"\n\"The functional tests compare results with their expected values by using [XML \"\n\"canonicalisation - XML c14n](https://www.w3.org/TR/xml-c14n/). Alternatively, \"\n\"you can call py.test with the ``--functional-prefer-diffs`` flag. This will \"\n\"enable comparison based on Python's ``difflib``. Comparison is made on a line-by-\"\n\"line basis and in case of failure, a unified diff will be printed to standard \"\n\"output.\"\nmsgstr \"\"\n\"功能测试使用 [XML canonicalisation - XML c14n](https://www.w3.org/TR/xml-c14n/) \"\n\"将结果与期望值进行比较。或者，也可以调用py, 使用 ``--functional-prefer-diffs`` 标\"\n\"志进行测试。这将支持基于 Python's ``difflib`` 的比较。在逐行比较的基础上，如果失\"\n\"败,将把统一的差异打印到标准输出。\"\n\n#: ../../testing.rst:275\nmsgid \"Saving test results for disk\"\nmsgstr \"在磁盘中保存测试结果\"\n\n#: ../../testing.rst:277\nmsgid \"\"\n\"The result of each functional test can be saved to disk by using the ``--\"\n\"functional-save-results-directory`` option. Each result file is named after the \"\n\"test identifier it has when running with pytest.\"\nmsgstr \"\"\n\"通过使用 ``--functional-save-results-directory`` 选项，可以将每个功能测试的结果保\"\n\"存到磁盘上。每个结果文件都是根据使用pytest运行时的测试标识符命名的。\"\n\n#: ../../testing.rst:288\nmsgid \"Test coverage\"\nmsgstr \"测试覆盖率\"\n\n#: ../../testing.rst:290\nmsgid \"\"\n\"Use the `--cov pycsw` flag in order to see information on code coverage. It is \"\n\"possible to get output in a variety of formats.\"\nmsgstr \"使用 `--cov pycsw` 标志来查看代码覆盖率的信息。可以各种格式获得输出。\"\n\n#: ../../testing.rst:299\nmsgid \"Specifying a timeout for tests\"\nmsgstr \"指定测试超时\"\n\n#: ../../testing.rst:301\nmsgid \"\"\n\"The `--timeout ` option can be used to specify that if a test takes \"\n\"more than `` to run it is considered to have failed. Seconds can be a \"\n\"float, so it is possibe to specify sub-second timeouts\"\nmsgstr \"\"\n\"`--timeout ` 选项可用于指定如果测试运行时间超过 ``，则认为它已\"\n\"经失败。秒可以是一个浮点，所以可以指定次秒超时\"\n\n#: ../../testing.rst:311\nmsgid \"Linting with flake8\"\nmsgstr \"Linting with flake8\"\n\n#: ../../testing.rst:313\nmsgid \"\"\n\"Use the `--flake8` flag to also check if the code complies with Python's style \"\n\"guide\"\nmsgstr \"使用 `--flake8` 标志也检查代码是否符合Python风格指南\"\n\n#: ../../testing.rst:322\nmsgid \"Testing multiple Python versions\"\nmsgstr \"测试多个Python版本\"\n\n#: ../../testing.rst:324\nmsgid \"\"\n\"For testing multiple Python versions and configurations simultaneously you can \"\n\"use `tox`_. pycsw includes a `tox.ini` file with a suitable configuration. It \"\n\"can be used to run tests against multiple Python versions and also multiple \"\n\"database backends. When running `tox` you can send arguments to the `py.test` \"\n\"runner by using the invocation `tox -- `. \"\n\"Examples:\"\nmsgstr \"\"\n\"为了同时测试多个Python版本和配置，可以使用 `tox`_ 。 pycsw包含一个具有适当配置的 \"\n\"`tox.ini` 文件它可以用于对多个Python版本和多个数据库后端进行测试。在运行 `tox` \"\n\"时，可以通过调用 `tox -- ` 向 `py.test` 运行程\"\n\"序发送参数。例如：\"\n\n#: ../../testing.rst:348\nmsgid \"Web Testing\"\nmsgstr \"Web测试\"\n\n#: ../../testing.rst:350\nmsgid \"\"\n\"You can also use the pycsw tests via your web browser to perform sample requests \"\n\"against your pycsw install. The tests are is located in ``tests/``. To \"\n\"generate the HTML page:\"\nmsgstr \"\"\n\"还可以通过Web浏览器使用pycsw测试，来执行pycsw安装样例申请。这些测试在 ``tests/`` \"\n\"中。生成HTML页面：\"\n\n#: ../../testing.rst:358\nmsgid \"Then navigate to ``http://host/path/to/pycsw/tests/index.html``.\"\nmsgstr \"导航到 ``http://host/path/to/pycsw/tests/index.html`` 。\"\n\n#~ msgid \"\"\n#~ \"Compliance benchmarking is done via the OGC `Compliance & Interoperability \"\n#~ \"Testing & Evaluation Initiative`_. The pycsw `wiki `_ documents testing procedures and \"\n#~ \"status.\"\n#~ msgstr \"\"\n#~ \"合规性基准是通过OGC `合规性和互操作性测试与自发性评估`_ 完成的。该pycsw维基 \"\n#~ \"``_ 文档测试程序\"\n#~ \"和状态。\"\n\n#~ msgid \"Tester\"\n#~ msgstr \"测试仪\"\n\n#~ msgid \"\"\n#~ \"The pycsw tests framework (in ``tests``) is a collection of testsuites to \"\n#~ \"perform automated regession testing of the codebase. Test are run against \"\n#~ \"all pushes to the GitHub repository via `Travis CI`_.\"\n#~ msgstr \"\"\n#~ \"该pycsw测试框架（在 ``tests`` 里）是测试包的集合体，用来执行代码库的自动\"\n#~ \"regession测试。通过 `Travis CI`_ ，测试在GitHub的库中运行。\"\n\n#~ msgid \"Running Locally\"\n#~ msgstr \"本地运行\"\n\n#~ msgid \"\"\n#~ \"The tests perform HTTP GET and POST requests against ``http://\"\n#~ \"localhost:8000``. The expected output for each test can be found in \"\n#~ \"``expected``. Results are categorized as ``passed``, ``failed``, or \"\n#~ \"``initialized``. A summary of results is output at the end of the run.\"\n#~ msgstr \"\"\n#~ \"针对 ``http://localhost:8000``，测试执行HTTP GET和POST请求。每个测试的输出都在\"\n#~ \"``expected``中。结果被归类为``通过``，``失败``，或``初始化``。总结的结果会在运\"\n#~ \"行结束时输出。\"\n\n#~ msgid \"Failed Tests\"\n#~ msgstr \"测试失败\"\n\n#~ msgid \"\"\n#~ \"If a given test has failed, the output is saved in ``results``. The \"\n#~ \"resulting failure can be analyzed by running ``diff tests/expected/\"\n#~ \"name_of_test.xml tests/results/name_of_test.xml`` to find variances. The \"\n#~ \"task returns a status code which indicates the number of tests which \"\n#~ \"have failed (i.e. ``echo $?``).\"\n#~ msgstr \"\"\n#~ \"如果某个测试失败，输出将保存在``结果``中。 运行``diff tests/expected/\"\n#~ \"name_of_test.xml tests/results/name_of_test.xml`` ，会自动统计失败结果以找到差\"\n#~ \"异。任务会返回一个状态代码，表示已失败的测试数目（即``echo $?``）。\"\n\n#~ msgid \"Test Suites\"\n#~ msgstr \"测试套件\"\n\n#~ msgid \"\"\n#~ \"The tests framework is run against a series of 'suites' (in ``tests/\"\n#~ \"suites``), each of which specifies a given configuration to test various \"\n#~ \"functionality of the codebase. Each suite is structured as follows:\"\n#~ msgstr \"\"\n#~ \"测试框架将针对一系列“套件”（在``测试/ suites``）完成运行，其中每一项均指定一个\"\n#~ \"给定的配置，以测试基本代码的各种功能。每个套件的结构如下：\"\n\n#~ msgid \"``tests/suites/suite/default.yml``: the configuration for the suite\"\n#~ msgstr \"`tests/suites/suite/default.yml`：对于该套件的配置\"\n\n#~ msgid \"\"\n#~ \"``tests/suites/suite/post``: directory of XML documents for HTTP POST requests\"\n#~ msgstr \"`tests/suites/suite/post`：XML文档目录的HTTP POST请求\"\n\n#~ msgid \"\"\n#~ \"``tests/suites/suite/get/requests.txt``: directory and text file of KVP for \"\n#~ \"HTTP GET requests\"\n#~ msgstr \"\"\n#~ \"`tests/suites/suite/get/requests.txt`：KVP的目录和文本文件，用于HTTP GET请求\"\n\n#~ msgid \"\"\n#~ \"``tests/suites/suite/data``: directory of sample XML data required for the \"\n#~ \"test suite. Database and test data are setup/loaded automatically as part of \"\n#~ \"testing\"\n#~ msgstr \"\"\n#~ \"`tests/suites/suite/data`：测试套件所需样本的XML数据目录。作为测试的一部分，数\"\n#~ \"据库和测试数据是自动设置或自动加载的\"\n\n#~ msgid \"When the tests are invoked, the following operations are run:\"\n#~ msgstr \"当测试被调用，将执行以下操作：\"\n\n#~ msgid \"pycsw configuration is set to ``tests/suites/suite/default.yml``\"\n#~ msgstr \"pycsw配置设置为`tests/suites/suite/default.yml`\"\n\n#~ msgid \"HTTP POST requests are run against ``tests/suites/suite/post/*.xml``\"\n#~ msgstr \"HTTP POST请求是针对 `tests/suites/suite/post/*.xml` 运行的\"\n\n#~ msgid \"\"\n#~ \"HTTP GET requests are run against each request in ``tests/suites/suite/get/\"\n#~ \"requests.txt``\"\n#~ msgstr \"HTTP GET请求是针对 ``tests/suites/suite/get/requests.txt`` 运行的\"\n\n#~ msgid \"\"\n#~ \"The CSV format of ``tests/suites/suite/get/requests.txt`` is ``testname,\"\n#~ \"request``, with one line for each test. The ``testname`` value is a unique \"\n#~ \"test name (this value sets the name of the output file in the test results). \"\n#~ \"The ``request`` value is the HTTP GET request. The ``PYCSW_SERVER`` token is \"\n#~ \"replaced at runtime with the URL to the pycsw install.\"\n#~ msgstr \"\"\n#~ \"在每项测试的第一行中， `tests/suites/suite/get/requests.txt` 的CSV格式是 \"\n#~ \"`testname,request` 。该 ``testname`` 值是唯一的测试名（此值设置在测试结果输出\"\n#~ \"文件的名称内）。该 ``request`` 值是HTTP GET请求的值。该 ``PYCSW_SERVER`` 在\"\n#~ \"URL pycsw安装运行时会被替换掉的。\"\n\n#~ msgid \"Ensure that all file paths are relative to ``path/to/pycsw``\"\n#~ msgstr \"确保所有文件的路径都关联 ``path/to/pycsw`` \"\n\n#~ msgid \"\"\n#~ \"Ensure that ``repository.database`` points to an SQLite3 database called \"\n#~ \"``tests/suites/foo/data/records.db``. The database *must* be called \"\n#~ \"``records.db`` and the directory ``tests/suites/foo/data`` *must* exist\"\n#~ msgstr \"\"\n#~ \"确保 ``repository.database`` 指定于 ``tests/suites/foo/data/records.db`` 的一\"\n#~ \"个sqlite3数据库。该数据库*必须*被写为 ``records.db``，目录 ``tests/suites/foo/\"\n#~ \"data`` 也必须存在\"\n\n#~ msgid \"\"\n#~ \"Pycsw uses `pytest`_ for managing its automated tests. There are a number of \"\n#~ \"test suites that perform mostly functional testing. These tests ensure that \"\n#~ \"pycsw is compliant with the various supported standards. There is also a \"\n#~ \"growing set of unit tests. These focus on smaller scope testing, in order to \"\n#~ \"verify that individual bits of code are working as expected.\"\n#~ msgstr \"\"\n#~ \"Pycsw使用 `pytest`_ 管理它的自动化测试。有许多测试套件主要执行功能测试。这些测\"\n#~ \"试确保pycsw符合各种受支持的标准。还有一组不断增长的单元测试。这些测试集中在较\"\n#~ \"小的范围内，以便验证各个代码位是否按预期工作.\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/tools.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-09 14:34+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh_CN\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../tools.rst:4\nmsgid \"Cataloguing and Metadata Tools\"\nmsgstr \"编目和元数据工具\"\n\n#: ../../tools.rst:7\nmsgid \"OARec Clients and Servers\"\nmsgstr \"OARec 客户端和服务器\"\n\n#: ../../tools.rst:9\nmsgid \"\"\n\"https://github.com/opengeospatial/ogcapi-records/blob/master/\"\n\"implementations.md\"\nmsgstr \"\"\n\"https://github.com/opengeospatial/ogcapi-records/blob/master/\"\n\"implementations.md\"\n\n#: ../../tools.rst:12\nmsgid \"CSW Clients\"\nmsgstr \"CSW客户端\"\n\n#: ../../tools.rst:14\nmsgid \"\"\n\"`Geoportal CSW Clients `_\"\nmsgstr \"\"\n\"`Geoportal CSW 客户端 `_\"\n\n#: ../../tools.rst:15\nmsgid \"`OWSLib `_\"\nmsgstr \"`OWSLib `_\"\n\n#: ../../tools.rst:16\nmsgid \"\"\n\"`QGIS MetaSearch `_\"\nmsgstr \"\"\n\"`QGIS MetaSearch `_\"\n\n#: ../../tools.rst:19\nmsgid \"CSW Servers\"\nmsgstr \"CSW服务器\"\n\n#: ../../tools.rst:21\nmsgid \"`deegree `_\"\nmsgstr \"`deegree `_\"\n\n#: ../../tools.rst:22\nmsgid \"`GeoNetwork opensource `_\"\nmsgstr \"`GeoNetwork 开源 `_\"\n\n#: ../../tools.rst:25\nmsgid \"Metadata Editing Tools\"\nmsgstr \"元数据编辑工具\"\n\n#: ../../tools.rst:27\nmsgid \"`pygeometa `_\"\nmsgstr \"`pygeometa `_\"\n\n#: ../../tools.rst:28\nmsgid \"\"\n\"`CatMDEdit `_\"\nmsgstr \"\"\n\"`CatMDEdit `_\"\n\n#: ../../tools.rst:29\nmsgid \"`EUOSME `_\"\nmsgstr \"`EUOSME `_\"\n\n#: ../../tools.rst:30\nmsgid \"`GIMED `_\"\nmsgstr \"`GIMED `_\"\n\n#: ../../tools.rst:31\nmsgid \"\"\n\"`Metatools `_ (`QGIS `_ plugin)\"\nmsgstr \"\"\n\"`元工具`_（`QGIS `_插件）\"\n\n#~ msgid \"\"\n#~ \"`Geoportal CSW Clients `_\"\n#~ msgstr \"\"\n#~ \"`Geoportal CSW客户端 `_\"\n\n#~ msgid \"\"\n#~ \"`MetaSearch `_ \"\n#~ \"(`QGIS `_ plugin)\"\n#~ msgstr \"\"\n#~ \"`联合检索 `_ （`QGIS \"\n#~ \"`_ 插件）\"\n\n#~ msgid \"`eXcat `_\"\n#~ msgstr \"`eXcat `_\"\n\n#~ msgid \"`CatMDEdit `_\"\n#~ msgstr \"`CatMDEdit `_\"\n\n#~ msgid \"`GIMED `_\"\n#~ msgstr \"`GIMED `_\"\n\n#~ msgid \"\"\n#~ \"`QSphere `_ (`QGIS `_ plugin)\"\n#~ msgstr \"\"\n#~ \"`QSphere `_ (`QGIS `_ plugin)\"\n"
},
{
"path": "docs/locale/zh/LC_MESSAGES/transactions.po",
"content": "#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: pycsw 2.0-dev\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2022-03-08 22:54+0800\\n\"\n\"PO-Revision-Date: 2022-03-10 09:22+0800\\n\"\n\"Last-Translator: \\n\"\n\"Language-Team: \\n\"\n\"Language: zh\\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=utf-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\"Generated-By: Babel 2.8.0\\n\"\n\"X-Generator: Poedit 3.0.1\\n\"\n\n#: ../../transactions.rst:4 ../../transactions.rst:67\nmsgid \"Transactions\"\nmsgstr \"事务\"\n\n#: ../../transactions.rst:6\nmsgid \"\"\n\"pycsw's CSW implementation has the ability to process CSW Harvest and \"\n\"Transaction requests (CSW-T). Transactions are disabled by default; to \"\n\"enable, ``manager.transactions`` must be set to ``true``. Access to \"\n\"transactional functionality is limited to IP addresses which must be set in \"\n\"``manager.allowed_ips``.\"\nmsgstr \"\"\n\"pycsw 的 CSW 实现具有处理 CSW Harvest 和 Transaction 请求（CSW-T）的能力。默认\"\n\"情况下禁用事务；要启用，必须将 ``manager.transactions`` 设置为 ``true``。对事务\"\n\"功能的访问仅限于必须在``manager.allowed_ips`` 中设置的 IP 地址。\"\n\n#: ../../transactions.rst:9\nmsgid \"Supported Resource Types\"\nmsgstr \"支持的资源类型\"\n\n#: ../../transactions.rst:11\nmsgid \"\"\n\"For transactions and harvesting, pycsw supports the following metadata \"\n\"resource types by default:\"\nmsgstr \"对于事务和收获，pycsw 默认支持以下元数据资源类型：\"\n\n#: ../../transactions.rst:1\nmsgid \"Resource Type\"\nmsgstr \"源类型\"\n\n#: ../../transactions.rst:1\nmsgid \"Namespace\"\nmsgstr \"命名空间\"\n\n#: ../../transactions.rst:1\nmsgid \"Transaction\"\nmsgstr \"业务\"\n\n#: ../../transactions.rst:1\nmsgid \"Harvest\"\nmsgstr \"获取\"\n\n#: ../../transactions.rst:1\nmsgid \"Dublin Core\"\nmsgstr \"Dublin Core\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/cat/csw/2.0.2``\"\nmsgstr \"``http://www.opengis.net/cat/csw/2.0.2``\"\n\n#: ../../transactions.rst:1\nmsgid \"yes\"\nmsgstr \"是\"\n\n#: ../../transactions.rst:1\nmsgid \"FGDC\"\nmsgstr \"FGDC\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/cat/csw/csdgm``\"\nmsgstr \"``http://www.opengis.net/cat/csw/csdgm``\"\n\n#: ../../transactions.rst:1\nmsgid \"GM03\"\nmsgstr \"GM03\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.interlis.ch/INTERLIS2.3``\"\nmsgstr \"``http://www.interlis.ch/INTERLIS2.3``\"\n\n#: ../../transactions.rst:1\nmsgid \"ISO 19139\"\nmsgstr \"ISO 19139\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.isotc211.org/2005/gmd``\"\nmsgstr \"``http://www.isotc211.org/2005/gmd``\"\n\n#: ../../transactions.rst:1\nmsgid \"ISO GMI\"\nmsgstr \"ISO GMI\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.isotc211.org/2005/gmi``\"\nmsgstr \"``http://www.isotc211.org/2005/gmi``\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:CSW 2.0.2\"\nmsgstr \"OGC:CSW 2.0.2\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:WMS 1.1.1/1.3.0\"\nmsgstr \"OGC:WMS 1.1.1/1.3.0\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/wms``\"\nmsgstr \"``http://www.opengis.net/wms``\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:WMTS 1.0.0\"\nmsgstr \"OGC:WMTS 1.0.0\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/wmts/1.0``\"\nmsgstr \"``http://www.opengis.net/wmts/1.0``\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:WFS 1.0.0/1.1.0/2.0.0\"\nmsgstr \"OGC:WFS 1.0.0/1.1.0/2.0.0\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/wfs``\"\nmsgstr \"``http://www.opengis.net/wfs``\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:WCS 1.0.0\"\nmsgstr \"OGC:WCS 1.0.0\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/wcs``\"\nmsgstr \"``http://www.opengis.net/wcs``\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:WPS 1.0.0\"\nmsgstr \"OGC:WPS 1.0.0\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/wps/1.0.0``\"\nmsgstr \"``http://www.opengis.net/wps/1.0.0``\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:SOS 1.0.0\"\nmsgstr \"OGC:SOS 1.0.0\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/sos/1.0``\"\nmsgstr \"``http://www.opengis.net/sos/1.0``\"\n\n#: ../../transactions.rst:1\nmsgid \"OGC:SOS 2.0.0\"\nmsgstr \"OGC:SOS 2.0.0\"\n\n#: ../../transactions.rst:1\nmsgid \"``http://www.opengis.net/sos/2.0``\"\nmsgstr \"``http://www.opengis.net/sos/2.0``\"\n\n#: ../../transactions.rst:1\nmsgid \"`WAF`_\"\nmsgstr \"`WAF`_\"\n\n#: ../../transactions.rst:1\nmsgid \"``urn:geoss:waf``\"\nmsgstr \"``urn:geoss:waf``\"\n\n#: ../../transactions.rst:31\nmsgid \"\"\n\"Additional metadata models are supported by enabling the appropriate :ref:\"\n\"`profiles`.\"\nmsgstr \"通过启用适当的 :ref:`profiles` 来支持其他元数据模型。\"\n\n#: ../../transactions.rst:35\nmsgid \"\"\n\"For transactions to be functional when using SQLite3, the SQLite3 database \"\n\"file (**and its parent directory**) must be fully writable. For example:\"\nmsgstr \"\"\n\"为了在使用 SQLite3 时事务能够正常工作，SQLite3 数据库文件（**及其父目录**）必须\"\n\"是完全可写的。例如：\"\n\n#: ../../transactions.rst:44\nmsgid \"\"\n\"For CSW-T deployments, it is strongly advised that this directory reside in an \"\n\"area that is not accessible by HTTP.\"\nmsgstr \"对于 CSW-T 部署，强烈建议将此目录驻留在 HTTP 无法访问的区域中。\"\n\n#: ../../transactions.rst:47\nmsgid \"Harvesting\"\nmsgstr \"获取\"\n\n#: ../../transactions.rst:51\nmsgid \"\"\n\"Your server must be able to make outgoing HTTP requests for this functionality.\"\nmsgstr \"服务器必须能够为此功能发出传出 HTTP 请求。\"\n\n#: ../../transactions.rst:53\nmsgid \"\"\n\"pycsw supports the CSW-T ``Harvest`` operation. Records which are harvested \"\n\"require to setup a cronjob to periodically refresh records in the local \"\n\"repository. A sample cronjob is available in ``etc/harvest-all.cron`` which \"\n\"points to ``pycsw-admin.py`` (you must specify the correct path to your \"\n\"configuration). Harvest operation results can be sent by email (via ``mailto:\"\n\"``) or ftp (via ``ftp://``) if the Harvest request specifies ``csw:\"\n\"ResponseHandler``.\"\nmsgstr \"\"\n\"pycsw 支持 CSW-T ``Harvest`` 操作。收集的记录需要设置一个 cronjob 来定期刷新本\"\n\"地存储库中的记录。``etc/harvest-all.cron`` 中提供了一个示例 cronjob，它指向 \"\n\"``pycsw-admin.py``（必须指定正确的配置路径）。如果 Harvest 请求指定了 ``csw:\"\n\"ResponseHandler``，则 Harvest 操作结果可以通过电子邮件（通过 ``mailto:``）或 \"\n\"ftp（通过 ``ftp://``）发送。\"\n\n#: ../../transactions.rst:57\nmsgid \"\"\n\"For ``csw:ResponseHandler`` values using the ``mailto:`` protocol, you must \"\n\"have ``server.smtp_host`` set in your :ref:`configuration `.\"\nmsgstr \"\"\n\"对于使用 ``mailto:`` 协议的 ``csw:ResponseHandler`` 值，必须在 :ref:\"\n\"`configuration ` 中设置 ``server.smtp_host``。\"\n\n#: ../../transactions.rst:60\nmsgid \"OGC Web Services\"\nmsgstr \"OGC Web服务\"\n\n#: ../../transactions.rst:62\nmsgid \"\"\n\"When harvesting OGC web services, requests can provide the base URL of the \"\n\"service as part of the Harvest request. pycsw will construct a \"\n\"``GetCapabilities`` request dynamically.\"\nmsgstr \"\"\n\"获取 OGC Web 服务时，请求可以提供服务的基本 URL 作为 Harvest 请求的一部分。\"\n\"pycsw 将动态构造一个 ``GetCapabilities`` 请求。\"\n\n#: ../../transactions.rst:64\nmsgid \"\"\n\"When harvesting other CSW servers, pycsw pages through the entire CSW in \"\n\"default increments of 10. This value can be modified via the ``manager.\"\n\"csw_harvest_pagesize`` :ref:`configuration ` option. It is \"\n\"strongly advised to use the ``csw:ResponseHandler`` parameter for harvesting \"\n\"large CSW catalogues to prevent HTTP timeouts.\"\nmsgstr \"\"\n\"当收获其他 CSW 服务器时，pycsw 以默认增量 10 对整个 CSW 进行分页。这个值可以通\"\n\"过 ``manager.csw_harvest_pagesize`` :ref:`configuration ` 选项进\"\n\"行修改。强烈建议使用``csw:ResponseHandler`` 参数来收集大型 CSW 目录以防止 HTTP \"\n\"超时。\"\n\n#: ../../transactions.rst:69\nmsgid \"\"\n\"pycsw supports 3 modes of the ``Transaction`` operation (``Insert``, \"\n\"``Update``, ``Delete``):\"\nmsgstr \"\"\n\"pycsw支持 ``Transaction`` 操作（ ``Insert`` ， ``Update`` ， ``Delete`` ）的3种\"\n\"模式：\"\n\n#: ../../transactions.rst:71\nmsgid \"**Insert**: full XML documents can be inserted as per CSW-T\"\nmsgstr \"**Insert**：完整的XML文档可以用CSW-T插入\"\n\n#: ../../transactions.rst:72\nmsgid \"\"\n\"**Update**: updates can be made as full record updates or record properties \"\n\"against a ``csw:Constraint``\"\nmsgstr \"\"\n\"**更新**：更新可以作为完整记录更新或针对 ``csw:Constraint`` 的记录属性进行\"\n\n#: ../../transactions.rst:73\nmsgid \"**Delete**: deletes can be made against a ``csw:Constraint``\"\nmsgstr \"**删除**：可以针对 ``csw:Constraint`` 进行删除\"\n\n#: ../../transactions.rst:75\nmsgid \"\"\n\"Transaction operation results can be sent by email (via ``mailto:``) or ftp \"\n\"(via ``ftp://``) if the Transaction request specifies ``csw:ResponseHandler``.\"\nmsgstr \"\"\n\"事务操作结果可以通过电子邮件（通过 ``mailto:``）或 ftp（通过 ``ftp://``）发送，\"\n\"如果事务请求指定了``csw:ResponseHandler``。\"\n\n#: ../../transactions.rst:77\nmsgid \"The :ref:`tests` contain CSW-T request examples.\"\nmsgstr \":ref:`tests` 包含 CSW-T 请求示例。\"\n"
},
{
"path": "docs/metadata-model-reference.rst",
"content": ".. _metadata-model-reference:\n\nMetadata Model Reference\n========================\n\npycsw's metadata repository model is designed to support queryable elements as well full-text search. The model\nis rooted in ISO 19115 and is updated as required to be able to support additional metadata models in a generic\nfashion.\n\nOverview\n--------\n\nModel Crosswalk\n---------------\n\n.. list-table:: pycsw model\n :widths: 20 20 20 20 20 20 20 20\n :class: metadata-model-table\n :header-rows: 1\n\n * - Database column\n - pycsw mapping name\n - Queryable name\n - ISO 19115 (XPath)\n - CSW Record/Dublin Core (XPath)\n - OGC API - Records (JSONPath)\n - STAC (JSONPath)\n - Description\n * - ``identifier``\n - ``pycsw:Identifier``\n - ``apiso:Identifier``\n - ``gmd:fileIdentifier/gco:CharacterString``\n - ``dc:identifier``\n - ``id``\n - ``id``\n - Record identifier (Primary key)\n * - ``typename``\n - ``pycsw:Typename``\n - \n - \n - \n - \n - \n - CSW typename (e.g. ``csw:Record``, ``gmd:MD_Metadata``), see also ref:`existing-repository-requirements`\n * - ``schema``\n - ``pycsw:Schema``\n - \n - \n - \n - \n - \n - Schema namespace, i.e. http://www.opengis.net/cat/csw/2.0.2, http://www.isotc211.org/2005/gmd, http://www.opengis.net/spec/ogcapi-records-1/1.0/req/record-core\n * - ``mdsource``\n - ``pycsw:MdSource``\n - \n - \n - \n - \n - \n - Origin of resource, either ``local`` (default), or URL to location of record/resource/service\n * - ``insert_date``\n - ```pycsw:InsertDate``\n - \n - \n - \n -\n - \n - Date of insertion of the metadata record, see also ref:`existing-repository-requirements`\n * - ``xml``\n - ``pycsw:XML``\n - \n - \n - \n - \n - \n - Raw XML metadata as it was inserted into the repository. Note that this field is deprecated for the ``metadata`` field, and will be removed in a future release, see also ref:`existing-repository-requirements`\n * - ``metadata``\n - ``pycsw:Metadata``\n - \n - \n - \n - \n - \n - Raw metadata payload (replaces ``xml`` field, supports any metadata type [JSON, XML, etc.]), see also ref:`existing-repository-requirements`\n * - ``metadata_type``\n - pycsw:MetadataType\n - \n - \n - \n - \n - \n - Media type of the metadata payload (``application/xml`` [default], ``application/json`` for OGC API - Records and STAC)\n * - ``anytext``\n - ``pycsw:AnyText``\n - ``apiso:AnyText``\n - ``//text()`` (``csw:AnyText`` [queryable only, not a returnable])\n - ``//text()`` (``csw:AnyText`` [queryable only, not a returnable])\n - ``q=`` (for API)\n - ``q=`` (for API)\n - Bag of metadata element and attributes content ONLY, no XML tags or JSON element names, see also :ref:`existing-repository-requirements`\n * - ``language``\n - ``pycsw:Language``\n - ``apiso:Language``\n - ``gmd:language/gmd:LanguageCode``, ``gmd:language/gco:CharacterString``\n - ``dc:language``\n - ``properties.language``\n - ``properties.language``\n - \n * - ``title``\n - ``pycsw:Title``\n - ``apiso:Title``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString``\n - ``dc:title``\n - ``properties.title``\n - ``properties.title``\n - \n * - ``abstract``\n - ``pycsw:Abstract``\n - ``apiso:Abstract``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:abstract/gco:CharacterString``\n - ``dct:abstract``\n - ``properties.description``\n - ``properties.description``\n - \n * - ``edition``\n - ``pycsw:Edition``\n - ``apiso:Edition``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:edition/gco:CharacterString``\n - \n - \n - \n - \n * - ``keywords``\n - ``pycsw:Keywords``\n - ``apiso:Subject``\n - ``gmd:identificationInfo/gmd:MD_Identification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString``, ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:topicCategory/gmd:MD_TopicCategoryCode``\n - ``dc:subject``\n - ``properties.keywords``\n - \n - CSV of keywords, see also :ref:`existing-repository-requirements`\n * - ``keywordstype``\n - ``pycsw:KeywordType``\n - ``apiso:KeywordType``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:type/gmd:MD_KeywordTypeCode``\n - \n - \n - \n - \n * - ``themes``\n - ``pycsw:Themes``\n - \n - \n - \n - ``properties.themes``\n - \n - JSON list of concepts/schemes, see also :ref:`existing-repository-requirements`\n * - ``format``\n - ``pycsw:Format``\n - ``apiso:Format``\n - ``gmd:distributionInfo/gmd:MD_Distribution/gmd:distributionFormat/gmd:MD_Format/gmd:name/gco:CharacterString``\n - ``dc:format``\n - ``properties.formats``\n - \n - \n * - ``source``\n - ``pycsw:Source``\n - \n - \n - ``dc:source``\n - ``properties.externalIds``\n - \n - \n * - ``date``\n - ``pycsw:Date``\n - \n - \n - ``dc:date``\n - ``time``\n - ``properties.datetime``\n - \n * - ``date_modified``\n - ``pycsw:Modified``\n - ``apiso:Modified``\n - ``gmd:dateStamp/gco:Date``\n - ``dct:modified``\n - ``properties.updated``\n - ``properties.updated``\n - \n * - ``type``\n - ``pycsw:Type``\n - ``apiso:Type``\n - ``gmd:hierarchyLevel/gmd:MD_ScopeCode``\n - ``dc:type``\n - ``properties.type``\n - \n - \n * - ``wkt_geometry``\n - ``pycsw:BoundingBox``\n - ``apiso:BoundingBox``\n - ``apiso:BoundingBox``\n - ``ows:BoundingBox``\n - ``geometry``\n - ``geometry``\n - WKT/EWKT of geometry\n * - ``crs``\n - ``pycsw:CRS``\n - ``apiso:CRS``\n - ``gmd:referenceSystemInfo/gmd:MD_ReferenceSystem/gmd:referenceSystemIdentifier/gmd:RS_Identifier/gmd:codeSpace/gco:CharacterString``, ``gmd:referenceSystemInfo/gmd:MD_ReferenceSystem/gmd:referenceSystemIdentifier/gmd:RS_Identifier/gmd:version/gco:CharacterString``, ``gmd:referenceSystemInfo/gmd:MD_ReferenceSystem/gmd:referenceSystemIdentifier/gmd:RS_Identifier/gmd:code/gco:CharacterString``\n - ``dct:spatial``\n - \n - \n - \n * - ``title_alternate``\n - ``pycsw:AlternateTitle``\n - ``apiso:AlternateTitle``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:alternateTitle/gco:CharacterString``\n - ``dct:alternative``\n - \n - \n - \n * - ``date_revision``\n - ``pycsw:RevisionDate``\n - ``apiso:RevisionDate``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date[gmd:dateType/gmd:CI_DateTypeCode/@codeListValue=\"revision\"]/gmd:date/gco:Date``\n - \n - ``properties.updated``\n - ``created`` or ``properties.updated``\n - \n * - ``date_creation``\n - ``pycsw:CreationDate``\n - ``apiso:CreationDate``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date[gmd:dateType/gmd:CI_DateTypeCode/@codeListValue=\"creation\"]/gmd:date/gco:Date``\n - \n - ``properties.created``\n - ``created`` or ``properties.created``\n - \n * - ``date_publication``\n - ``pycsw:PublicationDate``\n - ``apiso:PublicationDate``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date[gmd:dateType/gmd:CI_DateTypeCode/@codeListValue=\"publication\"]/gmd:date/gco:Date``\n - \n - \n - \n - \n * - ``organization``\n - ``pycsw:OrganizationName``\n - ``apiso:OrganisationName``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:pointOfContact/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString``\n - \n - \n - \n - \n * - ``securityconstraints``\n - ``pycsw:SecurityConstraints``\n - ``apiso:HasSecurityConstraints``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_SecurityConstraints``\n - \n - \n - \n - \n * - ``parentidentifier``\n - ``pycsw:ParentIdentifier``\n - ``apiso:ParentIdentifier``\n - ``gmd:parentIdentifier/gco:CharacterString``\n - \n - ``collection``\n - ``collection``\n - \n * - ``topicategory``\n - ``pycsw:TopicCategory``\n - ``apiso:TopicCategory``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:topicCategory/gmd:MD_TopicCategoryCode``\n - \n - \n - \n - \n * - ``resourcelanguage``\n - ``pycsw:ResourceLanguage``\n - ``apiso:ResourceLanguage``\n - ``md:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:code/gmd:MD_LanguageTypeCode``\n - \n - \n - \n - \n * - ``geodescode``\n - ``pycsw:GeographicDescriptionCode``\n - ``apiso:GeographicDescriptionCode``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString``\n - \n - \n - \n - \n * - ``denominator``\n - ``pycsw:Denominator``\n - ``apiso:Denominator``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:spatialResolution/gmd:MD_Resolution/gmd:equivalentScale/gmd:MD_RepresentativeFraction/gmd:denominator/gco:Integer``\n - \n - \n - \n - \n * - ``distancevalue``\n - ``pycsw:DistanceValue``\n - ``apiso:DistanceValue``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:spatialResolution/gmd:MD_Resolution/gmd:distance/gco:Distance``\n - \n - \n - ``gsd`` or ``properties.gsd``\n - \n * - ``distanceuom``\n - ``pycsw:DistanceUOM``\n - ``apiso:DistanceUOM``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:spatialResolution/gmd:MD_Resolution/gmd:distance/gco:Distance/@uom``\n - \n - \n - fixed to ``m``\n - \n * - ``time_begin``\n - ``pycsw:TempExtent_begin``\n - ``apiso:TempExtent_begin``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:temporalElement/gmd:EX_TemporalExtent/gmd:extent/gml:TimePeriod/gml:beginPosition``\n - \n - ``properties.extent.temporal.interval[0]``\n - ``properties.start_datetime``\n - \n * - ``time_end``\n - ``pycsw:TempExtent_end``\n - ``apiso:TempExtent_end``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:temporalElement/gmd:EX_TemporalExtent/gmd:extent/gml:TimePeriod/gml:endPosition``\n - \n - ``properties.extent.temporal.interval[1]``\n - ``properties.end_datetime``\n - \n * - ``servicetype``\n - ``pycsw:ServiceType``\n - ``apiso:ServiceType``\n - ``gmd:identificationInfo/srv:SV_ServiceIdentification/srv:serviceType/gco:LocalName``\n - \n - \n - \n - \n * - ``servicetypeversion``\n - ``pycsw:ServiceTypeVersion``\n - ``apiso:ServiceTypeVersion``\n - ``gmd:identificationInfo/srv:SV_ServiceIdentification/srv:serviceTypeVersion/gco:CharacterString``\n - \n - \n - \n - \n * - ``operation``\n - ``pycsw:Operation``\n - ``apiso:Operation``\n - ``gmd:identificationInfo/srv:SV_ServiceIdentification/srv:containsOperations/srv:SV_OperationMetadata/srv:operationName/gco:CharacterString``\n - \n - \n - \n - \n * - ``couplingtype``\n - ``pycsw:CouplingType``\n - ``apiso:CouplingType``\n - ``gmd:identificationInfo/srv:SV_ServiceIdentification/srv:couplingType/srv:SV_CouplingType``\n - \n - \n - \n - \n * - ``operateson``\n - ``pycsw:OperatesOn``\n - ``apiso:OperatesOn``\n - ``gmd:identificationInfo/srv:SV_ServiceIdentification/srv:operatesOn/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:RS_Identifier/gmd:code/gco:CharacterString``\n - \n - \n - \n - \n * - ``operatesonidentifier``\n - ``pycsw:OperatesOnIdentifier``\n - ``apiso:OperatesOnIdentifier``\n - ``gmd:identificationInfo/srv:SV_ServiceIdentification/srv:coupledResource/srv:SV_CoupledResource/srv:identifier/gco:CharacterString``\n - \n - \n - \n - \n * - ``operatesoname``\n - ``pycsw:OperatesOnName``\n - ``apiso:OperatesOnName``\n - ``gmd:identificationInfo/srv:SV_ServiceIdentification/srv:coupledResource/srv:SV_CoupledResource/srv:operationName/gco:CharacterString``\n - \n - \n - \n - \n * - ``degree``\n - ``pycsw:Degree``\n - ``apiso:Degree``\n - ``gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:report/gmd:DQ_DomainConsistency/gmd:result/gmd:DQ_ConformanceResult/gmd:pass/gco:Boolean``\n - \n - \n - \n - \n * - ``accessconstraints``\n - ``pycsw:AccessConstraints``\n - ``apiso:AccessConstraints``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:accessConstraints/gmd:MD_RestrictionCode``\n - ``dc:rights``\n - \n - \n - \n * - ``otherconstraints``\n - ``pycsw:OtherConstraints``\n - ``apiso:OtherConstraints``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:otherConstraints/gco:CharacterString``\n - \n - ``properties.license``\n - \n - \n * - ``classification``\n - ``pycsw:Classification``\n - ``apiso:Classification``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:accessConstraints/gmd:MD_ClassificationCode``\n - \n - \n - \n - \n * - ``conditionapplyingtoaccessanduse``\n - ``pycsw:ConditionApplyingToAccessAndUse``\n - ``apiso:ConditionApplyingToAccessAndUse``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:useLimitation/gco:CharacterString``\n - \n - \n - \n - \n * - ``lineage``\n - ``pycsw:Lineage``\n - ``apiso:Lineage``\n - ``gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:lineage/gmd:LI_Lineage/gmd:statement/gco:CharacterString``\n - \n - \n - \n - \n * - ``responsiblepartyrole``\n - ``pycsw:ResponsiblePartyRole``\n - ``apiso:ResponsiblePartyRole``\n - ``gmd:contact/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode``\n - \n - \n - \n - \n * - ``specificationtitle``\n - ``pycsw:SpecificationTitle``\n - ``apiso:SpecificationTitle``\n - ``gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:report/gmd:DQ_DomainConsistency/gmd:result/gmd:DQ_ConformanceResult/gmd:specification/gmd:CI_Citation/gmd:title/gco:CharacterString``\n - \n - \n - \n - \n * - ``specificationdate``\n - ``pycsw:SpecificationDate``\n - ``apiso:SpecificationDate``\n - ``gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:report/gmd:DQ_DomainConsistency/gmd:result/gmd:DQ_ConformanceResult/gmd:specification/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:Date``\n - \n - \n - \n - \n * - ``specificationdatetype``\n - ``pycsw:SpecificationDateType``\n - ``apiso:SpecificationDateType``\n - ``gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:report/gmd:DQ_DomainConsistency/gmd:result/gmd:DQ_ConformanceResult/gmd:specification/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:dateType/gmd:CI_DateTypeCode``\n - \n - \n - \n - \n * - ``creator``\n - ``pycsw:Creator``\n - ``apiso:Creator``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:pointOfContact/gmd:CI_ResponsibleParty/gmd:organisationName[gmd:role/gmd:CI_RoleCode/@codeListValue=\"originator\"]/gco:CharacterString``\n - ``dc:creator``\n - ``properties.providers``\n - \n - \n * - ``publisher``\n - ``pycsw:Publisher``\n - ``apiso:Publisher``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:pointOfContact/gmd:CI_ResponsibleParty/gmd:organisationName[gmd:role/gmd:CI_RoleCode/@codeListValue=\"publisher\"]/gco:CharacterString``\n - ``dc:publisher``\n - ``properties.providers``\n - \n - \n * - ``contributor``\n - ``pycsw:Contributor``\n - ``apiso:Contributor``\n - ``gmd:identificationInfo/gmd:MD_DataIdentification/gmd:pointOfContact/gmd:CI_ResponsibleParty/gmd:organisationName[gmd:role/gmd:CI_RoleCode/@codeListValue=\"contributor\"]/gco:CharacterString``\n - ``dc:contributor``\n - ``properties.providers``\n - \n - \n * - ``relation``\n - ``pycsw:Relation``\n - ``apiso:Relation``\n - ``gmd:identificationInfo/gmd:MD_Data_Identification/gmd:aggregationInfo``\n - ``dc:relation``\n - \n - \n - \n * - ``platform``\n - ``pycsw:Platform``\n - ``apiso:Platform``\n - ``gmi:acquisitionInfo/gmi:MI_AcquisitionInformation/gmi:platform/gmi:MI_Platform/gmi:identifier``\n - \n - \n - ``platform`` or ``properties.platform``\n - \n * - ``instrument``\n - ``pycsw:Instrument``\n - ``apiso:Instrument``\n - ``gmi:acquisitionInfo/gmi:MI_AcquisitionInformation/gmi:platform/gmi:MI_Platform/gmi:instrument/gmi:MI_Instrument/gmi:identifier``\n - \n - \n - ``instruments`` or ``properties.instruments``\n - \n * - ``sensortype``\n - ``pycsw:SensorType``\n - ``apiso:SensorType``\n - ``gmi:acquisitionInfo/gmi:MI_AcquisitionInformation/gmi:platform/gmi:MI_Platform/gmi:instrument/gmi:MI_Instrument/gmi:type``\n - \n - \n - \n - \n * - ``cloudcover``\n - ``pycsw:CloudCover``\n - ``apiso:CloudCover``\n - ``gmd:contentInfo/gmd:MD_ImageDescription/gmd:cloudCoverPercentage``\n - \n - \n - \n - \n * - ``bands``\n - ``pycsw:Bands``\n - ``apiso:Bands``\n - ``gmd:contentInfo/gmd:MD_ImageDescription/gmd:dimension/MD_Band/@id``\n - \n - \n - \n - JSON list of band information, see also :ref:`existing-repository-requirements` \n * - ``links``\n - ``pycsw:Links``\n - \n - \n - \n - ``links``\n - ``links``, ``assets``\n - List of dicts with properties: ``name``, ``description``, ``protocol``, ``url``, see also :ref:`existing-repository-requirements`\n * - ``contacts``\n - ``pycsw:Contacts``\n - \n - ``//gmd:CI_ResponsibleParty`` \n - \n - ``properties.providers``\n - \n - List of dicts with properties: name, organization, address, postcode, city, region, country, email, phone, fax, onlineresource, position, role\n"
},
{
"path": "docs/migration-guide.rst",
"content": ".. _migration-guide:\n\npycsw Migration Guide\n=====================\n\nThis page provides migration support across pycsw versions\nover time to help with pycsw change management.\n\npycsw 2.x to 3.0 Migration\n--------------------------\n\n- the default configuration is now in YAML format. See :ref:`configuration` for more information. A helper script (``pycsw-admin.py migrate-config``) is included for updating from the previous configuration format\n- the default endpoint for standalone deployments is now powered by ``pycsw/wsgi_flask.py`` (based on Flask) which supports ALL pycsw supported APIs. Make sure to use ``requirements-standalone.txt`` on top of ``requirements.txt`` to install Flask along with other standalone requirements\n- the previously used ``pycsw/wsgi.py`` can still be used for CSW only deployments or for applications that need to integrate pycsw as a library (e.g. Django applications). PyPI installations still use ``requirements.txt`` which does not install Flask by default\n- the default endpoint ``/`` is now OGC API - Records\n- the CSW endpoint is now ``/csw``\n- the OAI-PMH endpoint is now ``/oaipmh``\n- the OpenSearch endpoint is now ``/opensearch``\n- the SRU endpoint is now ``/sru``\n- the ``pycsw-admin.py`` syntax has been updated\n\n - the ``-c`` flag has been replaced by subcommands (i.e. ``pycsw-admin.py -c load_records`` -> ``pycsw-admin.py load-records``)\n - subcommands have been slugified (i.e. ``load_records`` -> ``load-records``)\n - consult ``--help`` to use the updated CLI syntax\n- use the following migration script to add new model fields\n\n.. code-block:: sql\n\n alter table records add column metadata TEXT;\n alter table records add column metadata_type TEXT default 'application/xml';\n alter table records add column edition TEXT;\n alter table records add column contacts TEXT;\n alter table records add column themes TEXT;\n vacuum;\n\npycsw 1.x to 2.0 Migration\n--------------------------\n\n- the default CSW version is now 3.0.0. CSW clients need to explicitly specify\n ``version=2.0.2`` for CSW 2 behaviour. Also, pycsw administrators can use a\n WSGI wrapper to the pycsw API to force ``version=2.0.2`` on init of\n ``pycsw.server.Csw`` from the server. See :ref:`csw-support` for more information.\n\n- ``pycsw.server.Csw.dispatch_wsgi()`` previously returned the response\n content as a string. 2.0.0 introduces a compatability break to\n additionally return the HTTP status code along with the response as a list\n\n.. code-block:: python\n\n from pycsw.server import Csw\n my_csw = Csw(my_dict) # add: env=some_environ_dict, version='2.0.2' if preferred\n\n # using pycsw 1.x\n response = my_csw.dispatch_wsgi()\n\n # using pycsw 2.0\n http_status_code, response = my_csw.dispatch_wsgi()\n\n # covering either pycsw version\n content = csw.dispatch_wsgi()\n\n # pycsw 2.0 has an API break:\n # pycsw < 2.0: content = xml_response\n # pycsw >= 2.0: content = [http_status_code, content]\n # deal with the API break\n if isinstance(content, list): # pycsw 2.0+\n http_response_code, response = content\n\nSee :ref:`api` for more information.\n"
},
{
"path": "docs/oaipmh.rst",
"content": ".. _oaipmh:\n\nOAI-PMH Support\n===============\n\npycsw supports the `The Open Archives Initiative Protocol for Metadata Harvesting`_ (OAI-PMH) standard.\n\nOAI-PMH OpenSearch support is enabled by default. There are two ways to access OAI-PMH\ndepending on the deployment pattern chosen.\n\nOGC API - Records deployment\n----------------------------\n\n.. code-block:: bash\n\n http://localhost:8000/oaipmh\n\nCSW legacy deployment\n---------------------\n\nHTTP requests must be specified with ``mode=oaipmh`` in the base URL for OAI-PMH requests, e.g.:\n\n.. code-block:: bash\n\n http://localhost/pycsw/csw.py?mode=oaipmh&verb=Identify\n\nSee http://www.openarchives.org/OAI/openarchivesprotocol.html for more information on OAI-PMH as well as request / reponse examples.\n\n.. _`The Open Archives Initiative Protocol for Metadata Harvesting`: http://www.openarchives.org/OAI/openarchivesprotocol.html\n\n"
},
{
"path": "docs/oarec-support.rst",
"content": ".. _oarec-support:\n\nOGC API - Records Support\n=========================\n\nVersions\n--------\n\npycsw supports `OGC API - Records - Part 1: Core, version 1.0`_ by default.\n\nRequest Examples\n----------------\n\nAs the OGC successor to CSW, OGC API - Records is a change in paradigm rooted in lowering\nthe barrier to entry, being webby/of the web, and focusing on developer experience/adoption.\nJSON and HTML output formats are both supported via the ``f`` parameter.\n\n.. code-block:: bash\n\n # landing page\n http://localhost:8000/\n # landing page explictly as JSON\n http://localhost:8000/?f=json\n # landing page as HTML\n http://localhost:8000/?f=html\n # conformance classes\n http://localhost:8000/conformance\n # all collections\n http://localhost:8000/collections\n # default collection\n http://localhost:8000/collections/metadata:main\n # default collection queryables\n http://localhost:8000/collections/metadata:main/queryables\n\n # collection queries\n # query parameters can be combined (exclusive/AND)\n\n # collection query, all records\n http://localhost:8000/collections/metadata:main/items\n # collection query, full text search\n http://localhost:8000/collections/metadata:main/items?q=lorem\n # collection query, full text search (multiple terms result in an exclusive (AND) search\n http://localhost:8000/collections/metadata:main/items?q=lorem dolor\n # collection query, spatial query\n http://localhost:8000/collections/metadata:main/items?bbox=-142,42,-52,84\n # collection query, temporal query\n http://localhost:8000/collections/metadata:main/items?datetime=2001-10-30/2007-10-30\n # collection query, temporal query, before\n http://localhost:8000/collections/metadata:main/items?datetime=../2007-10-30\n # collection query, temporal query, after\n http://localhost:8000/collections/metadata:main/items?datetime=2007-10-30/..\n # collection query, property query\n http://localhost:8000/collections/metadata:main/items?title=Lorem%20ipsum\n # collection query, CQL filter\n http://localhost:8000/collections/metadata:main/items?filter-lang=cql-text&filter=title LIKE '%lorem%'\n # collection query, limiting results\n http://localhost:8000/collections/metadata:main/items?limit=1\n # collection query, paging\n http://localhost:8000/collections/metadata:main/items?limit=10&offset=10\n # collection query, paging and sorting (default ascending)\n http://localhost:8000/collections/metadata:main/items?limit=10&offset=10&sortby=title\n # collection query, paging and sorting (descending)\n http://localhost:8000/collections/metadata:main/items?limit=10&offset=10&sortby=-title\n # collection query as CQL JSON (HTTP POST), as curl request\n curl http://localhost:8000/collections/metadata:main/items --request POST -H \"Content-Type: application/json\" --data '{ \"eq\": [{ \"property\": \"title\" }, \"Lorem ipsum\"]}'\n # collection query as CQL JSON (HTTP POST), limiting results, as curl request\n curl http://localhost:8000/collections/metadata:main/items?limit=0 --request POST -H \"Content-Type: application/json\" --data '{ \"eq\": [{ \"property\": \"title\" }, \"Lorem ipsum\"]}'\n\n # collection item as GeoJSON\n http://localhost:8000/collections/metadata:main/items/{itemId}\n # collection item as HTML\n http://localhost:8000/collections/metadata:main/items/{itemId}?f=html\n # collection item as XML\n http://localhost:8000/collections/metadata:main/items/{itemId}?f=xml\n\nVirtual Collections\n-------------------\n\nIn OGC API - Records, pycsw's global repository is named `metadata:main`, which\nserves all metadata records from a given pycsw configuration.\n\nOGC API - Records support exposes parent metadata as distinct collections,\nreducing the barrier for users querying on a specific collection, for\nmultiple collections. This functionality is implemented by default and does\nnot require additional setup/configuration by the user. More information\non this feature can be found in `RFC 10: OGC API - Records virtual collections support`_.\n\n\n.. _`OGC API - Records - Part 1: Core, version 1.0`: https://ogcapi.ogc.org/records\n.. _`RFC 10: OGC API - Records virtual collections support`: https://pycsw.org/development/rfc/rfc-10.html\n"
},
{
"path": "docs/odc.rst",
"content": ".. _odc:\n\nOpen Data Catalog Configuration\n===============================\n\nOpen Data Catalog (https://github.com/azavea/Open-Data-Catalog/) is an open data catalog based on Django, Python and PostgreSQL. It was originally developed for OpenDataPhilly.org, a portal that provides access to open data sets, applications, and APIs related to the Philadelphia region. The Open Data Catalog is a generalized version of the original source code with a simple skin. It is intended to display information and links to publicly available data in an easily searchable format. The code also includes options for data owners to submit data for consideration and for registered public users to nominate a type of data they would like to see openly available to the public.\n\npycsw supports binding to an existing Open Data Catalog repository for metadata query. The binding is read-only (transactions are not in scope, as Open Data Catalog manages repository metadata changes in the application proper).\n\nOpen Data Catalog Setup\n-----------------------\n\nOpen Data Catalog provides CSW functionality using pycsw out of the box (installing ODC will also install pycsw). Settings are defined in https://github.com/azavea/Open-Data-Catalog/blob/master/OpenDataCatalog/settings.py#L165.\n\nODC settings must ensure that ``REGISTRY_PYCSW['repository']['source']`` is set to``hypermap.search.pycsw_repository``.\n\nAt this point, pycsw is able to read from the Open Data Catalog repository using the Django ORM.\n"
},
{
"path": "docs/opensearch.rst",
"content": ".. _opensearch:\n\nOpenSearch Support\n==================\n\npycsw OpenSearch support is enabled by default. There are two ways to access OpenSearch\ndepending on the deployment pattern chosen.\n\nOGC API - Records deployment\n----------------------------\n\n.. code-block:: bash\n\n http://localhost:8000/opensearch\n\nCSW legacy deployment\n---------------------\n\nHTTP requests must be specified with ``mode=opensearch`` in the base URL for OpenSearch requests, e.g.:\n\n.. code-block:: bash\n\n http://localhost/pycsw/csw.py?mode=opensearch&service=CSW&version=2.0.2&request=GetCapabilities\n\nThis will return the Description document which can then be `autodiscovered `_.\n\nOGC OpenSearch Geo and Time Extensions 1.0\n------------------------------------------\n\npycsw supports the `OGC OpenSearch Geo and Time Extensions 1.0`_ standard via the following conformance classes:\n\n- Core (GeoSpatial Service) ``{searchTerms}``, ``{geo:box}``, ``{startIndex}``, ``{count}``\n- Temporal Search core ``{time:start}``, ``{time:end}``\n\nSupported Query Parameters\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n- ``q``\n- ``time``\n- ``bbox``\n\nOGC OpenSearch Extension for Earth Observation\n----------------------------------------------\n\npycsw supports the `OGC OpenSearch Extension for Earth Observation`_ standard via the following conformance classes:\n\n- Core\n\nSupported Query Parameters\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n- ``eo:cloudCover``\n- ``eo:instrument``\n- ``eo:orbitDirection``\n- ``eo:orbitNumber``\n- ``eo:platform``\n- ``eo:processingLevel``\n- ``eo:productType``\n- ``eo:sensorType``\n- ``eo:snowCover``\n- ``eo:spectralRange``\n- ``eo:illuminationElevationAngle``\n\nMapping of non-19115 Queryable Mappings\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThe following queryables are implemented as faceted keywords given they are not\nimplemented in generic geospatial metadata standards:\n\n- ``eo:productType``\n- ``eo:orbitNumber``\n- ``eo:orbitDirection``\n- ``eo:snowCover``\n- ``eo:processingLevel``\n\nThis means metadata ingested into pycsw must have these fields implemented as keywords, as\nper the examples below:\n\n.. code-block:: xml\n\n \n \n eo:productType:S2MSI2A\n \n \n eo:orbitNumber:50\n \n \n eo:orbitDirection:DESCENDING\n \n \n eo:snowCover:0.0\n \n \n eo:procesingLevel:Level-2A\n \n \n.. code-block:: xml\n\n \n eo:productType:S2MSI2A\n eo:orbitNumber:50\n eo:orbitDirection:DESCENDING\n eo:snowCover:0.0\n eo:procesingLevel:Level-2A\n\n\nOpenSearch Temporal Queries Implementation\n------------------------------------------\n\nBy default, pycsw's OpenSearch temporal support will query the Dublin Core ``dc:date`` property as\na time instant/single point in time. To enable temporal extent search, set ``profiles=apiso`` which\nwill query the temporal extents of a metadata record (``apiso:TempExtent_begin`` and ``apiso:TempExtent_end``).\n\nAt the HTTP API level, time is supported via either ``time=t1/t2`` or ``start=t1&stop=t2``. If the\n``time`` parameter is present, it will override the ``start`` and ``stop`` parameters respectively.\n\n.. _`OGC OpenSearch Extension for Earth Observation`: https://docs.ogc.org/is/13-026r9/13-026r9.html\n.. _`OGC OpenSearch Geo and Time Extensions 1.0`: https://www.ogc.org/standards/opensearchgeo\n"
},
{
"path": "docs/outputschemas.rst",
"content": ".. _outputschemas:\n\nOutput Schema Plugins\n=====================\n\nOverview\n--------\n\npycsw allows for extending the implementation of output schemas to the core standard. outputschemas allow for a client to request metadata in a specific format (ISO, Dublin Core, FGDC, NASA DIF Atom and GM03 are default).\n\nAll outputschemas must be placed in the ``pycsw/plugins/outputschemas`` directory.\n\nRequirements\n------------\n\n.. code-block:: none\n\n pycsw/\n plugins/\n __init__.py # empty\n outputschemas/\n __init__.py # __all__ is a list of all provided outputschemas\n atom.py # default\n dif.py # default\n fgdc.py # default\n gm03.py # default\n\nImplementing a new outputschema\n-------------------------------\n\nCreate a file in ``pycsw/plugins/outputschemas``, which defines the following:\n\n- ``NAMESPACE``: the default namespace of the outputschema which will be advertised\n- ``NAMESPACE``: dict of all applicable namespaces to outputschema\n- ``XPATH_MAPPINGS``: dict of pycsw core queryables mapped to the equivalent XPath of the outputschema\n- ``write_record``: function which returns a record as an ``lxml.etree.Element`` object\n\nAdd the name of the file to ``__init__.py:__all__``. The new outputschema is now supported in pycsw.\n\nTesting\n-------\n\nNew outputschemas must add examples to the :ref:`tests` interface, which must provide example requests specific to the profile.\n"
},
{
"path": "docs/profiles.rst",
"content": ".. _profiles:\n\nProfile Plugins\n===============\n\nOverview\n--------\n\npycsw allows for the implementation of profiles to the core standard. Profiles allow specification of additional metadata format types (i.e. ISO 19139:2007, NASA DIF, INSPIRE, etc.) to the repository, which can be queried and presented to the client. pycsw supports a plugin architecture which allows for runtime loading of Python code.\n\nAll profiles must be placed in the ``pycsw/plugins/profiles`` directory.\n\nRequirements\n------------\n\n.. code-block:: none\n\n pycsw/\n plugins/\n __init__.py # empty\n profiles/ # directory to store profiles\n __init__.py # empty\n profile.py # defines abstract profile object (properties and methods) and functions to load plugins\n apiso/ # profile directory\n __init__.py # empty\n apiso.py # profile code\n ... # supporting files, etc.\n\nAbstract Base Class Definition\n------------------------------\n\nAll profile code must be instantiated as a subclass of ``profile.Profile``. Below is an example to add a ``Foo`` profile:\n\n.. code-block:: python\n\n from pycsw.plugins.profiles import profile\n\n class FooProfile(profile.Profile):\n profile.Profile.__init__(self,\n name='foo',\n version='1.0.3',\n title='My Foo Profile',\n url='http://example.org/fooprofile/docs',\n namespace='http://example.org/foons',\n typename='foo:RootElement',\n outputschema=http://example.org/foons',\n prefixes=['foo'],\n model=model,\n core_namespaces=namespaces,\n added_namespaces={'foo': 'http://example.org/foons'}\n repository=REPOSITORY['foo:RootElement'])\n\nYour profile plugin class (``FooProfile``) must implement all methods as per ``profile.Profile``. Profile methods must always return ``lxml.etree.Element`` types, or ``None``.\n\nEnabling Profiles\n-----------------\n\nAll profiles are disabled by default. To specify profiles at runtime, set the ``profiles`` value in the :ref:`configuration` to the name of the package (in the ``pycsw/plugins/profiles`` directory). To enable multiple profiles, specify as a comma separated value (see :ref:`configuration`).\n\nTesting\n-------\n\nProfiles must add examples to the :ref:`tests` interface, which must provide example requests specific to the profile.\n\nSupported Profiles\n==================\n\n.. include:: ../pycsw/plugins/profiles/apiso/docs/apiso.rst\n.. include:: ../pycsw/plugins/profiles/ebrim/docs/ebrim.rst\n"
},
{
"path": "docs/pubsub.rst",
"content": ".. _pubsub:\n\nPublish-Subscribe integration (Pub/Sub)\n=======================================\n\npycsw supports Publish-Subscribe (Pub/Sub) integration by implementing\nthe `OGC API Publish-Subscribe Workflow - Part 1: Core`_ (draft) specification.\n\nPub/Sub integration can be enabled by defining a broker that pycsw can use to\npublish notifications on given topics using CloudEvents (as per the specification).\n\nWhen enabled, core functionality of Pub/Sub includes:\n\n- displaying the broker link in the OGC API - Records landing (using the ``rel=hub`` link relation)\n- sending a notification message on metadata transactions (create, replace, update, delete)\n\nThe following message queuing protocols are supported:\n\nMQTT\n----\n\nExample directive:\n\n.. code-block:: yaml\n\n pubsub:\n broker:\n type: mqtt\n url: mqtt://localhost:1883\n channel: messages/a/data # optional\n show_link: false # default true\n\nHTTP\n----\n\nExample directive:\n\n.. code-block:: yaml\n\n pubsub:\n broker:\n type: http\n url: https://ntfy.sh\n channel: messages-a-data # optional\n show_link: true # default true\n\n.. note::\n\n For any Pub/Sub endpoints requiring authentication, encode the ``url`` value as follows:\n\n * ``mqtt://username:password@localhost:1883``\n * ``https://username:password@localhost``\n\n As with any section of the pycsw configuration, environment variables may be used as needed, for example\n to set username/password information in a URL. If ``pubsub.broker.url`` contains authentication, and\n ``pubsub.broker.show_link`` is ``true``, the authentication information will be stripped from the URL\n before displaying it on the landing page.\n\n.. note::\n\n If a ``channel`` is defined, it is used as a prefix to the relevant OGC API endpoint is used.\n\n If a ``channel`` is not defined, only the relevant OGC API endpoint is used.\n\n.. _`OGC API Publish-Subscribe Workflow - Part 1: Core`: https://docs.ogc.org/DRAFTS/25-030.html\n"
},
{
"path": "docs/repofilters.rst",
"content": ".. _repofilters:\n\nRepository Filters\n==================\n\npycsw has the ability to perform server side repository / database filters as a means to mask all requests to query against a specific subset of the metadata repository, thus providing the ability to deploy multiple pycsw instances pointing to the same database in different ways via the ``repository.filter`` configuration option.\n\nRepository filters are a convenient way to subset your repository at the server level without the hassle of creating proper database views. For large repositories, it may be better to subset at the database level for performance.\n\nScenario: One Database, Many Views\n----------------------------------\n\nImagine a sample database table of records (subset below for brevity):\n\n.. csv-table::\n :header: identifier,parentidentifier,title,abstract\n\n 1,33,foo1,bar1\n 2,33,foo2,bar2\n 3,55,foo3,bar3\n 4,55,foo1,bar1\n 5,21,foo5,bar5\n 5,21,foo6,bar6\n\nA default pycsw instance (with no ``repository.filters`` option) will always process requests against the entire table. So a CSW `GetRecords` filter like:\n\n.. code-block:: xml\n\n \n \n apiso:Title\n foo1\n \n \n\n...will return:\n\n.. csv-table::\n :header: identifier,parentidentifier,title,abstract\n\n 1,33,foo1,bar1\n 4,55,foo1,bar1\n\nSuppose you wanted to deploy another pycsw instance which serves metadata from the same database, but only from a specific subset. Here we set the ``repository.filter`` option:\n\n.. code-block:: yaml\n\n repository:\n database: sqlite:///records.db\n filter: pycsw:ParentIdentifier = '33'\n\nThe same CSW `GetRecords` filter as per above then yields the following results:\n\n.. csv-table::\n :header: identifier,parentidentifier,title,abstract\n\n 1,33,foo1,bar1\n\nAnother example:\n\n.. code-block:: text\n\n repository:0\n database: sqlite:///records.db\n filter: \"pycsw:ParentIdentifier != '33'\"\n\nThe same CSW `GetRecords` filter as per above then yields the following results:\n\n.. csv-table::\n :header: identifier,parentidentifier,title,abstract\n\n 4,55,foo1,bar1\n\nThe ``repository.filter`` option accepts all core queryables set in the pycsw core model (see ``pycsw.config.StaticContext.md_core_model`` for the complete list).\n"
},
{
"path": "docs/repositories.rst",
"content": ".. _repositories:\n\nRepository Plugins\n==================\n\nOverview\n--------\n\npycsw allows for the implementation of custom repositories in order to connect to a backend different from the pycsw's default. This is especially useful when downstream applications manage their own metadata model/database/document store and want pycsw to connect to it directly instead of using pycsw's default model, thus creating duplicate repositories which then require syncronization/accounting. Repository plugins enable a single metadata backend which is independent from the pycsw setup. pycsw thereby becomes a pure wrapper around a given backend in providing OGC API - Records, CSW and other APIs atop a given application.\n\nAll outputschemas must be placed in the ``pycsw/plugins/outputschemas`` directory.\n\nRequirements\n------------\n\nRepository plugins:\n\n- can be developed and referenced / connected external to pycsw\n- must be accessible within the ``PYTHONPATH`` of a given application\n- must implement pycsw's ``pycsw.core.repository.Repository`` properties and methods\n- must be specified in the pycsw :ref:`configuration` as a class reference (e.g. ``path.to.repo_plugin.MyRepository``)\n- must minimally implement the ``query_insert``, ``query_domain``, ``query_ids``, and ``query`` methods\n\nConfiguration\n-------------\n\n- set pycsw's ``repository.source`` setting to the class which implements the custom repository:\n\n.. code-block:: yaml\n\n repository:\n mappings: 'path.to.repo_plugin.MyRepository'\n"
},
{
"path": "docs/requirements-mocked.txt",
"content": "# This file holds some fake requirements to fool the readthedocs service into\n# building the documentation. For more information, see\n# https://github.com/geopython/pycsw/issues/521\nsphinx\n"
},
{
"path": "docs/sitemaps.rst",
"content": ".. _sitemaps:\n\nXML Sitemaps\n============\n\n`XML Sitemaps`_ can be generated by running:\n\n.. code-block:: bash\n\n pycsw-admin.py gen-sitemap --config default.yml --output sitemap.xml\n\nThe ``sitemap.xml`` file should be saved to an an area on your web server (parallel to or above your pycsw install location) to enable web crawlers to index your repository. \n\n.. _`XML Sitemaps`: https://www.sitemaps.org/index.html\n"
},
{
"path": "docs/soap.rst",
"content": ".. _soap:\n\nSOAP\n====\n\npycsw's CSW implementation supports handling of SOAP encoded requests and responses as per subclause 10.3.2 of OGC:CSW 2.0.2. SOAP request examples can be found in ``tests/index.html``.\n\n"
},
{
"path": "docs/sru.rst",
"content": ".. _sru:\n\nSearch/Retrieval via URL (SRU) Support\n======================================\n\npycsw supports the `Search/Retrieval via URL`_ search protocol implementation as per subclause 8.4 of the OpenGIS Catalogue Service Implementation Specification.\n\nSRU support is enabled by default. There are two ways to access SRU\ndepending on the deployment pattern chosen.\n\nOGC API - Records deployment\n----------------------------\n\n.. code-block:: bash\n\n http://localhost:8000/sru\n\nCSW legacy deployment\n---------------------\n\nHTTP GET requests must be specified with ``mode=sru`` for SRU requests, e.g.:\n\n.. code-block:: bash\n\n http://localhost/pycsw/csw.py?mode=sru&operation=searchRetrieve&query=foo\n\nSee https://www.loc.gov/standards/sru/misc/simple.html for example SRU requests.\n\n.. _`Search/Retrieval via URL`: https://www.loc.gov/standards/sru\n"
},
{
"path": "docs/stac.rst",
"content": ".. _stac:\n\nSpatioTemporal Asset Catalog (STAC) API Support\n===============================================\n\nVersions\n--------\n\npycsw supports `SpatioTemporal Asset Catalog API version v1.0.0`_ by default.\n\npycsw implements provides STAC support in the following manner:\n\n* a pycsw repository is equivalent to a STAC collection\n* pycsw metadata records are equivalent to STAC items\n\nThe STAC specification is designed with the same principles as OGC API - Records.\n\n\nImplementation\n--------------\n\nThe following design patterns are put forth for STAC support:\n\nCollections\n^^^^^^^^^^^\n\n* any pycsw record that is ingested as a STAC Collection will appear on\n ``/stac/collections`` as a collection\n\nSearch\n^^^^^^\n\n* In addition to OGC API - Records ``/collections/metadata:main/items`` search,\n STAC API specific searches are realized via ``/stac/search`` which conforms to the STAC API items-search conformance class.\n\nFiltering\n^^^^^^^^^\n\nSTAC API filtering is realized by `OGC Common Query Language (CQL2)`_ via HTTP GET and POST. For GET requests, the `filter=` query parameter can be used. For POST requests, a JSON payload with a `filter` property expressing the CQL2 can be used.\n\nLinks and Assets\n^^^^^^^^^^^^^^^^\n\nSTAC support will render links as follows:\n\n* links that are enclosures will be encoded as STAC assets (in ``assets``)\n* all other links remain as record links (in ``links``)\n\nTransactions\n^^^^^^^^^^^^\n\nSTAC Transactions are supported as per the following STAC API specifications:\n\n* `STAC API - Transaction Extension Specification`_.\n* `STAC API - Collection Transaction Extension`_.\n\nRequest Examples\n----------------\n\n.. code-block:: bash\n\n # landing page\n http://localhost:8000/stac\n\n # collections\n http://localhost:8000/stac/collections\n\n # collection queries\n # query parameters can be combined (exclusive/AND)\n\n # landing page\n http://localhost:8000/stac\n # OpenAPI\n http://localhost:8000/stac/openapi\n # collections\n http://localhost:8000/stac/collections\n # collections query, full text search\n http://localhost:8000/stac/collections?q=sentinel\n # collections query, spatial query\n http://localhost:8000/stac/collections?bbox=-142,42,-52,84\n # collections query, full text search and spatial query\n http://localhost:8000/stac/collections?q=sentinel,bbox=-142,42,-52,84\n # collections query, limiting results\n http://localhost:8000/stac/collections?limit=2\n # collections query, spatial query\n # single collection\n http://localhost:8000/stac/collections/metadata:main\n # collection queryables, all records\n http://localhost:8000/stac/queryables\n # collection query, all records\n http://localhost:8000/stac/search\n # collection query, full text search\n http://localhost:8000/stac/search?q=lorem\n # collection query, spatial query\n http://localhost:8000/stac/search?bbox=-142,42,-52,84\n # collection query, temporal query\n http://localhost:8000/stac/search?datetime=2001-10-30/2007-10-30\n # collection query, temporal query, before\n http://localhost:8000/stac/search?datetime=../2007-10-30\n # collection query, temporal query, after\n http://localhost:8000/stac/search?datetime=2007-10-30/..\n # collection query, property query\n http://localhost:8000/stac/search?title=Lorem%20ipsum\n # collection query, CQL filter\n http://localhost:8000/stac/search?filter=title like \"%lorem%\"\n # collection query, limiting results\n http://localhost:8000/stac/search?limit=1\n # collection filter query, limiting results\n http://localhost:8000/stac/search?limit=1&collections=landsat\n # collection ids filter query, limiting results\n http://localhost:8000/stac/search?limit=1&ids=id1,id2\n # collection query, paging\n http://localhost:8000/stac/search?limit=10&offset=10\n # collection query, paging and sorting (default ascending)\n http://localhost:8000/stac/search?limit=10&offset=10&sortby=title\n # collection query, paging and sorting (descending)\n http://localhost:8000/stac/search?limit=10&offset=10&sortby=-title\n # collection item as GeoJSON\n http://localhost:8000/stac/collections/metadata:main/items/{itemId}\n\n # CQL2 JSON (as curl commands)\n\n # search by creation date\n curl --location --request POST 'http://localhost:8000/stac/search' \\\n --header 'Content-Type: application/query-cql-json' \\\n --data-raw '{\n \"filter-lang\": \"cql2-json\",\n \"filter\": {\n \"op\": \"<=\",\n \"args\": [\n {\n \"property\": \"date_creation\"\n },\n \"2025-12-15\"\n ]\n }\n }'\n\n # search by creation date\n curl --location --request POST 'http://localhost:8000/stac/search' \\\n --header 'Content-Type: application/query-cql-json' \\\n --data-raw '{\n \"filter-lang\": \"cql2-json\",\n \"filter\": {\n \"op\": \"and\",\n \"args\": [\n { \n \"op\": \"in\",\n \"args\": [\n { \n \"property\": \"parentidentifier\"\n }, \n [ \n \"sentinel-2-l2a\"\n ] \n ] \n } \n ] \n } \n }'\n\n.. _`SpatioTemporal Asset Catalog API version v1.0.0`: https://github.com/radiantearth/stac-api-spec\n.. _`STAC API - Transaction Extension Specification`: https://github.com/stac-api-extensions/transaction\n.. _`STAC API - Collection Transaction Extension`: https://github.com/stac-api-extensions/collection-transaction\n.. _`OGC Common Query Language (CQL2)`: https://docs.ogc.org/is/21-065r2/21-065r2.html\n\n"
},
{
"path": "docs/support.rst",
"content": ".. _support:\n\nSupport\n=======\n\nCommunity\n---------\n\nPlease see the `Community`_ page for information on the pycsw community, getting support, and how to get involved.\n\n.. _`Community`: https://pycsw.org/community\n"
},
{
"path": "docs/testing.rst",
"content": ".. _tests:\n\nTesting\n=======\n\nThere are a number of test suites that perform mostly functional testing.\nThese tests ensure that pycsw operates correctly and is compliant with the \nvarious supported standards. There is also a growing set of unit tests. \nThese focus on smaller scope testing, in order to verify that individual \nbits of code are working as expected.\n\nTests can be run locally as part of the development cycle. They are also\nrun on pycsw's `GitHub Actions`_ continuous integration setup against all pushes and\npull requests to the code repository.\n\npycsw uses `pytest`_ for managing its automated tests.\n\nInstall pytest from the development requirements.\n\n.. code:: bash\n\n pip3 install -r requirements-dev.txt\n\nOGC API - Records\n-----------------\n\nTests for OGC API - Records are located in ``tests/functionaltests/suites/oarec``. They\ncan be run as follows:\n\n.. code:: bash\n\n pytest tests/functionaltests/suites/oarec\n\n\nOGC CSW\n-------\n\nTests for OGC CSW are located in ``tests/functionaltests/suites/csw30``. They\ncan be run as follows:\n\n.. code:: bash\n\n pytest tests/functionaltests/suites/csw30\n\n\n.. _ogc-cite:\n\nOGC CITE\n--------\n\nIn addition to pycsw's own tests, all public releases are also tested via the\nOGC `Compliance & Interoperability Testing & Evaluation Initiative`_ (CITE).\nThe pycsw `wiki`_ documents CITE testing procedures and status.\n\nTests for OGC CITE are located in ``tests/functionaltests/suites/cite``. They\ncan be run as follows:\n\n.. code:: bash\n\n pytest tests/functionaltests/suites/cite\n\n\nFunctional test suites\n----------------------\n\nMost of pycsw's tests are `functional tests`_. This means that\neach test case is based on the requirements mandated by the specifications of\nthe various standards that pycsw implements. These tests focus on making sure\nthat pycsw works as expected.\n\n\nSuites for xml-based standards (CSW, ATOM, etc)\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nA number of different test suites exist under ``tests/functionaltests/suites``.\nEach suite specifies the following structure:\n\n* A mandatory ``default.yml`` file with the pycsw configuration that must be\n used by the test suite;\n\n* A mandatory ``expected/`` directory containing the expected results for each\n request;\n\n* An optional ``data/`` directory that contains ``.xml`` files with testing\n data that is to be loaded into the suite's database before running the tests.\n The presence of this directory and its contents have the following meaning\n for tests:\n\n * If ``data/`` directory is present and contains files, they will be loaded\n into a new database for running the tests of the suite;\n\n * If ``data/`` directory is present and does not contain any data files, a\n new empty database is used in the tests;\n\n * If ``data/`` directory is absent, the suite will use a database populated\n with test data from the ``CITE`` suite.\n\n* An optional ``get/requests.txt`` file that holds request parameters used for\n making HTTP GET requests.\n\n Each line in the file must be formatted with the following scheme:\n\n test_id,request_query_string\n\n For example:\n\n TestGetCapabilities,service=CSW&version=2.0.2&request=GetCapabilities\n\n When tests are run, the *test_id* is used for naming each test and for\n finding the expected result.\n\n* An optional ``post/`` directory that holds ``.xml`` files used for making\n HTTP POST requests\n\nTest generation uses pytest's `pytest_generate_tests`_ function. This\nfunction is implemented in `tests/functionaltests/conftest.py`. It provides\nan automatic parametrization of the\n`tests/functionaltests/test_suites_functional:test_suites` test.\nThis parametrization causes the generation of a test for each of the GET and\nPOST requests defined in a suite's directory.\n\n\nSuites for JSON-based standards (OGC API - Records, STAC API, etc)\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThese are implemented as simple pytest-based tests, for which no custom\ntest generation function exists. They are simpler to generate - look into the\nimplementation in `tests/functionaltests/suites/oarec` for examples.\n\n\nUnit tests\n----------\n\npycsw also features unit tests. These deal with testing the expected behaviour\nof individual functions.\n\nThe usual implementation of unit tests is to import the function/method under\ntest, run it with a set of known arguments and assert that the result matches\nthe expected outcome.\n\nUnit tests are defined in `pycsw/tests/unittests/`.\n\npycsw's unit tests are marked with the `unit` marker. This makes it easy to run\nthem in isolation:\n\n.. code:: bash\n\n # running only the unit tests (not the functional ones)\n pytest -m unit\n\n\n\nRunning tests\n-------------\n\nSince pycsw uses `pytest`_, tests are run with the ``pytest`` runner. A basic\ntest run can be made with:\n\n.. code:: bash\n\n pytest\n\nThis command will run all tests and report on the number of successes, failures\nand also the time it took to run them. The `pytest` command accepts several\nadditional parameters that can be used in order to customize the execution of\ntests. Look into `pytest's invocation documentation`_ for a more complete\ndescription. You can also get a description of the available parameters by\nrunning:\n\n.. code:: bash\n\n pytest --help\n\n\nRunning specific suites and test cases\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\npytest allows tagging tests with markers. These can be used to selectively run\nsome tests. pycsw uses two markers:\n\n* ``unit`` - run only input tests\n* ``functional``- run only functional tests\n\nMarkers can be specified by using the ``-m `` flag.\n\n.. code:: bash\n\n pytest -m functional # run only functional tests\n\nYou can also use the ``-k `` flag to select which tests to run. Since each\ntest's name includes the suite name, http method and an identifier for the\ntest, it is easy to run only certain tests.\n\n.. code:: bash\n\n pytest -k \"apiso and GetRecords\" # run only tests from the apiso suite that have GetRecords in their name\n pytest -k \"post and GetRecords\" # run only tests that use HTTP POST and GetRecords in their name\n pytest -k \"not harvesting\" # run all tests except those from the harvesting suite\n\n\nThe ``-m`` and ``-k`` flags can be combined.\n\n\nExiting fast\n^^^^^^^^^^^^\n\nThe ``--exitfirst`` (or ``-x``) flag can be used to stop the test runner\nimmediately as soon as a test case fails.\n\n.. code:: bash\n\n pytest --exitfirst\n\n\nSeeing more output\n^^^^^^^^^^^^^^^^^^\n\nThere are three main ways to get more output from running tests:\n\n* The ``--verbose`` (or ``-v``) flag;\n\n* The ``--capture=no`` flag - Messages sent to stdout by a test are not\n suppressed;\n\n* The ``--pycsw-loglevel`` flag - Sets the log level of the pycsw instance\n under test. Set this value to ``debug`` in order to see all debug messages\n sent by pycsw while processing a request.\n\n\n.. code:: bash\n\n pytest --verbose\n pytest --pycsw-loglevel=debug\n pytest -v --capture=no --pycsw-loglevel=debug\n\n\nComparing xml-based suite results with difflib instead of XML c14n\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nFunctional tests for XML-based suites compare results with their expected\nvalues by using `XML canonicalisation - XML c14n`_.\nAlternatively, you can call pytest with the ``--functional-prefer-diffs``\nflag. This will enable comparison based on Python's ``difflib``. Comparison\nis made on a line-by-line basis and in case of failure, a unified diff will\nbe printed to standard output.\n\n.. code:: bash\n\n pytest -m functional -k 'harvesting' --functional-prefer-diffs\n\n\nSaving test results for disk\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThe result of each XML-based suite test can be saved to disk by using the\n``--functional-save-results-directory`` option. Each result file is named\nafter the test identifier it has when running with pytest.\n\n.. code:: bash\n\n pytest -m functional -k 'not harvesting' --functional-save-results-directory=/tmp/pycsw-test-results\n\n\n\nTest coverage\n^^^^^^^^^^^^^\n\nUse the `--cov pycsw` flag in order to see information on code coverage. It is\npossible to get output in a variety of formats.\n\n.. code:: bash\n\n pytest --cov pycsw\n\n\nSpecifying a timeout for tests\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThe `--timeout ` option can be used to specify that if a test takes\nmore than `` to run it is considered to have failed. Seconds can be\na float, so it is possibe to specify sub-second timeouts\n\n.. code:: bash\n\n pytest --timeout=1.5\n\n\nLinting with flake8\n^^^^^^^^^^^^^^^^^^^\n\nUse the `--flake8` flag to also check if the code complies with Python's style\nguide\n\n.. code:: bash\n\n pytest --flake8\n\n\nTesting multiple Python versions\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nFor testing multiple Python versions and configurations simultaneously you can\nuse `tox`_. pycsw includes a `tox.ini` file with a suitable configuration. It\ncan be used to run tests against multiple Python versions and also multiple\ndatabase backends. When running `tox` you can send arguments to the `pytest`\nrunner by using the invocation `tox -- `.\nExamples:\n\n.. code:: bash\n\n # install tox on your system\n sudo pip3 install tox\n\n # run all tests on multiple Python versions against all databases,\n # with default arguments\n tox\n\n # run tests only with python3.7 and using sqlite as backend\n tox -e py37 -sqlite\n\n # run only csw30 suite tests with python3.7 and postgresql as backend\n tox -e py37-postgresql -- -k 'csw30'\n\n\nWeb Testing\n^^^^^^^^^^^\n\nYou can also use the pycsw tests via your web browser to perform sample\nrequests against your pycsw install. The tests are is located in\n``tests/``. To generate the HTML page:\n\n.. code-block:: bash\n\n python3 gen_html.py > index.html\n\n\nThen navigate to ``http://host/path/to/pycsw/tests/index.html``.\n\n\n\n.. _Compliance & Interoperability Testing & Evaluation Initiative: https://github.com/opengeospatial/cite/wiki\n.. _functional tests: https://en.wikipedia.org/wiki/Functional_testing\n.. _pytest's invocation documentation: https://docs.pytest.org/en/stable/usage.html\n.. _pytest: https://docs.pytest.org\n.. _Github Actions: https://github.com/geopython/pycsw/actions\n.. _tox: https://tox.readthedocs.io\n.. _wiki: https://github.com/geopython/pycsw/wiki/OGC-CITE-Compliance\n.. _pytest_generate_tests: #basic-pytest-generate-tests-example\n.. _XML canonicalisation - XML c14n: https://www.w3.org/TR/xml-c14n/\n"
},
{
"path": "docs/tools.rst",
"content": ".. _tools:\n\nCataloguing and Metadata Tools\n==============================\n\nOGC API - Records Clients and Servers\n-------------------------------------\n\n- `OGC API - Records official implementations `_\n\nCSW Clients\n-----------\n\n- `Geoportal CSW Clients `_\n- `OWSLib `_\n- `QGIS MetaSearch `_\n\nCSW Servers\n-----------\n\n- `deegree `_\n- `GeoNetwork opensource `_\n\nMetadata Editing Tools\n----------------------\n\n- `pygeometa `_\n- `CatMDEdit `_\n- `EUOSME `_\n- `GIMED `_\n- `Metatools `_ (`QGIS `_ plugin)\n"
},
{
"path": "docs/transactions.rst",
"content": ".. _transactions:\n\nTransactions using CSW\n======================\n\npycsw's CSW implementation has the ability to process CSW Harvest and Transaction requests (CSW-T). Transactions are disabled by default; to enable, ``manager.transactions`` must be set to ``true``. Access to transactional functionality is limited to IP addresses which must be set in ``manager.allowed_ips``.\n\nSupported Resource Types\n------------------------\n\nFor transactions and harvesting, pycsw supports the following metadata resource types by default:\n\n.. csv-table::\n :header: Resource Type,Namespace,Transaction,Harvest\n\n Dublin Core,``http://www.opengis.net/cat/csw/2.0.2``,yes,yes\n FGDC,``http://www.opengis.net/cat/csw/csdgm``,yes,yes\n GM03,``http://www.interlis.ch/INTERLIS2.3``,yes,yes\n ISO 19139,``http://www.isotc211.org/2005/gmd``,yes,yes\n ISO GMI,``http://www.isotc211.org/2005/gmi``,yes,yes\n OGC:CSW 2.0.2,``http://www.opengis.net/cat/csw/2.0.2``,,yes\n OGC:WMS 1.1.1/1.3.0,``http://www.opengis.net/wms``,,yes\n OGC:WMTS 1.0.0,``http://www.opengis.net/wmts/1.0``,,yes\n OGC:WFS 1.0.0/1.1.0/2.0.0,``http://www.opengis.net/wfs``,,yes\n OGC:WCS 1.0.0,``http://www.opengis.net/wcs``,,yes\n OGC:WPS 1.0.0,``http://www.opengis.net/wps/1.0.0``,,yes\n OGC:SOS 1.0.0,``http://www.opengis.net/sos/1.0``,,yes\n OGC:SOS 2.0.0,``http://www.opengis.net/sos/2.0``,,yes\n `WAF`_,``urn:geoss:waf``,,yes\n\nAdditional metadata models are supported by enabling the appropriate :ref:`profiles`.\n\n.. note::\n\n For transactions to be functional when using SQLite3, the SQLite3 database file (**and its parent directory**) must be fully writable. For example:\n\n.. code-block:: bash\n\n $ mkdir /path/data\n $ chmod 777 /path/data\n $ chmod 666 test.db\n $ mv test.db /path/data\n\nFor CSW-T deployments, it is strongly advised that this directory reside in an area that is not accessible by HTTP.\n\nHarvesting\n----------\n\n.. note::\n\n Your server must be able to make outgoing HTTP requests for this functionality.\n\npycsw supports the CSW-T ``Harvest`` operation. Records which are harvested require to setup a cronjob to periodically refresh records in the local repository. A sample cronjob is available in ``etc/harvest-all.cron`` which points to ``pycsw-admin.py`` (you must specify the correct path to your configuration). Harvest operation results can be sent by email (via ``mailto:``) or ftp (via ``ftp://``) or ftps (via ``ftps://``) if the Harvest request specifies ``csw:ResponseHandler``.\n\n.. note::\n\n For ``csw:ResponseHandler`` values using the ``mailto:`` protocol, you must have ``server.smtp_host`` set in your :ref:`configuration `.\n\nOGC Web Services\n^^^^^^^^^^^^^^^^\n\nWhen harvesting OGC web services, requests can provide the base URL of the service as part of the Harvest request. pycsw will construct a ``GetCapabilities`` request dynamically.\n\nWhen harvesting other CSW servers, pycsw pages through the entire CSW in default increments of 10. This value can be modified via the ``manager.csw_harvest_pagesize`` :ref:`configuration ` option. It is strongly advised to use the ``csw:ResponseHandler`` parameter for harvesting large CSW catalogues to prevent HTTP timeouts.\n\nTransaction operations\n----------------------\n\npycsw supports 3 modes of the ``Transaction`` operation (``Insert``, ``Update``, ``Delete``):\n\n- **Insert**: full XML documents can be inserted as per CSW-T\n- **Update**: updates can be made as full record updates or record properties against a ``csw:Constraint``\n- **Delete**: deletes can be made against a ``csw:Constraint``\n\nTransaction operation results can be sent by email (via ``mailto:``) or ftp (via ``ftp://``) or ftps (via ``ftps://``) if the Transaction request specifies ``csw:ResponseHandler``.\n\nThe :ref:`tests` contain CSW-T request examples.\n\n.. _`WAF`: https://seabass.ieee.org/groups/geoss/index.php?option=com_sir_200&Itemid=157&ID=183\n\nTransactions using OGC API - Records\n====================================\n\npycsw's OGC API - Records support provides transactional capabilities via the `OGC API - Features - Part 4: Create, Replace, Update and Delete`_ draft specification,\nwhich follows RESTful patterns for insert/update/delete of resources.\n\nSupported Resource Types\n------------------------\n\nAll resource types supported by CSW Transactions are supported via OGC API - Records transactional workflow. Note that the HTTP ``Content-Type``\nheader MUST be set according to the media type of the given resource (i.e. ``application/json``, ``application/xml``, etc.).\n\nTransaction operations\n----------------------\n\nThe below examples demonstrate transactional workflow using pycsw's OGC API - Records endpoint:\n\n.. code-block:: bash\n\n # insert GeoJSON metadata\n curl -v -H \"Content-Type: application/geo+json\" -XPOST http://localhost:8000/collections/metadata:main/items -d @foorecord.json\n\n # update metadata\n curl -v -H \"Content-Type: application/geo+json\" -XPUT http://localhost:8000/collections/metadata:main/items/foorecord -d @foorecord.json\n\n # delete metadata\n curl -v -XDELETE http://localhost:8000/collections/metadata:main/items/foorecord\n\n # insert XML metadata\n curl -v -H \"Content-Type: application/xml\" -XPOST http://localhost:8000/collections/metadata:main/items -d @foorecord.xml\n\nHarvesting\n----------\n\nHarvesting is not yet supported via OGC API - Records.\n\nTransactions using STAC API\n===========================\n\npycsw's STAC API support provides transactional capabilities via the `STAC API - Transaction Extension Specification`_ and `STAC API - Collection Transaction Extension`_ specifications,\nwhich follows RESTful patterns for insert/update/delete of resources.\n\nSupported Resource Types\n------------------------\n\nSTAC Collections, Items and Item Collections are supported via OGC API - Records transactional workflow. Note that the HTTP ``Content-Type``\nheader MUST be set to (i.e. ``application/json``).\n\nTransaction operations\n----------------------\n\nThe below examples demonstrate transactional workflow using pycsw's OGC API - Records endpoint:\n\n.. code-block:: bash\n\n # insert STAC Item\n curl -v -H \"Content-Type: application/json\" -XPOST http://localhost:8000/stac/collections/metadata:main/items -d @fooitem.json\n\n # update STAC Item\n curl -v -H \"Content-Type: application/json\" -XPUT http://localhost:8000/stac/collections/metadata:main/items/fooitem -d @fooitem.json\n\n # delete STAC Item\n curl -v -XDELETE http://localhost:8000/stac/collections/metadata:main/items/fooitem\n\n # insert STAC Item Collection\n curl -v -H \"Content-Type: application/json\" -XPOST http://localhost:8000/stac/collections/metadata:main/items -d @fooitemcollection.json\n\n # insert STAC Collection\n curl -v -H \"Content-Type: application/json\" -XPOST http://localhost:8000/stac/collections -d @foocollection.json\n\n # update STAC Collection\n curl -v -H \"Content-Type: application/json\" -XPUT http://localhost:8000/stac/collections/foocollection -d @foocollection.json\n\n # delete STAC Collection\n curl -v -XDELETE http://localhost:8000/stac/collections/foocollection\n\n.. _`OGC API - Features - Part 4: Create, Replace, Update and Delete`: https://docs.ogc.org/DRAFTS/20-002.html\n.. _`STAC API - Transaction Extension Specification`: https://github.com/stac-api-extensions/transaction\n.. _`STAC API - Collection Transaction Extension`: https://github.com/stac-api-extensions/collection-transaction\n"
},
{
"path": "docs/xslt.rst",
"content": ".. _xslt:\n\nXSLT Support\n============\n\nBy default, pycsw performs metadata transformations using a generic framework\nthat attempts to cover generic use cases. pycsw users can also specify custom\nXSLT transformations for specific use cases or communities.\n\nTo specify a custom XSLT transformation, you must map to input and output\noutputschemas supported by pycsw, where the input outputschema must match\nthe metadata as ingested and stored in the repository.\n\n.. code-block:: yaml\n\n xslt:\n - input_os: http://www.opengis.net/cat/csw/2.0.2\n output_os: http://www.isotc211.org/2005/gmd\n transform: tests/functionaltests/suites/xslt/custom.xslt\n\n\nThe ``xslt`` directive must point to a valid XSLT document on disk.\n\n.. note::\n\n You may also use environment variables to point to XSLT files.\n"
},
{
"path": "etc/harvest-all.cron",
"content": "# run cronjob daily at 0400h\n#\n# info on setting up cron at http://www.unixgeeks.org/security/newbie/unix/cron-1.html\n\n00 04 * * * /path/to/pycsw-admin.py refresh-harvested-records --config /path/to/default.yml\n"
},
{
"path": "etc/mappings.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2015 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\n# sample mappings.py\n#\n# use this file to bind to an existing alternate metadata database model\n#\n# steps:\n# - update the 'mappings' dict to the column names of your existing database\n# - set repository.mappings to the location of this file\n\nMD_CORE_MODEL = {\n 'typename': 'pycsw:CoreMetadata',\n 'outputschema': 'http://pycsw.org/metadata',\n 'mappings': {\n 'pycsw:Identifier': 'identifier',\n 'pycsw:Typename': 'typename',\n 'pycsw:Schema': 'schema',\n 'pycsw:MdSource': 'mdsource',\n 'pycsw:InsertDate': 'insert_date',\n 'pycsw:XML': 'xml',\n 'pycsw:AnyText': 'anytext',\n 'pycsw:Language': 'language',\n 'pycsw:Title': 'title',\n 'pycsw:Abstract': 'abstract',\n 'pycsw:Keywords': 'keywords',\n 'pycsw:KeywordType': 'keywordstype',\n 'pycsw:Themes': 'themes',\n 'pycsw:Format': 'format',\n 'pycsw:Source': 'source',\n 'pycsw:Date': 'date',\n 'pycsw:Modified': 'date_modified',\n 'pycsw:Type': 'type',\n 'pycsw:BoundingBox': 'wkt_geometry',\n 'pycsw:CRS': 'crs',\n 'pycsw:AlternateTitle': 'title_alternate',\n 'pycsw:RevisionDate': 'date_revision',\n 'pycsw:CreationDate': 'date_creation',\n 'pycsw:PublicationDate': 'date_publication',\n 'pycsw:OrganizationName': 'organization',\n 'pycsw:SecurityConstraints': 'securityconstraints',\n 'pycsw:ParentIdentifier': 'parentidentifier',\n 'pycsw:TopicCategory': 'topicategory',\n 'pycsw:ResourceLanguage': 'resourcelanguage',\n 'pycsw:GeographicDescriptionCode': 'geodescode',\n 'pycsw:Denominator': 'denominator',\n 'pycsw:DistanceValue': 'distancevalue',\n 'pycsw:DistanceUOM': 'distanceuom',\n 'pycsw:TempExtent_begin': 'time_begin',\n 'pycsw:TempExtent_end': 'time_end',\n 'pycsw:ServiceType': 'servicetype',\n 'pycsw:ServiceTypeVersion': 'servicetypeversion',\n 'pycsw:Operation': 'operation',\n 'pycsw:CouplingType': 'couplingtype',\n 'pycsw:OperatesOn': 'operateson',\n 'pycsw:OperatesOnIdentifier': 'operatesonidentifier',\n 'pycsw:OperatesOnName': 'operatesoname',\n 'pycsw:Degree': 'degree',\n 'pycsw:AccessConstraints': 'accessconstraints',\n 'pycsw:OtherConstraints': 'otherconstraints',\n 'pycsw:Classification': 'classification',\n 'pycsw:ConditionApplyingToAccessAndUse': 'conditionapplyingtoaccessanduse',\n 'pycsw:Lineage': 'lineage',\n 'pycsw:ResponsiblePartyRole': 'responsiblepartyrole',\n 'pycsw:SpecificationTitle': 'specificationtitle',\n 'pycsw:SpecificationDate': 'specificationdate',\n 'pycsw:SpecificationDateType': 'specificationdatetype',\n 'pycsw:Creator': 'creator',\n 'pycsw:Publisher': 'publisher',\n 'pycsw:Contributor': 'contributor',\n 'pycsw:Relation': 'relation',\n 'pycsw:Links': 'links',\n }\n}\n"
},
{
"path": "etc/migrations/2.x-3.0/migrate.sql",
"content": "alter table records add column metadata TEXT;\nalter table records add column metadata_type TEXT default 'application/xml';\nalter table records add column edition TEXT;\nalter table records add column contacts TEXT;\nalter table records add column themes TEXT;\nalter table records add column illuminationelevationangle TEXT;\nalter table records alter column cloudcover type real using cast(cloudcover as float);\nalter table records alter column distancevalue type real using cast(distancevalue as float);\ndrop index ix_records_links;\nvacuum;\n"
},
{
"path": "etc/pycsw",
"content": "\n Options FollowSymLinks +ExecCGI\n Allow from all\n AddHandler cgi-script .py\n\n"
},
{
"path": "etc/pycsw.conf",
"content": "\n Options +FollowSymLinks +ExecCGI\n Require all granted\n AddHandler cgi-script .py\n\n"
},
{
"path": "etc/pycsw.desktop",
"content": "[Desktop Entry]\nType=Application\nEncoding=UTF-8\nName=pycsw\nComment=pycsw catalog server\nExec=xdg-open http://localhost/pycsw/tests/index.html\nIcon=/var/www/html/pycsw/docs/_static/pycsw-logo.png\nTerminal=false\nStartupNotify=false\nCategories=Education;Geography;\n"
},
{
"path": "pycsw/__init__.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n# Ricardo Garcia Silva \n#\n# Copyright (c) 2024 Tom Kralidis\n# Copyright (c) 2017 Ricardo Garcia Silva\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\n__version__ = '3.0-dev'\n"
},
{
"path": "pycsw/broker/__init__.py",
"content": "# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2025 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport importlib\n\nfrom pycsw.broker.base import BasePubSubClient\n\n\ndef load_client(def_: dict) -> BasePubSubClient:\n \"\"\"\n Load Pub/Sub client plugin\n\n :param def: `dict` of client definition\n\n :returns: PubSubClient object\n \"\"\"\n\n module, class_ = CLIENTS[def_['type']].rsplit('.', 1)\n module = importlib.import_module(module)\n\n return getattr(module, class_)(def_)\n\n\nCLIENTS = {\n 'mqtt': 'pycsw.broker.mqtt.MQTTPubSubClient',\n 'http': 'pycsw.broker.http.HTTPPubSubClient'\n}\n"
},
{
"path": "pycsw/broker/base.py",
"content": "# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2025 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport logging\nimport random\nfrom urllib.parse import urlparse\n\nfrom pycsw.core.util import remove_url_auth\n\nLOGGER = logging.getLogger(__name__)\n\n\nclass BasePubSubClient:\n \"\"\"Base Pub/Sub client\"\"\"\n\n def __init__(self, publisher_def: dict):\n \"\"\"\n Initialize object\n\n :param publisher_def: publisher definition\n\n :returns: pycsw.broker.base.BasePubSubClient\n \"\"\"\n\n self.type = None\n self.client_id = f'pycsw-pubsub-{random.randint(0, 1000)}'\n self.channel = publisher_def.get('channel')\n\n self.show_link = publisher_def.get('show_link', True)\n self.broker = publisher_def['url']\n self.broker_url = urlparse(publisher_def['url'])\n self.broker_safe_url = remove_url_auth(self.broker)\n\n def connect(self) -> None:\n \"\"\"\n Connect to a Pub/Sub broker\n\n :returns: None\n \"\"\"\n\n raise NotImplementedError()\n\n def pub(self, channel: str, message: str) -> bool:\n \"\"\"\n Publish a message to a broker/channel\n\n :param channel: `str` of channel\n :param message: `str` of message\n\n :returns: `bool` of publish result\n \"\"\"\n\n raise NotImplementedError()\n\n def __repr__(self):\n return f' {self.broker_safe_url}'\n"
},
{
"path": "pycsw/broker/http.py",
"content": "# =================================================================\n#\n# Authors: Tom Kralidis \n# Angelos Tzotsos \n#\n# Copyright (c) 2026 Tom Kralidis\n# Copyright (c) 2025 Angelos Tzotsos\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport logging\n\nimport requests\n\nfrom pycsw.broker.base import BasePubSubClient\n\nLOGGER = logging.getLogger(__name__)\n\n\nclass HTTPPubSubClient(BasePubSubClient):\n \"\"\"HTTP client\"\"\"\n\n def __init__(self, broker_url):\n \"\"\"\n Initialize object\n\n :param publisher_def: provider definition\n\n :returns: pycsw.pubsub.http.HTTPPubSubClient\n \"\"\"\n\n super().__init__(broker_url)\n self.type = 'http'\n self.auth = None\n\n msg = f'Initializing to broker {self.broker_safe_url} with id {self.client_id}' # noqa\n LOGGER.debug(msg)\n\n if None not in [self.broker_url.username, self.broker_url.password]:\n LOGGER.debug('Setting credentials')\n self.auth = (\n self.broker_url.username,\n self.broker_url.password\n )\n\n def connect(self) -> None:\n \"\"\"\n Connect to an HTTP broker\n\n :returns: None\n \"\"\"\n\n LOGGER.debug('Passing; connection to HTTP is lazy')\n\n def pub(self, channel: str, message: str, qos: int = 1) -> bool:\n \"\"\"\n Publish a message to a broker/channel\n\n :param channel: `str` of topic\n :param message: `str` of message\n\n :returns: `bool` of publish result\n \"\"\"\n\n LOGGER.debug(f'Publishing to broker {self.broker_safe_url}')\n LOGGER.debug(f'Channel: {channel}')\n LOGGER.debug(f'Message: {message}')\n LOGGER.debug(f'Sanitizing channel for HTTP')\n channel = channel.replace('/', '-')\n channel = channel.replace(':', '-')\n LOGGER.debug(f'Sanitized channel: {channel}')\n\n url = f'{self.broker}/{channel}'\n\n try:\n response = requests.post(url, auth=self.auth, json=message)\n response.raise_for_status()\n except Exception as err:\n LOGGER.debug(f'Message publishing failed: {err}')\n\n def __repr__(self):\n return f' {self.broker_safe_url}'\n"
},
{
"path": "pycsw/broker/mqtt.py",
"content": "# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2025 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport logging\n\nfrom paho.mqtt import client as mqtt_client\n\nfrom pycsw.broker.base import BasePubSubClient\n\nLOGGER = logging.getLogger(__name__)\n\n\nclass MQTTPubSubClient(BasePubSubClient):\n \"\"\"MQTT client\"\"\"\n\n def __init__(self, broker_url):\n \"\"\"\n Initialize object\n\n :param publisher_def: provider definition\n\n :returns: pycsw.pubsub.mqtt.MQTTPubSubClient\n \"\"\"\n\n super().__init__(broker_url)\n self.type = 'mqtt'\n self.port = self.broker_url.port\n\n self.userdata = {}\n\n msg = f'Connecting to broker {self.broker_safe_url} with id {self.client_id}' # noqa\n LOGGER.debug(msg)\n self.conn = mqtt_client.Client(mqtt_client.CallbackAPIVersion.VERSION2,\n client_id=self.client_id)\n\n self.conn.enable_logger(logger=LOGGER)\n\n if None not in [self.broker_url.username, self.broker_url.password]:\n LOGGER.debug('Setting credentials')\n self.conn.username_pw_set(\n self.broker_url.username,\n self.broker_url.password)\n\n if self.port is None:\n if self.broker_url.scheme == 'mqtts':\n self.port = 8883\n else:\n self.port = 1883\n\n if self.broker_url.scheme == 'mqtts':\n self.conn.tls_set(tls_version=2)\n\n def connect(self) -> None:\n \"\"\"\n Connect to an MQTT broker\n\n :returns: None\n \"\"\"\n\n self.conn.connect(self.broker_url.hostname, self.port)\n LOGGER.debug('Connected to broker')\n\n def pub(self, channel: str, message: str, qos: int = 1) -> bool:\n \"\"\"\n Publish a message to a broker/channel\n\n :param channel: `str` of channel\n :param message: `str` of message\n\n :returns: `bool` of publish result\n \"\"\"\n\n LOGGER.debug(f'Publishing to broker {self.broker_safe_url}')\n LOGGER.debug(f'Channel: {channel}')\n LOGGER.debug(f'Message: {message}')\n\n result = self.conn.publish(channel, message, qos)\n LOGGER.debug(f'Result: {result}')\n\n # TODO: investigate implication\n # result.wait_for_publish()\n\n if result.is_published:\n LOGGER.debug('Message published')\n return True\n else:\n msg = f'Publishing error code: {result[1]}'\n LOGGER.warning(msg)\n return False\n\n def __repr__(self):\n return f' {self.broker_safe_url}'\n"
},
{
"path": "pycsw/core/__init__.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2015 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n"
},
{
"path": "pycsw/core/admin.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n# Angelos Tzotsos \n#\n# Copyright (c) 2026 Tom Kralidis\n# Copyright (c) 2015 Angelos Tzotsos\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport json\nimport logging\nimport os\nimport sys\nfrom glob import glob\n\nimport click\n\nfrom pycsw import __version__\nfrom pycsw.core import config as pconfig\nfrom pycsw.core import metadata, repository, util\nfrom pycsw.core.etree import etree\nfrom pycsw.core.etree import PARSER\nfrom pycsw.core.util import parse_ini_config, str2bool\nfrom pycsw.ogc.api.util import get_typed_value, yaml_dump, yaml_load\n\nLOGGER = logging.getLogger(__name__)\n\n\ndef load_records(context, database, table, xml_dirpath, recursive=False, force_update=False):\n \"\"\"Load metadata records from directory of files to database\"\"\"\n\n repo = repository.Repository(database, context, table=table)\n\n file_list = []\n\n loaded_files = set()\n if os.path.isfile(xml_dirpath):\n file_list.append(xml_dirpath)\n elif recursive:\n for root, dirs, files in os.walk(xml_dirpath):\n for mfile in files:\n if mfile.endswith('.xml'):\n file_list.append(os.path.join(root, mfile))\n else:\n files = glob(os.path.join(xml_dirpath, '*.xml')) + glob(os.path.join(xml_dirpath, '*.json'))\n for rec in files:\n file_list.append(rec)\n\n total = len(file_list)\n counter = 0\n\n for recfile in sorted(file_list):\n counter += 1\n metadata_record = None\n LOGGER.info('Processing file %s (%d of %d)', recfile, counter, total)\n # read document\n try:\n with open(recfile) as fh:\n metadata_record = json.load(fh)\n except json.decoder.JSONDecodeError:\n metadata_record = etree.parse(recfile, context.parser)\n except etree.XMLSyntaxError:\n LOGGER.error('XML document \"%s\" is not well-formed', recfile, exc_info=True)\n continue\n except Exception:\n LOGGER.exception('XML document \"%s\" is not well-formed', recfile)\n continue\n\n try:\n record = metadata.parse_record(context, metadata_record, repo)\n except Exception:\n LOGGER.exception('Could not parse \"%s\" as an XML record', recfile)\n continue\n\n for rec in record:\n LOGGER.info('Inserting %s %s into database %s, table %s ....',\n rec.typename, rec.identifier, database, table)\n\n # TODO: do this as CSW Harvest\n try:\n repo.insert(rec, 'local', util.get_today_and_now())\n loaded_files.add(recfile)\n LOGGER.info('Inserted %s', recfile)\n except Exception as err:\n if force_update:\n LOGGER.info('Record exists. Updating.')\n repo.update(rec)\n LOGGER.info('Updated %s', recfile)\n loaded_files.add(recfile)\n else:\n if err.args: # Pull a decent error message\n LOGGER.error('ERROR: %s not inserted: %s', recfile, err.args[0], exc_info=True)\n else:\n LOGGER.error('ERROR: %s not inserted: %s', recfile, err, exc_info=True)\n\n return tuple(loaded_files)\n\n\ndef export_records(context, database, table, xml_dirpath):\n \"\"\"Export metadata records from database to directory of files\"\"\"\n repo = repository.Repository(database, context, table=table)\n\n LOGGER.info('Querying database %s, table %s ....', database, table)\n records = repo.session.query(repo.dataset)\n\n LOGGER.info('Found %d records\\n', records.count())\n\n LOGGER.info('Exporting records\\n')\n\n dirpath = os.path.abspath(xml_dirpath)\n\n exported_files = set()\n\n if not os.path.exists(dirpath):\n LOGGER.info('Directory %s does not exist. Creating...', dirpath)\n try:\n os.makedirs(dirpath)\n except OSError as err:\n LOGGER.exception('Could not create directory')\n raise RuntimeError('Could not create %s %s' % (dirpath, err)) from err\n\n for record in records.all():\n identifier = \\\n getattr(record,\n context.md_core_model['mappings']['pycsw:Identifier'])\n\n LOGGER.info('Processing %s', identifier)\n\n # sanitize identifier\n identifier = util.secure_filename(identifier)\n # write to XML document\n\n metadata_type = \\\n getattr(record,\n context.md_core_model['mappings']['pycsw:MetadataType'])\n\n if 'json' in metadata_type:\n extension = 'json'\n else:\n extension = 'xml'\n\n filename = os.path.join(dirpath, '%s.%s' % (identifier, extension))\n\n try:\n LOGGER.info('Writing to file %s', filename)\n if hasattr(record.xml, 'decode'):\n str_xml = record.xml.decode('utf-8')\n else:\n str_xml = record.xml\n with open(filename, 'w') as xml:\n xml.write('\\n')\n xml.write(str_xml)\n except Exception:\n # Something went wrong so skip over this file but log an error\n LOGGER.exception('Error writing %s to disk', filename)\n # If we wrote a partial file or created an empty file make sure it is removed\n if os.path.exists(filename):\n os.remove(filename)\n continue\n else:\n exported_files.add(filename)\n\n return tuple(exported_files)\n\n\ndef refresh_harvested_records(context, database, table, url):\n \"\"\"refresh / harvest all non-local records in repository\"\"\"\n from owslib.csw import CatalogueServiceWeb\n\n # get configuration and init repo connection\n repos = repository.Repository(database, context, table=table)\n\n # get all harvested records\n count, records = repos.query(constraint={'where': \"mdsource != 'local'\", 'values': []})\n\n if int(count) > 0:\n LOGGER.info('Refreshing %s harvested records', count)\n csw = CatalogueServiceWeb(url)\n\n for rec in records:\n source = \\\n getattr(rec,\n context.md_core_model['mappings']['pycsw:Source'])\n schema = \\\n getattr(rec,\n context.md_core_model['mappings']['pycsw:Schema'])\n identifier = \\\n getattr(rec,\n context.md_core_model['mappings']['pycsw:Identifier'])\n\n LOGGER.info('Harvesting %s (identifier = %s) ...',\n source, identifier)\n # TODO: find a smarter way of catching this\n if schema == 'http://www.isotc211.org/2005/gmd':\n schema = 'http://www.isotc211.org/schemas/2005/gmd/'\n try:\n csw.harvest(source, schema)\n LOGGER.info(csw.response)\n except Exception:\n LOGGER.exception('Could not harvest')\n else:\n LOGGER.info('No harvested records')\n\n\ndef gen_sitemap(context, database, table, url, output_file):\n \"\"\"generate an XML sitemap from all records in repository\"\"\"\n\n # get configuration and init repo connection\n repos = repository.Repository(database, context, table=table)\n\n # write out sitemap document\n urlset = etree.Element(util.nspath_eval('sitemap:urlset',\n context.namespaces),\n nsmap=context.namespaces)\n\n schema_loc = util.nspath_eval('xsi:schemaLocation', context.namespaces)\n\n urlset.attrib[schema_loc] = \\\n '%s http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd' % \\\n context.namespaces['sitemap']\n\n # get all records\n count, records = repos.query(constraint={}, maxrecords=99999999)\n\n LOGGER.info('Found %s records', count)\n\n for rec in records:\n url_ = etree.SubElement(urlset,\n util.nspath_eval('sitemap:url',\n context.namespaces))\n uri = '%s?service=CSW&version=2.0.2&request=GetRepositoryItem&id=%s' % \\\n (url,\n getattr(rec,\n context.md_core_model['mappings']['pycsw:Identifier']))\n etree.SubElement(url_,\n util.nspath_eval('sitemap:loc',\n context.namespaces)).text = uri\n\n # write to file\n LOGGER.info('Writing to %s', output_file)\n with open(output_file, 'wb') as ofile:\n ofile.write(etree.tostring(urlset, pretty_print=1,\n encoding='utf8', xml_declaration=1))\n\n\ndef post_xml(url, xml, timeout=30):\n \"\"\"Execute HTTP XML POST request and print response\"\"\"\n\n LOGGER.info('Executing HTTP POST request %s on server %s', xml, url)\n\n from owslib.util import http_post\n try:\n with open(xml) as f:\n return http_post(url=url, request=f.read(), timeout=timeout)\n except Exception as err:\n LOGGER.exception('HTTP XML POST error')\n raise RuntimeError(err) from err\n\n\ndef get_sysprof():\n \"\"\"Get versions of dependencies\"\"\"\n\n none = 'Module not found'\n\n try:\n import sqlalchemy\n vsqlalchemy = sqlalchemy.__version__\n except ImportError:\n vsqlalchemy = none\n\n try:\n import pyproj\n vpyproj = pyproj.__version__\n except ImportError:\n vpyproj = none\n\n try:\n import shapely\n try:\n vshapely = shapely.__version__\n except AttributeError:\n import shapely.geos\n vshapely = shapely.geos.geos_capi_version\n except ImportError:\n vshapely = none\n\n try:\n import owslib\n try:\n vowslib = owslib.__version__\n except AttributeError:\n vowslib = 'Module found, version not specified'\n except ImportError:\n vowslib = none\n\n return '''pycsw system profile\n --------------------\n Python version: %s\n os: %s\n SQLAlchemy: %s\n Shapely: %s\n lxml: %s\n libxml2: %s\n pyproj: %s\n OWSLib: %s''' % (sys.version_info, sys.platform, vsqlalchemy,\n vshapely, etree.__version__, etree.LIBXML_VERSION,\n vpyproj, vowslib)\n\n\ndef validate_xml(xml, xsd):\n \"\"\"Validate XML document against XML Schema\"\"\"\n\n LOGGER.info('Validating %s against schema %s', xml, xsd)\n\n schema = etree.XMLSchema(file=xsd)\n\n try:\n tree = etree.parse(xml, PARSER)\n schema.assertValid(tree)\n return 'Valid'\n except Exception as err:\n LOGGER.exception('Invalid XML')\n raise RuntimeError('ERROR: %s' % str(err)) from err\n\n\ndef delete_records(context, database, table):\n \"\"\"Deletes all records from repository\"\"\"\n\n LOGGER.info('Deleting all records')\n\n repo = repository.Repository(database, context, table=table)\n repo.delete(constraint={'where': '', 'values': []})\n\n\ndef cli_option_verbosity(f):\n def callback(ctx, param, value):\n if value is not None:\n logging.basicConfig(stream=sys.stdout,\n level=getattr(logging, value))\n return True\n\n return click.option('--verbosity', '-v',\n type=click.Choice(['ERROR', 'WARNING', 'INFO', 'DEBUG']),\n help='Verbosity',\n callback=callback)(f)\n\n\nCLI_OPTION_CONFIG = click.option('--config', '-c', required=True,\n type=click.Path(exists=True, resolve_path=True),\n help='Path to pycsw configuration')\n\nCLI_OPTION_YES = click.option('--yes', '-y', is_flag=True, default=False,\n help='Bypass confirmation')\n\nCLI_OPTION_YES_PROMPT = click.option('--yes', '-y', is_flag=True,\n default=False,\n prompt='This will delete all records! Continue?',\n help='Bypass confirmation')\n\n\ndef cli_callbacks(f):\n f = cli_option_verbosity(f)\n return f\n\n\n@click.group()\n@click.version_option(version=__version__)\ndef cli():\n pass\n\n\n@click.command('setup-repository')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\ndef cli_setup_repository(ctx, config, verbosity):\n \"\"\"Create repository tables and indexes\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n try:\n repository.setup(cfg['repository']['database'], table=cfg['repository'].get('table'))\n except Exception as err:\n msg = f'ERROR: Repository already exists: {err}'\n raise click.ClickException(msg) from err\n\n\n@click.command('load-records')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\n@click.option('--path', '-p', 'path', required=True,\n help='File or directory path to metadata records',\n type=click.Path(exists=True, resolve_path=True, file_okay=True))\n@click.option('--recursive', '-r', is_flag=True,\n default=False, help='Recurse subdirectories')\n@CLI_OPTION_YES\ndef cli_load_records(ctx, config, path, recursive, yes, verbosity):\n \"\"\"Load metadata records from directory or file into repository\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n context = pconfig.StaticContext()\n\n load_records(\n context,\n cfg['repository']['database'],\n cfg['repository']['table'],\n path,\n recursive,\n yes\n )\n\n\n@click.command('delete-records')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\n@CLI_OPTION_YES_PROMPT\ndef cli_delete_records(ctx, config, yes, verbosity):\n \"\"\"Delete all records from repository\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n context = pconfig.StaticContext()\n\n delete_records(\n context,\n cfg['repository']['database'],\n cfg['repository']['table']\n )\n\n\n@click.command('export-records')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\n@click.option('--path', '-p', 'path', required=True,\n help='Directory path to metadata records',\n type=click.Path(exists=True, resolve_path=True,\n writable=True, file_okay=False))\ndef cli_export_records(ctx, config, path, verbosity):\n \"\"\"Dump metadata records from repository into directory\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n context = pconfig.StaticContext()\n\n export_records(\n context,\n cfg['repository']['database'],\n cfg['repository']['table'],\n path\n )\n\n\n@click.command('rebuild-db-indexes')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\ndef cli_rebuild_db_indexes(ctx, config, verbosity):\n \"\"\"Rebuild repository database indexes\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n context = pconfig.StaticContext()\n\n repo = repository.Repository(cfg['repository']['database'], context, table=cfg['repository'].get('table'))\n repo.rebuild_db_indexes()\n\n\n@click.command('optimize-db')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\ndef cli_optimize_db(ctx, config, verbosity):\n \"\"\"Optimize repository database\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n context = pconfig.StaticContext()\n\n repo = repository.Repository(cfg['repository']['database'], context, table=cfg['repository'].get('table'))\n repo.optimize_db()\n\n\n@click.command('refresh-harvested-records')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\n@click.option('--url', '-u', 'url', help='URL of harvest endpoint')\ndef cli_refresh_harvested_records(ctx, config, verbosity, url):\n \"\"\"Refresh / harvest non-local records in repository\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n context = pconfig.StaticContext()\n\n refresh_harvested_records(\n context,\n cfg['repository']['database'],\n cfg['repository']['table'],\n url\n )\n\n\n@click.command('gen-sitemap')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\n@click.option('--output', '-o', 'output', required=True,\n help='Filepath to write sitemap',\n type=click.Path(resolve_path=True, writable=True,\n dir_okay=False))\ndef cli_gen_sitemap(ctx, config, output, verbosity):\n \"\"\"Generate XML Sitemap\"\"\"\n\n with open(config, encoding='utf8') as fh:\n cfg = yaml_load(fh)\n\n context = pconfig.StaticContext()\n\n gen_sitemap(\n context,\n cfg['repository']['database'],\n cfg['repository']['table'],\n cfg['server']['url'],\n output\n )\n\n\n@click.command('post-xml')\n@cli_callbacks\n@click.pass_context\n@click.option('--url', '-u', 'url', required=True, help='URL of CSW endpoint')\n@click.option('--xml', '-x', 'xml', required=True,\n help='XML file to POST',\n type=click.Path(resolve_path=True, exists=True,\n dir_okay=False))\n@click.option('--timeout', '-t', 'timeout', default=30,\n help='Timeout (in seconds) for HTTP requests')\ndef cli_post_xml(ctx, url, xml, timeout, verbosity):\n \"\"\"Execute a CSW request via HTTP POST\"\"\"\n\n click.echo(post_xml(url, xml, timeout))\n\n\n@click.command('validate-xml')\n@cli_callbacks\n@click.pass_context\n@click.option('--xml', '-x', 'xml', required=True,\n help='XML document',\n type=click.Path(resolve_path=True, exists=True,\n dir_okay=False))\n@click.option('--xsd', '-s', 'xsd', required=True,\n help='XML Schema document',\n type=click.Path(resolve_path=True, exists=True,\n dir_okay=False))\ndef cli_validate_xml(ctx, xml, xsd, verbosity):\n \"\"\"Validate an XML document against an XML Schema\"\"\"\n\n validate_xml(xml, xsd)\n\n\n@click.command('get-sysprof')\n@click.pass_context\ndef cli_get_sysprof(ctx):\n \"\"\"Get versions of dependencies\"\"\"\n\n click.echo(get_sysprof())\n\n\n@click.command('migrate-config')\n@cli_callbacks\n@click.pass_context\n@CLI_OPTION_CONFIG\ndef cli_migrate_config(ctx, config, verbosity):\n \"\"\"Migrate pycsw ini config to YAML\"\"\"\n\n dict_ = {\n 'server': {},\n 'logging': {},\n 'manager': {},\n 'metadata': {\n 'identification': {},\n 'provider': {},\n 'contact': {},\n 'inspire': {}\n },\n 'profiles': [],\n 'federatedcatalogues': [],\n 'repository': {}\n }\n\n cfg = parse_ini_config(config)\n\n for name, value in cfg.items('server'):\n if name == 'loglevel':\n dict_['logging']['level'] = value\n elif name == 'logfile':\n dict_['logging']['logfile'] = value\n elif name == 'profiles':\n dict_[name] = value.split(',')\n elif name == 'federatedcatalogues':\n dict_[name] = []\n for count, fc in enumerate(value.split(',')):\n dict_[name].append({'id': f'fedcat{count}', 'url': fc})\n else:\n dict_['server'][name] = get_typed_value(value)\n\n for name, value in cfg.items('metadata:main'):\n if name.startswith('identification'):\n new_key = name.replace('identification_', '')\n if new_key == 'keywords':\n dict_['metadata']['identification'][new_key] = value.split(',')\n elif new_key == 'abstract':\n dict_['metadata']['identification']['description'] = value\n else:\n dict_['metadata']['identification'][new_key] = get_typed_value(value)\n\n if name.startswith('provider'):\n new_key = name.replace('provider_', '')\n dict_['metadata']['provider'][new_key] = get_typed_value(value)\n\n if name.startswith('contact'):\n new_key = name.replace('contact_', '')\n dict_['metadata']['contact'][new_key] = get_typed_value(value)\n\n for name, value in cfg.items('manager'):\n if name == 'allowed_ips':\n dict_['manager'][name] = value.split(',')\n elif name == 'transactions':\n dict_['manager'][name] = str2bool(value)\n else:\n dict_['manager'][name] = get_typed_value(value)\n\n for name, value in cfg.items('repository'):\n if name == 'facets':\n dict_['repository'][name] = value.split(',')\n else:\n dict_['repository'][name] = get_typed_value(value)\n\n for name, value in cfg.items('metadata:inspire'):\n if name == 'languages_supported':\n dict_['metadata']['inspire'][name] = value.split(',')\n elif name == 'enabled':\n dict_['metadata']['inspire'][name] = str2bool(value)\n elif name == 'gemet_keywords':\n dict_['metadata']['inspire'][name] = value.split(',')\n elif name == 'temp_extent':\n begin, end = value.split('/')\n dict_['metadata']['inspire'][name] = {\n 'begin': begin,\n 'end': end\n }\n else:\n dict_['metadata']['inspire'][name] = get_typed_value(value)\n\n yaml_file = config.replace('.cfg', '.yml')\n click.echo(f'Writing to {yaml_file}')\n yaml_dump(dict_, yaml_file)\n\n\ncli.add_command(cli_setup_repository)\ncli.add_command(cli_load_records)\ncli.add_command(cli_export_records)\ncli.add_command(cli_delete_records)\ncli.add_command(cli_rebuild_db_indexes)\ncli.add_command(cli_optimize_db)\ncli.add_command(cli_refresh_harvested_records)\ncli.add_command(cli_gen_sitemap)\ncli.add_command(cli_post_xml)\ncli.add_command(cli_validate_xml)\ncli.add_command(cli_get_sysprof)\ncli.add_command(cli_migrate_config)\n"
},
{
"path": "pycsw/core/config.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2016 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport logging\nfrom pycsw.core.etree import PARSER\nfrom pycsw import __version__\n\nLOGGER = logging.getLogger(__name__)\n\n\nclass StaticContext(object):\n \"\"\"core configuration\"\"\"\n def __init__(self, prefix='csw30'):\n \"\"\"initializer\"\"\"\n\n LOGGER.debug('Initializing static context')\n self.version = __version__\n\n self.ogc_schemas_base = 'http://schemas.opengis.net'\n\n self.parser = PARSER\n self.server = None\n\n self.languages = {\n 'en': 'english',\n 'fr': 'french',\n 'el': 'greek',\n }\n\n self.response_codes = {\n 'OK': '200 OK',\n 'NotFound': '404 Not Found',\n 'InvalidValue': '400 Invalid property value',\n 'OperationParsingFailed': '400 Bad Request',\n 'OperationProcessingFailed': '403 Server Processing Failed',\n 'OperationNotSupported': '400 Not Implemented',\n 'MissingParameterValue': '400 Bad Request',\n 'InvalidParameterValue': '400 Bad Request',\n 'VersionNegotiationFailed': '400 Bad Request',\n 'InvalidUpdateSequence': '400 Bad Request',\n 'OptionNotSupported': '400 Not Implemented',\n 'NoApplicableCode': '400 Internal Server Error'\n }\n\n self.namespaces = {\n 'atom': 'http://www.w3.org/2005/Atom',\n 'csw': 'http://www.opengis.net/cat/csw/2.0.2',\n 'csw30': 'http://www.opengis.net/cat/csw/3.0',\n 'dc': 'http://purl.org/dc/elements/1.1/',\n 'dct': 'http://purl.org/dc/terms/',\n 'dif': 'http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/',\n 'fes20': 'http://www.opengis.net/fes/2.0',\n 'fgdc': 'http://www.opengis.net/cat/csw/csdgm',\n 'gm03': 'http://www.interlis.ch/INTERLIS2.3',\n 'gmd': 'http://www.isotc211.org/2005/gmd',\n 'gml': 'http://www.opengis.net/gml',\n 'gml32': 'http://www.opengis.net/gml/3.2',\n 'mdb': 'http://standards.iso.org/iso/19115/-3/mdb/2.0',\n 'ogc': 'http://www.opengis.net/ogc',\n 'os': 'http://a9.com/-/spec/opensearch/1.1/',\n 'ows': 'http://www.opengis.net/ows',\n 'ows11': 'http://www.opengis.net/ows/1.1',\n 'ows20': 'http://www.opengis.net/ows/2.0',\n 'rdf': 'http://www.w3.org/1999/02/22-rdf-syntax-ns#',\n 'sitemap': 'http://www.sitemaps.org/schemas/sitemap/0.9',\n 'soapenv': 'http://www.w3.org/2003/05/soap-envelope',\n 'xlink': 'http://www.w3.org/1999/xlink',\n 'xs': 'http://www.w3.org/2001/XMLSchema',\n 'xsi': 'http://www.w3.org/2001/XMLSchema-instance'\n }\n\n self.keep_ns_prefixes = [\n 'csw', 'dc', 'dct', 'gmd', 'gml', 'gml32', 'ows', 'xs'\n ]\n\n self.md_core_model = {\n 'typename': 'pycsw:CoreMetadata',\n 'outputschema': 'http://pycsw.org/metadata',\n 'mappings': {\n 'pycsw:Identifier': 'identifier',\n # CSW typename (e.g. csw:Record, md:MD_Metadata)\n 'pycsw:Typename': 'typename',\n # schema namespace, i.e. http://www.isotc211.org/2005/gmd\n 'pycsw:Schema': 'schema',\n # origin of resource, either 'local', or URL to web service\n 'pycsw:MdSource': 'mdsource',\n # date of insertion\n 'pycsw:InsertDate': 'insert_date', # date of insertion\n # raw XML metadata\n 'pycsw:XML': 'xml',\n # raw metadata payload, xml to be migrated to this in the future\n 'pycsw:Metadata': 'metadata',\n # raw metadata payload type, xml as default for now\n 'pycsw:MetadataType': 'metadata_type',\n # bag of metadata element and attributes ONLY, no XML tags\n 'pycsw:AnyText': 'anytext',\n 'pycsw:Language': 'language',\n 'pycsw:Title': 'title',\n 'pycsw:Abstract': 'abstract',\n 'pycsw:Edition': 'edition',\n 'pycsw:Keywords': 'keywords',\n 'pycsw:KeywordType': 'keywordstype',\n 'pycsw:Themes': 'themes',\n 'pycsw:Format': 'format',\n 'pycsw:Source': 'source',\n 'pycsw:Date': 'date',\n 'pycsw:Modified': 'date_modified',\n 'pycsw:Type': 'type',\n # geometry, specified in OGC WKT\n 'pycsw:BoundingBox': 'wkt_geometry',\n 'pycsw:VertExtentMin': 'vert_extent_min',\n 'pycsw:VertExtentMax': 'vert_extent_max',\n 'pycsw:CRS': 'crs',\n 'pycsw:AlternateTitle': 'title_alternate',\n 'pycsw:RevisionDate': 'date_revision',\n 'pycsw:CreationDate': 'date_creation',\n 'pycsw:PublicationDate': 'date_publication',\n 'pycsw:OrganizationName': 'organization',\n 'pycsw:SecurityConstraints': 'securityconstraints',\n 'pycsw:ParentIdentifier': 'parentidentifier',\n 'pycsw:TopicCategory': 'topicategory',\n 'pycsw:ResourceLanguage': 'resourcelanguage',\n 'pycsw:GeographicDescriptionCode': 'geodescode',\n 'pycsw:Denominator': 'denominator',\n 'pycsw:DistanceValue': 'distancevalue',\n 'pycsw:DistanceUOM': 'distanceuom',\n 'pycsw:TempExtent_begin': 'time_begin',\n 'pycsw:TempExtent_end': 'time_end',\n 'pycsw:ServiceType': 'servicetype',\n 'pycsw:ServiceTypeVersion': 'servicetypeversion',\n 'pycsw:Operation': 'operation',\n 'pycsw:CouplingType': 'couplingtype',\n 'pycsw:OperatesOn': 'operateson',\n 'pycsw:OperatesOnIdentifier': 'operatesonidentifier',\n 'pycsw:OperatesOnName': 'operatesoname',\n 'pycsw:Degree': 'degree',\n 'pycsw:AccessConstraints': 'accessconstraints',\n 'pycsw:OtherConstraints': 'otherconstraints',\n 'pycsw:Classification': 'classification',\n 'pycsw:ConditionApplyingToAccessAndUse': 'conditionapplyingtoaccessanduse',\n 'pycsw:Lineage': 'lineage',\n 'pycsw:ResponsiblePartyRole': 'responsiblepartyrole',\n 'pycsw:SpecificationTitle': 'specificationtitle',\n 'pycsw:SpecificationDate': 'specificationdate',\n 'pycsw:SpecificationDateType': 'specificationdatetype',\n 'pycsw:Creator': 'creator',\n 'pycsw:Publisher': 'publisher',\n 'pycsw:Contributor': 'contributor',\n 'pycsw:Relation': 'relation',\n 'pycsw:Platform': 'platform',\n 'pycsw:Instrument': 'instrument',\n 'pycsw:SensorType': 'sensortype',\n 'pycsw:CloudCover': 'cloudcover',\n 'pycsw:Bands': 'bands',\n 'pycsw:IlluminationElevationAngle': 'illuminationelevationangle',\n # links: list of dicts with properties: name, description, protocol, url\n 'pycsw:Links': 'links',\n # contacts: list of dicts with properties: name, organization, address, postcode, city, region, country, email, phone, fax, onlineresource, position, role\n 'pycsw:Contacts': 'contacts',\n }\n }\n\n self.model = None\n\n self.models = {\n 'csw': {\n 'operations_order': [\n 'GetCapabilities', 'DescribeRecord', 'GetDomain',\n 'GetRecords', 'GetRecordById', 'GetRepositoryItem'\n ],\n 'operations': {\n 'GetCapabilities': {\n 'methods': {\n 'get': True,\n 'post': True,\n },\n 'parameters': {\n 'sections': {\n 'values': ['ServiceIdentification', 'ServiceProvider',\n 'OperationsMetadata', 'Filter_Capabilities']\n }\n }\n },\n 'DescribeRecord': {\n 'methods': {\n 'get': True,\n 'post': True,\n },\n 'parameters': {\n 'schemaLanguage': {\n 'values': ['http://www.w3.org/XML/Schema',\n 'http://www.w3.org/TR/xmlschema-1/',\n 'http://www.w3.org/2001/XMLSchema']\n },\n 'typeName': {\n 'values': ['csw:Record']\n },\n 'outputFormat': {\n 'values': ['application/xml', 'application/json']\n }\n }\n },\n 'GetRecords': {\n 'methods': {\n 'get': True,\n 'post': True,\n },\n 'parameters': {\n 'resultType': {\n 'values': ['hits', 'results', 'validate']\n },\n 'typeNames': {\n 'values': ['csw:Record']\n },\n 'outputSchema': {\n 'values': ['http://www.opengis.net/cat/csw/2.0.2']\n },\n 'outputFormat': {\n 'values': ['application/xml', 'application/json']\n },\n 'CONSTRAINTLANGUAGE': {\n 'values': ['FILTER', 'CQL_TEXT']\n },\n 'ElementSetName': {\n 'values': ['brief', 'summary', 'full']\n }\n },\n 'constraints': {\n }\n },\n 'GetRecordById': {\n 'methods': {\n 'get': True,\n 'post': True,\n },\n 'parameters': {\n 'outputSchema': {\n 'values': ['http://www.opengis.net/cat/csw/2.0.2']\n },\n 'outputFormat': {\n 'values': ['application/xml', 'application/json']\n },\n 'ElementSetName': {\n 'values': ['brief', 'summary', 'full']\n }\n }\n },\n 'GetRepositoryItem': {\n 'methods': {\n 'get': True,\n 'post': False,\n },\n 'parameters': {\n }\n }\n },\n 'parameters': {\n 'version': {\n 'values': ['2.0.2', '3.0.0']\n },\n 'service': {\n 'values': ['CSW']\n }\n },\n 'constraints': {\n 'MaxRecordDefault': {\n 'values': ['10']\n },\n 'PostEncoding': {\n 'values': ['XML', 'SOAP']\n },\n 'XPathQueryables': {\n 'values': ['allowed']\n }\n },\n 'typenames': {\n 'csw:Record': {\n 'outputschema': 'http://www.opengis.net/cat/csw/2.0.2',\n 'queryables': {\n 'SupportedDublinCoreQueryables': {\n # map Dublin Core queryables to core metadata model\n 'dc:title':\n {'dbcol': self.md_core_model['mappings']['pycsw:Title']},\n 'dct:alternative':\n {'dbcol': self.md_core_model['mappings']['pycsw:AlternateTitle']},\n 'dc:creator':\n {'dbcol': self.md_core_model['mappings']['pycsw:Creator']},\n 'dc:subject':\n {'dbcol': self.md_core_model['mappings']['pycsw:Keywords']},\n 'dct:abstract':\n {'dbcol': self.md_core_model['mappings']['pycsw:Abstract']},\n 'dc:publisher':\n {'dbcol': self.md_core_model['mappings']['pycsw:Publisher']},\n 'dc:contributor':\n {'dbcol': self.md_core_model['mappings']['pycsw:Contributor']},\n 'dct:modified':\n {'dbcol': self.md_core_model['mappings']['pycsw:Modified']},\n 'dc:date':\n {'dbcol': self.md_core_model['mappings']['pycsw:Date']},\n 'dc:type':\n {'dbcol': self.md_core_model['mappings']['pycsw:Type']},\n 'dc:format':\n {'dbcol': self.md_core_model['mappings']['pycsw:Format']},\n 'dc:identifier':\n {'dbcol': self.md_core_model['mappings']['pycsw:Identifier']},\n 'dc:source':\n {'dbcol': self.md_core_model['mappings']['pycsw:Source']},\n 'dc:language':\n {'dbcol': self.md_core_model['mappings']['pycsw:Language']},\n 'dc:relation':\n {'dbcol': self.md_core_model['mappings']['pycsw:Relation']},\n 'dc:rights':\n {'dbcol':\n self.md_core_model['mappings']['pycsw:AccessConstraints']},\n 'dct:spatial':\n {'dbcol': self.md_core_model['mappings']['pycsw:CRS']},\n # bbox and full text map to internal fixed columns\n 'ows:BoundingBox':\n {'dbcol': self.md_core_model['mappings']['pycsw:BoundingBox']},\n 'csw:AnyText':\n {'dbcol': self.md_core_model['mappings']['pycsw:AnyText']},\n }\n }\n }\n }\n },\n 'csw30': {\n 'operations_order': [\n 'GetCapabilities', 'GetDomain', 'GetRecords',\n 'GetRecordById', 'GetRepositoryItem'\n ],\n 'operations': {\n 'GetCapabilities': {\n 'methods': {\n 'get': True,\n 'post': True,\n },\n 'parameters': {\n 'acceptVersions': {\n 'values': ['2.0.2', '3.0.0']\n },\n 'acceptFormats': {\n 'values': ['text/xml', 'application/xml']\n },\n 'sections': {\n 'values': ['ServiceIdentification', 'ServiceProvider',\n 'OperationsMetadata', 'Filter_Capabilities', 'All']\n }\n }\n },\n 'GetRecords': {\n 'methods': {\n 'get': True,\n 'post': True,\n },\n 'parameters': {\n 'typeNames': {\n 'values': ['csw:Record', 'csw30:Record']\n },\n 'outputSchema': {\n 'values': ['http://www.opengis.net/cat/csw/3.0']\n },\n 'outputFormat': {\n 'values': ['application/xml', 'application/json', 'application/atom+xml']\n },\n 'CONSTRAINTLANGUAGE': {\n 'values': ['FILTER', 'CQL_TEXT']\n },\n 'ElementSetName': {\n 'values': ['brief', 'summary', 'full']\n }\n },\n 'constraints': {\n }\n },\n 'GetRecordById': {\n 'methods': {\n 'get': True,\n 'post': True,\n },\n 'parameters': {\n 'outputSchema': {\n 'values': ['http://www.opengis.net/cat/csw/3.0']\n },\n 'outputFormat': {\n 'values': ['application/xml', 'application/json', 'application/atom+xml']\n },\n 'ElementSetName': {\n 'values': ['brief', 'summary', 'full']\n }\n }\n },\n 'GetRepositoryItem': {\n 'methods': {\n 'get': True,\n 'post': False,\n },\n 'parameters': {\n }\n }\n },\n 'parameters': {\n 'version': {\n 'values': ['2.0.2', '3.0.0']\n },\n 'service': {\n 'values': ['CSW']\n }\n },\n 'constraints': {\n 'MaxRecordDefault': {\n 'values': ['10']\n },\n 'PostEncoding': {\n 'values': ['XML', 'SOAP']\n },\n 'XPathQueryables': {\n 'values': ['allowed']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/OpenSearch': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetCapabilities-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetRecordById-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetRecords-Basic-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetRecords-Distributed-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetRecords-Distributed-KVP': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetRecords-Async-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetRecords-Async-KVP': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetDomain-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/GetDomain-KVP': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Transaction': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Harvest-Basic-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Harvest-Basic-KVP': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Harvest-Async-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Harvest-Async-KVP': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Harvest-Periodic-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Harvest-Periodic-KVP': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Filter-CQL': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Filter-FES-XML': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/Filter-FES-KVP-Advanced': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/SupportedGMLVersions': {\n 'values': ['http://www.opengis.net/gml/3.2']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/DefaultSortingAlgorithm': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/CoreQueryables': {\n 'values': ['TRUE']\n },\n 'http://www.opengis.net/spec/csw/3.0/conf/CoreSortables': {\n 'values': ['TRUE']\n }\n },\n 'typenames': {\n 'csw:Record': {\n 'outputschema': 'http://www.opengis.net/cat/csw/3.0',\n 'queryables': {\n 'SupportedDublinCoreQueryables': {\n # map Dublin Core queryables to core metadata model\n 'dc:title':\n {'dbcol': self.md_core_model['mappings']['pycsw:Title']},\n 'dct:alternative':\n {'dbcol': self.md_core_model['mappings']['pycsw:AlternateTitle']},\n 'dc:creator':\n {'dbcol': self.md_core_model['mappings']['pycsw:Creator']},\n 'dc:subject':\n {'dbcol': self.md_core_model['mappings']['pycsw:Keywords']},\n 'dct:abstract':\n {'dbcol': self.md_core_model['mappings']['pycsw:Abstract']},\n 'dc:publisher':\n {'dbcol': self.md_core_model['mappings']['pycsw:Publisher']},\n 'dc:contributor':\n {'dbcol': self.md_core_model['mappings']['pycsw:Contributor']},\n 'dct:modified':\n {'dbcol': self.md_core_model['mappings']['pycsw:Modified']},\n 'dc:date':\n {'dbcol': self.md_core_model['mappings']['pycsw:Date']},\n 'dc:type':\n {'dbcol': self.md_core_model['mappings']['pycsw:Type']},\n 'dc:format':\n {'dbcol': self.md_core_model['mappings']['pycsw:Format']},\n 'dc:identifier':\n {'dbcol': self.md_core_model['mappings']['pycsw:Identifier']},\n 'dc:source':\n {'dbcol': self.md_core_model['mappings']['pycsw:Source']},\n 'dc:language':\n {'dbcol': self.md_core_model['mappings']['pycsw:Language']},\n 'dc:relation':\n {'dbcol': self.md_core_model['mappings']['pycsw:Relation']},\n 'dc:rights':\n {'dbcol':\n self.md_core_model['mappings']['pycsw:AccessConstraints']},\n 'dct:spatial':\n {'dbcol': self.md_core_model['mappings']['pycsw:CRS']},\n # bbox and full text map to internal fixed columns\n 'ows:BoundingBox':\n {'dbcol': self.md_core_model['mappings']['pycsw:BoundingBox']},\n 'csw:AnyText':\n {'dbcol': self.md_core_model['mappings']['pycsw:AnyText']},\n }\n }\n }\n }\n }\n }\n self.set_model(prefix)\n\n def set_model(self, prefix):\n \"\"\"sets model given request context\"\"\"\n\n self.model = self.models[prefix]\n\n def gen_domains(self):\n \"\"\"Generate parameter domain model\"\"\"\n domain = {}\n domain['methods'] = {'get': True, 'post': True}\n domain['parameters'] = {'ParameterName': {'values': []}}\n for operation in self.model['operations'].keys():\n for parameter in self.model['operations'][operation]['parameters']:\n domain['parameters']['ParameterName']['values'].append('%s.%s' %\n (operation, parameter))\n return domain\n\n def refresh_dc(self, mappings):\n \"\"\"Refresh Dublin Core mappings\"\"\"\n\n LOGGER.debug('refreshing Dublin Core mappings with %s', str(mappings))\n\n defaults = {\n 'dc:title': 'pycsw:Title',\n 'dct:alternative': 'pycsw:AlternateTitle',\n 'dc:creator': 'pycsw:Creator',\n 'dc:subject': 'pycsw:Keywords',\n 'dct:abstract': 'pycsw:Abstract',\n 'dc:publisher': 'pycsw:Publisher',\n 'dc:contributor': 'pycsw:Contributor',\n 'dct:modified': 'pycsw:Modified',\n 'dc:date': 'pycsw:Date',\n 'dc:type': 'pycsw:Type',\n 'dc:format': 'pycsw:Format',\n 'dc:identifier': 'pycsw:Identifier',\n 'dc:source': 'pycsw:Source',\n 'dc:language': 'pycsw:Language',\n 'dc:relation': 'pycsw:Relation',\n 'dc:rights': 'pycsw:AccessConstraints',\n 'dct:spatial': 'pycsw:CRS',\n 'ows:BoundingBox': 'pycsw:BoundingBox',\n 'csw:AnyText': 'pycsw:AnyText',\n }\n\n for k, val in defaults.items():\n for model, params in self.models.items():\n queryables = params['typenames']['csw:Record']['queryables']\n queryables['SupportedDublinCoreQueryables'][k] = {\n 'dbcol': mappings['mappings'][val]\n }\n"
},
{
"path": "pycsw/core/etree.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n# Ricardo Garcia Silva \n#\n# Copyright (c) 2015 Tom Kralidis\n# Copyright (c) 2017 Ricardo Garcia Silva\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\n\"\"\"Custom etree objects for pycsw\n\nBe sure to use the ``PARSER`` object defined in this module whenever it is\nnecessary to parse external XML objects. This parser offers better protection\nagainst known XML attacks.\n\n\"\"\"\n\nfrom lxml import etree\n\nPARSER = etree.XMLParser(resolve_entities=False)\n"
},
{
"path": "pycsw/core/formats/__init__.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2015 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n"
},
{
"path": "pycsw/core/formats/fmt_json.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n# Ricardo Garcia Silva \n#\n# Copyright (c) 2015 Tom Kralidis\n# Copyright (c) 2017 Ricardo Garcia Silva\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport json\n\nimport xmltodict\n\n\ndef xml2dict(xml_string, namespaces):\n \"\"\"Convert an xml document to a dictionary.\n\n Parameters\n ----------\n xml_string: str\n XML representation to convert to a dictionary.\n namespaces: dict\n Namespaces used in the ``xml_string`` parameter\n\n Returns\n -------\n ordereddict\n An ordered dictionary with the contents of the xml data\n\n \"\"\"\n\n namespaces_reverse = dict((v, k) for k, v in namespaces.items())\n return xmltodict.parse(xml_string, process_namespaces=True,\n namespaces=namespaces_reverse)\n\n\ndef xml2json(xml_string, namespaces, pretty_print=False):\n \"\"\"Convert an xml string to JSON\"\"\"\n\n separators = (',', ': ')\n\n if pretty_print:\n return json.dumps(xml2dict(xml_string, namespaces),\n indent=4, separators=separators)\n\n return json.dumps(xml2dict(xml_string, namespaces), separators=separators)\n"
},
{
"path": "pycsw/core/log.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2024 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\n\nimport logging\nimport sys\n\nLOGGER = logging.getLogger(__name__)\n\n\ndef setup_logger(logging_config):\n \"\"\"\n Setup configuration\n\n :param logging_config: logging specific configuration\n\n :returns: void (creates logging instance)\n \"\"\"\n\n log_format = \\\n '[%(asctime)s] {%(pathname)s:%(lineno)d} %(levelname)s - %(message)s'\n date_format = '%Y-%m-%dT%H:%M:%SZ'\n\n loglevels = {\n 'CRITICAL': logging.CRITICAL,\n 'ERROR': logging.ERROR,\n 'WARNING': logging.WARNING,\n 'INFO': logging.INFO,\n 'DEBUG': logging.DEBUG,\n 'NOTSET': logging.NOTSET,\n }\n\n loglevel = loglevels[logging_config['level']]\n\n if 'logfile' in logging_config:\n logging.basicConfig(level=loglevel, datefmt=date_format,\n format=log_format,\n filename=logging_config['logfile'])\n else:\n logging.basicConfig(level=loglevel, datefmt=date_format,\n format=log_format, stream=sys.stdout)\n\n LOGGER.debug('Logging initialized')\n return\n"
},
{
"path": "pycsw/core/metadata.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n# Ricardo Garcia Silva \n# Angelos Tzotsos \n#\n# Copyright (c) 2025 Tom Kralidis\n# Copyright (c) 2016 James F. Dickens\n# Copyright (c) 2017 Ricardo Garcia Silva\n# Copyright (c) 2026 Angelos Tzotsos\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport json\nimport logging\nimport uuid\nfrom urllib.parse import urlparse\n\nfrom geolinks import sniff_link\nfrom owslib.util import build_get_url\nfrom shapely.wkt import loads\nfrom shapely.geometry import MultiPolygon\n\nfrom pycsw.core.etree import etree\nfrom pycsw.core import util\nfrom pycsw.plugins.outputschemas import atom\n\nLOGGER = logging.getLogger(__name__)\n\ndef parse_record(context, record, repos=None,\n mtype='http://www.opengis.net/cat/csw/2.0.2',\n identifier=None, pagesize=10):\n ''' parse metadata '''\n\n if identifier is None:\n identifier = uuid.uuid4().urn\n\n # parse web services\n if (mtype == 'http://www.opengis.net/cat/csw/2.0.2' and\n isinstance(record, str) and record.startswith('http')):\n LOGGER.info('CSW service detected, fetching via HTTP')\n # CSW service, not csw:Record\n try:\n return _parse_csw(context, repos, record, identifier, pagesize)\n except Exception as err:\n # TODO: implement better exception handling\n if str(err).find('ExceptionReport') != -1:\n msg = 'CSW harvesting error: %s' % str(err)\n LOGGER.exception(msg)\n raise RuntimeError(msg)\n LOGGER.debug('Not a CSW, attempting to fetch Dublin Core')\n try:\n content = util.http_request('GET', record)\n except Exception as err:\n raise RuntimeError('HTTP error: %s' % str(err))\n return [_parse_dc(context, repos, etree.fromstring(content, context.parser))]\n\n elif mtype == 'urn:geoss:waf': # WAF\n LOGGER.info('WAF detected, fetching via HTTP')\n return _parse_waf(context, repos, record, identifier)\n\n elif mtype == 'http://www.opengis.net/wms': # WMS\n LOGGER.info('WMS detected, fetching via OWSLib')\n return _parse_wms(context, repos, record, identifier)\n\n elif mtype == 'http://www.opengis.net/wmts/1.0': # WMTS\n LOGGER.info('WMTS 1.0.0 detected, fetching via OWSLib')\n return _parse_wmts(context, repos, record, identifier)\n\n elif mtype == 'http://www.opengis.net/wps/1.0.0': # WPS\n LOGGER.info('WPS detected, fetching via OWSLib')\n return _parse_wps(context, repos, record, identifier)\n\n elif mtype == 'http://www.opengis.net/wfs': # WFS 1.1.0\n LOGGER.info('WFS detected, fetching via OWSLib')\n return _parse_wfs(context, repos, record, identifier, '1.1.0')\n\n elif mtype == 'http://www.opengis.net/wfs/2.0': # WFS 2.0.0\n LOGGER.info('WFS detected, fetching via OWSLib')\n return _parse_wfs(context, repos, record, identifier, '2.0.0')\n\n elif mtype == 'http://www.opengis.net/wcs': # WCS\n LOGGER.info('WCS detected, fetching via OWSLib')\n return _parse_wcs(context, repos, record, identifier)\n\n elif mtype == 'http://www.opengis.net/sos/1.0': # SOS 1.0.0\n LOGGER.info('SOS 1.0.0 detected, fetching via OWSLib')\n return _parse_sos(context, repos, record, identifier, '1.0.0')\n\n elif mtype == 'http://www.opengis.net/sos/2.0': # SOS 2.0.0\n LOGGER.info('SOS 2.0.0 detected, fetching via OWSLib')\n return _parse_sos(context, repos, record, identifier, '2.0.0')\n\n elif (mtype == 'http://www.opengis.net/cat/csw/csdgm' and\n record.startswith('http')): # FGDC\n LOGGER.info('FGDC detected, fetching via HTTP')\n record = util.http_request('GET', record)\n\n return _parse_metadata(context, repos, record)\n\ndef _get(context, obj, name):\n ''' convenience method to get values '''\n return getattr(obj, context.md_core_model['mappings'][name])\n\ndef _set(context, obj, name, value):\n ''' convenience method to set values '''\n setattr(obj, context.md_core_model['mappings'][name], value)\n\ndef _parse_metadata(context, repos, record):\n \"\"\"parse metadata formats\"\"\"\n\n if isinstance(record, dict): # JSON\n LOGGER.debug('Record is JSON based')\n return [_parse_json_record(context, repos, record)]\n\n if isinstance(record, bytes) or isinstance(record, str):\n exml = etree.fromstring(record, context.parser)\n else: # already serialized to lxml\n if hasattr(record, 'getroot'): # standalone document\n exml = record.getroot()\n else: # part of a larger document\n exml = record\n\n root = exml.tag\n\n LOGGER.info('Serialized metadata, parsing content model')\n\n if root == '{%s}MD_Metadata' % context.namespaces['gmd']: # ISO\n return [_parse_iso(context, repos, exml)]\n elif root == '{http://www.isotc211.org/2005/gmi}MI_Metadata':\n # ISO Metadata for Imagery\n return [_parse_iso(context, repos, exml)]\n elif root == 'metadata': # FGDC\n return [_parse_fgdc(context, repos, exml)]\n elif root == '{%s}TRANSFER' % context.namespaces['gm03']: # GM03\n return [_parse_gm03(context, repos, exml)]\n elif root == '{http://www.geocat.ch/2008/che}CHE_MD_Metadata': # GM03 ISO profile\n return [_parse_iso(context, repos, exml)]\n elif root == '{%s}Record' % context.namespaces['csw']: # Dublin Core CSW\n return [_parse_dc(context, repos, exml)]\n elif root == '{%s}RDF' % context.namespaces['rdf']: # Dublin Core RDF\n return [_parse_dc(context, repos, exml)]\n elif root == '{%s}DIF' % context.namespaces['dif']: # DIF\n pass # TODO\n elif root == '{%s}MD_Metadata' % context.namespaces['mdb']:\n # ISO 19115p3 XML\n return [_parse_iso(context, repos, exml)]\n else:\n raise RuntimeError('Unsupported metadata format')\n\n\ndef _parse_csw(context, repos, record, identifier, pagesize=10):\n\n from owslib.csw import CatalogueServiceWeb\n\n recobjs = [] # records\n serviceobj = repos.dataset()\n\n # if init raises error, this might not be a CSW\n md = CatalogueServiceWeb(record, timeout=60)\n\n LOGGER.info('Setting CSW service metadata')\n # generate record of service instance\n _set(context, serviceobj, 'pycsw:Identifier', identifier)\n _set(context, serviceobj, 'pycsw:Typename', 'csw:Record')\n _set(context, serviceobj, 'pycsw:Schema', 'http://www.opengis.net/cat/csw/2.0.2')\n _set(context, serviceobj, 'pycsw:MdSource', record)\n _set(context, serviceobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(\n context,\n serviceobj,\n 'pycsw:AnyText',\n util.get_anytext(md._exml)\n )\n _set(context, serviceobj, 'pycsw:Type', 'service')\n _set(context, serviceobj, 'pycsw:Title', md.identification.title)\n _set(context, serviceobj, 'pycsw:Abstract', md.identification.abstract)\n _set(context, serviceobj, 'pycsw:Keywords', ','.join(md.identification.keywords))\n _set(context, serviceobj, 'pycsw:Creator', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:Publisher', md.provider.name)\n _set(context, serviceobj, 'pycsw:Contributor', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:OrganizationName', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:AccessConstraints', md.identification.accessconstraints)\n _set(context, serviceobj, 'pycsw:OtherConstraints', md.identification.fees)\n _set(context, serviceobj, 'pycsw:Source', record)\n _set(context, serviceobj, 'pycsw:Format', md.identification.type)\n\n _set(context, serviceobj, 'pycsw:ServiceType', 'OGC:CSW')\n _set(context, serviceobj, 'pycsw:ServiceTypeVersion', md.identification.version)\n _set(context, serviceobj, 'pycsw:Operation', ','.join([d.name for d in md.operations]))\n _set(context, serviceobj, 'pycsw:CouplingType', 'tight')\n\n links = [{\n 'name': identifier,\n 'description': 'OGC-CSW Catalogue Service for the Web',\n 'protocol': 'OGC:CSW',\n 'url': md.url\n }]\n\n _set(context, serviceobj, 'pycsw:Links', json.dumps(links))\n _set(context, serviceobj, 'pycsw:XML', caps2iso(serviceobj, md, context))\n _set(context, serviceobj, 'pycsw:MetadataType', 'application/xml')\n\n recobjs.append(serviceobj)\n\n # get all supported typenames of metadata\n # so we can harvest the entire CSW\n\n # try for ISO, settle for Dublin Core\n csw_typenames = 'csw:Record'\n csw_outputschema = 'http://www.opengis.net/cat/csw/2.0.2'\n\n grop = md.get_operation_by_name('GetRecords')\n if all(['gmd:MD_Metadata' in grop.parameters['typeNames']['values'],\n 'http://www.isotc211.org/2005/gmd' in grop.parameters['outputSchema']['values']]):\n LOGGER.debug('CSW supports ISO')\n csw_typenames = 'gmd:MD_Metadata'\n csw_outputschema = 'http://www.isotc211.org/2005/gmd'\n\n\n # now get all records\n # get total number of records to loop against\n\n try:\n md.getrecords2(typenames=csw_typenames, resulttype='hits',\n outputschema=csw_outputschema)\n matches = md.results['matches']\n except Exception: # this is a CSW, but server rejects query\n LOGGER.debug('CSW query failed')\n raise RuntimeError(md.response)\n\n if pagesize > matches:\n pagesize = matches\n\n LOGGER.info('Harvesting %d CSW records', matches)\n\n # loop over all catalogue records incrementally\n for r in range(1, matches+1, pagesize):\n try:\n md.getrecords2(typenames=csw_typenames, startposition=r,\n maxrecords=pagesize, outputschema=csw_outputschema, esn='full')\n except Exception as err: # this is a CSW, but server rejects query\n raise RuntimeError(md.response)\n for k, v in md.records.items():\n # try to parse metadata\n try:\n LOGGER.info('Parsing metadata record: %s', v.xml)\n if csw_typenames == 'gmd:MD_Metadata':\n recobjs.append(_parse_iso(context, repos,\n etree.fromstring(v.xml, context.parser)))\n else:\n recobjs.append(_parse_dc(context, repos,\n etree.fromstring(v.xml, context.parser)))\n except Exception as err: # parsing failed for some reason\n LOGGER.exception('Metadata parsing failed')\n\n return recobjs\n\ndef _parse_waf(context, repos, record, identifier):\n\n recobjs = []\n\n content = util.http_request('GET', record)\n\n LOGGER.debug(content)\n\n try:\n parser = etree.HTMLParser()\n tree = etree.fromstring(content, parser)\n except Exception as err:\n raise Exception('Could not parse WAF: %s' % str(err))\n\n up = urlparse(record)\n links = []\n\n LOGGER.info('collecting links')\n for link in tree.xpath('//a/@href'):\n link = link.strip()\n if not link:\n continue\n if link.find('?') != -1:\n continue\n if not link.endswith('.xml'):\n LOGGER.debug('Skipping, not .xml')\n continue\n if '/' in link: # path is embedded in link\n if link[-1] == '/': # directory, skip\n continue\n if link[0] == '/':\n # strip path of WAF URL\n link = '%s://%s%s' % (up.scheme, up.netloc, link)\n else: # tack on href to WAF URL\n link = '%s/%s' % (record, link)\n LOGGER.debug('URL is: %s', link)\n links.append(link)\n\n LOGGER.debug('%d links found', len(links))\n for link in links:\n LOGGER.info('Processing link %s', link)\n # fetch and parse\n linkcontent = util.http_request('GET', link)\n recobj = _parse_metadata(context, repos, linkcontent)[0]\n recobj.source = link\n recobj.mdsource = link\n recobjs.append(recobj)\n\n return recobjs\n\ndef _parse_wms(context, repos, record, identifier):\n\n from owslib.wms import WebMapService\n\n recobjs = []\n serviceobj = repos.dataset()\n\n md = WebMapService(record)\n try:\n md = WebMapService(record, version='1.3.0')\n except Exception as err:\n LOGGER.info('Looks like WMS 1.3.0 is not supported; trying 1.1.1', err)\n md = WebMapService(record)\n\n # generate record of service instance\n _set(context, serviceobj, 'pycsw:Identifier', identifier)\n _set(context, serviceobj, 'pycsw:Typename', 'csw:Record')\n _set(context, serviceobj, 'pycsw:Schema', 'http://www.opengis.net/wms')\n _set(context, serviceobj, 'pycsw:MdSource', record)\n _set(context, serviceobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(\n context,\n serviceobj,\n 'pycsw:AnyText',\n util.get_anytext(md.getServiceXML())\n )\n _set(context, serviceobj, 'pycsw:Type', 'service')\n _set(context, serviceobj, 'pycsw:Title', md.identification.title)\n _set(context, serviceobj, 'pycsw:Abstract', md.identification.abstract)\n _set(context, serviceobj, 'pycsw:Keywords', ','.join(md.identification.keywords))\n _set(context, serviceobj, 'pycsw:Creator', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:Publisher', md.provider.name)\n _set(context, serviceobj, 'pycsw:Contributor', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:OrganizationName', md.provider.contact.name)\n\n contacts = [vars(md.provider.contact)]\n contacts[0]['role'] = 'pointOfContact'\n _set(context, serviceobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n _set(context, serviceobj, 'pycsw:AccessConstraints', md.identification.accessconstraints)\n _set(context, serviceobj, 'pycsw:OtherConstraints', md.identification.fees)\n _set(context, serviceobj, 'pycsw:Source', record)\n _set(context, serviceobj, 'pycsw:Format', md.identification.type)\n for c in md.contents:\n if md.contents[c].parent is None:\n bbox = md.contents[c].boundingBoxWGS84\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n _set(context, serviceobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n break\n _set(context, serviceobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, serviceobj, 'pycsw:DistanceUOM', 'degrees')\n _set(context, serviceobj, 'pycsw:ServiceType', 'OGC:WMS')\n _set(context, serviceobj, 'pycsw:ServiceTypeVersion', md.identification.version)\n _set(context, serviceobj, 'pycsw:Operation', ','.join([d.name for d in md.operations]))\n _set(context, serviceobj, 'pycsw:OperatesOn', ','.join(list(md.contents)))\n _set(context, serviceobj, 'pycsw:CouplingType', 'tight')\n\n links = [{\n 'name': identifier,\n 'description': 'OGC-WMS Web Map Service',\n 'protocol': 'OGC:WMS',\n 'url': md.url\n }]\n\n _set(context, serviceobj, 'pycsw:Links', json.dumps(links))\n _set(context, serviceobj, 'pycsw:XML', caps2iso(serviceobj, md, context))\n _set(context, serviceobj, 'pycsw:MetadataType', 'application/xml')\n\n recobjs.append(serviceobj)\n\n # generate record foreach layer\n\n LOGGER.info('Harvesting %d WMS layers', len(md.contents))\n\n for layer in md.contents:\n recobj = repos.dataset()\n identifier2 = '%s-%s' % (identifier, md.contents[layer].name)\n _set(context, recobj, 'pycsw:Identifier', identifier2)\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', 'http://www.opengis.net/wms')\n _set(context, recobj, 'pycsw:MdSource', record)\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:Type', 'dataset')\n _set(context, recobj, 'pycsw:ParentIdentifier', identifier)\n _set(context, recobj, 'pycsw:Title', md.contents[layer].title)\n _set(context, recobj, 'pycsw:Abstract', md.contents[layer].abstract)\n _set(context, recobj, 'pycsw:Keywords', ','.join(md.contents[layer].keywords))\n\n _set(\n context,\n recobj,\n 'pycsw:AnyText',\n util.get_anytext([\n md.contents[layer].title,\n md.contents[layer].abstract,\n ','.join(md.contents[layer].keywords)\n ])\n )\n\n bbox = md.contents[layer].boundingBoxWGS84\n if bbox is not None:\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n _set(context, recobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, recobj, 'pycsw:DistanceUOM', 'degrees')\n else:\n bbox = md.contents[layer].boundingBox\n if bbox:\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n _set(context, recobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:%s' % \\\n bbox[-1].split(':')[1])\n\n _set(context, recobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n times = md.contents[layer].timepositions\n if times is not None: # get temporal extent\n time_begin = time_end = None\n if len(times) == 1 and len(times[0].split('/')) > 1:\n time_envelope = times[0].split('/')\n time_begin = time_envelope[0]\n time_end = time_envelope[1]\n elif len(times) > 1: # get first/last\n time_begin = times[0]\n time_end = times[-1]\n if all([time_begin is not None, time_end is not None]):\n _set(context, recobj, 'pycsw:TempExtent_begin', time_begin)\n _set(context, recobj, 'pycsw:TempExtent_end', time_end)\n\n params = {\n 'service': 'WMS',\n 'version': '1.1.1',\n 'request': 'GetMap',\n 'layers': md.contents[layer].name,\n 'format': 'image/png',\n 'height': '200',\n 'width': '200',\n 'srs': 'EPSG:4326',\n 'bbox': '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3]),\n 'styles': ''\n }\n\n links = [{\n 'name': md.contents[layer].name,\n 'description': 'OGC-Web Map Service',\n 'protocol': 'OGC:WMS',\n 'url': md.url\n }, {\n 'name': md.contents[layer].name,\n 'description': 'Web image thumbnail (URL)',\n 'protocol': 'WWW:LINK-1.0-http--image-thumbnail',\n 'url': build_get_url(md.url, params)\n }]\n\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n _set(context, recobj, 'pycsw:XML', caps2iso(recobj, md, context))\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n\n recobjs.append(recobj)\n\n return recobjs\n\ndef _parse_wmts(context, repos, record, identifier):\n\n from owslib.wmts import WebMapTileService\n\n recobjs = []\n serviceobj = repos.dataset()\n\n md = WebMapTileService(record)\n # generate record of service instance\n _set(context, serviceobj, 'pycsw:Identifier', identifier)\n _set(context, serviceobj, 'pycsw:Typename', 'csw:Record')\n _set(context, serviceobj, 'pycsw:Schema', 'http://www.opengis.net/wmts/1.0')\n _set(context, serviceobj, 'pycsw:MdSource', record)\n _set(context, serviceobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(\n context,\n serviceobj,\n 'pycsw:AnyText',\n util.get_anytext(md.getServiceXML())\n )\n _set(context, serviceobj, 'pycsw:Type', 'service')\n _set(context, serviceobj, 'pycsw:Title', md.identification.title)\n _set(context, serviceobj, 'pycsw:Abstract', md.identification.abstract)\n _set(context, serviceobj, 'pycsw:Keywords', ','.join(md.identification.keywords))\n _set(context, serviceobj, 'pycsw:Creator', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:Publisher', md.provider.name)\n _set(context, serviceobj, 'pycsw:Contributor', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:OrganizationName', md.provider.contact.name)\n\n contacts = [vars(md.provider.contact)]\n contacts[0]['role'] = 'pointOfContact'\n _set(context, serviceobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n _set(context, serviceobj, 'pycsw:AccessConstraints', md.identification.accessconstraints)\n _set(context, serviceobj, 'pycsw:OtherConstraints', md.identification.fees)\n _set(context, serviceobj, 'pycsw:Source', record)\n _set(context, serviceobj, 'pycsw:Format', md.identification.type)\n\n for c in md.contents:\n if md.contents[c].parent is None:\n bbox = md.contents[c].boundingBoxWGS84\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n _set(context, serviceobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n break\n _set(context, serviceobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, serviceobj, 'pycsw:DistanceUOM', 'degrees')\n _set(context, serviceobj, 'pycsw:ServiceType', 'OGC:WMTS')\n _set(context, serviceobj, 'pycsw:ServiceTypeVersion', md.identification.version)\n _set(context, serviceobj, 'pycsw:Operation', ','.join([d.name for d in md.operations]))\n _set(context, serviceobj, 'pycsw:OperatesOn', ','.join(list(md.contents)))\n _set(context, serviceobj, 'pycsw:CouplingType', 'tight')\n\n links = [{\n 'name': identifier,\n 'description': 'OGC-WMTS Web Map Service',\n 'protocol': 'OGC:WMTS',\n 'url': md.url\n }]\n\n _set(context, serviceobj, 'pycsw:Links', json.dumps(links))\n _set(context, serviceobj, 'pycsw:XML', caps2iso(serviceobj, md, context))\n _set(context, serviceobj, 'pycsw:MetadataType', 'application/xml')\n\n recobjs.append(serviceobj)\n\n # generate record for each layer\n\n LOGGER.debug('Harvesting %d WMTS layers', len(md.contents))\n\n for layer in md.contents:\n recobj = repos.dataset()\n keywords = ''\n identifier2 = '%s-%s' % (identifier, md.contents[layer].name)\n _set(context, recobj, 'pycsw:Identifier', identifier2)\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', 'http://www.opengis.net/wmts/1.0')\n _set(context, recobj, 'pycsw:MdSource', record)\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:Type', 'dataset')\n _set(context, recobj, 'pycsw:ParentIdentifier', identifier)\n if md.contents[layer].title:\n _set(context, recobj, 'pycsw:Title', md.contents[layer].title)\n else:\n _set(context, recobj, 'pycsw:Title', \"\")\n if md.contents[layer].abstract:\n _set(context, recobj, 'pycsw:Abstract', md.contents[layer].abstract)\n else:\n _set(context, recobj, 'pycsw:Abstract', \"\")\n if hasattr(md.contents[layer], 'keywords'): # safeguard against older OWSLib installs\n keywords = ','.join(md.contents[layer].keywords)\n _set(context, recobj, 'pycsw:Keywords', keywords)\n\n _set(\n context,\n recobj,\n 'pycsw:AnyText',\n util.get_anytext([\n md.contents[layer].title,\n md.contents[layer].abstract,\n ','.join(keywords)\n ])\n )\n\n bbox = md.contents[layer].boundingBoxWGS84\n\n if bbox is not None:\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n _set(context, recobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, recobj, 'pycsw:DistanceUOM', 'degrees')\n else:\n bbox = md.contents[layer].boundingBox\n if bbox:\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n _set(context, recobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:%s' % \\\n bbox[-1].split(':')[1])\n\n _set(context, recobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n params = {\n 'service': 'WMTS',\n 'version': '1.0.0',\n 'request': 'GetTile',\n 'layer': md.contents[layer].name,\n }\n\n links = [{\n 'name': md.contents[layer].name,\n 'description': 'OGC-Web Map Tile Service',\n 'protocol': 'OGC:WMTS',\n 'url': md.url\n }, {\n 'name': md.contents[layer].name,\n 'description': 'Web image thumbnail (URL)',\n 'protocol': 'WWW:LINK-1.0-http--image-thumbnai',\n 'url': build_get_url(md.url, params)\n }]\n\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n _set(context, recobj, 'pycsw:XML', caps2iso(recobj, md, context))\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n\n recobjs.append(recobj)\n\n return recobjs\n\n\ndef _parse_wfs(context, repos, record, identifier, version):\n\n import requests\n from owslib.wfs import WebFeatureService\n\n bboxs = []\n recobjs = []\n serviceobj = repos.dataset()\n\n try:\n md = WebFeatureService(record, version)\n except requests.exceptions.HTTPError as err:\n raise\n except Exception as err:\n if version == '1.1.0':\n md = WebFeatureService(record, '1.0.0')\n\n # generate record of service instance\n _set(context, serviceobj, 'pycsw:Identifier', identifier)\n _set(context, serviceobj, 'pycsw:Typename', 'csw:Record')\n _set(context, serviceobj, 'pycsw:Schema', 'http://www.opengis.net/wfs')\n _set(context, serviceobj, 'pycsw:MdSource', record)\n _set(context, serviceobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(\n context,\n serviceobj,\n 'pycsw:AnyText',\n util.get_anytext(etree.tostring(md._capabilities))\n )\n _set(context, serviceobj, 'pycsw:Type', 'service')\n _set(context, serviceobj, 'pycsw:Title', md.identification.title)\n _set(context, serviceobj, 'pycsw:Abstract', md.identification.abstract)\n _set(context, serviceobj, 'pycsw:Keywords', ','.join(md.identification.keywords))\n _set(context, serviceobj, 'pycsw:Creator', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:Publisher', md.provider.name)\n _set(context, serviceobj, 'pycsw:Contributor', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:OrganizationName', md.provider.contact.name)\n\n contacts = [vars(md.provider.contact)]\n contacts[0]['role'] = 'pointOfContact'\n _set(context, serviceobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n _set(context, serviceobj, 'pycsw:AccessConstraints', md.identification.accessconstraints)\n _set(context, serviceobj, 'pycsw:OtherConstraints', md.identification.fees)\n _set(context, serviceobj, 'pycsw:Source', record)\n _set(context, serviceobj, 'pycsw:Format', md.identification.type)\n _set(context, serviceobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, serviceobj, 'pycsw:DistanceUOM', 'degrees')\n _set(context, serviceobj, 'pycsw:ServiceType', 'OGC:WFS')\n _set(context, serviceobj, 'pycsw:ServiceTypeVersion', md.identification.version)\n _set(context, serviceobj, 'pycsw:Operation', ','.join([d.name for d in md.operations]))\n _set(context, serviceobj, 'pycsw:OperatesOn', ','.join(list(md.contents)))\n _set(context, serviceobj, 'pycsw:CouplingType', 'tight')\n\n links = [{\n 'name': identifier,\n 'description': 'OGC-WFS Web Feature Service',\n 'protocol': 'OGC:WFS',\n 'url': md.url\n }]\n\n _set(context, serviceobj, 'pycsw:Links', json.dumps(links))\n\n # generate record foreach featuretype\n\n LOGGER.info('Harvesting %d WFS featuretypes', len(md.contents))\n\n for featuretype in md.contents:\n recobj = repos.dataset()\n identifier2 = '%s-%s' % (identifier, md.contents[featuretype].id)\n _set(context, recobj, 'pycsw:Identifier', identifier2)\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', 'http://www.opengis.net/wfs')\n _set(context, recobj, 'pycsw:MdSource', record)\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:Type', 'dataset')\n _set(context, recobj, 'pycsw:ParentIdentifier', identifier)\n _set(context, recobj, 'pycsw:Title', md.contents[featuretype].title)\n _set(context, recobj, 'pycsw:Abstract', md.contents[featuretype].abstract)\n _set(context, recobj, 'pycsw:Keywords', ','.join(md.contents[featuretype].keywords))\n\n _set(\n context,\n recobj,\n 'pycsw:AnyText',\n util.get_anytext([\n md.contents[featuretype].title,\n md.contents[featuretype].abstract,\n ','.join(md.contents[featuretype].keywords)\n ])\n )\n\n bbox = md.contents[featuretype].boundingBoxWGS84\n if bbox is not None:\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n wkt_polygon = util.bbox2wktpolygon(tmp)\n _set(context, recobj, 'pycsw:BoundingBox', wkt_polygon)\n _set(context, recobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, recobj, 'pycsw:DistanceUOM', 'degrees')\n bboxs.append(wkt_polygon)\n\n params = {\n 'service': 'WFS',\n 'version': '1.1.0',\n 'request': 'GetFeature',\n 'typename': md.contents[featuretype].id,\n }\n\n links = [{\n 'name': md.contents[featuretype].id,\n 'description': 'OGC-Web Feature Service',\n 'protocol': 'OGC:WFS',\n 'url': md.url\n }, {\n 'name': md.contents[featuretype].id,\n 'description': 'File for download',\n 'protocol': 'WWW:DOWNLOAD-1.0-http--download',\n 'url': build_get_url(md.url, params)\n }]\n\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n _set(context, recobj, 'pycsw:XML', caps2iso(recobj, md, context))\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n _set(context, recobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n recobjs.append(recobj)\n\n # Derive a bbox based on aggregated featuretype bbox values\n\n bbox_agg = bbox_from_polygons(bboxs)\n\n if bbox_agg is not None:\n _set(context, serviceobj, 'pycsw:BoundingBox', bbox_agg)\n\n _set(context, serviceobj, 'pycsw:XML', caps2iso(serviceobj, md, context))\n\n recobjs.insert(0, serviceobj)\n\n return recobjs\n\ndef _parse_wcs(context, repos, record, identifier):\n\n from owslib.wcs import WebCoverageService\n\n bboxs = []\n recobjs = []\n serviceobj = repos.dataset()\n\n md = WebCoverageService(record, '1.0.0')\n\n # generate record of service instance\n _set(context, serviceobj, 'pycsw:Identifier', identifier)\n _set(context, serviceobj, 'pycsw:Typename', 'csw:Record')\n _set(context, serviceobj, 'pycsw:Schema', 'http://www.opengis.net/wcs')\n _set(context, serviceobj, 'pycsw:MdSource', record)\n _set(context, serviceobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(\n context,\n serviceobj,\n 'pycsw:AnyText',\n util.get_anytext(etree.tostring(md._capabilities))\n )\n _set(context, serviceobj, 'pycsw:Type', 'service')\n _set(context, serviceobj, 'pycsw:Title', md.identification.title)\n _set(context, serviceobj, 'pycsw:Abstract', md.identification.abstract)\n _set(context, serviceobj, 'pycsw:Keywords', ','.join(md.identification.keywords))\n _set(context, serviceobj, 'pycsw:Creator', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:Publisher', md.provider.name)\n _set(context, serviceobj, 'pycsw:Contributor', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:OrganizationName', md.provider.contact.name)\n\n contacts = [vars(md.provider.contact)]\n contacts[0]['role'] = 'pointOfContact'\n _set(context, serviceobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n _set(context, serviceobj, 'pycsw:AccessConstraints', md.identification.accessConstraints)\n _set(context, serviceobj, 'pycsw:OtherConstraints', md.identification.fees)\n _set(context, serviceobj, 'pycsw:Source', record)\n _set(context, serviceobj, 'pycsw:Format', md.identification.type)\n _set(context, serviceobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, serviceobj, 'pycsw:DistanceUOM', 'degrees')\n _set(context, serviceobj, 'pycsw:ServiceType', 'OGC:WCS')\n _set(context, serviceobj, 'pycsw:ServiceTypeVersion', md.identification.version)\n _set(context, serviceobj, 'pycsw:Operation', ','.join([d.name for d in md.operations]))\n _set(context, serviceobj, 'pycsw:OperatesOn', ','.join(list(md.contents)))\n _set(context, serviceobj, 'pycsw:CouplingType', 'tight')\n\n links = [{\n 'name': identifier,\n 'description': 'OGC-WCS Web Coverage Service',\n 'protocol': 'OGC:WCS',\n 'url': md.url\n }]\n\n _set(context, serviceobj, 'pycsw:Links', json.dumps(links))\n\n # generate record foreach coverage\n\n LOGGER.info('Harvesting %d WCS coverages ', len(md.contents))\n\n for coverage in md.contents:\n recobj = repos.dataset()\n identifier2 = '%s-%s' % (identifier, md.contents[coverage].id)\n _set(context, recobj, 'pycsw:Identifier', identifier2)\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', 'http://www.opengis.net/wcs')\n _set(context, recobj, 'pycsw:MdSource', record)\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:Type', 'dataset')\n _set(context, recobj, 'pycsw:ParentIdentifier', identifier)\n _set(context, recobj, 'pycsw:Title', md.contents[coverage].title)\n _set(context, recobj, 'pycsw:Abstract', md.contents[coverage].abstract)\n _set(context, recobj, 'pycsw:Keywords', ','.join(md.contents[coverage].keywords))\n\n _set(\n context,\n recobj,\n 'pycsw:AnyText',\n util.get_anytext([\n md.contents[coverage].title,\n md.contents[coverage].abstract,\n ','.join(md.contents[coverage].keywords)\n ])\n )\n\n bbox = md.contents[coverage].boundingBoxWGS84\n if bbox is not None:\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n wkt_polygon = util.bbox2wktpolygon(tmp)\n _set(context, recobj, 'pycsw:BoundingBox', wkt_polygon)\n _set(context, recobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, recobj, 'pycsw:DistanceUOM', 'degrees')\n bboxs.append(wkt_polygon)\n\n links = [{\n 'name': md.contents[coverage].id,\n 'description': 'OGC-Web Coverage Service',\n 'protocol': 'OGC:WCS',\n 'url': md.url\n }]\n\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n _set(context, recobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n _set(context, recobj, 'pycsw:XML', caps2iso(recobj, md, context))\n\n recobjs.append(recobj)\n\n # Derive a bbox based on aggregated coverage bbox values\n\n bbox_agg = bbox_from_polygons(bboxs)\n\n if bbox_agg is not None:\n _set(context, serviceobj, 'pycsw:BoundingBox', bbox_agg)\n\n _set(context, serviceobj, 'pycsw:XML', caps2iso(serviceobj, md, context))\n recobjs.insert(0, serviceobj)\n\n return recobjs\n\ndef _parse_wps(context, repos, record, identifier):\n\n from owslib.wps import WebProcessingService\n\n recobjs = []\n serviceobj = repos.dataset()\n\n md = WebProcessingService(record)\n\n # generate record of service instance\n _set(context, serviceobj, 'pycsw:Identifier', identifier)\n _set(context, serviceobj, 'pycsw:Typename', 'csw:Record')\n _set(context, serviceobj, 'pycsw:Schema', 'http://www.opengis.net/wps/1.0.0')\n _set(context, serviceobj, 'pycsw:MdSource', record)\n _set(context, serviceobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(\n context,\n serviceobj,\n 'pycsw:AnyText',\n util.get_anytext(md._capabilities)\n )\n _set(context, serviceobj, 'pycsw:Type', 'service')\n _set(context, serviceobj, 'pycsw:Title', md.identification.title)\n _set(context, serviceobj, 'pycsw:Abstract', md.identification.abstract)\n _set(context, serviceobj, 'pycsw:Keywords', ','.join(md.identification.keywords))\n _set(context, serviceobj, 'pycsw:Creator', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:Publisher', md.provider.name)\n _set(context, serviceobj, 'pycsw:Contributor', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:OrganizationName', md.provider.contact.name)\n\n contacts = [vars(md.provider.contact)]\n contacts[0]['role'] = 'pointOfContact'\n _set(context, serviceobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n _set(context, serviceobj, 'pycsw:AccessConstraints', md.identification.accessconstraints)\n _set(context, serviceobj, 'pycsw:OtherConstraints', md.identification.fees)\n _set(context, serviceobj, 'pycsw:Source', record)\n _set(context, serviceobj, 'pycsw:Format', md.identification.type)\n\n _set(context, serviceobj, 'pycsw:ServiceType', 'OGC:WPS')\n _set(context, serviceobj, 'pycsw:ServiceTypeVersion', md.identification.version)\n _set(context, serviceobj, 'pycsw:Operation', ','.join([d.name for d in md.operations]))\n _set(context, serviceobj, 'pycsw:OperatesOn', ','.join([o.identifier for o in md.processes]))\n _set(context, serviceobj, 'pycsw:CouplingType', 'loose')\n\n links = [{\n 'name': identifier,\n 'description': 'OGC-WPS Web Processing Service',\n 'protocol': 'OGC:WPS',\n 'url': md.url\n }, {\n 'name': identifier,\n 'description': 'OGC-WPS Capabilities service (ver 1.0.0)',\n 'protocol': 'OGC:WPS-1.1.0-http-get-capabilities',\n 'url': build_get_url(md.url, {'service': 'WPS', 'version': '1.0.0', 'request': 'GetCapabilities'})\n }]\n\n _set(context, serviceobj, 'pycsw:Links', json.dumps(links))\n _set(context, serviceobj, 'pycsw:XML', caps2iso(serviceobj, md, context))\n _set(context, serviceobj, 'pycsw:MetadataType', 'application/xml')\n\n recobjs.append(serviceobj)\n\n # generate record foreach process\n\n LOGGER.info('Harvesting %d WPS processes', len(md.processes))\n\n for process in md.processes:\n recobj = repos.dataset()\n identifier2 = '%s-%s' % (identifier, process.identifier)\n _set(context, recobj, 'pycsw:Identifier', identifier2)\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', 'http://www.opengis.net/wps/1.0.0')\n _set(context, recobj, 'pycsw:MdSource', record)\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:Type', 'software')\n _set(context, recobj, 'pycsw:ParentIdentifier', identifier)\n _set(context, recobj, 'pycsw:Title', process.title)\n _set(context, recobj, 'pycsw:Abstract', process.abstract)\n\n _set(\n context,\n recobj,\n 'pycsw:AnyText',\n util.get_anytext([process.title, process.abstract])\n )\n\n params = {\n 'service': 'WPS',\n 'version': '1.0.0',\n 'request': 'DescribeProcess',\n 'identifier': process.identifier\n }\n\n links.append({\n 'name': identifier,\n 'description': 'OGC-WPS DescribeProcess service (ver 1.0.0)',\n 'protocol': 'OGC:WPS-1.0.0-http-describe-process',\n 'url': build_get_url(md.url, {'service': 'WPS', 'version': '1.0.0', 'request': 'DescribeProcess', 'identifier': process.identifier})\n })\n\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n _set(context, recobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n _set(context, recobj, 'pycsw:XML', caps2iso(recobj, md, context))\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n\n recobjs.append(recobj)\n\n return recobjs\n\n\ndef _parse_sos(context, repos, record, identifier, version):\n\n from owslib.sos import SensorObservationService\n\n bboxs = []\n recobjs = []\n serviceobj = repos.dataset()\n\n if version == '1.0.0':\n schema = 'http://www.opengis.net/sos/1.0'\n else:\n schema = 'http://www.opengis.net/sos/2.0'\n\n md = SensorObservationService(record, version=version)\n\n # generate record of service instance\n _set(context, serviceobj, 'pycsw:Identifier', identifier)\n _set(context, serviceobj, 'pycsw:Typename', 'csw:Record')\n _set(context, serviceobj, 'pycsw:Schema', schema)\n _set(context, serviceobj, 'pycsw:MdSource', record)\n _set(context, serviceobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(\n context,\n serviceobj,\n 'pycsw:AnyText',\n util.get_anytext(etree.tostring(md._capabilities))\n )\n _set(context, serviceobj, 'pycsw:Type', 'service')\n _set(context, serviceobj, 'pycsw:Title', md.identification.title)\n _set(context, serviceobj, 'pycsw:Abstract', md.identification.abstract)\n _set(context, serviceobj, 'pycsw:Keywords', ','.join(md.identification.keywords))\n _set(context, serviceobj, 'pycsw:Creator', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:Publisher', md.provider.name)\n _set(context, serviceobj, 'pycsw:Contributor', md.provider.contact.name)\n _set(context, serviceobj, 'pycsw:OrganizationName', md.provider.contact.name)\n\n contacts = [vars(md.provider.contact)]\n contacts[0]['role'] = 'pointOfContact'\n _set(context, serviceobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n\n _set(context, serviceobj, 'pycsw:AccessConstraints', md.identification.accessconstraints)\n _set(context, serviceobj, 'pycsw:OtherConstraints', md.identification.fees)\n _set(context, serviceobj, 'pycsw:Source', record)\n _set(context, serviceobj, 'pycsw:Format', md.identification.type)\n _set(context, serviceobj, 'pycsw:CRS', 'urn:ogc:def:crs:EPSG:6.11:4326')\n _set(context, serviceobj, 'pycsw:DistanceUOM', 'degrees')\n _set(context, serviceobj, 'pycsw:ServiceType', 'OGC:SOS')\n _set(context, serviceobj, 'pycsw:ServiceTypeVersion', md.identification.version)\n _set(context, serviceobj, 'pycsw:Operation', ','.join([d.name for d in md.operations]))\n _set(context, serviceobj, 'pycsw:OperatesOn', ','.join(list(md.contents)))\n _set(context, serviceobj, 'pycsw:CouplingType', 'tight')\n\n links = [{\n 'name': identifier,\n 'description': 'OGC-SOS Sensor Observation Service',\n 'protocol': 'OGC:SOS',\n 'url': md.url\n }]\n\n _set(context, serviceobj, 'pycsw:Links', json.dumps(links))\n\n # generate record foreach offering\n\n LOGGER.info('Harvesting %d SOS ObservationOffering\\'s ', len(md.contents))\n\n for offering in md.contents:\n recobj = repos.dataset()\n identifier2 = '%s-%s' % (identifier, md.contents[offering].id)\n _set(context, recobj, 'pycsw:Identifier', identifier2)\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', schema)\n _set(context, recobj, 'pycsw:MdSource', record)\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:Type', 'dataset')\n _set(context, recobj, 'pycsw:ParentIdentifier', identifier)\n _set(context, recobj, 'pycsw:Title', md.contents[offering].description)\n _set(context, recobj, 'pycsw:Abstract', md.contents[offering].description)\n begin = md.contents[offering].begin_position\n end = md.contents[offering].end_position\n _set(context, recobj, 'pycsw:TempExtent_begin',\n util.datetime2iso8601(begin) if begin is not None else None)\n _set(context, recobj, 'pycsw:TempExtent_end',\n util.datetime2iso8601(end) if end is not None else None)\n\n #For observed_properties that have mmi url or urn, we simply want the observation name.\n observed_properties = []\n for obs in md.contents[offering].observed_properties:\n #Observation is stored as urn representation: urn:ogc:def:phenomenon:mmisw.org:cf:sea_water_salinity\n if obs.lower().startswith(('urn:', 'x-urn')):\n observed_properties.append(obs.rsplit(':', 1)[-1])\n #Observation is stored as uri representation: http://mmisw.org/ont/cf/parameter/sea_floor_depth_below_sea_surface\n elif obs.lower().startswith(('http://', 'https://')):\n observed_properties.append(obs.rsplit('/', 1)[-1])\n else:\n observed_properties.append(obs)\n #Build anytext from description and the observed_properties.\n anytext = []\n anytext.append(md.contents[offering].description)\n anytext.extend(observed_properties)\n _set(context, recobj, 'pycsw:AnyText', util.get_anytext(anytext))\n _set(context, recobj, 'pycsw:Keywords', ','.join(observed_properties))\n\n bbox = md.contents[offering].bbox\n if bbox is not None:\n tmp = '%s,%s,%s,%s' % (bbox[0], bbox[1], bbox[2], bbox[3])\n wkt_polygon = util.bbox2wktpolygon(tmp)\n _set(context, recobj, 'pycsw:BoundingBox', wkt_polygon)\n _set(context, recobj, 'pycsw:CRS', md.contents[offering].bbox_srs.id)\n _set(context, recobj, 'pycsw:DistanceUOM', 'degrees')\n bboxs.append(wkt_polygon)\n _set(context, recobj, 'pycsw:Contacts', \n json.dumps(contacts,default=lambda o: o.__dict__))\n _set(context, recobj, 'pycsw:XML', caps2iso(recobj, md, context))\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n recobjs.append(recobj)\n\n # Derive a bbox based on aggregated featuretype bbox values\n\n bbox_agg = bbox_from_polygons(bboxs)\n\n if bbox_agg is not None:\n _set(context, serviceobj, 'pycsw:BoundingBox', bbox_agg)\n\n _set(context, serviceobj, 'pycsw:XML', caps2iso(serviceobj, md, context))\n recobjs.insert(0, serviceobj)\n\n return recobjs\n\n\ndef _parse_fgdc(context, repos, exml):\n\n from owslib.fgdc import Metadata\n\n recobj = repos.dataset()\n links = []\n\n md = Metadata(exml)\n\n if md.idinfo.datasetid is not None: # we need an identifier\n _set(context, recobj, 'pycsw:Identifier', md.idinfo.datasetid)\n else: # generate one ourselves\n _set(context, recobj, 'pycsw:Identifier', uuid.uuid1().urn)\n\n _set(context, recobj, 'pycsw:Typename', 'fgdc:metadata')\n _set(context, recobj, 'pycsw:Schema', context.namespaces['fgdc'])\n _set(context, recobj, 'pycsw:MdSource', 'local')\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:XML', md.xml)\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n _set(context, recobj, 'pycsw:AnyText', util.get_anytext(exml))\n _set(context, recobj, 'pycsw:Language', 'en-US')\n\n if hasattr(md.idinfo, 'descript'):\n _set(context, recobj, 'pycsw:Abstract', md.idinfo.descript.abstract)\n\n if hasattr(md.idinfo, 'keywords'):\n if md.idinfo.keywords.theme:\n _set(context, recobj, 'pycsw:Keywords', \\\n ','.join(md.idinfo.keywords.theme[0]['themekey']))\n\n if hasattr(md.idinfo.timeperd, 'timeinfo'):\n if hasattr(md.idinfo.timeperd.timeinfo, 'rngdates'):\n _set(context, recobj, 'pycsw:TempExtent_begin',\n md.idinfo.timeperd.timeinfo.rngdates.begdate)\n _set(context, recobj, 'pycsw:TempExtent_end',\n md.idinfo.timeperd.timeinfo.rngdates.enddate)\n\n if hasattr(md.idinfo, 'origin'):\n _set(context, recobj, 'pycsw:Creator', md.idinfo.origin)\n _set(context, recobj, 'pycsw:Publisher', md.idinfo.origin)\n _set(context, recobj, 'pycsw:Contributor', md.idinfo.origin)\n \n contacts = []\n if hasattr(md.idinfo, 'ptcontac'):\n _set(context, recobj, 'pycsw:OrganizationName', md.idinfo.ptcontac.cntorg)\n contacts.append(fgdccontact2iso(md.idinfo.ptcontac, 'pointOfContact'))\n \n if hasattr(md.metainfo, 'metc'):\n contacts.append(fgdccontact2iso(md.metainfo.metc, 'pointOfContact'))\n \n if hasattr(md.distinfo, 'distrib'):\n contacts.append(fgdccontact2iso(md.distinfo.distrib, 'distributor'))\n \n if len(contacts) > 0:\n _set(context, recobj, 'pycsw:Contacts', json.dumps(contacts))\n\n _set(context, recobj, 'pycsw:AccessConstraints', md.idinfo.accconst)\n _set(context, recobj, 'pycsw:OtherConstraints', md.idinfo.useconst)\n _set(context, recobj, 'pycsw:Date', md.metainfo.metd)\n\n if hasattr(md.idinfo, 'spdom') and hasattr(md.idinfo.spdom, 'bbox'):\n bbox = md.idinfo.spdom.bbox\n else:\n bbox = None\n\n if hasattr(md.idinfo, 'citation'):\n if hasattr(md.idinfo.citation, 'citeinfo'):\n _set(context, recobj, 'pycsw:Type', md.idinfo.citation.citeinfo['geoform'])\n _set(context, recobj, 'pycsw:Title', md.idinfo.citation.citeinfo['title'])\n _set(context, recobj,\n 'pycsw:PublicationDate', md.idinfo.citation.citeinfo['pubdate'])\n _set(context, recobj, 'pycsw:Format', md.idinfo.citation.citeinfo['geoform'])\n if md.idinfo.citation.citeinfo['onlink']:\n for link in md.idinfo.citation.citeinfo['onlink']:\n links.append({\n 'name': None,\n 'description': None,\n 'protocol': None,\n 'url': link\n })\n\n if hasattr(md, 'distinfo') and hasattr(md.distinfo, 'stdorder'):\n for link in md.distinfo.stdorder['digform']:\n tmp = ',%s,,%s' % (link['name'], link['url'])\n links.append({\n 'name': None,\n 'description': link['name'],\n 'protocol': None,\n 'url': link['url']\n })\n\n if len(links) > 0:\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n\n if bbox is not None:\n try:\n tmp = '%s,%s,%s,%s' % (bbox.minx, bbox.miny, bbox.maxx, bbox.maxy)\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n except Exception:\n LOGGER.debug('Coordinates are corrupt')\n _set(context, recobj, 'pycsw:BoundingBox', None)\n else:\n _set(context, recobj, 'pycsw:BoundingBox', None)\n\n return recobj\n\ndef _parse_gm03(context, repos, exml):\n\n def get_value_by_language(pt_group, language, pt_type='text'):\n for ptg in pt_group:\n if ptg.language == language:\n if pt_type == 'url':\n val = ptg.plain_url\n else: # 'text'\n val = ptg.plain_text\n return val\n\n from owslib.gm03 import GM03\n\n recobj = repos.dataset()\n links = []\n\n md = GM03(exml)\n\n if hasattr(md.data, 'core'):\n data = md.data.core\n elif hasattr(md.data, 'comprehensive'):\n data = md.data.comprehensive\n\n language = data.metadata.language\n\n _set(context, recobj, 'pycsw:Identifier', data.metadata.file_identifier)\n _set(context, recobj, 'pycsw:Typename', 'gm03:TRANSFER')\n _set(context, recobj, 'pycsw:Schema', context.namespaces['gm03'])\n _set(context, recobj, 'pycsw:MdSource', 'local')\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:XML', md.xml)\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n _set(context, recobj, 'pycsw:AnyText', util.get_anytext(exml))\n _set(context, recobj, 'pycsw:Language', data.metadata.language)\n _set(context, recobj, 'pycsw:Type', data.metadata.hierarchy_level[0])\n _set(context, recobj, 'pycsw:Date', data.metadata.date_stamp)\n\n for dt in data.date:\n if dt.date_type == 'modified':\n _set(context, recobj, 'pycsw:Modified', dt.date)\n elif dt.date_type == 'creation':\n _set(context, recobj, 'pycsw:CreationDate', dt.date)\n elif dt.date_type == 'publication':\n _set(context, recobj, 'pycsw:PublicationDate', dt.date)\n elif dt.date_type == 'revision':\n _set(context, recobj, 'pycsw:RevisionDate', dt.date)\n\n if hasattr(data, 'metadata_point_of_contact'):\n _set(context, recobj, 'pycsw:ResponsiblePartyRole', data.metadata_point_of_contact.role)\n\n _set(context, recobj, 'pycsw:Source', data.metadata.dataset_uri)\n _set(context, recobj, 'pycsw:CRS','urn:ogc:def:crs:EPSG:6.11:4326')\n\n if hasattr(data, 'citation'):\n _set(context, recobj, 'pycsw:Title', get_value_by_language(data.citation.title.pt_group, language))\n\n if hasattr(data, 'data_identification'):\n _set(context, recobj, 'pycsw:Abstract', get_value_by_language(data.data_identification.abstract.pt_group, language))\n if hasattr(data.data_identification, 'topic_category'):\n _set(context, recobj, 'pycsw:TopicCategory', data.data_identification.topic_category)\n _set(context, recobj, 'pycsw:ResourceLanguage', data.data_identification.language)\n\n if hasattr(data, 'format'):\n _set(context, recobj, 'pycsw:Format', data.format.name)\n\n # bbox\n if hasattr(data, 'geographic_bounding_box'):\n try:\n tmp = '%s,%s,%s,%s' % (data.geographic_bounding_box.west_bound_longitude,\n data.geographic_bounding_box.south_bound_latitude,\n data.geographic_bounding_box.east_bound_longitude,\n data.geographic_bounding_box.north_bound_latitude)\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n except Exception:\n LOGGER.debug('Coordinates are corrupt')\n _set(context, recobj, 'pycsw:BoundingBox', None)\n else:\n _set(context, recobj, 'pycsw:BoundingBox', None)\n\n # temporal extent\n if hasattr(data, 'temporal_extent'):\n if data.temporal_extent.extent['begin'] is not None and data.temporal_extent.extent['end'] is not None:\n _set(context, recobj, 'pycsw:TempExtent_begin', data.temporal_extent.extent['begin'])\n _set(context, recobj, 'pycsw:TempExtent_end', data.temporal_extent.extent['end'])\n\n # online linkages\n name = description = protocol = ''\n\n if hasattr(data, 'online_resource'):\n if hasattr(data.online_resource, 'name'):\n name = get_value_by_language(data.online_resource.name.pt_group, language)\n if hasattr(data.online_resource, 'description'):\n description = get_value_by_language(data.online_resource.description.pt_group, language)\n linkage = get_value_by_language(data.online_resource.linkage.pt_group, language, 'url')\n\n links.append({\n 'name': name,\n 'description': description,\n 'protocol': protocol,\n 'url': linkage\n })\n\n if len(links) > 0:\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n\n keywords = []\n for kw in data.keywords:\n keywords.append(get_value_by_language(kw.keyword.pt_group, language))\n _set(context, recobj, 'pycsw:Keywords', ','.join(keywords))\n\n # contacts\n return recobj\n\ndef _parse_iso(context, repos, exml):\n \"\"\" Parses ISO 19139, ISO 19115p3 \"\"\"\n\n from owslib.iso import MD_ImageDescription, MD_Metadata, SV_ServiceIdentification\n from owslib.iso_che import CHE_MD_Metadata\n\n recobj = repos.dataset()\n bbox = None\n links = []\n mdmeta_ns = 'gmd'\n\n if exml.tag == '{http://www.geocat.ch/2008/che}CHE_MD_Metadata':\n md = CHE_MD_Metadata(exml)\n elif exml.tag == '{http://standards.iso.org/iso/19115/-3/mdb/2.0}MD_Metadata':\n from owslib.iso3 import MD_Metadata\n md = MD_Metadata(exml)\n mdmeta_ns = 'mdb'\n else:\n md = MD_Metadata(exml)\n\n md_identification = md.identification[0]\n\n _set(context, recobj, 'pycsw:Identifier', md.identifier)\n _set(context, recobj, 'pycsw:Typename', f'{mdmeta_ns}:MD_Metadata')\n _set(context, recobj, 'pycsw:Schema', context.namespaces['gmd'])\n _set(context, recobj, 'pycsw:MdSource', 'local')\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:XML', md.xml)\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n _set(context, recobj, 'pycsw:AnyText', util.get_anytext(exml))\n _set(context, recobj, 'pycsw:Language', md.language or md.languagecode)\n _set(context, recobj, 'pycsw:Type', md.hierarchy)\n _set(context, recobj, 'pycsw:ParentIdentifier', md.parentidentifier)\n _set(context, recobj, 'pycsw:Date', md.datestamp)\n _set(context, recobj, 'pycsw:Modified', md.datestamp)\n _set(context, recobj, 'pycsw:Source', md.dataseturi)\n\n if md.referencesystem is not None and md.referencesystem.code is not None:\n try:\n code_ = 'urn:ogc:def:crs:EPSG::%d' % int(md.referencesystem.code)\n except ValueError:\n code_ = md.referencesystem.code\n _set(context, recobj, 'pycsw:CRS', code_)\n\n if md_identification:\n _set(context, recobj, 'pycsw:Title', md_identification.title)\n _set(context, recobj, 'pycsw:Edition', md_identification.edition)\n _set(context, recobj, 'pycsw:AlternateTitle', md_identification.alternatetitle)\n _set(context, recobj, 'pycsw:Abstract', md_identification.abstract)\n _set(context, recobj, 'pycsw:Relation', md_identification.aggregationinfo)\n\n if hasattr(md_identification, 'temporalextent_start'):\n _set(context, recobj, 'pycsw:TempExtent_begin', md_identification.temporalextent_start)\n if hasattr(md_identification, 'temporalextent_end'):\n _set(context, recobj, 'pycsw:TempExtent_end', md_identification.temporalextent_end)\n\n if len(md_identification.topiccategory) > 0:\n _set(context, recobj, 'pycsw:TopicCategory', md_identification.topiccategory[0])\n\n if len(md_identification.resourcelanguage) > 0:\n _set(context, recobj, 'pycsw:ResourceLanguage', md_identification.resourcelanguage[0])\n elif len(md_identification.resourcelanguagecode) > 0:\n _set(context, recobj, 'pycsw:ResourceLanguage', md_identification.resourcelanguagecode[0])\n\n # Geographic bounding box\n if hasattr(md_identification, 'bbox'):\n bbox = md_identification.bbox\n else:\n bbox = None\n\n # Vertical extent of a bounding box\n if hasattr(md_identification, 'extent'):\n if hasattr(md_identification.extent, 'vertExtMin') and \\\n md_identification.extent.vertExtMin is not None:\n _set(context, recobj, 'pycsw:VertExtentMin', md_identification.extent.vertExtMin)\n if hasattr(md_identification.extent, 'vertExtMax') and \\\n md_identification.extent.vertExtMax is not None:\n _set(context, recobj, 'pycsw:VertExtentMax', md_identification.extent.vertExtMax)\n\n if (hasattr(md_identification, 'keywords') and\n len(md_identification.keywords) > 0):\n all_keywords = [item for sublist in md_identification.keywords for item in sublist.keywords if item is not None]\n _set(context, recobj, 'pycsw:Keywords', ','.join([\n k.name for k in all_keywords if hasattr(k,'name') and k.name not in [None,'']]))\n _set(context, recobj, 'pycsw:KeywordType', md_identification.keywords[0].type)\n _set(context, recobj, 'pycsw:Themes', \n json.dumps([t for t in md_identification.keywords if t.thesaurus is not None], \n default=lambda o: o.__dict__))\n\n # Creator\n if (hasattr(md_identification, 'creator') and\n len(md_identification.creator) > 0):\n all_orgs = set([item.organization for item in md_identification.creator if hasattr(item, 'organization') and item.organization is not None])\n _set(context, recobj, 'pycsw:Creator', ';'.join(all_orgs))\n # Publisher\n if (hasattr(md_identification, 'publisher') and\n len(md_identification.publisher) > 0):\n all_orgs = set([item.organization for item in md_identification.publisher if hasattr(item, 'organization') and item.organization is not None])\n _set(context, recobj, 'pycsw:Publisher', ';'.join(all_orgs))\n # Contributor\n if (hasattr(md_identification, 'contributor') and\n len(md_identification.contributor) > 0):\n all_orgs = set([item.organization for item in md_identification.contributor if hasattr(item, 'organization') and item.organization is not None])\n _set(context, recobj, 'pycsw:Contributor', ';'.join(all_orgs))\n\n if (hasattr(md_identification, 'contact') and\n len(md_identification.contact) > 0):\n all_orgs = set([item.organization for item in md_identification.contact if hasattr(item, 'organization') and item.organization is not None])\n _set(context, recobj, 'pycsw:OrganizationName', ';'.join(all_orgs))\n _set(context, recobj, 'pycsw:Contacts', json.dumps(md_identification.contact, default=lambda o: o.__dict__))\n\n if len(md_identification.securityconstraints) > 0:\n _set(context, recobj, 'pycsw:SecurityConstraints',\n md_identification.securityconstraints[0])\n if len(md_identification.accessconstraints) > 0:\n _set(context, recobj, 'pycsw:AccessConstraints',\n md_identification.accessconstraints[0])\n if len(md_identification.otherconstraints) > 0:\n _set(context, recobj, 'pycsw:OtherConstraints', md_identification.otherconstraints[0])\n\n if hasattr(md_identification, 'date'):\n for datenode in md_identification.date:\n if datenode.type == 'revision':\n _set(context, recobj, 'pycsw:RevisionDate', datenode.date)\n elif datenode.type == 'creation':\n _set(context, recobj, 'pycsw:CreationDate', datenode.date)\n elif datenode.type == 'publication':\n _set(context, recobj, 'pycsw:PublicationDate', datenode.date)\n\n if hasattr(md_identification, 'extent') and hasattr(md_identification.extent, 'description_code'):\n _set(context, recobj, 'pycsw:GeographicDescriptionCode', md_identification.extent.description_code)\n\n if len(md_identification.denominators) > 0:\n _set(context, recobj, 'pycsw:Denominator', md_identification.denominators[0])\n if len(md_identification.distance) > 0:\n _set(context, recobj, 'pycsw:DistanceValue', float(md_identification.distance[0]))\n if len(md_identification.uom) > 0:\n _set(context, recobj, 'pycsw:DistanceUOM', md_identification.uom[0])\n if len(md_identification.classification) > 0:\n _set(context, recobj, 'pycsw:Classification', md_identification.classification[0])\n if len(md_identification.uselimitation) > 0:\n _set(context, recobj, 'pycsw:ConditionApplyingToAccessAndUse',\n md_identification.uselimitation[0])\n\n service_types = []\n from owslib.iso import SV_ServiceIdentification\n for smd in md.identification:\n if isinstance(smd, SV_ServiceIdentification):\n service_types.append(smd.type)\n _set(context, recobj, 'pycsw:ServiceTypeVersion', smd.version)\n _set(context, recobj, 'pycsw:CouplingType', smd.couplingtype)\n\n _set(context, recobj, 'pycsw:ServiceType', ','.join(service_types))\n\n if hasattr(md_identification, 'dataquality'):\n _set(context, recobj, 'pycsw:Degree', md.dataquality.conformancedegree)\n _set(context, recobj, 'pycsw:Lineage', md.dataquality.lineage)\n _set(context, recobj, 'pycsw:SpecificationTitle', md.dataquality.specificationtitle)\n if hasattr(md.dataquality, 'specificationdate'):\n _set(context, recobj, 'pycsw:specificationDate',\n md.dataquality.specificationdate[0].date)\n _set(context, recobj, 'pycsw:SpecificationDateType',\n md.dataquality.specificationdate[0].datetype)\n\n if hasattr(md, 'contact') and len(md.contact) > 0:\n _set(context, recobj, 'pycsw:ResponsiblePartyRole', md.contact[0].role)\n\n if hasattr(md, 'contentinfo') and len(md.contentinfo) > 0:\n for ci in md.contentinfo:\n if isinstance(ci, MD_ImageDescription):\n _set(context, recobj, 'pycsw:CloudCover', float(ci.cloud_cover))\n _set(context, recobj, 'pycsw:IlluminationElevationAngle', ci.illumination_elevation_angle)\n\n keywords = _get(context, recobj, 'pycsw:Keywords')\n if ci.processing_level is not None:\n pl_keyword = 'eo:processingLevel:' + ci.processing_level\n if keywords is None:\n keywords = pl_keyword\n else:\n keywords += ',' + pl_keyword\n\n _set(context, recobj, 'pycsw:Keywords', keywords)\n\n bands = []\n for band in ci.bands:\n band_info = {\n 'id': band.id,\n 'units': band.units,\n 'min': band.min,\n 'max': band.max\n }\n bands.append(band_info)\n\n if len(bands) > 0:\n _set(context, recobj, 'pycsw:Bands', json.dumps(bands))\n\n if hasattr(md, 'acquisition') and md.acquisition is not None:\n platform = md.acquisition.platforms[0]\n _set(context, recobj, 'pycsw:Platform', platform.identifier)\n\n if platform.instruments:\n instrument = platform.instruments[0]\n _set(context, recobj, 'pycsw:Instrument', instrument.identifier)\n _set(context, recobj, 'pycsw:SensorType', instrument.type)\n\n all_formats = []\n if hasattr(md.distribution, 'format') and md.distribution.format is not None:\n all_formats.append(md.distribution.format)\n\n LOGGER.info('Scanning for links')\n if hasattr(md, 'distribution'):\n dist_links = []\n if hasattr(md.distribution, 'online'):\n LOGGER.debug(f'Scanning for {mdmeta_ns}:transferOptions element(s)')\n dist_links.extend(md.distribution.online)\n if hasattr(md.distribution, 'distributor'):\n LOGGER.debug(f'Scanning for {mdmeta_ns}:distributorTransferOptions element(s)')\n for dist_member in md.distribution.distributor:\n dist_links.extend(dist_member.online)\n for link in dist_links:\n if link.url is not None and link.protocol is None: # take a best guess\n link.protocol = sniff_link(link.url)\n if (link.protocol is not None and link.protocol not in all_formats):\n all_formats.append(link.protocol)\n links.append({\n 'name': link.name,\n 'description': link.description,\n 'protocol': link.protocol,\n 'url': link.url,\n 'function': link.function\n })\n\n _set(context, recobj, 'pycsw:Format', ','.join(all_formats))\n\n try:\n LOGGER.debug('Scanning for srv:SV_ServiceIdentification links')\n for sident in md.identification:\n if hasattr(sident, 'operations'):\n for sops in sident.operations:\n for scpt in sops['connectpoint']:\n LOGGER.debug('adding srv link %s', scpt.url)\n linkobj = {\n 'name': scpt.name,\n 'description': scpt.description,\n 'protocol': scpt.protocol,\n 'url': scpt.url\n }\n links.append(linkobj)\n except Exception: # srv: identification does not exist\n LOGGER.exception('no srv:SV_ServiceIdentification links found')\n\n if hasattr(md_identification, 'graphicoverview'):\n for thumb in md_identification.graphicoverview:\n links.append({\n 'name': 'preview',\n 'description': 'Web image thumbnail (URL)',\n 'protocol': 'WWW:LINK-1.0-http--image-thumbnail',\n 'url': thumb\n })\n\n if len(links) > 0:\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n\n if bbox is not None:\n try:\n tmp = '%s,%s,%s,%s' % (bbox.minx, bbox.miny, bbox.maxx, bbox.maxy)\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n except Exception:\n LOGGER.debug('Coordinates are corrupt')\n _set(context, recobj, 'pycsw:BoundingBox', None)\n else:\n _set(context, recobj, 'pycsw:BoundingBox', None)\n\n return recobj\n\n\ndef _parse_dc(context, repos, exml):\n\n from owslib.csw import CswRecord\n\n recobj = repos.dataset()\n links = []\n\n md = CswRecord(exml)\n\n if md.bbox is None:\n bbox = None\n else:\n bbox = md.bbox\n\n _set(context, recobj, 'pycsw:Identifier', md.identifier)\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', context.namespaces['csw'])\n _set(context, recobj, 'pycsw:MdSource', 'local')\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:XML', md.xml)\n _set(context, recobj, 'pycsw:MetadataType', 'application/xml')\n _set(context, recobj, 'pycsw:AnyText', util.get_anytext(exml))\n _set(context, recobj, 'pycsw:Language', md.language)\n _set(context, recobj, 'pycsw:Type', md.type)\n _set(context, recobj, 'pycsw:Title', md.title)\n _set(context, recobj, 'pycsw:AlternateTitle', md.alternative)\n _set(context, recobj, 'pycsw:Abstract', md.abstract)\n\n if md.subjects is not None and len(md.subjects) > 0 and None not in md.subjects:\n _set(context, recobj, 'pycsw:Keywords', ','.join(md.subjects))\n\n _set(context, recobj, 'pycsw:ParentIdentifier', md.ispartof)\n _set(context, recobj, 'pycsw:Relation', md.relation)\n _set(context, recobj, 'pycsw:TempExtent_begin', md.temporal)\n _set(context, recobj, 'pycsw:TempExtent_end', md.temporal)\n _set(context, recobj, 'pycsw:ResourceLanguage', md.language)\n _set(context, recobj, 'pycsw:Creator', md.creator)\n _set(context, recobj, 'pycsw:Publisher', md.publisher)\n _set(context, recobj, 'pycsw:Contributor', md.contributor)\n _set(context, recobj, 'pycsw:OrganizationName', md.rightsholder)\n if md.rights is not None and len(md.rights) > 0 and None not in md.rights:\n _set(context, recobj, 'pycsw:ConditionApplyingToAccessAndUse', ','.join(md.rights))\n _set(context, recobj, 'pycsw:AccessConstraints', md.accessrights)\n _set(context, recobj, 'pycsw:OtherConstraints', md.license)\n _set(context, recobj, 'pycsw:Date', md.date)\n _set(context, recobj, 'pycsw:CreationDate', md.created)\n _set(context, recobj, 'pycsw:PublicationDate', md.issued)\n _set(context, recobj, 'pycsw:Modified', md.modified)\n _set(context, recobj, 'pycsw:Format', md.format)\n _set(context, recobj, 'pycsw:Source', md.source)\n\n for ref in md.references:\n links.append({\n 'name': None,\n 'description': None,\n 'protocol': ref['scheme'],\n 'url': ref['url'],\n })\n for uri in md.uris:\n links.append({\n 'name': uri['name'],\n 'description': uri['description'],\n 'protocol': uri['protocol'],\n 'url': uri['url'],\n })\n\n if len(links) > 0:\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n\n if bbox is not None:\n try:\n tmp = '%s,%s,%s,%s' % (bbox.minx, bbox.miny, bbox.maxx, bbox.maxy)\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(tmp))\n except Exception:\n LOGGER.debug('Coordinates are corrupt')\n _set(context, recobj, 'pycsw:BoundingBox', None)\n else:\n _set(context, recobj, 'pycsw:BoundingBox', None)\n\n return recobj\n\n\ndef _parse_json_record(context, repos, record):\n \"\"\"Parse JSON record\"\"\"\n\n recobj = None\n\n if 'conformsTo' in record:\n LOGGER.debug('Parsing OGC API - Records record model')\n recobj = _parse_oarec_record(context, repos, record)\n elif 'stac_version' in record:\n LOGGER.debug('Parsing STAC resource')\n recobj = _parse_stac_resource(context, repos, record)\n\n if recobj is None:\n raise RuntimeError('Unsupported JSON metadata format')\n\n atom_xml = atom.write_record(recobj, 'full', context)\n\n _set(context, recobj, 'pycsw:XML', etree.tostring(atom_xml))\n\n return recobj\n\n\ndef _parse_oarec_record(context, repos, record):\n \"\"\"Parse OARec record\"\"\"\n\n conformance = 'http://www.opengis.net/spec/ogcapi-records-1/1.0/req/record-core'\n\n recobj = repos.dataset()\n keywords = []\n links = []\n\n _set(context, recobj, 'pycsw:Identifier', record['id'])\n _set(context, recobj, 'pycsw:Typename', 'csw:Record')\n _set(context, recobj, 'pycsw:Schema', conformance)\n _set(context, recobj, 'pycsw:MdSource', 'local')\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:XML', '') # FIXME: transform into XML? or not, to validate\n _set(context, recobj, 'pycsw:Metadata', json.dumps(record))\n _set(context, recobj, 'pycsw:MetadataType', 'application/geo+json')\n\n _set(context, recobj, 'pycsw:AnyText', ' '.join([str(t) for t in util.get_anytext_from_obj(record)]))\n\n language = record['properties'].get('language')\n if language is not None and isinstance(language, dict):\n _set(context, recobj, 'pycsw:Language', language.get('code'))\n\n _set(context, recobj, 'pycsw:Type', record['properties']['type'])\n _set(context, recobj, 'pycsw:Title', record['properties']['title'])\n _set(context, recobj, 'pycsw:Abstract', record['properties'].get('description'))\n\n if 'keywords' in record['properties']:\n keywords = record['properties']['keywords']\n _set(context, recobj, 'pycsw:Keywords', ','.join(keywords))\n\n if 'themes' in record['properties']:\n _set(context, recobj, 'pycsw:Themes', json.dumps(record['properties']['themes']))\n\n if 'links' in record:\n for link in record['links']:\n new_link = {\n 'url': link.get('href')\n }\n\n if link.get('title') is not None:\n new_link['name'] = link.get('title')\n new_link['description'] = link.get('title')\n if link.get('description') is not None:\n new_link['description'] = link.get('description')\n if link.get('type') is not None:\n new_link['protocol'] = link.get('type')\n if link.get('rel') is not None:\n new_link['function'] = link.get('rel')\n\n links.append(new_link)\n\n if links:\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n\n if record.get('geometry') is not None:\n _set(context, recobj, 'pycsw:BoundingBox', util.bbox2wktpolygon(util.geojson_geometry2bbox(record['geometry'])))\n\n if 'temporal' in record['properties'].get('extent', []):\n _set(context, recobj, 'pycsw:TempExtent_begin', record['properties']['extent']['temporal']['interval'][0])\n _set(context, recobj, 'pycsw:TempExtent_end', record['properties']['extent']['temporal']['interval'][1])\n\n return recobj\n\n\ndef _parse_stac_resource(context, repos, record):\n \"\"\"Parse STAC resource\"\"\"\n\n recobj = repos.dataset()\n keywords = []\n links = []\n bbox_wkt = None\n\n stac_type = record.get('type', 'Feature')\n if stac_type == 'Feature':\n LOGGER.debug('Parsing STAC Item')\n conformance = 'https://github.com/radiantearth/stac-spec/tree/master/item-spec/item-spec.md'\n typename = 'stac:Item'\n metadata_type = 'application/geo+json'\n stype = 'item'\n title = record['properties'].get('title')\n abstract = record['properties'].get('description')\n _set(context, recobj, 'pycsw:CreationDate', record['properties'].get('created'))\n _set(context, recobj, 'pycsw:Modified', record['properties'].get('updated'))\n _set(context, recobj, 'pycsw:Platform', record['properties'].get('platform'))\n _set(context, recobj, 'pycsw:OtherConstraints', record['properties'].get('license'))\n instruments = record['properties'].get('instruments')\n if instruments is not None:\n _set(context, recobj, 'pycsw:Instrument', ','.join(instruments))\n if record['properties'].get('gsd') is not None:\n _set(context, recobj, 'pycsw:DistanceValue', float(record['properties']['gsd']))\n _set(context, recobj, 'pycsw:DistanceUOM', 'm')\n if record.get('geometry') is not None:\n bbox_wkt = util.bbox2wktpolygon(util.geojson_geometry2bbox(record['geometry']))\n elif stac_type == 'Collection':\n LOGGER.debug('Parsing STAC Collection')\n conformance = 'https://github.com/radiantearth/stac-spec/tree/master/collection-spec/collection-spec.md'\n typename = 'stac:Collection'\n metadata_type = 'application/json'\n stype = 'collection'\n title = record.get('title')\n abstract = record.get('description')\n _set(context, recobj, 'pycsw:CreationDate', record.get('created'))\n _set(context, recobj, 'pycsw:Modified', record.get('updated'))\n _set(context, recobj, 'pycsw:Platform', record.get('platform'))\n _set(context, recobj, 'pycsw:OtherConstraints', record.get('license'))\n instruments = record.get('instruments')\n if instruments is not None:\n _set(context, recobj, 'pycsw:Instrument', ','.join(instruments))\n if record.get('gsd') is not None:\n _set(context, recobj, 'pycsw:DistanceValue', float(record['gsd']))\n _set(context, recobj, 'pycsw:DistanceUOM', 'm')\n if 'extent' in record and 'spatial' in record['extent']:\n bbox_csv = ','.join(str(t) for t in record['extent']['spatial']['bbox'][0])\n bbox_wkt = util.bbox2wktpolygon(bbox_csv)\n if 'extent' in record and 'temporal' in record['extent'] and 'interval' in record['extent']['temporal']:\n _set(context, recobj, 'pycsw:TempExtent_begin', record['extent']['temporal']['interval'][0][0])\n _set(context, recobj, 'pycsw:TempExtent_end', record['extent']['temporal']['interval'][0][1])\n elif stac_type == 'Catalog':\n LOGGER.debug('Parsing STAC Catalog')\n conformance = 'https://github.com/radiantearth/stac-spec/tree/master/catalog-spec/catalog-spec.md'\n typename = 'stac:Catalog'\n metadata_type = 'application/json'\n stype = 'catalog'\n title = record.get('title')\n abstract = record.get('description')\n _set(context, recobj, 'pycsw:CreationDate', record.get('created'))\n _set(context, recobj, 'pycsw:Modified', record.get('updated'))\n _set(context, recobj, 'pycsw:Platform', record.get('platform'))\n _set(context, recobj, 'pycsw:OtherConstraints', record.get('license'))\n instruments = record.get('instruments')\n if instruments is not None:\n _set(context, recobj, 'pycsw:Instrument', ','.join(instruments))\n\n _set(context, recobj, 'pycsw:Identifier', record['id'])\n _set(context, recobj, 'pycsw:Typename', typename)\n _set(context, recobj, 'pycsw:Schema', conformance)\n _set(context, recobj, 'pycsw:MdSource', 'local')\n _set(context, recobj, 'pycsw:InsertDate', util.get_today_and_now())\n _set(context, recobj, 'pycsw:XML', '') # FIXME: transform into XML? or not, to validate\n _set(context, recobj, 'pycsw:Metadata', json.dumps(record))\n _set(context, recobj, 'pycsw:MetadataType', metadata_type)\n _set(context, recobj, 'pycsw:AnyText', ' '.join([str(t) for t in util.get_anytext_from_obj(record)]))\n _set(context, recobj, 'pycsw:Type', stype)\n _set(context, recobj, 'pycsw:Title', title)\n _set(context, recobj, 'pycsw:Abstract', abstract)\n _set(context, recobj, 'pycsw:BoundingBox', bbox_wkt)\n\n if 'links' in record:\n for link in record['links']:\n new_link = {\n 'url': link.get('href')\n }\n\n if link.get('title') is not None:\n new_link['name'] = link.get('title')\n new_link['description'] = link.get('title')\n if link.get('description') is not None:\n new_link['description'] = link.get('description')\n if link.get('type') is not None:\n new_link['protocol'] = link.get('type')\n if link.get('rel') is not None:\n new_link['function'] = link.get('rel')\n\n links.append(new_link)\n\n if 'assets' in record:\n for key, link in record['assets'].items():\n new_link = {\n 'url': link.get('href')\n }\n\n if link.get('title') is not None:\n new_link['name'] = key\n new_link['description'] = link.get('title')\n if link.get('type') is not None:\n new_link['protocol'] = link.get('type')\n if link.get('rel') is not None:\n new_link['function'] = link.get('rel')\n else:\n new_link['function'] = 'enclosure'\n\n links.append(new_link)\n\n if links:\n _set(context, recobj, 'pycsw:Links', json.dumps(links))\n\n if stac_type == 'Feature':\n if 'keywords' in record['properties']:\n keywords = record['properties']['keywords']\n _set(context, recobj, 'pycsw:Keywords', ','.join(keywords))\n\n if 'start_datetime' in record['properties']:\n _set(context, recobj, 'pycsw:TempExtent_begin', record['properties']['start_datetime'])\n\n if 'end_datetime' in record['properties']:\n _set(context, recobj, 'pycsw:TempExtent_end', record['properties']['end_datetime'])\n\n if 'datetime' in record['properties']:\n _set(context, recobj, 'pycsw:Date', record['properties']['datetime'])\n if 'start_datetime' not in record['properties'] and 'end_datetime' not in record['properties']:\n _set(context, recobj, 'pycsw:TempExtent_begin', record['properties']['datetime'])\n _set(context, recobj, 'pycsw:TempExtent_end', record['properties']['datetime'])\n\n if 'eo:cloud_cover' in record['properties']:\n _set(context, recobj, 'pycsw:CloudCover', float(record['properties']['eo:cloud_cover']))\n\n if 'processing:lineage' in record['properties']:\n _set(context, recobj, 'pycsw:Lineage', record['properties']['processing:lineage'])\n\n if 'collection' in record:\n _set(context, recobj, 'pycsw:ParentIdentifier', record['collection'])\n\n _set(context, recobj, 'pycsw:IlluminationElevationAngle', record['properties'].get('view:off_nadir'))\n\n if stac_type in ['Collection', 'Catalog']:\n if 'keywords' in record:\n keywords = record['keywords']\n _set(context, recobj, 'pycsw:Keywords', ','.join(keywords))\n\n if 'start_datetime' in record:\n _set(context, recobj, 'pycsw:TempExtent_begin', record['start_datetime'])\n\n if 'end_datetime' in record:\n _set(context, recobj, 'pycsw:TempExtent_end', record['end_datetime'])\n\n if 'datetime' in record:\n _set(context, recobj, 'pycsw:Date', record['datetime'])\n if 'start_datetime' not in record and 'end_datetime' not in record:\n _set(context, recobj, 'pycsw:TempExtent_begin', record['datetime'])\n _set(context, recobj, 'pycsw:TempExtent_end', record['datetime'])\n\n return recobj\n\n\ndef fgdccontact2iso(cnt, role='pointOfContact'):\n \"\"\"Creates a iso format contact (owslib style) from fgdc format\"\"\"\n\n return {\n 'name': cnt.cntper,\n 'organization': cnt.cntorg,\n 'position': cnt.cntpos,\n 'phone': cnt.voice,\n 'address': cnt.address,\n 'city': cnt.city,\n 'region': cnt.state,\n 'postcode': cnt.postal,\n 'country': cnt.country,\n 'email': cnt.email,\n 'role': role\n }\n\n\ndef caps2iso(record, caps, context):\n \"\"\"Creates ISO metadata from Capabilities XML\"\"\"\n\n from pycsw.plugins.profiles.apiso.apiso import APISO\n\n apiso_obj = APISO(context.model, context.namespaces, context)\n apiso_obj.ogc_schemas_base = 'http://schemas.opengis.net'\n apiso_obj.url = context.url\n queryables = dict(apiso_obj.repository['queryables']['SupportedISOQueryables'].items())\n iso_xml = apiso_obj.write_record(record, 'full', 'http://www.isotc211.org/2005/gmd', queryables, caps)\n return etree.tostring(iso_xml)\n\n\ndef bbox_from_polygons(bboxs):\n \"\"\"Derive an aggregated bbox from n polygons\n\n Parameters\n ----------\n bboxs: list\n A sequence of strings containing Well-Known Text representations of\n polygons\n\n Returns\n -------\n str\n Well-Known Text representation of the aggregated bounding box for\n all the input polygons\n \"\"\"\n\n try:\n multi_pol = MultiPolygon(\n [loads(bbox) for bbox in bboxs]\n )\n bstr = \",\".join([f\"{b:.2f}\" for b in multi_pol.bounds])\n return util.bbox2wktpolygon(bstr)\n except Exception as err:\n raise RuntimeError('Cannot aggregate polygons: %s' % str(err)) from err\n"
},
{
"path": "pycsw/core/pygeofilter_evaluate.py",
"content": "# =================================================================\n#\n# Authors: Tom Kralidis \n#\n# Copyright (c) 2021 Tom Kralidis\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport logging\n\nfrom shapely import box\nfrom shapely.geometry import shape\nfrom sqlalchemy import text\n\nfrom pygeofilter import ast\nfrom pygeofilter.values import Envelope\nfrom pygeofilter.backends.evaluator import handle\nfrom pygeofilter.backends.sqlalchemy import filters\nfrom pygeofilter.backends.sqlalchemy.evaluate import SQLAlchemyFilterEvaluator\n\nfrom pycsw.core.util import bbox2wktpolygon\n\nLOGGER = logging.getLogger(__name__)\n\n\nclass PycswFilterEvaluator(SQLAlchemyFilterEvaluator):\n def __init__(self, field_mapping=None, dbtype='sqlite',\n undefined_as_null=None):\n super().__init__(field_mapping, undefined_as_null=undefined_as_null)\n self._pycsw_dbtype = dbtype\n\n @handle(ast.GeometryIntersects)\n def intersects(self, node, lhs, rhs):\n LOGGER.debug('Overriding INTERSECT filter handling')\n geometry = self.field_mapping['bbox'].key\n try:\n crs = node.crs\n except AttributeError:\n crs = 4326\n\n if isinstance(node.rhs, Envelope):\n wkt = box(node.rhs.x1, node.rhs.x2,\n node.rhs.y1, node.rhs.y2, ccw=False).wkt\n else:\n wkt = shape(node.rhs.geometry).wkt\n\n if self._pycsw_dbtype == 'postgresql+postgis+native':\n return text(f\"ST_Intersects({geometry}, 'SRID={crs};{wkt}')\")\n else:\n return text(f\"query_spatial({geometry}, '{wkt}', 'intersects', 'false') = 'true'\") # noqa\n\n @handle(ast.BBox)\n def bbox(self, node, lhs):\n LOGGER.debug('Overriding BBOX filter handling')\n geometry = self.field_mapping['bbox'].key\n crs = node.crs or 4326\n\n bbox_string = f'{node.minx},{node.miny},{node.maxx},{node.maxy}'\n wkt = bbox2wktpolygon(bbox_string)\n\n if self._pycsw_dbtype == 'postgresql+postgis+native':\n return text(f\"ST_Intersects({geometry}, 'SRID={crs};{wkt}')\")\n else:\n return text(f\"query_spatial({geometry}, '{wkt}', 'bbox', 'false') = 'true'\") # noqa\n\n @handle(ast.Equal)\n def equal(self, node, lhs, rhs):\n list_props = [\n 'dataset.keywords',\n 'dataset.instrument'\n ]\n\n if str(lhs.prop) in list_props:\n LOGGER.debug(f'Overriding {lhs.prop} \"=\" with \"ilike\"')\n node.pattern = f'%{rhs}%'\n node.nocase = False\n node.not_ = False\n\n return self.ilike(node, lhs)\n\n return filters.runop(lhs, rhs, '=')\n\n @handle(ast.Like)\n def ilike(self, node, lhs):\n LOGGER.debug('Overriding ILIKE filter handling')\n LOGGER.debug(f'Term: {node.pattern}')\n if (str(lhs.prop) == 'dataset.anytext' and\n self._pycsw_dbtype.startswith('postgres')):\n if '%' not in node.pattern:\n LOGGER.debug('Kicking into PostgreSQL FTS mode')\n return text(f\"plainto_tsquery('english', '{node.pattern}') @@ anytext_tsvector\") # noqa\n\n LOGGER.debug('Default ILIKE behaviour')\n return filters.like(\n lhs,\n node.pattern,\n not node.nocase,\n node.not_\n )\n\n\ndef to_filter(ast, dbtype, field_mapping=None):\n return PycswFilterEvaluator(field_mapping, dbtype).evaluate(ast)\n"
},
{
"path": "pycsw/core/repository.py",
"content": "# -*- coding: utf-8 -*-\n# =================================================================\n#\n# Authors: Tom Kralidis \n# Angelos Tzotsos \n# Ricardo Garcia Silva \n#\n# Copyright (c) 2024 Tom Kralidis\n# Copyright (c) 2015 Angelos Tzotsos\n# Copyright (c) 2017 Ricardo Garcia Silva\n#\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation\n# files (the \"Software\"), to deal in the Software without\n# restriction, including without limitation the rights to use,\n# copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the\n# Software is furnished to do so, subject to the following\n# conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n# OTHER DEALINGS IN THE SOFTWARE.\n#\n# =================================================================\n\nimport inspect\nimport logging\nimport os\nfrom time import sleep\n\nfrom shapely.wkt import loads\nfrom shapely.errors import ShapelyError\n\nfrom sqlalchemy import create_engine, func, __version__, select\nfrom sqlalchemy.exc import OperationalError\nfrom sqlalchemy.sql import text\nfrom sqlalchemy.ext.declarative import declarative_base\nfrom sqlalchemy.orm import create_session\n\nfrom pycsw.core import util\nfrom pycsw.core.etree import etree\nfrom pycsw.core.etree import PARSER\n\nLOGGER = logging.getLogger(__name__)\n\n\nclass Repository(object):\n _engines = {}\n\n @classmethod\n def create_engine(clazz, url):\n '''\n SQL Alchemy engines are thread-safe and simple wrappers for connection pools\n\n https://groups.google.com/forum/#!topic/sqlalchemy/t8i3RSKZGb0\n\n To reduce startup time we can cache the engine as a class variable in the\n repository object and do database initialization once\n\n Engines are memoized by url\n '''\n if url not in clazz._engines:\n LOGGER.info('creating new engine: %s', util.sanitize_db_connect(url))\n engine = create_engine('%s' % url, echo=False, pool_pre_ping=True)\n\n # load SQLite query bindings\n # This can be directly bound via events\n # for sqlite < 0.7, we need to to this on a per-connection basis\n if engine.name in ['sqlite', 'sqlite3'] and __version__ >= '0.7':\n from sqlalchemy import event\n\n @event.listens_for(engine, \"connect\")\n def connect(dbapi_connection, connection_rec):\n create_custom_sql_functions(dbapi_connection)\n\n clazz._engines[url] = engine\n\n return clazz._engines[url]\n\n ''' Class to interact with underlying repository '''\n def __init__(self, database, context, app_root=None, table='records', repo_filter=None, stable_sort = False):\n ''' Initialize repository '''\n\n self.context = context\n self.filter = repo_filter\n self.stable_sort = stable_sort\n self.fts = False\n self.database = database\n self.table = table\n\n # Don't use relative paths, this is hack to get around\n # most wsgi restriction...\n if (app_root and self.database.startswith('sqlite:///') and\n not self.database.startswith('sqlite:////')):\n self.database = self.database.replace('sqlite:///', 'sqlite:///%s%s' % (app_root, os.sep))\n\n self.engine = Repository.create_engine('%s' % self.database)\n\n base = declarative_base(bind=self.engine)\n\n LOGGER.info('binding ORM to existing database')\n\n self.postgis_geometry_column = None\n\n schema_name, table_name = table.rpartition(\".\")[::2]\n\n default_table_args = {\n \"autoload\": True,\n \"schema\": schema_name or None\n }\n column_constraints = context.md_core_model.get(\"column_constraints\")\n\n # Note: according to the sqlalchemy docs available here:\n #\n # https://docs.sqlalchemy.org/en/14/orm/declarative_tables.html#declarative-table-configuration\n #\n # the __table_args__ attribute can either be a tuple or a dict\n if column_constraints is not None:\n table_args = tuple((*column_constraints, default_table_args))\n else:\n table_args = default_table_args\n\n self.dataset = type(\n 'dataset',\n (base,),\n {\n \"__tablename__\": table_name,\n \"__table_args__\": table_args\n }\n )\n\n self.dbtype = self.engine.name\n\n self.session = create_session(self.engine)\n self.func = func\n\n temp_dbtype = None\n\n self.query_mappings = {\n 'identifier': self.dataset.identifier,\n 'type': self.dataset.type,\n 'typename': self.dataset.typename,\n 'parentidentifier': self.dataset.parentidentifier,\n 'collections': self.dataset.parentidentifier,\n 'updated': self.dataset.insert_date,\n 'title': self.dataset.title,\n 'description': self.dataset.abstract,\n 'keywords': self.dataset.keywords,\n 'edition': self.dataset.edition,\n 'anytext': self.dataset.anytext,\n 'bbox': self.dataset.wkt_geometry,\n 'date': self.dataset.date,\n 'date_creation': self.dataset.date_creation,\n 'date_modified': self.dataset.date_modified,\n 'datetime': self.dataset.date,\n 'time_begin': self.dataset.time_begin,\n 'time_end': self.dataset.time_end,\n 'platform': self.dataset.platform,\n 'cloudcover': self.dataset.cloudcover,\n 'instrument': self.dataset.instrument,\n 'sensortype': self.dataset.sensortype,\n 'off_nadir': self.dataset.illuminationelevationangle,\n 'distancevalue': self.dataset.distancevalue,\n 'otherconstraints': self.dataset.otherconstraints\n }\n\n if self.dbtype == 'postgresql':\n # check if PostgreSQL is enabled with PostGIS 1.x\n try:\n self.session.execute(select([func.postgis_version()]))\n temp_dbtype = 'postgresql+postgis+wkt'\n LOGGER.debug('PostgreSQL+PostGIS1+WKT detected')\n except Exception:\n LOGGER.exception('PostgreSQL+PostGIS1+WKT detection failed')\n\n # check if PostgreSQL is enabled with PostGIS 2.x\n try:\n self.session.execute('select(postgis_version())')\n temp_dbtype = 'postgresql+postgis+wkt'\n LOGGER.debug('PostgreSQL+PostGIS2+WKT detected')\n except Exception:\n LOGGER.exception('PostgreSQL+PostGIS2+WKT detection failed')\n\n # check if a native PostGIS geometry column exists\n try:\n result = self.session.execute(\n \"select f_geometry_column \"\n \"from geometry_columns \"\n \"where f_table_name = '%s' \"\n \"and f_geometry_column != 'wkt_geometry' \"\n \"limit 1;\" % table_name\n )\n row = result.fetchone()\n self.postgis_geometry_column = str(row['f_geometry_column'])\n temp_dbtype = 'postgresql+postgis+native'\n LOGGER.debug('PostgreSQL+PostGIS+Native detected')\n except Exception:\n LOGGER.exception('PostgreSQL+PostGIS+Native not picked up: %s', table_name)\n\n # check if a native PostgreSQL FTS GIN index exists\n result = self.session.execute(\"select relname from pg_class where relname='fts_gin_idx'\").scalar()\n self.fts = bool(result)\n LOGGER.debug('PostgreSQL FTS enabled: %r', self.fts)\n\n if temp_dbtype is not None:\n LOGGER.debug('%s support detected', temp_dbtype)\n self.dbtype = temp_dbtype\n\n if self.dbtype == 'postgresql+postgis+native':\n LOGGER.debug('Adjusting to PostGIS geometry column (wkb_geometry)')\n self.query_mappings['bbox'] = self.dataset.wkb_geometry\n self.query_mappings['geometry'] = self.dataset.wkb_geometry\n\n if self.dbtype in ['sqlite', 'sqlite3']: # load SQLite query bindings\n # <= 0.6 behaviour\n if not __version__ >= '0.7':\n self.connection = self.engine.raw_connection()\n create_custom_sql_functions(self.connection)\n\n LOGGER.info('setting repository queryables')\n # generate core queryables db and obj bindings\n self.queryables = {}\n for tname in self.context.model['typenames']:\n for qname in self.context.model['typenames'][tname]['queryables']:\n self.queryables[qname] = {}\n\n for qkey, qvalue in \\\n self.context.model['typenames'][tname]['queryables'][qname].items():\n self.queryables[qname][qkey] = qvalue\n\n # flatten all queryables\n # TODO smarter way of doing this\n self.queryables['_all'] = {}\n for qbl in self.queryables:\n if qbl != '_all':\n self.queryables['_all'].update(self.queryables[qbl])\n\n self.queryables['_all'].update(self.context.md_core_model['mappings'])\n\n def ping(self, max_tries=10, wait_seconds=10):\n LOGGER.debug(f\"Waiting for {util.sanitize_db_connect(self.database)}...\")\n\n if self.database.startswith('sqlite'):\n sql = 'SELECT sqlite_version();'\n else:\n sql = 'SELECT version();'\n\n engine = create_engine(self.database)\n current_try = 0\n while current_try < max_tries:\n try:\n engine.execute(sql)\n LOGGER.debug(\"Database is already up!\")\n break\n except OperationalError as err:\n LOGGER.debug(f\"Database not responding yet {err}\")\n current_try += 1\n sleep(wait_seconds)\n else:\n raise RuntimeError(\n f\"Database not responding at {util.sanitize_db_connect(self.database)} after {max_tries} tries. \")\n\n def rebuild_db_indexes(self):\n \"\"\"Rebuild database indexes\"\"\"\n\n LOGGER.info('Rebuilding database %s, table %s', util.sanitize_db_connect(self.database), self.table)\n connection = self.engine.connect()\n connection.autocommit = True\n connection.execute('REINDEX %s' % self.table)\n connection.close()\n LOGGER.info('Done')\n\n def optimize_db(self):\n \"\"\"Optimize database\"\"\"\n from sqlalchemy.exc import ArgumentError, OperationalError\n\n LOGGER.info('Optimizing database %s', util.sanitize_db_connect(self.database))\n connection = self.engine.connect()\n try:\n # PostgreSQL\n connection.execution_options(isolation_level=\"AUTOCOMMIT\")\n connection.execute('VACUUM ANALYZE')\n except (ArgumentError, OperationalError):\n # SQLite\n connection.autocommit = True\n connection.execute('VACUUM')\n connection.execute('ANALYZE')\n finally:\n connection.close()\n LOGGER.info('Done')\n\n def _create_values(self, values):\n value_dict = {}\n for num, value in enumerate(values):\n value_dict['pvalue%d' % num] = value\n return value_dict\n\n def describe(self):\n ''' Derive table columns and types '''\n\n type_mappings = {\n 'TEXT': 'string',\n 'VARCHAR': 'string',\n 'FLOAT': 'number'\n }\n\n properties = {\n 'geometry': {\n '$ref': 'https://geojson.org/schema/Polygon.json',\n 'x-ogc-role': 'primary-geometry'\n }\n }\n\n for i in self.dataset.__table__.columns:\n if i.name in ['anytext', 'metadata', 'metadata_type', 'xml']:\n continue\n\n properties[i.name] = {\n 'title': i.name\n }\n\n if i.name == 'identifier':\n properties[i.name]['x-ogc-role'] = 'id'\n\n try:\n properties[i.name]['type'] = type_mappings[str(i.type)]\n except Exception as err:\n LOGGER.debug(f'Cannot determine type: {err}')\n\n return properties\n\n def query_ids(self, ids):\n ''' Query by list of identifiers '''\n\n column = getattr(self.dataset,\n self.context.md_core_model['mappings']['pycsw:Identifier'])\n\n query = self.session.query(self.dataset).filter(column.in_(ids))\n return self._get_repo_filter(query).all()\n\n def query_collections(self, filters=None, limit=10):\n ''' Query for parent collections '''\n\n column = getattr(self.dataset,\n self.context.md_core_model['mappings']['pycsw:ParentIdentifier'])\n\n collections = self.session.query(column).distinct()\n\n results = self._get_repo_filter(collections).all()\n\n ids = [res[0] for res in results if res[0] is not None]\n\n column = getattr(self.dataset,\n self.context.md_core_model['mappings']['pycsw:Identifier'])\n\n query = self.session.query(self.dataset).filter(column.in_(ids))\n\n collection_typenames = [\n 'stac:Collection'\n ]\n\n column = getattr(self.dataset,\n self.context.md_core_model['mappings']['pycsw:Typename'])\n\n query2 = self.session.query(self.dataset).filter(column.in_(collection_typenames))\n\n if filters is not None:\n LOGGER.debug('Querying repository with additional filters')\n return list(set(self._get_repo_filter(query).filter(filters).limit(limit).all()) |\n set(self._get_repo_filter(query2).filter(filters).limit(limit).all()))\n\n return list(set(self._get_repo_filter(query).limit(limit).all()) |\n set(self._get_repo_filter(query2).limit(limit).all()))\n\n def query_domain(self, domain, typenames, domainquerytype='list',\n count=False):\n ''' Query by property domain values '''\n\n domain_value = getattr(self.dataset, domain)\n\n if domainquerytype == 'range':\n LOGGER.info('Generating property name range values')\n query = self.session.query(func.min(domain_value),\n func.max(domain_value))\n else:\n if count:\n LOGGER.info('Generating property name frequency counts')\n query = self.session.query(getattr(self.dataset, domain),\n func.count(domain_value)).group_by(domain_value)\n else:\n query = self.session.query(domain_value).distinct()\n return self._get_repo_filter(query).all()\n\n def query_insert(self, direction='max'):\n ''' Query to get latest (default) or earliest update to repository '''\n column = getattr(self.dataset,\n self.context.md_core_model['mappings']['pycsw:InsertDate'])\n\n if direction == 'min':\n return self._get_repo_filter(self.session.query(func.min(column))).first()[0]\n # else default max\n return self._get_repo_filter(self.session.query(func.max(column))).first()[0]\n\n def query_source(self, source):\n ''' Query by source '''\n column = getattr(self.dataset,\n self.context.md_core_model['mappings']['pycsw:Source'])\n\n query = self.session.query(self.dataset).filter(column == source)\n return self._get_repo_filter(query).all()\n\n def query(self, constraint, sortby=None, typenames=None,\n maxrecords=10, startposition=0):\n ''' Query records from underlying repository '''\n\n # run the raw query and get total\n if 'where' in constraint: # GetRecords with constraint\n LOGGER.debug('constraint detected')\n query = self.session.query(self.dataset).filter(\n text(constraint['where'])).params(self._create_values(constraint['values']))\n else: # GetRecords sans constraint\n LOGGER.debug('No constraint detected')\n query = self.session.query(self.dataset)\n\n total = self._get_repo_filter(query).count()\n\n if util.ranking_pass: # apply spatial ranking\n # TODO: Check here for dbtype so to extract wkt from postgis native to wkt\n LOGGER.debug('spatial ranking detected')\n LOGGER.debug('Target WKT: %s', getattr(self.dataset, self.context.md_core_model['mappings']['pycsw:BoundingBox']))\n LOGGER.debug('Query WKT: %s', util.ranking_query_geometry)\n query = query.order_by(func.get_spatial_overlay_rank(getattr(self.dataset, self.context.md_core_model['mappings']['pycsw:BoundingBox']), util.ranking_query_geometry).desc())\n # trying to make this wsgi safe\n util.ranking_pass = False\n util.ranking_query_geometry = ''\n\n if sortby is not None: # apply sorting\n LOGGER.debug('sorting detected')\n # TODO: Check here for dbtype so to extract wkt from postgis native to wkt\n sortby_column = getattr(self.dataset, sortby['propertyname'])\n\n if sortby['order'] == 'DESC': # descending sort\n if 'spatial' in sortby and sortby['spatial']: # spatial sort\n query = query.order_by(func.get_geometry_area(sortby_column).desc())\n else: # aspatial sort\n query = query.order_by(sortby_column.desc())\n else: # ascending sort\n if 'spatial' in sortby and sortby['spatial']: # spatial sort\n query = query.order_by(func.get_geometry_area(sortby_column))\n else: # aspatial sort\n query = query.order_by(sortby_column)\n \n if self.stable_sort:\n identifier = self.context.md_core_model['mappings']['pycsw:Identifier']\n query = query.order_by(identifier)\n \n # always apply limit and offset\n return [str(total), self._get_repo_filter(query).limit(\n maxrecords).offset(startposition).all()]\n\n def insert(self, record, source, insert_date):\n ''' Insert a record into the repository '''\n\n if isinstance(record.xml, bytes):\n LOGGER.debug('Decoding bytes to unicode')\n record.xml = record.xml.decode()\n\n try:\n self.session.begin()\n self.session.add(record)\n self.session.commit()\n except Exception as err:\n LOGGER.exception(err)\n self.session.rollback()\n raise\n\n def update(self, record=None, recprops=None, constraint=None):\n ''' Update a record in the repository based on identifier '''\n\n if record is not None:\n identifier = getattr(record,\n self.context.md_core_model['mappings']['pycsw:Identifier'])\n\n if isinstance(record.xml, bytes):\n LOGGER.debug('Decoding bytes to unicode')\n record.xml = record.xml.decode()\n\n if recprops is None and constraint is None: # full update\n LOGGER.debug('full update')\n update_dict = dict([(getattr(self.dataset, key),\n getattr(record, key))\n for key in record.__dict__.keys() if key != '_sa_instance_state'])\n\n try:\n self.session.begin()\n self._get_repo_filter(self.session.query(self.dataset)).filter_by(\n identifier=identifier).update(update_dict, synchronize_session='fetch')\n self.session.commit()\n except Exception as err:\n self.session.rollback()\n msg = 'Cannot commit to repository'\n LOGGER.exception(msg)\n raise RuntimeError(msg) from err\n else: # update based on record properties\n LOGGER.debug('property based update')\n try:\n rows = rows2 = 0\n self.session.begin()\n for rpu in recprops:\n # update queryable column and XML document via XPath\n if 'xpath' not in rpu['rp']:\n self.session.rollback()\n raise RuntimeError('XPath not found for property %s' % rpu['rp']['name'])\n if 'dbcol' not in rpu['rp']:\n self.session.rollback()\n raise RuntimeError('property not found for XPath %s' % rpu['rp']['name'])\n rows += self._get_repo_filter(self.session.query(self.dataset)).filter(\n text(constraint['where'])).params(self._create_values(constraint['values'])).update({\n getattr(self.dataset, rpu['rp']['dbcol']): rpu['value'],\n 'xml': func.update_xpath(str(self.context.namespaces),\n getattr(self.dataset, self.context.md_core_model['mappings']['pycsw:XML']), str(rpu)),\n }, synchronize_session='fetch')\n # then update anytext tokens\n rows2 += self._get_repo_filter(self.session.query(self.dataset)).filter(\n text(constraint['where'])).params(self._create_values(constraint['values'])).update({\n 'anytext': func.get_anytext(getattr(\n self.dataset, self.context.md_core_model['mappings']['pycsw:XML']))\n }, synchronize_session='fetch')\n self.session.commit()\n LOGGER.debug('Updated %d records', rows)\n return rows\n except Exception as err:\n self.session.rollback()\n msg = 'Cannot commit to repository'\n LOGGER.exception(msg)\n raise RuntimeError(msg) from err\n\n def delete(self, constraint):\n ''' Delete a record from the repository '''\n\n LOGGER.debug('Deleting record with constraint: %s', constraint)\n try:\n self.session.begin()\n rows = self._get_repo_filter(self.session.query(self.dataset)).filter(\n text(constraint['where'])).params(self._create_values(constraint['values']))\n\n parentids = []\n for row in rows: # get ids\n parentids.append(getattr(row,\n self.context.md_core_model['mappings']['pycsw:Identifier']))\n\n rows = rows.delete(synchronize_session='fetch')\n\n if rows > 0:\n LOGGER.debug('Deleting all child records')\n # delete any child records which had this record as a parent\n rows += self._get_repo_filter(self.session.query(self.dataset)).filter(\n getattr(self.dataset,\n self.context.md_core_model['mappings']['pycsw:ParentIdentifier']).in_(parentids)).delete(\n synchronize_session='fetch')\n\n self.session.commit()\n LOGGER.debug('Deleted %d records', rows)\n except Exception as err:\n self.session.rollback()\n msg = 'Cannot commit to repository'\n LOGGER.exception(msg)\n raise RuntimeError(msg) from err\n\n return rows\n\n def exists(self):\n if self.database.startswith('sqlite:'):\n db_path = self.database.rpartition(\":///\")[-1]\n if not os.path.isfile(db_path):\n try:\n os.makedirs(os.path.dirname(db_path))\n except OSError as exc:\n if exc.args[0] == 17: # directory already exists\n pass\n\n def _get_repo_filter(self, query):\n ''' Apply repository wide side filter / mask query '''\n if self.filter is not None:\n return query.filter(text(self.filter))\n return query\n\n\ndef create_custom_sql_functions(connection):\n \"\"\"Register custom functions on the database connection.\"\"\"\n\n inspect_function = inspect.getfullargspec\n\n for function_object in [\n query_spatial,\n update_xpath,\n util.get_anytext,\n get_geometry_area,\n get_spatial_overlay_rank\n ]:\n argspec = inspect_function(function_object)\n connection.create_function(\n function_object.__name__,\n len(argspec.args),\n function_object\n )\n\n\ndef query_spatial(bbox_data_wkt, bbox_input_wkt, predicate, distance):\n \"\"\"Perform spatial query\n\n Parameters\n ----------\n bbox_data_wkt: str\n Well-Known Text representation of the data being queried\n bbox_input_wkt: str\n Well-Known Text representation of the input being queried\n predicate: str\n Spatial predicate to use in query\n distance: int or float or str\n Distance parameter for when using either of ``beyond`` or ``dwithin``\n predicates.\n\n Returns\n -------\n str\n Either ``true`` or ``false`` depending on the result of the spatial\n query\n\n Raises\n ------\n RuntimeError\n If an invalid predicate is used\n\n \"\"\"\n\n try:\n bbox1 = loads(bbox_data_wkt.split(';')[-1])\n bbox2 = loads(bbox_input_wkt)\n if predicate == 'bbox':\n result = bbox1.intersects(bbox2)\n elif predicate == 'beyond':\n result = bbox1.distance(bbox2) > float(distance)\n elif predicate == 'contains':\n result = bbox1.contains(bbox2)\n elif predicate == 'crosses':\n result = bbox1.crosses(bbox2)\n elif predicate == 'disjoint':\n result = bbox1.disjoint(bbox2)\n elif predicate == 'dwithin':\n result = bbox1.distance(bbox2) <= float(distance)\n elif predicate == 'equals':\n result = bbox1.equals(bbox2)\n elif predicate == 'intersects':\n result = bbox1.intersects(bbox2)\n elif predicate == 'overlaps':\n result = bbox1.intersects(bbox2) and not bbox1.touches(bbox2)\n elif predicate == 'touches':\n result = bbox1.touches(bbox2)\n elif predicate == 'within':\n result = bbox1.within(bbox2)\n else:\n raise RuntimeError(\n 'Invalid spatial query predicate: %s' % predicate)\n except (AttributeError, ValueError, ShapelyError, TypeError):\n result = False\n return \"true\" if result else \"false\"\n\n\ndef update_xpath(nsmap, xml, recprop):\n \"\"\"Update XML document XPath values\"\"\"\n\n if isinstance(xml, bytes) or isinstance(xml, str):\n # serialize to lxml\n xml = etree.fromstring(xml, PARSER)\n\n recprop = eval(recprop)\n nsmap = eval(nsmap)\n try:\n nodes = xml.xpath(recprop['rp']['xpath'], namespaces=nsmap)\n if len(nodes) > 0: # matches\n for node1 in nodes:\n if node1.text != recprop['value']: # values differ, update\n node1.text = recprop['value']\n except Exception as err:\n LOGGER.warning('update_xpath error', exc_info=True)\n raise RuntimeError('ERROR: %s' % str(err)) from err\n\n return etree.tostring(xml)\n\n\ndef get_geometry_area(geometry):\n \"\"\"Derive area of a given geometry\"\"\"\n try:\n if geometry is not None:\n return str(loads(geometry).area)\n return '0'\n except Exception:\n return '0'\n\n\ndef get_spatial_overlay_rank(target_geometry, query_geometry):\n \"\"\"Derive spatial overlay rank for geospatial search as per Lanfear (2006)\n http://pubs.usgs.gov/of/2006/1279/2006-1279.pdf\"\"\"\n\n # TODO: Add those parameters to config file\n kt = 1.0\n kq = 1.0\n if target_geometry is not None and query_geometry is not None:\n try:\n q_geom = loads(query_geometry)\n t_geom = loads(target_geometry)\n Q = q_geom.area\n T = t_geom.area\n if any(item == 0.0 for item in [Q, T]):\n LOGGER.warning('Geometry has no area')\n return '0'\n X = t_geom.intersection(q_geom).area\n if kt == 1.0 and kq == 1.0:\n LOGGER.debug('Spatial Rank: %s', str((X/Q)*(X/T)))\n return str((X/Q)*(X/T))\n else:\n LOGGER.debug('Spatial Rank: %s', str(((X/Q)**kq)*((X/T)**kt)))\n return str(((X/Q)**kq)*((X/T)**kt))\n except Exception:\n LOGGER.warning('Cannot derive spatial overlay ranking', exc_info=True)\n return '0'\n return '0'\n\n\ndef setup(database, table, create_sfsql_tables=True, postgis_geometry_column='wkb_geometry',\n extra_columns=[], language='english'):\n \"\"\"Setup database tables and indexes\"\"\"\n from sqlalchemy import Column, create_engine, Integer, MetaData, \\\n Table, Text, Unicode\n from sqlalchemy.types import Float\n from sqlalchemy.orm import create_session\n\n LOGGER.info('Creating database %s', util.sanitize_db_connect(database))\n if database.startswith('sqlite:///'):\n _, filepath = database.split('sqlite:///')\n dirname = os.path.dirname(filepath)\n if not os.path.exists(dirname):\n LOGGER.debug('SQLite directory %s does not exist' % dirname)\n try:\n db_path = database.rpartition(\":///\")[-1]\n os.makedirs(os.path.dirname(db_path))\n except OSError as exc:\n if exc.args[0] == 17: # directory already exists\n LOGGER.debug('Directory already exists')\n\n dbase = create_engine(database)\n schema_name, table_name = table.rpartition(\".\")[::2]\n\n mdata = MetaData(dbase, schema=schema_name or None)\n create_postgis_geometry = False\n\n # If PostGIS 2.x detected, do not create sfsql tables.\n if dbase.name == 'postgresql':\n try:\n dbsession = create_session(dbase)\n for row in dbsession.execute('select(postgis_lib_version())'):\n postgis_lib_version = row[0]\n create_sfsql_tables = False\n create_postgis_geometry = True\n LOGGER.info('PostGIS %s detected: Skipping SFSQL tables creation', postgis_lib_version)\n except Exception:\n pass\n\n if create_sfsql_tables:\n LOGGER.info('Creating table spatial_ref_sys')\n srs = Table(\n 'spatial_ref_sys', mdata,\n Column('srid', Integer, nullable=False, primary_key=True),\n Column('auth_name', Text),\n Column('auth_srid', Integer),\n Column('srtext', Text)\n )\n srs.create()\n\n i = srs.insert()\n i.execute(srid=4326, auth_name='EPSG', auth_srid=4326, srtext='GEOGCS[\"WGS 84\",DATUM[\"WGS_1984\",SPHEROID[\"WGS 84\",6378137,298.257223563,AUTHORITY[\"EPSG\",\"7030\"]],AUTHORITY[\"EPSG\",\"6326\"]],PRIMEM[\"Greenwich\",0,AUTHORITY[\"EPSG\",\"8901\"]],UNIT[\"degree\",0.01745329251994328,AUTHORITY[\"EPSG\",\"9122\"]],AUTHORITY[\"EPSG\",\"4326\"]]')\n\n LOGGER.info('Creating table geometry_columns')\n geom = Table(\n 'geometry_columns', mdata,\n Column('f_table_catalog', Text, nullable=False),\n Column('f_table_schema', Text, nullable=False),\n Column('f_table_name', Text, nullable=False),\n Column('f_geometry_column', Text, nullable=False),\n Column('geometry_type', Integer),\n Column('coord_dimension', Integer),\n Column('srid', Integer, nullable=False),\n Column('geometry_format', Text, nullable=False),\n )\n geom.create()\n\n i = geom.insert()\n i.execute(f_table_catalog='public', f_table_schema='public',\n f_table_name=table_name, f_geometry_column='wkt_geometry',\n geometry_type=3, coord_dimension=2,\n srid=4326, geometry_format='WKT')\n\n # abstract metadata information model\n\n LOGGER.info('Creating table %s', table_name)\n records = Table(\n table_name, mdata,\n # core; nothing happens without these\n Column('identifier', Text, primary_key=True),\n Column('typename', Text,\n default='csw:Record', nullable=False, index=True),\n Column('schema', Text,\n default='http://www.opengis.net/cat/csw/2.0.2', nullable=False,\n index=True),\n Column('mdsource', Text, default='local', nullable=False,\n index=True),\n Column('insert_date', Text, nullable=False, index=True),\n Column('xml', Unicode, nullable=False),\n Column('anytext', Text, nullable=False),\n Column('metadata', Unicode),\n Column('metadata_type', Text, default='application/xml', nullable=False),\n Column('language', Text, index=True),\n\n # identification\n Column('type', Text, index=True),\n Column('title', Text, index=True),\n Column('title_alternate', Text, index=True),\n Column('abstract', Text, index=True),\n Column('edition', Text, index=True),\n Column('keywords', Text, index=True),\n Column('keywordstype', Text, index=True),\n Column('themes', Text, index=True),\n Column('parentidentifier', Text, index=True),\n Column('relation', Text, index=True),\n Column('time_begin', Text, index=True),\n Column('time_end', Text, index=True),\n Column('topicategory', Text, index=True),\n Column('resourcelanguage', Text, index=True),\n\n # attribution\n Column('creator', Text, index=True),\n Column('publisher', Text, index=True),\n Column('contributor', Text, index=True),\n Column('organization', Text, index=True),\n\n # security\n Column('securityconstraints', Text, index=True),\n Column('accessconstraints', Text, index=True),\n Column('otherconstraints', Text, index=True),\n\n # date\n Column('date', Text, index=True),\n Column('date_revision', Text, index=True),\n Column('date_creation', Text, index=True),\n Column('date_publication', Text, index=True),\n Column('date_modified', Text, index=True),\n\n Column('format', Text, index=True),\n Column('source', Text, index=True),\n\n # geospatial\n Column('crs', Text, index=True),\n Column('geodescode', Text, index=True),\n Column('denominator', Text, index=True),\n Column('distancevalue', Float, index=True),\n Column('distanceuom', Text, index=True),\n Column('wkt_geometry', Text),\n Column('vert_extent_min', Float, index=True),\n Column('vert_extent_max', Float, index=True),\n\n # service\n Column('servicetype', Text, index=True),\n Column('servicetypeversion', Text, index=True),\n Column('operation', Text, index=True),\n Column('couplingtype', Text, index=True),\n Column('operateson', Text, index=True),\n Column('operatesonidentifier', Text, index=True),\n Column('operatesoname', Text, index=True),\n\n # inspire\n Column('degree', Text, index=True),\n Column('classification', Text, index=True),\n Column('conditionapplyingtoaccessanduse', Text, index=True),\n Column('lineage', Text, index=True),\n Column('responsiblepartyrole', Text, index=True),\n Column('specificationtitle', Text, index=True),\n Column('specificationdate', Text, index=True),\n Column('specificationdatetype', Text, index=True),\n\n # eo\n Column('platform', Text, index=True),\n Column('instrument', Text, index=True),\n Column('sensortype', Text, index=True),\n Column('cloudcover', Float, index=True),\n # bands: JSON list of dicts with properties: name, units, min, max\n Column('bands', Text, index=True),\n # STAC: view:off_nadir\n Column('illuminationelevationangle', Text, index=True),\n\n # distribution\n # links: JSON list of dicts with properties: name, description, protocol, url\n Column('links', Text, index=False),\n # contacts: JSON list of dicts with owslib contact properties, name, organization, email, role, etc.\n Column('contacts', Text, index=True),\n )\n\n # add extra columns that may have been passed via extra_columns\n # extra_columns is a list of sqlalchemy.Column objects\n if extra_columns:\n LOGGER.info('Extra column definitions detected')\n for extra_column in extra_columns:\n LOGGER.info('Adding extra column: %s', extra_column)\n records.append_column(extra_column)\n\n records.create()\n\n conn = dbase.connect()\n\n if dbase.name == 'postgresql':\n LOGGER.info('Creating PostgreSQL Free Text Search (FTS) GIN index')\n tsvector_fts = \"alter table %s add column anytext_tsvector tsvector\" % table_name\n conn.execute(tsvector_fts)\n index_fts = \"create index fts_gin_idx on %s using gin(anytext_tsvector)\" % table_name\n conn.execute(index_fts)\n # This needs to run if records exist \"UPDATE records SET anytext_tsvector = to_tsvector('english', anytext)\"\n trigger_fts = \"create trigger ftsupdate before insert or update on %s for each row execute procedure tsvector_update_trigger('anytext_tsvector', 'pg_catalog.%s', 'anytext')\" % (table_name, language)\n conn.execute(trigger_fts)\n\n if dbase.name == 'postgresql' and create_postgis_geometry:\n # create native geometry column within db\n LOGGER.info('Creating native PostGIS geometry column')\n if postgis_lib_version < '2':\n create_column_sql = \"SELECT AddGeometryColumn('%s', '%s', 4326, 'POLYGON', 2)\" % (table_name, postgis_geometry_column)\n else:\n create_column_sql = \"ALTER TABLE %s ADD COLUMN %s geometry(Geometry,4326);\" % (table_name, postgis_geometry_column)\n create_insert_update_trigger_sql = '''\nDROP TRIGGER IF EXISTS %(table)s_update_geometry ON %(table)s;\nDROP FUNCTION IF EXISTS %(table)s_update_geometry();\nCREATE FUNCTION %(table)s_update_geometry() RETURNS trigger AS $%(table)s_update_geometry$\nBEGIN\n IF NEW.wkt_geometry IS NULL THEN\n RETURN NEW;\n END IF;\n NEW.%(geometry)s := ST_GeomFromText(NEW.wkt_geometry,4326);\n RETURN NEW;\nEND;\n$%(table)s_update_geometry$ LANGUAGE plpgsql;\n\nCREATE TRIGGER %(table)s_update_geometry BEFORE INSERT OR UPDATE ON %(table)s\nFOR EACH ROW EXECUTE PROCEDURE %(table)s_update_geometry();\n ''' % {'table': table_name, 'geometry': postgis_geometry_column}\n\n create_spatial_index_sql = 'CREATE INDEX %(geometry)s_idx ON %(table)s USING GIST (%(geometry)s);' \\\n % {'table': table_name, 'geometry': postgis_geometry_column}\n\n conn.execute(create_column_sql)\n conn.execute(create_insert_update_trigger_sql)\n conn.execute(create_spatial_index_sql)\n"
},
{
"path": "pycsw/core/schemas/catalog.xml",
"content": "\n\n\n\n \n \n \n \n \n \n\n"
},
{
"path": "pycsw/core/schemas/ogc/OGC-SOFTWARE-NOTICE.txt",
"content": "OGC Software Notice\n\nThis OGC work (including software, documents, or other related items) is being provided by the copyright holders under the following license. By obtaining, using and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions:\n\nPermission to use, copy, and modify this software and its documentation, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the software and documentation or portions thereof, including modifications, that you make:\n\n The full text of this NOTICE in a location viewable to users of the redistributed or derivative work.\n Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, a short notice of the following form (hypertext is preferred, text is permitted) should be used within the body of any redistributed or derivative code: \"Copyright © [$date-of-document] Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/legal (Hypertext is preferred, but a textual representation is permitted.)\n Notice of any changes or modifications to the OGC files, including the date changes were made. (We recommend you provide URIs to the location from which the code is derived.) \n\n \n\nTHIS SOFTWARE AND DOCUMENTATION IS PROVIDED \"AS IS,\" AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.\n\nCOPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.\n\nThe name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the software without specific, written prior permission. Title to copyright in this software and any associated documentation will at all times remain with copyright holders."
},
{
"path": "pycsw/core/schemas/ogc/README.txt",
"content": "\nThese schemas are shipped with pycsw to support realtime XML validation.\n\nThe schemas have been downloaded from the official OGC schema repository at http://schemas.opengis.net/\n\nNote that only schemas required for pycsw are included.\n\nAs well, xs:import and xs:include statements with references to absolute URLs have been modified\nto refer to relative URLs for performance.\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/README.txt",
"content": "# 2015-02-13\n\nThe unofficial CSW 3.0 schema can be tested from here.\n\nhttp://test.schemas.opengis.net/csw/3.0/\n\nI did make one change to the examples/Capabilities.xml\n\nThanks,\n\nkevin\n\n####################################################################\n--- csw3_0_0-beta-20150123-pv/csw/3.0/examples/Capabilities.xml\n+++ csw3_0_0-beta-20150123-pv-s1/csw/3.0/examples/Capabilities.xml\n@@ -15,7 +15,7 @@\n xmlns:xlink=\"http://www.w3.org/1999/xlink\"\n xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n xsi:schemaLocation=\"http://www.opengis.net/cat/csw/3.0\n- http://www.opengis.net/csw/3.0/cswAll.xsd\n+ http://schemas.opengis.net/csw/3.0/cswAll.xsd\n http://www.opengis.net/gml/3.2\n http://schemas.opengis.net/gml/3.2.1/gml.xsd\n http://www.w3.org/1999/xlink\n\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/_wrapper.xsd",
"content": "\n\n\n\n\n \n \n\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/cswAll.xsd",
"content": "\n\n \n cswAll.xsd 2012-06-04\n \n This XML Schema Document includes and imports, directly or\n indirectly, all the XML Schemas defined by the Catalogue Service\n Specification.\n \n CSW is an OGC Standard.\n\n Copyright (c) 2012 Open Geospatial Consortium, Inc.\n All Rights Reserved.\n To obtain additional rights see: http://www.opengeospatial.org/legal/.\n \n \n \n \n \n \n \n \n \n \n \n \n \n\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/cswCommon.xsd",
"content": "\n\n \n \n http://schemas.opengis.net/csw/3.0/cswCommons.xsd\n \n \n This schema defines commen elements used in the CSW schemas.\n \n \n \n \n \n \n \n \n \n \n \n Base type for all request messages except GetCapabilities.\n The attributes identify the relevant service type and version.\n \n \n \n \n \n \n \n \n \n \n \n \n This is a general acknowledgement response message for all requests \n that may be processed in an asynchronous manner.\n EchoedRequest - Echoes the submitted request message\n RequestId - identifier for polling purposes (if no response \n handler is available, or the URL scheme is\n unsupported)\n \n \n \n \n \n \n \n \n \n \n \n Includes a copy of the request message body.\n \n \n \n \n \n \n\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/cswGetCapabilities.xsd",
"content": "\n\n \n \n http://schemas.opengis.net/csw/3.0/cswGetCapabilities.xsd\n \n \n This schema defines the request and response messages\n for the CSW 3.0 GetCapabilities operation.\n \n \n \n \n \n \n \n \n \n \n \n \n Request for a description of service capabilities. See\n OGC 06-121r9 for more information.\n \n \n \n \n \n \n \n OGC service type identifier (CSW).\n \n \n \n \n \n \n \n \n \n \n \n \n \n This type extends ows:CapabilitiesBaseType defined in OGC 06-121r9\n to include information about supported OGC filter components. A\n profile may extend this type to describe additional capabilities.\n \n \n \n \n \n \n \n If sections parameter not specified, then\n Filter_Capabilities is mandatory. On full\n getCapabilities request, then all capabilities\n should be present. Document this in the specification,\n use annotation on minOccurs to make this point.\n \n \n \n \n \n \n \n\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/cswGetDomain.xsd",
"content": "\n\n \n \n http://schemas.opengis.net/csw/3.0/cswGetDomain.xsd\n \n \n This schema defines the request and response messages for the CSW 3.0\n GetDomain operation.\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Returns the set of supported possible values\n for the specified data component.\n \n \n \n \n \n \n Returns the set of available values for the\n specified data component. This is typically\n a subset of the list of possible values.\n \n \n \n \n \n \n \n \n \n \n \n \n Returns the actual values for some property. In general this is\n a subset of the value domain (that is, set of permissible values),\n although in some cases these may be the same.\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/cswGetRecordById.xsd",
"content": "\n\n \n \n http://schemas.opengis.net/csw/3.0/cswGetRecordsById.xsd\n \n \n This schema defines the request messages for the CSW 3.0\n GetRecordById operation.\n \n \n \n \n \n \n \n \n \n \n \n \n Convenience operation to retrieve default record representations \n by identifier.\n Id - object identifier (a URI) that provides a reference to a \n catalogue item (or a result set if the catalogue supports \n persistent result sets).\n ElementSetName - one of \"brief, \"summary\", or \"full\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n"
},
{
"path": "pycsw/core/schemas/ogc/cat/csw/3.0/cswGetRecords.xsd",
"content": "\n\n \n \n http://schemas.opengis.net/csw/3.0/cswGetRecords.xsd\n \n \n This schema defines the request and response messages for the CSW 3.0\n GetRecords operation.\n \n \n \n \n \n \n \n \n \n \n \n \n The principal means of searching the catalogue. The matching\n catalogue entries may be included with the response. The client\n may assign a requestId (absolute URI). A distributed search is\n performed if the DistributedSearch element is present and the\n catalogue is a member of a federation. Profiles may allow\n alternative query expressions.\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n requestId becomes mandatory in the case of a distributed\n search. Must be a unique Id (i.e. a UUID).\n \n \n \n \n \n \n \n \n \n \n Various attributes that specify basic retrieval options:\n outputFormat - the media type of the response message\n outputSchema - the preferred schema for records in the result set\n startPosition - requests a slice of the result set, starting\n at this position\n maxRecords - the maximum number of records to return. No\n records are returned if maxRecords=0.\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Governs the behaviour of a distributed search.\n hopCount - the maximum number of message hops before\n the search is terminated. Each catalogue node \n decrements this value when the request is received, \n and must not forward the request if hopCount=0.\n \n \n \n \n \n \n To restrict the number of catalogues of a federation which\n should be searched upon an optional list of those catalogues\n can be provided within the federatedCatatalogues parameter.\n \n \n \n \n \n \n \n \n An Id which uniquely identifies the requestor.\n \n \n \n \n \n \n Id which uniquely identifies a complete client initiated\n distributed search sequence/session.\n \n \n \n \n \n \n Defines how long (sec) the distributedSearchId should be valid,\n meaning how long a server involved in distributed search should\n minimally store information related to the distributedSearchId.\n \n \n \n \n \n \n \n \n \n For every catalogue in this list an optional timeout definition\n (in msec) can be provided.\n \n \n \n \n \n \n \n \n \n \n Specifies a query to execute against instances of one or\n more object types. A set of ElementName elements may be included \n to specify an adhoc view of the csw30:Record instances in the\n result set. Otherwise, use ElementSetName to specify a predefined\n view. The Constraint element contains a query filter expressed\n in a supported query language. A sorting criterion that specifies\n a property to sort by may be included.\n\n typeNames - a list of object types to query.\n \n \n \n \n \n \n \n