tinydb

Tautan Cepat

• Contoh Kode
• Versi Python yang Didukung
• Dokumentasi
• log perubahan
• Ekstensi
• Berkontribusi

Perkenalan

TinyDB adalah database berorientasi dokumen ringan yang dioptimalkan untuk kebahagiaan Anda :) Ini ditulis dengan Python murni dan tidak memiliki ketergantungan eksternal. Targetnya adalah aplikasi kecil yang akan dihancurkan oleh SQL-DB atau server database eksternal.

TinyDB adalah:

• kecil: Kode sumber saat ini memiliki 1.800 baris kode (dengan sekitar 40% dokumentasi) dan 1.600 baris pengujian.
• berorientasi dokumen: Seperti MongoDB, Anda dapat menyimpan dokumen apa pun (direpresentasikan sebagai dict ) di TinyDB.
• dioptimalkan untuk kebahagiaan Anda: TinyDB dirancang sederhana dan menyenangkan untuk digunakan dengan menyediakan API yang sederhana dan bersih.
• ditulis dengan Python murni: TinyDB tidak memerlukan server eksternal (misalnya PyMongo) atau ketergantungan apa pun dari PyPI.
• berfungsi pada Python 3.8+ dan PyPy3: TinyDB berfungsi pada semua versi modern Python dan PyPy.
• sangat dapat diperluas: Anda dapat dengan mudah memperluas TinyDB dengan menulis penyimpanan baru atau mengubah perilaku penyimpanan dengan Middlewares.
• Cakupan tes 100%: Tidak diperlukan penjelasan.

Untuk mendalami semua detailnya, buka dokumen TinyDB. Anda juga dapat mendiskusikan segala sesuatu yang berhubungan dengan TinyDB seperti pengembangan umum, ekstensi atau memamerkan proyek berbasis TinyDB Anda di forum diskusi.

Versi Python yang Didukung

TinyDB telah diuji dengan Python 3.8 - 3.13 dan PyPy3.

Status Proyek

Proyek ini sedang dalam mode pemeliharaan. Ini telah mencapai keadaan matang dan stabil di mana fitur-fitur baru atau perubahan arsitektur yang signifikan tidak direncanakan. Meskipun demikian, masih akan ada rilis untuk perbaikan bug atau fitur yang disumbangkan oleh komunitas. Baca selengkapnya tentang arti hal ini secara khusus di sini.

Contoh Kode

 > >> from tinydb import TinyDB , Query
> >> db = TinyDB ( '/path/to/db.json' )
> >> db . insert ({ 'int' : 1 , 'char' : 'a' })
> >> db . insert ({ 'int' : 1 , 'char' : 'b' })

Bahasa Kueri

 > >> User = Query ()
> >> # Search for a field value
>> > db . search ( User . name == 'John' )
[{ 'name' : 'John' , 'age' : 22 }, { 'name' : 'John' , 'age' : 37 }]

> >> # Combine two queries with logical and
>> > db . search (( User . name == 'John' ) & ( User . age <= 30 ))
[{ 'name' : 'John' , 'age' : 22 }]

> >> # Combine two queries with logical or
>> > db . search (( User . name == 'John' ) | ( User . name == 'Bob' ))
[{ 'name' : 'John' , 'age' : 22 }, { 'name' : 'John' , 'age' : 37 }, { 'name' : 'Bob' , 'age' : 42 }]

> >> # Negate a query with logical not
>> > db . search ( ~ ( User . name == 'John' ))
[{ 'name' : 'Megan' , 'age' : 27 }, { 'name' : 'Bob' , 'age' : 42 }]

> >> # Apply transformation to field with `map`
>> > db . search (( User . age . map ( lambda x : x + x ) == 44 ))
> >> [{ 'name' : 'John' , 'age' : 22 }]

> >> # More possible comparisons:  !=  <  >  <=  >=
>> > # More possible checks: where(...).matches(regex), where(...).test(your_test_func)

Tabel

 > >> table = db . table ( 'name' )
> >> table . insert ({ 'value' : True })
> >> table . all ()
[{ 'value' : True }]

Menggunakan Middleware

 > >> from tinydb . storages import JSONStorage
> >> from tinydb . middlewares import CachingMiddleware
> >> db = TinyDB ( '/path/to/db.json' , storage = CachingMiddleware ( JSONStorage ))

Berkontribusi

Baik melaporkan bug, mendiskusikan perbaikan dan ide-ide baru, atau menulis ekstensi: Kontribusi ke TinyDB dipersilakan! Berikut cara memulainya:

1. Periksa masalah yang masih terbuka atau buka masalah baru untuk memulai diskusi seputar ide fitur atau bug
2. Cabangkan repositori di Github, buat cabang baru dari cabang master dan mulailah membuat perubahan (dikenal sebagai GitHub Flow)
3. Tulis tes yang menunjukkan bahwa bug telah diperbaiki atau fitur berfungsi seperti yang diharapkan
4. Kirim permintaan tarik dan bug pengelola hingga digabungkan dan dipublikasikan ☺