7. project

Last page update: November 10, 2011

• introduction
• section_index

7.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 and resources.

(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 filesystems

  • When 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 statement import module or with from module import

  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

7.2. section_index

• 1. project structure
  • 1.1. basic structure
  • 1.2. project autocreation
• 2. introduction to the resources
  • 2.1. public resource
  • 2.2. private resource
• 3. the ``.gnr`` folder
  • 3.1. introduction
  • 3.2. section index
• 4. the ``instances`` folder
  • 4.1. introduction
  • 4.2. section index
• 5. the ``packages`` folder
  • 5.1. introduction
  • 5.2. section index
• 6. the ``resources`` folder
• 7. the ``sites`` folder
  • 7.1. introduction
  • 7.2. section index
• 8. Tutorial: creation of a project
  • 8.1. introduction
  • 8.2. section index

Footnotes:

[1]	Genro provides additional modules that implement common functions for all the applications (user management, table of Italian municipalities...)