Komutlar

Her fiil collie <verb> biçimini kullanır. Bu, doğrudan ikili dosyada (cli/) uygulanan ve tüm kurulumlarda geçerli olan kurallı sözdizimidir. collie dizinini PATH değişkeninize eklemeden önce (aşağıda), depo kökünden bin/collie <verb> çalıştırın. Herdr tarafından yönetilen bir kurulumda bu fiiller, aynı davranışla Herdr eylemleri (aşağıda) olarak kaydedilir.

Ana makinede birden fazla örnek çalışıyorsa her fiilin başına COLLIE_INSTANCE=<name> ekleyin. Bkz. Tek bir konakta birden fazla Collie örneği.

CLI ayrıca daha seyrek gerçekleştirilen görevler için build, serve, unserve, doctor ve crew … komutlarını da içerir.

Hem start hem de status, Collie çalışıyor başlığını çıktılar: bir durum işareti ve sürüm, ardından bir service, bir local ve bir tailnet satırı. İlk çalıştırma, başarısız bir durum denetiminde ne yazdırıldığı dahil olmak üzere başlığı tam olarak gösterir. Bildirilen sürüm, sunulan paket damgasından okunur ve etkin derlemeyi yansıtır.

Ink veya düz metin. stdout bir TTY olduğunda start, status, doctor, crew add ve crew status komutları etkileşimli bir terminal arayüzü sunar. --plain parametresini geçirmek veya çıktıyı bir boruya, dosyaya, systemd günlüğüne ya da CI çalıştırıcısına yönlendirmek ham satır çıktısına geri döner.

collie doctor hangi durumu okuduğunu belirtir. İlk satırı örneği (default veya COLLIE_INSTANCE içindeki adı) ve okuduğu durum dizinini belirtir. Bir makinede iki şerit çalıştırıyorsanız, geri kalanına güvenmeden önce bu satırı kontrol edin; çünkü yanlış COLLIE_INSTANCE değerine sahip bir kabuk yanlış şeridi okur. --json, collie girdisinde instance ve stateDir ile aynı iki değeri verir.

collie doctor aracı programlarınızı listeler. Collie'nin giriş profiline sahip olduğu her program bir harness-<name> satırı alır: Collie'nin oturum açma kabuğunuzun PATH üzerinde çalıştıracağı dosya, yazdırdığı sürüm ve profilin bu sürüm hakkındaki kararı. Doğrulanmış aralığın üzerindeki bir sürüm yalnızca bir nottur, çünkü bir turdaki gönderimlere yine de güvenilir. Satır, dosya çözümlendiğinde ancak sürümü okunamadığında uyarır; örneğin PATH üzerinde ilk sırada yer alan ve $HOME gerektiren bir sarmalayıcı veya bozuk bir kurulum: sürüm okunana kadar Collie bu programa yapılan her göndermeyi geçici olarak ele alır. Yüklü olmayan bir program not installed gösterir. --json içinde her satır ayrıca harness, binary, version ve profileStatus taşır.

Satır, PATH üzerindeki kopyayı adlandırır, çünkü collie doctor bakacak bir bölmeye sahip değildir. Herdr üzerindeki bir gönderme, kendi bölmesinde çalışan programa sorar; bu nedenle tam yolu ile başlatılan veya bir projede yüklü olan başka bir kopyayı çalıştıran bir bölme, makbuzlarında o kopyanın sürümünü gösterir.

collie dizinini PATH ortam değişkeninize ekleyin

~/.local/bin/collie ögesini yayınlamak için collie link komutunu çalıştırın:

bin/collie link          # ~/.local/bin/collie → <checkout>/bin/collie
collie status            # from anywhere
bin/collie unlink        # take the name back down

Bir çalışma kopyasının ikili dosyasına sembolik bağ oluşturur; böylece gelecekteki collie build güncellemeleri ek bir adıma gerek kalmadan hemen geçerli olur (ADR 0021). Komut, diğer Collie çalışma kopyalarından kalan mevcut bağlantıların yerine geçer ve hangisinin üzerine yazdığını bildirir. Bu yoldaki Collie dışı dosyaların üzerine yazmayı reddeder. unlink, sembolik bağı yalnızca sizin geçerli çalışma kopyasını hedefliyorsa kaldırır.

~/.local/bin dizini PATH içinde yoksa link sizi uyarır ve çıkar. Kabuk profilinizi asla düzenlemez. path-link satırını denetlemek ve yalın collie komutunun hangi çalışma kopyasına çözümlendiğini görmek için collie doctor komutunu çalıştırın.

Herdr eylemleri

herdr plugin install AltanS/collie veya herdr plugin link ile oluşturulmuş Yalnızca Herdr tarafından yönetilen bir kurulum için geçerlidir. Herdr, Collie tarafından desteklenen beş çoğullayıcıdan biridir. Bu eylemler doğrudan bağdaştırıcıyla eşleşir: her eylem fiili yukarıdaki tabloda belgelenen aynı collie ikili dosyasına iletir. scripts/install.sh üzerinden oluşturulan ikili yüklemelerde eklenti eylemleri mevcut değildir ve geçerli tek sözdizimi collie <verb> olur.

Collie bu eylemleri herdr-plugin.toml içine kaydeder. Bunları herdr plugin action invoke <id> --plugin herdr.collie ile çağırın veya herdr plugin action list --plugin herdr.collie ile görüntüleyin:

qr, pair, devices, link, logs, stt ve config komutlarının karşılık gelen bir eklenti eylemi yoktur; çünkü bir terminal, konumsal bağımsız değişkenler veya her ikisini birden gerektirirler. Bunları collie <verb> olarak çalıştırın.

Herdr eylemleri, terminal başlığı yerine Herdr'ın JSON zarfını döndürür. Eylemin yakalanan stdout çıktısını herdr plugin log list --plugin herdr.collie ile görüntüleyin veya çıktıyı doğrudan satır içinde yazdırmak için collie <verb> komutunu çalıştırın. herdr plugin list --json çıktısı, etkin sürümü değil, plugin link sırasında önbelleğe alınan sürümü yansıtır. Bağlantılı klonlar için update, önbelleği düzeltmek amacıyla otomatik olarak yeniden bağlar. Bunu herdr plugin link "$(pwd)" ile zorlayabilirsiniz. Herdr ≥0.8.0, bildirimi her çağrıda diskten yeniden okur.

Not. scripts/collie-ctl.sh <verb> desteklenmeye devam eder. Bir önyükleme dolgusu (bootstrap shim) olarak çalışır: Bun'ı bulur, depoda yoksa bin/collie derler ve argv değerini iletir. Yeni bağlanmış bir klon, ilk ikili dosyasını derlemek için bu yolu kullanır. Herdr eylemleri bu betiğe işaret etmeyi sürdürür; çünkü Herdr <0.8.0, yükleme sırasında önbelleğe alınan eylem tanımlarını dondurur (ADR 0006). Her eylem fiili, cli/ içindeki derlenmiş ikili dosya içinde bir kez uygulanır.