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

# isyatirim v0.1.0

## AÃ§Ä±klama

isyatirim, Ä°ÅŸ YatÄ±rÄ±m'Ä±n web sitesinden veri Ã§ekme iÅŸlemlerini kolaylaÅŸtÄ±rmak amacÄ±yla geliÅŸtirilmiÅŸ, kullanÄ±cÄ± isteÄŸine gÃ¶re Ã¶zelleÅŸtirilebilir bir Python kÃ¼tÃ¼phanesidir.

## Kurulum

KÃ¼tÃ¼phaneyi kullanmak iÃ§in aÅŸaÄŸÄ±daki adÄ±mlarÄ± izleyin:

1. Python'Ä± sisteminize yÃ¼kleyin: https://www.python.org/downloads/
2. Terminali aÃ§Ä±n ve paketi yÃ¼klemek iÃ§in aÅŸaÄŸÄ±daki komutu Ã§alÄ±ÅŸtÄ±rÄ±n:

```bash
pip install isyatirim
```

## KullanÄ±m

### KÃ¼tÃ¼phanenin Ä°Ã§eri AktarÄ±lmasÄ±

```python
from isyatirim import veri_cek
```

### Veri Ã‡ekme Ã–rnekleri

```python
# Tek hisse, gÃ¼nlÃ¼k 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, haftalÄ±k frekans, basit getiri ve NA kaldÄ±r
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, aylÄ±k frekans, kapanÄ±ÅŸ fiyatÄ± ve NA bÄ±rak
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, yÄ±llÄ±k frekans, kapanÄ±ÅŸ fiyatÄ±, ortalama fiyatlar ve NA kaldÄ±r
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, varsayÄ±lan None): Hisse senedi sembolÃ¼ veya sembollerinin listesi (Ã–rn. 'AKBNK' veya ['AKBNK','EUPWR'])
* `baslangic_tarih` (str, 'GG-AA-YYYY', varsayÄ±lan None): Verilerin baÅŸlangÄ±Ã§ tarihi (Ã¶rn. '03-01-2023').
* `bitis_tarih` (str, 'GG-AA-YYYY', varsayÄ±lan None): Verilerin bitiÅŸ tarihi (Ã¶rn. '21-07-2023').
* `frekans` (str, varsayÄ±lan '1g'): Veri frekansÄ± (GÃ¼nlÃ¼k: '1g', HaftalÄ±k: '1h', AylÄ±k: '1a', YÄ±llÄ±k: '1y').
* `gozlem` (str, varsayÄ±lan 'son'): HaftalÄ±k, aylÄ±k ve yÄ±llÄ±k frekanslarda istenen gÃ¶zlem ('son': Son, 'ortalama': Ortalama)
* `getiri_hesapla` (bool, varsayÄ±lan True): Getiri hesaplanacak mÄ±?
* `logaritmik_getiri` (bool, varsayÄ±lan True): Logaritmik getiri mi hesaplanacak?
* `na_kaldir` (bool, varsayÄ±lan True): Eksik deÄŸerler kaldÄ±rÄ±lacak mÄ±?

### DÃ¶nen DeÄŸer

`veri_cek` fonksiyonu bir pandas DataFrame dÃ¶ndÃ¼rÃ¼r.

## Notlar

* KÃ¼tÃ¼phane, Ä°ÅŸ YatÄ±rÄ±m'Ä±n web sitesindeki verilere baÄŸÄ±mlÄ±dÄ±r. Bu nedenle, verilerin doÄŸruluÄŸu ve sÃ¼rekliliÄŸi iÃ§in lÃ¼tfen ilgili web sitesini kontrol edin: [Ä°ÅŸ YatÄ±rÄ±m](https://www.isyatirim.com.tr/tr-tr/Sayfalar/default.aspx)
* KÃ¼tÃ¼phanenin geliÅŸtirilmesi ve iyileÅŸtirilmesi iÃ§in geri bildirimlerinizi bekliyorum. GitHub reposuna katkÄ±da bulunun: [GitHub Repo](https://github.com/urazakgul/IsYatirim)
* Herhangi bir sorun veya Ã¶neride lÃ¼tfen GitHub reposundaki "Issue" bÃ¶lÃ¼mÃ¼nden yeni bir konu aÃ§arak bildirim saÄŸlayÄ±n: [GitHub Issues](https://github.com/urazakgul/IsYatirim/issues)

## DeÄŸiÅŸiklikler

### v0.1.0 - 24/07/2023

* Ä°lk sÃ¼rÃ¼m yayÄ±nlandÄ±.

## Lisans

Bu proje MIT LisansÄ± altÄ±nda lisanslanmÄ±ÅŸtÄ±r - [LICENSE](LICENSE.txt) dosyasÄ±na bakÄ±n.