精通Pylons：Python Web框架指南

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

"Apress the Definitive Guide to Pylons" 本书《Apress the Definitive Guide to Pylons》由James Gardner撰写，是关于Pylons Web框架的全面指南。Pylons是在Ruby on Rails的流行趋势下，Python社区内兴起的一种极具创新性的Web框架。它结合了Ruby、Python和Perl的优点，并采用了WSGI（Web服务器网关接口）标准，以提供结构化和灵活性。这本书旨在帮助开发者构建基于Pylons的网站，同时涵盖了高级特性，如国际化和本地化、打包及部署。在"Getting Started"部分，作者引导读者进入Pylons的世界，介绍如何开始使用这个框架。书中的Part 1可能详细讲解了Pylons的基础知识，包括安装、配置以及创建第一个Pylons项目。James Gardner作为Pylons的联合创始人和主要开发者，以其专业知识为读者提供了深入浅出的指导。在内容中提到了SQLAlchemy和FormEncode，这两者是Pylons生态中的重要工具。SQLAlchemy是Python的一个高级对象关系映射（ORM）库，用于处理数据库操作，使开发者能够用Python代码与数据库交互。而FormEncode则是一种表单验证库，用于确保用户提交的数据符合预期的格式和规则。书的后部分可能涉及了Pylons的高级主题，如国际化和本地化，这对于构建面向全球用户的网站至关重要。这部分会涵盖如何处理多语言内容、日期和时间格式等问题。另外，书中可能还讨论了如何打包和部署Pylons应用，这是将开发的应用程序上线到生产环境的关键步骤。此书的出版信息表明，它遵循了GNU Free Documentation License，这意味着任何人都可以自由地复制、分发和修改文档。书的ISBN号也分别给出了纸质版和电子版的编号，表明了它同时有实体书和电子书两种形式。技术审阅者Michael Orr的存在意味着内容的准确性得到了专业审查，而编辑团队包括Steve Anglin和Matt Wade等，他们为书籍的质量提供了保证。《Apress the Definitive Guide to Pylons》是一本适合Python开发者学习Pylons框架的权威教程，通过这本书，读者可以系统性地学习Pylons的各个方面，从基础到高级，从而提升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页未读，继续阅读

philipx41

粉丝: 0
资源: 11

精通Pylons：Python Web框架指南

iReport权威指南：2007年精通开源报表工具

HTML5入门权威指南

SQLite权威指南：从入门到精通

Apress The Definitive Guide to SUSE Linux Enterprise Server 12 2014.rar

Apress - Definitive Guide To Apache Myfaces And Facelets (2008)

Apress - The Definitive Guide To Swt And Jface

Apress - The Definitive Guide to Java Swing, Third Edition.pdf

APress - The Definitive Guide to MySQL, 2nd Ed - 2004 - (By Laxxuss).chm

The Definitive Guide to Grails Second Edition (Apress 2009)

The Definitive Guide to Magento (Apress出品 Magento权威指南)

最新资源