Django تعارفی گائیڈ: تیزی سے اپنی پہلی ویب ایپلیکیشن بنائیں

Django ایک اعلیٰ سطحی Python ویب فریم ورک ہے، جس کا مقصد تیز رفتار ترقی اور سادہ ڈیزائن ہے۔ یہ ماڈل-ٹیمپلیٹ-ویو (MTV) فن تعمیر کی پیروی کرتا ہے، اور کوڈ کے دوبارہ استعمال اور کمپوننٹائزیشن کی حوصلہ افزائی کرتا ہے۔ یہ گائیڈ آپ کو قدم بہ قدم ایک سادہ Django ایپلیکیشن بنانے میں مدد کرے گی، تاکہ آپ تیزی سے شروعات کر سکیں۔

1. ماحول کی تنصیب

سب سے پہلے، آپ کو یہ یقینی بنانا ہوگا کہ آپ کے سسٹم پر Python انسٹال ہے۔ Django Python 3.6 یا اس سے اوپر کے ورژن استعمال کرنے کی سفارش کرتا ہے۔

1.1 Python انسٹال کریں

اگر آپ کے سسٹم پر Python انسٹال نہیں ہے، تو آپ اسے Python کی آفیشل ویب سائٹ سے ڈاؤن لوڈ اور انسٹال کر سکتے ہیں۔

1.2 ورچوئل ماحول بنائیں (Virtual Environment)

مختلف پروجیکٹس کے درمیان انحصار کو الگ کرنے کے لیے، ورچوئل ماحول استعمال کرنے کی سختی سے سفارش کی جاتی ہے۔

ٹرمینل یا کمانڈ پرامپٹ کھولیں۔
ایک پروجیکٹ ڈائریکٹری بنائیں، مثال کے طور پر myproject:
```
mkdir myproject
cd myproject
```
ورچوئل ماحول بنائیں اور فعال کریں:
```
python3 -m venv venv  # یا python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate  # Windows
```
ورچوئل ماحول کو فعال کرنے کے بعد، آپ کے ٹرمینل پرامپٹ پر (venv) ظاہر ہوگا، جس کا مطلب ہے کہ آپ ورچوئل ماحول استعمال کر رہے ہیں۔

1.3 Django انسٹال کریں

فعال ورچوئل ماحول میں، pip کا استعمال کرتے ہوئے Django انسٹال کریں:

pip install Django

تصدیق کریں کہ انسٹالیشن کامیاب رہی:

python -m django --version

آپ کو Django کا ورژن نمبر نظر آنا چاہیے۔

2. Django پروجیکٹ بنائیں

Django انسٹال کرنے کے بعد، آپ ایک نیا Django پروجیکٹ بنا سکتے ہیں۔

اب بھی اپنی پروجیکٹ ڈائریکٹری (myproject) میں، درج ذیل کمانڈ چلائیں:
```
django-admin startproject mysite
```
یہ myproject ڈائریکٹری میں mysite نامی ایک ڈائریکٹری بنائے گا، جس میں Django پروجیکٹ کے بنیادی فائلیں شامل ہوں گی۔
mysite ڈائریکٹری میں جائیں:
```
cd mysite
```
Django پروجیکٹ ڈائریکٹری کا ڈھانچہ اس طرح ہے:
```
mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py
```
- manage.py: ایک کمانڈ لائن ٹول، جو Django پروجیکٹ کو منظم کرنے کے لیے استعمال ہوتا ہے۔
- mysite/: Python پیکیج جس میں پروجیکٹ کی ترتیبات شامل ہیں۔
  - __init__.py: ایک خالی فائل، جو Python کو بتاتی ہے کہ اس ڈائریکٹری کو ایک Python پیکیج سمجھا جانا چاہیے۔
  - settings.py: پروجیکٹ کی کنفیگریشن فائل، جیسے کہ ڈیٹا بیس کی ترتیبات، ڈیبگ موڈ وغیرہ۔
  - urls.py: URL روٹنگ کنفیگریشن، URL کو ویو فنکشنز سے نقشہ کرتی ہے۔
  - asgi.py: ASGI (Asynchronous Server Gateway Interface) کنفیگریشن فائل، جو غیر مطابقت پذیر ایپلی کیشنز کو تعینات کرنے کے لیے استعمال ہوتی ہے۔
  - wsgi.py: WSGI (Web Server Gateway Interface) کنفیگریشن فائل، جو روایتی مطابقت پذیر ایپلی کیشنز کو تعینات کرنے کے لیے استعمال ہوتی ہے۔## 3. ڈویلپمنٹ سرور شروع کریں

Django ایک ہلکا پھلکا ڈویلپمنٹ سرور کے ساتھ آتا ہے، جو آپ کو مقامی طور پر تیار کرنے اور جانچنے میں سہولت فراہم کرتا ہے۔

mysite ڈائریکٹری میں، درج ذیل کمانڈ چلائیں:
```
python manage.py runserver
```
اپنا براؤزر کھولیں اور http://127.0.0.1:8000/ پر جائیں۔ آپ کو "It worked! Congratulations on your first Django-powered page." کا صفحہ نظر آنا چاہیے۔

4. Django ایپلیکیشن بنائیں

ایک Django پروجیکٹ میں متعدد ایپلیکیشنز ہوسکتی ہیں۔ آئیے myapp نامی ایک ایپلیکیشن بنائیں۔

ایک نئی ٹرمینل ونڈو کھولیں (ڈویلپمنٹ سرور کو چلتا رکھیں)۔
mysite ڈائریکٹری میں، درج ذیل کمانڈ چلائیں:
```
python manage.py startapp myapp
```
یہ mysite ڈائریکٹری میں myapp نامی ایک ڈائریکٹری بنائے گا، جس میں Django ایپلیکیشن کے بنیادی فائلیں شامل ہوں گی۔
Django ایپلیکیشن ڈائریکٹری کا ڈھانچہ درج ذیل ہے:
```
myapp/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py
```
- __init__.py: ایک خالی فائل، جو Python کو بتاتی ہے کہ اس ڈائریکٹری کو ایک Python پیکیج سمجھا جانا چاہیے۔
- admin.py: Django ایڈمن پینل کو ترتیب دینے کے لیے استعمال ہوتا ہے۔
- apps.py: ایپلیکیشن کی ترتیب۔
- migrations/: ڈیٹا بیس کی منتقلی کو منظم کرنے کے لیے استعمال ہوتا ہے۔
- models.py: ڈیٹا ماڈلز (ڈیٹا بیس ٹیبلز) کی وضاحت کرتا ہے۔
- tests.py: ٹیسٹ کیسز لکھیں۔
- views.py: ویو فنکشنز کی وضاحت کرتا ہے، جو درخواستوں کو ہینڈل کرتے ہیں اور جوابات واپس کرتے ہیں۔

mysite/settings.py میں، myapp کو INSTALLED_APPS فہرست میں شامل کریں:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myapp',  # myapp شامل کریں
]

5. ایک سادہ ویو بنائیں

اب ہم ایک سادہ ویو بناتے ہیں، جو براؤزر میں "Hello, Django!" دکھائے گا۔

myapp/views.py فائل میں ترمیم کریں اور درج ذیل کوڈ شامل کریں:

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django!")

ایک myapp/urls.py فائل بنائیں، اور URL کو ویو فنکشن میں میپ کریں:

    from django.urls import path
    from . import views

    urlpatterns = [
        path('', views.index, name='index'),
    ]
    ```

3. `myapp/urls.py` کو `mysite/urls.py` میں شامل کریں:

    ```python
    from django.urls import include, path
    from django.contrib import admin

    urlpatterns = [
        path('admin/', admin.site.urls),
        path('myapp/', include('myapp.urls')),  # myapp کی URL کنفیگریشن شامل کریں
    ]
    ```

4. `http://127.0.0.1:8000/myapp/` پر جائیں۔ آپ کو "Hello, Django!" کا صفحہ نظر آنا چاہیے۔

## 6. ایک ماڈل بنائیں

آئیے کچھ ڈیٹا ذخیرہ کرنے کے لیے ایک سادہ ماڈل بناتے ہیں۔

1. `myapp/models.py` فائل میں ترمیم کریں اور درج ذیل کوڈ شامل کریں:

    ```python
    from django.db import models

    class Question(models.Model):
        question_text = models.CharField(max_length=200)
        pub_date = models.DateTimeField('date published')

        def __str__(self):
            return self.question_text
    ```

    یہ `Question` نامی ایک ماڈل کی وضاحت کرتا ہے، جس میں دو فیلڈز شامل ہیں: `question_text` (CharField) اور `pub_date` (DateTimeField)۔

2. ڈیٹا بیس کی منتقلی بنائیں اور لاگو کریں:

    ```bash
    python manage.py makemigrations myapp
    python manage.py migrate
    ```

    `makemigrations` کمانڈ آپ کے ماڈل کی بنیاد پر منتقلی فائلیں بنائے گی، اور `migrate` کمانڈ منتقلی کو ڈیٹا بیس پر لاگو کرے گی۔

## 7. Django ایڈمن پینل استعمال کریں

Django ایک طاقتور ایڈمن پینل مہیا کرتا ہے، جو آپ کے ڈیٹا کو آسانی سے منظم کرنے کے لیے استعمال کیا جا سکتا ہے۔

1. ایک سپر صارف بنائیں:

    ```bash
    python manage.py createsuperuser
    ```

    اشارے پر عمل کرتے ہوئے صارف نام، ای میل اور پاس ورڈ درج کریں۔

2. `myapp/admin.py` فائل میں ترمیم کریں اور `Question` ماڈل کو رجسٹر کریں:

    ```python
    from django.contrib import admin
    from .models import Question

    admin.site.register(Question)
    ```

3. `http://127.0.0.1:8000/admin/` پر جائیں، اور اپنے بنائے ہوئے سپر صارف کے ساتھ لاگ ان کریں۔ آپ کو "Questions" ماڈیول نظر آئے گا، جہاں آپ سوالات شامل، ترمیم اور حذف کر سکتے ہیں۔

## 8. ٹیمپلیٹس استعمال کریں

ٹیمپلیٹس کا استعمال HTML صفحات کو زیادہ لچکدار طریقے سے تیار کرنے کے لیے کیا جا سکتا ہے۔1. `myapp` ڈائریکٹری میں `templates` نامی ایک ڈائریکٹری بنائیں، اور `templates` ڈائریکٹری میں `myapp` نامی ایک ڈائریکٹری بنائیں (`myapp/templates/myapp`)۔

2. `myapp/templates/myapp` ڈائریکٹری میں `index.html` نامی ایک فائل بنائیں، اور درج ذیل کوڈ شامل کریں:

    ```html
    

    
        Hello, Django!
    
    
        The current time is: {{ current_time }}
    

    ```

3. `myapp/views.py` فائل میں ترمیم کریں اور ٹیمپلیٹ استعمال کریں:

    ```python
    from django.shortcuts import render
    import datetime

    def index(request):
        now = datetime.datetime.now()
        return render(request, 'myapp/index.html', {'current_time': now})
    ```

    `render` فنکشن ٹیمپلیٹ کو لوڈ کرے گا اور ڈیٹا کو رینڈر کرنے کے لیے ٹیمپلیٹ میں منتقل کرے گا۔

4. دوبارہ `http://127.0.0.1:8000/myapp/` پر جائیں۔ آپ کو ایک ایسا صفحہ نظر آنا چاہیے جس میں موجودہ وقت شامل ہو۔

## 9. نتیجہ

اس گائیڈ کے ذریعے، آپ Django کے بنیادی تصورات اور استعمال کے طریقوں کو سمجھ چکے ہیں، بشمول ماحول کی تنصیب، پروجیکٹ اور ایپلیکیشن بنانا، ماڈل کی تعریف کرنا، ویوز بنانا اور ٹیمپلیٹس کا استعمال کرنا۔ یہ صرف ایک شروعات ہے، Django بہت ساری خصوصیات مہیا کرتا ہے، آپ مزید پیچیدہ ویب ایپلیکیشن بنانے کے لیے سیکھنا اور دریافت کرنا جاری رکھ سکتے ہیں۔