Каковы некоторые лучшие практики для структурирования cherrypy приложения?

CherryPy намеренно не требует, чтобы вы создавали подкласс из предоставляемый фреймворком базовый класс, так что вы можете свободно разрабатывать свой собственный механизм наследования или, что более важно, вообще не использовать его. Вы, безусловно, можете определять свой собственный базовый класс и наследовать от него; таким образом вы можете стандартизировать создание и настройку обработчика с помощью метода __ init __ вашего класса, а также с помощью переменных и методов уровня класса.

Однако предпочтительный подход отличается. Для большинства веб-приложений вы действительно не хотите изменять фактическую логику построения ваших обработчиков и не заботитесь о переменных или методах уровня класса; вместо этого вам нужны повторно используемые переменные и методы для каждого URI или поддерева URI или для каждого сайта, а не для каждого класса. Вы склонны отличать один набор обработчиков от другого набора более конфигурацией экземпляра (метаданные обработчика) и методами экземпляра (логикой обработчика). Традиционное наследование на основе классов может это сделать, но это немного грубый инструмент для такого рода настройки.

CherryPy, таким образом, предназначен для обеспечения такого рода настройки для каждого набора ресурсов, с которой наследование на основе классов не работает.Он обеспечивает это через 1) дизайн своей системы конфигурации, которая позволяет вам связывать метаданные с одним URI, поддеревом URI, поддеревом обработчиков или целым сайтом с одним и тем же синтаксисом (см. http://docs.cherrypy.org/dev/intro/concepts/config.html для обзора) и 2) система хуков и инструментов, которая позволяет связывать логику в один URI, поддерево URI, поддерево обработчиков или весь сайт. См. http://docs.cherrypy.org/dev/intro/concepts/tools.html

Итак, практически: используйте обычные атрибуты в cherrypy.root для построения своего дерева обработчиков :

def make_app():
    root = Root()
    root.foo = Foo()
    root.bars = BarCollection()
    return root

Однако не делайте Root, Foo и Bar наследованием от общего базового класса. Вместо этого напишите независимые инструменты, чтобы делать такие вещи, как «выводить шаблоны». То есть вместо:

from cherrypy import expose

class Foo(MyAppBase):
    @expose()
    def index(self, a, b, c):
        ...

root.foo = Foo(template='foo.html')

напишите:

from cherrypy import expose, tools

class Foo(object):
    @tools.render(template='foo.html')
    @expose()
    def index(self, a, b, c):
        ...

root.foo = Foo()

... где 'tools.render' - это инструмент CherryPy, который вы написали для поиска и применения данного шаблона. Этот подход позволит вам переопределить аргументы инструмента в вашем файле конфигурации и избежать необходимости переупаковывать или исправлять код:

[/foo/]
tools.render.template = 'foo2.html'