Script jsondatacheck

A command line interface for the validation of JSON based data.

The command line interface is implemented as a front-end for the package
'jsondata'.

The interface provides a callable generic validator(default:=Draft4) for arbitrary
JSON data files. The validation is performed with a main JSON schema file linking 
additional sub-configuration for an optional set of an arbitrary number of branches.
It provides the validation of JSON based data/files by their corresponding JSONschemas.
The call interface is Linux/Unix command line standard - on other supported OS too - 
with a few conventions related to default values of file names and paths.

The application of this call interface is mainly intended for the purposes::
1. as a developer utility for the development of JSON based data
2. as a user tool in order to enumerate the list of actually 
   used JSON sources
3. as a user tools in order to verify the present JSON data
4. as a automation and test tool for various JSON specifications,
   and JSON based applications

Therefore the assembly of data tree models with basic branch functions 
in accordance/complance to RFC6901 and RFC6902 is provided for the 
incremental setup and serialization of JSON data.

When no explicit filenames are provided the following convention is applied
as default:

    appname: "-a"
        "JSONobjects"

    JSON-schema: "-s"
        dirname(__file__)/<appname>.jsd ("jsondata.jsd")

    JSON-data: "-c"
        <appname>.json ("jsondata.json")

    Search-path-data: "-p"
        Search path for JSON-data - refer to __file__=JSONData/Serializer.py:
        default:= ../dirname(__file__)/:dirname(__file__)/:/etc/:$HOME/

SYNOPSIS:
  jsondatacheck [OPTIONS]

OPTIONS:
  -a, --appname= <appname>
     Name of application.
     default: jsondatacheck
  -c, --configfile= <configfile>
     A single configuration file including path with JSON data.
     default: jsondatacheck.json
  -D, --print-data
     Pretty print data.
  -f --filelist= <list-of-filenames>
     List of colon seperated filenames to be searched for. These 
     could be relative pathnames too.
     default:=[<appname>.json]
  -j, --json= (json|ujson)
      Use as scanner and parser one of the verified packages:
          'json': standard package
          'ujson': ultra-json for performance, check platform availability,
              and eventually run unit tests.
  -n, --no-default-path
     Supress load of default path.
     default: False
  -N, --no-sub-data
     Supress load of sub-data files, e.g. from plugins.
     default: False
  -p, --pathlist= <search-path-JSON-data>
     Search path for JSON data file(s), standard list for current platform.
     default:= ../dirname(__file__)/:dirname(__file__)/:/etc/:$HOME/
  -P, --plugins-pathlist= <search-path-JSON-data-branches>
     Search path for JSON data file(s) to be inserted as additional branches,
     standard list for current platform.
     default:= ../dirname(__file__)/:dirname(__file__)/:/etc/:$HOME/
  -s, --schemafile= <schemafile>
     Schema file - JSONschema.
     default: jsondatacheck.jsd
  -S, --print-schema
     Pretty print schema.
  -V, --validator= <validator>
     Alternate validator provided by module 'jsonschema'
     - default: validate
     - draft3: Draft3Validator
     - off: None
    default:= validate

  -i, --interactive
     Dialog mode, displays formatted for interactive JSON and 
     JSONschema design.
      
  -d, --debug
     Debug entries, does NOT work with 'python -O ...'.
     Developer output, aimed for filtering.
  -v, --verbose
     Verbose, some relevant states for basic analysis.
     When '--selftest' is set, repetition raises the display level.
     
  --selftest
     Performs a basic functional selftest by load, verify, and validate.
     0. jsondata/data.json + jsondata/schema.jsd
     1. jsondata/selftest.json + jsondata/selftest.jsd

  --version
     Current version - terse.
  --Version
     Current version - detailed.

  -h, --help
     This help.

PYTHON OPTIONS:
  -O, -OO
   Eliminates '__debug__' code.