Skip to content

Latest commit

 

History

History
243 lines (166 loc) · 9.96 KB

README.md

File metadata and controls

243 lines (166 loc) · 9.96 KB
+ Pynecone'u mu arıyorsun? Doğru repodasın. Pynecone, Reflex olarak yeniden adlandırıldı. +
Reflex Logo Reflex Logo

✨ Saf Python'da performanslı, özelleştirilebilir web uygulamaları. Saniyeler içinde dağıtın. ✨

PyPI version tests versions Documentaiton Discord


English | 简体中文 | 繁體中文 | Türkçe | हिंदी | Português (Brasil) | Italiano | Español | 한국어 | 日本語


⚙️ Kurulum

Bir terminal açın ve çalıştırın (Python 3.8+ gerekir):

pip install reflex

🥳 İlk Uygulamanı Oluştur

reflex'i kurduğunuzda reflex komut satırı aracınıda kurmuş olursunuz.

Kurulumun başarılı olduğunu test etmek için yeni bir proje oluşturun. (my_app_name'i proje ismiyle değiştirin.):

mkdir my_app_name
cd my_app_name
reflex init

Bu komut ile birlikte yeni oluşturduğunuz dizinde bir şablon uygulaması oluşturur.

Uygulamanızı geliştirme modunda başlatabilirsiniz:

reflex run

Uygulamanızın http://localhost:3000 adresinde çalıştığını görmelisiniz.

Şimdi my_app_name/my_app_name.py yolundaki kaynak kodu düzenleyebilirsiniz. Reflex'in hızlı yenileme özelliği vardır, böylece kodunuzu kaydettiğinizde değişikliklerinizi anında görebilirsiniz.

🫧 Örnek Uygulama

Bir örnek üzerinden gidelim: DALL·E kullanarak bir görüntü oluşturma uygulaması yazalım. Basit olması açısından, yalnızca OpenAI API'ını kullanıyoruz, ancak bunu yerel olarak çalıştırılan bir makine öğrenimi modeliyle değiştirebilirsiniz.

 

A frontend wrapper for DALL·E, shown in the process of generating an image.

 

İşte bunu oluşturmak için kodun tamamaı. Her şey sadece bir Python dosyasıyla hazırlandı!

import reflex as rx
import openai

openai.api_key = "YOUR_API_KEY"

class State(rx.State):
    """Uygulama durumu."""
    prompt = ""
    image_url = ""
    processing = False
    complete = False

    def get_image(self):
        """Prompt'tan görüntüyü alın."""
        if self.prompt == "":
            return rx.window_alert("Prompt Empty")

        self.processing, self.complete = True, False
        yield
        response = openai.Image.create(prompt=self.prompt, n=1, size="1024x1024")
        self.image_url = response["data"][0]["url"]
        self.processing, self.complete = False, True
        

def index():
    return rx.center(
        rx.vstack(
            rx.heading("DALL·E"),
            rx.input(placeholder="Enter a prompt", on_blur=State.set_prompt),
            rx.button(
                "Generate Image",
                on_click=State.get_image,
                is_loading=State.processing,
                width="100%",
            ),
            rx.cond(
                State.complete,
                     rx.image(
                         src=State.image_url,
                         height="25em",
                         width="25em",
                    )
            ),
            padding="2em",
            shadow="lg",
            border_radius="lg",
        ),
        width="100%",
        height="100vh",
    )

# Sayfa ve durumu uygulamaya ekleyin.
app = rx.App()
app.add_page(index, title="reflex:DALL·E")

Daha Detaylı İceleyelim

Reflex UI

UI (Kullanıcı Arayüzü) ile başlayalım.

def index():
    return rx.center(
        ...
    )

Bu index fonkisyonu uygulamanın frontend'ini tanımlar.

Frontend'i oluşturmak için center, vstack, input, ve button gibi farklı bileşenler kullanıyoruz. Karmaşık düzenler oluşturmak için bileşenleri birbirinin içine yerleştirilebiliriz. Ayrıca bunları CSS'nin tüm gücüyle şekillendirmek için anahtar kelime argümanları kullanabilirsiniz.

Reflex, işinizi kolaylaştırmak için 60'tan fazla dahili bileşen içerir. Aktif olarak yeni bileşen ekliyoruz ve kendi bileşenlerinizi oluşturmak oldukça kolay.

Durum (State)

Reflex arayüzünüzü durumunuzun bir fonksiyonu olarak temsil eder.

class State(rx.State):
    """Uygulama durumu."""
    prompt = ""
    image_url = ""
    processing = False
    complete = False

Durum (State), bir uygulamadaki değişebilen tüm değişkenleri (vars olarak adlandırılır) ve bunları değiştiren fonksiyonları tanımlar.

Burada durum prompt ve image_urlinden oluşur. Ayrıca döngüsel ilerlemenin ve görüntünün ne zaman gösterileceğini belirtmek için processing ve complete booleanları da vardır.

Olay İşleyicileri (Event Handlers)

def get_image(self):
    """Prompt'tan görüntüyü alın."""
    if self.prompt == "":
        return rx.window_alert("Prompt Empty")

    self.processing, self.complete = True, False
    yield
    response = openai.Image.create(prompt=self.prompt, n=1, size="1024x1024")
    self.image_url = response["data"][0]["url"]
    self.processing, self.complete = False, True

Durum içinde, durum değişkenlerini değiştiren olay işleyicileri adı verilen fonksiyonları tanımlarız. Olay işleyicileri, Reflex'te durumu değiştirebilmemizi sağlar. Bir düğmeye tıklamak veya bir metin kutusuna yazı yazmak gibi kullanıcı eylemlerine yanıt olarak çağrılabilirler. Bu eylemlere olay denir.

DALL·E uygulamamız bir olay işleyicisine sahip, get_image ki bu da OpenAI API'ından oluşturulan resmi alır. Bir olay işleyicisinin ortasında yieldın kullanılması UI'ın güncellenmesini sağlar. Aksi takdirde UI olay işleyicisinin sonunda güncellenecektir.

Yönlendirme (Routing)

En sonunda uygulamamızı tanımlıyoruz.

app = rx.App()

Uygulamamızın kök dizinine index bileşeninden bir sayfa ekliyoruz. Ayrıca sayfa önizlemesinde/tarayıcı sekmesinde görünecek bir başlık ekliyoruz.

app.add_page(index, title="DALL-E")

Daha fazla sayfa ekleyerek çok sayfalı bir uygulama oluşturabilirsiniz.

📑 Kaynaklar

📑 Docs   |   🗞️ Blog   |   📱 Component Library   |   🖼️ Gallery   |   🛸 Deployment  

✅ Durum

Reflex, Aralık 2022'de Pynecone adıyla piyasaya sürüldü.

Temmuz 2023 itibarıyla Herkese Açık Beta aşamasındayız.

  • Public Alpha: Herkes Reflex'i yükleyebilir ve kullanabilir. Sorunlar olabilir, ancak bunları aktif olarak çözmek için çalışıyoruz.
  • 🔶 Public Beta: Kurumsal olmayan kullanım durumları için yeterince kararlı.
  • Public Hosting Beta: Optionally, uygulamalarınızı Reflex ile dağıtın ve barındırın!
  • Public: Reflex kullanıma hazır.

Reflex'in her hafta yeni sürümleri ve özellikleri geliyor! Güncel kalmak için ⭐ yıldızlamayı ve bu repoyu 👀 izlediğinizden emin olun.

Katkı

Her boyuttaki katkıları memnuniyetle karşılıyoruz! Aşağıda Reflex topluluğuna adım atmanın bazı yolları mevcut.

  • Discord Kanalımıza Katılın: Discord'umuz, Reflex projeniz hakkında yardım almak ve nasıl katkıda bulunabileceğinizi tartışmak için en iyi yerdir.
  • GitHub Discussions: Eklemek istediğiniz özellikler veya kafa karıştırıcı, açıklığa kavuşturulması gereken şeyler hakkında konuşmanın harika bir yolu.
  • GitHub Issues: Issues hataları bildirmenin mükemmel bir yoludur. Ayrıca mevcut bir sorunu deneyip çözebilir ve bir PR (Pull Requests) gönderebilirsiniz.

Beceri düzeyiniz veya deneyiminiz ne olursa olsun aktif olarak katkıda bulunacak kişiler arıyoruz. Katkı sağlamak için katkı sağlama rehberimize bakabilirsiniz: CONTIBUTING.md

Hepsi Katkıda Bulunanlar Sayesinde:

Lisans

Reflex açık kaynaklıdır ve Apache License 2.0 altında lisanslıdır.