pycsw Home | Demos | Documentation | Issue Tracker | FAQ | Download

Profile Plugins

Overview

pycsw 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.

All profiles must be placed in the server/profiles directory.

Requirements

pycsw/
 server/
   profile.py # defines abstract profile object (properties and methods) and functions to load plugins
   profiles/ # directory to store profiles
     __init__.py # empty
     apiso/ # profile directory
       apiso.py # profile code
       ... # supporting files, etc.

Abstract Base Class Definition

All profile code must be instantiated as a subclass of profile.Profile. Below is an example to add a Foo profile:

from server import profile

class FooProfile(profile.Profile):
    profile.Profile.__init__(self,
        name='foo',
        version='1.0.3',
        title='My Foo Profile',
        url='http://example.org/fooprofile/docs',
        namespace='http://example.org/foons',
        typename='foo:RootElement',
        outputschema=http://example.org/foons',
        prefixes=['foo'],
        model=model,
        core_namespaces=namespaces,
        added_namespaces={'foo': 'http://example.org/foons'}
        repository=REPOSITORY['foo:RootElement'])

Your profile plugin class (FooProfile) must implement all methods as per profile.Profile. Profile methods must always return lxml.etree.Element types, or None.

Enabling Profiles

All profiles are disabled by default. To specify profiles at runtime, set the server.profiles value in the Configuration to the name of the package (in the server/profiles directory). To enable multiple profiles, specify as a comma separated value (see Configuration).

Testing

Profiles must add examples to the Tester interface, which must provide example requests specific to the profile.

Supported Profiles

ISO Metadata Application Profile (1.0.0)

Overview

The ISO Metadata Application Profile (APISO) is a profile of CSW 2.0.2 which enables discovery of geospatial metadata following ISO 19139:2007 and ISO 19119:2005/PDAM 1.

Configuration

No extra configuration is required.

Enabling APISO Support

To enable APISO support, add apiso to server.profiles as specified in Configuration.

Testing

A testing interface is available in tester/index.html which contains tests specific to APISO to demonstrate functionality. See Tester for more information.

INSPIRE Extension

Overview

APISO includes an extension for enabling INSPIRE Discovery Services 3.0 support. To enable the INSPIRE extension to APISO, create a [metadata:inspire] section in the main configuration with enabled set to true.

Configuration

[metadata:inspire]

Directory Interchange Format (DIF) 9.7

Overview

The Directory Interchange Format (DIF) is a metadata format supported by the NASA Global Change Master Directory.

Configuration

No extra configuration is required.

Enabling DIF Support

To enable DIF support, add dif to server.profiles.

Testing

A testing interface is available in dif/tester/index.html which contains tests specific to DIF to demonstrate functionality. See Tester for more information.

FGDC CSGDM 1998

Overview

The FGDC CSDGM Application Profile is a profile of CSW 2.0.2 which enables discovery of geospatial metadata following FGDC:CSDGM 1998 metadata.

Configuration

No extra configuration is required.

Enabling DIF Support

To enable fgdc support, add fgdc to server.profiles.

Testing

A testing interface is available in tester/index.html which contains tests specific to FGDC to demonstrate functionality. See Tester for more information.