Pylons入门指南：权威指南

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

"The Definitive Guide to Pylons.pdf" 是一本由 James Gardner 撰写的关于 Pylons 框架的详细指南。这本书详细介绍了如何使用 Pylons 进行 Web 开发，旨在帮助读者掌握这个 Python 框架的核心概念和技术。 Pylons 是一个基于 Python 的开源 Web 应用程序框架，它采用了 Model-View-Controller (MVC) 设计模式，旨在提供高效、灵活和可扩展的解决方案。Pylons 强调轻量级和快速开发，适合构建高性能的 Web 应用程序。在 "Getting Started" 部分，读者可以期待学习到以下内容： 1. **安装与配置**：了解如何在本地环境中设置 Pylons，包括安装必要的依赖库，如 Python，Paste，SQLAlchemy 等，并设置开发环境。 2. **基础架构**：Pylons 的 MVC 架构是如何工作的，模型（Model）如何处理数据，视图（View）如何展示信息，以及控制器（Controller）如何协调这两者。 3. **路由系统**：Pylons 使用 Routes 模块实现灵活的 URL 映射，读者将学习如何定义 URL 路径并映射到特定的控制器方法。 4. **模板引擎**：Pylons 支持多种模板语言，如 Mako 和 Genshi，用于创建动态网页。这部分会介绍如何编写和使用模板来生成 HTML 输出。 5. **数据库集成**：通过 SQLAlchemy，Pylons 提供了强大的数据库操作支持。读者会学习如何定义数据模型，执行 SQL 查询，以及实现事务处理。 6. **表单处理**：理解如何处理用户提交的表单数据，验证输入，以及使用 WSGI 中间件如 FormEncode 进行数据验证。 7. **错误处理与调试**：学习如何配置错误页面，进行调试，以及使用 Pylons 自带的开发服务器进行测试。 8. **国际化与本地化**：了解如何使应用程序支持多语言，包括翻译文本，设置日期和货币格式。 9. **部署策略**：讨论如何将 Pylons 应用部署到生产环境，包括配置服务器，使用 Nginx 或 Apache 作为反向代理，以及性能优化技巧。 10. **高级主题**：可能涵盖插件系统，自定义中间件，单元测试，持续集成，以及与其他 Python 库如 Pyramid 或 Flask 的比较。此外，书中的技术审查员 Michael Orr 的贡献确保了内容的专业性和准确性。这本书不仅适合初学者，也对有经验的开发者提供了深入的见解，帮助他们更好地利用 Pylons 构建复杂的应用程序。尽管书的标签为 "Delphi"，但 Delphi 是一个与 Pylons 相关性不大的对象 Pascal 开发工具，主要应用于桌面应用开发。在这个上下文中，标签可能是误标，因为内容主要涉及 Python Web 开发的 Pylons 框架。

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页未读，继续阅读

chunyangsuhao

粉丝: 103
资源: 7382

Pylons入门指南：权威指南

802.11 Wireless Networks The Definitive Guide Oreilly.pdf

The Definitive Guide to Magento.pdf

The Definitive Guide to Terracotta.pdf

The Definitive Guide to JasperReports.pdf

The Definitive Guide to GCC.pdf

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

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

MongoDB The Definitive Guide 3rd Edition.pdf

Hadoop The Definitive Guide 2nd Edition.pdf

Javascript - The Definitive Guide 6th.pdf

最新资源