Yazılım geliştiricileri, Nodejs alanında geliştirdikleri projelere npm paketlerini entegre ederek işlerini hızlandırıyorlar Ancak bazı durumlarda hazır paketlerin kullanımı mümkün olmayabilir Bu durumda, yerel npm paketleri oluşturmak gerekebilir Bu paketler, kodların tekrar kullanımını ve daha kaliteli bir yazılım üretimini sağlar Yerel npm paketi oluşturma işlemi, `npm init` komutuyla başlar Daha sonra, kodlama ve test etme aşamaları gerçekleştirilir Karma ve Jasmine gibi test araçları kullanarak, kodların doğru şekilde çalıştığı doğrulanır Son olarak, `npm adduser` ile bir npm hesabı oluşturulur ve `npm publish` komutu ile paket yayınlanır Güncelleme yapılması gerektiğinde ise, yine kodlama, test ve yayınlama aşamaları takip edilir
Biliyoruz ki, npm, bugünün yazılım dünyasında oldukça önemli bir yer tutuyor. Birçok yazılım geliştiricisi, Node.js alanında geliştirdikleri projelere npm paketlerini entegre ediyorlar. Bu paketler hem hızlı bir şekilde geliştiricilerin işlerini yapmalarını sağlıyor, hem de hazır kodlar içerdikleri için daha kaliteli bir yazılım üretmelerini sağlıyor.
Fakat, her zaman npm üzerinden hazır paketleri kullanmak mümkün olmayabilir. Yazılımcılar, kendilerine özel bir paket oluşturmak istediklerinde yerel npm paketleri oluşturma yoluna gidebilirler.
Bu makalede, yerel npm paketlerinin nasıl oluşturulup yayınlanabileceği detaylı bir şekilde ele alınmıştır. İlk olarak `npm init` komutuyla yeni bir paket oluşturarak işe başlanır. Daha sonra bu paketi kodlanıp test edilir. Test etmek için de Karma ve Jasmine gibi test araçları kullanılabilir. `npm test` komutu ise yapılan testlerinin success olup olmadığı konusunda doğrulama işlemi için kullanılır.
Paketin yayınlanması işlemine gelince, öncelikle `npm adduser` komutu ile bir npm hesabı oluşturulur. Daha sonra `npm publish` komutu ile yayınlanan paket npm üzerinden kullanıma sunulur. Paketlerde güncelleme yapmak gerektiğinde ise, yine kodlama, test ve yayınlama aşamaları tekrar takip edilir.
1. Adım: Paket Oluşturma
Yerel npm paketi oluşturma işlemi, öncelikle yeni bir paket oluşturma adımıyla başlar. İlk adım olarak terminal üzerinden `npm init` komutuyla yeni bir paket oluşturabilirsiniz. Bu sayede tüm proje dosyalarınızın yer aldığı bir paket oluşturulur. Paket oluştururken öncelikle bir isim, sürüm, açıklama gibi bilgileri girmeniz gerekir. Ayrıca, paketin geliştirilme aşamasında kullanılacak bağımlılıklar ve scriptler de aynı adımlarla oluşturulur.
`npm init` komutundan sonra npm size package.json dosyasını oluşturmanızı isteyecektir. Bu dosyada projenizle ilgili tüm içerikleri tanımlamanız gerekmektedir. Eğer tüm alanlar için geçerli değerler belirlerseniz, kaydedildikten sonra veri girilmek istenmeyen alanlar varsayılan değerlerle tamamlanacaktır.
Yeni oluşturulan paketin yapısını ve içerisindeki dosyaları, yalnızca size özel bir npm deposuna yerleştirebilirsiniz. Bu sayede paketin güncellemeleri, yeni sürümleri tipik olarak ortak bir depolama alanı aracılığıyla erişim sağlayanlar tarafından kullanılabilir hale gelecektir.
2. Adım: Kodlama ve Test Etme
Bir npm paketi oluşturulduktan sonra, içine kodlama yapmak ve test etmek gerekir. Bu adım, paketin sağlıklı ve sorunsuz bir şekilde çalışmasını sağlamak için oldukça önemlidir. İlk olarak, `npm init` komutu kullanılarak yeni bir paket oluşturulur. Ardından, paket için gerekli olan kodlar yazılır ve test edilir.
Bunun için ilk olarak, test araçlarından Karma ve Jasmine kurulur. Karma, test çalıştırma ortamı olan bir araçtır ve Jasmine, JavaScript için bir test çerçevesidir. Bu araçlar kullanılarak, kod testlerinin yazılması ve takibi kolay bir şekilde yapılır.
| Karma ve Jasmine Kurulumu Adımları |
|---|
|
Test araçları yüklendikten sonra, paketin içindeki kodlar test edilir. `npm test` komutu kullanılarak testlerin başarılı bir şekilde çalıştığı doğrulanır. Eğer testler başarısız olursa, hatalı olabilecek yerlerde değişiklikler yapılarak testler tekrarlanır.
2.1. Karma ve Jasmine Kurulumu
Kodlama sürecinde, kodun doğru şekilde çalışmasını sağlamak için karma ve jasmine gibi test araçları kullanılır. Karma, uygulamalarda çalışan JavaScript kodlarının test edilmesi için kullanılan bir test çerçevesidir. Jasmine ise tek başına çalışabilen bir test yazılımıdır. Bu iki araç, yazılan kodların hızlı bir şekilde test edilmesini ve izlenmesini sağlar. İlk önce, karma ve jasmine kurulumları npm üzerinden gerçekleştirilir. Bunun için, `npm install -g karma jasmine` komutu kullanılır. Kurulumlar tamamlandıktan sonra, test yazılımı yazmak için karma init ve jasmine init komutları kullanılır. Bu komutlarla birlikte, projeye özgü karma ve jasmine yapılandırmaları oluşturulur ve ihlallerin takibi sağlanır. Yapılandırmalar tamamlanarak, karma start veya jasmine komutu kullanılarak testler başarıyla çalıştırılır. Karma ve jasmine kullanımı, yerel npm paketi oluşturma sürecinde oldukça önemlidir ve doğru şekilde kullanıldığında, yazılan kodların hatalardan arındırılmış hale getirilmesi sağlanır.
2.2. Testlerin Çalıştırılması
`npm test` komutu, oluşturulan paketin testlerinin başarılı bir şekilde çalıştığını doğrulamak için kullanılır. Bu komut, paketin kök klasörü konumunda çalıştırılır ve test sonuçları raporlanır.
`npm test` komutu, karma ve jasmine gibi test araçlarını kullanarak testlerin çalışmasını sağlar. `npm run test` da aynı işlevi yerine getirir. Test kapsamı, paketin gereksinimlerine ve uygulama geliştirme aşamasına bağlı olarak değişebilir. Test işlemi sırasında hatalar veya başarısızlıklar görülen durumlarda, kodların değiştirilmesi ve tekrar test edilmesi gerekir.
Test sonuçları, kapsamlı bir rapor olarak sunulur. Bu rapor, testlerdeki tüm hataları ve uyarıları içerir. Ayrıca, testlerin hangi aşamalarda başarılı olduğunu da gösterir. Test sonuçları, hem test işleminin başarılı bir şekilde gerçekleştiğine hem de paketin doğru çalıştığına dair güvence sağlar.
3. Adım: Paket Yayınlama
Paketinizi oluşturduktan ve test ettikten sonra, son adım paketi yayınlamaktır. Bunun için, `npm login` komutuyla oturum açmanız gerekiyor. Eğer bir npm hesabınız yoksa, önce `npm adduser` komutuyla bir hesap oluşturmanız gerekiyor.
`npm whoami` komutunu kullanarak kimlik bilgilerinizi doğrulayabilirsiniz. Giriş yaptıktan sonra, `npm publish` komutunu kullanarak paketinizi yayınlayabilirsiniz. Bu işlem sırasında, paketinizin ismi, sürümü ve açıklaması gibi bilgileri de yayınlayabilirsiniz.
Eğer paketinizin özel bir yayın yeri varsa, `npm publish` komutunu ek parametrelerle kullanarak farklı bir adres üzerinden de yayınlayabilirsiniz. Ayrıca, paketinizi güncellemek istediğinizde, kodlama, test ve yayınlama adımlarını yeniden takip etmeniz gerekiyor.
Paket yayınlama işlemi başarılı bir şekilde tamamlandıktan sonra, paketiniz npm üzerinde bulunabilir hale gelir ve diğer kullanıcılar tarafından kullanılabilir hale gelir. Artık dilediğiniz zaman `npm install` komutunu kullanarak paketi projelerinizde kullanabilirsiniz.
3.1. npm Hesap Oluşturma
Paket oluşturulduktan ve test edildikten sonra, bir npm hesabı oluşturmak için `npm adduser` komutu kullanılmalıdır. Bu komut çalıştırıldığında, kullanıcıdan kullanıcı adı, e-posta adresi ve şifre istenir. Bilgiler girildikten sonra, npm hesabı oluşturulur ve kullanıcının paketlerini yayınlama yeteneği kazanır.
Bu hesap oluşturma işlemi sırasında, kullanıcılardan ek olarak standart ve iki faktörlü kimlik doğrulama yöntemleri seçenekleri sunulur. Bu, hesap güvenliğini arttırmak için her zaman önerilir.
Eğer daha önce npm'de hesap açılmışsa, `npm login` komutuyla oturum açarak devam edebilirsiniz. `npm whoami` komutuyla kimlik doğrulamasını yapabilir ve daha önce oluşturulan kullanıcı adını görebilirsiniz. Bu şekilde, paketler için gerekli izinlere sahip olduklarını doğrulayarak yayınlama işlemine önceden hazırlık yapabilirsiniz.
npm hesap oluşturma işlemi tamamlandıktan sonra, artık paketinizi yayınlayabilirsiniz. Yayınlama için gerekli komut olan `npm publish` ile birlikte, paketinizi kolayca paylaşabilirsiniz.
3.2. Paket Yayınlama
3.2. Paket Yayınlama
Paketinizi oluşturduktan sonra, yayınlama işlemi gerçekleştirmek oldukça kolaydır. `npm publish` komutunu kullanarak paketinizi yayınlayabilir ve npm üzerinden kullanıma sunabilirsiniz. Ancak öncelikle `npm login` komutuyla npm hesabınıza giriş yapmanız veya `npm adduser` komutuyla yeni bir hesap oluşturmanız gerekir.
Bir kere npm hesabınıza giriş yaptıktan sonra, `npm whoami` komutuyla hangi hesapta olduğunuzu doğrulayabilirsiniz. Artık komutu kullanarak paketinizi npm üzerinden yayınlayabilirsiniz.
Bir kez paketinizi yayınladıktan sonra, güncelleme işlemleri için de yine `npm publish` komutunu kullanmanız gerekiyor. Yapacağınız güncelleme işlemleri de tıpkı ilk yayınlama işlemi gibi gerçekleşir. Kodlama, test ve yayınlama aşamalarını başarılı bir şekilde tamamladığınızda, önemli bir inovasyonu gerçekleştirerek, siz de bir npm paketi oluşturabilir ve yayınlayabilirsiniz.
4. Adım: Paket Güncelleme
Paket oluşturulduktan sonra, paket hatalarını düzeltmek için kodlama işlemi yapılabilir. Bu işlem sonrası testler de ilgili hatalara göre güncellenir. Testlerin başarıyla geçilmesinden sonra, paket tekrar yayınlanabilir. Güncelleme işlemi, ilk oluşturma aşamasındaki prosedürlere benzer şekilde yapılır. Yeni kodlama işlemi gerçekleştirilir ve testler yazılır. Bu testler, değişen kodlama işlemlerine göre oluşturulur ve önceki hatalara göre güncellenir. Ardından paket tekrar yayınlanabilir. Bu süreç, paketin güncel ve kullanışlı kalması için düzenli olarak takip edilmelidir.