#  -*- coding: utf-8 -*-
#  vim: tabstop=4 shiftwidth=4 softtabstop=4

#  Copyright (c) 2014-2016, GEM Foundation

#  OpenQuake is free software: you can redistribute it and/or modify it
#  under the terms of the GNU Affero General Public License as published
#  by the Free Software Foundation, either version 3 of the License, or
#  (at your option) any later version.

#  OpenQuake is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU Affero General Public License for more details.

#  You should have received a copy of the GNU Affero General Public License
#  along with OpenQuake.  If not, see <http://www.gnu.org/licenses/>.
from __future__ import print_function
import os.path
from openquake.commonlib import sap, shapefileparser


def to_shapefile(output, input_nrml_file, validate):
    """
    Convert a NRML source model file to ESRI Shapefile(s).
    For each type of source geometry defined in the NRML file (point, area,
    simple fault, complex fault, planar) a separate shapefile is created. Each
    shapefile is differentiated by a specific ending('_point', '_area',
    '_simple', '_complex', '_planar').
    """
    input_parser = shapefileparser.SourceModelParser()
    source_model = input_parser.read(input_nrml_file, validate)
    if not output:
        output = os.path.splitext(input_nrml_file)[0]
    print('Extracting %s_ files' % output)
    shapefileparser.ShapefileParser().write(output, source_model)


parser = sap.Parser(to_shapefile)
parser.opt('output', 'output path (no extension)')
parser.arg('input_nrml_file', 'path to source model NRML file')
parser.flg('validate', 'Apply validation to input model (can be slow)')

@@ -990,16 +990,17 @@
 ile(s).%0A
+%0A
     For 
@@ -1256,16 +1256,66 @@
 lanar').
+%0A%0A    NB: nonparametric sources are not supported.
 %0A    %22%22%22

Improved a docstring