mirror of https://github.com/pallets/flask.git
				
				
				
			
		
			
				
	
	
		
			34 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
			
		
		
	
	
			34 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
.. _tutorial-introduction:
 | 
						|
 | 
						|
Introducing Flaskr
 | 
						|
==================
 | 
						|
 | 
						|
We will call our blogging application flaskr, but feel free to choose your own
 | 
						|
less Web-2.0-ish name ;)  Essentially, we want it to do the following things:
 | 
						|
 | 
						|
1. Let the user sign in and out with credentials specified in the
 | 
						|
   configuration.  Only one user is supported.
 | 
						|
2. When the user is logged in, they can add new entries to the page
 | 
						|
   consisting of a text-only title and some HTML for the text.  This HTML
 | 
						|
   is not sanitized because we trust the user here.
 | 
						|
3. The index page shows all entries so far in reverse chronological order
 | 
						|
   (newest on top) and the user can add new ones from there if logged in.
 | 
						|
 | 
						|
We will be using SQLite3 directly for this application because it's good
 | 
						|
enough for an application of this size.  For larger applications, however,
 | 
						|
it makes a lot of sense to use `SQLAlchemy`_, as it handles database
 | 
						|
connections in a more intelligent way, allowing you to target different
 | 
						|
relational databases at once and more.  You might also want to consider
 | 
						|
one of the popular NoSQL databases if your data is more suited for those.
 | 
						|
 | 
						|
Here a screenshot of the final application:
 | 
						|
 | 
						|
.. image:: ../_static/flaskr.png
 | 
						|
   :align: center
 | 
						|
   :class: screenshot
 | 
						|
   :alt: screenshot of the final application
 | 
						|
 | 
						|
Continue with :ref:`tutorial-folders`.
 | 
						|
 | 
						|
.. _SQLAlchemy: http://www.sqlalchemy.org/
 |