ae-ae

ae namespace-root project

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

ae namespace root package use-cases

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

• update and deploy managed files created and renewed from template files.
• merge docstrings of all portions into a single combined and cross-linked documentation.
• compile and publish documentation via Sphinx onto ReadTheDocs.
• bulk manage/update/refactor multiple portion projects of this namespace simultaneously using the git repository manager tool (pjm).

to enable the update and deployment of managed 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 namespace portion project.

please check the project manager manual for more detailed information on the provided actions of the pjm tool.

installation

no installation is needed to use this project for your portion projects, because the pjm 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 45 portions are currently included in this namespace:

• ae_base
• ae_app_log
• ae_system
• ae_deep
• ae_django_utils
• ae_notify
• ae_valid
• ae_files
• ae_paths
• ae_cloud_storage
• ae_oaio_model
• ae_oaio_client
• ae_updater
• ae_core
• ae_dynamicod
• ae_i18n
• ae_literal
• ae_console
• ae_shell
• ae_managed_files
• ae_pythonanywhere
• ae_lockname
• ae_progress
• 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
• 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