Kod Kapsamı ve Gcov ile Lcov Araçlarının Kullanımı

Herkese merhaba bu senenin ilk döneminde bitirme projemde Libreoffice'de birim testlerin geliştirilmesi üzerine çalışmalarım oldu. Şimdi ise Libreoffice'de kod kapsamı üzerinde çalışıyorum.

Bu yazımda;
    • Kod kapsamının ne olduğundan
    • Projelerin kod kapsamı açısından nasıl geliştirilebileceğinden
    • Kod kapsamıyla ilgili kullanılan araçlardan bahsedeceğim.

Kod Kapsamı: Tam olarak bir orandır. Projede var olan testlerin kontrol ettiği kodun, yazılan bütün koda oranına denir. Sonuç olarak bize bir % vermektedir ve bu oranın 100'e yakın olması amaçlanmaktadır. Projelerde kod kapsamını geliştirirken farklı parametreler değerlendirilir. Bunlara bakacak olursak;

• Yazdığımız testler bütün kod için yetersiz olabilir. Projede test edilmeyen kısımlar için ek olarak birim testler yazılmalıdır.

• Projede ölü kodlar bulunabilir bunlar projeden kaldırılmalıdır.

Gcov ve Lcov: Gcov projelerimizi kod kapsamı bakımından test edebileceğimiz bir araçtır, lcov ise bu test sonuçlarını tarayıcıda görmemizi sağlayan bir araçtır. Şimdi bir dosya üzerinde bu araçların kullanımına bakalım.

hello.cpp isimli dosyamızı kod kapsamı testini gcov ile yapalım.

$ g++ -fprofile-arcs -ftest-coverage hello.cpp -o hello 

komutunu çalıştırarak hello.gcno dosyasını oluşturmuş oluruz. Daha sonra

$ ./hello

komutunu çalıştırıp hello.gcda dosyasını oluştururuz. Şimdi

$ gcov hello.cpp

komutu ile dosyamızda kod kapsamı testi yapmış oluruz ve

 

çıktısını almış oluruz. Şimdi lcov kullanımına bakalım.

$ lcov --capture --directory . --output-file hello.info

komutunu çalıştırarak hello.info dosyasını oluşturduk.

$ genhtml hello.info --output-directory .

komutunu çalıştırdıktan sonra klasörümüzde index.html dosyası oluşacaktır. Bu dosyayı tarayıcımızda çalıştırdığımızda;

arayüzü karşımıza çıkacaktır buradan dosyaların kod kapsam oranlarına nerelerde hatalar olduğuna bakabiliriz.

Bir sonraki yazımda Libreoffice'de kod kapsamından, nasıl geliştirlebileceğinden ve benim katkılarımdan bahsedeceğim iyi çalışmalar.

LibreOffice Çalışmalarım - 1

Herkese merhaba bu sene bitirme projemi LibreOffice ile ilgili yapıyorum. Bu yazımda ilk dönemde nasıl işler yaptığımdan bahsedeceğim.

Geçen senenin başından itibaren LibreOffice ile ilgili çalışıyorum. Geçen sene çalışmalarım projenin farklı kısımlarıyla ilgili oldu. Öncelikle süreci öğreten hata kayıtlarına kod göndermekle başladım daha sonra LibreOffice veritabanı aracı olan Base üzerinde çalıştım senenin sonunda 6 tane yama gönderdim.

Bu sene bitirme projemde ise LibreOffice'de birim testler üzerine çalışıyorum. Projede Java ile yazılmış birim testlerin Python ve C++ ortamlarına geçirilmesi isteniyor. Var olan testlerin ise yeni getirilen özellikler ile değiştirilmesi isteniyor.

Python testlerinde değiştirilmesi istenen özellikler vardı. 2 farklı modüldeki python testlerin büyük bir kısmına bu özellikleri kazandırdım ve 10 tane yama gönderdim.

C++ testlerinde ise kod kapsamayı olumsuz yönde etkileyen kod kapsama oranını düşüren kısımların düzeltilmesi ile ilgili çalıştım. LibreOffice'de yazılmış olan kodlardaki kod kapsama oranlarına şuradan ulaşabilirsiniz. Bu konuyla ilgili de 6 tane yama gönderdim.

Bu çalışmalarıma ek olarak LibreOffice projesinde Almanca kullanılan kelimelerin İngilizce'ye çevirilmesi isteniyor. Bu hata kaydını seviyorum doğrusu, çalışmaya ara verdiğim zamanlarda bununla ilgili çalışıyorum :) Bu konuyla ilgili de 3 tane yama gönderdim.

LibreOffice deposuna gönderdiğim yamaların linklerine şuradan ulaşabilirsiniz.
 
İyi çalışmalar.

ODC İş Çözümleri Yaz Stajı

Herkese merhaba, ikinci stajımı bu yaz ODC'de yaptım ve bu süre içerisinde kazanmış olduğum deneyimlerimi paylaşmak istedim.

Stajım iki ay sürdü. İlk ayda Swagger üzerine çalıştım. Bir rest apinin nasıl Swagger uyumlu hale getirileceğini öğrendim. Diğer Swagger araçlarını (Swagger Codegen, Swagger UI, Swagger Core ) da öğrenip üzerinde çalıştığım projede uyguladım. Swagger çalışmalarıma ek olarak ilk ayda Bootstrap öğrendim. Uygulama olarak Bootstrap ile bir form oluşturdum, bu formdaki girilen bilgileri bir servise gönderdim. İkinci ayda ise JUnit üzerine çalışmalar yaptım. 1 ay boyunca birim test ile ilgilenmem çok faydalı oldu benim için. Büyük çaplı projelerdeki birim testin önemini anlamış oldum. Nelerin test edilmesi gerektiğini, hangi amaçla test edildiğini öğrenmiş oldum.

Staj maceramın :) neler yaptım kısmı böyleydi. Şimdi duygu ve düşüncelere geçmek istiyorum.

Staj çıkışında metrobüste eve dönerken; akşama hangi konulara bakmam gerektiğini ve o gün neler öğrendiğimi düşündüğümde doğru yolda olduğumu anladım :) Tam bunu anladığımda Eluveitie - Vianna şarkısı çalıyordu. Beni motive eden parçalardan birisidir dayanamadım sizle de paylaştım.

Kavacık ciddi anlamda çok güzel e-si-yor-du :) Öğle aralarımız çok eğlenceli geçiyordu.

Stajda aklıma gelen her soruyu sorduğumda göstermiş oldukları sabırdan dolayı :) +Serdar Yiğit +ibrahim halil altun , Sinan Dirlik ve Nevra Aşuk'a çok teşekkür ederim. Bana yapmış olduğunuz bütün tavsiyeleri ve uyarıları dikkate aldım. Çok güzel zamanlardı benim için özlüyor insan :( İlk defa bir yazımda bu kadar duygusal cümleler kuruyorum :)

Stajda olduğum süre içerisinde bana yardımcı olan herkese ve ODC'ye teşekkür etmek istiyorum.

Son olarak stajımla ilgili sevdiğim sloganım "More than an Internship :) "

Birim Test ve JUnit Kullanımı

Herkese merhaba, bu yazımda Birim Test ve Java'nın bir kütüphanesi olan JUnit'den bahsedeceğim. Yazının içeriğine alt başlıklar halinde şöyle bir bakacak olursak;

• Birim Test nedir?
• Yazılım Projesinde Birim Test'in Önemi nedir?
• JUnit nedir? - Junit'de kullanılan assertion / annotation kavramları nelerdir?
• Eclips'de JUnit oluşturulması ve çalıştırılması nasıl olur?

    Birim Test
En basit anlamda projemizdeki fonksiyonların çalışıp çalışmadığını kontrol eder. Birden fazla birim testimiz olabilir fakat hepsi birbirinden bağımsız çalışmalıdır. Yani her test için odaklanılan tek nokta vardır. Testler sonuç olarak bize true / false döndürürler.
Birim Test hataları bulmak için kullanılmaz, bizim verdiğimiz girdiler ile fonksiyonun çalışırlığını kontrol eder.
Projemizde kaç tane fonksiyon varsa o kadar test olmalıdır.
Birim Test nedir? sorusuna cevap bulduktan sonra şimdi neden kullanılıra gelelim;

    Yazılım Projesinde Birim Test'in Önemi nedir?
Bize kaliteli kod yazmamızı sağlar. Projeyi geliştirme esnasında yanlışlarımızı görmemizi sağlar. Bütün bileşenleri birbirinden bağımsız bir biçimde tasarlamış oluruz. Böylelikle bakımı daha kolay ve kaliteli bir yazılım ortaya çıkar.
Şimdi Java'da test olayına bakalım;

    JUnit nedir? - Junit'de kullanılan assertion / annotation kavramları nelerdir?
Projemizde bulunan fonksiyonların doğru çıktı verip vermediğini kontrol etmemize yarayan Java kütüphanesidir. Testimizin çalışabilmesi için öncesinde ve sonrasında olması gereken işlemler olabilir. Örnek olarak test edeceğimiz fonksiyonun çalışabilmesi için bir veritabanı bağlantısı gerekiyorsa bunu testten önce sağlamamız gerekir. Böyle durumlarda annotation kullanırız. Testlerde kullanılan annotation'lara bakarsak;

@Test :  Metodun test edileceğini gösterir
@Test(expected = Exception.class) :  Metod hata fırlatmalıdır
@Before : Metodtan önce çalışır.
@After :  Metodtan sonra çalışır
@BeforeClass : Sınıf instance olduğunda bir defalığına çalışır
@AfterClass :  Metodları test ettikten sonra çalışır
@Ignore : Test edilmesini istemediğimiz metodları temsil eder

Test ettiğimiz fonksiyonların dönüş değerlerine göre durum karşılaştırmaları yaptığımız assertionlar vardır.
Bunların kullanımına bakacak olursak;

public class OrnekTest{
 
 @Test
 public void tabikiTest(){
  String name = "Kerem";
  assertEquals(name, OrnekSinif.getPersonName());
 }
}

OrnekSinif(nasıl bir sınıf ismiyse :D )'ın getPersonName() fonksiyonundan dönen isim ile bizim oluşturduğumuz ismi karşılaştırıyoruz.
assertEquals() metodu bu iki değer doğruysa test sonucunu true olarak döndürecektir.
Birçok assertion bulunmaktadır bunların tam listesi.

Şimdi artık Eclips'te bir JUnit oluşturup, çalıştırmaya bir bakalım:

 Öncelikle projemize JUnit bağımlılıklarını ekliyoruz.

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>

  New → Other → JUnit → JUnit Test Case 
Daha sonra testimizin ismini belirleyip Finish diyoruz.

import org.junit.Test;


public class TestOrnek {

 @Test
 public void test() {
  fail("Not yet implemented");
 }
}

Oluşan testimizin içeriği böyle oluyor.
Burada @Test kısmına girdileri verip sonuçların doğruluğunun kontrolünü yaparız.

Şimdi bu testimize örnek bir uygulama yapalım.

import static org.junit.Assert.*;
import org.junit.Test;

public class TestOrnek {
 public int topla(int x, int y){
  int sonuc = 0;
  sonuc = x + y;
  return sonuc;
 }
 @Test
 public void test() {
  int sonuc=0;
  sonuc = topla(5, 10);
  assertEquals(15, sonuc);
 }
}

Burada eğer topla fonksiyonumuzun sonucu 15 ise testimiz true olarak dönüş yapacaktır.

Testimizin çalışırlığını böylece kontrol etmiş oluruz.
İyi çalışmalar.

Bootstrap Kullanarak Form Oluşturmak

Herkese merhaba, web kütüphanelerinden biri olan Bootstrap ile girilen bir json formatını kullanarak form oluşturmaktan bahsedeceğim.

Öncelikle Bootstrap'in ne olduğu hakkında bir şeyler söyleyecek olursam;

Bootstrap; HTML, CSS ve JS'i bir arada bulunduran ve bunları kullanarak web arayüzü geliştirebildiğimiz bir kütüphanedir.
CSS'e ek olarak CSS önişlemcisi olan Less ve Sass'ı kullanır.

Bootstrap açık kaynaklı bir kütüphanedir. Github projesine buradan bakabilirsiniz.

Bootstrap sayfasında birçok uygulayabileceğimiz örnekler bulunmaktadır.

Şimdi bir json girdisine karşılık gelen formumuzu oluşturalım.

1-) İlk adım olarak formumuzda hangi alanların oluşmasını istiyorsak o alanları json formatında javascript kodumuzun içerisinde belirtiyoruz.

var fields, form;

fields = [ 
    {
        name: 'username',
        label: 'Username',
        type: 'text'
    }, {
        name: 'password',
        label: 'Password',
        type: 'password'
    }, {
        name: 'fruit',
        label: 'Fruit',
        choices: [
            ['apple', 'Apple'],
            ['pear', 'Pear'],
            ['orange', 'Orange']
        ],
        type: 'selectmultiple2' 
     }, {
        label: 'Submit',
        type: 'submit',
        class: 'btn-danger',
        icon: 'ok'
    }];


2-) Daha sonra bu json girdisini alıp alanlarıyla form oluşturabileceğimiz formata çeviriyoruz.

fields = JSON.stringify(fields);
        fields = formatter.formatjson(fields);
        demoInput = $('#form-demo-input');
        demoInput.val(fields);
          
        outputForm = $('#form-demo-output');
        outputForm.submit(function() {return false});

Bu işlemleri gerçekleştirdiğimizde formumuz şekildeki gibi oluşur;


Kodun tamamı ve uyguladığım örneğe linkten ulaşabilirsiniz.
İyi çalışmalar ve kolaylıklar dilerim.

Rest Api'yi Swagger Uyumlu Hale Getirmek

Herkese merhaba, bu yazımda bir Rest Apinin Swagger uyumlu hale getirilmesindeki adımlardan bahsedeceğim. Neleri eklememiz gerektiğinden, hangi özellikler için hangi metodları kullandığımızdan bahsedeceğim.

*Swagger-UI: 
Bir bağımlılığa sahip değildir, kendi yerel makinemizde çalıştırabiliriz. Apinin swagger uyumlu hale geldikten sonraki görüntüsüne örnek olarak petstore uygulaması verilebilir.

Şimdi apiyi swagger uyumlu hale getirmek için izlenecek adımları sırayla uygulamaya başlayalım.

1-)Öncelikle apimizde bulunan pom.xml dosyasının içine gereken bağımlılıkları ekliyoruz.

<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-jaxrs</artifactId>
    <version>${swagger-version}</version>
    <scope>compile</scope>
</dependency>

2-) Daha sonra buradan Swagger-ui paketini indiriyoruz.

-> Bu indirdiğimiz paketin içindeki dist klasörünün içindeki bütün dosyaları kopyalıyoruz.
-> Projemizin içinde src/main/webapp içine bir swagger klasörü oluşturalım. Kopyaladığımız bütün dosyaları bu klasörün içine yapıştıralım.

3-) Şimdi de webconfig.java dosyamızın içine port bilgisi, url bilgisi, uygulama adı gibi swaggerı servera tanımlayacak bilgileri giriyoruz.

4-) Şimdi ise apimizi swagger uyumlu hale getirebilmek için kod içeriklerinde değişiklikler yapıyoruz.

Bu kısımda birçok ek açıklamalar kullanıyoruz.

@Api: Başına getirilen sınıfı bir swagger kaynağı olarak işaretler.

@ApiModel: Swagger modelleri hakkında bilgiler eklememizi sağlar.

@ApiOperation: Özel olarak belirlediğimiz bir yola karşılık gelen bir tanımlama yapar.

@ApiParam: İşlemdeki parametreleri tanımlarız.

@ApiResponse: İşlem sırasında oluşabilecek hataları tanımlarız.

Tüm bunları gerçekleştirdikten sonra şekildeki gibi bir görüntü çıkar.

Burada petstore uygulamasının Pet, Store ve User modellerinden User'ın içindeki işlemler yer almaktadır.

Bu uygulamanın kaynak kodu şu adreste bulunmaktadır.
 İyi çalışmalar dilerim.

Swagger-Codegen ile Kod Oluşturma

Selamlar, bu yazımda Swagger araçlarından biri olan Swagger-Codegen ile var olan bir apiyi generate etmekten bahsedeceğim.

Öncelikle Kod Oluşturma nedir bunu açıklayacak olursam;
Var olan kodlara kod yazma yeteneği kazandırma işlemidir diyebiliriz. Örneğin elimizde herhangi bir dilde yazılmış bir api var. Biz bunu başka bir dile çevirmek istiyoruz. Bu noktada Kod Oluşturma yapmamız gerekmektedir. Birçok dilde bu işleme özel araçlar bulunmaktadır.

Ben bu yazımda bahsettiğim örneği açıklayacağım. Bir dilde yazılmış örnek bir apiyi Swagger-Codegen aracını kullanarak başka bir dile generate edilişinden bahsedeceğim.

*Swagger-Codegen

 Apiyi generate ederken Java kullanacağım.

-> Öncelikle Swagger-Codegen .jar dosyasını buradan indirmemiz gerekiyor.

-> Daha sonra aşağıdaki komutları sırasıyla uygulayarak elimizde bulunan apiyi istediğimiz bir dile çevirebiliriz.

$ git clone https://github.com/swagger-api/swagger-codegen

$ cd swagger-codegen

$ mvn clean package

$ java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar
        generate \
    -i  http://petstore.swagger.io/v2/swagger.json \
    -l  php \
    -o /var/tmp/php_api_client

Adımlarını takip ederek apiyi php dilindeki haline generate etmiş oluruz.

Buradaki parametrelere bakacak olursak;
i: Apinin .json linki
l: Generate etmek istediğimiz dil
o: Generate etmek istediğimiz yerin uzantısı

Hangi dillere generate edebileceğimizi öğrenmek için;

$ ls -1 modules/swagger-codegen/src/main/java/io/swagger/codegen/languages/

Daha fazla bilgiyi Swagger-Codegen Github sayfasından edinebilirisiniz.
Umarım faydalı olmuştur iyi çalışmalar.

Swagger ve Araçları

Herkese merhaba, bu yaz stajında Swagger ile ilgili çalışmalar yapıyorum. Bu süreçte öğrendiğim konulardan bahsetmek istedim.

*Öncelikle  Open API Initiative'den bahsedecek olursam;
Linux Foundation altında açık denetimli bir yapı olarak oluşturulan, gelişmekte ve yükselişte olan bir tanımlama formatıdır. Swagger Specification doğrudan Open Specification'ın temeline dayanarak OAI'ye eklenmiştir.

*OpenAPI Specification(The Swagger Specification);

OpenAPI Specification'ın hedefi; insanların ve bilgisayarların anlayabilmesi için REST API'lerin arayüzlerine dilden bağımsız bir standard tanımlamaktır. OpenAPI var olan bir apiyi tekrar yazmamamızı sağlar ama OpenAPI Specification'ın yapısında tanımlanmış servislerin yeteneklerini belirlemek gerkir.

*Swagger nedir ve hangi amaçla kullanılır?

Swagger; REST Apilerin web ortamında kullanıcılara daha basit ve kullanışlı bir şekilde sunulmasını sağlar. Birçok dile frameworkü bulunmaktadır.
Bir diğer avantajı, herhangi bir dilde yazılmış bir REST Api'yi başka bir dile dönüştürmeye uygundur( Code Generation ).

Bu proje içinde kendi araçlarını barındırır. Bunları inceleyecek olursak;

*Swagger Core: Swagger'ın bir Java uygulamasıdır diyebiliriz. Github'ta uygulamalı olarak Java ile bir Swagger uygulaması bulunmaktadır.

*Swagger Codegen: Bir dilde yazılmış REST Api'leri istediğimiz dile dönüştürme işlemine yardımcı olur. Bunun java dili yardımıyla yapılışı Github'ta bulunmaktadır.

*Swagger UI: Swagger uyumlu hale getirilmiş Api'yi kullanıcıya sunan bir araçtır. Bu aracın da uyarlanışı Github'ta bulunmaktadır.

*Swagger Editor: Swagger tanımlamalarını YAML veya JSON formatta oluşturur. Sitesinde bulunan api'yi Generate Client bölümünden istediğimiz dile çevirebiliriz. Swagger Codegen'in yaptığı işlem buna karşılık geliyor. Bu uygulama konuyu anlamak için faydalı oldu benim için.
Uygulama linki  

*Swagger IRC

Peki her şeyi tasarladık adımları uyguladık kullanıcıların karşısına nasıl bir görüntü çıkacak;

Şekilde görüldüğü gibi uygulamadaki bir bölümle iligli işlemler kullanıcıya listelenmektedir. Kullanıcı istediği işlemi gerekli parametreleri girerek gerçekleştirebilir.

Bu yazımda Swagger'ın ne olduğundan, araçlarından, hangi kolaylıkları sağladığından bahsettim. Bir sonraki yazılarımda araçların nasıl kullanıldığından ve bir apinin Swagger uyumlu hale nasıl getirildiği hakkında yazacağım.
Görüşmek üzere.

LibreOffice Hackfest 2016 - Ankara

Herkese merhaba, bu sene Ankara'da TÜBİTAK-ULAKBİM tarafından bir Hackfest gerçekleşti.

Etkinlik heyecan vericiydi benim için. Çünkü LibreOffice geliştiricilerinden Michael Meeks, Marcus Mohrhard ve Jan-Marek Glogowski'de katıldılar.

İlk gün geliştiricilerin yaptığı sunumları dinledik. Bu sunumlar bana birçok şey kattı. Çünkü yeni bakış açılar kazanıp, çalıştığımız alanın bilmediğimiz inceliklerini öğrendik.

Sonraki 2 günde uğraştığım iki tane hata kaydı üzerinde çalıştım. Çalışırken takıldığımız yerlerde geliştiricilere sorup o an halletmek çok iyi oldu.

Ben LibreOffice Base bileşeni üzerinde çalışıyorum. Bununla ilgili Michael Meeks'e merak ettiğim bütün soruları sordum. Etkinliğin en iyi yönlerinden birisi de buydu benim için; o an merak ettiğim ya da takıldığım konuyu geliştiricilerle çözmek.

Etkinliğe çalışmaktan büyük keyif aldığım Çanakkale ekibi ile katıldım :)

Etkinlikte sabahtan akşama kadar kodlama yaptık ama keyifimiz gayet yerindeydi. Çünkü çalışma performansımızdan memnunduk :)

Etkinliğe katılmam beni hem mutlu edip hem de birçok şey kattı.
Öncelikle +Necdet hocama, TÜBİTAK-ULAKBİM'e, orada tanıştığımız Muhammet Kara ve Gökhan Gurbetoğlu'na, tabiki yurt dışından gelen Michael Meeks, Marcus Mohrhard ve Jan-Marek Glogowski'ye çok teşekkür ediyorum.

Yakında görüşmek üzere :) 

Özgür Yazılım ve Linux Günleri - 2016

Herkese merhaba, Özgür Yazılım ve Linux Günleri bu sene 26-27 Mart tarihlerinde İstanbul Bilgi Ünversitesi'nde gerçekleşti. Etkinliğe ilk defa bu sene katıldım.

Neden daha önceden katılmadığımı kendime birçok kez sordum :) Çünkü oradaki ortam çok mutlu etti beni. Yeni insanlarla tanışmak yeni bilgiler öğrenmek farklı bakış açıları kazanmak insana çok fayda sağlıyor.

Etkinlikte dinlediğim beni en çok etkileyen sunum +Necdet Yücel  ve +Kaan Ozdincer 'in "Yine Yeniden Özgür Yazılım" sunumuydu. Özgür Yazılım ile ilgili doğru bilinen yanlışlar, eksik kalan tanımlamalar, bu alanda nelere dikkat etmemizin gerektiği gibi daha birçok şey öğrenmiş oldum. Bunlar benim için teknik bir bilgiden daha önemliydi. Çünkü benimsediğim ve çalışmayı istediğim bir alan hakkında en ince ayrıntıya kadar bilgi sahibi olmuştum. Böylece hayatımda etkisi çok fazla olan bir 45 dakikaydı benim için :)

Bir başka severek dinlediğim sunum ise +Aydan Taşdemir 'in "Pgbarman ile PostgreSQL Yedekleme" sunumuydu. LibreOffice Base bileşeni üzerinde çalıştığım için veritabanıyla ilgili bir sunum dinlemek çok iyi oldu benim için. Özellikle şu anda uğraştığım iş PostgreSQL ile ilgili olduğundan bu sunum bana çok faydalı oldu. PostgreSQL ile ilgili yeni bir özellik öğrenmiş oldum.

Biz yine Çanakkale'den kalabalık bir ekiple geldik. Bu etkinliğin benim açımdan önemi ayrı bir büyüktü. Çünkü sunumlardan birisini biz yapacaktık, içimde sadece o an tanımlayabileceğim bir heyecan vardı :)

Bizim sunumumuz "LibreOffice Geliştirme ve Yaygınlaştırma" toplantısı şeklinde gerçkleşti. 13 kişilik büyük bir ekip olarak bugüne kadar yaptığımız çalışmalardan bahsettik. Kendi söylediklerimde ve arkadaşlarımı dinlerken şunu farkettim; gerçekten süreç çok fazla çalışmayı gerektiriyor. Bir iş üzerinde haftalarca hatta aylarca pes etmeden ısrar etmek gerekebiliyor. Ama sonunda kazanılan bilgiler ve çalıştığınız işi bitirdiğinizi görmek aşırı mutluluk veriyor :)

Bir sonraki yazıma kadar daha çok çalışıp sizlere daha iyi haberler vermek istiyorum görüşmek üzere :)

AB2016 - LibreOffice Geliştirme Atölyesi

Bu sene Akademik Bilişim Aydın Adnan Menderes Üniversitesi'nde gerçekleşti. Etkinlikte 4 gün süren eğitimler ve sonrasında 3 gün konferanslar yapıldı.

Biz Çanakkale'den kalabalık bir ekiple "LibreOffice Geliştirme Atölyesi" eğitimine katıldık. 4 gün boyunca sabah 9 - akşam 6 saatleri arasında çalışmak benim için çok faydalı oldu. 4 gün boyunca LibreOffice deposuna gönderdiğim 2 yamam alındı :) bunların linkleri Link1 ve Link2 

Eğitimde her gün kendime bir şeyler katarak ilerledim. Biten günün sonunda yeni bilgiler öğrenerek yurda gitmek gerçekten çok mutluluk verici oluyor. Sabah bir de yama kabul mailiyle uyanmak +1 mutluluk oluyor :)

Çalışırken bir yerde takıldığımızda soru sormak istediğimizde hemen yardımımıza koşan sabırla bizleri dinleyen :) +Gülşah Köse , +aybüke özdemir , +Berk Güreken ve +yeliz taneroğlu eğitmenlerimize teşekkür ediyorum.

Bu organizasyonda emeği geçen +Mustafa Akgul ve +Necdet Yücel hocalarıma çok teşekkür ederim.

Çok çalışmak gerçekten çok mutluluk verici :)

Packathon Macerası

23 Ocak tarihinde İstanbul'da Bahçeşehir Üniversitesi'nde gerçekleşen Packathon etkinliğine Kripton ekibi olarak katılmaya karar verdik. Etkinlikle ilgili bilgiye buradan ulaşabilirsiniz.

Etkinlikte çalıştığım ekip arkadaşlarımla 1 gün boyunca öyle bir ortamda çalışmak bana çok şeyler kazandırdı. Günün başlangıcında ekip olarak görev paylaşımında bulunduk. Üzerime düşen görevi yapmam gerektiğinin bilinciyle insan çalıştığından daha fazla çalışıyor. Hepimiz çok çalışıp hedeflediğimiz işleri yerine getirdik. Günün sonunda böyle sonuçlar görmek insanı çok fazla mutlu ediyor ve daha çok çalışma isteği kazandırıyor.

Gün içerisinde çalışırken sürekli meslek hayatımda da böyle bir ortamda olmanın beni mutlu edebileceğini düşündüm. Çünkü üzerinde çalıştığım alan keyif veriyor, birlikte çalıştığım arkadaşlarla o alanda çalışmak gerçekten çok keyifli oluyor. Tatil gününde dışarda kar yağarken birlikte kod yazmak gerçekten çok mutlu edici :) 

Etkinliğinin düzenlenmesinde emeği geçen herkese teşekkür ediyorum. Beni çok mutlu eden etkinlikten sonraki duygularımı paylaşmak istedim ve tabiki bir gün boyunca benimle birlikte çalışan ekip arkadaşlarıma da teşekkür ediyorum. 

O günden çok sevdiğim bir fotoyu paylaşmak istiyorum ( Gerçekten haberimiz yoktu :) ) 

PROMOQUBE Yaz Stajı (for Ruby :D ) 

Aslında yaz stajlarının hiçbir zaman faydalı geçmediği bir şey yapılmadığı konusunda neredeyse herkes hem fikirdir. Hatta boş boş oturarak geçer 20 iş günü :) Benim geçen seneki yaptığım stajda aynen bu şekilde olmuştu o yüzden biraz akıllanmıştım. Bu sefer farklı olmalıydı bazı şeyler.

Bir gün yine Ruby çok öğrenme aşkıyla doldum ve Ruby-tr mail grubuna mail attım "Yaz için stajyer arayan var mı?" diye :) Geriye dönüşler oldu pek umudum yoktu ama her şey beklediğimin tersine gitti. Gayet güzel oldu her şey. Memnun kaldım stajımın sonunda. 

Ruby bilgim 2014 Akademik Bilişim'de 4 günlük eğtimde ne aldıysam o kadardı. Daha sonraları hoby olarak üstüne gide gide bir şeyler öğrendiğimleydi. 

Promoqube'de Ruby ile ilgili (bana göre) çok büyük işler yapmaya çalıştım. Her gün yeni bir şeyler öğreniyordum her öğrendiğimi yazıyordum. Unutmayayım kalıcı kalsın ileriki zamanlara da kalsın diye. Stajım böylelikle baya faydalı geçti. 

Uludağ sözlük için bir web parser yazdım. Staj bittikten sonra şimdiki hedefim bir türlü öğrenmeye cesaret edemediğim Rails'i öğrenmek :) Umarım onda da güzel şeyler yaparım ve Ruby ile çalışmalarıma devam ederim.

Staj yapıcak arkadaşlara tavsiyem; github hesabınızda birşeyler olsun en azından, blog yazmıyorsanız acilen bir şeyler yazın ve "Özgür Yazılım ulan!" diyin dikkat çekiyorsunuz zaten :) 

Çünkü staj mülakatında birçok konu üstüne konuştuk fakat karşımdaki insanların merak ettiği şeyler; "Python nerde öğrendin?" "Ne zamandır Ubuntu kullanıyorsun?" "Neden Özgür Yazılım düşünüyorsun?" ve anladım ki bu alanda gerçekten bir şeyler öğrenmek istedikçe kapılar her zaman açılıyor. En şaşırtıcı noktada en son soru olarak "Okulun neydi?" dediler bir kez daha anladım bizim meslekte okul ve nottan çok neyi yapabiliyor olduğunun daha önemli olduğunu.

Staj yapıyor olan ve yapacak olan arkadaşlara başarılar dilerim şimdiden :)

Son olarak meşhur Promoqube Logosu :)

Ruby ile Kendimize Özel Gem Oluşturmak

Bu yazımda Ruby de kendi istediğimiz işlevleri programda yerine getiren bir gem oluşturmaktan bahsedeceğim.

Ruby çok sayıda büyüleyici ve kullanışlı kütüphanelere sahiptir, bir çoğu klasik gem dosyası olarak yayınlanmıştır. Diğer kütüphaneler kaynak kodunun .zip ya da .tar.gz arşivlenmişi olarak yayınlanır.

Şimdi öncelikle bir ekrana "Merhaba naber nasılsın :) " yazdıran ruby kodumuzu tasarlayalım.

Tamam şimdi bu işlevi yerine getirecek bir gem dosyamızı oluşturalım. Bunun uzantısı .gemspec olmalıdır. Onun kodu da aşağıdaki gibidir:

Artık kodlarımız hazır. Terminali açıp aşağıdaki kodu yazdığımızda gem'i oluşturmuş oluyoruz.

Evet oluşturduğumuz gemi install edelim. Onu yapmak için konsola;

% sudo gem install ./merh-0.0.0.gem komutunu yazıyoruz.

Artık kendi oluşturduğumuz gem yüklenmiş oldu istediğimiz ruby koduna require ederek kullanabiliriz. Yapmamız gereken tek şey .rb uzantılı ruby kodumuzun başına;

>>  require 'merh' yazmaktır.

Ben bu işlemleri ilk öğrendiğimde çok keyif almıştım çünkü istediğimiz işleri yaptıran kendimize özel bir gem oluşturarak çok farklı şeyler yapabiliriz. Bu başlangıç olarak size örnek göstermek istediğim bir gemdi. Umarım ilgilenenlere faydalı olmuştur. 

Redis & Redis-rb

Redis: Veriyi key-value şekilde hafızada tutar. Açık kaynaktır. Redis geçici olan hiçbir şeyi veritabanında gereksiz yere yazmaz. Çeşitli veri yapıları kullanmaya izin verir. Yüksek performanslı cacheing mekanizmasına sahiptir. Veriyi RAM'de tutar ancak istenen aralıklarla veriyi diske kaydedebilir. Belirli periyotlarda aklında tuttuğu verileri bir dosyaya yazdığı için veri kaybı söz konusu değildir.

Memcached'den farklıdır. Memcached sadece veri girişi ve çıkışı yapar. Veriyi RAM'de tutar ancak veriyi dosyaya yazamaz.

Redis github üzerinde in-memory nosql veritabanıdır.

Kullandığı veri yapıları "string, hashes, lists, bitmaps vb."

Destekleyen diller; C, C#, C++, Clojure, Common Lisp, D, Dart, emacs lisp, Erlang, Fancy, Go, Haskell, haXe, Io,  Java, Lua, Node.js, Objective-C, Perl, PHP, Pure Data, Python, Ruby, Scala, Scheme, Smalltalk, Tcl.

Redis-rb

Yukarda Redis'i tanımladıktan sonra şimdi de Ruby'de Redis işlemlerinden bahsetmek istiyorum.

Her zaman olduğu gibi öncelikli olarak Redis'i require etmemiz gerekir:

>> require "redis"

Redis sınıfı tarafından Redise bağlanmak istersek:

>> redis = Redis.new

Eğer bir naklen serverı veya farklı bir porta bağlanmaya ihtiyaç duyarsak:

>> redis = Redis.new(:host => "10.0.1.1", :port => 6380, :db => 15)

Ayrıca özel bağlantı ayarları olan bir URL'ye bağlanabiliriz:

>> redis = Redis.new(:url => "redis://:p4ssw0rd@10.0.1.1:6380/15")

Bir Unix sokette redis dinlemek için bağlanabiliriz:

>> redis = Redis.new(:path => "/tmp/redis.sock")

Bir password korumalı redis örneğine bağlantı için:

>> redis = Redis.new(:password => "kerem3434")

-Redis sınıfı aynı isimlendirilmiş metodları dışa aktarır. Verilen komutlarla çalışırlar.

-Redis websitesinde özel olarak hazırlanmış argumentler kullanılır. Bakmak için tıklayınız.

Bunlara örnek olaran SET ve GET komutlarına bi bakalım.

>> redis.set("mykey", "kerem hallac")

# => "OK"

>> redis.get("mykey")

# => "kerem hallac"

Sentinel Support

Performansı otomatik üstlenme işini Redis Sentinel ile yaparız. Sentinele bağlanma;

>> SENTINELS = [{:host => "127.0.0.1", :port => 26380},

{:host => "127.0.0.1", :port => 26381}]

>> redis = Redis.new(:url => "redis://mymaster", :sentinels => SENTINELS, :role => :master)

-Redis stringler isadece değer olarak depolar. Eğer bir nesne depolamak istersek,  JSON require edip kullanmamız gerekmektedir.

>> require "json"

>> redis.set "foo", [1, 2, 3].to_json

# => OK

>> JSON.parse(redis.get("foo"))

# => [1, 2, 3]

Pipelining

Çoklu komutları sıralı bir şekilde çalıştırdığımız zaman, fakat bağımlı olmadan, pipelined çağırılabilir. Bu istemci bir sonraki komutun gönderilmesinden  önce ilk komutun cevabı için beklemez. 

Bunun avantajı çoklu komutlar gönderildiğinde dönüş yüksek hızlı bir çalışmada sonuçlanır.

>> redis.pipelined do 

>>     redis.set "foo", "bar"

>>     redis.incr "baz"

>> end

# => ["OK", 1]

Bir atomik oluşumda numaralı komutları çalıştırabilmek için MULTI/EXEC kullanılır. Pipeline çalışmasına benzerdir. Cevaplar multi metodu tarafından döndürülülür.

>> redis.multi do 

>>    redis.set "foo", "bar"

>>    redis.incr "baz"

>> end

# => ["OK", 1]

Bir şey yolunda gitmiyorsa exception çevirmeliyiz.

>> begin 

   redis.ping 

>> rescue Exception => e 

   e.inspect

# => #<Redis::CannotConnectError: Timed out connecting to Redis on 10.0.1.1:6380>

   e.message

# => Timed out connecting to Redis on 10.0.1.1:6380

>> end

Daha fazla bilgi için ---->> https://github.com/keremh/redis-rb

Redis hakkında söylemek istediklerim bu kadar umarım isteyen kişilere faydalı olmuştur. Son olarak Redis'in efsane fotoğrafıyla yazımı sonlandırıyorum :) 

Ruby ile Unit Testing

Yazılan bir Ruby kodunun nasıl test edileceğinden bahsetmek istedim. Bu test aşaması sonunda kodun çalışmasında sonuç olarak kaç tane iddia var, kaç tane arıza var,  kaç tane hata var, kaç tane atlama var bunların sonucuna ulaşmış oluruz.

Unit Testing: Yazılım programlamasında bir yazılım tasarımı ve geliştirme yöntemidir. Bu yöntemde yazılımcı yazılım kodunu oluşturan birimlerin kullanıma hazır olduğuna ikna olur.

Şimdi bir SimpleNumber isimli içinde iki sayıyı toplayıp çarpan iki tane metod bulunduran basit bir sınıf oluşturalım:

Şimdi bu kodun doğruluğuyla alakalı bir test kodu hazırlayalım..

Bu yazdığımız Testi terminalde çalıştırdığımızda alıcağımız çıktı şu olucaktır:

Bu testin sonunda istediğimiz bilgilere ulaşmış oluruz.
Bize daha fazla bilgilerin vermesini isteyebiliriz bir Test sonucunun daha kompleks bir kod tasarlıycak olursak:

Bu Test kodunu çalıştıracak olursak alıcağımız çıktı şöyle olucaktır:

Ruby'de bu Test aşamasını yukarıdaki kodlarda da kullandığımız birtakım assertionlarla sağlarız.

Onlardan birkaç tanesi bu şekildedir. Tablonun tamamına ulaşmak için tıklayınız.

Ruby ile ilgili yazmış olduğum Unit Test yazımın sonuna geldik. Okuyup vakit ayırdığınız için teşekkürler umarım faydalı olmuştur ilgilenenlere görüşmek üzere :)

Nokogiri ile HTML/XML Dökümanlarını Parsing İşlemi

Bir önceki yazımda bir web sitesini Request ve Respond işlemlerinin nasıl yapıldığından bahsetmiştim. Bu işlemlerin ardından o web sitesinde istediğimiz bir kısmı Parse etme işleminden bahsedicem bu yazımda. 

Nokogiri: Nokogiri bir HTML, XML, SAX ve Okuyucu Parserıdır. Ruby'nin Gem listinin içinde yer alır. Dökümanların çekimi sırasında CSS ve XPath ayırıcılarından yardım alır.

HTML: Web sayfalarını oluşturmak için kullanılan standart metin işaretleme dilidir.

XML: Hem insanlar hem bilgi işlem sistemleri tarafından kolayca okunabilecek dökümanlar oluşturmaya yarayan bir işaretleme dilidir.

SAX: XML dosyalarını olay tabanlı, sözcüksel işlemedir. Dosya içerisindeki her düğüm bir geri-besleme fonksiyonu aracılığı ile istemci koda yansıtılır.

CSS: HTML'e ek olarak metin ve format biçimlendirme alanında fazladan olanaklar sunan bir Web teknolojisidir.

XPath: XML dökümanındaki bir bilgiyi bulmak için kullanılan bir dildir. XML dökümanı içindeki elemanları ve onlara ait özellikleri incelemeye yarar.

Nokogiri Kurulumu:

Bu komutu terminale yazdığımızda nokogiri eğer yüklü değilse yüklemiş oluruz.

Kullanımı için gerekli 'require' işlemleri:

Kodun başına mutlaka nokogiri ve open-uri gem'lerini require etmemiz gerekir.

HTML dökümanını parse etme:

Bu komut ile verilen linkteki entry'i fetch etmiş oluyoruz. Sonraki adımda da bu entry içindeki yorumlardan istediğimiz birisini parse edeceğiz.

Parse etmeyi istediğimiz yorumun içinden bir kelimeyi seçip sağ tıklayıp "Öğeyi Denetle" deriz.

Burada işaretli kısımdaki id içeriğini altta gösterilen kod kısmında parametre olarak kullanırız ve o yorumun tamamını parse etmiş oluruz.

Bu kodun çıktısı olarakta artık o yorumu parse etmiş oluruz.

Bu işlemi bir döngü içinde başlık kısmına denk gelen id numarasından başlanarak arttıra arttıra giderek cevap alabildiğimiz entryleri parse etmemiz mümkündür. Ben bu işlemi CSS kullanarak yaptım bunun XPath ile yapılması da mümkündür tabiki. Fakat o kısımda pek bir bilgim olmadığından CSS'i tercih ettim.

Yine bu olayı ben HTML kullanarak yaptım bunun XML kullanarak bir dosyadan parse etmekte mümkündür. Aşağıda sizlere onun kodunu paylaşıyorum.

Bazı Parse Ayarları:

• NOBLANKS: Boş nodeları siler
• NOENT: Entitilerin yerine geçer
• NOERROR: Hata raporlarını ortadan kaldırır.
• STRICT: Kusurlu dökümanların parse edilidiği zaman bir hata yükseltir
• NONET: Hiç internet bağlantısı olmadığında parse etme işlemini engeller.

Yukarıda ayarların kodda nasıl kullanıldığına bakacak olursak;

Bu yazımın da sonuna gelmiş bulunuyoruz okuyup vakit ayırdığınız için teşekkür ederim. Umarım birazcıkda olsa ilgilenenlere faydalı olmuştur. Sonraki yazılarımda görüşmek üzere :) 

class Net::HTTP

HTTP Client API For Ruby

Ruby ile bir web sitesini crawl etmek istediğimde iki işlemi yapmak zorunda olduğumu öğrendim. Bunlar Request ve Response işlemleri. Bu yazımda baştan adım adım kod örnekleriyle açıklamalarda bulunacağım. Öncelikle bazı tanımların üstünde durmak istiyorum :)

HTTPS(Secure Hyper Text Transfer Protocol): HTTP'nin güvenli ağ protokolü ile birleştirilmiş halidir. Klasik HTTP protokolüne SSL protokolünün eklenmesiyle oluşturulur. İnternette sunucular ve son kullanıcılar arasında bilgilerin başkaları tarafından okunamayacak şekilde aktarılmasını hedefler.

HTTP(Hyper Text Transfer Protocol): İnternette sunucular ve son kullanıcılar arasında bilgilerin aktarılmasını hedefler. Uygulama katmanında yer alır.

URI(Uniform Resource Identifier): Web üzerinde belli bir kaynağa ulaşmak için kullanılan belli bir formata sahip karakter dizisidir.

URL(Uniform Resource Locator): Teknik söylem ve yazım kullanımlarında URI yerine kullanılır.

Web Crawling: Web sitelerini sıralı bir şekilde gezinerek bütün linklerini ya da  bizim belirlediğimiz sayıda linklerini elde etmektir.

Bütün örnek kodların başına NET::HTTP yüklenmiş varsayılır:

GET etme işleminde veriyi sadece request ederiz kaydetme yoktur.
POST işleminde ise gönderilen veriyi istersek veritabanına kaydedebiliriz.

GET etme işlemi yalnız başına, URI yardımıyla veya dinamik parametrelerle birlikte yapılır:

GET:

GET by URI:

GET with Dynamic Parameters:

NET::HTTP kullanımı:

start: hızlı bir şekilde bir tane HTTP server için bir bağlantı oluşturur.
new: eğer kendi kendine kapanmayan bir bağlantılı çoklu HTTP kullanmak istersek.
finish: bağlantıyı elle kapamak için.

Dataların Response Edilişi:

















Yönlendirmelerin Takibi:

Headerların Set Edilişi:














Akış Response Bodyleri:















HTTPS ve SSL kullanımı:











Proxyler:

Net::HTTP http_proxy den otomatik olarak bir proxy oluşturur.

Bir Web Crawler yazma maceramın ilk adımı olan bu işlemleri sizinle paylaşmak istedim umarım yararlı olmuştur ilgilenenlere. Diğer paylaşımlarımda görüşmek üzere teşekkür ederim :)