DEV Community: Koray Barkin

Liman'da Eklenti Geliştirme

Koray Barkin — Tue, 27 Oct 2020 11:24:01 +0000

Bize tanımlanmış IP üzerinden Liman’a giriş yaptıktan sonra Sistem Ayarları sekmesine gelerek Eklentiler’i seçiniz. Eğer burada Yeni sekmesini görmüyorsanız Mert Çelen’in paylaştığı rehberden Eklenti Geliştirme Ortamı Kurulumunu yapmanız gerekmektedir.

Yeni butonuna basarak eklentinizin ismini girerek oluşturmaya başlayalım.

Eklentimizi geliştirmek için eklentiyi bir sunucuya atamamız gerekmektedir. Bu atamayı sol taraftan Sunucular sekmesine giderek yapabiliriz. Açılan ekranda + işaretine basıp eklemek istediğiniz sunucuyu seçiniz. (Eğer görünürde bir sunucunuz yoksa, ilk önce sunucu oluşturmanız gerekmektedir.)

Liman’da yapacağımız işlemler şimdilik bu kadar. Geliştirme ortamınız da hazırsa Visual Studio Code yardımı ile eklentimizi geliştirebiliriz.

Visual Studio Code’u açalım ve Remote SSH ile Liman sunucumuza bağlanalım. Bağlandıktan sonra sol üstten Open Folder diyerek /liman/extensions/ klasörüne gelip oluşturduğunuz eklentiyi seçiniz.

Açılan eklentide view klasörü altında bir functions.php ve bir tane de index.blade.php adında iki tane dosyamızın olduğunu göreceğiz. Şimdi, Liman sunucumuzdaki bilgileri ya da sizin bilgisayarınızın bileşenlerinin bilgilerini çektiğimiz bir eklenti yapabiliriz. Aşağıdaki kodu functions.php dosyasına yapıştıralım.

<?php
function index(){
    return view("index");
}

function getHOSTinfo(){
    $hostInfo = runCommand("hostname");
    return respond($hostInfo,200);
}

function getIPinfo(){
    $ipInfo = runCommand("ip a");
    return respond($ipInfo,200);
}

?>

Şimdi burada tam olarak neler oluyor? getHOSTinfo fonksiyonunda, içerisinde bulunan runCommand’e hostname değerini gönderdik. Bu komut içerisine gönderdiğimiz değeri sunucumuzda terminal’e yazdığımızda çıkan sonucu döndürmektedir. Terminal’i açıp hostname yazdığımızda sunucumuzun adının yazdığını görürüz. Biz de bu eklentide sunucumuzun adını çağırmak istiyoruz ve çıkan sonucu eklentimize eklemek istiyoruz. Altındaki getIPinfo fonksiyonu da aynı işlemi yapmaktadır, IP bilgilerini öğrenmek için ip a komutunu runCommand’e gönderiyoruz. Ve son olarak da return respond ile eğer gönderdiğimiz HTTP talebinden 200 kodu dönüyorsa bu komutları tanımladığımız değeri gönder diyoruz.

Şimdi de index.blade.php dosyamıza geçelim. Aşağıda paylaştığım kodu index.blade.php dosyasına yapıştırın.

<ul class="nav nav-tabs" role="tablist" style="margin-bottom: 15px;">
  <li class="nav-item">
    <a class="nav-link active" onclick="getIP()" href="#ipTab" data-toggle="tab">IP Bilgileri</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" onclick="getHost()" href="#hostTab" data-toggle="tab">Host Bilgileri</a>
  </li>
</ul>

<div class="tab-content">
    <div id="ipTab" class="tab-pane active">
    <pre id="ipPre"></pre>
    </div>

    <div id="hostTab" class="tab-pane">
    <pre id="hostPre"></pre>
    </div>

</div>

<script>
function getIP(){
  request(API("getIPinfo"), new FormData(), function(response){
    msg = JSON.parse(response).message;
    $('#ipPre').html(msg);
  }, function(response){
    console.log("HATA!");
  });
}
function getHost(){
  request(API("getHOSTinfo"), new FormData(), function(response){
    msg = JSON.parse(response).message;
    $('#hostPre').html(msg);
  }, function(response){
    console.log("HATA!");
  });
}

if(location.hash === ""){
    getIP();
}
</script>

Verimizi direkt yazdırmamız mümkün, fakat daha şık bir görüntü olsun diye Tab’lı yapıda veriyi kullanmak istedim. Şimdi ise getIP ve getHost fonksiyonlarında neler döndüğünü inceleyelim. İki fonksiyonda da sunucumuza request (talep) gönderiyoruz. Endpoint URL’mizin sonuna function.php’de yazdığımız fonksiyonların adını yazdığımızda orada dönen verinin JSON biçimin de döndüğünü görebiliriz. Biz de bir FormData oluşturarak, eğer requestimizden bir response dönüyorsa veriyi parse et ve sadece message başlığını döndür diyoruz ve bu mesajı yukarıda belirttiğimiz id’ye gönderiyoruz. Eğer response dönmüyorsa, ikinci satıra gir ve konsola Hata! yaz dedik. Bunu da debug yaparken response’un durumunu takip etmek için kullanabiliriz.

Son olarak da if(location.hash === “”) diyerek sayfa yüklendiğinde index’te ise yüklemesini istediğimiz fonksiyonu yazıyoruz. Yani eklentiyi ilk açtığımızda karşımız IP bilgileri gözükecek.

Python ile Liman API Kullanımı

Koray Barkin — Tue, 20 Oct 2020 08:47:20 +0000

Liman sunucunuzda oluşturduğunuz sunucu, anahtar, modül, talep ve bildirimler gibi verilere ulaşabildiğiniz Liman API dokümantasyonuna buradan ulaşabilirsiniz:

https://api.liman.dev

Yukarıda paylaştığım dokümantasyonda, Liman API’ı yardımı ile gönderdiğiniz parametreye bağlı olarak birden fazla veriye erişmek mümkün.

Örnek olarak, Liman’a giriş yapıp bir Erişim Anahtarı oluşturalım. Sol taraftaki menüden "Erişim Anahtarı" seçeneğini seçip, gelen ekranda “Oluştur” butonuna basarak bir anahtar oluşturalım.

Anahtarınıza isim tanımladıktan sonra, otomatik bir şekilde size Token başlığı altında size özel bir anahtar oluşturulacak.

Şimdi ise bir Python dosyası yaratalım ve içerisine aşağıdaki kodu yapıştıralım.

import requests
myToken = 'KEY'
myUrl = 'https://IP/profil/anahtarlarim'
head = {'liman-token': myToken, "Accept":"application/json"}
response = requests.get(myUrl, headers=head, verify=False)
print(response.text)

Request modülü eğer bilgisayarınızda yüklü değilse pip paket yöneticisi ile request modülünü bilgisayarınıza kurabilirsiniz.

pip install request

Kodumuzda request.get metodu, ilk parametre olarak hedef URL’yi almaktadır. Bu noktada sizin Liman’a giriş yaptığınız IP’yi yazmanız gerekmektedir. (Örneğin; https://192.168.0.0/profil/anahtarlarim) İkinci parametre olarak headers'ı gönderiyoruz. Headers'ın içindeki liman-token parametresine, Liman sunucumuzda bize tanımlanan anahtarı tanımlıyoruz. Bu parametreyi API'ı kullanma amacımıza göre https://api.liman.dev linkinde yer alan parametreleri kullanarak değiştirebiliriz. Biz bu örnekte anahtar bilgilerine ulaşmak istiyoruz bu yüzden liman-token parametresini gönderiyoruz. Son olarak, bize dönen verinin JSON metni biçiminde dönmesini istediğimiz için "Accept":"application/json" değerini eklememiz gerekmektedir. Eğer bunu tanımlamazsak varsayılan olarak hedef verinin bulunduğu URL'nin HTML kodu dönecektir.

En sondaki verify=False yazmamızın sebebi ise, sertifika ile alakalı bir hata alırsanız sertifika yüklemek yerine sertifika kontrolünü kapatarak alınan hatanın önüne geçmektir.

Son olarak request.get’e eşitlediğimiz response’u printleyerek dönen HTTP kodunu görebiliriz print(response). Eğer 200 kodu dönüyorsa API’ımız başarıyla çalışıyor demektir.

Linux tabanlı işletim sistemleri ile Flutter'a Giriş

Koray Barkin — Fri, 16 Oct 2020 09:36:16 +0000

Bir önceki seride Flutter’ın ne olduğunu ve ne amaçla kullanıldığını sizinle paylaşmıştım. Eğer o dokümanı okumadıysanız yukarıdaki serinin ilk başlığına tıklayarak Flutter hakkında bilgi edinebilirsiniz. Bu dokümanda ise Linux işletim sistemi kullanıcılarının Flutter’ı nasıl kurabileceklerini ve nasıl kullanabileceklerini anlatacağım ilk önce kurulum ile başlayalım.

Başlıklar

Linux işletim sistemine Fluter kurulumu
Flutter SDK (Software Development Kit) Kurulumu
Flutter Geliştirme Ortamı Kurulumu

Linux işletim sistemine Fluter kurulumu

Öncelikle Flutter’ı kurmak için aşağıda belirttiğim gereksinimleri karşılayabiliyor olmanız gerekmektedir:

• İşletim Sistemi: Linux (64-bit)
• Disk Alanı: 600MB (IDE ve geliştirme araçları dahil değildir)
• Araçlar: Flutter geliştirmeniz için aşağıdaki komut satırı araçlarını kullanabiliyor olmanız gerekmektedir. Bunların birçoğu Linux içerisinde yüklüdür. Fakat daha önce kullanmadıysanız Git kurmanız gerekmektedir.

• bash
• curl
• file
• git 2.x
• mkdir
• rm
• unzip
• which
• xz-utils
• zip

Flutter SDK (Software Development Kit) Kurulumu

Flutter’ı Linux’ta iki farklı şekilde kurabilirsiniz.
1) Snapd kullanarak kurulum
En kolay kurulum yolu olan snapd ile yüklemek için önce snapd paket yöneticisine sahip olmanız gerekmektedir. Eğer bilgisayarınızda snapd yüklü değilse buradan yükleyebilirsiniz.
Eğer yüklüyse Terminal’i açıp aşağıdaki komutu yazmanız Flutter SDK’ini indirmeniz için yeterli olacaktır.

sudo snap install flutter --classic

2) Manuel olarak kurulum
1) Eğer snapd yoksa veya manuel olarak yüklemek istiyorsanız, aşağıdaki linkten güncel versiyonunu indirebilirsiniz. (Install Flutter manually başlığı altında flutter_linux_1.22.1-stable.tar.xz adlı dosyayı indirmeniz gerekmektedir.)

Manuel kurulum linki: https://flutter.dev/docs/get-started/install/linux

2) İndirdiğiniz dosyaları istediğiniz konuma çıkartın.

cd ~/development
tar xf ~/Downloads/flutter_linux_1.22.1-stable.tar.xz

3) Flutter araçlarını path’inize ekleyin.

export PATH="$PATH:`pwd`/flutter/bin"

4) Eğer bu adıma kadar herhangi bir sorun yaşamadıysanız aşağıdaki komutu çalıştırdığınızda bilgisayarınızda Flutter’ın ve gerekli araçların yüklü olup olmadığını denetleyebilirsiniz.

flutter doctor

Bu adıma kadar Flutter’ı başarıyla kurduk, şimdi sırada geliştirme ortamını kurmakta.

Flutter Geliştirme Ortamı Kurulumu

Flutter’da geliştirdiğimiz uygulamaları test ve debug edebilmek için bir sanal makineye ihtiyacımız var. Bunun için Android Studio yükleyip, hem kodumuzu orada yazabilir hem de Android Studio’nun AVM (Android Virtual Machine) eklentisini kullanabiliriz. Fakat Android Studio biraz yavaş çalışan bir derleyici olduğu için ve bilgisayarımızda fazla yer kapladığı için çok tercih etmiyorum.

Visual Studio Code
VS Code uygulamasının Dart ve Flutter uzantısını yükleyip geliştirmemizi buradan yapabiliriz. Yazdığımız kodu çalıştırmak için Android Studio’nun AVM’sini ya da ayrıca kurduğunuz bir sanal makineyi kullanabiliriz. Eğer Android Studio kullanmak istemiyorsanız Linux için önerilen Genymotion ve Andro VM sanal uygulamarını kullanabilirsiniz.

Açtığınız sanal makine VS Code uygulamasında sağ alt kısımda yazmaktadır. Eğer herhangi bir sanal makine göremiyorsanız şuan VS Code uygulamasının gördüğü bir sanal aygıt olmadığı için çalıştırırken hata alırsınız. VS Code uygulaması bir derleyici değil, düzenleyici olmasına ragmen bir cihaz bağladığımız takidrde uygulamamızı debug edebilir, çalıştırabiliriz. Hem hızlı bir kullanım imkanı hem de bilgisayarınızda disk alanı açısından avantaj sağlar.

Flutter uygulamanızı çalıştırmak için herhangi bir derleyiciye ihtiyacınız yoktur. Terminal’den projenizin olduğu dosyaya gidip aşağıdaki komutu çalıştırdığınızda bilgisayarınızda açık bulunan sanal aygıtta geliştirdiğiniz projeyi çalıştırabilirsiniz.

flutter run

Flutter Nedir? Nasıl kullanılır?

Koray Barkin — Thu, 15 Oct 2020 08:26:12 +0000

Başlıklar

Flutter Nedir?
Flutter'ı Nasıl Öğrenebilirim?
Flutter’ı hangi Compiler (derleyici) ile yazabilirim?

Flutter Nedir?

Son günlerde bir hayli duyduğumuz Flutter’ı bu kadar önemli kılan nedir bugün hep beraber öğreneceğiz. Mobil uygulama geliştirirken bildiğiniz üzere iOS ve Android işletim sistemli cihazlar için ayrı kod yazmamız gerekmektedir. iOS için Objective-C ve Swift kullanılırken, Android için Java ya da Kotlin popüler olarak kullanılmaktadır. Peki bu durumun bize açtığı sorunlar neler?

• Bir güncelleme yaparken her bir platform için iki farklı koda da güncellemeyi eklemek.
• Kullanıcı ara yüzleri farklı olduğu için ayrıca görselleştirme gerekmektedir.

Fakat Google’ın çıkardığı Dart dilinin kütüphanesi olan Flutter sayesinde geliştiriciler hem iOS hem de Android işletim sistemli cihazlarda bir kod üzerinden geliştirme yapabilmektedirler. Böylece geliştiriciler hem maliyetten hem de zamandan tasarruf edebilirler. Dart bilmiyorsanız bu problem değil, Dart’ın syntax’i Java’ya ve Kotlin’e oldukça benzemektedir. Eğer daha önce bu diller ile az da olsa bir tecrübeniz varsa kolaylıkla öğrenebilirsiniz.

1980’lerde Python geleceğin en önemli programlama dili olacak denildiğinde bunu söyleyenlerin çok da yanılmadığını söyleyebiliriz. Şu anda en popüler dil olan Python birçok alanda sıklıkla kullanılmaktadır. Şu anda ise, Google geliştiricileri bundan 5 yıl sonrasında Flutter’ın oldukça popüler olacağını söylüyorlar. Şu anda Google Play ve AppStore’da bulunan uygulamaların çoğu alışagelmiş sistem programlama üzerine kurulmuş olsa da siz yeni bir uygulama geliştiriyorsanız Flutter üzerinden geliştirmenizde fayda var.

• Flutter’ın Hot Reload, Live Reload gibi kullanıcılara geliştirme aşamasında hızlı bir test imkânı sunması.
• Kolay ve anlaşılır bir şekilde geliştirme ortamına sahip olması.
• Yeni, modern kullanıcı ara yüzü tasarımlarına sahip olması.
• Cupertino Widgetları, zengin API’ları ve cross-platform özelliği.
• Linux, Windows ve Mac üzerinden rahatlıkla geliştirilebilir.

Ve benzeri özellikle şüphesiz Flutter’ı öğrenmemiz için yeterli nedenler.

Flutter’ı nasıl öğrenebilirim?

Şu anda güncel olarak Udemy’den aldığım kursu yarılamış bulunmaktayım ve oldukça memnun olduğu söyleyebilirim. Sizinle aldığım dersleri, kullandığım kaynakları ve takip ettiğim YouTube kanallarını aşağıda paylaşacağım.
Udemy kursu: https://www.udemy.com/course/learn-flutter-dart-to-build-ios-android-apps/

Bu kursu kesinlikle tavsiye ederim. Giriş seviyesinden başlayıp en ince detayına kadar son seviyeye kadar 41 saatlik bir eğitim imkânı sunuyor.

Yararlı kaynaklar:
• https://fluttergems.dev
• https://flutter.dev

Bu sitelerden Flutter ile ilgili yeni bilgiler öğrenebilir, özelliklerini, widgetlarını keşfedebilirsiniz.

YouTube kanalı: The Flutter Way
https://www.youtube.com/channel/UCJm7i4g4z7ZGcJA_HKHLCVw
Bu kanalda tasarımını çok beğendiğim modern ve yaratıcı kullanıcı ara yüzleri tasarımlarını göstermektedir. Siz de izleyip, kendinize göre dilediğiniz değişiklikleri yapabilirsiniz gayet verimli bir kanal.

Flutter’ı hangi Compiler (derleyici) ile yazabilirim?

Flutter’ı kullanan geliştiriciler ya Android Studio ya da Visual Studio Code’u yaygın olarak kullanmaktadır. Fakat daha önceden kullanmış olanlarınız biliyordur, Android Studio’nun derlemesi biraz vakit alır ve yavaş çalışan bir uygulama geliştirme ortamıdır. Benim tavsiyem, VS Code indirip, Dart ve Flutter eklentilerini yüklemeniz. Fakat mobil uygulama geliştiriyorsanız uygulamanızın çalıştığını görmeniz için Android Studio AVM (Android Virtual Machine)’e ihtiyacınız vardır bu yüzden eğer Windows’ta uygulama geliştiriyorsanız Android Studio’yu her hâlükârda yüklemeniz gerekmektedir. Fakat Mac’te geliştiriyorsanız VS Code’da yazıp, XCode’un sanal telefonunu test etmek için kullanabilirsiniz, Android Studio yüklemeniz gerekmemektedir. Linux kullanıcıları için ise, Android Studio ya da herhangi bir Android Emulatörü indirip test etmek için kullanabilirsiniz. Linux için önerilen en popüler sanal makineler Genymotion ve Andro VM tercih edilmektedir.

Golang nedir? Golang ile REST API Geliştirme

Koray Barkin — Mon, 12 Oct 2020 09:44:59 +0000

Başlıklar

Golang Nedir?
Golang Kurulum
Golang ile REST API Geliştirme

Golang Nedir?

Go programlama dili, Google tarafından geliştirilmiş “büyük projelerdeki yazılım tecrübeleri” ile belirlenmiş bir dildir. Her programlama dilinin kendine ait bir çalışma alanında avantajları vardır. Go dilinin geliştirilmesi, Google’ın az dil özelliği kuralıyla esnek, hızlı, performanslı ve güçlü bir dil oluşturmaktır. Kısacası asıl amaç hızlı bir şekilde işlem yapmak, bu işlemleri yaparken de performanstan feragat etmemektir.

Go tamamen açık kaynak kodlarına sahip bir programlama dilidir. Bu yüzden Go dilini kullanan diğer şirketlerin geliştiricileri tavsiyesinde de Go diline eklemeler ve çıkarmalar yapılmaktadır. Fakat asıl amaç hızlı ve efektif bir şekilde geliştirme yapmak olduğu için, çoğu dilde olan Generics gibi bazı özelliklerin olmadığını gözlemleyebiliriz. Go dilinde neden Generics olmadığı sorulduğunda bu dili geliştiren Google geliştiricilerinin, “Generics performanslı ve hızlı değil, henüz bunun için bir çözüm bulamadık. Bulursak ekleriz.” Dediği öğrenildi. Bu da dilde performans ve hıza ne kadar önem verdiklerinin kısa bir özeti diyebiliriz.

Network ve Web Aplikasyonları geliştirmede büyük önem taşımaktadır. Oldukça verimli ve compile etmesi çok hızlı bir dil olduğu için geliştiriciler Go dilini sistem yönetiminde sıklıkla kullanmaktadır.

Golang Kurulum

Go dilini nasıl kuracağınızı bilmiyorsanız, aşağıdaki linkten işletim sisteminize göre uygun yükleme seçeneklerine ulaşabilirsiniz:
Golang kurulum: https://golang.org/doc/install

Go ile REST API Geliştirme

Şimdi localhost’umuzda HTTP requestleri ile çalışan basit bir API geliştirelim. İlk olarak main.go isimli dosyamızı oluşturalım. Bu dosya içerisine aşağıdaki kodu yapıştıralım. Bu kodumuzda görmüş olduğunuz gibi 3 farklı fonksiyon bulunmaktadır. Bunlardan homePage fonksiyonu root’taki URL requestlerinden sorumludur, handleRequests fonksiyonu ise URL ile tanımlanan fonksiyonu eşleştirir.

package main

import (
    "fmt"
    "log"
    "net/http"
)

func homePage(w http.ResponseWriter, r *http.Request){
    fmt.Fprintf(w, "Welcome to the HomePage!")
    fmt.Println("Endpoint Hit: homePage")
}

func handleRequests() {
    http.HandleFunc("/", homePage)
    log.Fatal(http.ListenAndServe(":10000", nil))
}

func main() {
    handleRequests()
}

Yeni bir eklenti geliştirmek istedik bundan sonra ne yapacağız? Yukarıda anlattığım gibi, bir veriyi göndermek istiyorsanız yapacağınız işlemleri bir fonksiyon içerisinde tamamlayıp, handleRequest fonksiyonunda http.HandleFunc("/", xxx) şeklinde URL uzantısını ekleyip veriyi gönderebiliriz.

Dinamik Veri Aktarımı

Golang ile Web API geliştirmeyi öğrendiğimize göre şimdi de dinamik bir şekilde veri nasıl aktarılır onu inceleyebiliriz. Dinamik veri aktarımı ile ilgili iki farklı yaklaşım bulunmaktadır. Birincisi çoğu yerde bulabileceğiniz fonksiyon içerisinde bir structure açıp, veriyi içerisinde saklamanız. İkinci yöntem ise structure gerektirmeyen verileri kolayca işlememize yarayan Gabs. Gabs, dinamik ya da bilinmeyen JSON yapıları ile uğraşırken büyük yarar sağlamaktadır.

Gabs'in yüklenmesi

go get github.com/Jeffail/gabs

Yükledikten sonra import edip, kullanmaya başlayabiliriz.

package main

import (
    "fmt"

    "github.com/Jeffail/gabs"
)

func main() {
    data := []byte(`{
        "employees":{
           "protected":false,
           "address":{
              "street":"22 Saint-Lazare",
              "postalCode":"75003",
              "city":"Paris",
              "countryCode":"FRA",
              "country":"France"
           },
           "employee":[
              {
                 "id":1,
                 "first_name":"Jeanette",
                 "last_name":"Penddreth"
              },
              {
                 "id":2,
                 "firstName":"Giavani",
                 "lastName":"Frediani"
              }
           ]
        }
     }`)

    jsonParsed, err := gabs.ParseJSON(data)
    if err != nil {
        panic(err)
    }

    //JSON Aramasi 
    fmt.Println("Get value of Protected:\t", jsonParsed.Path("employees.protected").Data())
    fmt.Println("Get value of Country:\t", jsonParsed.Search("employees", "address", "country").Data())
    fmt.Println("ID of first employee:\t", jsonParsed.Path("employees.employee.0.id").String())
    fmt.Println("Check Country Exists:\t", jsonParsed.Exists("employees", "address", "countryCode"))

    // adres objelerinin yinelenmesi
    for key, child := range jsonParsed.Search("employees", "address").ChildrenMap() {
        fmt.Printf("Key=>%v, Value=>%v\n", key, child.Data().(string))
    }

    // employee arrayinin yinelenmesi 
    for _, child := range jsonParsed.Search("employees", "employee").Children() {
        fmt.Println(child.Data())
    }

    // aramada indexin kullanilmasi 
    for _, child := range jsonParsed.Search("employees", "employee", "0").Children() {
        fmt.Println(child.Data())
    }
}

Yukarıdaki kodumuzda görmüş olduğunuz gibi data adında bir array açtık ve verimizi bu array içerisinde tutuyoruz. Fakat bu verimiz JSON encoding biçiminde tutulduğu için arraydeki değerlerimizi parselamamız gerekmektedir.

Verimizi bir database'den çekmiyoruz, statik olarak fonksiyon içerisinde tanımladık fakat dinamik bir şekilde verimizi çağırıyoruz. Eğer bir database ya da kullanıcı input'u ile veri çağırmamız gerekseydi de işlemlerimiz hemen hemen aynı olacaktı.

Yukardaki işlemleri gerçekleştirdikten sonra çalıştırdığımızda bu şekilde bir output'a ulaşabiliriz:

Get value of Protected:  false
Get value of Country:    France
ID of first employee:    1
Check Country Exists:    true
Key=>street, Value=>22 Saint-Lazare
Key=>postalCode, Value=>75003
Key=>city, Value=>Paris
Key=>countryCode, Value=>FRA
Key=>country, Value=>France
map[id:1 first_name:Jeanette last_name:Penddreth]
map[id:2 firstName:Giavani lastName:Frediani]
Jeanette
Penddreth
1

Böylece data arrayinde tanımladığımız verileri işleyip (JSON Parsing), key:value kombinasyonu ile kolaylıkla ulaşabildik.

Dinamik Web API geliştirme (Python & Flask)

Koray Barkin — Fri, 09 Oct 2020 09:21:59 +0000

Başlıklar

API Nedir?
Web API Nedir?
Kurulum
Dinamik Web API Geliştirme

API Nedir?

API yani Application Programming Interface’in Türkçe karşılığı Uygulama Geliştirme Ara yüzü anlamına gelmektedir. Kişinin elindeki verileri dış dünyaya açarak diğer uygulama ve platformların kullanımına belli kurallar ve tanımlamalar çerçevesinde sunduğu ara yüzdür.

Web API Nedir?

Birden fazla end user’ın bilgisayarlar, web tarayıcıları, akıllı telefonlar, tabletler vs. aracılığı HTTP protokolleri üzerinden haberleşelebilen bir servis oluşturmak için kullanılan bir framework olarak çalışmaktadır.
HTTP’nin tüm özelliklerini (URI, Request/Response headers, caching yani önbelleğe alma, versiyonlama, çeşitli içerik formatları gibi özellikler) kullanabilen, HTTP üzerinde kaynak odaklı servisler oluşturmak istediğinizde Web API kullanmanız daha sağlıklıdır.

Kurulum

Öncelikle Python’da oldukça popüler olan pip3 paket yöneticisini kuralım. Eğer pip3 yüklüyse bu adımı geçebilirsiniz.

sudo apt-get install python3-pip

Şimdi ise pip ile Flask kurmaya hazırız.

pip install flask

Kurulumumuzu tamamladık, şimdi bu dökümanda ne yapacağımızdan kısaca bir bahsedelim.

Daha önce flask ile Web API yapıp, statik bir şekilde veri aktarmayı işlemiştik. Eğer o dokümanı görmediyseniz buradan ulaşabilirsiniz.

Şimdi ise dinamik bir şekilde hem URL hem de veriyi alan bir Web API yapalım. Bu API’da Google Maps’in API’ını da kullanacağız.

Dinamik Web API Geliştirme

Şimdi ise gönderilen konuma göre Google Maps’in API’ından harita ve konum görüntüsünü yansıtan bir API yapalım. Dünyadaki tüm şehirlerin harita görüntüsünü elimizde tutmamız neredeyse imkansız. Bu nedenle bu tarz bir geliştirmeyi statik olarak yapmamız olanaksız. Neyse ki bizim için bütün şehirlerin hem harita hem de konum görüntülerini tutan Google Maps API’ı bulunmakta. Biz de bu API aracılığı ile veriyi Google Maps’ten çekip, bizim gönderdiğimiz şehrin görüntüsünü elde edeceğiz.

Bir python dosyası açalım ve içerisine aşağıdaki kodu yapıştıralım.

from flask import Flask
from string import Template
app = Flask(__name__)

HTML_TEMPLATE = Template("""
<h1>Hello ${place_name}!</h1>

<img src="https://maps.googleapis.com/maps/api/staticmap?size=700x300&markers=${place_name}" alt="map of ${place_name}">

<img src="https://maps.googleapis.com/maps/api/streetview?size=700x300&location=${place_name}" alt="street view of ${place_name}">
""")

@app.route('/')
def homepage():
    return """<h1>Hello world!</h1>"""

@app.route('/<some_place>')
def some_place_page(some_place):
    return(HTML_TEMPLATE.substitute(place_name=some_place))

if __name__ == '__main__':
    app.run(debug=False, use_reloader=True)

Daha sonra yaptığımız değişiklikleri kaydedip çalıştıralım. Her şey düzgün gittiyse aşağıdaki gibi bir sonuç almalısınız.

* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

http://127.0.0.1:5000/ adresindeki konuma gidip, index sayfasını görebiliriz.

Şimdi burada tam olarak ne oluyor? HTML_TEMPLATE, içerisinde gördüğünüz gibi bir URL tutmaktadır. Bu URL Google Maps’e bir request atıyor ve biz de istenilen request’i serverdan respond olarak alıyoruz. Peki neyin request’ini gönderiyoruz? Kısacası place_name yerine ne yazarsak o konumun görüntüsünü elde edeceğiz. Bizim API’ımızı da dinamik yapan asıl durum tam olarak da budur. Hiçbir şehrin görüntüsünü tek tek indirip girmedik, hepsi hazırda duruyor ve bizim talebimize göre o veriyi elde ediyoruz.

Bu geliştirdiğimiz API’da bir tek dinamik olan durum görüntüler değil, URL’yi de dinamik bir şekilde alabiliriz.

@app.route(‘/’) bildiğiniz gibi ana sayfayı yani index sayfasını temsil etmekteydi. Eğer biz oraya @app.route(‘/Ankara’) yazsaydık ve tek tek her şehir için böyle bir tanımda bulunsaydık bu dinamik değil statik olurdu. O yüzden adında bir değer tanımlıyoruz. Bu değere gönderdiğimiz isim Google Maps API’na place_name olarak gitmektedir ve oradan da konum bilgilerini çekmektedir.

Böylece hem URL hem de veriyi dinamik bir şekilde elde etmiş olduk!

Python ve Flask kullanarak Web API geliştirme

Koray Barkin — Fri, 09 Oct 2020 07:07:13 +0000

Başlıklar

API Nedir?
Web API Nedir?
Kurulum
Web API Geliştirme

API Nedir?

Web API Nedir?

Kurulum

Öncelikle Python’da oldukça popüler olan pip3 paket yöneticisini kuralım. Eğer pip3 yüklüyse bu adımı geçebilirsiniz.

sudo apt-get install python3-pip

Şimdi ise pip ile Flask kurmaya hazırız.

pip install flask

Kurulumumuzu tamamladık, şimdi bu dökümanda ne yapacağımızdan kısaca bir bahsedelim.

Web API Geliştirme

Her siteye girdiğinizde base URL dediğimiz ana sayfa bulunmaktadır. Sizin yaptığınız tercihler ile farklı konumlara request atılır ve bu base URL’in sonuna bir path eklenir.

Base URL:

dev.to

Örneğin, dev.to sitesine girdiğinizde ana sayfaya yönlendirilirsiniz. Fakat benim profilime girmek için adıma tıkladığınızda URL’nin sonuna aşağıdaki path’in eklendiğini görebilirsiniz.

/koraybarkin

Bu path kendi başına hiçbir işe yaramamaktadır, fakat base URL’imiz ile birleştiğinde dev.to sitesinde koraybarkin kullanıcısının profiline yönlendirmektedir.

https://dev.to/koraybarkin

Şimdi başka bir örnekten daha detaylı inceleyelim.

http://chroniclingamerica.loc.gov/search/pages/results/

Yukarıdaki URL’nin sonuna bir path eklenmiş ve bir sorgunun cevabı yansıtılmış. Şimdi ise parametre göndermenin ne işe yaradığını öğrenelim. Bu sitedeki aramamızın sonucunu parametre göndererek manipüle edebiliriz.

http://chroniclingamerica.loc.gov/search/pages/results/?format=json&proxtext=fire

Yukarıda görmüş olduğunuz gibi “?” işareti her bir query parametresinin başında yer yer almaktadır. Her bir query, & işareti ile birbirinden ayrılmaktadır. Yukarıdaki format=json query’si sayfadaki veriyi bize JSON halinde göstermesi için bir sorgudur. İkinci olarak da proxtext=fire sorgusu o sayfada yaptığımız aramayı spefisikleştirmektedir.

Şimdi bu terminolojileri anladığımıza göre Flask ile basit bir API yapalım.
İlk önce bir klasör açalım ve adına projeler diyelim. Daha sonra bu projeler klasörünün içerisine api adında bir klasör daha açalım ve bu api klasörünün içerisine de bir Python dosyası açalım (.py uzantılı) ve içerisine aşağıdaki kodu yapıştıralım.

import flask

app = flask.Flask(__name__)
app.config["DEBUG"] = False


@app.route('/', methods=['GET'])
def home():
    return "<h1>dev.to/koraybarkin Flask ile Web API geliştirme</h1><p>Tebrikler ilk Web API'ınızı başarıyla geliştirdiniz!</p>"

app.run()

Daha sonra yaptığımız değişiklikleri kaydedip çalıştıralım. Her şey düzgün gittiyse aşağıdaki gibi bir sonuç almalısınız.

* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Şimdi çıktımızda yazan http://127.0.0.1:5000/ adresine gittiğimizde aşağıdaki gibi bir ekrana ulaşıyor olmalısınız.

Şimdi ise bu yarattığımız basit Web API’ına veri gönderelim. Aşağıdaki kodu python dosyamıza yapıştıralım ve değişiklikleri kaydedelim. Daha sonra tekrar çalıştırdığımızda ana sayfamızdaki yazının hala aynı şekilde kaldığını görebiliriz. Peki bu eklediğimiz books array’indeki data nereye gitti? Kodu dikkatlice incelerseniz giriş ekranına bir /api/v1/resources/books/all path’ine jsonify(books) fonksiyonunu gönderdiğimizi görebilirsiniz.

import flask
from flask import request, jsonify

app = flask.Flask(__name__)
app.config["DEBUG"] = False

# Create some test data for our catalog in the form of a list of dictionaries.
books = [
    {'id': 0,
     'title': 'A Fire Upon the Deep',
     'author': 'Vernor Vinge',
     'first_sentence': 'The coldsleep itself was dreamless.',
     'year_published': '1992'},
    {'id': 1,
     'title': 'The Ones Who Walk Away From Omelas',
     'author': 'Ursula K. Le Guin',
     'first_sentence': 'With a clamor of bells that set the swallows soaring, the Festival of Summer came to the city Omelas, bright-towered by the sea.',
     'published': '1973'},
    {'id': 2,
     'title': 'Dhalgren',
     'author': 'Samuel R. Delany',
     'first_sentence': 'to wound the autumnal city.',
     'published': '1975'}
]


@app.route('/', methods=['GET'])
def home():
    return '''<h1>dev.to/koraybarkin Flask ile Web API geliştirme</h1><p>Tebrikler ilk Web API'ınızı başarıyla geliştirdiniz!</p>'''


# A route to return all of the available entries in our catalog.
@app.route('/api/v1/resources/books/all', methods=['GET'])
def api_all():
    return jsonify(books)

app.run()

Şimdi ise aşağıdaki path’i yazıp sonuca bakalım.

http://127.0.0.1:5000/api/v1/resources/books/all

Books array’indeki tüm veriyi alıp, jsonify() fonksiyonu ile json haline getirdik ve ekranımıza yansıttık. İşte statik bir şekilde veriyi gönderme, API oluşturma bu kadar basit!

Yazılım Lisans Tipleri ve Repository’e Lisans Ekleme

Koray Barkin — Mon, 05 Oct 2020 10:12:06 +0000

Başlıklar

Yazılım Lisans Tipleri
Repository’e Lisans Ekleme

Yazılım Lisans Tipleri

1) MIT Lisansı

MIT lisansı sizi birçok konuda özgür kılar. Yazılımınıza ait kaynak kodunu dilediğiniz gibi kullanabilir, paylaşabilir ve değiştirebilirsiniz. Ticari olarak kullanımında bile bir sorun olmamaktadır. Fakat yazılım kadar yazılımı geliştireni de özgür kılar. Yazılım ile ilgili herhangi bir sorun çıkması durumunda yazılımı geliştiren kişi için herhangi bir yükümlülük söz konusu değildir. Bu nedenle MIT lisanslı bir yazılımı gönül rahatlığı ile kullanabilirsiniz, fakat yazılımı kullandığınızda o yazılıma referans vermeniz gerekmektedir.

2) Apache Lisansı

Apache lisansının, MIT lisansından çok bir farkı olduğu söylenemez. Apache lisansı da hem yazılımı geliştireni hem de kullananları özgür kılmaktadır. Sadece yazılımınızı dağıtırken kullandığınız Apache lisanslı ürünlerin lisanslarını da dağıtımınıza eklemeniz gerekmektedir.

3) GNU Lisansı

GNU lisansı da MIT gibi kullanıcı ya ve geliştiren kişiye yazılımın kodlarına erişim konusunda bir kısıtlama getirmez. Fakat MIT lisansına kıyasla kullanım açısından bazı kısıtlamalara sahiptir. Bu kısıtlamaların en önemlisi, eğer yazılımınızda GNU lisansına sahip bir ürün kullandıysanız ve ürünü dağıtmaya başlarsanız, sizin yazılımınız da GNU lisansına sahip olmalıdır. Yani projemizde kendi geliştirdiğimiz kısımların da kaynak kodlarını paylaşmak zorundasınız. Bu nedenle ticari yazılımlarda GNU lisansı çok tercih edilmemektedir. MIT lisansında kaynak kodlarınızı paylaşmanız gerekmemektedir, geliştirdiğiniz kodları kimseyle paylaşmak zorunda değilsiniz.

Repository’e Lisans Ekleme

Yukarıda bahsettiğim lisanslar gibi olan tespit edilebilir lisans (detectable licence) eklediğiniz takdirde, repositorynizi ziyaret eden kullanıcılar repository sayfasının sağ üst kısmında lisans adını görebilirler. Lisans dosyasının tamamını okumak için, lisans adına tıklayabilirsiniz.

1) GitHub’da repositorynizin bulunduğu ana sayfaya gelin.

2) “Add File” diyerek “Create New File” seçeneğini seçiyoruz.

3) “Name your file…” kısmına LICENCE ya da LICENCE.md yazınız (bütün harfler büyük olmalıdır).Daha sonra sağ tarafta bulunan “Choose a licence template” butonuna basınız.

4) Açılan ekranda uygun lisans tipleri bulunmaktadır. Eklemek istediğiniz lisans tipini seçiniz.

5) Seçtikten sonra seçtiğiniz lisans tipinin izinleri, kısıtlamaları ve gereksinimlerini görebilirsiniz. Eğer kullanım koşullarını okuduktan sonra onaylıyorsanız “Review and Submit” butonuna basarak lisansı ekleyebilirsiniz.

6) Sayfanın alt kısmında bulunan “Commit changes” kısmında dosyada yaptığınız değişiklikleri içeren bir commit mesajı yazabilirsiniz.

7) Commit mesajı kısmının altında bulunan alandan yaptığınız commit’i bulunduğunuz branch’e mi ya da yeni bir branch’e mi eklemek istediğinizi seçiniz. Eğer bulunduğunuz branch varsayılan branch ise alttaki “Create a new branch for this commit and start a pull request” seçeneğini seçiniz. Branchlerin ne olduğunu tam olarak bilmiyorsanız bu linkten branch anlatımıma ulaşabilirsiniz.

Git'de Branch Nedir? Nasıl oluşturulur?

Koray Barkin — Fri, 02 Oct 2020 07:41:41 +0000

Başlıklar

Branch Oluşturmak
Yeni Bir Branch Oluşturmak
Branchleri Listelemek ve Branchler Arasında Gezinmek

Branch Oluşturmak

Branch oluşturmak kullanıcıya çalıştığı projenin farklı versiyonlarına erişmesini sağlar. Kullanıcı, projesine bir yenilik eklemek istediğinde, yaptığı değişiklik projenin çalışmasını olumsuz etkileyebilir. Bu gibi durumlarda projemizin o anki halini bozmamak için branch kullanabiliriz. Branch yardımı ile projemizin çalışır halini kaydedip, yeni eklenti üzerinde rahatlıkla çalışabiliriz. Projemizde herhangi bir sorun çıktığı takdirde geri dönüp önceki versiyona kolaylıkla erişebiliriz. Branch, sadece projenizi değiştirirken ya da güncellerken eski halini korumak ile kalmıyor. Projenize bir versiyon çıkarttığınız zaman her yeni versiyon için repository oluşturmak yerine her bir versiyon için farklı branchler açabilirsiniz. Böylece versiyonları bir arada kolayca takip edebilir ve erişebilirsiniz.

Git’de proje oluşturduğunuzda varsayılan olarak master adında bir branch oluşturulur. Eğer hiçbir değişiklik yapmadan çalışmaya devam edersek, bütün işlemlerimizi master branch’i üzerinden yapmış oluruz. Yeni bir eklenti yapacağımız zaman master branch’i üzerinde yeni bir branch açabiliriz. Böylece hem dosya kalabalığının hem de dosya boyutunun katlanmasının önüne geçmiş oluruz. Bunun yanı sıra istediğimiz zaman da bu iki farklı branch’i birleştirebiliriz.

Kısacası, bir proje geliştirirken final.py finalv2.py finalsonhali.py gibi hangi dosyanın ne içerdiğini bilmediğimiz karmaşık bir yapıdan bizleri kurtarıyor.

Şimdi yeni bir klasör oluşturup aşağıdaki komutu verelim.



git init

Örneğin, basit bir toplama işlemi yapan bir PHP (islemler.php) dosyamız olsun. Biz bu kodumuza eklenti olarak çarpma işlemi de hesaplamasını istiyoruz. Fakat, bu eklentiyi yaparken toplama işlemi fonksiyonunun işleyişini bozabiliriz. Bu yüzden eklentimizi güvenli ortamda geliştirmek için önce toplama işlemi dosyamızı Git’e ekleyip commit yapalım.



git add islemler.php



 git commit -m “toplama_islemi eklendi”

Yukarıdaki işlemleri gerçekleştirdikten sonra toplama işlemi yapan kodumuzu güvenli bir şekilde kaydettik. Şimdi ise rahatlıkla çarpma işlemi eklentisi üzerinde çalışabiliriz.

Yeni Bir Branch Oluşturmak

Git’de iki farklı şekilde branch oluşturabiliriz. Bu yollardan bir tanesi git branch komutunu kullanmak, diğeri ise git checkout -b parametresi vermek. Git branch komutu sadece yeni bir branch oluştururken, git checkout -b “…” komutu yazdığınız isimde branch yoksa onu oluşturur ve bulunduğunuz branch değiştirilir.



git checkout -b “carpma_islemi”

Bu komuttan sonra aşağıdaki yazıyı görüyorsanız doğru yoldasınız demektir.



Switched to new branch “carpma_islemi”

Şimdi yeni bir branch oluşturduğumuza ve çalışma branchimizi değiştirdiğimize göre önceden yarattığımız toplama.php dosyasını açıp çarpma işlemi eklentimizi ekleyebiliriz. Bundan sonra yapacağımız değişiklik carpma_islemi adındaki branchimize kaydedilecektir. İstediğimiz zaman master adındaki branchimize dönebilir ya da carpma_islemi ile birleştirebiliriz (merge). Değişiklikleri yaptıktan sonra dosyamızın yeni halini ekleyip commit edebiliriz.



git add islemler.php



git commit -m “carpma islemi eklendi”

Branchleri Listelemek ve Branchler Arasında Gezinmek

Git’de branch değiştirmek için git checkout komutunu kullanabiliriz. git checkout komutunu yazdıktan sonra gitmek istediğiniz branch’in adını yazmanız yeterlidir. Eğer gitmek istediğiniz branch’in adını hatırlamıyorsanız git branch komutu ile bütün branchleri listeleyebilirsiniz.

(Branchleri listeler)



git branch

(carpma_islemi branchine geçiş yapar)



git checkout carpma_islemi

git branch komutunu yazdıktan sonra bulunduğunuz branch’in yanında * işareti bulunur. Eğer carpma_islemi branchindeysek islemler.php dosyasının içeriğinde, eklediğimiz çarpma işlemi fonksiyonunu da görebiliriz fakat master branch’ine dönersek sadece toplama işleminin olduğunu göreceğiz.

(master branchine geçiş yapar)



git checkout master

Böylece iki farklı versiyonda islemler.php dosyamız mevcut. Sadece toplama işlemine sahip olan master branch’i ve hem toplama hem de çarpma işlemine sahip carpma_islemi branch’i. Eğer bölme işlemi gibi bir eklenti eklemek istiyorsak, git branch bölme_islemi diye bir branch açabilir ya da git checkout -b bölme_islemi diye branch açıp çalışma branchimizi de değiştirerek eklentimizi yapabiliriz. Bunun ardından aynı şekilde git add ve commit komutlarını yazarak projemizin üstüne koyarak ilerleyebiliriz.