Pardus:ActionsAPI

PardusWiki, özgür ansiklopedi

Konu başlıkları

1 Belge Hakkında
2 Actions
3 Actions API
4 Pisitools
- 4.1 dobin
- 4.2 dodir
- 4.3 dodoc
- 4.4 doexe
- 4.5 dohtml
- 4.6 doinfo
- 4.7 dolib
- 4.8 dolib_a
- 4.9 dolib_so
- 4.10 doman
- 4.11 domo
- 4.12 domove
- 4.13 dosed
- 4.14 dosbin
- 4.15 dosym
- 4.16 insinto
- 4.17 newdoc
- 4.18 newman
- 4.19 remove
- 4.20 rename
- 4.21 removeDir
5 Autotools
6 Cmaketools
7 Libtools
8 Shelltools
9 Get
10 Kde
11 Perlmodules
12 Pythonmodules
13 Scons
- 13.1 make
- 13.2 install

[değiştir] Belge Hakkında

Bu belgede Actions API tanıtılmış ve içerisindeki fonksiyonların işlevleri açıklanmış ve örneklendirilmiştir. PİSİ mimarisi ya da PİSİ paketi hazırlama ile ilgili bilgilere yer verilmemiştir. Belge A. Murat Eren tarafından geliştirilmektedir, belgeyi doğrudan güncellemek istemiyorsanız fikirlerinizi lütfen merenpardus.org.tr adresine gönderiniz.

[değiştir] Actions

Bir uygulamanın ikili bir PİSİ paketi haline getirilmesi sürecinde PİSİ'nin inşa (build) 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.

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:

#!/usr/bin/python 
# -*- coding: utf-8 -*-
# 
# Copyright 2005 TUBITAK/UEKAE 
# Licensed under the GNU General Public License, version 2. 
# See the file http://www.gnu.org/copyleft/gpl.txt. 
# 
# Gökçen Eraslan <gokcene{{at}}anadolu.edu.tr>  
     
from pisi.actionsapi import autotools
from pisi.actionsapi import pisitools
from pisi.actionsapi import get 
     
def setup():
    autotools.configure("--enable-nls --bindir=/bin --with-rmt=/usr/sbin/rmt") 

def build():
    autotools.make() 

def install():
    autotools.rawInstall("DESTDIR=%s" % get.installDIR())
    pisitools.dodoc("ChangeLog", "NEWS", "README", "INSTALL")
    pisitools.remove("/usr/share/man/man1/mt.1")
    pisitools.removeDir("/usr/libexec")

actions.py dosyası ile ilgili daha fazla bilgi [1] adresindeki PİSİ Mimari Belgesi'nden alınabilir.

[1] http://www.uludag.org.tr/projeler/pisi/pisi/pisi.html

Bu belgede actions.py dosyası içerisinde uygulamanın yapılandırılması, inşa edilmesi ve paketlenmek üzere kurulumu işlevlerinin gerçekleştirilebilmesi için Actions API tarafından sağlananlar üzerinde durulacaktır.

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.

[değiştir] Actions API

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

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 beklenen tarifin doğru şekilde yapılabilmesi için paket yapıcının, yapmakta olduğu paketi 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.

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:

Autotools: Uygulama derlemek ve kurmak için gerekli olan standart işlevleri sunar.
Cmaketools: cmake ile yapılandırılan uygulamaları derlemek ve kurmak için gerekli olan standart işlevleri sunar.
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.
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.
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.
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.
Kde: KDE uygulamaları için derleme öncesi yapılandırma, derleme ve kurulum işlevlerini sunar.
Perlmodules: Perl modüllerinin kurulumu için gerekli işlevleri sunar.
Pythonmodules: Python modüllerinin derlenmesi, kurulması, çalıştırılması gibi işlevleri sunar.
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.

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.

Actions API kullanımı ya da PİSİ için paket oluşturma ile ilgili sorularınızı [2] adresinden üye olabileceğiniz PiSi E-posta Listesi'nde sorabilirsiniz.

[2] http://liste.uludag.org.tr/mailman/listinfo/pisi

[değiştir] Pisitools

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.

[değiştir] dobin

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

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.

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

[değiştir] dodir

   (destinationDirectory)

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

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

[değiştir] dodoc

   (*sourceFiles)

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.

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

[değiştir] doexe

   (sourceFile, destinationDirectory)

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.

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

[değiştir] dohtml

   (*sourceFiles)

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.

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

[değiştir] doinfo

   (*sourceFiles)

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

pisitools.doinfo("*.info")

[değiştir] dolib

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

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

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

[değiştir] dolib_a

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

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.

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

[değiştir] dolib_so

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

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.

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

insert the static library into /usr/lib with permission 0755

[değiştir] doman

   (*sourceFiles)

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

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

[değiştir] domo

   (sourceFile, locale, destinationFile )

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.

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

[değiştir] domove

   (sourceFile, destination, destinationFile = )

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.

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

[değiştir] dosed

   (sourceFile, findPattern, replacePattern = )

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

pisitools.dosed("gcc/version.c", "<URL:http://gcc.gnu.org/bugs.html>" , "<URL:http://bugs.uludag.org.tr>")
pisitools.dosed("sshd_config", "(?m)(#UsePAM ).*", r"UsePAM yes")
pisitools.dosed("unix/Makefile", "-O3", get.CFLAGS())
pisitools.dosed("Make.Rules", "HAVE_NDBM_H=yes", "HAVE_NDBM_H=no")
pisitools.dosed("Makefile.def", "CC=cc", "CC=%s" % get.CC())
pisitools.dosed("automake.texi", "(?m)(@setfilename.*)automake", r"\1automake1.7")

[değiştir] dosbin

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

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.

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

[değiştir] dosym

   (sourceFile, destinationFile)

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.

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

[değiştir] insinto

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

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, soruceFile için metakarakter kullanılabilir.

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

[değiştir] newdoc

   (sourceFile, destinationFile)

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

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

[değiştir] newman

   (sourceFile, destinationFile)

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

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

[değiştir] remove

   (sourceFile)

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

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

[değiştir] rename

   (sourceFile, destinationFile)

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

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

[değiştir] removeDir

   (destinationDirectory)

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

pisitools.removeDir("/usr/lib")

[değiştir] Autotools

[değiştir] configure

   (parameters = "")

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.

[değiştir] rawConfigure

   (parameters = "", prefix="")

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

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

[değiştir] compile

   (parameters = "")

[değiştir] make

   (parameters = "")

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

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

[değiştir] install

   (parameters = "")

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

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

[değiştir] rawInstall

   (parameters = "")

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

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

[değiştir] aclocal

   (parameters = "")

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

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

[değiştir] autoconf

   (parameters = "")

configure betiğinin yaratılması için çağırılır.

autotools.autoconf()

[değiştir] autoreconf

   (parameters = "")

configure betiğinin tekrar yaratılması için çağırılır.

autotools.autoreconf()

[değiştir] automake

   (parameters = "")

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

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

[değiştir] autoheader

   (parameters = "")

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

autotools.autoheader()

[değiştir] Cmaketools

[değiştir] configure

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

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

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

[değiştir] make

   (parameters = "")

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

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

[değiştir] install

   (parameters = , argument = 'install')

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

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

[değiştir] rawInstall

   (parameters = , argument = 'install')

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

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

[değiştir] Libtools

[değiştir] preplib

   (sourceDirectory = "/usr/lib")

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

[değiştir] gnuconfig_update

   (None)

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

[değiştir] libtoolize

   (parameters = "")

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

[değiştir] gen_usr_ldscript

   (dynamicLib)

[değiştir] Shelltools

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.

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.

[değiştir] can_access_file

   (sourceFile)

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

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

[değiştir] can_access_directory

   (destinationDirectory)

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

[değiştir] makedirs

   (destinationDirectory)

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

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

[değiştir] chmod

   (sourceFile, mode = 0755)

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

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

[değiştir] unlink

   (sourceFile)

Tam yolu sourceFile ile verilmiş olan dosyayı siler.

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

[değiştir] unlinkDir

   (sourceDirectory)

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

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

[değiştir] move

   (sourceFile, destinationFile)

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.

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

[değiştir] copy

   (sourceFile, destinationFile)

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

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

[değiştir] copytree

   (source, destination, sym=False)

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

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

[değiştir] touch

   (sourceFile)

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

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

[değiştir] cd

   (directoryName = )

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

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

[değiştir] ls

   (source)

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.

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

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

        #burada file ile bir şeyler yapın..

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

[değiştir] export

   (key, value)

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

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

[değiştir] system

   (command)

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

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

[değiştir] isLink

   (sourceFile)

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

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

[değiştir] realPath

   (sourceFile)

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

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

[değiştir] baseName

   (sourceFile)

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.

shelltools.baseName(shelltools.realPath(link))

[değiştir] dirName

   (sourceFile)

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).

[değiştir] sym

   (sourceFile, destinationFile)

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

[değiştir] Get

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.

[değiştir] curDIR

   (None)

get.curDIR()

[değiştir] curKERNEL

   (None)

get.curKERNEL()

[değiştir] curPERL

   (None)

get.curPERL()

[değiştir] curPYTHON

   (None)

get.curPYTHON()

[değiştir] pkgDIR

   (None)

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

get.pkgDIR()

[değiştir] workDIR

   (None)

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

get.workDIR()

[değiştir] installDIR

   (None)

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

get.installDIR()

[değiştir] srcNAME

   (None)

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

[değiştir] srcVERSION

   (None)

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

[değiştir] srcRELEASE

   (None)

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)

[değiştir] srcTAG

   (None)

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