test-salla-pup-tetetetst 0.0.0.dev1
Python Salla api.
License: MIT
Requires Python: >=3.8
Keywords: salla,salla api



<div align="center">
<img src="https://i.suar.me/mKLad/l" width=400>
</div>

# <p align="center">Salla 🛍️ 
## <p dir="rtl" align="center"> تحت التطوير 👨‍💻


### <p dir="rtl" align="center"> مكتبة بايثون بسيطة، ولاكن قابلة للتوسع، خاصة بـ <a href="https://docs.salla.dev/">واجهة برمجة تطبيقات سلة</a> 👏.


## <p dir="rtl" align="center">المكتبة تحت التطوير الى الان ولم يتم دعم اي اصدار من  <a href="https://docs.salla.dev/">سلة</a> بشكل كامل ⏳

<div dir="rtl">

## المحتوى

  * [البداية](#البداية)
  * [كتابة كودك الاول](#كتابة-كودك-الاول)
    * [المتطلبات](#المتطلبات)
    * [كود بسيط لعرض المنتجات](#كود-بسيط-لعرض-المنتجات)
  * [الوثائق العامة](#الوثائق-العامة)
    * [الانواع - Types](#الانواع---Types)
    * [الاستخدام العام للمكتبة](#الاستخدام-العام-للمكتبة)
      * [المنتجات - products](#المنتجات---products)
  * [المزيد من الامثلة](#المزيد-من-الامثلة)
  * [مجموعة التيليجرام](#مجموعة-التيليجرام)
  * [عند مواجهة مشكلة](#عند-مواجهة-مشكلة)
  <!-- * [مشاريع استخدمت المكتبة](#مشاريع-استخدمت-المكتبة) -->

## البداية

تحتاج اصدار [بايثون](https://python.org) اكبر من او يساوي 3.8


هناك طريقتين لتنزيل المكتبة

* تنزيلها باستخدام pip ([مدير حزم بايثون](https://pip.pypa.io/en/stable/cli/pip_install/))*:

```bash
قريباً.
```

* التنزيل من السورس كود ([git](https://git-scm.com/downloads))*:

```bash
قريباً.
```

<!-- <b>لا يزال قيد التطوير ولديه تحديثات منتظمة ، لا تنس تحديثه بانتظام عن طريق استدعاء `pip install salla --upgrade` </b> -->

## كتابة كودك الاول

### المتطلبات

من المفترض أنك [حصلت على رمز واجهة برمجة التطبيقات](https://docs.salla.dev/docs/merchent/ZG9jOjIzMjE3MjMy-authorization). سوف نسمي هذا الرمز المميز "TOKEN".
علاوة على ذلك ، لديك معرفة أساسية بلغة برمجة Python والأهم من ذلك [واجهة برمجة تطبيقات سلة](https://docs.salla.dev/).


### كود بسيط لعرض المنتجات

انشاء ملف جديد اسمه `salla_products_list.py`
وبعد ذالك افتح الملف واستعدي فيه مكتبة سلة 

</div>

```python
import salla

store = salla.SallaStore(token="TOKEN")

for product in store.products():
    print(product.name)
```
<div dir="rtl">

بسيط جدا  🎉

*تنويه: تاكد من انك قمت باستبدال  الـ TOKEN مع الرمز الخاص بك.*

*تنويه: salla.SallaStore.products ترجع لك نوع map وليس مصفوفة اذ كنت تريد تحويلها الى المصفوفة انظر الى المثال 👇 .*

</div>

```python
import salla

store = salla.SallaStore(token="TOKEN")

# وضع المنتجات في مصفوفة
products = list(store.products())
```
<div dir="rtl">

**يمكنك تصفية الكلمات الرئيسية والحالة والفئة انظر الى [SallaStore.products](#المنتجات---products)**


## الوثائق العامة

### الانواع - Types

جميع الانواع متعرفة في [salla_types.py](salla/types.py) ومشروحة هناك القي نظرة

ويمكنك العثور على نوع المنتجات هنا [product.py](salla/product.py)

### الاستخدام العام للمكتبة

تم توضيح بعض حالات الاستخدام العامة لواجهة برمجة التطبيقات أدناه.

#### المنتجات - products

فيما يلي بعض الأمثلة على استخدام عوامل التصفية ومعالجات جلب المنتجات

</div>

```python

import salla

store = salla.SallaStore(token="TOKEN")


# جلب المنتجات بدون تصفية
products = store.products()

# SKU تصفية المنتجات مع اسم محدد أو.
products = store.products(keyword="هنا SKU يتم وضع الاسم او ال")

# التصفية بحسب رقم الصفحة
products = store.products(page=1)


# وضع حد للمنتجات لكل صفحة
products = store.products(per_page=3)


# (hidden,sale,out) تصفية بحسب حالة المنتج
products = store.products(status="out")

```

<div dir="rtl">

## المزيد من الامثلة

يمكنك العثور على المزيد من الامثلة في [مجلد الامثلة](examples)


## مجموعة التيليجرام

احصل على مساعدة. مناقشة. دردشة.

* انضم الى [مجموعة دردشة  تيليجرام الخاصة بواجهة برمجة تطبيقات سلة](https://t.me/salladev)

## عند مواجهة مشكلة

لاتتردد رفع [issues](https://github.com/TheAwiteb/salla/issues) عند مواجهة اي مشكلة

## الرخصة
هذا المشروع تحت رخصة ([MIT](https://opensource.org/licenses/MIT))