Eşya Kütüphanesi, eşyalarını ödünç alıp vererek çevrendekilerle paylaşmanı kolaylaştıran online bir platformdur.
Bu git deposu, Eşya Kütüphanesi web platformunun kaynak kodlarını içerir.
Bağımlılıklar kurulmadan önce bir virtualenv yaratılması ve aktifleştirilmesi tavsiye edilir.
Sonrasında
pip install -r requirements.txt # Bağımlıkları kur
cd src/ # Uygulama klasörüne gir
python manage.py database create # Veritabanını yarat ve örnek veriyle doldur
cd src/ # Daha önce girilmemişse
python manage.py runserver # Test sunucusunu başlat
runserver ile çalıştırılan test sunucusuna 0.0.0.0:5000den ulaşılabilir.
Veritabanı örnek veriyle doldurulmuşsa, sistemde bir adet test kullanıcısı öntanımlı olarak gelir. Bu kullanıcının bilgileri
Kullanıcı adı: bilgi@esyakutuphanesi.com
Parola: ekekek
şeklindedir. Sisteme http://0.0.0.0:5000/login üzerinden, veya farklı IP ve port değerleri ile çalıştırılmışsa ip:port/login üzerinden, giriş yapılır. Öntanımlı kullanıcı, sistem üzerinde yönetici haklarına sahiptir ve sistemde oturum açtıktan sonra yönetim paneline http://0.0.0.0:5000/admin/ / ip:port/admin üzerinden ulaşılabilir.
src/ dizini altında bulunan manage.py ve resetrun.sh dosyaları, projenin yönetimini kolaylaştıran bazı komutlar sunar. Dosya, python manage.py ile parametresiz olarak çağırıldığında aşağıdaki yardım çıktısını verir:
usage: manage.py [-?] {database,runserver} ...
positional arguments:
{database,runserver}
database Perform database operations
runserver Runs the Flask development server i.e. app.run()
optional arguments:
-?, --help show this help message and exit
Yerel test sunucusunu çalıştırır. Ön tanımlı IP değeri 0.0.0.0, ön tanımlı port değeri 5000 şeklindedir.
Örnek kullanım:
python manage.py runserver # Ön tanımlı IP ve port değerleriyle çalış
python manage.py runserver -P port # Verilen port değeri ve öntanımlı IP ile çalış
python manage.py runserver -h host # Verilen host değeri ve öntanımlı port ile çalış
Komutun kullanımıyla ilgili diğer detaylara python manage.py runserver --help ile ulaşılabilir.
Projenin kullanacağı veritabanını yaratır. Ön tanımlı olarak örnek veriyi yükler.
Örnek kullanım:
python manage.py database create # Tabloları yaratıp örnek veriyi yükle
python manage.py database create -s no # Tabloları yarat ve örnek veriyi yükleme
Projenin kullandığı veritabanını boşaltır. Çalışması y veya yes ile onaylanması gerekir.
Örnek kullanım:
python manage.py database drop # Tüm veriyi ve tabloları kaldır
Önce drop, sonra da create komutunun kullanılmasıyla yapılacak işi tek seferde yapar.
Örnek kullanım:
python manage.py database recreate # Tabloları sil, yarat ve örnek veriyi yükle
python manage.py database recreate -s no # Tabloları sil, yarat ve örnek veriyi yükleme
Daha önce yaratılmış veritabanına örnek veriyi yükler. Veritabanı yaratılmamışsa hata verir.
Örnek kullanım:
python manage.py populate # sample_data klasöründeki veriyi yükle
Projeye ait veritabanın hızlıca sıfırlanıp, yeniden yüklenip test sunucusunun çalıştırılmasını sağlar.
sh resetrun.sh şeklinde kullanılabilir. Etkisi
python manage.py database drop
python manage.py database create -s no
python manage.py database populate
python manage.py runserver -h 0.0.0.0 -p 5000
komutlarının art arda kullanmasına eşittir.