Ellipses

Static code reusing tool (WARNING: This software is a pre-release that is still in development)

Statik olarak yeniden kod kullanımı için bir araç (UYARI: Bu yazılım, geliştirmesi halen devam eden bir ön sürümdür)

Proje ayrıntıları için Geliştirme dokümanlarına göz atabilirsiniz.

Kurulum

Yayınlanan Gem paketini kurmanız yeterlidir.

gem install ellipses

Kullanım

• Eklenecek kodları SRCPATH ortam değişkeniyle anons edilen dizin ağacında topla. Bu dizinlere "sunucu" ("server") dizinleri diyoruz. Sunucu dizinlerin «provider»/«owner»/«repo» düzeninde olması tavsiye edilir. Örneğin SRCPATH=/usr/local/src ise tüketilecek kabuk kaynaklarını /usr/local/src/github.com/roktas/sh dizininde toplayabilirsin.

  export SRCPATH=/usr/local/src

• Sunucu dizin kökünde servis edilecek sembolleri bildiren bir src.toml dosyası oluştur. Örnekteki dizin için /usr/local/src/github.com/roktas/sh/src.toml dosyası aşağıdaki örnek içerikte olsun.

  depends = [
        "z"
  ]
  
  [[symbols]]
        symbol  = "a"
        depends = [
                "b",
                "c"
        ]
  
  [[symbols]]
        symbol = "b"
  
  [[symbols]]
        symbol = "c"
  
  [[symbols]]
        symbol = "z"

  Bu yapılandırmada z sembolü bağımlılık olarak tüm sembollere eklenirken, örneğin a sembolü buna ilave olarak b ve c sembollerini çekecektir. Sonuç olarak sunucudan a sembolü istendiğinde bağımlılık olarak sırasıyla z, b, c sembolleri ve sonrasında sembolün kendisi için a sembolü çekilecektir.

  Her sembol sunucu dizinde aynı isimde bir dosyaya karşılık gelir. "Yaprak" niteliğinde sembollerde sembol ile aynı isimde dosyanın varlığı zorunlu, diğerlerinde ise zorunlu değildir. Dolayısıyla yukarıdaki örnekte a sembolü için sırasıyla z, b, c ve (sembolün kendisi için) a dosyalarının içerikleri eklenecektir.

• Sunucudan sembol isteğinde bulun. Sembolleri tüketecek dosyalara "istemci" ("client") dosyalar diyoruz. Aşağıda örneklenen test.sh isimli istemci dosyada başlangıçta ... söz dizimiyle github.com/roktas/sh isimli sunucudan a sembolü istenmektedir. Bu satıra "direktif" satırı diyoruz.

  if true; then
        ... github.com/roktas/sh a
  fi

• Eklemenin yapılması için öncelikle istemci tarafı ilkle.

  src init

  Bu işlem sonucunda bulunulan dizinde src.json adında boş bir dosya oluşacaktır.

• İstemci dosyayı derle ("compile")

  src compile test.sh

  Bu işlemin sonucunda, örneğin a, b, c, ve z dosyaları basitçe aynı harfte tek satırlık içeriklerden oluşuyorsa test.sh dosyası aşağıdaki içerikte olacaktır.

  if true; then
        z
  
        b
  
        c
  
        a
  fi

  Derleme sırasında ... github.com/roktas/sh a direktifinin başındaki sekme karakterinin eklenen tüm satırların başına ön ek olarak geldiğini not edin. Her derleme işleminde src.json dosyası güncellenerek yapılan ekleme kaydedilmektedir.

• Herhangi bir anda sunucu tarafta bir değişiklik olmuşsa bu değişikliği update komutuyla al

  src update

  Bu komut tüm istemci dosyaları güncellediğinden dosya argümanı gerekmemektedir. Örneğin b dosyasının içeriği B olarak değiştirilmişse test.sh dosyasının içeriği aşağıdaki gibi olacaktır.

  if true; then
        z
  
        B
  
        c
  
        a
  fi

• Derlenen bir dosyayı eski haline getirmek için decompile komutunu uygula

  src decompile test.sh

  Komut sonucunda test.sh dosyasının içeriği (dosyada başka bir düzenleme yapılmadığı varsayımıyla) aşağıdaki gibi olacaktır.

  if true; then
        ... github.com/roktas/sh a
  fi

  Önceden uygulanan eklemelerin içeriğine müdahale edilmediği sürece test.sh dosyasında yapılan tüm değişiklikler korunmaktadır.