Ophelia

Ophelia é um projeto Python que cria páginas XHTML a partir de modelos escritos em TAL, o modelo de Zope Atributo Language & nbsp;. Ele é projetado para reduzir a repetição de código para zero.
O pacote contém um aplicativo WSGI correndo Ophelia, bem como um manipulador de solicitação para mod_python, o módulo Python para o servidor web Apache2.
Os arquivos da documentação citados abaixo podem ser encontrados dentro do diretório do pacote, junto com um número de doctests para os módulos.
Pontos entrada
Depois de instalado Ophelia e escreveu alguns modelos, como você pode torná-lo processar páginas da web?
Use Ophelia com Apache
O pacote Python contém um ophelia.modpython módulo que fornece um manipulador de solicitação para o módulo mod_python Apache.
Use Ophelia como uma aplicação WSGI
Ophelia define uma classe de aplicativo compatível com o padrão WSGI, PEP 333: ophelia.wsgi.Application. Você pode experimentá-lo, executando próprio servidor HTTP baseado em wsgiref de Ofélia ou executá-lo por qualquer servidor WSGI você pode cuidar de usar.
O servidor baseado em wsgiref é instalado como o executável Ophelia-wsgiref se Ophelia é instalado como um ovo com o "wsgiref" extra habilitado. Seu ponto de entrada de script é ophelia.wsgi.wsgiref_server.
Dump páginas únicas para stdout
Um executável que é sempre instalado com o ovo Ophelia é Ophelia-dump. Este script tem Ophelia tornar a resposta correspondente ao caminho que você especificar, e imprime-lo para sys.stdout, opcionalmente com cabeçalhos HTTP. Ponto de entrada do roteiro é ophelia.dump.dump.
Ambos os scripts fornecer algumas instruções de uso, quando chamado com a opção --help. Eles ler um arquivo de configuração; veja CONFIGURATION.txt para mais detalhes.
Que tipo de sites é Ophelia bom?
O conteúdo estático
Considere Ophelia como SSI as drogas. Não é fundamentalmente diferente, apenas muito mais amigável e mais capaz.
Use Ophelia para sites onde você basicamente escrever seu HTML mesmo, exceto que você precisa escrever o material recorrente apenas uma vez. Reduzir a repetição de zero tem um preço: o site deve seguir um padrão para Ophelia combinar seus modelos da maneira certa.
Considere o layout do seu site para ser hierárquica: há um olhar comum a todas as suas páginas, seções têm determinadas características e cada página tem conteúdo exclusivo. É crucial para Ophelia que essa hierarquia reflete na organização do sistema de arquivos de seus documentos; como modelos de combinar é deduzido de seus lugares na hierarquia de diretórios.
O conteúdo dinâmico
Ophelia torna a linguagem Python disponível para a inclusão de conteúdo dinâmico. Cada arquivo de modelo pode incluir um script Python. Scripts em Python e modelos que contribuem para uma quota de página de um conjunto comum de variáveis ​​para modificar e usar.
Modelo de conteúdo de Ofélia é muito simples e funciona melhor se cada objeto conteúdo que você publica é o seu próprio ponto de vista: a página é representado por diante. Se você receber o conteúdo de recursos externos de qualquer maneira (por exemplo, um banco de dados ou um repositório de controle de versão), ainda é OK para usar Ophelia mesmo com vários pontos de vista por objeto de conteúdo, desde que vista de um objeto não dependem do tipo do objeto ou até mesmo o objeto si.
Tentando usar Ophelia em um site mais complexo vai levar a um emaranhado feio da lógica e da apresentação. Não use Ophelia para sites que são realmente interfaces web para aplicativos, sistemas de gerenciamento de conteúdo e afins.
Como Ophelia funciona
Os arquivos de modelo
Para cada solicitação, Ophelia olha para uma série de arquivos de modelo. Demora um arquivo chamado "__init__" de cada diretório no caminho da raiz do site para a página, e uma final para a própria página. O pedido é servido por Ophelia se esse modelo final é encontrado.
Ao construir a página, o modelo da página é avaliada e seu conteúdo armazenado em que é chamado a ranhura interior. Em seguida, cada modelo no caminho de volta a partir da página para a raiz é avaliado por sua vez, e pode incluir o conteúdo atual da ranhura interna. O resultado é armazenado na ranhura interior depois de cada passo.
O resultado do processamento do modelo raiz é servido como a página.
Scripts Python
Cada arquivo de modelo pode começar com um script Python. Nesse caso, o roteiro é separada do molde por a primeira ocorrência de um "" Tag numa linha própria (excepto para o espaço em branco para a esquerda ou para a direita). Se o arquivo de modelo contém apenas um script Python, mas não, na verdade, um modelo, coloque "" Em sua última linha.
Scripts em Python são executados em ordem ao percorrer a partir da raiz do site para a página. Eles são executados no mesmo espaço de nomes de variáveis ​​que é usado mais tarde como o contexto de avaliação dos modelos. Variáveis ​​que são definidas por um script Python pode ser usado e modificado por qualquer executar scripts mais tarde, bem como por contos expressões utilizadas nos modelos.
O namespace é inicializado pelo Ophelia com uma única variável, __request__, que faz referência ao objeto do pedido. Assim, os scripts têm acesso a detalhes da solicitação e internos de navegação. Além das variáveis ​​de ajuste, os scripts também pode importar módulos, definir funções, acessar o sistema de arquivos, e, geralmente, fazer qualquer coisa que um programa Python pode fazer.
Como Ophelia se comporta
Canonização URL e redirecionamento
Se Ophelia encontra uma URL que corresponde a um diretório que ele se comporta de forma semelhante ao Apache em sua configuração padrão: Se a URL não termina com uma barra, ele irá redirecionar o browser para adicionar a barra. Se a barra estiver lá, ele vai tentar encontrar um modelo chamado index.html por padrão, e torná-la como o diretório "index".
Dependendo da configuração, de pedido explícito de páginas de índice de diretório pode ser redirecionado para a nu URLs de diretório sem o segmento de caminho final. Isso transformaria em.
Além disso, Ophelia Canonicaliza URLs contendo segmentos de caminho "." e "..", de acordo com a RFC 3986 de genérico sintaxe URI, e remove os segmentos de caminho vazias, que não se encontram no final do caminho. Se a URL é alterada por estas regras, Ophelia redireciona o navegador em conformidade.
O manipulador de mod_python
Apache2 processa um pedido em fases, cada uma das quais podem ser tratados por módulos, tais como mod_python. Ophelia fornece um manipulador mod_python para a fase de conteúdo geração. Se a URL solicitada é configurado para ser tratado por Ophelia, o manipulador tenta encontrar modelos apropriados no sistema de arquivos, e construir uma página a partir deles.
Manipulador mod_python de Ofélia nunca faz com que um arquivo não encontrado erro HTTP. Em vez disso, ele passa o controle de volta para Apache e outros módulos, se verificar que não é possível construir um recurso particular. Apache cai de volta para servir conteúdo estático do disco nesse caso. Ophelia pode assim ser instalado em cima de um site estático para lidar apenas as solicitações para as quais existem modelos no diretório template