Npm Paketi Yayınlama

Node.js geliştirme ortamında çalışırken, projelerimizin ve kodlarımızın diğer geliştiricilerle paylaşılabilir ve tekrar kullanılabilir olmasını isteriz. Bu süreçte npm (Node Package Manager), JavaScript paketlerini yönetmek ve paylaşmak için en popüler araçlardan biridir. Bu makalede, npm üzerinde nasıl bir paket yayınlayabileceğimizi adım adım öğreneceğiz.

1. Npm Nedir?

Npm, Node.js ekosisteminin temel taşlarından biridir. Npm, JavaScript projeleri için bağımlılıkları yönetir ve paketlerin paylaşılmasını sağlar. Bir npm paketi, tekrar kullanılabilir kod modüllerini içerir ve bu modüller projeler arasında kolayca paylaşılabilir. Npm'in başlıca özellikleri şunlardır:

• Bağımlılık Yönetimi: Projelerinizde kullanılan üçüncü parti kütüphaneleri yönetir.

• Paket Yayınlama: Kendi oluşturduğunuz kodları npm registry üzerinde paylaşmanızı sağlar.

• Paket Versiyonlama: Kodların farklı versiyonlarını yönetir ve güncellemeleri takip eder.

2. Npm Hesabı Oluşturma ve Giriş Yapma

Bir npm paketi yayınlamadan önce, npm üzerinde bir hesabınızın olması gerekmektedir. Hesap oluşturma ve giriş yapma işlemleri şu adımları içerir:

1. Npm Hesabı Oluşturma:

   • Npm'in resmi web sitesine (npmjs.com) gidin ve "Sign Up" butonuna tıklayın.

   • Kullanıcı adı, e-posta adresi ve şifre gibi bilgileri girerek hesap oluşturun.

   • E-posta adresinize gönderilen tek kullanımlık şifreyi girerek hesap doğrulama işlemini tamamlayın.

2. Npm Hesabına Giriş Yapma:

   • Terminal veya komut satırında npm adduser komutunu çalıştırın.

   • Kullanıcı adınızı, şifrenizi ve e-posta adresinizi girerek npm hesabınıza giriş yapın.

3. Npm Paketi Hazırlama

Npm paketinizin doğru yapılandırıldığından emin olmak için package.json dosyasını oluşturmanız gerekmektedir. Bu dosya, paketinizin adını, versiyonunu, ana dosyasını ve diğer metadata bilgilerini içerir. Aşağıda basit bir package.json örneği bulunmaktadır:

{
  "name": "moment-bilgen-yazilim-akademi",
  "version": "1.0.0",
  "description": "A simple package that uses moment.js to format dates",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": ["moment", "npm", "tutorial"],
  "author": "Your Name",
  "license": "ISC"
}

4. Npm Paketi Yayınlama

Paketinizi npm registry üzerinde paylaşmak için aşağıdaki adımları izleyin:

1. Npm Publish Komutu:

   • Terminalde, projenizin ana dizininde npm publish komutunu çalıştırın.

   • Eğer herhangi bir hata almazsanız, paketiniz npm registry üzerinde yayınlanmış olacaktır.

2. Paketin Yayınlandığını Kontrol Etme:

   • Paketinizin yayınlandığını doğrulamak için https://www.npmjs.com/package/moment-bilgen-yazilim-akademi adresine giderek paketinizin detaylarını kontrol edebilirsiniz.

5. Npm Paketinin Kullanılması

Yayınladığınız npm paketini kullanmak için yeni bir Node.js projesi oluşturup, aşağıdaki adımları izleyin:

1. Yeni Proje Oluşturma:

   • Yeni bir klasör oluşturun ve içine npm init --yes komutunu çalıştırarak package.json dosyası oluşturun.

2. Paketin Kurulumu:

   • npm install moment-bilgen-yazilim-akademi komutunu çalıştırarak yayınladığınız paketi projeye ekleyin.

3. Paketin Kullanılması:

   • index.js dosyasını oluşturup aşağıdaki kodu ekleyin:

const getCurrentDateTime = require('moment-bilgen-yazilim-akademi');

const dateTime = getCurrentDateTime();
console.log("Current Date and Time:", dateTime.fullDate);
console.log("Formatted Date (YYYY-MM-DD):", dateTime.formattedDate1);
console.log("Formatted Date (DD-MM-YYYY):", dateTime.formattedDate2);
console.log("Formatted Time:", dateTime.formattedTime);

6. Özet ve Sonuç

Bu makalede, Node.js projeleriniz için npm üzerinde nasıl bir paket yayınlayabileceğinizi öğrendik. Adım adım npm hesabı oluşturma, paketi yapılandırma ve yayınlama sürecini ele aldık. Npm, JavaScript projelerinin yönetimini ve paylaşımını oldukça kolaylaştıran güçlü bir araçtır. Npm paketlerini etkin bir şekilde kullanarak projelerinizde tekrar kullanılabilir kod modülleri oluşturabilir ve bu modülleri toplulukla paylaşabilirsiniz.

Daha fazla bilgi ve kaynak için npm'in resmi dokümantasyonunu ziyaret edebilirsiniz: npm Dokümantasyon.