118

我在 Google App Engine 中启动了一个应用程序，当它出现时，我就开始使用这项技术并从事一个我想了很长时间但一直没有开始的宠物项目。结果是BowlSK。然而，随着它的发展和功能的增加，让事情井井有条变得非常困难——主要是因为这是我的第一个 python 项目，在我开始工作之前我对它一无所知。

是）我有的：

  • 主级别包含：
    • 所有 .py 文件（不知道如何使包工作）
    • 主级别页面的所有 .html 模板
  • 子目录：
    • css、图像、js等的单独文件夹。
    • 包含子目录类型 url 的 .html 模板的文件夹

示例： http:
//www.bowlsk.com/映射到主页（默认包），“index.html”处的模板
http://www.bowlsk.com/games/view-series.html?series=7130映射到ViewSeriesPage（同样，默认包），模板位于“games/view-series.html”

真恶心。我该如何重组？我有两个想法：

  • 主文件夹包含：appdef、索引、main.py？

    • 代码的子文件夹。这必须是我的第一个包裹吗？
    • 模板的子文件夹。文件夹层次结构将匹配包层次结构
    • css、图像、js 等的各个子文件夹。

  • 包含 appdef、索引、main.py 的主文件夹？

    • 代码+模板的子文件夹。这样我在模板旁边就有了处理程序类，因为在这个阶段，我添加了很多特性，所以对一个的修改意味着对另一个的修改。同样，我是否必须将此文件夹名称作为我的课程的第一个包名称？我希望文件夹是“src”，但我不希望我的类是“src.WhateverPage”

有最佳实践吗？随着 Django 1.0 的出现，当它成为官方的 GAE 模板引擎时，我现在可以做些什么来提高我与它集成的能力吗？我会简单地开始尝试这些东西，看看哪个看起来更好，但是 pyDev 的重构支持似乎不能很好地处理包移动，所以让所有这些再次工作可能是一项不平凡的任务。

4

6 回答 6

104

首先，我建议您看一下“使用 Python、Django 和 Google App Engine 进行快速开发”

GvR 在其幻灯片演示的第 10 页上描述了一般/标准项目布局。

在这里，我将发布该页面的布局/结构的略微修改版本。我自己几乎都遵循这种模式。您还提到您在使用包裹时遇到了麻烦。只需确保您的每个子文件夹都有一个 __init__.py 文件。如果它是空的，那没关系。

样板文件

  • 这些在项目之间几乎没有变化
  • app.yaml：将所有非静态请求定向到 main.py
  • main.py：初始化应用并发送所有请求

项目布局

  • static/*：静态文件；由 App Engine 直接提供
  • myapp/*.py：特定于应用程序的 python 代码
    • views.py、models.py、tests.py、__init__.py 等
  • 模板/*.html：模板（或 myapp/templates/*.html）

以下是一些可能有帮助的代码示例：

主文件

import wsgiref.handlers

from google.appengine.ext import webapp
from myapp.views import *

application = webapp.WSGIApplication([
  ('/', IndexHandler),
  ('/foo', FooHandler)
], debug=True)

def main():
  wsgiref.handlers.CGIHandler().run(application)

我的应用程序/views.py

import os
import datetime
import logging
import time

from google.appengine.api import urlfetch
from google.appengine.ext.webapp import template
from google.appengine.api import users
from google.appengine.ext import webapp
from models import *

class IndexHandler(webapp.RequestHandler):
  def get(self):
    date = "foo"
    # Do some processing        
    template_values = {'data': data }
    path = os.path.join(os.path.dirname(__file__) + '/../templates/', 'main.html')
    self.response.out.write(template.render(path, template_values))

class FooHandler(webapp.RequestHandler):
  def get(self):
    #logging.debug("start of handler")

myapp/models.py

from google.appengine.ext import db

class SampleModel(db.Model):

我认为这种布局非常适合新的和相对中小型的项目。对于较大的项目，我建议将视图和模型分解为拥有自己的子文件夹，例如：

项目布局

  • static/：静态文件；由 App Engine 直接提供
    • js/*.js
    • 图片/*.gif|png|jpg
    • css/*.css
  • myapp/: 应用结构
    • 模型/*.py
    • 意见/*.py
    • 测试/*.py
    • 模板/*.html：模板
于 2008-09-16T08:10:50.747 回答
17

我通常的布局是这样的：

  • 应用程序.yaml
  • 索引.yaml
  • request.py - 包含基本的 WSGI 应用程序
  • 库
    • __init__.py- 通用功能，包括请求处理程序基类
  • 控制器 - 包含所有处理程序。request.yaml 导入这些。
  • 模板
    • 控制器使用的所有 django 模板
  • 模型
    • 所有数据存储模型类
  • 静止的
    • 静态文件（css、图像等）。由 app.yaml 映射到 /static

如果不清楚，我可以提供我的 app.yaml、request.py、lib/ init.py和示例控制器的外观示例。

于 2008-09-30T16:30:58.893 回答
11

我今天实现了一个谷歌应用引擎样板，并在 github 上进行了检查。这与上面尼克约翰逊（他曾经为谷歌工作）所描述的思路一致。

按照这个链接gae-boilerplate

于 2012-09-21T17:07:02.227 回答
7

我认为第一个选项被认为是最佳实践。并使代码文件夹成为您的第一个包。Guido van Rossum 开发的 Rietveld 项目是一个很好的学习模型。看看它：http ://code.google.com/p/rietveld

关于 Django 1.0，我建议你开始使用 Django 主干代码而不是 GAE 内置的 django 端口。再次，看看它是如何在 Rietveld 完成的。

于 2008-09-15T22:11:12.310 回答
3

我喜欢webpy，所以我采用它作为 Google App Engine 上的模板框架。
我的包文件夹通常是这样组织的：

app.yaml
application.py
index.yaml
/app
   /config
   /controllers
   /db
   /lib
   /models
   /static
        /docs
        /images
        /javascripts
        /stylesheets
   test/
   utility/
   views/

这是一个例子。

于 2010-06-23T20:30:50.180 回答
1

在代码布局方面，我并不完全了解最新的最佳实践，等等，但是当我做我的第一个 GAE 应用程序时，我使用了你的第二个选项，其中代码和模板彼此相邻。

这有两个原因 - 第一，它保留了代码和模板，第二，我的目录结构布局模仿了网站 - 让（对我而言）更容易记住所有内容的位置。

于 2008-09-07T14:25:20.330 回答