zaz/doc/source/main/application.rst

Application
-----------

Remember,  always import library.

.. code-block:: python

    import easymacro as app


Current doc
^^^^^^^^^^^

.. code-block:: python

    doc = app.active
    app.msgbox(doc.title)


Iter docs
^^^^^^^^^

.. code-block:: python

    for doc in app.docs:
        app.msgbox(doc.title)


Count
^^^^^

.. code-block:: python

    count = len(app.docs)
    app.msgbox(count)


Get by name
^^^^^^^^^^^

.. code-block:: python

    name = 'MyDoc.ods'
    if name in app.docs:
        doc = app.docs[name]
        app.msgbox(doc.title)


New
^^^

For default create new Calc document.

.. code-block:: python

    doc = app.docs.new()
    app.msgbox(doc.type)


For new Writer document.

.. code-block:: python

    doc = app.docs.new('writer')
    app.msgbox(doc.type)


With arguments.

.. code-block:: python

    args= {'Hidden': True}
    doc = app.docs.new('writer', args)
    msg = f'{doc.type} - {doc.title}'
    app.msgbox(msg)
    doc.visible = True


Other documents.

.. code-block:: python

    doc = app.docs.new('draw')
    app.msgbox(doc.type)

    doc = app.docs.new('impress')
    app.msgbox(doc.type)


Open
^^^^

.. code-block:: python

    path = '/home/mau/MyDoc.ods'
    doc = app.docs.open(path)


While LibreOffice support format, you can open arbitrary file.

.. code-block:: python

    path = '/home/mau/example.xlsx'
    doc = app.docs.open(path)


With arguments.

.. code-block:: python

    path = '/home/mau/example.odt'
    args= {'Password': 'letmein'}
    doc = app.docs.open(path, args)