peewee

xixi

Peewee é um ORM simples e pequeno. Possui poucos conceitos (mas expressivos), o que o torna fácil de aprender e intuitivo de usar.

• um ORM pequeno e expressivo
• python 2.7+ e 3.4+
• suporta sqlite, mysql, mariadb, postgresql
• toneladas de extensões

Novo no peewee? Isso pode ajudar:

• Início rápido
• Exemplo de aplicativo do Twitter
• Usando peewee interativamente
• Modelos e campos
• Consultando
• Relacionamentos e junções

Exemplos

Definir modelos é semelhante ao Django ou 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 )

Conecte-se ao banco de dados e crie tabelas:

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

Crie algumas linhas:

 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' )

As consultas são expressivas e combináveis:

 # 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 )

Confira o exemplo do aplicativo do Twitter.

Aprendendo mais

Verifique a documentação para mais exemplos.

Pergunta específica? Venha participar do canal #peewee em irc.libera.chat ou poste na lista de e-mails http://groups.google.com/group/peewee-orm . Se você quiser relatar um bug, crie um novo problema no GitHub.

Ainda quer mais informações?

Escrevi vários posts sobre a construção de aplicativos e serviços da Web com peewee (e geralmente com Flask). Se você quiser ver alguns aplicativos da vida real que usam o peewee, os seguintes recursos podem ser úteis:

• Construindo um aplicativo de anotações com Flask e Peewee, bem como a Parte 2 e a Parte 3.
• Serviço web analítico desenvolvido com Flask e Peewee.
• Resumo de notícias personalizado (com um analisador de consulta booleano!).
• Estruturando aplicativos Flask com Peewee.
• Criando um clone lastpass com Flask e Peewee.
• Criação de um serviço web de bookmarking que faz capturas de tela de seus favoritos.
• Construindo um pastebin, wiki e um serviço de bookmarking usando Flask e Peewee.
• Bancos de dados criptografados com Python e SQLCipher.
• Caro diário: um diário criptografado de linha de comando com Peewee.
• Consulte estruturas de árvore em SQLite usando Peewee e a extensão Transitive Closure.