Introduction
============

Overview
--------

ZAZ is a script for rapid develop extensions and macros for `LibreOffice`_, in
`Python`_ of course.

With ZAZ, you can create:

* Extensions for final user
* New components for used from Basic
* AddIn, new functions for Calc


Requirements
------------

* Python 3.7+
* LibreOffice 7.0+ with support for macros Python
* LibreOffice SDK, for new components and Add-In

In:

* ArchLinux
    * ``sudo pacman -S libreoffice-fresh-sdk``
* Ubuntu 20.04+
    * ``sudo apt install libreoffice-script-provider-python libreoffice-dev``


Installation
------------

* Clone this repository (recommended) or download it.

``git clone https://git.cuates.net/elmau/zaz.git``

* Move to.

``cd zaz/source``

* Start new extension.

``./zaz.py -new -t ~/projects -n MyFirstExtension``


My first extension
------------------

* Move to:

``cd ~/projects/MyFirstExtension``

* Create:

``python zaz.py -c``::

    ↪ python zaz.py -c
    04/02/2021 23:07:50 - INFO - Created directories...
    04/02/2021 23:07:50 - INFO - Created files...
    04/02/2021 23:07:50 - INFO - Don't forget generate DOMAIN.pot for locales
    04/02/2021 23:07:50 - INFO - New extension: MyFirstExtension make successfully...
        Now, you can install and test: zaz.py -i

* Install and test:

``python zaz.py -i``::

    ↪ python zaz.py -i
    04/02/2021 23:11:40 - INFO - Don't forget generate DOMAIN.pot for locales
    04/02/2021 23:11:40 - INFO - Compress OXT extension...
    04/02/2021 23:11:40 - INFO - Extension OXT created successfully...
    Copying: MyFirstExtension_v0.1.0.oxt

    unopkg done.

    04/02/2021 23:11:41 - INFO - Install extension successfully...
    04/02/2021 23:11:41 - INFO - Start LibreOffice...
    04/02/2021 23:11:53 - INFO - Extension make successfully...



.. _LibreOffice: https://libreoffice.org
.. _Python: https://python.org