پرش به محتویات

خوش آمدید به AbarORM

لوگو

abarorm یک کتابخانه سبک و آسان برای استفاده از نگاشت شیء-رابطه‌ای (ORM) برای پایگاه‌داده‌های SQLite و PostgreSQL در پایتون است. هدف آن ارائه یک رابط ساده و شهودی برای مدیریت مدل‌های پایگاه‌داده و تعاملات است.

ویژگی‌ها

  • تعریف مدل‌ها با استفاده از کلاس‌های پایتون.
  • مدیریت خودکار ایجاد و مدیریت طرح پایگاه‌داده.
  • پشتیبانی از عملیات CRUD (ایجاد، خواندن، به‌روزرسانی، حذف) پایه.
  • مدیریت روابط کلید خارجی به سادگی.
  • انواع فیلد سفارشی با اعتبارسنجی و محدودیت‌ها.
  • جدید در v1.0.0: ایجاد و به‌روزرسانی جدول به‌صورت خودکار.
  • جدید در v2.0.0: افزودن پشتیبانی از پایگاه‌داده‌های PostgreSQL.
  • جدید در v2.0.0: مرتب‌سازی بر اساس فیلدها در متد all().
  • جدید در v3.0.0: رفع اشکالات نام‌گذاری جدول برای اطمینان از سازگاری نام‌ها.
  • جدید در v3.0.0: به‌روزرسانی مقادیر برگشتی متدها برای بهبود وضوح و قابلیت استفاده.
  • جدید در v3.0.0: متد filter بهبود یافته اکنون از order_by برای مرتب‌سازی پشتیبانی می‌کند.
  • جدید در v3.2.0: افزودن قابلیت __gte و __lte در بخش فیلتر.
  • جدید در v4.0.0: روش های __repr__ ، count و to_dict برای دستکاری داده ها و اشکال زدایی آسان تر اضافه شد.
  • جدید در v4.2.3: متدهای first() ، last() ، exists() و paginate() به کلاس QuerySet برای قابلیت های جستجوی قدرتمندتر اضافه شده است.
  • جدید در 5.0.0: رفع اشکالات و ساختار PostgreSQL.
  • جدید در 5.1.0: عملکرد پیشرفته برای قابلیت استفاده و استحکام بهتر:
  • روش حذف بهبود یافته: اکنون از فیلتر کردن توسط فیلدهای اضافی فراتر از id پشتیبانی می کند و به درخواست های حذف انعطاف پذیرتر اجازه می دهد.
  • روش حاوی پیشرفته: به آرگومان‌های کلیدواژه پویا (kwargs) برای فیلتر کردن اجازه می‌دهد و درخواست‌های بصری را فعال می‌کند.

پایگاه‌داده‌های پشتیبانی‌شده

psql sqlite

نصب

شما می‌توانید abarorm را از PyPI با استفاده از pip نصب کنید:

pip install abarorm

برای پشتیبانی از PostgreSQL، psycopg2-binary را نصب کنید: (ضروری)

pip install psycopg2-binary

با abarorm شروع کنید