Alper'in Yazılım Durağı

.NET CLI Eklentisi Geliştirme: Kendi Komut Satırı Aracınızı Yazın

noreply@blogger.com (Alper Konuralp) — Thu, 24 Oct 2024 13:59:00 +0000

.NET CLI için kendi özel eklentinizi (plugin) geliştirmek, düşündüğünüzden daha kolaydır ve yazılım projelerinize esneklik kazandırır. CLI eklentileri, sık tekrarlanan görevleri otomatikleştirmek veya projelerinizi hızlandıracak özel komutlar oluşturmak için harika bir yoldur. Böylece, kendi iş akışınıza uygun araçlar geliştirip komut satırından rahatça kullanabilirsiniz.

Bu yazıda, sıfırdan bir .NET CLI aracı geliştirmenin tüm adımlarını birlikte inceleyeceğiz. Eklentinizi nasıl yapılandıracağınızı, paketleyeceğinizi ve ister lokal ister NuGet üzerinden dağıtabileceğinizi adım adım anlatacağım. Hazırsanız başlayalım!

1. Proje Oluşturma

İlk adım olarak, CLI eklentinizin temeli olacak bir .NET Console Application projesi oluşturmanız gerekiyor. Bu konsol uygulaması, komut satırından çağrıldığında çalışacak ve sizin tanımladığınız komutlara göre işlem yapacaktır.

Proje oluşturmak için aşağıdaki komutu terminalde (Command Prompt, PowerShell veya Bash) çalıştırın:

dotnet new console -n MyDotNetPlugin

Bu komut şu işlemleri yapar:

dotnet new console: Yeni bir konsol uygulaması oluşturur.
-n MyDotNetPlugin: Uygulamanın adını MyDotNetPlugin olarak belirler. Bu adı istediğiniz gibi değiştirebilirsiniz.

Komut çalıştıktan sonra, bulunduğunuz dizine bir MyDotNetPlugin klasörü oluşturulur ve proje dosyaları (örneğin Program.cs ve MyDotNetPlugin.csproj) buraya yerleştirilir.

Proje Klasörüne Girme

Projeyi oluşturduktan sonra terminalde proje klasörüne geçiş yaparak orada çalışmaya devam etmelisiniz:

cd MyDotNetPlugin

Bu aşamadan sonra, projenizin dosyalarını düzenlemeye başlayabilir ve CLI eklentisi olarak çalışması için gerekli ayarları yapabilirsiniz. Artık kodunuzu yazmak ve projenizi bir CLI aracı olarak paketlemek için hazırsınız.

2. Proje Yapısını Ayarlayın

Projenizi bir .NET CLI aracı (tool) olarak çalıştırabilmek için bazı ek yapılandırmalar yapmanız gerekiyor. Özellikle, projenizin bir konsol uygulamasından farkını belirlemek ve CLI komutu olarak paketlenmesini sağlamak için *.csproj dosyasına birkaç önemli ayar eklemelisiniz. Bu adım, eklentinizin komut satırında doğru şekilde tanınması için kritik önem taşır.

Öncelikle proje dizininizdeki MyDotNetPlugin.csproj dosyasını açın. İçeriğini aşağıdaki gibi düzenleyin:

MyDotNetPlugin.csproj:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>  <!-- Çıkış türü bir çalıştırılabilir dosya olacak -->
    <TargetFramework>net8.0</TargetFramework>  <!-- .NET sürümünü belirtiyoruz -->
    <PackAsTool>true</PackAsTool>  <!-- Projenin CLI aracı olarak paketlenmesini sağlar -->
    <ToolCommandName>mytool</ToolCommandName>  <!-- Komut satırında çalışacak komutun adı -->
  </PropertyGroup>

</Project>

Bu Yapılandırmalar Ne Anlama Geliyor?

<OutputType>Exe</OutputType>: Bu ayar, projenizin bir çalıştırılabilir uygulama (.exe veya ilgili platforma uygun format) olarak paketleneceğini belirtir. Eklentiniz, komut satırında bir komut olarak çalıştırılacak bir uygulama olacağı için bu gerekli.
<TargetFramework>net8.0</TargetFramework>: Bu satır, projenizin hangi .NET sürümünü kullanacağını tanımlar. En güncel sürümü kullanmak en iyisidir, ancak hedef platformunuza uygun farklı sürümler (örneğin net6.0 veya net7.0) da belirtebilirsiniz.
<PackAsTool>true</PackAsTool>: Bu ayar, projenin bir CLI aracı (tool) olarak paketlenmesini sağlar. Eğer bu ayar yoksa, dotnet komutuyla aracı paketleyemezsiniz.
<ToolCommandName>mytool</ToolCommandName>: Bu, projenizin komut satırında hangi isimle çalıştırılacağını belirler. Örneğin, bu ayarda mytool olarak belirttiğimiz için komut satırında aracı çalıştırmak için şunu kullanacağız:
```
mytool
```

Proje Yapısını Test Etme

Yapılandırmayı tamamladıktan sonra, projede kodlama yapmadan önce yapılandırmanın doğru çalışıp çalışmadığını test edebilirsiniz. Önce, aşağıdaki komutla projenin derlenip derlenmediğini kontrol edin:

dotnet build

Herhangi bir hata görmüyorsanız, CLI eklentisi olarak paketleme ve dağıtım için gerekli tüm ayarları başarıyla tamamladınız. Şimdi sıradaki adımda Program.cs dosyasına komutlarınızı ekleyip projenizi paketlemeye geçebiliriz.

3. Kodunuzu Yazın

Artık projenizin kalbini oluşturacak kodu yazmaya başlayabilirsiniz. Eklentinizin davranışını tanımlayan kodlar, Program.cs dosyasında bulunur. Bu kod, kullanıcı komutu çalıştırdığında tetiklenir ve gerekli işlemleri yapar. Aşağıda, basit bir CLI aracının nasıl çalışacağını ve genişletilebileceğini adım adım inceleyelim.

Program.cs Dosyasının Yapısı

Öncelikle proje dizininizdeki Program.cs dosyasını açın. Varsayılan olarak içinde Hello, World! yazan bir kod görürsünüz. Bunu aşağıdaki gibi değiştirin:

Program.cs:

using System;

class Program
{
    static void Main(string[] args)
    {
        if (args.Length == 0)
        {
            Console.WriteLine("Kullanım: mytool <komut> [parametreler]");
            Console.WriteLine("Örnek: mytool merhaba");
        }
        else
        {
            string command = args[0].ToLower();

            switch (command)
            {
                case "merhaba":
                    Console.WriteLine("Merhaba, dünya!");
                    break;
                case "zaman":
                    Console.WriteLine($"Şu anki saat: {DateTime.Now}");
                    break;
                case "topla":
                    if (args.Length == 3 && int.TryParse(args[1], out int a) && int.TryParse(args[2], out int b))
                    {
                        Console.WriteLine($"Sonuç: {a + b}");
                    }
                    else
                    {
                        Console.WriteLine("Kullanım: mytool topla <sayı1> <sayı2>");
                    }
                    break;
                default:
                    Console.WriteLine($"Bilinmeyen komut: {command}");
                    Console.WriteLine("Kullanılabilir komutlar: merhaba, zaman, topla");
                    break;
            }
        }
    }
}

Kod Açıklaması

args Parametresi:
Main metoduna gelen args dizisi, komut satırında verilen argümanları tutar. Örneğin, komut satırında mytool merhaba yazarsanız, args[0] değeri "merhaba" olur.
Komutların İşlenmesi:
İlk olarak args dizisinin uzunluğu kontrol edilir. Eğer kullanıcı herhangi bir komut vermezse, bir kullanım talimatı görüntülenir.
switch Yapısı ile Komut Yönlendirme:
Kullanıcının verdiği komuta göre, switch yapısı kullanılarak ilgili işlem yapılır:
- merhaba Komutu: "Merhaba, dünya!" mesajını ekrana yazdırır.
- zaman Komutu: Sistemin güncel saatini gösterir.
- topla Komutu: Kullanıcıdan iki sayı alır ve toplamını ekrana yazdırır. Sayılar doğru girilmezse bir hata mesajı verir.
Varsayılan Durum:
Eğer kullanıcı bilinmeyen bir komut girerse, bu durumda eklenti mevcut komutları listeleyerek yardımcı olur.

CLI Aracınızı Test Etme

Kodunuzu yazdıktan sonra, her şeyin doğru çalışıp çalışmadığını test etmek için projeyi derleyip çalıştırabilirsiniz.

dotnet run -- merhaba

Bu komutun çıktısı:

Merhaba, dünya!

Başka bir örnek:

dotnet run -- topla 5 10

Bu komutun çıktısı:

Sonuç: 15

Hata Yönetimi ve Genişletme

Bu örnek, CLI aracınıza nasıl temel komutlar ekleyebileceğinizi göstermektedir. Ancak daha karmaşık bir araç oluşturmak isterseniz şunları ekleyebilirsiniz:

Hata yönetimi: Kullanıcıdan gelen hatalı girişleri yakalayıp detaylı hata mesajları gösterebilirsiniz.
Yeni komutlar: switch yapısına yeni komutlar ekleyerek aracınızı genişletebilirsiniz.
Dış bağımlılıklar: Örneğin, bir HTTP isteği göndermek için HttpClient kullanabilir veya veritabanına bağlanabilirsiniz.

Bu basit CLI uygulaması, projelerinizi otomatikleştiren, zaman kazandıran araçlar geliştirmek için size iyi bir başlangıç sağlar. Şimdi, bir sonraki adımda bu projeyi paketleyip çalıştırılabilir bir araç haline getireceğiz.

Komut Satırı Argümanlarını Yönetmek İçin Kütüphaneler

CLI projeleri büyüdükçe, komut satırı argümanlarını elle işlemek karmaşıklaşabilir. Neyse ki, argümanları daha kolay bir şekilde ayrıştırmak ve işlemek için çeşitli kütüphaneler mevcut. Aşağıda, en popüler ve işlevsel birkaç .NET kütüphanesini bulabilirsiniz:

1. System.CommandLine

Nedir?: Microsoft tarafından geliştirilen resmi bir kütüphanedir. Komutların, alt komutların ve seçeneklerin yönetilmesi için güçlü bir altyapı sunar.
Özellikler:
- Alt komutlar ve çoklu argüman desteği sağlar.
- Otomatik olarak komut yardım dökümünü (help) oluşturur.
- Seçeneklerin kısa ve uzun sürümlerini destekler (örneğin, -v ve --version).

Örnek Kullanım:

dotnet add package System.CommandLine

using System.CommandLine;

var rootCommand = new RootCommand("MyTool - Komut satırı aracınız");

rootCommand.AddOption(new Option<string>("--isim", "Kullanıcının adı"));
rootCommand.SetHandler((string isim) => {
    Console.WriteLine($"Merhaba, {isim}!");
}, new Option<string>("--isim"));

await rootCommand.InvokeAsync(args);

2. CommandLineParser

Nedir?: Basit ve esnek bir komut satırı ayrıştırıcıdır. Küçük projelerde hızlıca kullanılabilir.
Özellikler:
- Argümanları doğrudan bir sınıfa bağlayarak (binding) yönetmeyi sağlar.
- Otomatik olarak hata mesajları ve yardım dökümü üretir.
- Seçeneklerin tür dönüştürmesini otomatik olarak yapar.

Örnek Kullanım:

dotnet add package CommandLineParser

using CommandLine;

public class Options
{
    [Option('n', "name", Required = true, HelpText = "Kullanıcının adını belirtir.")]
    public string Name { get; set; }
}

class Program
{
    static void Main(string[] args)
    {
        Parser.Default.ParseArguments<Options>(args)
            .WithParsed<Options>(opts => Console.WriteLine($"Merhaba, {opts.Name}!"));
    }
}

3. McMaster.Extensions.CommandLineUtils

Nedir?: Komut satırı argümanlarıyla çalışan daha gelişmiş projeler için kullanışlıdır. ASP.NET tarzı attribute kullanımıyla komutları tanımlamayı sağlar.
Özellikler:
- Alt komut ve seçenek desteği sunar.
- attribute kullanarak komutlar arasında geçiş sağlar.
- CLI projelerine doğal bir yapı kazandırır.

Örnek Kullanım:

dotnet add package McMaster.Extensions.CommandLineUtils

using McMaster.Extensions.CommandLineUtils;

[Command(Name = "mytool", Description = "Özel CLI Aracınız")]
class Program
{
    [Option("-n|--name <NAME>", "Kullanıcının adı", CommandOptionType.SingleValue)]
    public string Name { get; }

    public static int Main(string[] args) => CommandLineApplication.Execute<Program>(args);

    private void OnExecute()
    {
        Console.WriteLine($"Merhaba, {Name ?? "dünya"}!");
    }
}

Hangi Kütüphaneyi Seçmelisiniz?

Basit projeler için CommandLineParser hızlı bir başlangıç sağlar.
Alt komutlar ve detaylı seçenekler ile çalışmanız gerekiyorsa, System.CommandLine iyi bir tercihtir.
Daha karmaşık yapıya sahip büyük projeler için, McMaster.Extensions.CommandLineUtils kullanımı projelerinizi modüler hale getirebilir.

Bu kütüphanelerden biriyle çalışarak projenizi daha esnek, okunabilir ve sürdürülebilir hale getirebilirsiniz.

4. CLI Eklentisini Paketleme

Eklentinizi geliştirdikten sonra, onu .NET CLI aracı (tool) olarak paketlemeniz ve kullanıma hazır hale getirmeniz gerekiyor. Bu işlem, aracınızı hem lokal ortamda test etmenize hem de isterseniz NuGet üzerinden dağıtmanıza olanak tanır. Aşağıda adım adım bu süreci nasıl yapacağınızı anlatıyorum.

Paketleme İçin Projenizi Derleyin

Öncelikle projenizin sorunsuz bir şekilde derlendiğinden emin olun. Terminalde proje dizininde aşağıdaki komutu çalıştırın:

dotnet build -c Release

Bu komut, projenizi Release yapılandırmasında derler ve bin/Release/{framework} dizinine yerleştirir. Bu aşamada hata almıyorsanız, bir sonraki adımda eklentiyi paketleyebilirsiniz.

Eklentiyi Paketleme

CLI eklentisini kullanıma sunabilmek için bir NuGet paketi oluşturmanız gerekiyor. Aşağıdaki komutu kullanarak projenizi paketleyin:

dotnet pack -c Release

Bu komut, projenizi .nupkg uzantılı bir NuGet paketi haline getirir. Paket, bin/Release dizininde bulunacaktır. Örneğin, MyDotNetPlugin.1.0.0.nupkg şeklinde bir dosya oluşur.

Paket içeriği şu bilgileri barındırır:

Proje dosyası (.csproj) ayarları
Çalıştırılabilir dosya ve kodlar (.exe veya platforma uygun format)
CLI eklentisinin NuGet uyumlu paket tanımları

Lokal Olarak Eklentiyi Kurup Test Etme

Eklentinizi NuGet'e göndermeden önce lokal makinenizde test edebilirsiniz. Bunun için paket dosyasını dotnet ile global olarak kurun:

dotnet tool install --global --add-source ./bin/Release mytool

Bu komut, eklentinizi global araçlar (global tools) arasına ekler. Artık terminalde mytool komutunu doğrudan çalıştırarak test edebilirsiniz:

mytool merhaba

Eğer eklenti doğru çalışıyorsa, kurulum başarılı olmuştur.

NuGet Üzerinde Yayınlama (İsteğe Bağlı)

Eğer eklentinizi herkesin erişebileceği şekilde yayınlamak istiyorsanız, NuGet'e yüklemeniz gerekir. Bunun için önce bir NuGet API key edinmelisiniz. NuGet'e giriş yaparak buradan yeni bir API anahtarı oluşturabilirsiniz.

API anahtarını aldıktan sonra aşağıdaki komutla eklentinizi NuGet'e yükleyin:

dotnet nuget push bin/Release/MyDotNetPlugin.1.0.0.nupkg -k <API_KEY> -s https://api.nuget.org/v3/index.json

Bu komut, NuGet sunucusuna eklentinizi gönderir. Eğer yükleme başarılı olursa, eklentiniz kısa süre içinde NuGet galerisinde görünecektir.

Güncelleme ve Kaldırma

Kullanıcılar eklentinizi yükledikten sonra güncellemeleri ve kaldırmaları için aşağıdaki komutları verebilirler:

Güncelleme:
```
dotnet tool update -g mytool
```
Kaldırma:
```
dotnet tool uninstall -g mytool
```

Bu komutlar, eklentinizin yeni sürümlerini dağıttığınızda kullanıcıların kolayca güncelleme yapmasını sağlar.

Paketleme ve Yayınlama Sırasında Karşılaşılabilecek Sorunlar

"Tool 'mytool' was not found" hatası:
Eklentiyi kurarken bu hatayı alırsanız, paket adının ve ToolCommandName ayarının doğru olup olmadığını kontrol edin.
NuGet API hataları:
API anahtarınızın doğru olduğundan ve NuGet üzerindeki paket tanımlarınızın eksiksiz olduğundan emin olun.
Eksik bağımlılıklar:
Eklentiniz başka kütüphanelere bağımlıysa, *.csproj dosyasında tüm bağımlılıkların tanımlandığından emin olun.

Bu adımlarla, CLI eklentinizi başarıyla paketleyebilir ve isterseniz NuGet galerisinde yayınlayabilirsiniz. Paketleme işlemi, aracınızı farklı sistemlerde kolayca kullanmanıza ve paylaşmanıza olanak sağlar.

5. NuGet Üzerinden Yayınlama veya Lokal Kurulum

CLI eklentinizi yayınladıktan sonra iki şekilde kullanılabilir hale getirebilirsiniz: lokal kurulum ile kendi makinenizde test edebilir veya NuGet galerisinde yayınlayarak herkesin kullanımına sunabilirsiniz. Bu adımda, her iki yöntemi de ayrıntılarıyla inceleyeceğiz.

Lokal Kurulum

Eklentinizi NuGet'e göndermeden önce lokal ortamda test etmek iyi bir fikirdir. Böylece paketleme işleminin başarılı olup olmadığını ve komutların beklediğiniz gibi çalışıp çalışmadığını görebilirsiniz.

Paket Dosyanızın Yolunu Belirleyin:
Derleme işleminden sonra bin/Release dizininde oluşturulan .nupkg dosyasının bulunduğu konuma gidin.
Eklentiyi Lokal Olarak Kurun: Aşağıdaki komutla, eklentiyi makinenize global olarak kurun:
```
dotnet tool install --global --add-source ./bin/Release mytool
```
Kurulum Sonrası Test Edin:
Eklentinizin çalışıp çalışmadığını görmek için komut satırında aşağıdaki gibi basit bir komut çalıştırın:
```
mytool merhaba
```
Çıktı:
```
Merhaba, dünya!
```
Kurulumu Kaldırmak:
Test işlemi bittikten sonra eklentiyi kaldırmak isterseniz, şu komutu kullanın:
```
dotnet tool uninstall -g mytool
```

NuGet Üzerinde Yayınlama

Eğer eklentinizi herkesin erişimine açmak istiyorsanız, NuGet üzerinde yayınlamanız gerekir. Aşağıda, NuGet yayınlama adımlarını bulabilirsiniz.

NuGet API Anahtarını Alın:
NuGet galerisinde oturum açın ve NuGet API Keys sayfasına gidin. Buradan yeni bir API anahtarı oluşturun.

NuGet Paketini Gönderme:
Aşağıdaki komutu kullanarak paket dosyanızı NuGet sunucusuna yükleyin:

dotnet nuget push bin/Release/MyDotNetPlugin.1.0.0.nupkg -k <API_KEY> -s https://api.nuget.org/v3/index.json

Paketin Yayınlandığını Kontrol Edin:
Yükleme işlemi tamamlandığında, paketinizin NuGet galerisinde görünüp görünmediğini kontrol edin. Birkaç dakika içinde https://www.nuget.org adresinde eklentiniz listelenmiş olmalıdır.

NuGet Üzerinden Kurulum ve Güncelleme

Paketiniz NuGet galerisinde yayınlandıktan sonra, kullanıcılar aşağıdaki komutla eklentiyi kurabilirler:

dotnet tool install --global mytool

Eğer eklentinizin yeni bir sürümünü yayınladıysanız, kullanıcılar şu komutla güncelleyebilirler:

dotnet tool update -g mytool

Kurulumda veya güncellemede bir sorun olursa, kullanıcılar paketinizin NuGet adresini kontrol edebilir veya paket bağımlılıklarının doğru tanımlandığından emin olmalıdır.

Yayınlama ve Kurulum Sorunları

API Hatası: API anahtarınızı doğru şekilde girdiğinizden ve anahtarın süresinin dolmadığından emin olun.
Paket Bulunamıyor: Eğer kullanıcılar paketinizin adını bulamıyorsa, ToolCommandName ile paket adınızın uyumlu olduğundan emin olun.
Paket Versiyonları: NuGet sürümleme kurallarına uymak için her güncellemede versiyon numarasını artırmanız gerekir.

Bu adımlarla, eklentinizi hem lokal ortamda test edip hem de NuGet üzerinde tüm kullanıcılara açabilirsiniz. Bu süreç, aracınızın farklı platformlarda kullanılabilmesini ve güncel tutulmasını sağlar.

6. Kullanım

CLI eklentinizi başarıyla paketleyip kurduktan sonra, komut satırında kullanıma hazır hale gelir. Şimdi, eklentinizi nasıl kullanabileceğinizi, farklı komutları nasıl çalıştırabileceğinizi ve olası kullanım senaryolarını inceleyelim.

Kurulu Eklentiyi Çalıştırma

Eğer eklentinizi lokal olarak kurduysanız veya NuGet galerisinden yüklediyseniz, eklentinizi komut satırında kullanmaya hazırsınız. Eklentiyi şu şekilde çalıştırabilirsiniz:

mytool

Eğer komut satırında bir argüman vermeden çalıştırırsanız, eklentiniz varsayılan bir talimat veya bilgi mesajı dönecektir. Örneğin, aşağıdaki gibi:

Kullanım: mytool <komut> [parametreler]
Örnek: mytool merhaba

Komut Örnekleri

Eklentinizin içine yazdığınız komutlara göre farklı çıktılar alabilirsiniz. Örnek olarak, eklentinizde tanımlı olan komutların nasıl çalıştığını inceleyelim:

Merhaba Komutu:
```
mytool merhaba
```
Çıktı:
```
Merhaba, dünya!
```

Zaman Komutu:

mytool zaman

Çıktı:

Şu anki saat: 2024-10-24 12:45:00

Topla Komutu: Kullanıcıdan iki sayı alarak toplamını hesaplar:
```
mytool topla 10 20
```
Çıktı:
```
Sonuç: 30
```

Hatalı Komut Girişi: Eklentiye tanımlanmayan bir komut verdiğinizde:

mytool bilinmeyen

Çıktı:

Bilinmeyen komut: bilinmeyen
Kullanılabilir komutlar: merhaba, zaman, topla

Eklentiyi Güncelleme ve Kaldırma

Güncelleme:
Eğer eklentinin daha yeni bir sürümü yayınlandıysa, kullanıcılar aşağıdaki komutla en son sürüme güncelleyebilir:

dotnet tool update -g mytool

Kaldırma:
Eklentiyi sisteminizden kaldırmak isterseniz, şu komutu kullanın:

dotnet tool uninstall -g mytool

Farklı Senaryolar İçin Kullanım

Komut satırı otomasyonu: Sık tekrarlanan işlemleri otomatikleştirmek için eklentiyi planlayıcılar veya CI/CD süreçlerinde kullanabilirsiniz.
Alt komutlarla modüler yapı: Komut satırına yeni alt komutlar ekleyerek eklentiyi modüler hale getirebilirsiniz.
Parametrelerle esnek yapı: İsteğe bağlı parametreler ekleyerek kullanıcıya daha fazla esneklik sağlayabilirsiniz.

7. Güncelleme ve Kaldırma

CLI eklentinizin kullanıcıların sistemlerinde sorunsuz çalışmaya devam etmesi için zaman zaman güncellemeler yapmanız gerekebilir. Ayrıca, kullanıcılar istedikleri zaman eklentiyi kaldırmak isteyebilirler. Bu bölümde, eklentinizin güncellenmesi ve kaldırılması süreçlerini inceleyeceğiz.

Güncelleme İşlemi

Eğer eklentinizin yeni bir sürümünü yayınladıysanız (örneğin, hata düzeltmeleri veya yeni özellikler eklediyseniz), kullanıcılar bu sürüme kolayca geçiş yapabilirler. Güncelleme işlemi aşağıdaki komut ile yapılır:

dotnet tool update -g mytool

Bu komut, NuGet üzerindeki en son sürümü kontrol eder ve otomatik olarak indirip kurar. Eğer güncelleme başarılı olursa, terminalde aşağıdaki gibi bir mesaj alırsınız:

Tool 'mytool' was successfully updated to version 1.1.0.

Not:

Kullanıcıların yeni sürümü edinebilmesi için, yayınlanan sürüm numarasının artırılmış olması gerekir (örneğin, 1.0.0’dan 1.1.0’a).
Eğer kullanıcı güncelleme sırasında hata alırsa, NuGet paket önbelleği veya ağ bağlantısını kontrol etmeleri gerekebilir.

Eklentiyi Kaldırma

Kullanıcılar herhangi bir nedenle eklentiyi sistemlerinden kaldırmak isterse, şu komutu kullanabilirler:

dotnet tool uninstall -g mytool

Bu komut, eklentiyi sistemden kaldırır ve global araçlar listesinden siler. Eğer işlem başarılı olursa, şu mesaj görüntülenir:

Tool 'mytool' was successfully uninstalled.

Not:

Eğer kullanıcı farklı bir versiyona sahip birden fazla kurulum yaptıysa (örneğin lokal ve global), her kurulum için ayrı ayrı kaldırma komutu çalıştırmaları gerekebilir.

Olası Sorunlar ve Çözümleri

“Tool not found” Hatası: Kullanıcı eklentiyi daha önce kurmamış olabilir veya doğru isimle kaldırma komutunu vermemiş olabilir. Bu durumda, şu komutla yüklü araçları kontrol edin:
```
dotnet tool list -g
```
Güncelleme Hataları: Eğer güncelleme sırasında NuGet’e bağlantı sağlanamıyorsa, kullanıcının ağ bağlantısını kontrol etmesi veya NuGet kaynağını manuel olarak belirtmesi gerekebilir:
```
dotnet tool update -g mytool --add-source https://api.nuget.org/v3/index.json
```

Güncelleme ve Kaldırma Sürecinin Önemi

Güncel kalmak: Eklentiyi düzenli olarak güncelleyerek hata düzeltmeleri ve performans iyileştirmeleri sunabilirsiniz.
Esnek kullanım: Kullanıcıların istedikleri zaman eklentiyi kaldırabilmesi, onların sistem yönetimini kolaylaştırır ve eklentinizin kullanıcı dostu olmasını sağlar.

Bu adımlarla, kullanıcılar eklentinizi kolayca güncelleyebilir ve gerekirse sistemlerinden kaldırabilirler. Eklentiyi düzenli olarak güncel tutarak daha iyi bir deneyim sunabilir ve kullanıcılarınıza ihtiyaçlarına uygun yeni özellikler sağlayabilirsiniz.

Özet

Bu makalede, .NET CLI için kendi eklentinizi nasıl geliştirebileceğinizi adım adım inceledik. Basit bir console application projesinden yola çıkarak, projenizi nasıl CLI aracı haline getirebileceğinizi, paketleyip lokal ortamda test edebileceğinizi ve NuGet üzerinden yayınlayabileceğinizi gördük. Ayrıca, eklentinize farklı komutlar ekleme, argümanları işleme için kullanışlı kütüphaneleri tanıma ve güncelleme-kaldırma işlemleri hakkında bilgi sahibi olduk.

CLI eklentileri, sık tekrarlanan görevleri otomatikleştirmenin ve yazılım geliştirme süreçlerinizi hızlandırmanın mükemmel bir yoludur. Kendi eklentilerinizi geliştirerek, hem projelerinize özel araçlar oluşturabilir hem de iş akışınızı optimize edebilirsiniz. NuGet üzerinde yayınladığınız araçlarla, hem kendinize hem de topluluğa katkıda bulunabilirsiniz.

Artık elinizde, temel CLI araçları geliştirmek ve yayınlamak için gereken tüm bilgiler var. Projelerinizi geliştirdikçe, yeni komutlar ekleyebilir, argüman işleme sürecini genişletebilir ve aracınızı daha modüler hale getirebilirsiniz. Hangi projede olursanız olun, bir CLI aracıyla işlerinizi daha hızlı ve verimli hale getirmek tamamen sizin elinizde!

Eklentinizi geliştirme ve paylaşma sürecinde başarılar!

Kodlamada Yapay Zeka nasıl?

noreply@blogger.com (Alper Konuralp) — Sat, 28 Sep 2024 11:31:00 +0000

Merhaba,

Kodlama yaparken yapay zekadan faydalandığımızda esasında ne kadar yararlı! bir araç olduğunu farkediyoruz. Ben özellikle son dönemde şirketimizin Amazon ile anlaşması sayesinde Amazon Q Developer'ı deneyimliyorum. Bu noktada özellikle kod tamamlama noktasında başarılı olduğunu bazen tam yazmak istediğimi tahmin ettiğini görmek farklı ve güzel olabilmekte. Ancak sohbet üzerinden birşeyler sorduğumuzda gelen cevapların ne kadar sağlıklı olduğu noktasında çok büyük çekincelerim var. Bu sebeple bu haliyle yapay zekanın şu anki halinin bize belli noktaya kadar faydalı bir asistandan öteye gidemediğini söylemek yanlış olmaz. Bu makalede sizlerle paylaşmak istediğim bir örnek senaryo var. Bu senaryo ile bizim repository katmanında geliştirdiğimiz bir kodun refactoring süreci sırasında karşılaştım. Şöyle ki, kullanmakta olduğumuz bir standart repository metodunun bir senaryoda boşu boşuna veri tabanına gittiğini farkettim. Bunu düzeltmek için bir kod değişikliğini önce kendim yaptım. Sonrada bakalım Amazon Q Developer ve diğer yapay zeka modelleri bu konuda ne yapacak diye düşünerek aynı durumdaki diğer method'da bu değişikliği yapay zekadan istedim. Makalenin devamında sonuçları sizlerle paylaşacağım.

Öncelikle kodun benim değiştirdiğim halini sizlere göstermek istiyorum:

Bu kodda görebileceğiniz gibi ListByIdsAsync metodu bir ids parametresi alıyor. Eğer bu parametre null ve boş ise o zaman sorgu boşu boşuna DB'ye erişip hiç birşey dönmese dahi DB'yi meşkul ediyor. Bu yüzden buradaki işleme bir el atmak gerekiyordu. Bu noktada benim yaptığım müdehale parametreden gelen bilginin dolu olup olmadığını kontrol eden kodları içeri yerleştirmek şeklinde oldu. Bu sayede eğer veri yok ise hiç db'ye gitmeden geriye boş bir list dönebiliyoruz. Bu da işlem zamanımızı azaltıyor.

Bu kodda dikkat etmek gereken bazı noktalar vardı. Şöyle ki, parametre tipimiz IEnumerable türünde olduğu için normalde IEnumerable tipinin forward only bir tip olduğunu unutmamak lazım. Bu şu anlama geliyor. Herhangi bir nedenden dolayı bu tipin içindeki verileri bir kere okursanız, aynı referans üzerinden tekrar işlem yaptığınızda boş bir eleman sizi karşılayabilir. Bu sebeple eğer kontrol yapacak isem bu veriyi korumaya almam şart. Bende bunu sağlamak için yeni koddaki 120. satırı yazdım. ids.ToArray() metodu ile verimizi bir diziye dönüştürüyoruz. Sonrada bu dizi üzerinden istediğimiz işleri istediğimiz kadar tekrar tekrar yapabiliyoruz. Ancak bunun ilave bir memory kullanımı olacağını unutmamak lazım. Bu sebeple core repository'miz içinde benzer bir metot daha eklemek daha iyi sonuçlar verecektir. Neyse konumuz şu anda bu değil.

Biz konumuza döndüğümüzde, koddaki değişikliğimiz böyle. 2. metodumuz olan ListBySourceColumnListAsync isimli metotda benzer bir işlemi Q developer ile yapmaya çalıştığımda şöyle bir sonuç aldım. Burada esasında bir ekrana sığmayan bir görüntü idi. Ben PhotoShop yardımıyla bu parçaları birleştirerek tek bir ekran görüntüsüne dönüştürdüm :

Sonuç böyle olunca hemen ChatGPT ne diyecek diye baktım :

Tabi buradan başlayınca lokalde çalıştırdığım modellere de bir bakayım dedim. Kullandığım prompt şöyle :

Aşağıdaki koddaki sourceItemId parametresi null veya boş ise direk boş liste dönsün istiyorum. Bunu yapmanın en doğru yolu ne olur?

```csharp
        public Task<List<TEntity>> ListBySourceColumnListAsync(string sourceProviderKey, IEnumerable<string> sourceItemId)
        {
            return _dbContext
                        .Set<TEntity>()
                        .AsNoTracking()
                        .Where(x => x.SourceProviderKey == sourceProviderKey
                            && sourceItemId.Contains(x.SourceItemId))
                        .ToListAsync();
        }
```

Öncelikle qwen2.5-coder modeli ile denedim: bu model benimle çok muhattap bile olmadı. Tek satırla beni başından savdı:

Bir sonraki denemeyi Llama3.1 ile yaptım, sonuç yine hüsran. Ayrıca Llama daha kötü çünkü her nekadar bu işlem çalıştırılmayacak olsa da(Entity Framework Core bu Linq Expression'ı Sql cümlesine çevireceği için) yaklaşım hem EF içinde hemde normal bir .Net koleksiyonunda olsa gereksiz işlemlere neden olacaktır.

Birde lokalimde olmayan ama başka bir model olsun diye ollama.com üzerinden indirdiğim starcoder2 isimli model ile denedim ve sonuç yine hüsran oldu:

Sonuç olarak;

Bu durumu gördükten sonra yapay zekanın bizim işimizi elimizden alacağı zamanın daha gelmediğini açıkça görebiliyoruz. NVidia CEO'su bence biraz erken konuştu. Neden böyle olduğu ile ilgili daha detaylı bilgi için sizi Evrim Ağacının "Yapay Zeka Balonu Ne Zaman Patlayacak?" isimli videosuna yönlendirebilirim. Ama özet olarak LLM modelleri sizin onlara gönderdiğiniz promptları tam olarak anlamıyorlar. Sadece bu kelimelerin birbirleri ardına gelmesinin istatistiği üzerinde çalışıyorlar. O yüzden de bize verdikleri cevaplar yaratıcılıktan yoksun. Buna bir anlamda düşünmeden ezbere cevap veriyorlar desek daha doğru olur.

Evet işte böyle. Bir makalenin sonuna daha geldik. başka bir makalede görüşmek üzere.

Yolun Başında: “.Net 8 ve C# Yolculuğumuz”

noreply@blogger.com (Alper Konuralp) — Fri, 27 Sep 2024 19:23:00 +0000

Yazılım dünyasında teknoloji hızla değişiyor ve her yeni sürüm, bizlere daha hızlı, güvenli ve verimli uygulamalar geliştirme fırsatı sunuyor. .NET 8, bu yolculuğun en son durağı ve bu seride, bu güçlü platformu derinlemesine inceleyeceğiz. C#, yıllardır yazılım dünyasında kendini kanıtlamış bir dil. Ancak, .NET ekosistemindeki gelişmelerle birlikte, C#'ı ve .NET platformunu kullanmak artık daha da güçlü hale geldi. Performans iyileştirmeleri, modern uygulama geliştirme pratikleri ve dağıtık sistem desteği gibi yenilikler, .NET 8'i her zamankinden daha cazip bir hale getiriyor.

C# ve .NET: Kısa Bir Tarihçe

C#, 2000 yılında Microsoft tarafından geliştirilen modern, nesne yönelimli bir programlama dilidir. Başlangıçta .NET Framework ile birlikte gelen C#, Windows tabanlı uygulama geliştirmeye odaklanmıştı. Ancak 2002 yılında .NET Framework'ün ilk sürümüyle birlikte C# ve .NET platformu hızla evrildi.

.NET, başlangıçta yalnızca Windows'ta çalışırken, .NET Core'un 2016'da piyasaya sürülmesiyle açık kaynaklı ve platformlar arası bir hal aldı. Bu gelişme, Microsoft’un kapalı ekosistemden uzaklaşıp daha geniş bir geliştirici topluluğuna hitap etmesini sağladı. .NET 5 ile başlayan birleşik .NET platformu, .NET 6 ve .NET 7 sürümlerinde daha da olgunlaştı ve bugün .NET 8, hem platformlar arası geliştirmede hem de performans ve güvenlik açısından büyük yeniliklerle karşımızda.

Her Seviyeden Geliştirici İçin Bir Rehber

Bu seriyi yazarken hedefim, her seviyeden yazılımcıya hitap edebilecek bir içerik sunmak. İster .NET dünyasına yeni adım atan biri olun, ister yıllardır bu platformla projeler geliştiriyor olun, burada öğrenebileceğiniz ve uygulayabileceğiniz birçok bilgi bulacaksınız. .NET 8, geliştiricilere sunduğu geniş araç seti ve performans geliştirmeleri ile her seviyeden yazılımcının ilgisini çekecek. Amacımız, teorik bilginin ötesine geçerek pratiğe dayalı, gerçek hayatta karşılaşabileceğiniz senaryolarla .NET 8 ve C#'ı en verimli şekilde kullanmanızı sağlamak.

Modern Yazılım Geliştirme Pratikleri

.NET 8’in sunduğu yenilikler ve performans iyileştirmeleri, modern yazılım geliştirme dünyasında oldukça önemli bir yer tutuyor. Özellikle, platformlar arası geliştirme yetenekleri, asenkron programlama desteği ve microservices mimarisi gibi konular, bugün yazılım geliştiren herkesin bilmesi gereken temel taşlar haline geldi. Bu seride, bu konuların nasıl uygulanacağını ve projelerinizde nasıl hayata geçirebileceğinizi birlikte keşfedeceğiz. Ayrıca, işin mutfağına inip, hangi yöntemlerin ve araçların yazılımlarınızı daha stabil, güvenli ve performanslı hale getirdiğini öğreneceğiz.

Yenilikleri Takip Etmenin Önemi

Yazılım dünyasında başarıya ulaşmanın yolu, sürekli olarak öğrenmek ve yenilikleri takip etmekten geçiyor. .NET 8, bu süreçte size büyük kolaylıklar ve güçlü araçlar sunuyor. Performans optimizasyonlarından güvenlik protokollerine, veri yönetiminden test süreçlerine kadar birçok farklı konuya değineceğiz. Her biri, yazılım geliştirme sürecinde karşılaşabileceğiniz gerçek hayat problemlerine çözüm üretmek için tasarlandı.

Bu seri sonunda, .NET 8 ve C# konusunda kapsamlı bir bilgiye sahip olacağınız gibi, bu bilgileri projelerinize uygularken de kendinize olan güveniniz tam olacak.

Karmaşıklığı Basitleştirmek

Yolculuğumuz boyunca, teknik terimlerden kaçınmadan, ancak karmaşık anlatımları basitleştirerek konuları işleyeceğiz. Böylece hem yeni başlayanlar hem de deneyimli geliştiriciler için faydalı bir kaynak oluşturmayı hedefliyorum. Her makalede, işlenen konunun özüne inerek, pratik örneklerle detayları açıklayacağız. Hedefim, bu seriyi tamamladığınızda, .NET 8 ve C#’ı sadece öğrenmekle kalmayıp, projelerinizde etkin bir şekilde kullanabileceğiniz hale gelmenizi sağlamak.

Sonuç: Başlangıç Noktası

Hazırsanız, .NET 8 ve C# dünyasına birlikte adım atalım! Bu yolculuğun sonunda, yazılım projelerinizi bir üst seviyeye taşıyacak bilgi ve araçlara sahip olacaksınız. Hadi başlayalım!

OData Server Serisi - B013 - Örnekler İçin Yeni Düzenleme

noreply@blogger.com (Alper Konuralp) — Mon, 19 Oct 2020 10:31:00 +0000

OData Server Serisi - B013 - Örnekler İçin Yeni Düzenleme | OData Server Series - E013 - New Arrangement for Samples | OData Server Series - E013 - Neue Anordnung für Beispiele | Série de serveurs OData - E013 - Nouvel arrangement pour les échantillons

Part 1:

Part 2:

Merhaba bu seride bir OData Server geliştirirken, yaşadıklarımı sizlerle paylaşmak istiyorum. Microsoft .Net Core 3.1 ve C# kullanarak geliştireceğim bu projeyi bütün adımlarıyla sizlerle paylaşacağım.

Bu 13. bölümde, Örneklerimizde daha karmaşık işler yapabilmek için varlıklarımızda bir düzenleme yapıyoruz. Bu sırada TPH (Table per Hierarchy) nedir onu inceliyoruz. Entity Framework Core'da nasıl kullanıldığını görüyoruz.

Bölüm Linkleri :

1. Inheritance On Entity Framework Core : https://docs.microsoft.com/en-US/ef/core/modeling/inheritance

2. Entity Framework Core: Enums : https://medium.com/agilix/entity-framework-core-enums-ee0f8f4063f2

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

Hello, I want to share with you what I have experienced while developing an OData Server in this series. I will share with you all the steps of this project that I will develop using Microsoft .Net Core 3.1 and C #.

In this 13th episode, we adjust our assets to do more complex work in our Samples. Meanwhile, we examine what is TPH (Table per Hierarchy). We see how it is used in Entity Framework Core.

Episode Links:

1. Inheritance On Entity Framework Core : https://docs.microsoft.com/en-US/ef/core/modeling/inheritance

2. Entity Framework Core: Enums : https://medium.com/agilix/entity-framework-core-enums-ee0f8f4063f2

Our Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

Hallo, ich möchte Ihnen mitteilen, was ich bei der Entwicklung eines OData-Servers in dieser Serie erlebt habe. Ich werde Ihnen alle Schritte dieses Projekts mitteilen, die ich mit Microsoft .Net Core 3.1 und C # entwickeln werde.

In dieser 13. Folge passen wir unser Vermögen an, um komplexere Arbeiten in unseren Samples auszuführen. In der Zwischenzeit untersuchen wir, was TPH (Tabelle pro Hierarchie) ist. Wir sehen, wie es in Entity Framework Core verwendet wird.

Episodenlinks:

1. Inheritance On Entity Framework Core : https://docs.microsoft.com/en-US/ef/core/modeling/inheritance

2. Entity Framework Core: Enums : https://medium.com/agilix/entity-framework-core-enums-ee0f8f4063f2

Unsere Projekt-GitHub-Adresse: https://github.com/alperkonuralp/ProjectODataServer

Mein Kanal: https://www.youtube.com/c/AlperKonuralp35

Hab viel Spaß.

Bonjour, je souhaite partager avec vous ce que j'ai vécu lors du développement d'un serveur OData dans cette série. Je partagerai avec vous toutes les étapes de ce projet que je développerai en utilisant Microsoft .Net Core 3.1 et C #.

Dans ce 13ème épisode, nous ajustons nos ressources pour effectuer un travail plus complexe dans nos échantillons. Pendant ce temps, nous examinons ce qu'est TPH ( Table par hiérarchie). Nous voyons comment il est utilisé dans Entity Framework Core.

Liens d'épisode:

1. Inheritance On Entity Framework Core : https://docs.microsoft.com/en-US/ef/core/modeling/inheritance

2. Entity Framework Core: Enums : https://medium.com/agilix/entity-framework-core-enums-ee0f8f4063f2

Adresse de notre projet GitHub: https://github.com/alperkonuralp/ProjectODataServer

Ma chaîne: https://www.youtube.com/c/AlperKonuralp35

Amusez-vous bien.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

Project OData Server, OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core, TPH, Entity Framework Core TPH, Table per Hierarchy

OData Server Serisi - B012 - Bugün ve Gelecek

noreply@blogger.com (Alper Konuralp) — Mon, 19 Oct 2020 10:28:00 +0000

OData Server Serisi - B012 - Bugün ve Gelecek | OData Server Series - E012 - Today & The Future | OData Server Series - E012 - Heute und die Zukunft | Série de serveurs OData - E012 - Aujourd'hui et l'avenir

Bu 12. bölümde, sizlerle OData Serisi ve Project OData Series Projesi ile ilgili gelecek planlarımı ve şu anki çalışmalarım ile ilgili bilgiler paylaşmak istiyorum.

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this 12th episode, I would like to share with you information about my future plans for the OData Series and Project OData Series Project and my current work.

Our Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

In dieser 12. Folge möchte ich Ihnen Informationen über meine zukünftigen Pläne für die OData-Serie und das Projekt OData Series Project und meine aktuelle Arbeit mitteilen.

Unsere Projekt-GitHub-Adresse: https://github.com/alperkonuralp/ProjectODataServer

Mein Kanal: https://www.youtube.com/c/AlperKonuralp35

Hab viel Spaß.

Dans ce 12ème épisode, je voudrais partager avec vous des informations sur mes projets futurs pour la série OData et le projet OData Series Project et mon travail actuel.

Adresse de notre projet GitHub: https://github.com/alperkonuralp/ProjectODataServer

Ma chaîne: https://www.youtube.com/c/AlperKonuralp35

Amusez-vous bien.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

Project OData Server, OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core,

OData Server Serisi - B011 - Loglama

noreply@blogger.com (Alper Konuralp) — Mon, 19 Oct 2020 10:27:00 +0000

OData Server Serisi - B011 - Loglama | OData Server Series - E011 - Logging | OData Server Series - E011 - Protokollierung | Série de serveurs OData - E011 - Journalisation

Bu 11. bölümde, geliştirme sırasında birkaç kere bizi zorlayan logların çalışmaması problemini çözüyoruz. Bunu yaparken Asp.Net Core, Log4Net, Castle Windsor, Castle Logging Facility ve Microsoft.Extensions.Logging başlıklarını inceledik.

Bölüm Linkleri :

1. Castle Logging Facility Source Code : https://github.com/castleproject/Windsor/blob/master/src/Castle.Facilities.Logging/LoggingFacility.cs

2. Microsoft.Extensions.Logging.Log4Net.AspNetCore : https://www.nuget.org/packages/Microsoft.Extensions.Logging.Log4Net.AspNetCore/

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this episode 11, we solve the problem of logs not working, which has been forcing us several times during development. While doing this, we examined Asp.Net Core, Log4Net, Castle Windsor, Castle Logging Facility and Microsoft.Extensions.Logging.

Episode Links:

1. Castle Logging Facility Source Code : https://github.com/castleproject/Windsor/blob/master/src/Castle.Facilities.Logging/LoggingFacility.cs

2. Microsoft.Extensions.Logging.Log4Net.AspNetCore : https://www.nuget.org/packages/Microsoft.Extensions.Logging.Log4Net.AspNetCore/

Our Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

In dieser Episode 11 lösen wir das Problem, dass Protokolle nicht funktionieren, was uns während der Entwicklung mehrmals gezwungen hat. Dabei haben wir Asp.Net Core, Log4Net, Castle Windsor, Castle Logging Facility und Microsoft.Extensions.Logging untersucht.

Episodenlinks:

1. Castle Logging Facility Source Code : https://github.com/castleproject/Windsor/blob/master/src/Castle.Facilities.Logging/LoggingFacility.cs

2. Microsoft.Extensions.Logging.Log4Net.AspNetCore : https://www.nuget.org/packages/Microsoft.Extensions.Logging.Log4Net.AspNetCore/

Unsere Projekt-GitHub-Adresse: https://github.com/alperkonuralp/ProjectODataServer

Mein Kanal: https://www.youtube.com/c/AlperKonuralp35

Hab viel Spaß.

Dans cet épisode 11, nous résolvons le problème des logs qui ne fonctionnent pas, ce qui nous a obligé à plusieurs reprises au cours du développement. Ce faisant, nous avons examiné Asp.Net Core, Log4Net, Castle Windsor, Castle Logging Facility et Microsoft.Extensions.Logging.

Liens d'épisode:

1. Castle Logging Facility Source Code : https://github.com/castleproject/Windsor/blob/master/src/Castle.Facilities.Logging/LoggingFacility.cs

2. Microsoft.Extensions.Logging.Log4Net.AspNetCore : https://www.nuget.org/packages/Microsoft.Extensions.Logging.Log4Net.AspNetCore/

Adresse de notre projet GitHub: https://github.com/alperkonuralp/ProjectODataServer

Ma chaîne: https://www.youtube.com/c/AlperKonuralp35

Amusez-vous bien.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core, Log4Net, Castle Windsor, Castle Logging Facility, Microsoft.Extensions.Logging, Microsoft.Extensions.Logging.Log4Net.AspNetCore

OData Server Serisi - B010 - OData ile Post ve Put (2)

noreply@blogger.com (Alper Konuralp) — Mon, 19 Oct 2020 10:23:00 +0000

OData Server Serisi - B010 - OData ile Post ve Put (2) | OData Server Series - E010 - OData with Post & Put (2) | OData Server Series - E010 - OData mit Post & Put (2) | Série de serveurs OData - E010 - OData avec Post & Put (2)

Bu 10. bölümde, OData Kontrolörlerimizde yazdığımız Post ve Put metotları içindeki bir probleme el atıyoruz. Esasında bu, ilk yazdığımızda eksik bıraktığımız bir konu idi. Böylece ilişkili entity'leri de beraber kaydedip, değiştirebileceğiz.

Bölüm Linkleri :

1. Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions

2. DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation

3. Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/

4. Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this 10th episode, we address a problem in the Post and Put methods we wrote in our OData Controllers. In fact, this was a subject we left incomplete when we first wrote. Thus, we will be able to save and change associated entities together.

Episode Links:

1. Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions

2. DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation

3. Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/

4. Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Our Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

In dieser 10. Folge behandeln wir ein Problem in den Post- und Put-Methoden, die wir in unseren OData-Controllern geschrieben haben. Tatsächlich war dies ein Thema, das wir beim ersten Schreiben unvollständig gelassen haben. Auf diese Weise können wir zugeordnete Entitäten gemeinsam speichern und ändern.

Episodenlinks:

1. Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions

2. DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation

3. Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/

4. Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Unsere Projekt-GitHub-Adresse: https://github.com/alperkonuralp/ProjectODataServer

Mein Kanal: https://www.youtube.com/c/AlperKonuralp35

Hab viel Spaß.

Dans ce 10ème épisode, nous abordons un problème dans les méthodes Post and Put que nous avons écrites dans nos contrôleurs OData. En fait, c'était un sujet que nous avons laissé incomplet lorsque nous avons écrit pour la première fois. Ainsi, nous pourrons enregistrer et modifier ensemble les entités associées.

Liens d'épisode:

1. Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions

2. DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation

3. Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/

4. Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Adresse de notre projet GitHub: https://github.com/alperkonuralp/ProjectODataServer

Ma chaîne: https://www.youtube.com/c/AlperKonuralp35

Amusez-vous bien.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core, HTTP PATCH

Asp.Net 3.x Docker Alpine imajlarındaki TimeZone Problemi

noreply@blogger.com (Alper Konuralp) — Thu, 08 Oct 2020 07:22:00 +0000

Merhaba,

Asp.Net Core 3.1 ile geliştirdiğimiz projemizi Docker ile OpenShift üzerinde çalıştırıyoruz. Bu projemizi teste aldığımızda farkettiğimiz bir problemi sizinle paylaşmak istiyorum.

Bildiğiniz gibi işletim sistemleri TimeZone ile ilgili bilgileri içlerinde barındırırlar. Bu sayede uygulamalar bu bilgileri kullanıp timezone ile ilgili bilgi alabilirler. Ancak Alpine linux versiyonları kırpılmış versiyonlar olduklarından default olarak bu paketlere sahip olmuyorlar. Bu durumu çözmek için DockerFile'a FROM kısmının altına şu satırı eklemek yeterli oluyor.

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-alpine

RUN apk add --no-cache tzdata

Bu sayede TZConverter gibi kütüphaneler çalışır hale gelmekte.

OData Server Serisi - B009 - OData ile Patch

noreply@blogger.com (Alper Konuralp) — Sun, 04 Oct 2020 19:58:00 +0000

OData Server Serisi - B009 - OData ile Patch | OData Server Series - E009 - OData with Patch

Bu 9. bölümde, OData Kontrolörlerimizde olmasını isteyeceğimiz "Patch" özelliğini inceliyoruz. Ancak buna geçmeden önce, bir önceki bölümde "ProductController" üzerinde yapmayı unuttuğumuz bazı işleri tamamlayacağız.

Bölüm Linkleri :

Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions
DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation
Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/
Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this 9th episode, we examine the "Patch" feature that we want to have on our OData Controllers. But before we get to that, we'll complete some work we forgot to do on "ProductController" in the previous episode.

Episode Linkleri :

Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions
DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation
Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/
Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core, HTTP PATCH

OData Server Serisi - B008 - OData ile Post, Put ve Delete

noreply@blogger.com (Alper Konuralp) — Sun, 04 Oct 2020 19:55:00 +0000

OData Server Serisi - B008 - OData ile Post, Put ve Delete | OData Server Series - E008 - OData with Post, Put & Delete

Bu 8. bölümde, OData Kontrolörlerimizde olmasını isteyeceğimiz üç özelliği inceliyoruz. Bu bölümde yazdıklarımız ile beraber OData Kontrolörlerimiz CRUD işlemlerinin tamamını yapabilecekler.

Bölüm Linkleri :

Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions
DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation
Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/
Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this episode 8, we examine three features we would like to have in our OData Controllers. With what we have written in this episode, our OData Controllers will be able to do all of the CRUD operations.

Episode Linkleri :

Routing Conventions in ASP.NET Web API 2 Odata : https://docs.microsoft.com/en-us/aspnet/web-api/overview/odata-support-in-aspnet-web-api/odata-routing-conventions
DynamicEdmModelCreation : https://github.com/OData/ODataSamples/tree/master/WebApiCore/DynamicEdmModelCreation
Operations (OData Version 2.0) : https://www.odata.org/documentation/odata-version-2-0/operations/
Understand OData in 6 steps : https://www.odata.org/getting-started/understand-odata-in-6-steps/

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core, HTTP POST, HTTP PUT, HTTP DELETE

OData Server Serisi - B007 - OData ile Select

noreply@blogger.com (Alper Konuralp) — Sun, 04 Oct 2020 19:53:00 +0000

OData Server Serisi - B007 - OData ile Select | OData Server Series - E007 - OData with Select

Bu 7. bölümde, OData Kontrolörlerimizde olmasını isteyeceğimiz iki özelliği inceliyoruz. Böylece OData kontrolörlerimiz daha yetenekli olacaklar.

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this episode 7, we examine two features we would like to have in our OData Controllers. Thus, our OData controllers will be more capable.

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core, Dynamic Controllers

OData Server Serisi - B006 - Dinamik Kontrolörler

noreply@blogger.com (Alper Konuralp) — Sun, 04 Oct 2020 19:51:00 +0000

OData Server Serisi - B006 - Dinamik Kontrolörler | OData Server Series - E006 - Dynamic Controllers

Bu 6. bölümde projemize, projemizin en önemli parçalarından olan dinamik kod çalıştırma ile ilgileniyoruz. Yani çalışma zamanında string olarak hazırladığımız kodları derleyip, odata sunucumuzu bu dinamik kodlarla çalıştırıyoruz. Bu bölüm benim için en heyecan verici bölümlerden biri. Hadi ne duruyoruz, hemen başlayalım.

Bölüm linkleri :

Generic and dynamically generated controllers in ASP.NET Core MVC : https://www.strathweb.com/2018/04/generic-and-dynamically-generated-controllers-in-asp-net-core-mvc/
ASP.Net Core register Controller at runtime : https://stackoverflow.com/questions/46156649/asp-net-core-register-controller-at-runtime
Generic controllers in ASP.Net Core : https://www.ben-morris.com/generic-controllers-in-asp-net-core/
Share controllers, views, Razor Pages and more with Application Parts : https://docs.microsoft.com/en-us/aspnet/core/mvc/advanced/app-parts?view=aspnetcore-3.1
[ASP. Net core] to realize dynamic web API : https://developpaper.com/asp-net-core-to-realize-dynamic-web-api/

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

This 6th section is about "dynamic code execution", one of the most important parts of our project. In other words, we compile the codes we have prepared as strings at runtime and run our OData server with these dynamic codes. This episode is one of the most exciting episodes for me. Come on, let's get started right away.

Section links:

Generic and dynamically generated controllers in ASP.NET Core MVC : https://www.strathweb.com/2018/04/generic-and-dynamically-generated-controllers-in-asp-net-core-mvc/
ASP.Net Core register Controller at runtime : https://stackoverflow.com/questions/46156649/asp-net-core-register-controller-at-runtime
Generic controllers in ASP.Net Core : https://www.ben-morris.com/generic-controllers-in-asp-net-core/
Share controllers, views, Razor Pages and more with Application Parts : https://docs.microsoft.com/en-us/aspnet/core/mvc/advanced/app-parts?view=aspnetcore-3.1
[ASP. Net core] to realize dynamic web API : https://developpaper.com/asp-net-core-to-realize-dynamic-web-api/

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

Music: https://www.bensound.com

Intro : Logo PA https://www.youtube.com/channel/UC9YpORZEI7TTaAMtmBL8Yzw

Outro : EnzeeFX https://www.youtube.com/c/EnzeeFX

Tags :

OData, OData Server, Alper Konuralp, Microsoft.Net Core, Microsoft.Net Asp.Net Core, OData WebApi, Entity Framework Core, Dynamic Controllers

OData Server Serisi - B005 - OData'ya Giriş

noreply@blogger.com (Alper Konuralp) — Sun, 27 Sep 2020 21:47:00 +0000

OData Server Serisi - B005 - OData'ya Giriş | OData Server Series - E005 - Introduction to OData

Bu 5. bölümde projemize, OData'yı ekliyoruz. Bir önceki bölümde hazırladığımız 2 varlığı dünyaya açacağız.

Bölüm linkleri :

OData.org : https://www.odata.org/
OData WebApi : https://github.com/OData/WebApi
Enabling Endpoint Routing in OData : https://devblogs.microsoft.com/odata/enabling-endpoint-routing-in-odata/

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this 5th section, we add OData to our project. We will open the 2 assets we prepared in the previous section to the world.

Section links:

OData.org : https://www.odata.org/
OData WebApi : https://github.com/OData/WebApi
Enabling Endpoint Routing in OData : https://devblogs.microsoft.com/odata/enabling-endpoint-routing-in-odata/

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

OData Server Serisi - B004 - Entity Framework

noreply@blogger.com (Alper Konuralp) — Sun, 27 Sep 2020 21:45:00 +0000

OData Server Serisi - B004 - Entity Framework | OData Server Series - E004 - Entity Framework

Bu 4. bölümde projemize, Entity Framework ekliyoruz. Sqlite kullanan, 2 varlıktan oluşan bir Entity Framework uygulamasının nasıl yapıldığını göreceğiz.

Bölüm linkleri :

Design-time DbContext Creation : https://docs.microsoft.com/tr-tr/ef/core/miscellaneous/cli/dbcontext-creation
Logging in Entity Framework Core : https://www.entityframeworktutorial.net/efcore/logging-in-entityframework-core.aspx

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this 4th part, we add Entity Framework to our project. We will see how to make an Entity Framework application consisting of 2 entities using sqlite.

Section links:

Design-time DbContext Creation : https://docs.microsoft.com/tr-tr/ef/core/miscellaneous/cli/dbcontext-creation
Logging in Entity Framework Core : https://www.entityframeworktutorial.net/efcore/logging-in-entityframework-core.aspx

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

OData Server Serisi - B003 - Castle Windsor

noreply@blogger.com (Alper Konuralp) — Sun, 27 Sep 2020 21:43:00 +0000

OData Server Serisi - B003 - Castle Windsor | OData Server Series - E003 - Castle Windsor

Bu 3. bölümde projemize, Castle Windsor ve Log4net paketlerini ekliyoruz. Castle Windsor ile projemize tak çalıştır desteği gelirken, log4net ile loglama sistemimiz oluyor.

Bölüm linkleri :

Castle Windsor : https://github.com/castleproject/Windsor
log4net : http://logging.apache.org/log4net/

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this 3rd part, we add Castle Windsor and Log4net packages to our project. With Castle Windsor, we have plug and play support for our project, and we have a logging system with log4net.

Section links:

Castle Windsor: https://github.com/castleproject/Windsor
log4net: http://logging.apache.org/log4net/

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

OData Server Serisi - B002 - Proje Hazırlığı

noreply@blogger.com (Alper Konuralp) — Sun, 27 Sep 2020 21:40:00 +0000

OData Server Serisi - B002 - Proje Hazırlığı | OData Server Series - E002 - The project preparation

Bu 2. bölümde boş projemizi GitHub'dan indirip, yeni solution'ımızı oluşturuyoruz.

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

In this 2nd part, we download our blank project from GitHub and create our new solution.

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

OData Server Serisi - B001 - Tanışma

noreply@blogger.com (Alper Konuralp) — Sun, 27 Sep 2020 21:36:00 +0000

OData Server Serisi - B001 - Tanışma | OData Server Series - E001 - Pilot

Projemizin GitHub adresi : https://github.com/alperkonuralp/ProjectODataServer

Kanalım : https://www.youtube.com/c/AlperKonuralp35

İyi seyirler.

Out Project GitHub address : https://github.com/alperkonuralp/ProjectODataServer

My Channel : https://www.youtube.com/c/AlperKonuralp35

Have a good time.

Vue.js, Vuetify, Typescript ve Jest ile unit test yazmak

noreply@blogger.com (Alper Konuralp) — Mon, 11 Feb 2019 09:01:00 +0000

Vue.js, Vuetify, Typescript ve Jest ile unit test yazmak

Writing unit test with Vue.js, Vuetify, Typescript and Jest

Geliştirmekte olduğumuz proje kapsamında Vue.js, Vuetify ve Typescript ile çalışmaktayız. Burada unit test yazmak istediğimizde biraz araştırma yapmak, ve çıkan problemlerle boğuşmak zorunda kaldık. Bu yazıda bulduğumuz çözümler ile konuyu anlatmak istiyorum :
Öncelikle unit test aracı olarak jest kullanmaya karar verdik. Vue.js Cli tarafından öncelik Mocka'ya verilmiş olsada bizim projemizde onu açlıştırmak hiç kolay olmadı. Sıkıntı typescript kullanmamızdan kaynaklanmakta. bu iş için kullanacağımız araçların hepsi typescript destekli değil maalesef. Gelelim adımlara :
1. npm ile bazı paketleri projemize eklememiz lazım :
npm i -D jest@23.6.0 jsdom@13.2.0 jsdom-global@3.0.2 ts-jest@23.10.5 @vue/test-utils @vue/cli-plugin-unit-jest @vue/cli-plugin-typescript

Burada önemli nokta jest sürümünün 23'de kalması. Çünkü ts-jest şu anda (11.02.2019 itibari ile) sadece jest'in 23. versiyonuna kadar destek vermekte. jest'i 24. versiyona geçirirseniz bir sürü problem ve uyumsuzluk çıkmakta.

Ayrıca jest'i direk çağırabilmek için aşağıdaki komutu'da çalıştırmamız gerekiyor :
npm i -g jest

2. Projenizin root dizininde jest.config.js isimli bir dosya oluşturuyoruz ve aşağıdaki gibi içini dolduruyoruz:

const { defaults } = require('jest-config');
// jest.config.js
 
module.exports = {
  preset: 'ts-jest',
  testEnvironment: 'node',
  moduleNameMapper: { '^@/(.*)$': '<rootDir>/src/$1' },
  moduleFileExtensions: [
    ...defaults.moduleFileExtensions,
    // tell Jest to handle `*.vue` files
    "vue",
    'ts',
    'tsx'
  ],
  transform: {
    // process `*.vue` files with `vue-jest`
    '^.+\\.vue$': 'vue-jest',
    '.+\\.(css|styl|less|sass|scss|svg|png|jpg|ttf|woff|woff2)$': 'jest-transform-stub',
    '^.+\\.tsx?$': 'ts-jest'
  },
  snapshotSerializers: [
    'jest-serializer-vue'
  ],
  testMatch: [
    '**/tests/unit/**/*.(spec|test).(js|jsx|ts|tsx)|**/__tests__/*.(js|jsx|ts|tsx)'
  ],
  testURL: 'http://localhost/',
  globals: {
    window: {
      navigator: {
        userAgent: 'node'
      }
    },
 
    navigator: {
      userAgent: 'node'
    }
  },
 
  setupTestFrameworkScriptFile: "<rootDir>/tests/jest-setup.ts",
  collectCoverage: true
};

collectCoverage ile projemizin coverage'ını görmemiz sağlanmış olmakta.
Testlerimizin, projenin root dizininin altındaki tests isimli dizinde yer alacağını söylemekteyiz. Ben biraz düzen manyağı olduğum için alt dizinlerle çalışabilmek içinde /**/ şeklindeki path yazımını kullanıyorum. Böylece tests altındaki bütün alt dizinlerde taranıyor. Ayrıca test olarak sistem sadece .test.ts , .spec.ts , .test.js , .spec.js uzantılarını kabul etmekte. tsx ve jsx de var ama biz bunları kullanmadığımız için pas geçtim.

3. tests dizininin içinde jest-setup.ts dosyasını oluşturuyoruz. Bu dosya test sisteminin genel bir setup dosyası olup, ilk çalıştırılan dosya olmakta.

//  package.json has a section that instructs jest to
//  read this setup/startup file.

// jsdom 'u testler için register ediyoruz.
import jsdomGlobal from 'jsdom-global';
jsdomGlobal();
 
// Vue kullanmak yerine localVue kullandığımız için bu kısmı yorum haline getirdim. 
import Vue from 'vue';
 
// //  DON'T DO THIS or you'll have problems like <v-btn :to="..."> rendering
// //  as <router-link> instead of <a href="..."> on the unit tests.
// //  See tests/Foo.spec.js to learn how to use Vuetify in the unit tests.
// // import Vuetify from 'vuetify';
// // Vue.use(Vuetify); // NO, DON'T DO THIS.

// //  You may not need this. Uncomment only if you see some sort of
// //  regeneratorRuntime error.
// // import 'babel-polyfill';

//  So we don't see unnecessary Vue warnings about production.
Vue.config.productionTip = false;

Gördüğünüz gibi Vue'de burada register olmakta.

4. Sonrada isteğinize göre test dosyalarınızı oluşturabiliyorsunuz:

import { shallowMount } from '@vue/test-utils';
import CustomCommandColumn from '../../../../../src/components/data-table/components/columns/custom-command-column.vue';
import Vuetify from 'vuetify';
import Vue from 'vue';
 
describe('custom-command-column-without-tooltip', () => {
  Vue.use(Vuetify);
 
  const c = shallowMount(CustomCommandColumn, {
    propsData:
    {
      row: {},
      custom: {
        key: 'cc1',
        icon: 'fa-ink',
      },
    },
  });
 
  it('Simple use without tooltip', () => {
    const vm: any = c.vm;
    expect(vm.isVisible).toBe(true);
    expect(vm.custom.icon).toBe('fa-ink');
    // console.log(c.element.outerHTML);
    expect(c.find('v-icon-stub').exists()).toBe(true);
    expect(c.find('v-tooltip-stub').exists()).toBe(false);
  });
});

5. Test'leri çalıştırmak için command prompt veya terminal'de jest yazmanız yeterli olacaktır. Ancak npm ile çalıştığımız için package.json içerisine bir scripts ekleyerek bu işin npm'de yapılmasını da sağlıyoruz.

    "test": "jest",

bunun kullanımı ise
npm t
komutu ile olmakta :

Vue.js Unit Test için mount ve shallowMount farkı

noreply@blogger.com (Alper Konuralp) — Mon, 11 Feb 2019 08:30:00 +0000

Vue.js Unit Test için mount ve shallowMount farkı

mount and shallowMount difference for Vue.js Unit Test

Vue.js ile unit test yazmak istediğinizde karşımıza 2 yardımcı(helper) metod çıkıyor. Bunlardan ilki mount : Bu metod komponent'imizin test edebileceğimiz bir örneğini sağlarken, bu komponent'in içindeki bütün alt komponent'leri de oluşturmaktadir. Yani iç içe kullandığımız bütün komponent'lerimiz oluşturulup kullanıma sunulmaktadır. mount ile dökümandaki bir örneği aşağıda görebilirsiniz :

When you want to write a unit test with Vue.js, we can use 2 helper methods. The first of these is "mount": While this method provides an instance of our component that we can test, it also creates all the sub-components inside this component. In other words, all components that we use nested are created and made available. Here is an example of the document with mount:

import { mount } from '@vue/test-utils';
import Foo from './Foo.vue';

describe('Foo', () => {
  it('renders a div', () => {
    const wrapper = mount(Foo);
    expect(wrapper.contains('div')).toBe(true);
  });
});

Burada Foo ismindeki komponent'imiz içindeki bütün alt komponent'lerle beraber oluşturulup kullanıma sunulur. Büyük bir iş sürecini test etmek istediğimizde kullanabileceğimiz bir yöntem.

Here, the component called Foo is created with all sub components in it. A method we can use when we want to test a large business process.

shallowMount : Bu metod mount metoduna çok benzemekle beraber, farklı olarak, sadece çalışılan komponent'i oluşturup, alt komponent'leri "-stub" son eki ile isimlendirip aynı bırakır. Örnek olarak kendi kodumdan şöyle bir örnek verebilirim :

shallowMount: This method is very similar to the mount method. Unlike, this method generates only the main component. This method changes names the sub-components with the suffix "-stub". But this method does not create an instance for sub components. For example, let me share a part of my own code:

<template>
  <div v-if="isVisible">
    &nbsp;
    <v-tooltip top v-if="!!custom.tooltip">
      <v-icon slot="activator" @click.stop="customClicked">{{ custom.icon }}</v-icon>
      <span>{{ custom.tooltip | translate }}</span>
    </v-tooltip>
    <v-icon v-else @click.stop="customClicked">{{ custom.icon }}</v-icon>
  </div>
</template>
<script lang="ts">

Burada vuetify ile geliştirdiğim bir komponent görünmektedir. Bu komponent'i shallowMount ile oluşturduğumuzda şöyle bir sonuç alıyoruz :

Here I see a component I developed with vuetify. When we create this component with shallowMount, we get a result:

<div>
    &nbsp;
    <v-tooltip-stub opendelay="200"

                    closedelay="200"

                    contentclass=""

                    fixed="true"

                    top="true"

                    maxwidth="auto"

                    nudgebottom="0"

                    nudgeleft="0"

                    nudgeright="0"

                    nudgetop="0"

                    nudgewidth="0"

                    debounce="0"

                    tag="span">
        <v-icon-stub>

            fa-ink

        </v-icon-stub>

        <span>Deneme</span>

    </v-tooltip-stub>
</div>

Dikkat edebileceğiniz gibi, v-tooltip komponent'i v-tooltip-stub olarak, v-icon komponent'i de v-icon-stub olarak aynen korunmuş durumdadır. mount metodunu kullanmış olsaydık, bu komponentlerin de render edilmiş hallerini çıktıda görecektik.

As you may notice, the v-tooltip component is v-tooltip-stub, and the v-icon component is protected as v-icon-stub. If we had used the mount method, we would see the rendered version of these components in the output.

Vue Unit Test ile alt komponent olaylarının(events) testi

noreply@blogger.com (Alper Konuralp) — Mon, 11 Feb 2019 08:08:00 +0000

Vue Unit Test ile alt komponent olaylarının(events) testi

Testing of sub-component events with Vue Unit Test

Vue.js, Vuetify ve typescript ile geliştirdiğimiz komponentlerimiz için unit test yazmak istediğimizde karşımıza çıkan bir sorundan bahsetmek istiyorum. Hazırladığımız komponent içinde yeralan bir icon (vuetify v-icon komponenti) üzerinde yazmış olduğumuz @click event'ının tetiklenmesi gerekiyor. Bunu jest kullandığımız unit testimizde nasıl tetikleriz diye düşündüm. Araştırma yaptım. Ancak önerilen yöntemler maalesef sonuç vermedi. Önce kodlara bir bakalım :

I would like to talk about a problem that we encountered when we wanted to write a unit test for our components we developed with Vue.js, Vuetify and typescript. We need to trigger the @click event that we wrote on an icon in the component we prepared. I thought about how to trigger this in our unit test, which we used as a "Jest". I did research. However, the recommended methods did not yield results. Let's look at the codes first:

Vue Komponent'imiz: Our Vue Component:

<template>
  <div v-if="isVisible">
    &nbsp;
    <v-tooltip top v-if="!!custom.tooltip">
      <v-icon slot="activator" @click.stop="customClicked">{{ custom.icon }}</v-icon>
      <span>{{ custom.tooltip | translate }}</span>
    </v-tooltip>
    <v-icon v-else @click.stop="customClicked">{{ custom.icon }}</v-icon>
  </div>
</template>
<script lang="ts">

...

Burada ben çözümü komponent'in üzerindeki event'i tetiklemek yerine, event için atanmış customClicked metodunu tetiklemek olarak buldum. v-icon component'i üzerindeki @click event'ının çalışcağından emin olduğumuz için bu mantıklı bir yaklaşım olmakta.

Here I found the solution as triggering the customClicked method assigned to the event instead of triggering the event on the component. This is a logical approach because we're confident that the @click event on the v-icon component will work.

Test Kodumuz: Our Test Code:

import { shallowMount } from '@vue/test-utils';
import CustomCommandColumn from 'custom-command-column.vue';
import Vue from 'vue';
import Vuetify from 'vuetify';
 
describe('custom-command-column-with-action-url', () => {
  Vue.use(Vuetify);
  const routerUrls: any[] = [];
  const actionUrl = '/deneme/deneme';
 
  const $router = {
    push: (url: string) => {
      routerUrls.push(url);
      return;
    },
  };
 
  const c = shallowMount(CustomCommandColumn, {
    propsData:
    {
      row: {},
      custom: {
        key: 'cc1',
        icon: 'fa-ink',
        tooltip: '`Deneme',
        actionUrl,
      },
    },
    mocks: {
      $router,
    },
  });
 
  it('Simple use with tooltip', () => {
    const vm: any = c.vm;
    expect(vm.isVisible).toBe(true);
    expect(vm.custom.icon).toBe('fa-ink');
    expect(c.find('v-tooltip-stub v-icon-stub').exists()).toBe(true);
    vm.customClicked({});
    expect(routerUrls.some((r: string) => r === actionUrl)).toBe(true);
  });
});

Vuejs ve Typescript konuları

noreply@blogger.com (Alper Konuralp) — Mon, 11 Feb 2019 07:53:00 +0000

Son zamanlarda projelerimizde Vuejs ve typescript kullanıyoruz. Bu iki dünya ile ilgili olarak karşılaştığımız problemlerini ve çözümlerini elimden geldiğince burada paylaşmaya çalışacağım.

Typescript window objesine property ve metod eklemek

noreply@blogger.com (Alper Konuralp) — Mon, 22 Oct 2018 07:36:00 +0000

Typescript bir çok konuda başarılı bir araç olmasına rağmen, javascript'te rahatlıkla yaptığımız şeyler konusunda katı kurallar getirebiliyor. Bu makalede window objesine nasıl property ve metot ekleyebileceğimizi gösterdim.

Mesela, window objesi üzerine javascript'te aşağıdaki gibi bir kod yazmak çok mümkünken, Typescript'te konu biraz daha sıkıntılı:

// Javascript 
window.myProperty = 'demo';

// Typescript 
(window as any).myProperty = 'demo';

Ancak bu noktada Typescript için bir ayarlama yaparak bu durumdan kurtulabilirsiniz : 1. shims-window.d.ts isminde bir dosya oluşturun. 2. Aşağıdaki kodu dosyanın içine yapıştırın:

export {}; // this file needs to be a module

declare global {
  interface Window {
    myProperty?: string;
  }
}

Window interface'i içine istediğiniz property ve metot'u ekleyebilirsiniz. Ayrıca kendi tiplerinizi de kullanmanız mümkün. Örnek olarak User isminde bir tipiniz var ise :

import { User } from './user';
export {}; // this file needs to be a module

declare global {
  interface Window {
    user?: User;
  }
}

Vue.js VS Code ve Visual Studio hatası

noreply@blogger.com (Alper Konuralp) — Mon, 22 Oct 2018 07:08:00 +0000

Vue.js ile VS Code veya Visual Studio üzerinde projeler geliştiriyoruz. Bazen de hatalarla karşılaşabiliyoruz. Bunlardan biri ile ilgili çözüm yolunu bu makalede özetlemeye çalıştım.

Eğer .vue uzantılı dosyaların import satırında

TS2307: Cannot find module './components/App.vue'

şeklinde bir hata alıyorsanız büyük ihtimalle şema tanımları ile ilgili dosyanız eksik veya hasarlıdır. Bu problemi çözmek için aşağıdaki yöntemi kullanabilirsiniz:
1. Projeniz içindeki .d.ts uzantılı, adı çoğunlukla shims-vue.d.ts veya vue-shims.d.ts olan dosyayı bulunuz.
2. Bu dosya yoksa shims-vue.d.ts isminde bir dosya oluşturunuz.
3. içine aşağıdaki kodu ekleyiniz.

declare module "*.vue" {
  import Vue from "vue";
  export default Vue;
}

Bu sayede VS Code veya Visual Studio bu dosyaları anlayabilir hale gelecektir.

Git'te GitCredentialWinStore ile ilgili alınan hatanın çözümü

noreply@blogger.com (Alper Konuralp) — Mon, 16 Apr 2018 06:29:00 +0000

Git kurulumundan sonra remote(sunucu) ile ilgili işlemler yaptığınızda session açık olsada tekrar tekrar kullanıcı adı ve şifre soruyor ve mesaj ekranında aşağıdaki gibi bir hata alıyorsanız:

"C:\Program Files (x86)\GitExtensions\GitCredentialWinStore\git-credential-winstore.exe" erase: C:\Program Files (x86)\GitExtensions\GitCredentialWinStore\git-credential-winstore.exe: No such file or directory

bu durumda git'in şifre saklama sisteminde bir problem oluştuğunu görmekteyiz. Bunun çözümü olarak öncelikle https://github.com/Microsoft/Git-Credential-Manager-for-Windows adresinden Windows için git şifre yönetim aracını indirmeniz ve kurmanız gerekiyor. Dosyanın tam indirme linki :
https://github.com/Microsoft/Git-Credential-Manager-for-Windows/releases
şeklindedir. Güncel versiyonu buradan indirip kurduktan sonra GIT BASH ile 2 satırlık bir işlem yapmamız gerekiyor.

1. öncelikle git'in geçerli şifre yöneticisini siliyoruz :

git config --global --unset credential.helper

2. sonra da tekrar ekliyoruz:

git config --global credential.helper wincred

Bu işlemden sonra problemin çözülmüş olması lazım.

Azure Cosmos DB Emulator Çalışmıyor.

noreply@blogger.com (Alper Konuralp) — Sun, 24 Dec 2017 10:49:00 +0000

Merhaba, Bugün Azure Cosmos DB'ye bir göz attım. Kullanımını anlamak için kendi bilgisayarımıza bir emulator(Azure Cosmos DB Emulator) kurabiliyoruz. Bunu kurup çalıştırdığımda DocumentDB.StartupEntryPoint.exe'nin hata verdiğini gördüm. Hatanın detayını eventviewer'dan şöyle gördüm:

Problemin performans counter ile ilgili olduğunu google araması sonucunda buldum. Çözüm için aşağıdaki adımları izleyebilirsiniz:
1. Runas Administrator olarak command prompt veya powershell açınız.
2. Aşağıdaki komutunu yazarak çalıştırınız:

lodctr /R

3. eğer
Error: Unable to rebuild performance counter setting from system backup store, error code is 2
şeklinde bir hata alırsanız şu komut ile syswow64 dizinine geçiniz:

cd C:\Windows\syswow64

lodctr /R

komutunu tekrar deneyiniz.
4. Herşey doğru ise aşağıdaki gibi bir sonuç almanız gerekmektedir.

Info: Successfully rebuilt performance counter setting from system backup store

5. Son olarak aşağıdaki komut ile işlemi tamamlıyoruz:

winmgmt.exe /RESYNCPERF

Bundan sonra Azure Cosmos DB Emulator uygulamasını kapatıp tekrar çalıştırdığınızda problem kalmayacaktır.

Kaynaklar :
1. https://stackoverflow.com/a/44415748
2. https://social.technet.microsoft.com/Forums/ie/en-US/9b01e1a6-d872-4f28-9280-f35d6ca02a9f/lodctr-r-error-code-2?forum=w7itprogeneral