peewee

ピーピー

Peewee はシンプルで小さな ORM です。コンセプトがほとんどない (ただし表現力豊か) ため、習得が簡単で直感的に使用できます。

• 小さくて表現力豊かな ORM
• Python 2.7 以降および 3.4 以降
• sqlite、mysql、mariadb、postgresqlをサポート
• 大量の拡張機能

ピーウィーは初めてですか?これらが役立つかもしれません:

• クイックスタート
• ツイッターアプリの例
• インタラクティブにピーウィーを使用する
• モデルとフィールド
• クエリを実行する
• 関係と結合

例

モデルの定義は、Django や 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 )

データベースに接続し、テーブルを作成します。

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

いくつかの行を作成します。

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

クエリは表現力豊かで構成可能です。

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

Twitter アプリのサンプルを確認してください。

もっと詳しく知る

その他の例については、ドキュメントを確認してください。

具体的な質問ですか？ irc.libera.chat の #peewee チャンネルに参加するか、メーリング リスト http://groups.google.com/group/peewee-orm に投稿してください。バグを報告したい場合は、GitHub で新しい問題を作成してください。

さらに詳しい情報が必要ですか?

私は、peewee (通常は Flask) を使用したアプリケーションと Web サービスの構築に関するブログ記事を数多く書いてきました。 peeweee を使用する実際のアプリケーションを確認したい場合は、次のリソースが役立つ場合があります。

• Flask と Peewee、およびパート 2 とパート 3 を使用してメモを取るアプリを構築します。
• Flask と Peewee で構築された分析 Web サービス。
• パーソナライズされたニュース ダイジェスト (ブール クエリ パーサーを使用)。
• Peewee を使用して Flask アプリを構築します。
• Flask と Peewee を使用して lastpass クローンを作成します。
• ブックマークのスクリーンショットを撮るブックマーク Web サービスを作成します。
• Flask と Peewee を使用して、ペーストビン、Wiki、ブックマーク サービスを構築します。
• Python と SQLCipher を使用した暗号化されたデータベース。
• Dear Diary: Peewee を使用した暗号化されたコマンドライン日記。
• Peewee と Transitive Closure Extension を使用して SQLite でツリー構造をクエリします。