gnucash master: Multiple changes pushed

Mon Jul 6 15:59:08 EDT 2020

Updated	 via  https://github.com/Gnucash/gnucash/commit/b0b23895 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/22f91c40 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/40cfb70f (commit)
	 via  https://github.com/Gnucash/gnucash/commit/e23bf0bc (commit)
	 via  https://github.com/Gnucash/gnucash/commit/7c8e0a28 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/3e842a7b (commit)
	 via  https://github.com/Gnucash/gnucash/commit/b9c6fc28 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/0434acbe (commit)
	 via  https://github.com/Gnucash/gnucash/commit/485d8a65 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/44e61f4d (commit)
	 via  https://github.com/Gnucash/gnucash/commit/5833c5af (commit)
	 via  https://github.com/Gnucash/gnucash/commit/17d606e1 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/c222503f (commit)
	 via  https://github.com/Gnucash/gnucash/commit/ee77b713 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/b073dbc5 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/4e280b95 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/48072f5a (commit)
	 via  https://github.com/Gnucash/gnucash/commit/ee3342d2 (commit)
	from  https://github.com/Gnucash/gnucash/commit/4ee573e2 (commit)


commit b0b238958e2b8c36426688762341f3288d3919ff
Merge: 4ee573e23 22f91c407
Author: John Ralls <jralls at ceridwen.us>
Date:   Mon Jul 6 12:45:07 2020 -0700

    Merge Christoph Holtermann's 'python-sessionOpenMode' into master.

commit 22f91c407ee52fcba649d2f608f900a7be6f99fc
Author: c-holtermann <mail at c-holtermann.net>
Date:   Sat Jul 4 22:26:35 2020 +0200

    use same order in comment as in definition of SessionOpenMode enum

commit 40cfb70fb722501278d87bc283588d70a578b583
Author: c-holtermann <mail at c-holtermann.net>
Date:   Sat Jul 4 22:22:16 2020 +0200

    fix SessionOpenMode explanation for SESSION_NORMAL_OPEN

commit e23bf0bc1c7e35c66c7be2d8250e7f6073eb3b8b
Author: c-holtermann <mail at c-holtermann.net>
Date:   Sat Jul 4 22:16:13 2020 +0200

    fix SessionOpenMode explanation for SESSION_NEW_OVERWRITE

commit 7c8e0a28fc7ef0be313a6e92910fbd9e691fa204
Author: c-holtermann <mail at c-holtermann.net>
Date:   Sat Jun 20 13:21:41 2020 +0200

    better display for doxygen, typo and consistent naming

commit 3e842a7bf6e3b5479c9e110554c0399b461373a6
Author: c-holtermann <mail at c-holtermann.net>
Date:   Sat Jun 20 10:35:31 2020 +0200

    use urllib.parse.urlparse to check for xml on python Session init

commit b9c6fc28767c130c7bc52f68c3dbaee88fe77f41
Author: c-holtermann <mail at c-holtermann.net>
Date:   Thu Jun 11 17:52:02 2020 +0200

    add some unittests for python Session
    
    test arguments, deprecated as well as new mode arguments
    test creating a session with a new xml file using __init__()
    and begin(). Test raising exception when opening nonexistent
    file without respective mode setting.

commit 0434acbe1035ed679d23242a412c48a680ac5a07
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 19 20:45:21 2020 +0200

    reformat two python example scripts with black
    
    use black python code formatter on latex_invoices.py and gncinvoice_jinja.py

commit 485d8a65b0ad4d6e7e3e52de991fdf99135ff088
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 19 19:17:09 2020 +0200

    decorate Session.begin with default mode argument

commit 44e61f4df27c972c62218dea2069a43e92819ea5
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 19 19:15:51 2020 +0200

    enable Session.__init__() to be provided with existing instance or book

commit 5833c5afcbce5a60bf65291bc52407be1508913a
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 19 18:24:33 2020 +0200

    add unittests for function_class
    
    add tests for some existing function_class functionality.
    Add tests for the keyword argument changes.

commit 17d606e1f80915fd201606eac9d1f67c5ad0d536
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 19 19:14:20 2020 +0200

    enable keyword arguments for default_arguments_decorator
    
    default_arguments_decorator until now only allows positional
    argument defaults. This adds keyword defaults. The keywords
    can be mapped to the positional arguments by optional argument
    kargs_pos so interactions between keyword and positional arg
    defaults can raise a TypeError. Some more information in
    the docstring is included. In addition the docstring of
    the wrapped function will be modified to contain information
    about the defaults.

commit c222503f42fd47ef973b0cfd49457de96f12a694
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 19 19:08:00 2020 +0200

    add method decorate_method to function_class.py
    
    ClassFromFunctions.decorate_method() allows to provide positional
    and keyword arguments for the decorator call besides the wrapped
    method.

commit ee77b713c235e8eb0ee73710bdb35f4918e363a6
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 12 12:24:05 2020 +0200

    update example scripts to SessionOpenMode

commit b073dbc5c323f88363e97231afc37fab017dfa8c
Author: c-holtermann <mail at c-holtermann.net>
Date:   Thu Jun 11 21:11:06 2020 +0200

    allow keyword arguments for function_class.py
    
    allow keyword arguments for function_class methods
    and functions. process_dict_convert_to_instance() is added to
    mimic the behavior of the process_list_convert_to_instance()
    Derived methods in gnucash_core.py like raise_backend_errors_after_call
    get modified to accept being called with keyword args.
    Also adds some docstrings.

commit 4e280b959349e420e34ca93938982fb4e39481bd
Author: c-holtermann <mail at c-holtermann.net>
Date:   Tue Jun 9 22:41:20 2020 +0200

    adapt to use of sessionOpenMode in qof_session_begin

commit 48072f5a4c957e5ef4a168f8774006872cd4acf7
Author: c-holtermann <mail at c-holtermann.net>
Date:   Thu Jun 11 17:50:49 2020 +0200

    make SessionOpenMode enum available for python

commit ee3342d2b474fc94be206e1a768dc8de07b0ea32
Author: c-holtermann <mail at c-holtermann.net>
Date:   Fri Jun 19 22:43:08 2020 +0200

    introduce python submodule deprecation
    
    the deprecation submodule will house content related to deprecation.
    That is general convenience function and functions related to specific
    deprecation issues. The latter starts with decorator functions to bridge
    the change in qof_session_begin argument change to SessionOpenMode.


Summary of changes:
 bindings/python/CMakeLists.txt                     |   2 +-
 bindings/python/__init__.py                        |   1 +
 bindings/python/deprecation.py                     |  68 ++++++
 .../python/example_scripts/account_analysis.py     |   4 +-
 .../python/example_scripts/gncinvoice_jinja.py     |  75 ++++---
 bindings/python/example_scripts/latex_invoices.py  | 236 +++++++++++----------
 .../new_book_with_opening_balances.py              |   7 +-
 .../example_scripts/rest-api/gnucash_rest.py       |   7 +-
 bindings/python/example_scripts/simple_book.py     |   4 +-
 .../example_scripts/simple_business_create.py      |   4 +-
 .../example_scripts/simple_invoice_insert.py       |   4 +-
 bindings/python/example_scripts/simple_session.py  |   8 +-
 .../python/example_scripts/simple_sqlite_create.py |   4 +-
 bindings/python/example_scripts/simple_test.py     |   7 +-
 bindings/python/function_class.py                  | 209 +++++++++++++++---
 bindings/python/gnucash_core.py                    | 146 +++++++++++--
 bindings/python/tests/CMakeLists.txt               |   3 +-
 bindings/python/tests/runTests.py.in               |   1 +
 bindings/python/tests/test_function_class.py       | 177 ++++++++++++++++
 bindings/python/tests/test_session.py              |  47 +++-
 libgnucash/engine/qofsession.h                     |  18 +-
 21 files changed, 817 insertions(+), 215 deletions(-)
 create mode 100644 bindings/python/deprecation.py
 create mode 100644 bindings/python/tests/test_function_class.py