##########################################################
Saturnin SDK - Development tools and examples for Saturnin
##########################################################

.. seealso::

   For installation instructions, see the Saturnin_ documentation.

.. note:: Requires Python 3.11+

.. note::

   Examples are not distributed via PyPI. You can either download the ZIP package from
   `gihub releases`_ and unpack it into directory of your choice, or checkout the "examples"
   directory directly from SDK repository_.

   To register (example and your own) services and applications for use with Saturnin in
   "development" mode, use `saturnin install package -e .` from root directory of service
   package.

   For example to register `TextIO` sample service:

   1. CD to `examples/textio`
   2. Run `saturnin install package -e .`


Saturnin SDK development is sponsored by IBPhoenix_.

.. toctree::
   :maxdepth: 1
   :hidden:

   usage-guide
   examples
   changelog
   license


.. _IBPhoenix: http://www.ibphoenix.com
.. _Python: http://python.org
.. _Firebird: http://www.firebirdsql.org
.. _Firebird Project: http://www.firebirdsql.org
.. _Saturnin: http://saturnin.readthedocs.io
.. _IBPhoenix: http://www.ibphoenix.com
.. _gihub releases: https://github.com/FirebirdSQL/saturnin-sdk/releases
.. _repository: https://github.com/FirebirdSQL/saturnin-sdk
.. _Dash: https://kapeli.com/dash
.. _Zeal: https://zealdocs.org/
.. _Firebird Butler: https://firebird-butler.readthedocs.io