6. project¶
Last page update: September 22, 2015
6.1. introduction¶
In this section we explain how to build a Genro project database management.
The Genro applications (or projects) are divided into several layers, allowing customization and reuse of code and resources among various projects.
A Genropy Project is structured in a main
project
folder with 4 subfolders, called:sites
,instances
,packages
andresources
.(in the image, ``projectName`` is the name of the project)
Let’s introduce the 4 subfolders:
The
instances
folder:
It contains customizations for the particular customer
Usually contains parameters for database access
It has a
data
subfolder that you can use to store data in filesystemsWhen working with the Python interpreter or command line tools, usually working at the instance:
#!python from gnr.app.gnrapp import GnrApp instance = GnrApp('name_of_project')More information in the instances section.
The
packages
folder:
It contains the various modules that make up the application code to Genro [1].
Note
the Genro packages are not Python packages (not a set of linked modules, containing a file
__init__.py
), and Genro packages can’t be imported with the statementimport
module or withfrom
moduleimport
More information in the packages section.
The
resources
folder:
- It is a place for a lot of useful tool, like components (python modules), CSS files, js scripts, and so on.
- You will use it for all the common tools of your project.
For an introduction to the resources, please check the resources page.
The
sites
folder:
- It deals with everything related to the configuration of a particular installation
- It includes Web components and configurations that are necessary for the execution over the Web
- Typically, it contains the configuration and WSGI script (it is used as the executable if you want to use a debugger, like WingIDE)
More information in the sites section
6.2. section_index¶
Footnotes:
[1] | Genro provides additional modules that implement common functions for all the applications (user management, table of Italian municipalities...) |