BATsh Hızlı Başvuru [TR] Türkçe
===============================

----------------------------------------------------------------------
ÖZET
  BATsh, cmd.exe batch ve bash/sh sözdizimini aynı betik dosyasında
  çalıştıran iki dilli bir kabuktur. Modu satır/bölüm bazında otomatik
  olarak değiştirir.
  Harici kabuk gerekmez -- saf Perl uygulaması.
  İşlem hatlarını, yönlendirmeyi, işlevleri ve değişken-genişletme
  uzantılarını destekler.

KARMA MOD ÖRNEĞİ
  :: CMD bölümü (ilk belirteç büyük harf)
  @ECHO OFF
  SET LANG=BATsh
  SET COUNT=3

  # SH bölümü (ilk belirteç küçük harf)
  greet() { echo "Hello from $1 (bash mode)"; }
  greet $LANG
  for i in 1 2 3; do echo "  item $i of $COUNT"; done
  result=$(echo $LANG | perl -ne "print uc")
  echo "Uppercase: $result"

  :: yeniden CMD bölümü (SH sonucunu köprü aracılığıyla okur)
  ECHO Back in CMD: %result%

  # Şununla çalıştırın: perl lib/BATsh.pm script.batsh
  # Ya da:             use BATsh; BATsh->run('script.batsh');
----------------------------------------------------------------------


BATsh, cmd.exe ve bash/sh sözdizimini aynı betikte çalıştıran iki dilli bir
kabuktur.  Betik bölümlere ayrılır; her bölüm uygun kabuk tarafından olduğu
gibi çalıştırılır.

1. Mod Algılama
---------------
  Bir bölümün ilk anlamlı satırının İLK BELİRTECİ, o bölümü hangi kabuğun
  çalıştıracağını belirler:

  CMD modu: ilk belirteç tamamen [A-Z 0-9 _ - \ / : . @ %] karakterlerinden
            oluşur VE en az bir büyük harf A-Z içerir.

    ECHO hello          -> CMD bölümü (cmd.exe)
    SET FOO=bar baz     -> CMD bölümü  (değer kısmı sınanmaz)
    @ECHO OFF           -> CMD bölümü
    IF "%X%"=="Y" (     -> CMD bölümü

  SH modu: bunun dışındaki her şey (herhangi bir küçük harf ya da hiç harf yok).

    echo hello          -> SH bölümü  (bash/sh)
    export FOO=bar      -> SH bölümü
    if [ -f "$f" ]; then  -> SH bölümü
    #!/bin/sh           -> SH bölümü  (shebang bir SH satırıdır)

  Yorumlar ve boş satırlar geçerli bölüme dahil edilir.
  Yorum sözdizimi:
    ::           CMD tarzı yorum
    REM ...      CMD tarzı yorum (büyük/küçük harf duyarsız)
    @REM ...     CMD tarzı yorum
    # ...        SH tarzı yorum  (#! shebang DEĞİL)

2. Kabuğu Başlatma
------------------
  perl lib/BATsh.pm               # etkileşimli REPL
  perl lib/BATsh.pm script.batsh  # bir betik dosyasını çalıştır
  perl lib/BATsh.pm -e "echo hi"  # satır içi tek satırlık komut

  Perl'den:
    use BATsh;
    BATsh->run('script.batsh');
    BATsh->run_string("echo hello");
    BATsh->repl();

3. Ortam Değişkeni Köprüsü
--------------------------
  Her bölüm çalışmadan önce BATsh, geçerli %ENV değerini önbilgi olarak
  enjekte eder (CMD için SET satırları, SH için export satırları).  Bölümden
  sonra kabuğun son ortamı %ENV içine geri okunur.

  export FOO=hello   # SH, FOO değerini ayarlar
  ECHO %FOO%         # CMD, FOO değerini köprü aracılığıyla okur (Windows)

  SET BAR=world      # CMD, BAR değerini ayarlar
  echo $BAR          # SH, BAR değerini köprü aracılığıyla okur

4. SETLOCAL / ENDLOCAL
----------------------
  SETLOCAL           # %ENV anlık görüntüsü (cmd.exe değil, BATsh yönetir)
  SET TMP=local_val
  ECHO %TMP%
  ENDLOCAL           # %ENV geri yüklenir (TMP kaybolur)

  Kapsamlar iç içe olabilir.

5. Bölüm Sınırı Algılama
------------------------
  Bir bölüm, blok derinliği sıfıra döndüğünde VE bir sonraki anlamlı satır
  farklı bir moda ait olduğunda sona erer.

  CMD bölümleri tırnaksız ( ve ) derinliğini izler:

    IF "%X%"=="Y" (     <- blok açar (derinlik 1)
        ECHO yes
    ) ELSE (            <- kapatır ve yeniden açar (derinlik >=1 kalır)
        ECHO no
    )                   <- bloğu kapatır (derinlik 0) -> bölüm bitebilir

  SH bölümleri anahtar sözcük derinliğini izler:

    for x in 1 2; do   <- blok açar (derinlik 1)
        echo $x
    done                <- bloğu kapatır (derinlik 0) -> bölüm bitebilir

  Açık bir blok içindeki satırlar, ilk belirteçleri diğer mod gibi görünse
  bile geçerli bölüme dahil edilir. Bu şunu mümkün kılar:

    for x in A B; do
        ECHO $x          <- SH bloğu içinde büyük harf: yine de SH bölümü
    done

  SH anahtar sözcük çiftleri:
    Açıcılar (+1) : if  for  while  until  case  function  select  {
    Kapatıcılar (-1) : fi  done  esac  }
    Nötr     ( 0) : then  do  else  elif

6. Alt Yordam Tanımları
-----------------------
  :GREET
  echo "Hello $BATSH_ARG1"
  RET

  Etiketler : ile başlar ve RET ya da RETURN ile biter.
  Gövde, çalıştırmadan önce ayıklanır (satır içinde çalıştırılmaz).
  Gövde CMD satırları, SH satırları veya bir karışım içerebilir.

7. CALL ve source
-----------------
  CALL :GREET world      # alt yordamı bağımsız değişkenle çağır
  CALL other.batsh       # başka bir .batsh dosyasını dahil et/çalıştır (CMD)
  source other.batsh     # başka bir .batsh dosyasını dahil et/çalıştır (SH)
  . other.batsh          # POSIX nokta gösterimi

  Bağımsız değişkenler: $BATSH_ARG1 .. $BATSH_ARGn  (CMD'de %BATSH_ARG1%)
  Sayı:                 $BATSH_ARGC

8. Perl API
-----------
  BATsh->run($file)            # bir .batsh dosyasını çalıştır
  BATsh->run_string($source)   # kaynak dizesini çalıştır
  BATsh->run_lines(@lines)     # satır dizisini çalıştır
  BATsh->repl()                # etkileşimli REPL
  BATsh->classify_token($tok)  # 'CMD' veya 'SH'
  BATsh->setlocal()            # %ENV anlık görüntüsü
  BATsh->endlocal()            # %ENV geri yükle
  BATsh->call_sub($lbl, @args) # alt yordamı çağır
  BATsh->source_file($file)    # .batsh dosyasını dahil et
  BATsh->version()             # sürüm dizesi

9. Platform Notları
-------------------
  Windows: Hem CMD hem SH bölümleri saf Perl ile çalışır -- harici cmd.exe, bash veya sh gerekmez.
  UNIX:    Hem CMD hem SH bölümleri saf Perl ile çalışır -- harici cmd.exe, bash veya sh gerekmez.

10. Gereksinimler
-----------------
  Perl 5.005_03 veya üzeri.  Yalnızca çekirdek modüller (File::Spec, Carp).
  CPAN bağımlılığı yok.

11. CMD İşlem Hattı ve Parametre Değiştiricileri
------------------------------------------------
  cmd1 | cmd2              # geçici dosya aracılığıyla işlem hattı (Saf Perl)
  ECHO hello | perl -e "while(<STDIN>){print uc}"

  SET /P VAR=Prompt:       # STDIN'den bir satır okuyup VAR'a yazar

  Batch parametresi tilde değiştiricileri (örn. %0=C:\scripts\deploy.bat iken):
    %~0   -> C:\scripts\deploy.bat  (yalnızca tırnak kaldırma)
    %~f0  -> C:/scripts/deploy.bat  (tam mutlak yol)
    %~d0  -> C:                     (sürücü harfi)
    %~p0  -> /scripts/              (dizin yolu)
    %~n0  -> deploy                 (uzantısız dosya adı)
    %~x0  -> .bat                   (uzantı)
    %~dp0 -> C:/scripts/            (sürücü + dizin, en yaygın)
    %~nx1 -> deploy.bat             (ad + uzantı)

12. SH İşlevleri ve Genişletme
------------------------------
  greet() {              # işlev tanımı
      echo "Hi $1"
  }
  function add {         # alternatif sözdizimi
      echo $(( $1 + $2 ))
  }
  greet world            # işlevi çağır
  add 3 4                # -> 7

  ${var%.*}    .* ile eşleşen en kısa soneki kaldır
  ${var%%.*}   .* ile eşleşen en uzun  soneki kaldır
  ${var#*.}    *. ile eşleşen en kısa öneki kaldır
  ${var##*.}   *. ile eşleşen en uzun  öneki kaldır
  ${var/a/b}   a'nın ilk geçişini b ile değiştir
  ${var//a/b}  a'nın tüm geçişlerini b ile değiştir
  ${var^^}     tümünü büyük harf
  ${var,,}     tümünü küçük harf
  ${var:2:4}   2. konumdan başlayarak 4 uzunlukta alt dize
  ${#var}      dize uzunluğu
  ${var:-def}  ayarlıysa değeri, değilse def

13. SH G/Ç Yönlendirme
----------------------
  cmd > file      stdout üzerine yaz
  cmd >> file     stdout sonuna ekle
  cmd < file      stdin dosyadan
  cmd 2> file     stderr dosyaya
  cmd 2>&1        stderr'i stdout'a birleştir
  cmd > f 2>&1    hem stdout hem stderr dosyaya

  Here-document (stdin üzerinde girdi):
    cmd <<EOF       EOF'a kadar gövde satırları; $VAR genişletilir
    cmd <<'EOF'     EOF'a kadar gövde satırları; genişletme yok (düz metin)
    cmd <<-EOF      <<EOF gibi, ama satır başındaki TAB karakterleri atılır

14. SH Bileşik Komutlar
-----------------------
  cmd1 && cmd2    cmd2'yi yalnızca cmd1 başarılıysa çalıştır
  cmd1 || cmd2    cmd2'yi yalnızca cmd1 başarısızsa çalıştır
  cmd1 ; cmd2     cmd2'yi koşulsuz çalıştır

15. SH Diziler
--------------
  arr=(a b c)            # indeksli dizi sabiti
  arr+=(d e)             # öğe ekle
  arr[5]=x               # indekse göre ata
  declare -a list        # indeksli dizi tanımla
  declare -A map         # ilişkisel dizi tanımla
  map[key]=value         # ilişkisel atama
  map=([k1]=v1 [k2]=v2)  # ilişkisel sabit

  ${arr[0]}    0. öğe  ($arr, ${arr[0]} ile aynı)
  ${arr[-1]}   son öğe
  ${arr[@]}    tüm öğeler (sözcüklere ayrılır)
  ${arr[*]}    tüm öğeler (tek sözcük)
  ${#arr[@]}   öğe sayısı
  ${#arr[2]}   2. öğenin uzunluğu
  ${!arr[@]}   indeks (veya anahtar) listesi
  unset arr[1] # bir öğeyi sil
  unset arr    # tüm diziyi sil

16. SH case Deyimleri
---------------------
  case $x in
      a|b|c)      echo "a, b veya c" ;;    # |  -- birden çok desen
      [0-9])      echo "bir rakam"   ;;    # [..]  karakter sınıfı
      [!aeiou])   echo "ünsüz"       ;;    # [!..] olumsuz sınıf
      data*)      echo "önek"        ;;    # *  ve  ?  joker
      "*")        echo "yıldız"      ;;    # tırnaklı = birebir eşleşme
      *)          echo "varsayılan"  ;;    # *)  varsayılan dal
  esac

  Dal sonlandırıcıları (her gövdeden sonra):
    ;;    burada dur (normal durum)
    ;&    sonraki dal gövdesini de çalıştır
    ;;&   kalan desenleri sınamayı sürdür

17. SH trap ve Sinyaller
------------------------
  trap 'echo bye' EXIT       # betik bitince (veya exit'te) çalışır
  trap 'rm -f $tmp' EXIT     # işleyici tetiklenince açılır
  trap 'echo got INT' INT    # gerçek sinyali %SIG ile köprüle
  trap '' INT                # sinyali yok say
  trap - INT                 # varsayılan eylemi geri yükle
  trap                       # geçerli trap'leri listele (ayrıca: trap -p)

  SIGSPEC: ad (INT veya SIGINT), numara (2) ya da EXIT (= 0).
  EXIT sonda bir kez çalışır; gerçek adlar Perl %SIG işleyicileri kurar.

Ayrıca bakınız: https://metacpan.org/dist/BATsh
