TypeScript Projenizde ESLint ve Prettier Kurulumu (Mongoose ile)
Merhaba! Bu makalede, TypeScript projelerinizde kod stilinizi otomatize etmek ve tutarlılığını sağlamak için ESLint ve Prettier’ı nasıl kuracağınızı, özellikle de Mongoose ODM kullanıyorsanız, adım adım açıklayacağım. Bu araçlar, kod kalitenizi artırmanıza, hataları önlemenize ve takım çalışmasını kolaylaştırmanıza yardımcı olacaktır.
Gereksinimler
Başlamadan önce, projenizin Node.js ve npm veya yarn kurulumuna sahip olduğundan emin olun. Zaten bir TypeScript projeniz varsa, bu adımları atlayabilirsiniz. Yok ise, aşağıdaki komutlarla yeni bir proje oluşturabilirsiniz:
npm init -y
npm install --save-dev typescript @types/node
tsc --init
Ardından, Mongoose’i projenize ekleyin:
npm install --save mongoose
ESLint ve Prettier Kurulumu
İlk olarak, ESLint ve Prettier’ı geliştirme bağımlılıkları olarak ekleyelim. Bu işlem için aşağıdaki komutu kullanabilirsiniz:
npm install --save-dev eslint prettier @typescript-eslint/parser @typescript-eslint/eslint-plugin
Bu komut, ESLint’i TypeScript ile çalıştırmak için gerekli olan parse’ı ve plugin’i de yükler. Sonrasında, ESLint yapılandırma dosyasını (.eslintrc.js) oluşturmamız gerekiyor. Bu dosya, ESLint’in nasıl çalışacağını ve hangi kuralları uygulayacağını tanımlar. Aşağıdaki kodla başlayabilirsiniz:
module.exports = {
parser: '@typescript-eslint/parser',
extends: [
'eslint:recommended',
'plugin:@typescript-eslint/recommended',
'prettier',
],
plugins: ['@typescript-eslint', 'prettier'],
rules: {
'prettier/prettier': 'error',
},
};
Bu konfigürasyon, önerilen ESLint ve TypeScript kurallarını kullanır ve Prettier’ı entegre eder. “prettier/prettier” kuralı, Prettier’ın kurallarını zorunlu kılar. Ayrıca, .prettierrc.js dosyasını oluşturup kendi Prettier ayarlarınızı burada belirleyebilirsiniz. Örneğin, tırnak kullanımını veya girinti derinliğini ayarlayabilirsiniz.
Mongoose ile Entegrasyon
Mongoose ile çalışırken, bazı ESLint kurallarını devre dışı bırakmanız veya özelleştirmeniz gerekebilir. Örneğin, Mongoose’nin dinamik model oluşturma yöntemi, bazı tiplendirilme kurallarına uymayabilir. Bu durumlarda, `// @ts-ignore` yorumunu kullanarak bu tür uyarıları geçici olarak devre dışı bırakabilirsiniz. Ancak, ideal çözüm, kodunuzu mümkün olduğunca tiplendirilmiş tutmak ve bu tür durumları en aza indirgemektir. Daha kapsamlı bir yaklaşım ise, Mongoose’in tip tanımlamalarını kullanarak tipleri daha iyi tanımlamaktır.
VS Code Entegrasyonu
Visual Studio Code gibi bir IDE kullanıyorsanız, ESLint ve Prettier eklentilerini kurarak geliştirme deneyiminizi daha da geliştirebilirsiniz. Bu eklentiler, kod yazarken gerçek zamanlı geri bildirim sağlar ve otomatik biçimlendirme işlemlerini gerçekleştirir. Bu sayede, kod stilinizle ilgili hataları anında fark edebilir ve düzeltebilirsiniz.
Sonuç
ESLint ve Prettier’ı TypeScript projenize entegre etmek, kod kalitenizi ve tutarlılığınızı önemli ölçüde artırır. Özellikle büyük projelerde veya ekip çalışmasında, bu araçların faydaları oldukça belirgindir. Bu adımları izleyerek, kodunuzun daha temiz, daha okunabilir ve daha bakımı kolay olmasını sağlayabilirsiniz. Daha fazla bilgi için fatihsoysal.com adresini ziyaret edebilirsiniz.
Umarım bu makale faydalı olmuştur! Sorularınız veya önerileriniz varsa, lütfen yorumlarda belirtin.
Faydalı Kaynaklar:
- ESLint Resmi Dokümanları
- Prettier Resmi Dokümanları
- TypeScript Resmi Dokümanları
- Mongoose Resmi Dokümanları
#Etiketler: #TypeScript, #ESLint, #Prettier, #Mongoose, #ODM, #KodKalitesi, #KodStili, #JavaScript, #Nodejs, #WebGeliştirme