# Yöntem 1: 'function' anahtar kelimesi olmadan, en sık kullanılan ve daha kısa yöntemdir.
# Bir fonksiyonu tanımlarken parantezlerin boş olması, argüman almadığı anlamına gelmez.
# Argümanlar yine $1, $2 şeklinde erişilir.
mesaj_goster() {
    echo "Merhaba, bu bir Bash fonksiyonudur!"
}

# Yöntem 2: 'function' anahtar kelimesini kullanarak.
# Bazı kabuklarda (örneğin zsh) 'function' anahtar kelimesi olmadan fonksiyon tanımlamanıza
# izin verilmezken, Bash bu konuda daha esnektir.
function sistem_bilgisi_al {
    echo "Sistem bilgileri alınıyor..."
    uptime
    df -h /
}

mesaj_goster # İlk tanımladığımız fonksiyonu çağırıyoruz
sistem_bilgisi_al # İkinci fonksiyonu çağırıyoruz

toplama_yap() {
    local sayi1=$1 # İlk argümanı yerel değişkene atıyoruz
    local sayi2=$2 # İkinci argümanı yerel değişkene atıyoruz
    local toplam=$(( sayi1 + sayi2 ))
    echo "Verilen sayıların toplamı: $toplam"
}

toplama_yap 10 20    # Çıktı: Verilen sayıların toplamı: 30
toplama_yap 50 100   # Çıktı: Verilen sayıların toplamı: 150

# Daha karmaşık bir örnek: Dosya işlemlerini simüle eden bir fonksiyon
dosya_islem_simulasyonu() {
    local islem_tipi="$1"
    local dosya_adi="$2"

    if [ -z "$islem_tipi" ] || [ -z "$dosya_adi" ]; then
        echo "[HATA] İşlem tipi ve dosya adı belirtmelisiniz." >&2
        return 1 # Hata kodu döndür
    fi

    echo "[$islem_tipi] işlemi '$dosya_adi' üzerinde yapılıyor..."
    sleep 1 # İşlem yapılıyormuş gibi bekle
    echo "[$islem_tipi] işlemi '$dosya_adi' tamamlandı."
    return 0
}

dosya_islem_simulasyonu "oku" "rapor.log"
dosya_islem_simulasyonu "sil" "gecici.tmp"
dosya_islem_simulasyonu # Hata mesajı verecek

arguman_detaylari_goster() {
    echo "Fonksiyon Adı: ${FUNCNAME[0]}" # Fonksiyonun kendi adını verir
    echo "Argüman Sayısı (\$#): $#"
    echo "Tüm Argümanlar (\"$@\"): "
    for arg in "$@"; do
        echo "  - '$arg'"
    done
    echo "Tüm Argümanlar (\"$*\"): '$*'"
    echo "İlk Argüman (\$1): '$1'"
    echo "İkinci Argüman (\$2): '$2'"
}

arguman_detaylari_goster "elma" "armut suyu" "üzüm"
echo "-------------------------------------"
arguman_detaylari_goster "tek argüman"

# Çıkış durumu (exit status) döndürme örneği
kontrol_et() {
    local sayi=$1
    if [ "$sayi" -ge 10 ]; then
        echo "Sayı 10 veya daha büyük."
        return 0 # Başarılı
    else
        echo "Sayı 10'dan küçük."
        return 1 # Başarısız
    fi
}

kontrol_et 12
if [ $? -eq 0 ]; then
    echo "Kontrol başarılıydı."
else
    echo "Kontrol başarısız oldu."
fi

kontrol_et 5
if [ $? -eq 0 ]; then
    echo "Kontrol başarılıydı."
else
    echo "Kontrol başarısız oldu."
fi

# Değer döndürme (standart çıktıya yazdırma - echo kullanarak) örneği
dosya_boyutu_al() {
    local dosya="$1"
    if [ -f "$dosya" ]; then
        stat -c%s "$dosya" # Dosyanın boyutunu echo ile yazdır
        return 0
    else
        echo "0" # Dosya yoksa 0 döndür
        return 1
    fi
}

# Geçici bir dosya oluşturalım
echo "Merhaba Dünya!" > test_dosya.txt

boyut=$(dosya_boyutu_al "test_dosya.txt")
if [ $? -eq 0 ]; then
    echo "test_dosya.txt boyutu: $boyut byte"
else
    echo "Hata: dosya bulunamadı veya boyutu alınamadı."
fi

rm test_dosya.txt # Geçici dosyayı silelim

# Global değişken
global_mesaj="Ben başlangıçta globalim"

ornek_fonksiyon_kapsam() {
    local fonksiyon_ici_degisken="Bu sadece fonksiyon içinde var"
    global_mesaj="Fonksiyon tarafından değiştirilen global mesaj" # Global değişkeni değiştiriyoruz
    echo "Fonksiyon içinde: global_mesaj = '$global_mesaj'"
    echo "Fonksiyon içinde: fonksiyon_ici_degisken = '$fonksiyon_ici_degisken'"
}

echo "Fonksiyon çağrılmadan önce: global_mesaj = '$global_mesaj'"
# echo "Fonksiyon çağrılmadan önce: fonksiyon_ici_degisken = '$fonksiyon_ici_degisken'" # Hata verir: Tanımsız

ornek_fonksiyon_kapsam

echo "Fonksiyon çağrıldıktan sonra: global_mesaj = '$global_mesaj'" # Değişiklik kalıcı oldu
# echo "Fonksiyon çağrıldıktan sonra: fonksiyon_ici_degisken = '$fonksiyon_ici_degisken'" # Hata verir: Tanımsız

# --- lib/log_functions.sh ---
#!/bin/bash
# log_functions.sh: Günlük kaydı ile ilgili yardımcı fonksiyonlar içerir.

log_info() {
    echo "[INFO] $(date +'%Y-%m-%d %H:%M:%S') - $@"
}

log_warn() {
    echo "[UYARI] $(date +'%Y-%m-%d %H:%M:%S') - $@" >&2
}

log_error() {
    echo "[HATA] $(date +'%Y-%m-%d %H:%M:%S') - $@" >&2
    return 1 # Hata durumunda 1 döndür
}

# --- lib/validation_functions.sh ---
#!/bin/bash
# validation_functions.sh: Giriş verilerini doğrulamak için fonksiyonlar içerir.

is_valid_email() {
    local email="$1"
    # Basit bir e-posta regex kontrolü
    [[ "$email" =~ ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}$ ]]
    return $? # Regex sonucunu döndür (0 ise eşleşti)
}

is_positive_number() {
    local num="$1"
    [[ "$num" =~ ^[0-9]+$ ]] && [ "$num" -gt 0 ]
    return $?
}

# --- main_script.sh ---
#!/bin/bash
# main_script.sh: Ana uygulama mantığını içerir.

# Kütüphane dosyalarını kaynak olarak ekleme
# 'source' veya '.' (nokta) kullanılabilir. Tercih edilen genellikle 'source' kelimesi daha okunabilir olduğu için.
source "./lib/log_functions.sh"
. "./lib/validation_functions.sh" # '.' operatörü de aynı işi yapar

log_info "Betik başlatılıyor. Argümanlar: $@"

# Komut satırı argümanlarını kontrol edelim
if [ "$#" -lt 2 ]; then
    log_error "Kullanım: $0 <e-posta> <sayı>"
    exit 1
fi

KULLANICI_EMAIL="$1"
GIRIS_SAYI="$2"

if is_valid_email "$KULLANICI_EMAIL"; then
    log_info "Girilen e-posta adresi geçerli: $KULLANICI_EMAIL"
else
    log_error "Geçersiz e-posta formatı: $KULLANICI_EMAIL"
    exit 1
fi

if is_positive_number "$GIRIS_SAYI"; then
    log_info "Girilen sayı geçerli ve pozitif: $GIRIS_SAYI"
else
    log_error "Geçersiz veya pozitif olmayan sayı: $GIRIS_SAYI"
    exit 1
fi

log_info "Tüm doğrulamalar başarılı. Uygulama mantığı devam ediyor..."
# ... ana uygulama mantığı ...
log_info "Betik başarıyla tamamlandı."

/my_project/
├── main.sh             # Ana betik: Uygulamanın ana giriş noktası, iş akışını yönetir.
├── config/             # Yapılandırma dosyaları
│   └── app_config.sh   # Uygulama genelindeki yapılandırma değişkenleri.
├── lib/                # Kütüphane fonksiyonları ve modüller
│   ├── common.sh       # Genel yardımcı fonksiyonlar (dosya işlemleri, string manipülasyonu vb.)
│   ├── log.sh          # Günlük kaydı ile ilgili fonksiyonlar.
│   ├── network.sh      # Ağ işlemleriyle ilgili fonksiyonlar (curl, ping vb.).
│   ├── validation.sh   # Kullanıcı girdisi doğrulama fonksiyonları.
│   └── database.sh     # Veritabanı etkileşimleri için fonksiyonlar (eğer varsa).
├── scripts/            # Diğer yardımcı betikler veya tek seferlik görevler
│   ├── setup.sh
│   └── cleanup.sh
├── tests/              # Birim testleri veya entegrasyon testleri (isteğe bağlı).
├── docs/               # Proje dokümantasyonu (README, kullanım kılavuzları vb.).
└── data/               # Geçici veya kalıcı veri depolama alanı.

#
# get_config_value()
#
# Betik yapılandırma dosyasından belirtilen anahtarın değerini çeker.
#
# Argümanlar:
#   $1 - Ayar anahtarı (örn: "VERITABANI_ADI"). Gerekli.
#
# Çıkış:
#   Eğer anahtar bulunursa değeri standart çıktıya (stdout) yazdırır.
#   Aksi takdirde boş bir satır yazdırır.
#
# Dönüş Kodu:
#   0 - Anahtar bulundu ve değeri yazdırıldı.
#   1 - Anahtar bulunamadı veya 'config.sh' dosyasına erişilemedi.
#
# Kullanım Örneği:
#   DB_HOST=$(get_config_value "DB_HOST")
#   if [ $? -ne 0 ]; then
#       echo "DB_HOST yapılandırma değeri bulunamadı." >&2
#       exit 1
#   fi
#
get_config_value() {
    local key="$1"
    local config_file="./config/app_config.sh"

    if [ -z "$key" ]; then
        log_error "get_config_value(): Ayar anahtarı belirtilmedi."
        echo ""
        return 1
    fi

    if [ ! -f "$config_file" ]; then
        log_error "get_config_value(): Yapılandırma dosyası bulunamadı: $config_file"
        echo ""
        return 1
    }

    # Yapılandırma dosyasını kaynak olarak ekleyip değişkeni okumak daha doğru olabilir.
    # Ancak, bu örnekte basitlik adına grep kullanıyoruz.
    # Gerçek uygulamalarda config dosyasını 'source' ederek doğrudan değişkene erişmek daha güvenlidir.
    local value=$(grep -E "^${key}=" "$config_file" | cut -d'=' -f2-)

    if [ -n "$value" ]; then
        echo "$value"
        return 0
    else
        log_warn "get_config_value(): Anahtar '$key' yapılandırma dosyasında bulunamadı."
        echo ""
        return 1
    }
}