peewee

peewee

Peewee ist ein einfaches und kleines ORM. Es verfügt über wenige (aber ausdrucksstarke) Konzepte, wodurch es leicht zu erlernen und intuitiv zu verwenden ist.

• ein kleines, ausdrucksstarkes ORM
• Python 2.7+ und 3.4+
• unterstützt SQLite, MySQL, Mariadb, Postgresql
• Tonnenweise Erweiterungen

Neu bei Peewee? Diese können helfen:

• Schnellstart
• Beispiel einer Twitter-App
• Peewee interaktiv nutzen
• Modelle und Felder
• Abfragen
• Beziehungen und Verbindungen

Beispiele

Das Definieren von Modellen ähnelt Django oder 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 )

Stellen Sie eine Verbindung zur Datenbank her und erstellen Sie Tabellen:

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

Erstellen Sie ein paar Zeilen:

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

Abfragen sind ausdrucksstark und zusammensetzbar:

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

Schauen Sie sich die Beispiel-Twitter-App an.

Mehr erfahren

Weitere Beispiele finden Sie in der Dokumentation.

Konkrete Frage? Kommen Sie vorbei im #peewee-Kanal auf irc.libera.chat oder posten Sie auf der Mailingliste http://groups.google.com/group/peewee-orm. Wenn Sie einen Fehler melden möchten, erstellen Sie ein neues Problem auf GitHub.

Möchten Sie noch mehr Informationen?

Ich habe eine Reihe von Blogbeiträgen über das Erstellen von Anwendungen und Webdiensten mit Peewee (und normalerweise Flask) geschrieben. Wenn Sie einige reale Anwendungen sehen möchten, die Peewee verwenden, können die folgenden Ressourcen hilfreich sein:

• Erstellen einer Notiz-App mit Flask und Peewee sowie Teil 2 und Teil 3.
• Mit Flask und Peewee erstellter Analytics-Webdienst.
• Personalisierte Nachrichtenübersicht (mit einem booleschen Abfrageparser!).
• Strukturieren von Flask-Apps mit Peewee.
• Erstellen eines Lastpass-Klons mit Flask und Peewee.
• Erstellen eines Lesezeichen-Webdienstes, der Screenshots Ihrer Lesezeichen erstellt.
• Erstellen eines Pastebins, eines Wikis und eines Lesezeichendienstes mit Flask und Peewee.
• Verschlüsselte Datenbanken mit Python und SQLCipher.
• Dear Diary: Ein verschlüsseltes Befehlszeilen-Tagebuch mit Peewee.
• Baumstrukturen in SQLite mit Peewee und der Transitive-Closure-Erweiterung abfragen.