README

This is client library for accessing SOAP services of ISDS (Informační systém
datových schránek / Data Box Information System) as defined in Czech ISDS Act
(300/2008 Coll.) <http://portal.gov.cz/zakon/300/2008> and implied documents.

Copyright (C) 2009, 2010, 2011, 2012, 2013  Petr Písař <petr.pisar@atlas.cz>
Copyright (C) 2014, 2015, 2016, 2017, 2018  Petr Písař <petr.pisar@atlas.cz>
Copyright (C) 2019  Petr Písař <petr.pisar@atlas.cz>

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

This program 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 Lesser General Public License for more
details.


This code is written in ISO99 C language and requires libxml2, (optional but
strongly recommended) cURL, (libgcrypt and GPGME) or OpenSSL, >=expat-2.0.0,
xsltproc and DocBook XSLT stylesheets if building documentation is enabled,
and (if not part of your standard library) optional Gettext libraries and
pkg-config tool at compilation time. gnupg2 is required at run time (provides
gpgsm that uses gpgme to process CMS) if GPGME cryptographic back-end is
selected. Build system preparation from VCS requires >=automake-1.11,
autoconf, autopoint, and libtool in addition. Tests require >=GnuTLS-2.12.0
library.

Applications linked against this library need to be linked to libxml2 too.

It has been tested on GNU/Linux (Linux 5.2.11, glibc-2.29, gcc-8.2.0) with
libxml2-2.9.9, curl-7.65.0, libgcrypt-1.8.3, gpgme-1.13.0, expat-2.2.7,
gnupg-2.2.17, gnutls-3.6.9, libxslt-1.1.33, and docbook-xsl-stylesheets-1.79.1
on amd64 architecture.

Latest code can be obtained from GIT repository
<http://repo.or.cz/w/libisds.git> (web interface).

ISDS documentation is located under `doc' directory, user documentation can be
found in header files. See `client' directory for examples how to use this
library. Preliminary library self-tests are located in `test' directory. Test
data and message examples are stored in `server/messages' directory.

Credentials for testing account can be passed to example clients and on-line
tests by environmental variables `ISDS_USERNAME', `ISDS_PASSWORD', and
`ISDS_CODE_MEP' or by saving them into `test_credentials' (first line is the
user name, second line is the password) and `test_credentials_mep' (first list
is tge use name, second line is the MEP code) in a build root directory.
Environmental variables take precedence.