2022-07-07 16:16:10 -04:00
|
|
|
|
"""
|
|
|
|
|
Script creates a project with the MVC pattern
|
|
|
|
|
=============================================
|
|
|
|
|
|
|
|
|
|
.. versionadded:: 1.0.0
|
|
|
|
|
|
|
|
|
|
.. seealso::
|
|
|
|
|
|
|
|
|
|
`MVC pattern <https://en.wikipedia.org/wiki/Model–view–controller>`_
|
|
|
|
|
|
|
|
|
|
.. rubric:: Use a clean architecture for your applications.
|
|
|
|
|
|
|
|
|
|
.. image:: https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/kivymddoc/preview-mvc.png
|
|
|
|
|
:align: center
|
|
|
|
|
|
|
|
|
|
Use a clean architecture for your applications. KivyMD allows you to quickly
|
|
|
|
|
create a project template with the MVC pattern. So far, this is the only
|
|
|
|
|
pattern that this utility offers. You can also include database support in
|
|
|
|
|
your project. At the moment, support for the Firebase database
|
|
|
|
|
(the basic implementation of the real time database) and RestDB
|
|
|
|
|
(the full implementation) is available.
|
|
|
|
|
|
|
|
|
|
Project creation
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
Template command::
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
kivymd.create_project \\
|
2022-07-07 16:16:10 -04:00
|
|
|
|
name_pattern \\
|
|
|
|
|
path_to_project \\
|
|
|
|
|
name_project \\
|
|
|
|
|
python_version \\
|
|
|
|
|
kivy_version
|
|
|
|
|
|
|
|
|
|
Example command::
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
kivymd.create_project \\
|
2022-07-07 16:16:10 -04:00
|
|
|
|
MVC \\
|
|
|
|
|
/Users/macbookair/Projects \\
|
|
|
|
|
MyMVCProject \\
|
|
|
|
|
python3.10 \\
|
|
|
|
|
2.1.0
|
|
|
|
|
|
|
|
|
|
This command will by default create a project with an MVC pattern.
|
|
|
|
|
Also, the project will create a virtual environment with Python 3.10,
|
|
|
|
|
Kivy version 2.1.0 and KivyMD master version.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
Please note that the Python version you specified must be installed on your
|
|
|
|
|
computer.
|
|
|
|
|
|
|
|
|
|
.. image:: https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/kivymddoc/mvc-base.png
|
|
|
|
|
:align: center
|
|
|
|
|
|
|
|
|
|
Creating a project using a database
|
|
|
|
|
-----------------------------------
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
Note that in the following command, you can use one of two database names:
|
|
|
|
|
'firebase' or 'restdb'.
|
|
|
|
|
|
|
|
|
|
Template command::
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
kivymd.create_project \\
|
2022-07-07 16:16:10 -04:00
|
|
|
|
name_pattern \\
|
|
|
|
|
path_to_project \\
|
|
|
|
|
name_project \\
|
|
|
|
|
python_version \\
|
|
|
|
|
kivy_version \\
|
|
|
|
|
--name_database
|
|
|
|
|
|
|
|
|
|
Example command::
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
kivymd.create_project \\
|
2022-07-07 16:16:10 -04:00
|
|
|
|
MVC \\
|
|
|
|
|
/Users/macbookair/Projects \\
|
|
|
|
|
MyMVCProject \\
|
|
|
|
|
python3.10 \\
|
|
|
|
|
2.1.0 \\
|
|
|
|
|
--name_database restdb
|
|
|
|
|
|
|
|
|
|
This command will create a project with an MVC template by default.
|
|
|
|
|
The project will also create a virtual environment with Python 3.10,
|
|
|
|
|
Kivy version 2.1.0, KivyMD master version and a wrapper for working with
|
|
|
|
|
the database restdb.io.
|
|
|
|
|
|
|
|
|
|
.. image:: https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/kivymddoc/mvc-database.png
|
|
|
|
|
:align: center
|
|
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
|
|
class DataBase:
|
|
|
|
|
def __init__(self):
|
|
|
|
|
database_url = "https://restdbio-5498.restdb.io"
|
|
|
|
|
api_key = "7ce258d66f919d3a891d1166558765f0b4dbd"
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
Please note that `database.py` the shell in the `DataBase` class uses the
|
|
|
|
|
`database_url` and `api_key` parameters on the test database (works only in read mode),
|
|
|
|
|
so you should use your data for the database.
|
|
|
|
|
|
|
|
|
|
Create project with hot reload
|
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
|
|
Template command::
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
kivymd.create_project \\
|
2022-07-07 16:16:10 -04:00
|
|
|
|
name_pattern \\
|
|
|
|
|
path_to_project \\
|
|
|
|
|
name_project \\
|
|
|
|
|
python_version \\
|
|
|
|
|
kivy_version \\
|
|
|
|
|
--use_hotreload
|
|
|
|
|
|
|
|
|
|
Example command::
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
kivymd.create_project \\
|
2022-07-07 16:16:10 -04:00
|
|
|
|
MVC \\
|
|
|
|
|
/Users/macbookair/Projects \\
|
|
|
|
|
MyMVCProject \\
|
|
|
|
|
python3.10 \\
|
|
|
|
|
2.1.0 \\
|
|
|
|
|
--use_hotreload yes
|
|
|
|
|
|
|
|
|
|
After creating the project, open the file `main.py`, there is a lot of useful
|
|
|
|
|
information. Also, the necessary information is in other modules of the project
|
|
|
|
|
in the form of comments. So do not forget to look at the source files of the
|
|
|
|
|
created project.
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
Create project with responsive view
|
|
|
|
|
-----------------------------------
|
|
|
|
|
|
|
|
|
|
When creating a project, you can specify which views should use responsive
|
|
|
|
|
behavior. To do this, specify the name of the view/views in the
|
|
|
|
|
`--use_responsive` argument:
|
|
|
|
|
|
|
|
|
|
Template command::
|
|
|
|
|
|
|
|
|
|
kivymd.create_project \\
|
|
|
|
|
name_pattern \\
|
|
|
|
|
path_to_project \\
|
|
|
|
|
name_project \\
|
|
|
|
|
python_version \\
|
|
|
|
|
kivy_version \\
|
|
|
|
|
--name_screen FirstScreen SecondScreen ThirdScreen \\
|
|
|
|
|
--use_responsive FirstScreen SecondScreen
|
|
|
|
|
|
|
|
|
|
The `FirstScreen` and `SecondScreen` views will be created with an responsive
|
|
|
|
|
architecture. For more detailed information about using the adaptive view, see
|
|
|
|
|
the `MDResponsiveLayout <https://kivymd.readthedocs.io/en/latest/components/responsivelayout/>`_
|
|
|
|
|
widget.
|
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
Others command line arguments
|
2022-10-02 11:16:59 -04:00
|
|
|
|
=============================
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
Required Arguments
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
- pattern
|
|
|
|
|
- the name of the pattern with which the project will be created
|
|
|
|
|
|
|
|
|
|
- directory
|
|
|
|
|
- directory in which the project will be created
|
|
|
|
|
|
|
|
|
|
- name
|
|
|
|
|
- project name
|
|
|
|
|
|
|
|
|
|
- python_version
|
|
|
|
|
- the version of Python (specify as `python3.9` or `python3.8`) with
|
|
|
|
|
- which the virtual environment will be created
|
|
|
|
|
|
|
|
|
|
- kivy_version
|
|
|
|
|
- version of Kivy (specify as `2.1.0` or `master`) that will be used in the project
|
|
|
|
|
|
|
|
|
|
Optional arguments
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
- name_screen
|
|
|
|
|
- the name of the class which be used when creating the project pattern
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
When you need to create an application template with multiple screens,
|
|
|
|
|
use multiple values separated by a space for the `name_screen` parameter,
|
|
|
|
|
for example, as shown below:
|
|
|
|
|
|
|
|
|
|
Template command::
|
|
|
|
|
|
|
|
|
|
kivymd.create_project \\
|
|
|
|
|
name_pattern \\
|
|
|
|
|
path_to_project \\
|
|
|
|
|
name_project \\
|
|
|
|
|
python_version \\
|
|
|
|
|
kivy_version \\
|
|
|
|
|
--name_screen FirstScreen SecondScreen ThirdScreen
|
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
- name_database
|
|
|
|
|
- provides a basic template for working with the 'firebase' library
|
|
|
|
|
- or a complete implementation for working with a database 'restdb.io'
|
|
|
|
|
|
|
|
|
|
- use_hotreload
|
|
|
|
|
- creates a hot reload entry point to the application
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
- use_localization
|
2022-07-07 16:16:10 -04:00
|
|
|
|
- creates application localization files
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
- use_responsive
|
|
|
|
|
- the name/names of the views to be used by the responsive UI
|
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
.. warning:: On Windows, hot reloading of Python files may not work.
|
|
|
|
|
But, for example, there is no such problem in macOS. If you fix this,
|
|
|
|
|
please report it to the KivyMD community.
|
|
|
|
|
"""
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
__all__ = [
|
|
|
|
|
"main",
|
|
|
|
|
]
|
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
import os
|
|
|
|
|
import re
|
|
|
|
|
import shutil
|
|
|
|
|
from typing import Union
|
|
|
|
|
|
|
|
|
|
from kivy import Logger, platform
|
|
|
|
|
|
|
|
|
|
from kivymd import path as kivymd_path
|
|
|
|
|
from kivymd.tools.argument_parser import ArgumentParserWithHelp
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_basemodel = '''# The model implements the observer pattern. This means that the class must
|
|
|
|
|
# support adding, removing, and alerting observers. In this case, the model is
|
|
|
|
|
# completely independent of controllers and views. It is important that all
|
|
|
|
|
# registered observers implement a specific method that will be called by the
|
|
|
|
|
# model when they are notified (in this case, it is the `model_is_changed`
|
|
|
|
|
# method). For this, observers must be descendants of an abstract class,
|
|
|
|
|
# inheriting which, the `model_is_changed` method must be overridden.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class BaseScreenModel:
|
|
|
|
|
"""Implements a base class for model modules."""
|
|
|
|
|
|
|
|
|
|
_observers = []
|
|
|
|
|
|
|
|
|
|
def add_observer(self, observer) -> None:
|
|
|
|
|
self._observers.append(observer)
|
|
|
|
|
|
|
|
|
|
def remove_observer(self, observer) -> None:
|
|
|
|
|
self._observers.remove(observer)
|
|
|
|
|
|
|
|
|
|
def notify_observers(self, name_screen: str) -> None:
|
|
|
|
|
"""
|
|
|
|
|
Method that will be called by the observer when the model data changes.
|
|
|
|
|
|
|
|
|
|
:param name_screen:
|
|
|
|
|
name of the view for which the method should be called
|
|
|
|
|
:meth:`model_is_changed`.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
for observer in self._observers:
|
|
|
|
|
if observer.name == name_screen:
|
|
|
|
|
observer.model_is_changed()
|
|
|
|
|
break
|
|
|
|
|
'''
|
|
|
|
|
|
|
|
|
|
temp_database_model = '''import multitasking
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
from Model.base_model import BaseScreenModel
|
|
|
|
|
|
|
|
|
|
multitasking.set_max_threads(10)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class {name_screen}Model(BaseScreenModel):
|
|
|
|
|
"""
|
|
|
|
|
Implements the logic of the
|
|
|
|
|
:class:`~View.{name_screen}.{module_name}.{name_screen}View` class.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
def __init__(self, database):
|
2022-10-02 11:16:59 -04:00
|
|
|
|
# Just an example of the data. Use your own values.
|
|
|
|
|
self._data = None
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
@property
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def data(self):
|
|
|
|
|
return self._data
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
@data.setter
|
|
|
|
|
def data(self, value):
|
|
|
|
|
self._data = value
|
2022-07-07 16:16:10 -04:00
|
|
|
|
# We notify the View -
|
|
|
|
|
# :class:`~View.{name_screen}.{module_name}.{name_screen}View` about the
|
|
|
|
|
# changes that have occurred in the data model.
|
|
|
|
|
self.notify_observers({notify_name_screen})
|
|
|
|
|
|
|
|
|
|
@multitasking.task
|
|
|
|
|
def check_data(self):
|
2022-10-02 11:16:59 -04:00
|
|
|
|
"""Just an example of the method. Use your own code."""
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
self.data = ["example item"]
|
2022-07-07 16:16:10 -04:00
|
|
|
|
'''
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_without_database_model = '''from Model.base_model import BaseScreenModel
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class {name_screen}Model(BaseScreenModel):
|
|
|
|
|
"""
|
|
|
|
|
Implements the logic of the
|
|
|
|
|
:class:`~View.{module_name}.{name_screen}.{name_screen}View` class.
|
|
|
|
|
"""'''
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_screens_imports = """# The screens dictionary contains the objects of the models and controllers
|
|
|
|
|
# of the screens of the application.
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
"""
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_code_responsive_view = '''from kivymd.uix.responsivelayout import MDResponsiveLayout
|
|
|
|
|
|
|
|
|
|
from View.{name_screen}.components import (
|
|
|
|
|
MobileScreenView,
|
|
|
|
|
TabletScreenView,
|
|
|
|
|
DesktopScreenView,
|
|
|
|
|
)
|
|
|
|
|
from View.base_screen import BaseScreenView
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class {name_screen}View(MDResponsiveLayout, BaseScreenView):
|
|
|
|
|
def __init__(self, **kw):
|
|
|
|
|
super().__init__(**kw)
|
|
|
|
|
self.mobile_view = MobileScreenView()
|
|
|
|
|
self.tablet_view = TabletScreenView()
|
|
|
|
|
self.desktop_view = DesktopScreenView()
|
|
|
|
|
|
|
|
|
|
def model_is_changed(self) -> None:
|
|
|
|
|
"""
|
|
|
|
|
Called whenever any change has occurred in the data model.
|
|
|
|
|
The view in this method tracks these changes and updates the UI
|
|
|
|
|
according to these changes.
|
|
|
|
|
"""
|
|
|
|
|
'''
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_responsive_component_imports = """from .platforms.MobileScreen.mobile_screen import MobileScreenView
|
|
|
|
|
from .platforms.TabletScreen.tablet_screen import TabletScreenView
|
|
|
|
|
from .platforms.DesktopScreen.desktop_screen import DesktopScreenView
|
|
|
|
|
"""
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_responsive_platform_baseclass = """from kivymd.uix.screen import MDScreen
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
class {}View(MDScreen):
|
|
|
|
|
pass
|
|
|
|
|
"""
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_code_view = '''from View.base_screen import BaseScreenView
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class {name_screen}View(BaseScreenView):
|
|
|
|
|
def model_is_changed(self) -> None:
|
|
|
|
|
"""
|
|
|
|
|
Called whenever any change has occurred in the data model.
|
|
|
|
|
The view in this method tracks these changes and updates the UI
|
|
|
|
|
according to these changes.
|
|
|
|
|
"""
|
2022-07-07 16:16:10 -04:00
|
|
|
|
'''
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_code_controller = '''{import_module}
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class {name_screen}Controller:
|
|
|
|
|
"""
|
|
|
|
|
The `{name_screen}Controller` class represents a controller implementation.
|
|
|
|
|
Coordinates work of the view with the model.
|
|
|
|
|
The controller implements the strategy pattern. The controller connects to
|
|
|
|
|
the view to control its actions.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
def __init__(self, model):
|
|
|
|
|
self.model = model # Model.{module_name}.{name_screen}Model
|
|
|
|
|
self.view = {name_view}(controller=self, model=self.model)
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def get_view(self) -> {get_view}:
|
|
|
|
|
return self.view
|
2022-07-07 16:16:10 -04:00
|
|
|
|
'''
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_base_screen = '''from kivy.properties import ObjectProperty
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
from kivymd.app import MDApp
|
|
|
|
|
from kivymd.theming import ThemableBehavior
|
|
|
|
|
from kivymd.uix.screen import MDScreen
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
from Utility.observer import Observer
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
class BaseScreenView(ThemableBehavior, MDScreen, Observer):
|
|
|
|
|
"""
|
|
|
|
|
A base class that implements a visual representation of the model data.
|
|
|
|
|
The view class must be inherited from this class.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
controller = ObjectProperty()
|
|
|
|
|
"""
|
|
|
|
|
Controller object - :class:`~Controller.controller_screen.ClassScreenControler`.
|
|
|
|
|
|
|
|
|
|
:attr:`controller` is an :class:`~kivy.properties.ObjectProperty`
|
|
|
|
|
and defaults to `None`.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
model = ObjectProperty()
|
|
|
|
|
"""
|
|
|
|
|
Model object - :class:`~Model.model_screen.ClassScreenModel`.
|
|
|
|
|
|
|
|
|
|
:attr:`model` is an :class:`~kivy.properties.ObjectProperty`
|
|
|
|
|
and defaults to `None`.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
manager_screens = ObjectProperty()
|
|
|
|
|
"""
|
|
|
|
|
Screen manager object - :class:`~kivymd.uix.screenmanager.MDScreenManager`.
|
|
|
|
|
|
|
|
|
|
:attr:`manager_screens` is an :class:`~kivy.properties.ObjectProperty`
|
|
|
|
|
and defaults to `None`.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
def __init__(self, **kw):
|
|
|
|
|
super().__init__(**kw)
|
|
|
|
|
# Often you need to get access to the application object from the view
|
|
|
|
|
# class. You can do this using this attribute.
|
|
|
|
|
self.app = MDApp.get_running_app()
|
|
|
|
|
# Adding a view class as observer.
|
|
|
|
|
self.model.add_observer(self)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
'''
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_utility = '''
|
|
|
|
|
# Of course, "very flexible Python" allows you to do without an abstract
|
|
|
|
|
# superclass at all or use the clever exception `NotImplementedError`. In my
|
|
|
|
|
# opinion, this can negatively affect the architecture of the application.
|
|
|
|
|
# I would like to point out that using Kivy, one could use the on-signaling
|
|
|
|
|
# model. In this case, when the state changes, the model will send a signal
|
|
|
|
|
# that can be received by all attached observers. This approach seems less
|
|
|
|
|
# universal - you may want to use a different library in the future.
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
class Observer:
|
|
|
|
|
"""Abstract superclass for all observers."""
|
|
|
|
|
|
|
|
|
|
def model_is_changed(self):
|
|
|
|
|
"""
|
|
|
|
|
The method that will be called on the observer when the model changes.
|
|
|
|
|
"""
|
|
|
|
|
'''
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_hot_reload_main = '''
|
2022-07-07 16:16:10 -04:00
|
|
|
|
"""
|
|
|
|
|
Script for managing hot reloading of the project.
|
|
|
|
|
For more details see the documentation page -
|
|
|
|
|
|
|
|
|
|
https://kivymd.readthedocs.io/en/latest/api/kivymd/tools/patterns/create_project/
|
|
|
|
|
|
|
|
|
|
To run the application in hot boot mode, execute the command in the console:
|
|
|
|
|
DEBUG=1 python main.py
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
import importlib
|
|
|
|
|
import os
|
|
|
|
|
|
|
|
|
|
from kivy import Config
|
|
|
|
|
|
|
|
|
|
from PIL import ImageGrab
|
|
|
|
|
|
|
|
|
|
# TODO: You may know an easier way to get the size of a computer display.
|
|
|
|
|
resolution = ImageGrab.grab().size
|
|
|
|
|
|
|
|
|
|
# Change the values of the application window size as you need.
|
|
|
|
|
Config.set("graphics", "height", resolution[1])
|
|
|
|
|
Config.set("graphics", "width", "400")
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
from kivy.core.window import Window{}
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
# Place the application window on the right side of the computer screen.
|
|
|
|
|
Window.top = 0
|
|
|
|
|
Window.left = resolution[0] - Window.width
|
|
|
|
|
|
|
|
|
|
from kivymd.tools.hotreload.app import MDApp
|
2022-10-02 11:16:59 -04:00
|
|
|
|
from kivymd.uix.screenmanager import MDScreenManager
|
|
|
|
|
{}{}
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
class {}(MDApp):
|
|
|
|
|
KV_DIRS = [os.path.join(os.getcwd(), "View")]{}
|
|
|
|
|
|
|
|
|
|
def build_app(self) -> MDScreenManager:
|
2022-07-07 16:16:10 -04:00
|
|
|
|
"""
|
|
|
|
|
In this method, you don't need to change anything other than the
|
|
|
|
|
application theme.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
import View.screens
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
self.manager_screens = MDScreenManager(){}{}
|
2022-07-07 16:16:10 -04:00
|
|
|
|
Window.bind(on_key_down=self.on_keyboard_down)
|
|
|
|
|
importlib.reload(View.screens)
|
|
|
|
|
screens = View.screens.screens
|
|
|
|
|
|
|
|
|
|
for i, name_screen in enumerate(screens.keys()):
|
2022-10-02 11:16:59 -04:00
|
|
|
|
model = screens[name_screen]["model"]({})
|
2022-07-07 16:16:10 -04:00
|
|
|
|
controller = screens[name_screen]["controller"](model)
|
|
|
|
|
view = controller.get_view()
|
|
|
|
|
view.manager_screens = self.manager_screens
|
|
|
|
|
view.name = name_screen
|
|
|
|
|
self.manager_screens.add_widget(view)
|
|
|
|
|
|
|
|
|
|
return self.manager_screens
|
|
|
|
|
|
|
|
|
|
def on_keyboard_down(self, window, keyboard, keycode, text, modifiers) -> None:
|
|
|
|
|
"""
|
|
|
|
|
The method handles keyboard events.
|
|
|
|
|
|
|
|
|
|
By default, a forced restart of an application is tied to the
|
|
|
|
|
`CTRL+R` key on Windows OS and `COMMAND+R` on Mac OS.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
if "meta" in modifiers or "ctrl" in modifiers and text == "r":
|
2022-10-02 11:16:59 -04:00
|
|
|
|
self.rebuild(){}{}
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
{}().run()
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
# After you finish the project, remove the above code and uncomment the below
|
|
|
|
|
# code to test the application normally without hot reloading.
|
|
|
|
|
'''
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_main = '''"""
|
|
|
|
|
The entry point to the application.
|
|
|
|
|
|
|
|
|
|
The application uses the MVC template. Adhering to the principles of clean
|
|
|
|
|
architecture means ensuring that your application is easy to test, maintain,
|
|
|
|
|
and modernize.
|
|
|
|
|
|
|
|
|
|
You can read more about this template at the links below:
|
|
|
|
|
|
|
|
|
|
https://github.com/HeaTTheatR/LoginAppMVC
|
|
|
|
|
https://en.wikipedia.org/wiki/Model–view–controller
|
|
|
|
|
"""
|
|
|
|
|
{}
|
|
|
|
|
from kivymd.app import MDApp
|
|
|
|
|
from kivymd.uix.screenmanager import MDScreenManager
|
|
|
|
|
|
|
|
|
|
from View.screens import screens{}
|
|
|
|
|
{}
|
|
|
|
|
|
|
|
|
|
class {}(MDApp):{}
|
|
|
|
|
def __init__(self, **kwargs):
|
|
|
|
|
super().__init__(**kwargs){}
|
|
|
|
|
self.load_all_kv_files(self.directory)
|
|
|
|
|
# This is the screen manager that will contain all the screens of your
|
|
|
|
|
# application.
|
|
|
|
|
self.manager_screens = MDScreenManager()
|
|
|
|
|
{}
|
|
|
|
|
def build(self) -> MDScreenManager:
|
|
|
|
|
self.generate_application_screens()
|
|
|
|
|
return self.manager_screens
|
|
|
|
|
|
|
|
|
|
def generate_application_screens(self) -> None:
|
|
|
|
|
"""
|
|
|
|
|
Creating and adding screens to the screen manager.
|
|
|
|
|
You should not change this cycle unnecessarily. He is self-sufficient.
|
|
|
|
|
|
|
|
|
|
If you need to add any screen, open the `View.screens.py` module and
|
|
|
|
|
see how new screens are added according to the given application
|
|
|
|
|
architecture.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
for i, name_screen in enumerate(screens.keys()):
|
|
|
|
|
model = screens[name_screen]["model"]({})
|
|
|
|
|
controller = screens[name_screen]["controller"](model)
|
|
|
|
|
view = controller.get_view()
|
|
|
|
|
view.manager_screens = self.manager_screens
|
|
|
|
|
view.name = name_screen
|
|
|
|
|
self.manager_screens.add_widget(view)
|
|
|
|
|
{}{}
|
|
|
|
|
|
|
|
|
|
{}().run()
|
|
|
|
|
'''
|
|
|
|
|
|
|
|
|
|
temp_makefile = """# FILE TO FIND AND CREATE LOCALIZATION FILES FOR YOUR APPLICATION. \\
|
|
|
|
|
\\
|
|
|
|
|
In this file, you can specify in which files of your project to search for \\
|
|
|
|
|
localization strings. \\
|
|
|
|
|
These files should be listed in the below command: \\
|
|
|
|
|
\\
|
|
|
|
|
\\
|
|
|
|
|
xgettext -Lpython --output=messages.pot --from-code=utf-8 \\
|
|
|
|
|
path/to/file-1 \\
|
|
|
|
|
path/to/file-2 \\
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
.PHONY: po mo
|
|
|
|
|
|
|
|
|
|
po:
|
|
|
|
|
xgettext -Lpython --output=messages.pot --from-code=utf-8 \\
|
|
|
|
|
{}
|
|
|
|
|
msgmerge --update --no-fuzzy-matching --backup=off data/locales/po/en.po messages.pot
|
|
|
|
|
msgmerge --update --no-fuzzy-matching --backup=off data/locales/po/ru.po messages.pot
|
|
|
|
|
|
|
|
|
|
mo:
|
|
|
|
|
mkdir -p data/locales/en/LC_MESSAGES
|
|
|
|
|
mkdir -p data/locales/ru/LC_MESSAGES
|
|
|
|
|
msgfmt -c -o data/locales/en/LC_MESSAGES/%s.mo data/locales/po/en.po
|
|
|
|
|
msgfmt -c -o data/locales/ru/LC_MESSAGES/%s.mo data/locales/po/ru.po
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
firebase_requirements = """kivy==2.1.0
|
|
|
|
|
kivymd==1.0.0
|
|
|
|
|
multitasking
|
|
|
|
|
firebase
|
|
|
|
|
firebase-admin
|
|
|
|
|
python_jwt
|
|
|
|
|
gcloud
|
|
|
|
|
sseclient
|
|
|
|
|
pycryptodome==3.4.3
|
|
|
|
|
requests_toolbelt
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
without_firebase_requirements = """kivy==2.1.0
|
|
|
|
|
kivymd==1.0.0
|
|
|
|
|
"""
|
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
available_patterns = ["MVC"]
|
|
|
|
|
available_databases = ["firebase", "restdb"]
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
path_to_project = ""
|
|
|
|
|
project_name = ""
|
|
|
|
|
use_localization = ""
|
|
|
|
|
name_database = ""
|
|
|
|
|
use_hotreload = ""
|
|
|
|
|
temp_makefile_files = ""
|
|
|
|
|
temp_screens_data = ""
|
|
|
|
|
kivy_version = ""
|
|
|
|
|
python_version = ""
|
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
def main():
|
2022-10-02 11:16:59 -04:00
|
|
|
|
"""Project creation function."""
|
|
|
|
|
|
|
|
|
|
global project_name
|
|
|
|
|
global use_localization
|
|
|
|
|
global name_database
|
|
|
|
|
global use_hotreload
|
|
|
|
|
global temp_makefile_files
|
|
|
|
|
global temp_screens_data
|
|
|
|
|
global path_to_project
|
|
|
|
|
global kivy_version
|
|
|
|
|
global python_version
|
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
parser = create_argument_parser()
|
|
|
|
|
args = parser.parse_args()
|
|
|
|
|
|
|
|
|
|
pattern_name = args.pattern
|
|
|
|
|
project_directory = args.directory
|
|
|
|
|
project_name = "".join(args.name.split(" "))
|
|
|
|
|
kivy_version = args.kivy_version
|
|
|
|
|
python_version = args.python_version
|
|
|
|
|
if "3" not in python_version:
|
|
|
|
|
parser.error("Python must be at least version 3")
|
2022-10-02 11:16:59 -04:00
|
|
|
|
name_screen = args.name_screen
|
2022-07-07 16:16:10 -04:00
|
|
|
|
path_to_project = os.path.join(project_directory, project_name)
|
|
|
|
|
name_database = args.name_database
|
|
|
|
|
if name_database != "no" and name_database not in available_databases:
|
|
|
|
|
parser.error(
|
|
|
|
|
f"The database name must be one of the {available_databases} list"
|
|
|
|
|
)
|
|
|
|
|
use_hotreload = args.use_hotreload
|
|
|
|
|
use_localization = args.use_localization
|
2022-10-02 11:16:59 -04:00
|
|
|
|
use_responsive = args.use_responsive
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
# Check arguments.
|
2022-10-02 11:16:59 -04:00
|
|
|
|
for name in name_screen:
|
|
|
|
|
if name[-6:] != "Screen":
|
|
|
|
|
parser.error(
|
|
|
|
|
f"The name of the {name} screen should contain the word "
|
|
|
|
|
f"'Screen' at the end.\n"
|
|
|
|
|
"For example - '--name_screen MyFirstScreen ...'"
|
|
|
|
|
)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
if not os.path.exists(
|
|
|
|
|
os.path.join(kivymd_path, "tools", "patterns", pattern_name)
|
|
|
|
|
):
|
|
|
|
|
parser.error(
|
|
|
|
|
f"There is no {pattern_name} pattern.\n"
|
|
|
|
|
f"Only {available_patterns} template is available."
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
# Call the functions of creating a project.
|
|
|
|
|
if not os.path.exists(path_to_project):
|
|
|
|
|
shutil.copytree(
|
|
|
|
|
os.path.join(kivymd_path, "tools", "patterns", pattern_name),
|
|
|
|
|
path_to_project,
|
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
create_main()
|
|
|
|
|
|
|
|
|
|
for name in name_screen:
|
|
|
|
|
module_name = chek_camel_case_name_project(name)
|
|
|
|
|
if not module_name:
|
|
|
|
|
parser.error(
|
|
|
|
|
"The name of the screen should be written in camel case style. "
|
|
|
|
|
"\nFor example - 'MyFirstScreen'"
|
|
|
|
|
)
|
|
|
|
|
module_name = "_".join([name.lower() for name in module_name])
|
|
|
|
|
|
|
|
|
|
# Create models module.
|
|
|
|
|
create_model(name, module_name, name_database, path_to_project)
|
|
|
|
|
# Create controllers module.
|
|
|
|
|
create_controller(name, module_name, use_hotreload, path_to_project)
|
|
|
|
|
# Create screens data.
|
|
|
|
|
create_screens_data(name, module_name)
|
|
|
|
|
if use_localization == "yes":
|
|
|
|
|
# Create makefile data.
|
|
|
|
|
create_makefile_data(name, module_name)
|
|
|
|
|
# Create views.
|
|
|
|
|
create_view(name, module_name, use_responsive, path_to_project)
|
|
|
|
|
|
|
|
|
|
# Create module `NameProject/View/NameScreen/components/common/__init__.py`.
|
|
|
|
|
create_common_responsive_module(use_responsive, path_to_project)
|
|
|
|
|
# Create module `NameProject/View/screens.py`.
|
|
|
|
|
create_module_screens()
|
|
|
|
|
# Create module `NameProject/Model/base_model.py`.
|
|
|
|
|
create_basemodel()
|
|
|
|
|
# Create module `NameProject/View/base_screen.py`.
|
|
|
|
|
create_module_basescreen()
|
|
|
|
|
# Create package `NameProject/Utility`.
|
|
|
|
|
create_package_utility()
|
|
|
|
|
# Create file `NameProject/Makefile`.
|
|
|
|
|
if use_localization == "yes":
|
|
|
|
|
# Create makefile data.
|
|
|
|
|
create_makefile()
|
|
|
|
|
|
|
|
|
|
create_requirements()
|
2022-07-07 16:16:10 -04:00
|
|
|
|
os.makedirs(os.path.join(path_to_project, "assets", "images"))
|
|
|
|
|
os.mkdir(os.path.join(path_to_project, "assets", "fonts"))
|
|
|
|
|
|
|
|
|
|
if name_database != "no":
|
2022-10-02 11:16:59 -04:00
|
|
|
|
check_databases()
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
if use_hotreload == "yes":
|
2022-10-02 11:16:59 -04:00
|
|
|
|
create_main_with_hotreload()
|
2022-07-07 16:16:10 -04:00
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "requirements.txt"),
|
|
|
|
|
"a",
|
|
|
|
|
encoding="utf-8",
|
|
|
|
|
) as requirements:
|
|
|
|
|
requirements.write("watchdog")
|
|
|
|
|
|
|
|
|
|
if use_localization == "yes":
|
|
|
|
|
Logger.info("KivyMD: Create localization files...")
|
2022-10-02 11:16:59 -04:00
|
|
|
|
os.chdir(path_to_project)
|
|
|
|
|
os.system("make po")
|
|
|
|
|
os.system("make mo")
|
2022-07-07 16:16:10 -04:00
|
|
|
|
else:
|
|
|
|
|
os.remove(os.path.join(path_to_project, "messages.pot"))
|
|
|
|
|
os.remove(os.path.join(path_to_project, "libs", "translation.py"))
|
|
|
|
|
shutil.rmtree(os.path.join(path_to_project, "data"))
|
2022-10-02 11:16:59 -04:00
|
|
|
|
|
2022-07-07 16:16:10 -04:00
|
|
|
|
Logger.info(f"KivyMD: Project '{path_to_project}' created")
|
|
|
|
|
Logger.info(
|
|
|
|
|
f"KivyMD: Create a virtual environment for '{path_to_project}' project..."
|
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
create_virtual_environment()
|
2022-07-07 16:16:10 -04:00
|
|
|
|
Logger.info(
|
|
|
|
|
f"KivyMD: Install requirements for '{path_to_project}' project..."
|
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
install_requirements()
|
|
|
|
|
os.remove(os.path.join(path_to_project, "__init__.py"))
|
|
|
|
|
if name_database == "no":
|
|
|
|
|
os.remove(
|
|
|
|
|
os.path.join(path_to_project, "Model", "database_firebase.py")
|
|
|
|
|
)
|
|
|
|
|
os.remove(
|
|
|
|
|
os.path.join(path_to_project, "Model", "database_restdb.py")
|
|
|
|
|
)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
else:
|
|
|
|
|
parser.error(f"The {path_to_project} project already exists")
|
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def create_main_with_hotreload() -> None:
|
2022-07-07 16:16:10 -04:00
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "main.py"), encoding="utf-8"
|
|
|
|
|
) as main_file:
|
|
|
|
|
main_code = ""
|
|
|
|
|
for string in main_file.readlines():
|
|
|
|
|
main_code += f"# {string}"
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "main.py"), "w", encoding="utf-8"
|
|
|
|
|
) as main_file:
|
2022-10-02 11:16:59 -04:00
|
|
|
|
main_file.write(f"{temp_hot_reload_main}\n{main_code}")
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "main.py"), encoding="utf-8"
|
|
|
|
|
) as main_file:
|
|
|
|
|
main_code = main_file.read()
|
|
|
|
|
main_code = main_code.format(
|
|
|
|
|
"\nfrom kivy.properties import StringProperty\n"
|
2022-07-07 16:16:10 -04:00
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"\nfrom Model.database import DataBase"
|
|
|
|
|
if name_database != "no"
|
|
|
|
|
else "",
|
|
|
|
|
"\nfrom libs.translation import Translation\n"
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
project_name,
|
|
|
|
|
'\n lang = StringProperty("en")\n'
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"\n self.base = DataBase()\n"
|
|
|
|
|
if name_database != "no"
|
|
|
|
|
else "",
|
|
|
|
|
"\n self.translation = Translation(\n"
|
2022-10-02 11:16:59 -04:00
|
|
|
|
' self.lang, "%s", os.path.join(self.directory, "data", "locales")'
|
2022-07-07 16:16:10 -04:00
|
|
|
|
"\n )" % project_name
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"self.database" if name_database != "no" else "",
|
|
|
|
|
"\n\n def on_lang(self, instance_app, lang_value: str) -> None:\n"
|
|
|
|
|
" self.translation.switch_lang(lang_value)\n"
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"\n def switch_lang(self) -> None:\n"
|
|
|
|
|
' """Switch lang."""\n\n'
|
|
|
|
|
' self.lang = "ru" if self.lang == "en" else "en"'
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
project_name,
|
2022-10-02 11:16:59 -04:00
|
|
|
|
)
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "main.py"), "w", encoding="utf-8"
|
|
|
|
|
) as main_module:
|
|
|
|
|
main_module.write(main_code)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_main() -> None:
|
|
|
|
|
main_code = temp_main.format(
|
|
|
|
|
"\nfrom kivy.properties import StringProperty\n"
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"\nfrom libs.translation import Translation"
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"from Model.database import DataBase\n"
|
|
|
|
|
if name_database != "no"
|
|
|
|
|
else "",
|
|
|
|
|
project_name,
|
|
|
|
|
'\n lang = StringProperty("en")\n'
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"\n self.translation = Translation(\n"
|
|
|
|
|
' self.lang, "%s", os.path.join(self.directory, "data", "locales")'
|
|
|
|
|
"\n )" % project_name
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"self.database = DataBase()\n" if name_database != "no" else "",
|
|
|
|
|
"self.database" if name_database != "no" else "",
|
|
|
|
|
"\n def on_lang(self, instance_app, lang_value: str) -> None:\n"
|
|
|
|
|
" self.translation.switch_lang(lang_value)\n"
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
"\n def switch_lang(self) -> None:\n"
|
|
|
|
|
' """Switch lang."""\n\n'
|
|
|
|
|
' self.lang = "ru" if self.lang == "en" else "en"\n'
|
|
|
|
|
if use_localization == "yes"
|
|
|
|
|
else "",
|
|
|
|
|
project_name,
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "main.py"), "w", encoding="utf-8"
|
|
|
|
|
) as main_module:
|
|
|
|
|
main_module.write(main_code)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_model(
|
2022-10-02 11:16:59 -04:00
|
|
|
|
name_screen: str, module_name: str, name_database: str, path_to_project: str
|
2022-07-07 16:16:10 -04:00
|
|
|
|
) -> None:
|
|
|
|
|
if name_database != "no":
|
2022-10-02 11:16:59 -04:00
|
|
|
|
code_model = temp_database_model.format(
|
2022-07-07 16:16:10 -04:00
|
|
|
|
name_screen=name_screen,
|
|
|
|
|
module_name=module_name,
|
|
|
|
|
notify_name_screen=f'"{" ".join(module_name.split("_"))}"',
|
|
|
|
|
)
|
|
|
|
|
else:
|
2022-10-02 11:16:59 -04:00
|
|
|
|
code_model = temp_without_database_model.format(
|
2022-07-07 16:16:10 -04:00
|
|
|
|
module_name=module_name, name_screen=name_screen
|
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
|
|
|
|
|
model_module = os.path.join(path_to_project, "Model", module_name)
|
|
|
|
|
with open(f"{model_module}.py", "w", encoding="utf-8") as module:
|
|
|
|
|
module.write(code_model)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_basemodel() -> None:
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "Model", "base_model.py"),
|
|
|
|
|
"w",
|
|
|
|
|
encoding="utf-8",
|
|
|
|
|
) as module_basemodel:
|
|
|
|
|
module_basemodel.write(temp_basemodel)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_module_basescreen() -> None:
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "View", "base_screen.py"),
|
|
|
|
|
"w",
|
|
|
|
|
encoding="utf-8",
|
|
|
|
|
) as base_screen:
|
|
|
|
|
base_screen.write(temp_base_screen)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_controller(
|
2022-10-02 11:16:59 -04:00
|
|
|
|
name_screen: str, module_name: str, use_hotreload: str, path_to_project: str
|
2022-07-07 16:16:10 -04:00
|
|
|
|
) -> None:
|
|
|
|
|
name_view = (
|
|
|
|
|
f"View.{name_screen}.{module_name}.{name_screen}View"
|
|
|
|
|
if use_hotreload == "yes"
|
|
|
|
|
else f"{name_screen}View"
|
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
code_controller = temp_code_controller.format(
|
2022-07-07 16:16:10 -04:00
|
|
|
|
name_screen=name_screen,
|
|
|
|
|
module_name=module_name,
|
|
|
|
|
import_module=""
|
|
|
|
|
f"import importlib\n\n"
|
|
|
|
|
f"import View.{name_screen}.{module_name}\n\n"
|
|
|
|
|
f"# We have to manually reload the view module in order to apply the\n"
|
|
|
|
|
f"# changes made to the code on a subsequent hot reload.\n"
|
|
|
|
|
f"# If you no longer need a hot reload, you can delete this instruction.\n"
|
2022-10-02 11:16:59 -04:00
|
|
|
|
f"importlib.reload(View.{name_screen}.{module_name})\n\n"
|
2022-07-07 16:16:10 -04:00
|
|
|
|
if use_hotreload == "yes"
|
|
|
|
|
else f"\nfrom View.{name_screen}.{module_name} import {name_screen}View",
|
|
|
|
|
name_view=name_view,
|
2022-10-02 11:16:59 -04:00
|
|
|
|
get_view=f"View.{name_screen}.{module_name}"
|
|
|
|
|
if use_hotreload == "yes"
|
|
|
|
|
else f"{name_screen}View",
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
path_to_controller = os.path.join(path_to_project, "Controller")
|
|
|
|
|
if not os.path.exists(path_to_controller):
|
|
|
|
|
os.mkdir(path_to_controller)
|
|
|
|
|
controller_module = os.path.join(path_to_project, "Controller", module_name)
|
|
|
|
|
with open(f"{controller_module}.py", "w", encoding="utf-8") as module:
|
|
|
|
|
module.write(code_controller)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
|
|
|
|
|
def create_makefile() -> None:
|
|
|
|
|
makefile = temp_makefile.format(temp_makefile_files[:-2])
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "Makefile"), "w", encoding="utf-8"
|
|
|
|
|
) as make_file:
|
|
|
|
|
make_file.write(makefile)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_makefile_data(name_screen: str, module_name: str) -> None:
|
|
|
|
|
global temp_makefile_files
|
|
|
|
|
|
|
|
|
|
temp_makefile_files += (
|
|
|
|
|
f" View/{name_screen}/{module_name}.py \\\n"
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_makefile_files += (
|
|
|
|
|
f" View/{name_screen}/{module_name}.kv \\\n"
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_screens_data(name_screen: str, module_name: str) -> None:
|
|
|
|
|
global temp_screens_imports
|
|
|
|
|
global temp_screens_data
|
|
|
|
|
|
|
|
|
|
temp_screens_imports += (
|
|
|
|
|
f"from Model.{module_name} import {name_screen}Model\n"
|
|
|
|
|
f"from Controller.{module_name} import {name_screen}Controller\n"
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
temp_screens_data += (
|
|
|
|
|
'\n %s: {\n "model": %s,'
|
|
|
|
|
'\n "controller": %s,\n },\n'
|
|
|
|
|
% (
|
|
|
|
|
f'"{" ".join(module_name.split("_"))}"',
|
2022-07-07 16:16:10 -04:00
|
|
|
|
f"{name_screen}Model",
|
|
|
|
|
f"{name_screen}Controller",
|
2022-10-02 11:16:59 -04:00
|
|
|
|
)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def create_module_screens() -> None:
|
|
|
|
|
path_to_module_screens = os.path.join(path_to_project, "View", "screens.py")
|
|
|
|
|
with open(path_to_module_screens, "w", encoding="utf-8") as module_screens:
|
|
|
|
|
module_screens.write(
|
|
|
|
|
"%s\nscreens = {%s}" % (temp_screens_imports, temp_screens_data)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def create_common_responsive_module(
|
|
|
|
|
use_responsive: list, path_to_project: str
|
2022-07-07 16:16:10 -04:00
|
|
|
|
) -> None:
|
2022-10-02 11:16:59 -04:00
|
|
|
|
for name_screen in use_responsive:
|
|
|
|
|
path_to_init_common = os.path.join(
|
|
|
|
|
path_to_project, "View", name_screen, "components", "common"
|
|
|
|
|
)
|
|
|
|
|
os.makedirs(path_to_init_common)
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_init_common, "__init__.py"),
|
|
|
|
|
"w",
|
|
|
|
|
encoding="utf-8",
|
|
|
|
|
) as init_common_components:
|
|
|
|
|
init_common_components.write(
|
|
|
|
|
"# This directory is for common responsive design components\n"
|
|
|
|
|
)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def create_view(
|
|
|
|
|
name_screen: str,
|
|
|
|
|
module_name: str,
|
|
|
|
|
use_responsive: list,
|
|
|
|
|
path_to_project: str,
|
2022-07-07 16:16:10 -04:00
|
|
|
|
) -> None:
|
2022-10-02 11:16:59 -04:00
|
|
|
|
path_to_view = os.path.join(path_to_project, "View", name_screen)
|
|
|
|
|
path_to_components = os.path.join(path_to_view, "components")
|
|
|
|
|
view_module = os.path.join(path_to_view, module_name)
|
|
|
|
|
os.makedirs(path_to_view)
|
|
|
|
|
os.makedirs(path_to_components)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_view, "__init__.py"), "w", encoding="utf-8"
|
|
|
|
|
) as init_module:
|
|
|
|
|
init_module.write("")
|
|
|
|
|
with open(f"{view_module}.py", "w", encoding="utf-8") as view_file:
|
|
|
|
|
view_file.write(
|
|
|
|
|
temp_code_view.format(name_screen=name_screen)
|
|
|
|
|
if name_screen not in use_responsive
|
|
|
|
|
else temp_code_responsive_view.format(name_screen=name_screen)
|
|
|
|
|
)
|
2022-07-07 16:16:10 -04:00
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
if name_screen in use_responsive:
|
|
|
|
|
for name_platform in ["DesktopScreen", "MobileScreen", "TabletScreen"]:
|
|
|
|
|
path_to_init_components = os.path.join(
|
|
|
|
|
path_to_project,
|
|
|
|
|
"View",
|
|
|
|
|
name_screen,
|
|
|
|
|
"components",
|
|
|
|
|
"__init__.py",
|
|
|
|
|
)
|
|
|
|
|
path_to_platforms = os.path.join(
|
|
|
|
|
path_to_project, "View", name_screen, "components", "platforms"
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
path_to_platform = os.path.join(path_to_platforms, name_platform)
|
|
|
|
|
path_to_platform_components = os.path.join(
|
|
|
|
|
path_to_platform, "components"
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
os.makedirs(path_to_platform_components)
|
|
|
|
|
shutil.copy(
|
|
|
|
|
os.path.join(path_to_view, "__init__.py"),
|
|
|
|
|
path_to_platform_components,
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
shutil.copy(
|
|
|
|
|
os.path.join(path_to_view, "__init__.py"), path_to_platforms
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
2022-10-02 11:16:59 -04:00
|
|
|
|
|
|
|
|
|
name_platform_module = (
|
|
|
|
|
f'{name_platform.split("Screen")[0].lower()}_screen'
|
|
|
|
|
)
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_platform, f"{name_platform_module}.kv"),
|
|
|
|
|
"w",
|
|
|
|
|
encoding="utf-8",
|
|
|
|
|
) as platform_rule:
|
|
|
|
|
platform_rule.write(f"<{name_platform}View>\n")
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_platform, f"{name_platform_module}.py"),
|
|
|
|
|
"w",
|
|
|
|
|
encoding="utf-8",
|
|
|
|
|
) as platform_baseclass:
|
|
|
|
|
platform_baseclass.write(
|
|
|
|
|
temp_responsive_platform_baseclass.format(name_platform)
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
with open(
|
|
|
|
|
path_to_init_components, "w", encoding="utf-8"
|
|
|
|
|
) as init_components:
|
|
|
|
|
init_components.write(temp_responsive_component_imports)
|
|
|
|
|
|
|
|
|
|
with open(f"{view_module}.kv", "w", encoding="utf-8") as view_file:
|
|
|
|
|
view_file.write(f"<{name_screen}View>\n")
|
|
|
|
|
|
|
|
|
|
if name_screen not in use_responsive:
|
|
|
|
|
shutil.copy(
|
|
|
|
|
os.path.join(path_to_view, "__init__.py"), path_to_components
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def create_package_utility() -> None:
|
|
|
|
|
path_to_utility = os.path.join(path_to_project, "Utility")
|
|
|
|
|
os.mkdir(path_to_utility)
|
|
|
|
|
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_utility, "__init__.py"), "w", encoding="utf-8"
|
|
|
|
|
) as init_module:
|
|
|
|
|
init_module.write("")
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_utility, "observer.py"), "w", encoding="utf-8"
|
|
|
|
|
) as observer:
|
|
|
|
|
observer.write(temp_utility)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_requirements() -> None:
|
|
|
|
|
with open(
|
|
|
|
|
os.path.join(path_to_project, "requirements.txt"), "w", encoding="utf-8"
|
|
|
|
|
) as requirements:
|
|
|
|
|
requirements.write(
|
|
|
|
|
firebase_requirements
|
|
|
|
|
if name_database == "firebase"
|
|
|
|
|
else without_firebase_requirements
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_virtual_environment() -> None:
|
|
|
|
|
os.system(f"{python_version} -m pip install virtualenv")
|
|
|
|
|
os.system(
|
|
|
|
|
f"virtualenv -p {python_version} {os.path.join(path_to_project, 'venv')}"
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def install_requirements() -> None:
|
2022-07-07 16:16:10 -04:00
|
|
|
|
python = os.path.join(path_to_project, "venv", "bin", "python3")
|
|
|
|
|
if kivy_version == "master":
|
|
|
|
|
if platform == "macosx":
|
|
|
|
|
os.system(
|
|
|
|
|
f"{python} -m pip install 'kivy[base] @ https://github.com/kivy/kivy/archive/master.zip'"
|
|
|
|
|
)
|
|
|
|
|
else:
|
|
|
|
|
os.system(
|
|
|
|
|
f"{python} -m pip install https://github.com/kivy/kivy/archive/master.zip"
|
|
|
|
|
)
|
|
|
|
|
elif kivy_version == "stable":
|
|
|
|
|
os.system(f"{python} -m pip install kivy")
|
|
|
|
|
else:
|
|
|
|
|
os.system(f"{python} -m pip install kivy=={kivy_version}")
|
|
|
|
|
os.system(
|
|
|
|
|
f"{python} -m pip install https://github.com/kivymd/KivyMD/archive/master.zip"
|
|
|
|
|
)
|
|
|
|
|
os.system(f"{python} -m pip install watchdog")
|
|
|
|
|
if name_database == "firebase":
|
|
|
|
|
os.system(
|
|
|
|
|
f"{python} -m pip install "
|
|
|
|
|
f"multitasking "
|
|
|
|
|
f"firebase "
|
|
|
|
|
f"firebase-admin "
|
|
|
|
|
f"python_jwt "
|
|
|
|
|
f"gcloud "
|
|
|
|
|
f"sseclient "
|
|
|
|
|
f"pycryptodome==3.4.3 "
|
|
|
|
|
f"requests_toolbelt "
|
|
|
|
|
f"watchdog "
|
|
|
|
|
)
|
|
|
|
|
os.system(
|
|
|
|
|
f"{os.path.join(path_to_project, 'venv', 'bin', 'python3')} -m pip list"
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
2022-10-02 11:16:59 -04:00
|
|
|
|
def check_databases() -> None:
|
2022-07-07 16:16:10 -04:00
|
|
|
|
databases = {"firebase": "restdb", "restdb": "firebase"}
|
|
|
|
|
os.remove(
|
|
|
|
|
os.path.join(
|
|
|
|
|
path_to_project, "Model", f"database_{databases[name_database]}.py"
|
|
|
|
|
)
|
|
|
|
|
)
|
|
|
|
|
os.rename(
|
|
|
|
|
os.path.join(path_to_project, "Model", f"database_{name_database}.py"),
|
|
|
|
|
os.path.join(path_to_project, "Model", "database.py"),
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def chek_camel_case_name_project(name_project) -> Union[bool, list]:
|
|
|
|
|
result = re.findall("[A-Z][a-z]*", name_project)
|
|
|
|
|
if len(result) == 1:
|
|
|
|
|
return False
|
|
|
|
|
return result
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_argument_parser() -> ArgumentParserWithHelp:
|
|
|
|
|
parser = ArgumentParserWithHelp(
|
|
|
|
|
prog="create_project.py",
|
|
|
|
|
allow_abbrev=False,
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"pattern",
|
|
|
|
|
help="the name of the pattern with which the project will be created.",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"directory",
|
|
|
|
|
help="directory in which the project will be created.",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"name",
|
|
|
|
|
help="project name.",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"python_version",
|
|
|
|
|
help="the version of Python (specify as `python3.9` or `python3.8`) "
|
|
|
|
|
"with which the virtual environment will be created.",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"kivy_version",
|
|
|
|
|
help="version of Kivy (specify as `2.1.0` or `master`) that will be "
|
|
|
|
|
"used in the project.",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"--name_screen",
|
2022-10-02 11:16:59 -04:00
|
|
|
|
nargs="*",
|
|
|
|
|
type=str,
|
|
|
|
|
default=["MainScreen"],
|
|
|
|
|
help="the name/names of the class which be used when creating the project pattern.",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"--use_responsive",
|
|
|
|
|
nargs="*",
|
|
|
|
|
type=str,
|
|
|
|
|
default=[],
|
|
|
|
|
help="the name/names of the views to be used by the responsive UI.",
|
2022-07-07 16:16:10 -04:00
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"--name_database",
|
|
|
|
|
default="no",
|
|
|
|
|
help="name of the database provider ('firebase' or 'restdb').",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"--use_hotreload",
|
|
|
|
|
default="no",
|
|
|
|
|
help="creates a hot reload entry point to the application.",
|
|
|
|
|
)
|
|
|
|
|
parser.add_argument(
|
|
|
|
|
"--use_localization",
|
|
|
|
|
default="no",
|
|
|
|
|
help="creates application localization files.",
|
|
|
|
|
)
|
|
|
|
|
return parser
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
if __name__ == "__main__":
|
|
|
|
|
main()
|