ae-ae 0.3.94

ae namespace-root: bundling and maintaining templates and documentation of the portions of this namespace.

ae namespace-root project

ae_ae namespace-root 0.3.94

ae namespace root package use-cases

this package is the root project of the ae namespace and their portions (the modules and sub-packages of the namespace ae). it provides helpers and templates in order to bundle and ease the maintenance, for example to:

• update and deploy common outsourced files, optionally generated from templates.
• merge docstrings of all portions into a single combined and cross-linked documentation.
• compile and publish documentation via Sphinx onto ReadTheDocs.
• bulk refactor multiple portions of this namespace simultaneously using the git repository manager tool (grm).

to enable the update and deployment of outsourced files generated from the templates provided by this root package, add this root package to the development requirements file (dev_requirements.txt) of each portion project of this namespace. in this entry you can optionally specify the version of this project.

and because this namespace-root package is only needed for development tasks, it will never need to be added to the installation requirements file (requirements.txt) of a project.

please check the git repository manager manual for more detailed information on the provided actions of the grm tool.

installation

no installation is needed to use this project for your portion projects, because the grm tool is automatically fetching this and the other template projects from https://gitlab.com/ae-group (and in the specified version).

an installation is only needed if you want to adapt this namespace-root project for your needs or if you want to contribute to this root package. in this case please follow the instructions given in the :ref:contributing document.

namespace portions

the following 40 portions are currently included in this namespace:

• ae_base
• ae_deep
• ae_django_utils
• ae_droid
• ae_notify
• ae_valid
• ae_files
• ae_paths
• ae_core
• ae_lockname
• ae_dynamicod
• ae_i18n
• ae_parse_date
• ae_literal
• ae_progress
• ae_updater
• ae_console
• ae_sys_core
• ae_sys_data
• ae_sys_core_sh
• ae_sys_data_sh
• ae_db_core
• ae_db_ora
• ae_db_pg
• ae_transfer_service
• ae_sideloading_server
• ae_gui_app
• ae_gui_help
• ae_kivy_glsl
• ae_kivy_dyn_chi
• ae_kivy_relief_canvas
• ae_kivy
• ae_kivy_auto_width
• ae_kivy_file_chooser
• ae_kivy_iterable_displayer
• ae_kivy_qr_displayer
• ae_kivy_sideloading
• ae_kivy_user_prefs
• ae_lisz_app_data
• ae_enaml_app