n n

PiSi hakkında

n n

PİSİ (Packages Installed Successfully as Intended) 2011 öncesi Pardus projesi kapsamında geliştirilen bir ikili(binary) paket yönetim sistemidir. PiSi paket sistemi paketlerin sadece kurulup kaldırılmasından daha fazla işleve sahiptir, örneğin tüm kurulu paketlerin eski bir tarihteki haline geri döndürülebilmesi mümkündür.

n n

2.Temel bilgiler

n n

Paket: Sisteme kurulacak bir yazılım, doküman veya her tür veri.

n n

Kaynak dosya: Pakete ait derlenmemiş dosyaları, veri ve dökümanları bulunduran ve internetten indirilebilir haldeki sıkıştırılmış dosyalardır.

n n

Pisilemek: Bir paketi Pisi paketi haline getirmek.

n n

Derleme: Derlenebilir bir programlama dili ile yazılan programların (C, C++ gibi) kaynak kodlarını çalıştırılabilir ikili dosyaya (executable binary) dönüştürmek için yapılması gereken işlem.

n n

Bağımlılık: yazılımın çalışması ve derlenmesi sırasında kullandığı ve sisteme kurulması gereken başka paketler.

n n

Doğrulama kodu: İnternetten indirilen dosyaların doğruluğunu test etmek için kullanılır. Pisi paketi oluşturulurken yazılımın sıkıştırılmış kaynak dosyalarından sha1sum algoritmasıyla elde edilen anahtar yazılımın kendi sitesinde yayınlanan anahtar ile karşılaştırılarak doğrulama yapılır.

n n

2.1 Bakış açısı

n n

Bir yazılımı pisi paket sistemine dahil edilmesi pisilemek istediğiniz paketin ne olduğu ve nasıl çalıştığı hakkında bilgi toplamaktan başlayıp pisi dosyası oluşturulduktan sonra test edilip hata düzeltme ve yeni sürümlerin takip edilmesiyle devam eden bir süreçtir. Bir paketçi eğer bu süreci takip edebileceğini düşünüyorsa pisileme işlemine başlamalıdır. Bu açıdan bakınca yapılan pisi dosyaları onu yapanların çocukları gibi olurlar ve paketin her yeni sürümünde ve hata düzeltmesinde yenilenirler.

n n

Ancak sürece sadık kalınmadan başıboş bırakılan ve takip edilmeyen pisi paketlerinin ömrü her gün yeni geliştirmelerin yapıldığı Linux dünyasında çok kısa olacaktır. Bu nedenle "yapabildiğin kadar değil bakabileceğin kadar pisile" sözünü unutmamalısınız. Ayrıca Linux dünyası kollektif çalışmanın ve imece yönteminin en güzel örneklerini sergileyip geliştiğinden mutlaka pisilediğiniz inşa dosyalarını internette paylaşın. Bu sayede pisi paketlerinizi takip edecek pek çok ebeveyni olabilir.

n n

2.2 Pisileme işlevi

n n

Bu işlev sonraki bölümde anlatılan dosyalar (Pisi inşa dosyaları) kullanılarak paketin inşa dosyasından Pisi tarafından kullanılabilecek bir paket ortaya çıkarma mekanizmasıdır. Bu mekanizma ile Pisi tarafından paket oluşturma süreci şöyledir;

n n

Oluşturulan pspec.xml dosyasının Source bölümündeki bilgiler işlenerek yazılımın kaynak kodu indirilir ve sha1sum şifreleme anahtarı ile doğruluğu kontrol edilerek /var/pisi/paket_adi/work klasörüne açılır.

n n

Eğer varsa files klasörü içindeki gerekli dosya ve yamalar uygun bir şekilde koda uygulanır.

n n

actions.py python betiği işletilerek paket elde etmek için kaynak koddan /var/pisi/paket_adi/install dizinine kurulum yapılır.

n n

Varsa ek dosyalar install dizinine pspec.xml dosyasında "additional files" kısmında belirtildiği üzere kopyalanır.

n n

Pisi, install dizinindeki oluşan dosyaları XML biçiminde indeksler.

n n

Bu indeks dosyaları ve paket verisi pspec.xml'den alınan verilerle birleştirilerek tek bir pisi dosyası olarak sıkıştırılır.

n n

Görüldüğü gibi pisi dosyası oluştururken aynı zamanda paketi /var/pisi/paket_adi/install dizinine de kurmuş oluyoruz. Pisi bu kurulumun sanki kök dizine kuruluyormuş gibi olmasını sağlıyor. Bu sayede bu dizine bakarak paket kurulduğunda sistemdeki hangi dosyaları oluşturduğunu görmüş oluyoruz.

n n

2.3 Pisi Linux GIT reposu

n n

GIT reposu Pisi Linux geliştiricilerinin paketler için oluşturduğu pisi inşa dosyalarını ve Pisi Linux projelerini barındıran bir servistir. Depoya Github adresinden ulaşabilirsiniz, burada Pisi Linux için pisilenmiş paketlerin inşa dosyaları ve projelerin kaynak kodları bulunur. Pisilemeye yeni başlayanların "Nasıl?" sorularının yanıtlarının hepsi aslında bu Pisi Paketleri reposundaki inşa dosyalarında mevcuttur.

n n

2.4 Dosya ve dizin konumları

n n

Pisi paketi inşa dosyaları pspec.xml ve actions.py'dir ve her ikisi de aynı dizinde olmalıdır. Ayrıca ihtiyaç halinde kullanılan diğer dosyalar için comar ve files dizinleri kullanılır, bunlar da yine pspec.xml ile aynı klasörde bulunmalıdır. Kaynak dosyalar şöyle görünür;

n n

paket_adı

n n

n     |__pspec.xml
n
n     |__actions.py
n
n     |__translations.xml
n
n     |__files
n
n     |__comar
n
n           |__package.py
n           |__service.py
n
n

n n

2.5 ActionsApi

n n

n
n

n n

Bu belgede Actions API tanıtılmış ve içerisindeki fonksiyonların işlevleri açıklanmış ve örneklendirilmiştir.

n n

n
n

n n

Actions

n n

n
n

n n

Bir uygulamanın PiSi paketi haline getirilmesi için paket inşa sistemi tarafından kullanılan minimum bileşenler, paketlenecek uygulamanın kaynak kodu, pspec.xml dosyası ve actions.py dosyasıdır. Ayrıca varsa yamalar ve ek dosyalar da uygulamanın kaynak kodunun parçası olarak düşünülebilir.

n n

n
n

n n

pspec.xml dosyası uygulamanın kaynak kodunu taşıyan arşiv dosyasının nereden çekileceği, bu arşiv dosyası açılırken hangi yamaların uygulanacağı, bu uygulamayı kimin paketlemiş olduğu, uygulamanın adı, sürüm numarası gibi meta sayılabilecek bilgilerin saklandığı dosya iken, bu uygulamanın derlenmesi ve inşa edilmesi aşamasında yapılması gereken işlerin tarifi de, bu belgede bahsedilecek olan Actions API'dan faydalanan actions.py dosyası içerisinde yer alır. Örnek bir actions.py dosyası aşağıdaki gibidir:

n n

n
n

n n

n#!/usr/bin/python 
n# -*- coding: utf-8 -*-
n
n#Licensed under the GNU General Public License, version 3. 
n# See the file http://www.gnu.org/licenses/gpl.txt
n
n
n from pisi.actionsapi import autotools
n from pisi.actionsapi import pisitools
n from pisi.actionsapi import get 
n
n def setup():
n     autotools.configure("--enable-nls 
n                          --bindir=/bin 
n                          --with-rmt=/usr/sbin/rmt") 
n
n def build():
n     autotools.make() 
n
n def install():
n     autotools.rawInstall("DESTDIR=%s" % get.installDIR())
n     pisitools.dodoc("AUTHORS", "NEWS", "README")
n     pisitools.remove("/usr/share/man/man1/mt.1")
n     pisitools.removeDir("/usr/libexec")
n

n n

n
n

n n

Bu belgede actions.py python betiği içerisinde paketlerin inşa edilmesi yapılandırılması ve kurulumu işlevlerinin gerçekleştirilebilmesi için Actions API tarafından sağlanan fonksiyonlar üzerinde durulacaktır.

n n

n
n

n n

Belge içerisinde sık sık bahsedilen kurulum (install) işlemi, uygulamanın gerçek sisteme kurulumu ile karıştırılmamalıdır. Bu belgede bahsedilen kurulum işlemi aksi belirtilmediği sürece, uygulamanın paketlenmesinden bir önceki aşama olan ve bu paket gerçek sistemde kurulurken hangi dosyanın nereye gitmesi gerektiğinin anlaşılması için yapılan sanal bir kurulum işlemidir.

n n

n
n

n n

Actions API

n n

n
n

n n

Actions API, pisi paketlerinin oluşturulması esnasında paketi oluşturacak yazılımın hangi işlemlere tabi tutulacağına dair bilgilerin Python programlama dili ile yazıldığı actions.py isimli dosya içerisinde kullanabilecek fonksiyonları barındıran kütüphanedir. Paket yapılırken bu kütüphane dışında herhangi bir Python modülü kullanılmaması tavsiye edilir, fakat paketleyici bu konuda özgürdür.

n n

n
n

n n

actions.py isimli dosya, kaynak koddan bir ikili ve kurulmaya hazır PİSİ paketi oluşturma sürecini tarif eden bir dosyadır. Bu dosya içerisinde tarifin doğru şekilde yapılabilmesi için paket yapıcının paketleyecekleri yazılımı yeterince tanıması gereklidir. Öte yandan paket yapıcı için bu kaynağın daha önce paketlendiği dağıtımların paket sistemlerinin spec dosyalarına göz atarak hızlı bir şekilde paketin nasıl oluşturulması gerektiğine dair fikir sahibi olması da mümkündür, fakat bunun PİSİ'nin diğer paket yöneticileri ile arasında organik bir bağ olduğu şeklinde yorumlanması yanlış olur; çünkü PİSİ diğer paket yöneticilerinin hiçbirisi ile arasında bir ilişki olmayan yeni bir paket yöneticisidir.

n n

n
n

n n

Actions API içerisinde paket yapıcılara sunulan fonksiyonlar amaçlarına göre birbirinden ayrılmış ve ayrı modüller içerisinde toplanmışlardır. Her bir modülün actions.py içerisinden dahil edildiğinde hangi fonksiyonları sunduğu ve bu fonksiyonların özellikleri sonraki başlıklarda incelenmiştir. Bununla beraber modüllerin basitçe amaçları şu şekilde tanımlanabilir:

n n

n
n

n n

Autotools: Uygulama derlemek ve kurmak için gerekli olan standart işlevleri sunar.

n n

n
n

n n

Cmaketools: cmake ile yapılandırılan uygulamaları derlemek ve kurmak için gerekli olan standart işlevleri sunar.

n n

n
n

n n

Pisitools: Pisitools, içerisinde paket yapıcıların en sık kullanacağı fonksiyonları sunan modüldür. Özel durumlar dışında tüm işlemler bu modüldeki fonksiyonlar yardımı ile gerçekleştirilmelidir. Bu modül ile beraber gelen fonksiyonların tümü relative path'ler ile çalışır ve çok büyük bir kısmı da work dizininden install dizinine dosya taşıma işlerinde kullanılırlar. Bununla beraber symlink oluşturma, dosyalar üzerinde değişiklik yapma (sed ile), dosya ya da dizin silme gibi ihtiyaçlara da yanıt verir.

n n

n
n

n n

Shelltools: Bu modül ile beraber özel durumlarda kullanılabilecek fonksiyonlar sunulur. Kimi işlevler pisitools içindeki işlevlerle benzerlik gösterir, fakat shelltools içerisindekilere absolut path verebilir, böylece sıkça karşılaşılmayacak work dizininden work dizinine, install dizininden install dizinine doysa taşıma işlemleri, dosya izinlerini değiştirme, kabuk'ta komut çalıştırma, çalışma dizini değiştirme gibi ihtiyaçlar karşılanabilir. Fakat mümkün olan her durumda Pisitools içerisindeki fonksiyonların tercih edilmesi şarttır. Shelltools içerisindeki fonksiyonlar paketleyiciyi tamamen özgür bıraktığı için dikkatli bir şekilde kullanılmalılardır.

n n

n
n

n n

Libtools: Kütüphanelerin doğru şekilde yapılandırılması, uygulamanın doğru şekilde derlenebilmesi için ihtiyaç duyulan derleme öncesi ve sonrası işlevlerini sunar.

n n

n
n

n n

Get: Derleme öncesi yapılandırma, derleme ve kurulum esnasında ihtiyaç duyulabilecek çeşitli ortam değişkenlerinin ve paket ile ilgili bilgilerin elde edilmesi için işlevler sunar.

n n

n
n

n n

Kde: KDE uygulamaları için derleme öncesi yapılandırma, derleme ve kurulum işlevlerini sunar.

n n

n
n

n n

Perlmodules: Perl modüllerinin kurulumu için gerekli işlevleri sunar.

n n

n
n

n n

Pythonmodules: Python modüllerinin derlenmesi, kurulması, çalıştırılması gibi işlevleri sunar.

n n

n
n

n n

Scons: Scons yeni nesil bir yazılım inşa aracıdır, geliştiricilere geleneksel autoconf/automake araçlarının yerini alabilecek bir yapı sunar. Autotools modülünün autoconf/automake için sunduklarını, Scons modülü de scons ile inşa edilmek üzere hazırlanmış uygulamalar için sunar.

n n

n
n

n n

Takip eden bölümlerde modüllerle ilgili açıklamalar yer almaktadır. Fonksiyonlar modüllerin altbaşlıkları olarak gösterilmiştir, fonksiyon ismini takip eden satırda fonksiyonun aldığı parametreler belirtilmiş (bir fonksiyon hiç parametre almadığı None belirtimi ile ifade edilmiştir), takip eden paragrafta nasıl bir işlev sunduğu açıklanmış, bu açıklamanın ardından da örnek bir kullanımı verilmiştir.

n n

n
n

n n

Pisitools

n n

n
n

n n

Pisitools modülü bir paket geliştiricisinin en çok ihtiyaç duyabileceği işlevleri barındıran modüldür. Ayrıca, paket yapıcının çağırdığı fonksiyonlardaki parametrelerin başına otomatik olarak çalışma dizinlerini ekleyerek onun sistemin gerçek dosyalarına erişmeden sanal bir dizin içerisinde çalışabilmesine olanak sağlar. Pisitools modülünün sunduğu bu rahatlık kimi durumlarda engelleyici olabilmektedir, bu gibi durumda da tüm kontrolü paket yapıcıya bırakan Shelltools modülü içerisindeki işlevlerden yararlanılabilir.

n n

n
n

n n

dobin (sourceFile, destinationDirectory = '/usr/bin')

n n

n
n

n n

work dizini içerisindeki yolu sourceFile ile verilen bir çalıştırılabilir destinationDirectory parametresi ile tam yolu verilmiş dizin içerisine koyar. Bu parametrenin öntanımlı değeri ``/usr/bin ''dizinidir.''

n n

n
n

n n

pisitools.dobin("sed/sed", "/bin")

n n

n
n

n n

pisitools.dobin("zipsplit")

n n

n
n

n n

dosbin (sourceFile, destinationDirectory = '/usr/sbin')

n n

n
n

n n

Install dizini içerisine destinationDirectory ile belirtilmiş isimde bir dizini oluşturur.

n n

n
n

n n

work dizininde içerisindeki yolu sourceFile ile verilen bir çalıştırılabilir dosyayı öntanımlı olarak /sbin verilmiş ise destinationDirectory ile tam yolu verilmiş dizin içerisine kopyalar.+

n n

n
n

n n

pisitools.dosbin("traceroute6")

n n

n
n

n n

pisitools.dosbin("extras/scsi_id/scsi_id", "/sbin")

n n

n
n

n n

dodir (destinationDirectory)

n n

n
n

n n

Install dizini içerisine destinationDirectory ile belirtilmiş isimde bir dizini oluşturur.

n n

n
n

n n

n
pisitools.dodir("/usr/include/awk")
n
n
pisitools.dodir("/usr/" + get.HOST() + "/include")
n
n
pisitools.dodir("/usr/share/doc/%s/examples" % get.srcTAG())
n

n n

n
n

n n

dodoc (sourceFiles)

n n

n
n

n n

work dizini içerisinden yolu verilen dosya ya da dosya listesini install dizni altındaki /usr/share/doc/PACKAGE altına kopyalar. Metakarakter kullanılabilir.

n n

n
n

n n

n
pisitools.dodoc("README")
n
n
pisitools.dodoc("*.html")
n
n
pisitools.dodoc("FAQ", "README", "ChangeLog.*", "algorithm.txt")
n

n n

n
n

n n

doexe (sourceFile, destinationDirectory)

n n

n
n

n n

work dizinindeki yolu verilen bir dosyayı destinationDirectory ile belirlenen install dizini içerisindeki hedefe çalıştırılabilir dosya olarak kopyalar. sourceFile için Metakarakter kullanılabilir.

n n

n
n

n n

n
pisitools.doexe("extras/scsi-devfs.sh", "/etc/udev/scripts/")
n
n
pisitools.doexe("etc/hotplug/*.rc", "/etc/hotplug/")
n

n n

n
n

n n

dohtml (sourceFiles)

n n

n
n

n n

work dizini içerisinden yolu verilen dosya ya da dosya listesini install dizni altındaki /usr/share/doc/PACKAGE/html altına kopyalar. Metakarakter kullanılabilir.

n n

n
n

n n

n
pisitools.dohtml("index.html")
n
n
pisitools.dohtml("doc/*")
n

n n

n
n

n n

doinfo (*sourceFiles)

n n

n
n

n n

work dizini içerisinden yolu verilen dosya ya da dosya listesini install dizni altındaki /usr/share/info altına kopyalar. Metakarakter kullanılabilir.

n n

n
n

n n

pisitools.doinfo("*.info")

n n

n
n

n n

dolib (sourceFile, destinationDirectory = '/usr/lib')

n n

n
n

n n

work dizini içerisindeki bir kütüphaneyi öntanımlı olarak install dizini altında /usr/lib içerisine kopyalar.

n n

n
n

n n

n
pisitools.dolib("libz.a")
n
n
pisitools.dolib("lib/libpci.a")
n
n
pisitools.dolib("libbz2.so.1.0.2", "/lib")
n

n n

n
n

n n

dolib_a (sourceFile, destinationDirectory = '/usr/lib')

n n

n
n

n n

work dizini içerisindeki bir statik kütüphaneyi öntanımlı olarak install dizini altında /usr/lib içerisine gerekli dosya izinleri ile kopyalar.

n n

n
n

n n

n
pisitools.dolib_a("lib/libpci.a")
n
n
pisitools.dolib_a("libdb1.a")
n

n n

n
n

n n

dolib_so (sourceFile, destinationDirectory = '/usr/lib')

n n

n
n

n n

work dizini içerisindeki bir paylaşımlı kütüphaneyi öntanımlı olarak install dizini altında /usr/lib içerisine gerekli dosya izinleri ile kopyalar.

n n

n
n

n n

pisitools.dolib_so("libdb1.so.2")

n n

n
n

n n

doman (*sourceFiles)

n n

n
n

n n

work dizini içerisinden yolu verilen dosya ya da dosya listesini install dizni altındaki /usr/share/man/ altına kopyalar. Metakarakter kullanılabilir.

n n

n
n

n n

n
pisitools.doman("logrotate.8")
n
n
pisitools.doman("doc/bash.1", "doc/bashbug.1", "doc/builtins.1", "doc/rbash.1")
n
n
pisitools.doman("*.[1-8]")
n

n n

n
n

n n

domo (sourceFile, locale, destinationFile )

n n

n
n

n n

work dizini içerisindeki yolu sourceFile ile verilen bir po dosyasını, locale ile belirlenen dil için derleyerek bir mo dosyası oluşturur ve bu dosyayı install altındaki /usr/share/locale/LOCALE/LC_MESSAGES dizini içerisine destinationFile ile verilen isimle kopyalar.

n n

n
n

n n

pisitools.domo("po/tr.po", "tr", "pam_login.mo")

n n

n
n

n n

domove (sourceFile, destination, destinationFile = '')

n n

n
n

n n

install dizini içerisindeki yolu sourceFile ile verilen dosyayı, yine install dizini içerisindeki yolu destination ile verilen dizin içerisine eğer belirtilmişse destinationFile ismi ile taşır.

n n

n
n

n n

n
pisitools.domove("/usr/bin/passwd", "/bin/")
n
n
pisitools.domove("/usr/bin/yacc", "/usr/bin", "yacc.bison")
n
n
pisitools.domove("/usr/docs/", "/usr/share/doc/%s/html/" % get.srcTAG())
n

n n

n
n

n n

dosed (sourceFile, findPattern, replacePattern = '')

n n

n
n

n n

work dizini içerisindeki yolu verilen sourceFile içerisinde istenen değişiklikleri yapar (FIXME: dosed dökümantasyonunun biraz daha genişletilmesi gerekli).

n n

n
n

n n

n
pisitools.dosed("gcc/version.c", "", "")
n
n
pisitools.dosed("sshd_config", "(?m)(#UsePAM ).*", r"UsePAM yes")
n
n
pisitools.dosed("unix/Makefile", "-O3", get.CFLAGS())
n
n
pisitools.dosed("Make.Rules", "HAVE_NDBM_H=yes", "HAVE_NDBM_H=no")
n
n
pisitools.dosed("Makefile.def", "CC=cc", "CC=%s" % get.CC())
n
n
pisitools.dosed("automake.texi", "(?m)(@setfilename.*)automake", r"1automake1.7")
n

n n

n
n

n n

dosym (sourceFile, destinationFile)

n n

n
n

n n

install dizini içerisinde göstereceği yol sourceFile ile verilmiş olan ve install dizin içerisindeki yolu destinationFile ile verilmiş bir symlink oluşturur.

n n

n
n

n n

n
pisitools.dosym("gzip", "/bin/gunzip")
n
n
pisitools.dosym("libdb1.so.2", "/usr/lib/libdb.so.2")
n
n
pisitools.dosym("../bin/lsmod", "/sbin/lsmod")
n
n
pisitools.dosym("/usr/X11R6/include/X11", "/usr/include/X11")
n

n n

n
n

n n

insinto (destinationDirectory, sourceFile, destinationFile = '', sym = True)

n n

n
n

n n

work dizini içerisindeki yolu sourceFile ile verilmiş olan bir dosyayı install dizini içerisindeki yolu destinationDirectory ile verilmiş olan dizin içerisine, eğer verilmişse destinationFile ismi ile, eğer verilmemişse kendi adı ile kopyalar. Dosyanın work dizini içerisindeki uid/guid ve izinleri korunur. destinationFile parametresi kullanılmamışsa, sourceFile için metakarakter kullanılabilir.

n n

n
n

n n

n
pisitools.insinto("/opt/rar/bin", "rar")
n
n
pisitools.insinto("/etc/", "doc/nanorc.sample", "nanorc")
n
n
pisitools.insinto("/etc/hotplug", "etc/hotplug/*map")
n

n n

n
n

n n

newdoc (sourceFile, destinationFile)

n n

n
n

n n

work dizini içerisindeki yolu sourceFile ile verilmiş olan dosyayı /usr/share/doc/PACKAGE/ dizini içerisine destinationFile adı ile kopyalar.

n n

n
n

n n

n
pisitools.newdoc("extras/volume_id/README", "README_volume_id")
n
n
pisitools.newdoc("gprof/ChangeLog.linux", "gprof/ChangeLog.linux")
n
n
pisitools.newdoc("bfd/PORTING", "bfd/PORTING")
n

n n

n
n

n n

newman (sourceFile, destinationFile)

n n

n
n

n n

work dizini içerisindeki yolu sourceFile ile verilmiş olan dosyayı /usr/share/man/manPREFIX/ dizini içerisine destinationFile adı ile kopyalar.

n n

n
n

n n

pisitools.newman("less.nro", "less.1")

n n

n
n

n n

remove (sourceFile)

n n

n
n

n n

install dizini içerisindeki yolu sourceFile ile verilmiş olan dosyayı siler.

n n

n
n

n n

pisitools.remove("/usr/lib/libdb_cxx.so")

n n

n
n

n n

rename (sourceFile, destinationFile)

n n

n
n

n n

install dizini içerisindeki yolu sourceFile ile verilen dosyayı, bulunduğu dizinde destinationFile olarak isimlendirir.

n n

n
n

n n

pisitools.rename("/usr/bin/bash", "bash.old")

n n

n
n

n n

removeDir (destinationDirectory)

n n

n
n

n n

install dizini içerisindeki yolu destinationDirectory ile verilmiş olan dizini tüm içeriği ile beraber siler.

n n

n
n

n n

pisitools.removeDir("/usr/lib")

n n

n
n

n n

Autotools

n n

n
n

n n

configure (parameters = "")

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ve PİSİ'nin ön tanımlı yapılandırma parametreleri ile yapılandırır. Fonksiyonun parametreli ile ya da parametresiz çağırıldığı farketmeksizin, her durumda prefix, host, mandir, infodir, datadir, sysconfdir, localstatedir parametreleri öntanımlı değerleri configure betiğine gönderilir. Bu öntanımlı değerler ``PisiKaynakDizini/pisi/actionsapi/variables.py ''içerisinden görüntülenebilir.''

n n

n
n

n n

rawConfigure (parameters = "", prefix="")

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ile hiçbir öntanımlı yapılandırma parametresi olmaksızın yapılandırır.

n n

n
n

n n

n
autotools.rawConfigure()
n
n
autotools.rawConfigure("--prefix %s/usr --with-doxywizard" % get.installDIR())
n
n
autotools.rawConfigure("--enable-nls --enable-freetype --disable-xmltest")
n

n n

n
n

n n

compile (parameters = "")

n n

n
n

n n

make (parameters = "")

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ile inşa eder.

n n

n
n

n n

n
autotools.make()
n
n
autotools.make("local-all")
n
n
autotools.make("LIBS=%s" % get.LDFLAGS())
n
n
autotools.make("-j1")
n

n n

n
n

n n

install (parameters = "")

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ve PİSİ'nin ön tanımlı kurulum parametreleri ile kurulum dizini içerisine kurar.

n n

n
n

n n

n
autotools.install()
n
n
autotools.install("libdir=%s/usr/lib" % get.installDIR())
n

n n

n
n

n n

rawInstall (parameters = "")

n n

n
n

n n

Kaynağı verilen parametreler ile kurulum dizini içerisine kurar.

n n

n
n

n n

n
autotools.rawInstall("DESTDIR=%s" % get.installDIR())
n
n
autotools.rawInstall("DESTDIR="%s" docdir=/usr/share/doc/%s/html" % (get.installDIR(), get.srcTAG()))
n

n n

n
n

n n

aclocal (parameters = "")

n n

n
n

n n

configure.in dosyasının içeriğine göre bir aclocal.m4 oluşturmak için çağırılır.

n n

n
n

n n

n
autotools.aclocal("-I cmulocal -I config")
n
n
autotools.aclocal("-I m4")
n
n
autotools.aclocal()
n

n n

n
n

n n

autoconf (parameters = "")

n n

n
n

n n

configure betiğinin oluşturulması için çağırılır.

n n

n
n

n n

n
autotools.autoconf()
n
n
autoreconf (parameters = "")
n

n n

n
n

n n

configure betiğinin tekrar oluşturulması için çağırılır.

n n

n
n

n n

n
autotools.autoreconf()
n
n
automake (parameters = "")
n

n n

n
n

n n

makefile dosyasının yaratılması için çağırılır.

n n

n
n

n n

n
autotools.automake("-afc")
n
n
autotools.automake("--add-missing")
n
n
autotools.automake()
n

n n

n
n

n n

autoheader (parameters = "")

n n

n
n

n n

configure için şablon dosyalarının yaratılması için çağırılır.

n n

n
n

n n

autotools.autoheader()

n n

n
n

n n

Cmaketools

n n

n
n

n n

configure(parameters = '', sourceDir = '.', installPrefix = '%s' % get.defaultprefixDIR())

n n

n
n

n n

Kaynağı verilen parametreler ile yapılandırır.

n n

n
n

n n

n
cmaketools.configure()
n
n
cmaketools.configure(installPrefix = "%s" % (get.kdeDIR()))
n

n n

n
n

n n

cmaketools.configure("-DCMAKE_BUILD_TYPE=None -DKDEDIR=%s" % get.kdeDIR(), sourceDir = "..")

n n

n
n

n n

make(parameters = "")

n n

n
n

n n

Kaynağı ''parameters'' ile verilen parametreler ile inşa eder.

n n

n
n

n n

n
cmaketools.make()
n
n
cmaketools.make("LIBS=%s" % get.LDFLAGS())
n
n
cmaketools.make("-j1")
n

n n

n
n

n n

install (parameters = '', argument = 'install')

n n

n
n

n n

Kaynağı ''parameters'' ile verilen parametreler ve PİSİ'nin ön tanımlı kurulum parametreleri ile kurulum dizini içerisine kurar.

n n

n
n

n n

n
cmaketools.install()
n
n
cmaketools.install("libdir=%s/usr/lib" % get.installDIR())
n

n n

n
n

n n

rawInstall (parameters = '', argument = 'install')

n n

n
n

n n

Kaynağı install'dan farklı olarak sadece ''parameters'' ile verilen parametreler ile kurar.

n n

n
n

n n

cmaketools.rawInstall("PREFIX=%s" % get.installDIR())

n n

n
n

n n

Libtools

n n

n
n

n n

preplib (sourceDirectory = "/usr/lib")

n n

n
n

n n

Belirtilen dizin için ldconfig komutunu çalıştırır.

n n

n
n

n n

gnuconfig_update (None)

n n

n
n

n n

En yeni config.* dosyalarını kaynak üzerine kopyalar.

n n

n
n

n n

libtoolize (parameters = "")

n n

n
n

n n

Bir kaynağı libtool kullanabilecek hale getirir. Bunun, için kaynak dizininde "/usr/bin/libtoolize" uygulamasını parameters ile verilmiş parametreler ile çağırır.

n n

n
n

n n

gen_usr_ldscript (dynamicLib)

n n

n
n

n n

Pardus /lib dizini altında dinamik, /usr/lib altında da statik olarak kritik kütüphanelere sahip olduğundan, bağlama (linking) problemleri ile karşılaşmamak için /usr/lib dizini altında sahte bir dinamik kütüphane oluşturmamız gerekiyor. Bu amaçla /usr/lib dizini altında 'dynamicLib' parametresi ile verilen isimde bir dosyayı yazma modu ('w') ile açarak, boş bir dosya oluşturuyoruz. Daha sonra da içerisine açıklama niteliğinde karakter dizisi yerleştirerek, ardından dosya izinlerini değiştiriyoruz (öntanımlı 0755).

n n

n
n

n n

Shelltools

n n

n
n

n n

Pisitools ile yer yer benzer işlevler sunar (örneğin pisitools.domove() ile shelltools.move() teorik olarak aynı işlevi sunarlar). Fakat shelltools modülü, pisitools modülünün paket yapıcıya sunduğu rahatlığı sunmaz. Pisitools modülü ile çalışılırken, fonksiyon çağrılarına çalışma dizinleri otomatik olarak eklenirken, shelltools ile paket yapıcı daha özgürdür ve biraz daha dikkat etmek zorundadır, çünkü çalışma dizini dışında kalan, sistemin gerçek dosyalarına da erişme şansı vardır.

n n

n
n

n n

Paket yapıcıların gerekmediği sürece shelltools modülünü kullanmamaları, bunun yerine eğer mümkünse ihtiyaç duydukları işlevleri pisitools modülünden karşılamaları beklenir.

n n

n
n

n n

can_access_file (sourceFile)

n n

n
n

n n

Tam yolu sourceFile ile verilmiş olan dosyanın erişilebilir olup olmadığını bilgisini döndürür.

n n

n
n

n n

shelltools.can_access_file("/usr/share/terminfo/%s" % termfile)

n n

n
n

n n

can_access_directory (destinationDirectory)

n n

n
n

n n

Tam yolu destinationDirectory ile verilmiş olan dizinin erişilebilir olup olmadığını bilgisini döndürür.

n n

n
n

n n

makedirs (destinationDirectory)

n n

n
n

n n

Tam yolu destinationDirectory ile verilmiş olan dizini oluşturur.

n n

n
n

n n

n
shelltools.makedirs("%s/build" % get.workDIR())
n
n
shelltools.makedirs("%s/build-default-i686-pc-linux-gnu-nptl" % get.workDIR())
n

n n

n
n

n n

chmod (sourceFile, mode = 0755)

n n

n
n

n n

Tam yolu sourceFile ile verilen dosyanın izinlerini değiştirir. Metakarakter kullanılabilir.

n n

n
n

n n

n
shelltools.chmod("config/config.sub")
n
n
shelltools.chmod(get.installDIR() + "/lib/libz.so.*")
n
n
shelltools.chmod("%s/usr/lib/misc/pt_chown" % get.installDIR(), 4711)
n
n
shelltools.chmod(get.installDIR() + "/etc/ssh/sshd_config", 0600)
n

n n

n
n

n n

unlink (sourceFile)

n n

n
n

n n

Tam yolu sourceFile ile verilmiş olan dosyayı siler.

n n

n
n

n n

shelltools.unlink(get.workDIR() + '/' + get.srcDIR() + "/missing")

n n

n
n

n n

unlinkDir (sourceDirectory)

n n

n
n

n n

Tam yolu sourceDirectory ile verilmiş olan dizini ve altdizinlerini siler.

n n

n
n

n n

shelltools.unlinkDir(get.workDIR() + "/tmpbuild")

n n

n
n

n n

move (sourceFile, destinationFile)

n n

n
n

n n

Tam yolu sourceFile ile verilmiş dosya ya da dizini tam yolu destinationFile ile verilmiş dosya ya da dizine taşır. sourceFile içinde metakarakterler kulanılabilir.

n n

n
n

n n

n
shelltools.move("ac-wrapper.sh", "%s/usr/lib/misc/" % get.installDIR())
n
n
shelltools.move("proc/*.h", "%s/usr/include/proc/" % get.installDIR())
n

n n

n
n

n n

copy (sourceFile, destinationFile)

n n

n
n

n n

Tam yolu sourceFile ile verilmiş olan bir dosyayı tam oylu destinationFile ile verilmiş bir dosya olarak kopyalar. sourceFile içinde metakarakterler kulanılabilir.

n n

n
n

n n

n
shelltools.copy("Makefile.pre.in", "%s/usr/lib/python2.3/config/" % get.installDIR())
n
n
shelltools.copy("scripts/*", "%s/usr/bin/" % get.installDIR())
n

n n

n
n

n n

copytree (source, destination, sym=False)

n n

n
n

n n

Tam yolu source ile verilmiş olan dizini, tam yolu destination ile verilmiş hedefe kopyalar.

n n

n
n

n n

n
shelltools.copytree("include/linux/", "%s/usr/include/linux/" % get.installDIR())
n
n
shelltools.copytree("include/asm-generic/", "%s/usr/include/asm-generic/" % get.installDIR())
n

n n

n
n

n n

touch (sourceFile)

n n

n
n

n n

Tam yolu sourceFile ile verilen dosyanın son erişim tarihini erişim anı yapar, eğer dosya yoksa onu yaratır.

n n

n
n

n n

n
shelltools.touch(get.workDIR() + "aclocal.m4")
n
n
shelltools.touch("gcc/c-gperf.h")
n

n n

n
n

n n

cd (directoryName = '')

n n

n
n

n n

Çalışma dizinini tam yolu directoryName ile verilen dizin içerisine değiştirir.

n n

n
n

n n

n
shelltools.cd("build_unix")
n
n
shelltools.cd("%s/build-default-i686-pc-linux-gnu-nptl" % get.workDIR())
n

n n

n
n

n n

ls (source)

n n

n
n

n n

Tam yolu source ile verilen dizin ya da dosyaların bir listesini döndürür, bu liste içerisindeki her bir dosya üzerinde bir işlem yapmak gerektiği durumlarda kullanılabilir, metakarakterlerden yararlanılabilir.

n n

n
n

n n

shelltools.ls(get.installDIR() + "/usr/lib/*w.*")

n n

n
n

n n

for file in shelltools.ls(get.installDIR() + "/usr/lib/*w.*"):

n n

n
n

n n

shelltools.ls(get.installDIR() + "/bin/")

n n

n
n

n n

export (key, value)

n n

n
n

n n

key ile tanımlanmış isimdeki bir ortam değişkenini value değeri ile set eder.

n n

n
n

n n

n
shelltools.export("WANT_AUTOCONF", "2.5")
n
n
shelltools.export("CXX", get.CXX())
n
n
shelltools.export("LDFLAGS", get.LDFLAGS() + "-Wl,-z,now")
n
n
shelltools.export("LC_ALL", "C")
n

n n

n
n

n n

system (command)

n n

n
n

n n

command ile verilen komutu kabuğa işletir, kabukten dönen sonuç geridönüş değeridir.

n n

n
n

n n

n
shelltools.system("./update-pciids.sh &> /dev/null")
n
n
shelltools.system("./autogen.sh")
n

n n

n
n

n n

isLink (sourceFile)

n n

n
n

n n

Tam you sourceFile ile verilen dosyanın link olup olmadığı bilgisini döndürür.

n n

n
n

n n

shelltools.isLink(get.installDIR() + '/maybe/link')

n n

n
n

n n

realPath (sourceFile)

n n

n
n

n n

Tam you sourceFile ile verilen linkin işaret ettiği gerçek dizinin yolunu döndürür.

n n

n
n

n n

shelltools.realPath(get.installDIR() + link)

n n

n
n

n n

baseName (sourceFile)

n n

n
n

n n

sourceFile ile verilen dosya yolunun gösterdiği dosyanın adını döndürür (os.path.basename()). Aşağıdaki örnekteki gibi durumlarda kullanılabilir.

n n

n
n

n n

shelltools.baseName(shelltools.realPath(link))

n n

n
n

n n

dirName (sourceFile)

n n

n
n

n n

Tam yolu sourceFile ile verilen bir dosya yolunun son dizinlerden ibaret olan kısmını döndürür (bu kimi zaman verilen sourceFile'ın tamamıdır).

n n

n
n

n n

sym (sourceFile, destinationFile)

n n

n
n

n n

Göstereceği yol sourceFile ile verilmiş olan ve tam yolu destinationFile ile verilmiş bir symlink oluşturur.

n n

n
n

n n

Get

n n

n
n

n n

Get modülü, paket inşa ortamındaki sabit değerleri, dinamik değerleri ve ortam değişkenlerini okumak için kullanılır.

n n

n
n

n n

curDIR (None)

n n

n
n

n n

O an üzerinde çalışılan dizinin yolunu döndürür.

n n

n
n

n n

get.curDIR()*

n n

n
n

n n

curKERNEL (None)

n n

n
n

n n

Kullanılan kernel'in sürümünü döndürür.

n n

n
n

n n

get.curKERNEL()

n n

n
n

n n

curPERL (None)

n n

n
n

n n

Kullanılan Perl'in sürümünü döndürür.

n n

n
n

n n

get.curPERL()

n n

n
n

n n

curPYTHON (None)

n n

n
n

n n

Kullanılan Python'un sürümünü döndürür.

n n

n
n

n n

get.curPYTHON()

n n

n
n

n n

pkgDIR (None)

n n

n
n

n n

Paketin açıldığı ve içerisinde work ve install dizinlerinin olduğu dizinin tam yolunu döndürür.

n n

n
n

n n

get.pkgDIR()

n n

n
n

n n

workDIR (None)

n n

n
n

n n

work dizininin tam yolunu döndürür. *

n n

n
n

n n

n```installDIR (None)
n

n n

n
n

n n

install dizininin tam yolunu döndürür.

n n

n
n

n n

get.installDIR()

n n

n
n

n n

srcNAME (None)

n n

n
n

n n

Kaynak paketinin adını döndürür (automake-wrapper-1.7-3 için, automake-wrapper).

n n

n
n

n n

get.srcNAME()

n n

n
n

n n

srcVERSION (None)

n n

n
n

n n

Paketin kaynak versiyonunu döndürür (automake-wrapper-1.7-3 için, 1.7).

n n

n
n

n n

n
n```srcRELEASE (None)
n

n n

n
n

n n

Paket kaynağının dağıtım tarafından çıkarılmış kaçıncı sürümü olduğunu döndürür (automake-wrapper-1.7-3 için, 3)

n n

n
n

n n

get.srcRELEASE()

n n

n
n

n n

srcTAG (None)

n n

n
n

n n

Paket adı + '-' + mainstream sürüm numarası + '-' + dağıtım sürüm numarası'ndan oluşan ismi döndürür (automake-wrapper-1.7-3 için, automake-wrapper-1.7-3).

n n

n
n

n n

get.srcTAG()

n n

n
n

n n

srcDIR (None)

n n

n
n

n n

Paket adı + '-' + mainstream sürüm numarası'ndan oluşan ismi döndürür (automake-wrapper-1.7-3 için, automake-wrapper-1.7).

n n

n
n

n n

get.srcDIR()

n n

n
n

n n

ARCH (None)

n n

n
n

n n

Üzerinde çalışılan bilgisayarın işlemci mimarisini döndürür.

n n

n
n

n n

n
arch = "linux-x86-64" if get.ARCH() == "x86_64" else "linux-x86-sse2"
n
n
bits = "64" if get.ARCH() == "x86_64" else "32"
n
n
minimumcpu = "" if get.ARCH() == "x86_64" else "--cpu=pentium2"
n
n
cpu = "x86-64" if get.ARCH() == "x86_64" else "sse"
n
n
mmx = "--enable-mmx" if get.ARCH() == "i686" else "--disable-mmx"
n
n
optimizationtype = "--enable-amd64" if get.ARCH() == "x86_64" else "--enable-mmx"
n
n
libdir = "lib64" if get.ARCH() == "x86_64" else "lib"
n
n
flags = "%s -fPIC" % get.CFLAGS() if get.ARCH() == "x86_64" else get.CFLAGS()
n
n
WorkDir = get.ARCH()
n
n
WorkDir = "%s/%s" % (get.ARCH(), get.srcNAME())
n

n n

n
n

n n

HOST (None)

n n

n
n

n n

CFLAGS (None)

n n

n
n

n n

CXXFLAGS (None)

n n

n
n

n n

LDFLAGS (None)

n n

n
n

n n

docDIR (None)

n n

n
n

n n

sbinDIR (None)

n n

n
n

n n

infoDIR (None)

n n

n
n

n n

manDIR (None)

n n

n
n

n n

dataDIR (None)

n n

n
n

n n

confDIR (None)

n n

n
n

n n

localstateDIR (None)

n n

n
n

n n

defaultprefixDIR (None)

n n

n
n

n n

kdeDIR (None)

n n

n
n

n n

qtDIR (None)

n n

n
n

n n

qtLIBDIR (None)

n n

n
n

n n

AR (None)

n n

n
n

n n

AS (None)

n n

n
n

n n

CC (None)

n n

n
n

n n

CXX (None)

n n

n
n

n n

LD (None)

n n

n
n

n n

NM (None)

n n

n
n

n n

RANLIB (None)

n n

n
n

n n

F77 (None)

n n

n
n

n n

GCJ (None)

n n

n
n

n n

Kde

n n

n
n

n n

configure *(parameters = "")

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ve PİSİ'nin ön tanımlı yapılandırma parametreleri ile yapılandırır.

n n

n
n

n n

kde.configure()

n n

n
n

n n

make (parameters = "")

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ile inşa eder.

n n

n
n

n n

kde.make()

n n

n
n

n n

install (parameters = 'install')

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ve PİSİ'nin ön tanımlı kurulum parametreleri ile kurulum dizini içerisine kurar.

n n

n
n

n n

kde.install()

n n

n
n

n n

Perlmodules

n n

n
n

n n

configure (parameters = "")

n n

n
n

n n

Perl kaynağını verilen parametreler ile yapılandırır.

n n

n
n

n n

n
perlmodules.configure()
n
n
perlmodules.configure("/usr")
n
n
perlmodules.configure('BUILD_SPAMC="yes"
n

n n

n
n

n n

ENABLE_SSL="yes"

n n

n
n

n n

CONTACT_ADDRESS="root@localhost"

n n

n
n

n n

SYSCONFDIR=/etc

n n

n
n

n n

DATADIR=/usr/share/spamassassin')

n n

n
n

n n

make (parameters = "")

n n

n
n

n n

Perl kaynağını verilen parametreler ile derler.

n n

n
n

n n

n
perlmodules.make()
n
n
perlmodules.make("test")
n

n n

n
n

n n

install (parameters = 'install')

n n

n
n

n n

Perl kaynağını verilen parametreler ile kurar.

n n

n
n

n n

perlmodules.install()

n n

n
n

n n

Pythonmodules

n n

n
n

n n

configure (parameters = "")

n n

n
n

n n

Python kurulum dosyasının (setup.py) yapılandırmasını çalıştırır.

n n

n
n

n n

pythonmodules.configure()

n n

n
n

n n

compile (parameters = "")

n n

n
n

n n

Kaynağı verilen parametreler ile derler.

n n

n
n

n n

pythonmodules.compile()

n n

n
n

n n

install (parameters = "")

n n

n
n

n n

parameters ile belirtilen kaynak için python setup.py install komutunu install dizini içerisinde çalıştırır.

n n

n
n

n n

n
pythonmodules.install()
n
n
pythonmodules.install("--install-lib=/usr/lib/pardus")
n
n
pythonmodules.install("--prefix=/usr")
n

n n

n
n

n n

run (parameters = "")

n n

n
n

n n

parameters ile belirtilen kaynağı python ile işletir.

n n

n
n

n n

n
pythonmodules.run()
n
n
fixCompiledPy (lookInto = '/usr/lib/%s/' % get.curPYTHON())
n

n n

n
n

n n

Derlenmiş Python dosyalarını (.pyc, .pyo) paketten siler.

n n

n
n

n n

n
pythonmodules.fixCompiledPy()
n
n
pythonmodules.fixCompiledPy("/usr")
n
n
pythonmodules.fixCompiledPy("/usr/share/doc")
n
n
pythonmodules.fixCompiledPy("/usr/kde/4/share/apps/frescobaldi/lib")
n

n n

n
n

n n

Scons

n n

n
n

n n

make (parameters = "")

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ile inşa eder.

n n

n
n

n n

n
scons.make('CC="%s" CXX="%s"' % (get.CC(), get.CXX()))
n
n
scons.make("prefix=/usr
n

n n

n
n

n n

DESTDIR=%s

n n

n
n

n n

ash=1

n n

n
n

n n

portaudio=1

n n

n
n

n n

portmidi=1

n n

n
n

n n

oss=0

n n

n
n

n n

optflags="%s"```" % (get.installDIR(), get.CFLAGS()))

n n

n
n

n n

install (parameters = 'install')

n n

n
n

n n

Kaynağı parameters ile verilen parametreler ve PİSİ'nin ön tanımlı kurulum parametreleri ile kurulum dizini içerisine kurar.+

n n

n
n

n n

n
scons.install()
n
n
scons.install("PREFIX='%s/usr' swig_install install" % get.installDIR())
n
n
scons.install("prefix='/usr' destdir='%s' install" % get.installDIR())
n

n n

3.Pisi paketi inşa dosyaları

n n

n
n   |__pspec.xml
n
n   |__actions.py
n
n   |__translations.xml
n
n   |__files
n
n   |__comar
n
n

n n

3.1.actions.py

n n

Bu dosyadaki python kodları, pisi paketi yapılmak istenen yazılımın kaynak dosyasından derlenmesi ve install dizinine sanal bir kurulum yapılması için pisi tarafından çalıştırılır.

n n

Temel Python yapısı

n n

Python kodları kolay yazılıp okunan bir yapıdadır. Bir fonksiyon def fonksiyonadı(argüman1, argüman2): şeklinde, veriler de değişken=veri şeklinde tanımlanabilir. # işaretinden sonra yazılanlar açıklama satırlarıdır. Örneğin;

n n

Yukarıdaki python betiği ekrana “Pisi Linux” yazacaktır. Görüldüğü gibi fonksiyonu kullanırken verilen parametrelerin değeri, fonksiyon tanımında belirtilen değişken adlarıyla fonksiyon içinde kullanılabiliyor.

n n

Burada dikkat edilmesi gereken nokta fonksiyon tanımından sonra fonksiyonun içeriğini oluşturan kodların dört karakter b