$ go install github.com/Elagoht/collage/cmd/collage@latest
$ collage new <project_name>
$ cd <project_name>
$ go mod tidy
$ collage dev

Sunucuda render edilen web için bir Go framework'ü

Sunucudan HTML, fragment fragment.

Sunucuda fragment'lerden render edilen, neye bağlıysa ona göre cache'lenen ve kısım kısım güncellenen page'ler. Tek bir Go binary'sinde.

Bir landing page, single-page app değildir

Bir ürün sayfası, bir landing page, tıklanacak pek bir şeyi olmayan birkaç sayfalık bir site: hiçbiri sunucuda bir JavaScript runtime'ına, bir client framework'üne ve bir hydration adımına ihtiyaç duymaz. Böyle bir runtime Go'dan yavaştır ve sunucuda daha fazla bellek ve disk tüketir. Client framework'ü ise tarayıcıya, doğrudan alabileceği HTML'i kurması için bir program gönderir. collage HTML'i gönderir.

Tipik bir stack (JavaScript bundle'ı, hydration, SSR framework'ü, bir bağımlılık ağacı ve bir JavaScript runtime'ı) ve yanında collage: HTML, birkaç satır JavaScript ve tek bir Go binary'si.tipik bir stackJS bundlehydrationSSR frameworkbağımlılık ağacıJS runtimecollageHTMLbirkaç satır JStek Go binary'sikurulacak runtime yok

Component değil, fragment

Bir page, fragment'leri saran bir layout'tur. Her fragment bir template ve kendi verisini çeken bir fonksiyondur. Kardeş fragment'ler verilerini aynı anda çeker, page yine de sırasıyla yazılır. Bir fragment'i WithFragmentPath ile kendine ait bir URL'de açın; üç satırlık bir fetch page'in yalnızca o kısmını yenisiyle değiştirir. Sunucudaki state sunucuda render edilir ve her seferinde bir fragment güncellenir.

fetch, XHR, server-sent events ve WebSocket tam da bunun için yapıldı. Script'i yazmak istemezseniz bir plugin fragment'leri belirli aralıklarla ya da sunucu push ettiğinde yeniler, isterseniz yerinde morph da eder. elagoht/live

collage.NewPage("search").
  	WithLayouts(layout).
  	WithContent(searchPage).
  	WithPath("en", "/search").
  	WithFragmentPath("en", "/search/results", results).
  	Build()
input.addEventListener("input", async () => {
    const res = await fetch("/search/results?q=" + encodeURIComponent(input.value));
    document.querySelector("#results").outerHTML = await res.text();
  });

Layout'lar ve slot'lar

Layout, page'in içeriği için bir slot bırakır. Bir fragment da kendi slot'larını bırakabilir. Slot'ları fragment'lerle doldurun, collage page'i birleştirir.

Neye bağlıysa ona göre cache'lenir

Her page ve cache'lenen her değer, neyden oluştuysa onun tag'lerini taşır: post:hello, author:ada. InvalidateTags, bir tag'i kullanan page'leri stale olarak işaretler ve arka planda yeniden render eder, bu sırada eski page'i fallback olarak saklar. PurgeTags ise onları doğrudan siler; bu, bir daha asla gösterilmemesi gereken içerik içindir. Geri kalan her şey cache'te kalır.

app.InvalidateTags(ctx, "author:ada")
  app.PurgeTags(ctx, "user:42")

Tag ile invalidate edin

Bir page neyden oluştuğunu hatırlar. Bir tag'i invalidate edin, yalnızca onu kullanan page'ler yeniden render edilir; geri kalanı olduğu gibi kalır.

İstediğiniz kadar middleware ve plugin

Bir framework size tek bir middleware dosyası verip bir request'in ihtiyaç duyduğu her şeyi onun içinde elle zincirletiyorsa, collage'da app.Use'u istediğiniz kadar çağırabilirsiniz; her çağrı herhangi bir func(http.Handler) http.Handler alır. Her plugin de kendi middleware'ini getirir ve bunlar plugin'leri listelediğiniz sırayla çalışır. Çekirdek küçük kalır: session, spam koruması, canlı güncelleme, SEO ve metrikler plugin'dir. Kırk beş plugin yayımlanmış durumda. Kendi plugin'iniz ise ihtiyaç duyduğu hook'lara sahip bir Go tipidir.

app, err := collage.New(&collage.Config{
  	Plugins: []collage.Plugin{
  		session.New(session.Options{KeyEnv: "SESSION_KEY"}),
  		honeypot.New(honeypot.Options{KeyEnv: "HONEYPOT_KEY"}),
  		client.New(),
  		live.New(live.Options{}),
  	},
  })

  app.Use(requestID)
  app.Use(auditLog)

Hâlâ Go yazıyorsunuz

İkinci bir dil de ikinci bir process de yok. Veri katmanınız Go kodunuzdur: veritabanı, kuyruk, dış API. Elinizdeki bir API'yi ya da servisi app.Handle ile collage'ın kendi mux'ına mount edersiniz. Page'lerin yanında, aynı middleware'lerin arkasında çalışır. Tek proje, tek binary.

api := http.NewServeMux()
  api.HandleFunc("GET /api/users/{id}", users.Get)
  api.HandleFunc("POST /api/users", users.Create)

  app.Handle("/api/", api)

Siteler ve web uygulamaları için küçük bir çekirdek

collage batteries-included değildir ve size neyi bıraktığını açıkça söyler. Sahip oldukları, sunucuda render edilen bir front end'in ihtiyaç duyduklarıdır. Bu yüzden çok kullanıcılı, rol bazlı bir web uygulaması da bir landing page kadar rahat yazılır: session'lar ve roller, sahtesi üretilemeyen form'lar, spam koruması, page'in canlı güncellenen kısımları.

Çekirdekte

  • Fragment'ler ve fragment path'leri
  • Forgery korumalı action'lar
  • Cache, tag'ler, invalidate ve purge
  • Private page'ler ve roller için guard'lar
  • Locale URL'leri ve adla link'ler
  • Static export

Bir plugin ile

  • Session'lar
  • Honeypot ve validation
  • Flash mesajları
  • SSE ya da WebSocket üzerinden canlı fragment'ler
  • OAuth, basic auth, rate limit'ler

Dahil değil

  • Backend: iş kuralları ve servisler sizin Go kodunuzdur
  • ORM
  • Migration'lar
  • Veritabanı katmanı: o sizin Go kodunuz

Nasıl çalışır

Aynı anda çekin

Her fragment'in kendi data handler'ı vardır. Kardeş fragment'ler verilerini aynı anda çeker, HTML yine de sırasıyla yazılır.

Fragment'leri canlı stream edin

collage-live ile bir tag'i invalidate etmek, onu kullanan ve açık olan her fragment'i yeniden render eder ve tek bir stream üzerinden tarayıcıya gönderir. Yalnızca o kısım değişir. Örneğin burada, sunucunun CPU kullanımı.

Kaydedin ve görün

collage dev, bir template değiştiğinde tarayıcıyı yeniler, Go kodu değiştiğinde yeniden build eder. Başarısız bir render, dosyasını ve satırını tarayıcıda gösterir.

Build edin, export edin, serve edin

collage build, her işletim sistemi ve mimari için sitenin sunucusunun tamamı olan tek bir static binary üretir. collage export siteyi static dosyalar olarak yazar, collage serve de onları bir static host gibi serve eder.

Rehber