isyatveri 0.1.0
İş Yatırım'ın web sitesinden veri çekme işlemlerini kolaylaştıran ve isteğe göre özelleştirilebilen bir kütüphane.
License: MIT

# isyatveri v0.1.0

## Aciklama

isyatveri, Is Yatirim'in web sitesinden veri cekme islemlerini kolaylastirmak amaciyla gelistirilmis, istege gore ozellestirilebilir bir Python kutuphanesidir.

## Kurulum

Kutuphaneyi kullanmak icin asagidaki adimlari izleyin:

1. Python'i sisteminize yukleyin: https://www.python.org/downloads/
2. Terminali acin ve paketi yuklemek icin asagidaki komutu calistirin:

```bash
pip install isyatveri
```

## Kullanim

### Kutuphanenin Iceri Aktarilmasi

```python
from isyatveri import veri_cek
```

### Veri Cekme Ornekleri

```python
# Tek hisse, gunluk frekans ve logaritmik getiri
sembol = 'AKBNK'
baslangic_tarih = '03-01-2023'
bitis_tarih = '21-07-2023'
frekans = '1g'
gozlem = 'son'
getiri_hesapla = True
logaritmik_getiri = True
na_kaldir = True

veriler = veri_cek(
    sembol,
    baslangic_tarih,
    bitis_tarih,
    frekans,
    gozlem,
    getiri_hesapla,
    logaritmik_getiri,
    na_kaldir
)

print(veriler)
```

```python
# Birden fazla hisse, haftalik frekans, basit getiri ve NA kaldir
sembol = ['AKBNK','EUPWR']
baslangic_tarih = '03-01-2023'
bitis_tarih = '21-07-2023'
frekans = '1h'
gozlem = 'son'
getiri_hesapla = True
logaritmik_getiri = False
na_kaldir = True

veriler = veri_cek(
    sembol,
    baslangic_tarih,
    bitis_tarih,
    frekans,
    gozlem,
    getiri_hesapla,
    logaritmik_getiri,
    na_kaldir
)

print(veriler)
```

```python
# Birden fazla hisse, aylik frekans, kapanis fiyati ve NA birak
sembol = ['AKBNK','EUPWR']
baslangic_tarih = '03-01-2023'
bitis_tarih = '21-07-2023'
frekans = '1a'
gozlem = 'son'
getiri_hesapla = False
logaritmik_getiri = True
na_kaldir = False

veriler = veri_cek(
    sembol,
    baslangic_tarih,
    bitis_tarih,
    frekans,
    gozlem,
    getiri_hesapla,
    logaritmik_getiri,
    na_kaldir
)

print(veriler)
```

```python
# Birden fazla hisse, yillik frekans, kapanis fiyati, ortalama fiyatlar ve NA kaldir
sembol = ['AKBNK','EUPWR']
baslangic_tarih = '03-01-2023'
bitis_tarih = '21-07-2023'
frekans = '1y'
gozlem = 'ortalama'
getiri_hesapla = False
logaritmik_getiri = True
na_kaldir = True

veriler = veri_cek(
    sembol,
    baslangic_tarih,
    bitis_tarih,
    frekans,
    gozlem,
    getiri_hesapla,
    logaritmik_getiri,
    na_kaldir
)

print(veriler)
```

### Fonksiyon Parametreleri

* `sembol` (str veya list, varsayilan None): Hisse senedi sembolu veya sembollerinin listesi (Orn. 'AKBNK' veya ['AKBNK','EUPWR'])
* `baslangic_tarih` (str, 'GG-AA-YYYY', varsayilan None): Verilerin baslangic tarihi (Orn. '03-01-2023').
* `bitis_tarih` (str, 'GG-AA-YYYY', varsayilan None): Verilerin bitis tarihi (Orn. '21-07-2023').
* `frekans` (str, varsayilan '1g'): Veri frekansi (Gunluk: '1g', Haftalik: '1h', Aylik: '1a', Yillik: '1y').
* `gozlem` (str, varsayilan 'son'): Haftalik, aylik ve yillik frekanslarda istenen gozlem ('son': Son, 'ortalama': Ortalama)
* `getiri_hesapla` (bool, varsayilan True): Getiri hesaplanacak mi?
* `logaritmik_getiri` (bool, varsayilan True): Logaritmik getiri mi hesaplanacak?
* `na_kaldir` (bool, varsayilan True): Eksik degerler kaldirilacak mi?

### Donen Deger

`veri_cek` fonksiyonu bir pandas DataFrame dondurur.

## Notlar

* Kutuphane, Is Yatirim'in web sitesindeki verilere bagimlidir. Bu nedenle, verilerin dogrulugu ve surekliligi icin lutfen ilgili web sitesini kontrol edin: [Is Yatirim](https://www.isyatirim.com.tr/tr-tr/Sayfalar/default.aspx)
* Kutuphanenin gelistirilmesi ve iyilestirilmesi icin geri bildirimlerinizi bekliyorum. GitHub reposuna katkida bulunun: [GitHub Repo](https://github.com/urazakgul/isyatveri)
* Herhangi bir sorun veya oneride lutfen GitHub reposundaki "Issue" bolumunden yeni bir konu acarak bildirim saglayin: [GitHub Issues](https://github.com/urazakgul/isyatveri/issues)

## Degisiklikler

### v0.1.0 - 24/07/2023

* Ilk surum yayinlandi.

## Lisans

Bu proje MIT Lisansi altinda lisanslanmistir - [LICENSE](LICENSE.txt) dosyasina bakin.