app/soc/logic/site/map.py
author Sverre Rabbelier <srabbelier@gmail.com>
Thu, 13 Nov 2008 16:40:05 +0000
changeset 477 8a8b1bd035c4
parent 469 fc401778e380
child 492 4abdeedfc08e
permissions -rw-r--r--
Moved from docs -> document

#!/usr/bin/python2.5
#
# Copyright 2008 the Melange authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Site map information, used to generate sidebar menus, urlpatterns, etc.
"""

__authors__ = [
  '"Todd Larsen" <tlarsen@google.com>',
  ]


from google.appengine.api import users

from django.conf.urls import defaults

from soc.logic import models
from soc.logic import path_link_name
from soc.logic.site import page

import soc.logic.models.site_settings


# Home Page view
home = page.Page(
  page.Url(
    r'^$',
    'soc.views.models.site_settings.main_public'),
  'Google Open Source Programs',
  # it should be obvious that every page comes from the home page
  in_breadcrumb=False)

# User sub-menu, changes depending on if User is signed-in or not
user_signin_sub_menu = page.NonPage(
  'user-sign-in-sub-menu',
  'User',
  parent=home)

user_signout_sub_menu = page.NonPage(
  'user-sign-out-sub-menu',
  'User',
  parent=home)

# User authentication view placeholders
# (these are not real Django views, but need to appear in menus, etc.)
user_signin = page.Page(
  page.Url(
    # not a real Django URL regex, just a unique placeholder
    users.create_login_url('/'),
    # no view, since App Engine handles this page
    # (this page will not be placed in urlpatterns)
    None,
    # name is alternate string for view when it is not unique
    name='user-sign-in'),
  'User (sign in)',
  link_url=users.create_login_url('/'),
  parent=user_signin_sub_menu)

user_signout = page.Page(
  page.Url(
    # not a real Django URL regex, just a unique placeholder
    users.create_logout_url('/'),
    # no view, since App Engine handles this page
    # (this page will not be placed in urlpatterns)
    None,
    # name is alternate string for view when it is not unique
    name='user-sign-out'),
  'User (sign out)',
  link_url=users.create_logout_url('/'),
  parent=user_signout_sub_menu)

# User Profile views
user_edit_self = page.Page(
  page.Url(
    r'^user/edit$',
    'soc.views.user.profile.create'),
  'User: Edit Your User Profile',
  short_name='Site-wide User Profile',
  parent=user_signout_sub_menu)

# Site Home Page views
site_home = page.Page(
  page.Url(
    r'^home$',
    'soc.views.models.site_settings.main_public'),
  'Google Open Source Programs',
  # it should be obvious that every page comes from the home page
  in_breadcrumb=False)


site_sub_menu = page.NonPage(
  'site-sub-menu',
  'Site',
  parent=home)

home_settings_sub_menu = page.NonPage(
  'home-settings-sub-menu',
  'Home Settings',
  parent=site_sub_menu)

# Site Home Settings views
home_settings_list = page.Page(
  page.Url(
    r'^home/list$',
    'soc.views.models.home_settings.list'),
  'Site: List Home Settings',
  short_name='List Home Settings',
  parent=home_settings_sub_menu)

home_settings_create = page.Page(
  page.Url(
    r'^home/create$',
    'soc.views.models.home_settings.create'),
  'Site: Create New Home Settings',
  short_name='Create Home Settings',
  parent=home_settings_sub_menu)

home_settings_edit = page.Page(
  page.Url(
    r'^home/edit/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.home_settings.edit'),
  'Site: Settings',
  short_name='Edit Site Settings',
  parent=home_settings_sub_menu)

home_settings_show = page.Page(
  page.Url(
    r'^home/show/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.home_settings.public'),
  'Show Document',
  parent=home)


site_settings_sub_menu = page.NonPage(
  'site-settings-sub-menu',
  'Site Settings',
  parent=site_sub_menu)

# Site Home Settings views
site_settings_list = page.Page(
  page.Url(
    r'^site/list$',
    'soc.views.models.site_settings.list'),
  'Site: List Site Settings',
  short_name='List Site Settings',
  parent=site_settings_sub_menu)

site_settings_create = page.Page(
  page.Url(
    r'^site/create$',
    'soc.views.models.site_settings.create'),
  'Site: Create New Site Settings',
  short_name='Create Site Settings',
  parent=site_settings_sub_menu)

site_settings_edit = page.Page(
  page.Url(
    r'^site/edit$',
    'soc.views.models.site_settings.main_edit'),
  'Site: Settings',
  short_name='Edit Main Site Settings',
  parent=site_settings_sub_menu)

site_settings_edit = page.Page(
  page.Url(
    r'^site/edit/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.site_settings.edit'),
  'Site: Settings',
  short_name='Edit Site Settings',
  parent=site_settings_sub_menu)

site_settings_show = page.Page(
  page.Url(
    r'^site/show/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.site_settings.public'),
  'Show Site Settings',
  parent=home)

site_settings_delete = page.Page(
  page.Url(
    r'^site/delete/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.site_settings.delete'),
  'Delete Site Settings',
  parent=home)


# User views
user_sub_menu = page.NonPage(
  'site-user-sub-menu',
  'Site: Users Sub-Menu',
  short_name='Site Users',
  parent=site_sub_menu)

site_user_lookup = page.Page(
  page.Url(
    r'^user/lookup$',
    'soc.views.site.user.profile.lookup'),
  'Site: Look Up an Existing User',
  short_name='Look Up Site User',
  parent=user_sub_menu)

user_create = page.Page(
  page.Url(
    r'^user/create$',
    'soc.views.models.user.create'),
  'Site: Create New User Profile',
  short_name='Create Site User',
  parent=user_sub_menu)

site_user_edit = page.Page(
  page.Url(
    r'^user/edit/%s$' % path_link_name.LINKNAME_ARG_PATTERN,
    'soc.views.models.user.edit'),
  'Site: Modify Existing User Profile',
  short_name='Modify Site User',
  parent=user_sub_menu)

user_show = page.Page(
  page.Url(
    r'^user/show/%s$' % path_link_name.LINKNAME_ARG_PATTERN,
    'soc.views.models.user.public'),
  'User: Show Existing User Profile',
  parent=user_signout)

user_list = page.Page(
  page.Url(
    r'^user/list$',
    'soc.views.models.user.list'),
  'Site: List of Users',
  short_name='List Site Users',
  parent=user_sub_menu)

user_delete = page.Page(
  page.Url(
    r'^user/delete/%s$' % path_link_name.LINKNAME_ARG_PATTERN,
    'soc.views.models.user.delete'),
  'Site: Delete Existing User',
  short_name='Delete Site User',
  parent=user_sub_menu)


# Document views
document_show = page.Page(
  page.Url(
    r'^document/show/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.document.public'),
  'Show Document',
  parent=home)

# Site Document views
site_document_sub_menu = page.NonPage(
  'site-document-sub-menu',
  'Site: Documents Sub-Menu',
  short_name='Site Documents',
  parent=site_sub_menu)

site_document_create = page.Page(
  page.Url(
    r'^document/edit$',
    'soc.views.models.document.create'),
  'Site: Create New Document',
  'Create Site Document',
  parent=site_document_sub_menu)

site_document_edit = page.Page(
  page.Url(
    r'^document/edit/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.document.edit'),
  'Site: Modify Existing Document',
  short_name='Modify Site Document',
  parent=site_document_sub_menu)

site_document_delete = page.Page(
  page.Url(
    r'^document/delete/%s$' % path_link_name.PATH_LINKNAME_ARGS_PATTERN,
    'soc.views.models.document.delete'),
  'Site: Delete Existing Document',
  short_name='Delete Site Document',
  parent=site_document_sub_menu)

site_document_list = page.Page(
  page.Url(
    r'^document/list$',
    'soc.views.models.document.list'),
  'Site: List of Documents',
  short_name='List Site Documents',
  parent=site_document_sub_menu)

# Sponsor Group public view
sponsor_profile = page.Page(
  page.Url(
    r'^sponsor/show/%s$' % path_link_name.LINKNAME_ARG_PATTERN,
    'soc.views.models.sponsor.public'),
  'Sponsor Public Profile',
  parent=home)

# Sponsor Group Site views
site_sponsor_sub_menu = page.NonPage(
  'site-sponsor-sub-menu',
  'Site: Sponsors Sub-Menu',
  short_name='Site Sponsors',
  parent=site_sub_menu)

site_sponsor_create = page.Page(
  page.Url(
    r'^sponsor/create$',
    'soc.views.models.sponsor.create'),
  'Site: Create New Sponsor',
  short_name='Create Site Sponsor',
  parent=site_sponsor_sub_menu)

site_sponsor_delete = page.Page(
  page.Url(
    r'^sponsor/delete/%s$' % path_link_name.LINKNAME_ARG_PATTERN,
    'soc.views.models.sponsor.delete'),
  'Site: Delete Existing Sponsor',
  short_name='Delete Site Sponsor',
  parent=site_sponsor_sub_menu)

site_sponsor_edit = page.Page(
  page.Url(
    r'^sponsor/edit/%s$' % path_link_name.LINKNAME_ARG_PATTERN,
    'soc.views.models.sponsor.edit'),
  'Site: Modify Existing Sponsor',
  short_name='Modify Site Sponsor',
  parent=site_sponsor_sub_menu)

site_sponsor_list = page.Page(
  page.Url(
    r'^sponsor/list$',
    'soc.views.models.sponsor.list'),
  'Site: List of Sponsors',
  short_name='List Site Sponsors',
  parent=site_sponsor_sub_menu)

# Host public view
host_profile = page.Page(
  page.Url(
      r'^host/show/(?P<sponsor_ln>%(lnp)s)/(?P<user_ln>%(lnp)s)$' % {
          'lnp': path_link_name.LINKNAME_PATTERN_CORE},
    'soc.views.models.host.public'),
  'Host Public Profile',
  parent=home)

# Host Site views
site_host_sub_menu = page.NonPage(
  'site-host-sub-menu',
  'Site: Host Sub-Menu',
  short_name='Site Hosts',
  parent=site_sub_menu)

site_host_create = page.Page(
  page.Url(
    r'^host/create$',
    'soc.views.models.host.create'),
  'Site: Create New Host',
  short_name='Create Site Host',
  parent=site_host_sub_menu)

site_host_delete = page.Page(
  page.Url(
    r'^host/delete/(?P<sponsor_ln>%(lnp)s)/(?P<user_ln>%(lnp)s)$' % {
          'lnp': path_link_name.LINKNAME_PATTERN_CORE},
    'soc.views.models.host.delete'),
  'Site: Delete Existing Host',
  short_name='Delete Site Host',
  parent=site_host_sub_menu)

site_host_edit = page.Page(
  page.Url(
    r'^host/edit/(?P<sponsor_ln>%(lnp)s)/(?P<user_ln>%(lnp)s)$' % {
          'lnp': path_link_name.LINKNAME_PATTERN_CORE},
    'soc.views.models.host.edit'),
  'Site: Modify Existing Host',
  short_name='Modify Site Host',
  parent=site_host_sub_menu)

site_host_list = page.Page(
  page.Url(
    r'^host/list$',
    'soc.views.models.host.list'),
  'Site: List of Hosts',
  short_name='List Site Hosts',
  parent=site_host_sub_menu)

# these are not really used...
#    (r'^org/profile/(?P<program>ghop[_0-9a-z]+)/(?P<link_name>[_0-9a-z]+)/$',
#     'soc.views.person.profile.edit',
#     {'template': 'ghop/person/profile/edit.html'}),
#    (r'^org/profile/(?P<program>[_0-9a-z]+)/(?P<link_name>[_0-9a-z]+)/$',
#     'soc.views.person.profile.edit'),


ROOT_PAGES = [
  # /, first level of the sidebar menu, excluded from breadcrumbs
  home,

  # alternate view of /, no menu presence
  site_home,
]


def getDjangoUrlPatterns(pages=ROOT_PAGES):
  """Returns Django urlpatterns derived from the site map Pages.

  Args:
    pages: a list of page.Page objects from which to generate urlpatterns
      (from them and from their child Pages); default is ROOT_PAGES

  Raises:
    KeyError if more than one Page has the same urlpattern.

    TODO(tlarsen): this probably does not work correctly, currently, since
    page.Page.makeDjangoUrls() returns a list, and this routine is
    combining lists from potentially multiple page hierarchies.  Each list
    might have a urlpattern that the other contains, but this won't be
    detected by the current code (will Django catch this?).  This really
    needs to be detected earlier via a global Page dictionary.
  """
  urlpatterns = ['']

  for page in pages:
    urlpatterns.extend(page.makeDjangoUrls())

  return defaults.patterns(*urlpatterns)