Pylons全指南：从入门到精通

需积分: 0 109 浏览量更新于2024-07-23 2 收藏 4.26MB PDF 举报

《Pylons权威指南》是一本全面介绍Pylons框架的教程，由James Gardner编著，于2009年出版。该书在GNU自由文档许可证下提供版权许可，允许读者在指定条件下复制、分发和修改。书中不仅深入探讨了Pylons框架的基础知识，还涵盖了其设计理念、安装与配置、开发流程以及高级特性的讲解。 Pylons框架是一个轻量级且灵活的Python Web应用框架，专为Python开发者设计，旨在快速构建可扩展的Web应用程序。它采用了MVC（模型-视图-控制器）架构，为开发者提供了清晰的分工，有助于构建模块化和易于维护的代码结构。在《The Definitive Guide to Pylons》中，作者从入门级内容开始，引导读者逐步了解如何搭建项目环境，包括但不限于： 1. Getting Started：这部分会介绍Pylons框架的历史背景，为何选择Pylons，以及如何下载和安装所需的依赖库。作者会演示如何初始化一个新项目，并创建基本的目录结构。 2. PART1：这一部分深入剖析了Pylons的核心组件，如web服务器的配置，如WSGI服务器和URL路由器。读者将学习如何设置路由、定义控制器和处理HTTP请求。 3. 模型层：Pylons支持对象关系映射（ORM），这部分会讲解如何使用SQLAlchemy或类似工具来操作数据库，以及如何定义和管理数据模型。 4. 视图层：这部分详细介绍了模板语言（如Mako或Genshi）的使用，以及如何编写响应用户请求的HTML、JSON或其他格式的数据。 5. 控制器层：这部分会介绍如何组织和管理应用逻辑，如何处理业务规则和错误处理，以及如何进行权限控制和国际化支持。 6. Security and Authentication：章节中会涉及如何实现用户身份验证和授权，以确保应用的安全性。 7. Advanced Topics：对于有经验的开发者，本书还会涉及更高级的主题，如异步处理、测试策略、性能优化以及部署和运维技巧。《The Definitive Guide to Pylons》由资深编辑团队编审，确保内容准确无误。技术评审者Michael Orr的专业意见也为读者提供了额外的技术深度。这本书不仅是初学者学习Pylons的绝佳资源，也是经验丰富的开发者扩展知识库、提升技能的实用参考书。随着时代的发展，虽然Pylons可能已被其他框架如Flask或Django取代，但对早期Web开发者的理解和实践仍然具有一定的价值。

PART 3

■ ■ ■

Expert Pylons

■CHAPTER 16 The Web Server Gateway Interface (WSGI). . . . . . . . . . . . . . . . . . 369

Introducing WSGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

WSGI Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

WSGI in Pylons Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

WSGI Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

WSGI Middleware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

Writing WSGI Middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

Modifying the Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

Changing the Status and Headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Handling Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Altering the Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

Testing the Gzip Middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

■CHAPTER 17 Pylons’ Internal Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

A Bit of History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

Egg Entry Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

Entry Points and websetup.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

The Pylons Config File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

Default Config Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

Constructing a Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

Constructing an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

Composite Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

Pipelines and Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

Understanding Factories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

Alternative Ways of Specifying Factories . . . . . . . . . . . . . . . . . . . . . . . . . . 400

Configuration Inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

Accessing the Pylons WSGI Application and

Other Objects Programmatically

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Accessing the Server, Application, and Filters . . . . . . . . . . . . . . . . . . . . . . 401

Accessing Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

Creating a Pylons Application with Paste Deploy . . . . . . . . . . . . . . . . . . . . 402

The Pylons Middleware Stack. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403

Application State vs. Request State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

■CONTENTS xv

Creating an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Loading the Pylons Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

The PylonsApp Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

The Middleware Chain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

Handling a Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

The Cascade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408

The Registry Manager, StackedObjectProxy, and Pylons Globals . . . . . . 409

Returning to the Middleware Chain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

The Role of PylonsApp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

The Role of WSGIController. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

Handling the Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

abort(), redirect_to(), and HTTPException . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Exception Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Error Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Streaming Content. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Returning Unicode from an Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

■CHAPTER 18 Authentication and Authorization. . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

Private Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

A Homegrown Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

AuthKit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417

Authentication Middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418

Authorization and Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

The Authorization Decorator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

The Authorization Middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

The Authorization Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

Protecting a Controller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424

Groups, Roles, and Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424

User Management API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426

Cookie Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

Alternative Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

Functional Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

General Security Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429

Secure Sockets Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429

Encrypted Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432

■CONTENTSxvi

■CHAPTER 19 SimpleSite Tutorial Part 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

Authentication and Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

Setting Up the Middleware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

Adjusting websetup.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434

Protecting Controller Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

Changing Templates Based on Permissions. . . . . . . . . . . . . . . . . . . . . . . . 438

Signing In and Signing Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

Styling the Sign-in Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

Protecting the Rest of the Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443

Using the AuthKit User Management API . . . . . . . . . . . . . . . . . . . . . . . . . . 445

Error Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

Customizing the Error Documents for SimpleSite . . . . . . . . . . . . . . . . . . . 447

Adding a WYSIWYG Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

Configuring the setup.py File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

Choosing a Version Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

Configuring Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

Extra Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

Extra Dependency Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

Specifying Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

Customizing the Long Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456

Customizing the Production Config File Template . . . . . . . . . . . . . . . . . . . 457

Packaging a Pylons Project for Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

Building an Egg File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

Publishing an Egg on the Python Package Index . . . . . . . . . . . . . . . . . . . . 460

Making SimpleSite into a Paste Project Template . . . . . . . . . . . . . . . . . . . . . . . . 462

Introducing Project Template Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

Using Project Template Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

Completing the Cycle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

■CHAPTER 20 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

Getting Started with Pylons Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

Understanding the logging Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

Understanding Log Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

Logging Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

474

Logging in Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

Introducing Logging Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

Logger Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

Handler Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

Formatter Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

■CONTENTS xvii

Redirecting Log Output Using Handlers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

Logging to a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

Logging to wsgi.errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479

Configuring Which Messages Are Logged. . . . . . . . . . . . . . . . . . . . . . . . . . 480

Controlling Propagation with Loggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480

Using Propagation to Filter Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482

Summarizing Propagation Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

Capturing Log Output from Other Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

Capturing SQLAlchemy Log Messages Using Propagation . . . . . . . . . . . . 483

Capturing AuthKit Messages Using a Handler . . . . . . . . . . . . . . . . . . . . . . 484

Production Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485

■CHAPTER 21 Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487

Choosing or Setting Up a Python Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 487

Using the System Python Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

Platform Packages or Easy Install? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

Using Buildout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

Setting Up a Virtual Python Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . 489

Dealing with Activate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

Installing the Required Software into the Environment . . . . . . . . . . . . . . . . . . . . 490

Creating a Config File for the Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491

Setting Up the Application Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491

Serving the Application from the Installed Environment . . . . . . . . . . . . . . . . . . . 492

Deployment Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

Embedding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

Proxying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494

Using Apache to Proxy Requests to Pylons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494

Setting Up Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

Creating init Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

Restarting Stopped Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497

Embedding Pylons in Apache with mod_wsgi . . . . . . . . . . . . . . . . . . . . . . . . . . . 497

Setting Up a Virtual Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501

Deployment on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502

■APPENDIX Licenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

■INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513

■CONTENTSxviii

About the Author

■JAMES GARDNER is an Oxford University graduate in physics; cofounder of

the Pylons web framework; and founder of 3aims Ltd, a knowledge inter-

action technology consultancy based in London. The majority of his profes-

sional experience has been in the development and support of R&D systems

for three different National Health Service organizations in the United King-

dom, and he also coded the popular “What Should I Read Next?” book recom-

mendation service.

James has been writing computer programs since he was a small boy

when he first got his hands on a Sinclair ZX Spectrum and was very proud to

show his grandmother the flashing colored shapes he had managed to get to appear on a black

background on the TV. The excitement and satisfaction of being able to create something extra-

ordinary from a series of carefully ordered characters in a file and a little bit of logical thinking has

never left him.

James is heavily involved in open source software, and in addition to his involvement in Pylons,

he wrote the Python web modules AuthKit and FormBuild and has a keen interest in authentication

and single sign-on systems such as OpenID. He is an advocate of building web applications with the

Web Server Gateway Interface APIs that you’ll learn about in this book.

While not traveling to London or Oxford, James enjoys nothing more than discussing ideas with

challenging and like-minded individuals or sitting down with a cup of tea, a pile of blank paper, a

pen, and an Internet connection to think about better ways to solve complex problems using web

technology.

In his spare time, James enjoys everything to do with the outdoors from cycling to climbing

and from astronomy to scuba diving. In fact, he recently went on a dive trip to the Farne Islands

off the coast of Northumbria in the United Kingdom where he thoroughly enjoyed having his

equipment nibbled by inquisitive seals. James is lucky enough to have traveled widely and enjoys

meeting new people and learning about the different ways people see the world.

James’ company’s web site is at

http://3aims.com, and he maintains a personal blog docu-

menting his experiments with Python and Linux, amongst other things, at http://jimmyg.org.

xix

剩余545页未读，继续阅读

Aloys_Code

粉丝: 40
资源: 25

Pylons全指南：从入门到精通

Pylons开发权威指南

精通Pylons：Python Web框架指南

Pylons入门指南：权威指南

Gardner -- The Definitive Guide to Pylons -- 2008.pdf

Gardner -- The Definitive Guide to Pylons -- 2008 -- code.7z

The Definitive Guide to Jython

Juneau -- The Definitive Guide to Jython -- 2010.pdf

Apress.the.Definitive.Guide.to.Pylons.Dec.2008

[James_Gardner]_The_Definitive_Guide_to_Pylons(z-lib.org).rar

《Pylons权威指南》：从入门到精通

最新资源