← man/dev_and_programming
config_data — man config_data — 80×24
ugur@toprak:~/man/dev_and_programming$man config_data
Bölüm 1 Geliştirme & Programlama

config_data

Perl modüllerinin yapılandırmasını sorgular veya değiştirir

Genel Bakış

 	 # Yapılandırma/özellik (config/feature) değerlerini al
 	 config_data --module Foo::Bar --feature bazzable
 	 config_data --module Foo::Bar --config magic_number

 	 # Yapılandırma/özellik değerlerini ayarla
 	 config_data --module Foo::Bar --set_feature bazzable=1
 	 config_data --module Foo::Bar --set_config magic_number=42

 	 # Kullanım mesajını yazdır
 	 config_data --help

Açıklama

"config_data" aracı, Perl modüllerinin yapılandırmasına yönelik bir komut satırı arayüzü sağlar. "Yapılandırma" derken, "kullanıcı tercihleri" veya "yerel ayarlar" gibi bir şeyi kastediyoruz. Bu; Andreas Koenig ("CPAN::Config"), Jon Swartz ("HTML::Mason::Config"), Andy Wardley ("Template::Config") ve Larry Wall (perl'in kendi Config.pm'i) gibi kişilerin bağımsız olarak geliştirdiği sistemlerin resmileştirilmesi ve soyutlanmasıdır.

Burada kullanılan yapılandırma sistemi, "Module::Build" bağlamında geliştirilmiştir. Bu sisteme göre, örneğin "Foo" modülüne ait yapılandırma resmi, "Foo::ConfigData" adlı bir modülde saklanır (Ben buna "Foo::Config" derdim ama bu ad önceki paragrafta bahsedilen diğer sistemler tarafından alınmıştı...). Bu "...::ConfigData" modülleri, yapılandırma verilerini ve bu verileri sorgulamak ile ayarlamak (evet, aslında yeniden yazmak) için herkese açık yöntemleri (methods) içerir. "config_data" betiği (şu anda belgesini okuduğunuz betik) yalnızca bu yöntemler için bir arayüzdür (front-end). Dilerseniz alternatif arayüzler oluşturabilirsiniz.

Saklanabilecek iki veri türü "config" (yapılandırma) değerleri ve "feature" (özellik) değerleri olarak adlandırılır. Bir "config" değeri, karmaşık veri yapısı referansları da dahil olmak üzere herhangi bir perl skaler değeri (scalar) olabilir. Ancak "Data::Dumper" kullanılarak serileştirilebilir (serializable) olmalıdır. Bir "feature" ise boolean (1 veya 0) bir değerdir.

Kullanım

Bu betik, tek bir modülün yapılandırması etrafında temel bir alıcı/ayarlayıcı (getter/setter) sarmalayıcısı (wrapper) olarak işlev görür. Komut satırında, hangi modülün yapılandırmasıyla ilgilendiğinizi belirtin ve "config" veya "feature" değerlerini almak veya ayarlamak için seçenekler geçirin. Aşağıdaki seçenekler desteklenmektedir:

module Yapılandırılacak modülün adını belirtir (gerekli).

feature Bir "feature" (özellik) adı geçirildiğinde, bunun değerini gösterir. Değer, özellik etkinse 1, özellik etkin değilse 0 veya özellik bilinmiyorsa boş olacaktır. Herhangi bir özellik adı belirtilmediğinde, bilinen tüm özelliklerin adları ve değerleri gösterilecektir.

config Bir "config" (yapılandırma) girdisinin adı geçirildiğinde, bunun değerini gösterir. Değer, perl kodu olarak "Data::Dumper" (veya benzeri) kullanılarak görüntülenecektir. Herhangi bir yapılandırma adı belirtilmediğinde, bilinen tüm yapılandırma girdilerinin adları ve değerleri gösterilecektir.

set_feature Belirtilen "feature" değerini verilen boolean değerine ayarlar. Değeri 1 veya 0 olarak belirtin.

set_config Belirtilen "config" girdisini verilen değere ayarlar.

eval Eğer "--eval" seçeneği kullanılırsa, "set_config" içindeki değerler saklanmadan önce perl kodu olarak değerlendirilecektir (evaluate). Bu, orta derecede karmaşık veri yapılarının saklanmasına olanak tanır. Gerçekten karmaşık yapılar için muhtemelen bu komut satırı arayüzünü kullanmamalı, bunun yerine doğrudan Perl API'sini kullanmalısınız.

help Birkaç örnek de içeren bir yardım mesajı yazdırır ve çıkar.

Yazar

Ken Williams, kwilliams@cpan.org

Telif Hakkı

Telif Hakkı (c) 1999, Ken Williams. Tüm hakları saklıdır.

Bu kütüphane ücretsiz bir yazılımdır; Perl'in kendisiyle aynı şartlar altında yeniden dağıtabilir ve/veya değiştirebilirsiniz.

Ayrıca Bakınız

Module::Build(3), perl(1).

perl v5.34.0 2026-02-22 CONFIG_DATA(1)