Book Image

Building RESTful Python Web Services

By : Gaston C. Hillar
Book Image

Building RESTful Python Web Services

By: Gaston C. Hillar

Overview of this book

Python is the language of choice for millions of developers worldwide, due to its gentle learning curve as well as its vast applications in day-to-day programming. It serves the purpose of building great web services in the RESTful architecture. This book will show you the best tools you can use to build your own web services. Learn how to develop RESTful APIs using the popular Python frameworks and all the necessary stacks with Python, Django, Flask, and Tornado, combined with related libraries and tools. We will dive deep into each of these frameworks to build various web services, and will provide use cases and best practices on when to use a particular framework to get the best results. We will show you everything required to successfully develop RESTful APIs with the four frameworks such as request handling, URL mapping, serialization, validation, authentication, authorization, versioning, ORMs, databases, custom code for models and views, and asynchronous callbacks. At the end of each framework, we will add authentication and security to the RESTful APIs and prepare tests for it. By the end of the book, you will have a deep understanding of the stacks needed to build RESTful web services.

Related Content you might be interested in

Current Title:

Small book image
Building RESTful Python Web Services
Gaston C. Hillar
Oct, 2016 | 418 pages
No titles found
Table of Contents (18 chapters)
Building RESTful Python Web Services
Building RESTful Python Web Services
Credits
Credits
About the Author
About the Author
Acknowledgments
Acknowledgments
About the Reviewer
About the Reviewer
www.PacktPub.com
www.PacktPub.com
Preface
Preface
Free Chapter
1
Developing RESTful APIs with Django
Developing RESTful APIs with Django
Designing a RESTful API to interact with a simple SQLite database
Understanding the tasks performed by each HTTP method
Working with lightweight virtual environments
Setting up the virtual environment with Django REST framework
Creating the models
Managing serialization and deserialization
Writing API views
Making HTTP requests to the API
Test your knowledge
Summary
2
Working with Class-Based Views and Hyperlinked APIs in Django
Working with Class-Based Views and Hyperlinked APIs in Django
Using model serializers to eliminate duplicate code
Working with wrappers to write API views
Using the default parsing and rendering options and move beyond JSON
Browsing the API
Designing a RESTful API to interact with a complex PostgreSQL database
Understanding the tasks performed by each HTTP method
Declaring relationships with the models
Managing serialization and deserialization with relationships and hyperlinks
Creating class-based views and using generic classes
Taking advantage of generic class based views
Working with endpoints for the API
Creating and retrieving related resources
Test your knowledge
Summary
3
Improving and Adding Authentication to an API With Django
Improving and Adding Authentication to an API With Django
Adding unique constraints to the models
Updating a single field for a resource with the PATCH method
Taking advantage of pagination
Customizing pagination classes
Understanding authentication, permissions and throttling
Adding security-related data to the models
Creating a customized permission class for object-level permissions
Persisting the user that makes a request
Configuring permission policies
Setting a default value for a new required field in migrations
Composing requests with the necessary authentication
Browsing the API with authentication credentials
Test your knowledge
Summary
4
Throttling, Filtering, Testing, and Deploying an API with Django
Throttling, Filtering, Testing, and Deploying an API with Django
Understanding throttling classes
Configuring throttling policies
Testing throttling policies
Understanding filtering, searching, and ordering classes
Configuring filtering, searching, and ordering for views
Testing filtering, searching, and ordering
Filtering, searching, and ordering in the Browsable API
Setting up unit tests
Writing a first round of unit tests
Running unit tests and checking testing coverage
Improving testing coverage
Understanding strategies for deployments and scalability
Test your knowledge
Summary
5
Developing RESTful APIs with Flask
Developing RESTful APIs with Flask
Designing a RESTful API to interact with a simple data source
Understanding the tasks performed by each HTTP method
Setting up a virtual environment with Flask and Flask-RESTful
Declaring status codes for the responses
Creating the model
Using a dictionary as a repository
Configuring output fields
Working with resourceful routing on top of Flask pluggable views
Configuring resource routing and endpoints
Making HTTP requests to the Flask API
Test your knowledge
Summary
6
Working with Models, SQLAlchemy, and Hyperlinked APIs in Flask
Working with Models, SQLAlchemy, and Hyperlinked APIs in Flask
Designing a RESTful API to interact with a PostgreSQL database
Understanding the tasks performed by each HTTP method
Installing packages to simplify our common tasks
Creating and configuring the database
Creating models with their relationships
Creating schemas to validate, serialize, and deserialize models
Combining blueprints with resourceful routing
Registering the blueprint and running migrations
Creating and retrieving related resources
Test your knowledge
Summary
7
Improving and Adding Authentication to an API with Flask
Improving and Adding Authentication to an API with Flask
Improving unique constraints in the models
Updating fields for a resource with the PATCH method
Coding a generic pagination class
Adding pagination features
Understanding the steps to add authentication and permissions
Adding a user model
Creating a schemas to validate, serialize, and deserialize users
Adding authentication to resources
Creating resource classes to handle users
Running migrations to generate the user table
Composing requests with the necessary authentication
Test your knowledge
Summary
8
Testing and Deploying an API with Flask
Testing and Deploying an API with Flask
Setting up unit tests
Writing a first round of unit tests
Running unit tests with nose2 and checking testing coverage
Improving testing coverage
Understanding strategies for deployments and scalability
Test your knowledge
Summary
9
Developing RESTful APIs with Tornado
Developing RESTful APIs with Tornado
Designing a RESTful API to interact with slow sensors and actuators
Understanding the tasks performed by each HTTP method
Setting up a virtual environment with Tornado
Declaring status codes for the responses
Creating the classes that represent a drone
Writing request handlers
Mapping URL patterns to request handlers
Making HTTP requests to the Tornado API
Test your knowledge
Summary
10
Working with Asynchronous Code, Testing, and Deploying an API with Tornado
Working with Asynchronous Code, Testing, and Deploying an API with Tornado
Understanding synchronous and asynchronous execution
Refactoring code to take advantage of asynchronous decorators
Mapping URL patterns to asynchronous request handlers
Making HTTP requests to the Tornado non-blocking API
Setting up unit tests
Writing a first round of unit tests
Running unit tests with nose2 and checking testing coverage
Improving testing coverage
Other Python Web frameworks for building RESTful APIs
Test your knowledge
Summary
11
Exercise Answers
Exercise Answers
Chapter 1, Developing RESTful APIs with Django
Chapter 2, Working with Class-Based Views and Hyperlinked APIs in Django
Chapter 3, Improving and Adding Authentication to an API With Django
Chapter 4, Throttling, Filtering, Testing, and Deploying an API with Django
Chapter 5, Developing RESTful APIs with Flask
Chapter 6, Working with Models, SQLAlchemy, and Hyperlinked APIs in Flask
Chapter 7, Improving and Adding Authentication to an API with Flask
Chapter 8, Testing and Deploying an API with Flask
Chapter 9, Developing RESTful APIs with Tornado
Chapter 10, Working with Asynchronous Code, Testing, and Deploying an API with Tornado

Acknowledgments

At the time of writing this book, I was fortunate to work with an excellent team at Packt Publishing , whose contributions vastly improved the presentation of this book. Reshma Raman and Aaron Lazar allowed me to provide them ideas to develop this book and I jumped into the exciting project of teaching how to use many popular web frameworks to develop RESTful Web Services with Python 3.5. Divij Kotian helped me realize my vision for this book and provided many sensible suggestions regarding the text, the format and the flow. The reader will notice his great work. It was great working with Divij in another book. In fact, it is the third book in which I was able to work with Reshma and Divij. It’s been great working with them in another project and I can’t wait to work with them again. I would like to thank my technical reviewers and proofreaders, for their thorough reviews and insightful comments. I was able to incorporate some of the knowledge and wisdom they have gained in their many years in the software development industry. This book was possible because they gave valuable feedback.

Gebin George did a wonderful job when the book moved into the production stage. He has made all the necessary adjustments to generate the final version of the book with an outstanding layout. Gebin made the book easy to read in its different versions and made sure I was happy with the results. A book like this one with so many tables, figures, pieces of code, commands and sample outputs requires skilled people with eye for detail during all the stages. I was fortunate to have Gebin onboard. I would like to thank my technical reviewers and proofreaders, for their thorough reviews and insightful comments. I was able to incorporate some of the knowledge and wisdom they have gained in their many years in the software development industry. This book was possible because they gave valuable feedback.

I usually start writing notes about ideas for a book when I spend time at software development conferences and events. I wrote the initial idea for this book in San Francisco, California, at Intel Developer Forum 2015. One year later, at Intel Developer Forum 2016, I had the chance to discuss with many software engineers the book I was finishing and incorporate their suggestions in the final drafts.

The entire process of writing a book requires a huge amount of lonely hours. I wouldn’t be able to write an entire book without dedicating some time to play soccer against my sons Kevin and Brandon, and my nephew, Nicolas. Of course, I never won a match. However, I did score a few goals.

Previous Section
Next Chapter