peewee

pipí

Peewee es un ORM simple y pequeño. Tiene pocos conceptos (pero expresivos), lo que lo hace fácil de aprender y de uso intuitivo.

• un ORM pequeño y expresivo
• pitón 2.7+ y 3.4+
• soporta sqlite, mysql, mariadb, postgresql
• toneladas de extensiones

¿Nuevo en pipi? Estos pueden ayudar:

• Inicio rápido
• Ejemplo de aplicación de Twitter
• Usando Peewee interactivamente
• Modelos y campos
• Consultando
• Relaciones y uniones

Ejemplos

Definir modelos es similar a Django o SQLAlchemy:

 from peewee import *
import datetime


db = SqliteDatabase ( 'my_database.db' )

class BaseModel ( Model ):
    class Meta :
        database = db

class User ( BaseModel ):
    username = CharField ( unique = True )

class Tweet ( BaseModel ):
    user = ForeignKeyField ( User , backref = 'tweets' )
    message = TextField ()
    created_date = DateTimeField ( default = datetime . datetime . now )
    is_published = BooleanField ( default = True )

Conéctese a la base de datos y cree tablas:

 db . connect ()
db . create_tables ([ User , Tweet ])

Crea algunas filas:

 charlie = User . create ( username = 'charlie' )
huey = User ( username = 'huey' )
huey . save ()

# No need to set `is_published` or `created_date` since they
# will just use the default values we specified.
Tweet . create ( user = charlie , message = 'My first tweet' )

Las consultas son expresivas y componibles:

 # A simple query selecting a user.
User . get ( User . username == 'charlie' )

# Get tweets created by one of several users.
usernames = [ 'charlie' , 'huey' , 'mickey' ]
users = User . select (). where ( User . username . in_ ( usernames ))
tweets = Tweet . select (). where ( Tweet . user . in_ ( users ))

# We could accomplish the same using a JOIN:
tweets = ( Tweet
          . select ()
          . join ( User )
          . where ( User . username . in_ ( usernames )))

# How many tweets were published today?
tweets_today = ( Tweet
                . select ()
                . where (
                    ( Tweet . created_date >= datetime . date . today ()) &
                    ( Tweet . is_published == True ))
                . count ())

# Paginate the user table and show me page 3 (users 41-60).
User . select (). order_by ( User . username ). paginate ( 3 , 20 )

# Order users by the number of tweets they've created:
tweet_ct = fn . Count ( Tweet . id )
users = ( User
         . select ( User , tweet_ct . alias ( 'ct' ))
         . join ( Tweet , JOIN . LEFT_OUTER )
         . group_by ( User )
         . order_by ( tweet_ct . desc ()))

# Do an atomic update (for illustrative purposes only, imagine a simple
# table for tracking a "count" associated with each URL). We don't want to
# naively get the save in two separate steps since this is prone to race
# conditions.
Counter . update ( count = Counter . count + 1 ). where ( Counter . url == request . url )

Consulte la aplicación de Twitter de ejemplo.

Aprendiendo más

Consulte la documentación para ver más ejemplos.

¿Pregunta específica? Ven y pasa el rato en el canal #peewee en irc.libera.chat, o publica en la lista de correo, http://groups.google.com/group/peewee-orm. Si desea informar un error, cree una nueva incidencia en GitHub.

¿Aún quieres más información?

He escrito varias publicaciones de blog sobre la creación de aplicaciones y servicios web con peewee (y generalmente Flask). Si desea ver algunas aplicaciones de la vida real que utilizan peewee, los siguientes recursos pueden resultarle útiles:

• Creación de una aplicación para tomar notas con Flask y Peewee, así como con las Partes 2 y 3.
• Servicio web de análisis creado con Flask y Peewee.
• Resumen de noticias personalizado (¡con un analizador de consultas booleanas!).
• Estructuración de aplicaciones Flask con Peewee.
• Creando un clon de último paso con Flask y Peewee.
• Crear un servicio web de marcadores que tome capturas de pantalla de sus marcadores.
• Creación de un Pastebin, una wiki y un servicio de marcadores utilizando Flask y Peewee.
• Bases de datos cifradas con Python y SQLCipher.
• Querido diario: un diario cifrado de línea de comandos con Peewee.
• Consultar estructuras de árbol en SQLite usando Peewee y la extensión de cierre transitivo.