Python projelerinizde kar\u015f\u0131la\u015ft\u0131\u011f\u0131n\u0131z karma\u015f\u0131kl\u0131\u011f\u0131 nas\u0131l y\u00f6netirsiniz? B\u00fcy\u00fck \u00f6l\u00e7ekli uygulamalar geli\u015ftirirken temiz, anla\u015f\u0131l\u0131r ve bak\u0131m\u0131 kolay bir yap\u0131 olu\u015fturmak, ba\u015far\u0131 i\u00e7in kilit \u00f6neme sahiptir. Bu makale, Python projelerinizde sa\u011flam ve \u00f6l\u00e7eklenebilir bir yap\u0131land\u0131rma olu\u015fturman\u0131n en iyi yollar\u0131n\u0131 ad\u0131m ad\u0131m a\u00e7\u0131kl\u0131yor, modern yakla\u015f\u0131mlar\u0131 ve pratik ipu\u00e7lar\u0131n\u0131 bir araya getiriyor.<\/p>\n
Bir Python projesine ba\u015flarken genellikle ilk akl\u0131m\u0131za gelen kod yazmaya bir an \u00f6nce ba\u015flamak olur. Ancak projenin b\u00fcy\u00fcmesiyle birlikte, tek bir dosyada biriken i\u015flevler veya d\u00fczensiz bir dosya y\u0131\u011f\u0131n\u0131, k\u0131sa s\u00fcrede i\u00e7inden \u00e7\u0131k\u0131lmaz bir hal alabilir. Bu durum, hem bireysel geli\u015ftiriciler hem de ekipler i\u00e7in b\u00fcy\u00fck bir verimlilik katili haline gelir. \u0130\u015fte bu y\u00fczden, daha ilk sat\u0131r kodu yazmadan \u00f6nce sa\u011flam bir proje yap\u0131s\u0131n\u0131n temellerini atmak, uzun vadede size say\u0131s\u0131z avantaj sa\u011flayacakt\u0131r.<\/p>\n
\u00d6ncelikle, d\u00fczenli bir proje yap\u0131s\u0131, kodun anla\u015f\u0131l\u0131rl\u0131\u011f\u0131n\u0131 art\u0131r\u0131r. Yeni bir geli\u015ftirici ekibe kat\u0131ld\u0131\u011f\u0131nda veya siz aylar sonra kendi yazd\u0131\u011f\u0131n\u0131z koda d\u00f6nd\u00fc\u011f\u00fcn\u00fczde, her \u015feyin mant\u0131ksal bir d\u00fczende olmas\u0131, \u00f6\u011frenme e\u011frisini \u00f6nemli \u00f6l\u00e7\u00fcde k\u0131salt\u0131r. Dosyalar\u0131n ve dizinlerin belirli bir amaca hizmet etmesi, kodun nerede bulunaca\u011f\u0131n\u0131 kolayca tahmin etmenizi sa\u011flar. Dolay\u0131s\u0131yla, bu durum yaln\u0131zca mevcut koddaki hatalar\u0131 ay\u0131klamay\u0131 kolayla\u015ft\u0131rmakla kalmaz, ayn\u0131 zamanda yeni \u00f6zelliklerin eklenmesini de h\u0131zland\u0131r\u0131r.<\/p>\n
Ayr\u0131ca, bak\u0131m\u0131 kolay bir proje yap\u0131s\u0131, teknik borcun birikmesini engeller. Her bile\u015fenin net bir sorumlulu\u011fu oldu\u011funda (Single Responsibility Prensibi), bir de\u011fi\u015fikli\u011fin di\u011fer alanlar\u0131 beklenmedik \u015fekilde etkileme olas\u0131l\u0131\u011f\u0131 azal\u0131r. Bu, \u00f6zellikle karma\u015f\u0131k sistemlerde, k\u00fc\u00e7\u00fck bir de\u011fi\u015fikli\u011fin domino etkisi yaratmas\u0131n\u0131 \u00f6nler. Bak\u0131m kolayl\u0131\u011f\u0131 ayn\u0131 zamanda g\u00fcvenlik g\u00fcncellemelerinin veya performans iyile\u015ftirmelerinin daha az riskle yap\u0131labilmesini sa\u011flar. \u0130\u015fbirli\u011fi ortamlar\u0131nda, birden fazla geli\u015ftiricinin ayn\u0131 anda farkl\u0131 mod\u00fcller \u00fczerinde \u00e7al\u0131\u015fabilmesi i\u00e7in de bu d\u00fczen hayati \u00f6nem ta\u015f\u0131r. \u00c7ak\u0131\u015fmalar azal\u0131r, kod incelemeleri daha verimli hale gelir ve tak\u0131m\u0131n genel \u00fcretkenli\u011fi artar.<\/p>\n
Vaka analizi olarak, b\u00fcy\u00fck bir e-ticaret platformu d\u00fc\u015f\u00fcnelim. Ba\u015flang\u0131\u00e7ta tek bir \u00d6zetle, Python projelerinde sa\u011flam bir yap\u0131land\u0131rma, sadece estetik bir tercih de\u011fil, ayn\u0131 zamanda projenin \u00f6l\u00e7eklenebilirli\u011fi, s\u00fcrd\u00fcr\u00fclebilirli\u011fi ve ba\u015far\u0131s\u0131 i\u00e7in kritik bir m\u00fchendislik prensibidir. Projenizin karma\u015f\u0131kl\u0131\u011f\u0131 ne olursa olsun, do\u011fru temel \u00fczerine in\u015fa etmek, gelecekteki olas\u0131 sorunlar\u0131n \u00f6n\u00fcne ge\u00e7ecektir. Dolay\u0131s\u0131yla, bu yakla\u015f\u0131mlar\u0131 benimsemek, hem sizin hem de ekibinizin uzun vadede daha verimli ve mutlu \u00e7al\u0131\u015fmas\u0131n\u0131 sa\u011flayacakt\u0131r.<\/p>\n Herhangi bir Python projesinin kalbi, onun dizin yap\u0131s\u0131d\u0131r. Bu yap\u0131, kodunuzu nas\u0131l organize etti\u011finizi, mod\u00fcllerinizi ve paketlerinizi nas\u0131l tan\u0131mlad\u0131\u011f\u0131n\u0131z\u0131 g\u00f6sterir. Do\u011fru bir ba\u015flang\u0131\u00e7 yapmak, projenizin b\u00fcy\u00fcmesiyle ortaya \u00e7\u0131kabilecek karma\u015f\u0131kl\u0131klar\u0131 y\u00f6netmek i\u00e7in hayati \u00f6neme sahiptir. Peki, basit ama etkili bir Python proje dizini yap\u0131s\u0131 nas\u0131l kurulur?<\/p>\n \u00d6ncelikle, Python’da “mod\u00fcl” bir En temel ve \u00f6nerilen proje yap\u0131lar\u0131ndan biri genellikle ana uygulama kodunu \u00f6zel bir dizine yerle\u015ftirmektir. Bu dizin genellikle <\/code><\/p>\n Bu yap\u0131da, Python projelerinde ba\u011f\u0131ml\u0131l\u0131k y\u00f6netiminin temel ta\u015f\u0131 sanal ortamlard\u0131r. Bir sanal ortam, projenize \u00f6zg\u00fc bir Python yorumlay\u0131c\u0131s\u0131 ve ba\u011f\u0131ml\u0131l\u0131k setidir. Bu, farkl\u0131 projelerinizin farkl\u0131 versiyonlarda k\u00fct\u00fcphanelere ihtiya\u00e7 duymas\u0131 durumunda \u00e7ak\u0131\u015fmalar\u0131 \u00f6nler. \u00d6rne\u011fin, bir projeniz Bir sanal ortam olu\u015fturmak ve etkinle\u015ftirmek i\u00e7in \u015fu komutlar\u0131 kullanabilirsiniz:<\/p>\n <\/code><\/p>\n Sanal ortam etkinle\u015ftirildikten sonra, y\u00fckledi\u011finiz t\u00fcm k\u00fct\u00fcphaneler o ortama \u00f6zg\u00fc olacakt\u0131r. Proje ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131z\u0131 <\/code><\/p>\n Bu temel yap\u0131 ve sanal ortamlar\u0131n bilin\u00e7li kullan\u0131m\u0131, Python projelerinizin temiz, s\u00fcrd\u00fcr\u00fclebilir ve i\u015fbirli\u011fine a\u00e7\u0131k olmas\u0131n\u0131n ilk ad\u0131mlar\u0131d\u0131r. Bu sayede, kodunuzu daha kolay y\u00f6netebilir, hatalar\u0131 daha h\u0131zl\u0131 ay\u0131klayabilir ve ekibinizle daha uyumlu \u00e7al\u0131\u015fabilirsiniz. Ayn\u0131 zamanda, projenizin b\u00fcy\u00fcmesi ve geli\u015fmesi i\u00e7in sa\u011flam bir zemin haz\u0131rlam\u0131\u015f olursunuz.<\/p>\n Python projelerinin ayr\u0131lmaz bir par\u00e7as\u0131 olan ba\u011f\u0131ml\u0131l\u0131k y\u00f6netimi, farkl\u0131 k\u00fct\u00fcphanelerin ve onlar\u0131n belirli versiyonlar\u0131n\u0131n do\u011fru bir \u015fekilde takip edilmesini ve kurulmas\u0131n\u0131 sa\u011flar. Bu konuda uzun y\u0131llard\u0131r <\/code><\/p>\n Bu dosyan\u0131n temel avantaj\u0131, sadeli\u011fi ve evrensel olarak kabul g\u00f6rm\u00fc\u015f olmas\u0131d\u0131r. Neredeyse her Python projesi bu dosyay\u0131 tan\u0131r ve Ancak, Bir <\/code><\/p>\n Ana avantaj\u0131, kapsaml\u0131 bir \u00f6zellik setidir:<\/p>\n Vaka analizi olarak, on ki\u015filik bir ekibin \u00e7al\u0131\u015ft\u0131\u011f\u0131 orta \u00f6l\u00e7ekli bir SaaS uygulamas\u0131n\u0131 ele alal\u0131m. Ba\u015flang\u0131\u00e7ta Sonu\u00e7 olarak, B\u00fcy\u00fck ve karma\u015f\u0131k yaz\u0131l\u0131m projelerini y\u00f6netmenin s\u0131rr\u0131, onlar\u0131 daha k\u00fc\u00e7\u00fck, ba\u011f\u0131ms\u0131z ve y\u00f6netilebilir par\u00e7alara ay\u0131rmaktan ge\u00e7er. Bu, mod\u00fcler tasar\u0131m\u0131n temelini olu\u015fturur ve Python'da mod\u00fcller (tek DRY prensibi, yaz\u0131l\u0131m geli\u015ftirmedeki en temel prensiplerden biridir: \"Her bilgi par\u00e7as\u0131, bir sistem i\u00e7inde tek, a\u00e7\u0131k ve yetkili bir temsilcili\u011fe sahip olmal\u0131d\u0131r.\" Bu, kodunuzda ayn\u0131 mant\u0131\u011f\u0131, ayn\u0131 algoritmay\u0131 veya ayn\u0131 veri yap\u0131s\u0131n\u0131 birden fazla yerde tekrarlamaktan ka\u00e7\u0131nman\u0131z gerekti\u011fi anlam\u0131na gelir. Tekrarlanan kod, bak\u0131m maliyetlerini art\u0131r\u0131r, hata yapma olas\u0131l\u0131\u011f\u0131n\u0131 y\u00fckseltir ve de\u011fi\u015fiklik yapmay\u0131 zorla\u015ft\u0131r\u0131r. E\u011fer bir mant\u0131k par\u00e7as\u0131 birden fazla yerde kullan\u0131l\u0131yorsa, onu ayr\u0131 bir fonksiyona, s\u0131n\u0131fa veya mod\u00fcle ta\u015f\u0131yarak merkezile\u015ftirmelisiniz.<\/p>\n \u00d6rne\u011fin, bir web uygulamas\u0131nda kullan\u0131c\u0131 giri\u015fi ve y\u00f6neticinin giri\u015fini do\u011frulayan iki ayr\u0131 ama benzer fonksiyonunuz varsa, DRY prensibini ihlal ediyorsunuz demektir. Bunun yerine, ortak do\u011frulama mant\u0131\u011f\u0131n\u0131 soyutlay\u0131p tek bir yard\u0131mc\u0131 fonksiyonda veya bir kimlik do\u011frulama mod\u00fcl\u00fcnde toplayabilirsiniz:<\/p>\n <\/code><\/p>\n Bu yakla\u015f\u0131m, kod taban\u0131n\u0131z\u0131n boyutunu k\u00fc\u00e7\u00fcltmekle kalmaz, ayn\u0131 zamanda bir hata d\u00fczeltmesi veya bir mant\u0131k de\u011fi\u015fikli\u011fi gerekti\u011finde yaln\u0131zca tek bir yerde i\u015flem yapman\u0131z\u0131 sa\u011flar. Bu da \u00f6nemli \u00f6l\u00e7\u00fcde zaman kazand\u0131r\u0131r ve hatalar\u0131 azalt\u0131r.<\/p>\n SOLID, nesne y\u00f6nelimli tasar\u0131m i\u00e7in be\u015f prensipten olu\u015fan bir k\u0131saltmad\u0131r. Bunlar do\u011frudan proje yap\u0131n\u0131z\u0131 \u015fekillendirmese de, mod\u00fcllerinizi ve s\u0131n\u0131flar\u0131n\u0131z\u0131 nas\u0131l tasarlad\u0131\u011f\u0131n\u0131z\u0131 etkileyerek dolayl\u0131 yoldan genel mimarinizi g\u00fc\u00e7lendirir. \u00d6zellikle Tek Sorumluluk Prensibi (Single Responsibility Principle - SRP)<\/strong> ve A\u00e7\u0131k\/Kapal\u0131 Prensibi (Open\/Closed Principle - OCP)<\/strong> proje yap\u0131s\u0131 i\u00e7in \u00e7ok \u00f6nemlidir:<\/p>\n Bir mod\u00fcl, s\u0131n\u0131f veya fonksiyonun yaln\u0131zca bir tek sorumlulu\u011fu olmal\u0131d\u0131r ve bu sorumlulu\u011fu de\u011fi\u015ftirmek i\u00e7in sadece tek bir nedeni olmal\u0131d\u0131r. Proje yap\u0131n\u0131zda, bu, her mod\u00fcl\u00fcn (veya paketin) belirli bir i\u015f alan\u0131na odaklanmas\u0131 gerekti\u011fi anlam\u0131na gelir. \u00d6rne\u011fin, bir <\/code>\n <\/li>\n Yaz\u0131l\u0131m varl\u0131klar\u0131 (s\u0131n\u0131flar, mod\u00fcller, fonksiyonlar) geni\u015fletmeye a\u00e7\u0131k, ancak de\u011fi\u015ftirmeye kapal\u0131 olmal\u0131d\u0131r. Bu, yeni i\u015flevsellik eklemek istedi\u011finizde mevcut kodu de\u011fi\u015ftirmek yerine, yeni kod eklemeniz gerekti\u011fi anlam\u0131na gelir. Python'da bu prensip genellikle soyut s\u0131n\u0131flar, aray\u00fczler veya strateji deseni gibi tekniklerle uygulan\u0131r. Proje yap\u0131s\u0131 a\u00e7\u0131s\u0131ndan, bu, sistemin ana bile\u015fenlerinin \u00e7ekirdek mant\u0131\u011f\u0131 de\u011fi\u015ftirmeden yeni \u00f6zelliklerin entegre edilebilece\u011fi \u015fekilde tasarlanmas\u0131 gerekti\u011fi anlam\u0131na gelir. \u00d6rne\u011fin, bir \u00f6deme sistemi mod\u00fcl\u00fc, yeni bir \u00f6deme y\u00f6ntemi eklendi\u011finde mevcut kodun geni\u015fletilmesine olanak tan\u0131mal\u0131, ancak mevcut \u00f6deme mant\u0131\u011f\u0131n\u0131 de\u011fi\u015ftirmeyi gerektirmemelidir.<\/p>\n<\/li>\n<\/ul>\n Paketler aras\u0131 ili\u015fkilerde, dairesel ba\u011f\u0131ml\u0131l\u0131klardan ka\u00e7\u0131nmak \u00f6nemlidir. E\u011fer Sonu\u00e7 olarak, DRY ve SOLID prensipleri, sadece tek tek kod par\u00e7ac\u0131klar\u0131n\u0131 de\u011fil, ayn\u0131 zamanda projenizin genel mimarisini ve dizin yap\u0131s\u0131n\u0131 da etkiler. Bu prensipleri benimseyerek, daha sa\u011flam, anla\u015f\u0131l\u0131r, test edilebilir ve uzun \u00f6m\u00fcrl\u00fc Python uygulamalar\u0131 geli\u015ftirebilirsiniz. Bu da, projenizin zaman i\u00e7inde kolayca geni\u015fletilebilmesini ve de\u011fi\u015fen ihtiya\u00e7lara adapte olabilmesini sa\u011flar.<\/p>\n Yaz\u0131l\u0131m geli\u015ftirmede testler, kodunuzun beklendi\u011fi gibi \u00e7al\u0131\u015ft\u0131\u011f\u0131ndan emin olman\u0131n en kritik yollar\u0131ndan biridir. Yaln\u0131zca hatalar\u0131 erken yakalamakla kalmaz, ayn\u0131 zamanda projenizin gelecekteki de\u011fi\u015fikliklere kar\u015f\u0131 daha dayan\u0131kl\u0131 olmas\u0131n\u0131 sa\u011flar. Sa\u011flam bir Python proje yap\u0131s\u0131, testlerin kolayca yaz\u0131lmas\u0131n\u0131, organize edilmesini ve y\u00fcr\u00fct\u00fclmesini desteklemelidir. Peki, test stratejilerini proje yap\u0131n\u0131za nas\u0131l entegre edersiniz?<\/p>\n Test yazman\u0131n bir\u00e7ok nedeni vard\u0131r, ancak ba\u015fl\u0131calar\u0131 \u015funlard\u0131r:<\/p>\n \u0130ki ana test t\u00fcr\u00fc genellikle kullan\u0131l\u0131r:<\/p>\n Testlerinizi organize etmek i\u00e7in yayg\u0131n ve etkili bir y\u00f6ntem, projenizin ana dizininde ayr\u0131 bir <\/code><\/p>\n Bu yap\u0131da, <\/code><\/p>\n <\/code> def test_add_numbers(): def test_subtract_numbers(): Bu testleri \u00e7al\u0131\u015ft\u0131rmak i\u00e7in:<\/p>\n <\/code> Ger\u00e7ek d\u00fcnya senaryosunda, otomatik testlerin en b\u00fcy\u00fck faydas\u0131 S\u00fcrekli Entegrasyon\/S\u00fcrekli Da\u011f\u0131t\u0131m (CI\/CD) boru hatlar\u0131nda ortaya \u00e7\u0131kar. B\u00fcy\u00fck bir yaz\u0131l\u0131m geli\u015ftirme ekibinin bir proje \u00fczerinde \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 d\u00fc\u015f\u00fcnelim. Her geli\u015ftirici kodunu ana bran\u015fa (main branch) g\u00f6ndermeden \u00f6nce, CI\/CD sistemi otomatik olarak devreye girer. Bu sistem, kodu al\u0131r, ba\u011f\u0131ml\u0131l\u0131klar\u0131 kurar ve t\u00fcm testleri (birim, entegrasyon vb.) \u00e7al\u0131\u015ft\u0131r\u0131r.<\/p>\n E\u011fer testlerden herhangi biri ba\u015far\u0131s\u0131z olursa, CI\/CD boru hatt\u0131 durur ve geli\u015ftiriciye bildirim g\u00f6nderilir. Bu, hatalar\u0131n ana kod taban\u0131na kar\u0131\u015fmas\u0131n\u0131 engeller ve \"geli\u015ftiricinin makinesinde \u00e7al\u0131\u015fan\" ama canl\u0131 sistemde sorun \u00e7\u0131karan durumlar\u0131n \u00f6n\u00fcne ge\u00e7er. Bu durum, \u00f6zellikle API entegrasyonlar\u0131 olan sistemler i\u00e7in kritik \u00f6neme sahiptir. \u00d6rne\u011fin, bir API entegrasyonu yapan bir mod\u00fclde de\u011fi\u015fiklik yap\u0131ld\u0131\u011f\u0131nda, entegrasyon testleri bu de\u011fi\u015fikliklerin \u00fc\u00e7\u00fcnc\u00fc taraf API'larla uyumlulu\u011funu bozup bozmad\u0131\u011f\u0131n\u0131 hemen kontrol eder.<\/p>\n Bu otomasyon sayesinde, ekip \u00fcyeleri kodlar\u0131n\u0131 daha g\u00fcvenle birle\u015ftirebilir, da\u011f\u0131t\u0131m s\u00fcre\u00e7leri h\u0131zlan\u0131r ve genel yaz\u0131l\u0131m kalitesi \u00f6nemli \u00f6l\u00e7\u00fcde artar. Testlerin proje yap\u0131s\u0131na do\u011fru bir \u015fekilde entegre edilmesi, bu s\u00fcrecin sorunsuz i\u015flemesini sa\u011flar ve modern yaz\u0131l\u0131m geli\u015ftirmenin temel ta\u015flar\u0131ndan biridir.<\/p>\n Sonu\u00e7 olarak, testler yaln\u0131zca hatalar\u0131 yakalamakla kalmaz, ayn\u0131 zamanda projenizin uzun \u00f6m\u00fcrl\u00fc ve s\u00fcrd\u00fcr\u00fclebilir olmas\u0131n\u0131 sa\u011flayan bir g\u00fcvencedir. Do\u011fru dizin yap\u0131s\u0131 ve g\u00fc\u00e7l\u00fc test ara\u00e7lar\u0131 (pytest gibi) kullanarak, testlerinizi projenizin vazge\u00e7ilmez bir par\u00e7as\u0131 haline getirebilirsiniz. Bu, hem geli\u015ftiricilerinize hem de son kullan\u0131c\u0131lar\u0131n\u0131za fayda sa\u011flayacak, daha g\u00fcvenilir ve kaliteli yaz\u0131l\u0131mlar \u00fcretmenize yard\u0131mc\u0131 olacakt\u0131r.<\/p>\n Bir Python projesi sadece \u00e7al\u0131\u015fan koddan ibaret de\u011fildir; ayn\u0131 zamanda anla\u015f\u0131l\u0131r, bak\u0131m\u0131 kolay ve iyi belgelenmi\u015f olmal\u0131d\u0131r. Dok\u00fcmantasyon ve kod kalitesi ara\u00e7lar\u0131, projenizin profesyonelli\u011fini ve uzun vadeli ba\u015far\u0131s\u0131n\u0131 do\u011frudan etkileyen kritik unsurlard\u0131r. Bu ara\u00e7lar, geli\u015ftiricilerin kodunuzu daha h\u0131zl\u0131 anlamalar\u0131na, yeni ba\u015flayanlar\u0131n projeye daha kolay adapte olmalar\u0131na ve kod taban\u0131n\u0131z\u0131n genel sa\u011fl\u0131\u011f\u0131n\u0131 koruman\u0131za yard\u0131mc\u0131 olur.<\/p>\n Python'da \u0130yi yaz\u0131lm\u0131\u015f <\/code><\/p>\n Bu \u00f6rnek, fonksiyonun amac\u0131n\u0131, parametrelerini, d\u00f6n\u00fc\u015f de\u011ferini ve olas\u0131 hatalar\u0131 a\u00e7\u0131k\u00e7a belirtir. Bu t\u00fcr detayl\u0131 Daha kapsaml\u0131 proje dok\u00fcmantasyonu i\u00e7in, Bu ara\u00e7lar, projenizin Kod kalitesi, projenizin s\u00fcrd\u00fcr\u00fclebilirli\u011finin temelidir. Tutarl\u0131 bir kodlama stili, potansiyel hatalar\u0131n erken tespiti ve en iyi uygulamalar\u0131n uygulanmas\u0131 i\u00e7in linting ve bi\u00e7imlendirme ara\u00e7lar\u0131 vazge\u00e7ilmezdir.<\/p>\n Bu ara\u00e7lar, kodu \u00e7al\u0131\u015ft\u0131rmadan \u00f6nce statik analiz yaparak, olas\u0131 sorunlar\u0131 otomatik olarak bulur ve d\u00fczeltmenize yard\u0131mc\u0131 olur. Genellikle CI\/CD boru hatlar\u0131na entegre edilerek, k\u00f6t\u00fc kaliteli kodun ana bran\u015fa kar\u0131\u015fmas\u0131 engellenir.\n <\/li>\n Bu ara\u00e7lar\u0131n kullan\u0131m\u0131, kod taban\u0131n\u0131zda tutarl\u0131l\u0131\u011f\u0131 ve kalitenin s\u00fcrekli y\u00fcksek kalmas\u0131n\u0131 sa\u011flar. Yeni ba\u015flayanlar i\u00e7in iyi al\u0131\u015fkanl\u0131klar edinmelerine yard\u0131mc\u0131 olurken, deneyimli geli\u015ftiricilerin de odaklar\u0131n\u0131 kodun mant\u0131\u011f\u0131na vermelerine olanak tan\u0131r. Modern geli\u015ftirme ortamlar\u0131nda, bu ara\u00e7lar genellikle IDE'lerle entegre olarak \u00e7al\u0131\u015f\u0131r ve kod yazarken an\u0131nda geri bildirim sa\u011flar.<\/p>\n Vaka analizi olarak, uluslararas\u0131 bir yaz\u0131l\u0131m firmas\u0131n\u0131n \u00d6zetle, dok\u00fcmantasyon ve kod kalitesi ara\u00e7lar\u0131, Python projenizi sadece i\u015flevsel de\u011fil, ayn\u0131 zamanda s\u00fcrd\u00fcr\u00fclebilir, i\u015fbirli\u011fine a\u00e7\u0131k ve profesyonel k\u0131lar. Bu ara\u00e7lar\u0131 benimsemek, projenizin uzun vadede ba\u015far\u0131l\u0131 olmas\u0131n\u0131n anahtar\u0131d\u0131r.<\/p>\n Bu makale i\u00e7eri\u011fi do\u011frudan mobil uyumlu HTML \u00fcretmekle ilgili olmasa da, modern web uygulamalar\u0131 geli\u015ftirirken mobil uyumlulu\u011fun ne kadar kritik oldu\u011funu unutmamak \u00f6nemlidir. Python backend'i bu konuda do\u011frudan rol oynamasa da, bir frontend ile etkile\u015fimde olan uygulamalar i\u00e7in duyarl\u0131 tasar\u0131m prensipleri vazge\u00e7ilmezdir. Frontend geli\u015ftiricileri, kullan\u0131c\u0131 deneyimini her cihazda optimize etmek i\u00e7in CSS medya sorgular\u0131n\u0131 yo\u011fun olarak kullan\u0131r.<\/p>\n <\/code><\/p>\n Bu t\u00fcr kurallar\u0131 genellikle CSS dosyalar\u0131n\u0131za ekleyerek taray\u0131c\u0131n\u0131n ekran boyutuna g\u00f6re farkl\u0131 stiller uygulamas\u0131n\u0131 sa\u011flars\u0131n\u0131z. Bir Python web projesi geli\u015ftirirken, frontend k\u0131sm\u0131n\u0131n da bu duyarl\u0131 tasar\u0131m prensiplerine uygun oldu\u011fundan emin olmak, genel kullan\u0131c\u0131 memnuniyetini art\u0131racakt\u0131r.<\/p>\n<\/p><\/div>\n Projenizin \u00f6l\u00e7e\u011fi b\u00fcy\u00fcd\u00fck\u00e7e veya ekip yap\u0131n\u0131z geni\u015fledik\u00e7e, geleneksel tekil proje yap\u0131lar\u0131n\u0131n s\u0131n\u0131rlar\u0131na ula\u015fabilirsiniz. Bu noktada, daha ileri d\u00fczey proje organizasyon yakla\u015f\u0131mlar\u0131 olan monorepo ve mikroservis mimarileri devreye girer. Her iki yakla\u015f\u0131m da kendi avantaj ve dezavantajlar\u0131yla birlikte gelir ve belirli ihtiya\u00e7lara y\u00f6nelik tasarlanm\u0131\u015ft\u0131r.<\/p>\n Monorepo (monolitik depo), birden fazla projenin, k\u00fct\u00fcphanenin veya servisin tek bir versiyon kontrol deposunda (\u00f6rne\u011fin Git deposu) bar\u0131nd\u0131r\u0131ld\u0131\u011f\u0131 bir yaz\u0131l\u0131m geli\u015ftirme stratejisidir. Bu, sadece bir uygulama de\u011fil, birbiriyle ili\u015fkili bir\u00e7ok uygulaman\u0131n veya k\u00fct\u00fcphanenin ayn\u0131 depoda bulunmas\u0131 anlam\u0131na gelir. \u00d6rne\u011fin, bir web frontend uygulamas\u0131, bir mobil uygulama backend API'si ve birka\u00e7 ortak Python k\u00fct\u00fcphanesi ayn\u0131 Git deposu i\u00e7inde ya\u015fayabilir.<\/p>\n Avantajlar\u0131:<\/strong><\/p>\napp.py<\/code> dosyas\u0131 ile ba\u015flayan proje, \u00fcr\u00fcn y\u00f6netimi, kullan\u0131c\u0131 kimlik do\u011frulamas\u0131, \u00f6deme sistemleri ve envanter takibi gibi y\u00fczlerce farkl\u0131 i\u015flev ekledik\u00e7e kaosa s\u00fcr\u00fcklenmi\u015fti. Yeni bir \u00f6zellik eklemek ya da var olan bir hatay\u0131 d\u00fczeltmek saatler al\u0131yor, bazen g\u00fcnler s\u00fcren test s\u00fcre\u00e7leri gerektiriyordu \u00e7\u00fcnk\u00fc bir de\u011fi\u015fikli\u011fin t\u00fcm sistemi nas\u0131l etkileyece\u011fi belirsizdi. Sonunda, ekip mecburen “b\u00fcy\u00fck bir refactor” s\u00fcrecine girerek t\u00fcm projeyi mod\u00fcler bir yap\u0131ya d\u00f6n\u00fc\u015ft\u00fcrd\u00fc. Art\u0131k her servis (\u00fcr\u00fcn, kullan\u0131c\u0131, \u00f6deme) kendi dizininde, kendi ba\u011f\u0131ml\u0131l\u0131klar\u0131 ve testleriyle birlikte ya\u015f\u0131yordu. Bu yeniden yap\u0131land\u0131rma, ba\u015flang\u0131\u00e7ta zaman alsa da, ekibin h\u0131z\u0131n\u0131 art\u0131rd\u0131, hata oranlar\u0131n\u0131 d\u00fc\u015f\u00fcrd\u00fc ve yeni \u00f6zelliklerin daha g\u00fcvenle da\u011f\u0131t\u0131lmas\u0131n\u0131 sa\u011flad\u0131. Bu \u00f6rnek, sa\u011flam bir proje yap\u0131s\u0131n\u0131n sadece b\u00fcy\u00fck projeler i\u00e7in de\u011fil, b\u00fcy\u00fcmeyi hedefleyen her proje i\u00e7in bir yat\u0131r\u0131m oldu\u011funu a\u00e7\u0131k\u00e7a g\u00f6sterir.<\/p>\nPython Proje Dizini Yap\u0131s\u0131 Nas\u0131l Olu\u015fturulur? Temel Yakla\u015f\u0131mlar<\/h2>\n
.py<\/code> uzant\u0131l\u0131 dosyad\u0131r, “paket” ise mod\u00fcller ve\/veya di\u011fer alt paketler i\u00e7eren bir dizindir. Bir dizini Python paketi olarak i\u015faretlemek i\u00e7in i\u00e7ine bo\u015f bir __init__.py<\/code> dosyas\u0131 koyman\u0131z yeterlidir (Python 3.3 ve sonras\u0131 i\u00e7in bu zorunluluk biraz hafiflese de, iyi bir pratik olarak kabul edilir). Bu dosya, Python’a bu dizinin i\u00e7eri\u011fini import edilebilir bir paket olarak ele almas\u0131n\u0131 s\u00f6yler.<\/p>\nsrc<\/code> olarak adland\u0131r\u0131l\u0131r veya do\u011frudan projenin ana paket ad\u0131 olabilir. Bu yakla\u015f\u0131m, ana uygulama kodunu di\u011fer yap\u0131land\u0131rma dosyalar\u0131, belgeler, testler veya ara\u00e7lar gibi \u00f6\u011felerden ay\u0131rarak d\u00fczeni art\u0131r\u0131r. \u0130\u015fte tipik bir \u00f6rnek:<\/p>\n\n.\n\u251c\u2500\u2500 src\/\n\u2502 \u2514\u2500\u2500 my_project\/ # Ana paket dizini\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 main.py # Uygulaman\u0131n ana giri\u015f noktas\u0131\n\u2502 \u251c\u2500\u2500 utils.py # Yard\u0131mc\u0131 fonksiyonlar\n\u2502 \u2514\u2500\u2500 models\/ # Veri modelleri veya i\u015f mant\u0131\u011f\u0131\n\u2502 \u2514\u2500\u2500 __init__.py\n\u2502 \u2514\u2500\u2500 user.py\n\u251c\u2500\u2500 tests\/ # Test dosyalar\u0131\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2514\u2500\u2500 test_main.py\n\u251c\u2500\u2500 .env # Ortam de\u011fi\u015fkenleri (opsiyonel)\n\u251c\u2500\u2500 .gitignore # Git taraf\u0131ndan yok say\u0131lacak dosyalar\n\u251c\u2500\u2500 README.md # Proje a\u00e7\u0131klamas\u0131\n\u251c\u2500\u2500 requirements.txt # Proje ba\u011f\u0131ml\u0131l\u0131klar\u0131\n\u2514\u2500\u2500 setup.py # Projenin da\u011f\u0131t\u0131m bilgileri (veya pyproject.toml)\n <\/pre>\nmy_project<\/code> ana pakettir ve alt\u0131nda main.py<\/code>, utils.py<\/code> gibi mod\u00fcller bar\u0131nd\u0131r\u0131r. models<\/code> ise my_project<\/code> paketinin alt\u0131nda bir alt pakettir. tests<\/code> dizini ise projenin testlerini i\u00e7erir. Bu ayr\u0131m, kodun testlerden ve di\u011fer yap\u0131land\u0131rmalardan temiz bir \u015fekilde izole edilmesini sa\u011flar.<\/p>\nSanal Ortamlar\u0131n \u00d6nemi ve Kullan\u0131m\u0131<\/h3>\n
Django 2.x<\/code> kullan\u0131rken, di\u011fer bir projeniz Django 4.x<\/code> kullanabilir. Sanal ortamlar sayesinde, her proje kendi ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131 izole bir \u015fekilde y\u00f6netebilir.<\/p>\n.gitignore<\/code> dosyas\u0131na venv\/<\/code> veya .venv\/<\/code> eklemek, ortam dosyalar\u0131n\u0131n versiyon kontrol\u00fcne dahil edilmesini engeller ve projenizi temiz tutar.\n <\/div>\n\n# Proje k\u00f6k dizininde\npython3 -m venv .venv\n\n# Sanal ortam\u0131 etkinle\u015ftirme (Linux\/macOS)\nsource .venv\/bin\/activate\n\n# Sanal ortam\u0131 etkinle\u015ftirme (Windows - PowerShell)\n.venv\\Scripts\\Activate.ps1\n\n# Sanal ortam\u0131 etkinle\u015ftirme (Windows - Cmd)\n.venv\\Scripts\\activate.bat\n <\/pre>\nrequirements.txt<\/code> (veya pyproject.toml<\/code>) dosyas\u0131na ekleyerek, ba\u015fkalar\u0131n\u0131n projenizi kolayca kurmas\u0131n\u0131 sa\u011flayabilirsiniz:<\/p>\n\n# Ba\u011f\u0131ml\u0131l\u0131klar\u0131 y\u00fckleme\npip install -r requirements.txt\n\n# Y\u00fckl\u00fc ba\u011f\u0131ml\u0131l\u0131klar\u0131 requirements.txt dosyas\u0131na yazma\npip freeze > requirements.txt\n <\/pre>\nBa\u011f\u0131ml\u0131l\u0131k Y\u00f6netimi:
requirements.txt<\/code> ve pyproject.toml<\/code> Kar\u015f\u0131la\u015ft\u0131rmas\u0131<\/h2>\nrequirements.txt<\/code> dosyas\u0131 standart bir \u00e7\u00f6z\u00fcm olmu\u015ftur. Ancak son y\u0131llarda, daha modern ve kapsaml\u0131 bir yakla\u015f\u0131m sunan pyproject.toml<\/code> dosyas\u0131 pop\u00fclerlik kazanm\u0131\u015ft\u0131r. Peki, bu iki yakla\u015f\u0131m aras\u0131ndaki farklar nelerdir ve hangi durumda hangisini tercih etmelisiniz?<\/p>\nrequirements.txt<\/code>: Basitlik ve Yayg\u0131nl\u0131k<\/h3>\nrequirements.txt<\/code> dosyas\u0131, Python projelerindeki harici ba\u011f\u0131ml\u0131l\u0131klar\u0131 listelemek i\u00e7in kullan\u0131lan d\u00fcz metin tabanl\u0131 bir dosyad\u0131r. Her sat\u0131r, bir paketin ad\u0131n\u0131 ve iste\u011fe ba\u011fl\u0131 olarak versiyon k\u0131s\u0131tlamalar\u0131n\u0131 i\u00e7erir. \u00d6rne\u011fin:<\/p>\n\nDjango==4.2.7\nrequests>=2.28.1,<3.0.0\ngunicorn\n <\/pre>\npip install -r requirements.txt<\/code> komutuyla ba\u011f\u0131ml\u0131l\u0131klar\u0131 kolayca kurabilir. Yeni ba\u015flayanlar i\u00e7in anla\u015f\u0131lmas\u0131 kolayd\u0131r ve h\u0131zl\u0131ca projenin ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131 listelemek i\u00e7in pratik bir \u00e7\u00f6z\u00fcmd\u00fcr. Ayr\u0131ca, canl\u0131 sistemlerde veya CI\/CD s\u00fcre\u00e7lerinde ba\u011f\u0131ml\u0131l\u0131klar\u0131 kesin versiyonlar\u0131yla (pinning) belirtmek i\u00e7in s\u0131kl\u0131kla kullan\u0131l\u0131r, bu da da\u011f\u0131t\u0131mlarda tutarl\u0131l\u0131\u011f\u0131 garanti eder.<\/p>\nrequirements.txt<\/code> dosyas\u0131n\u0131n baz\u0131 dezavantajlar\u0131 vard\u0131r. Her \u015feyden \u00f6nce, sadece do\u011frudan ba\u011f\u0131ml\u0131l\u0131klar\u0131 de\u011fil, bu ba\u011f\u0131ml\u0131l\u0131klar\u0131n kendi ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131 (transitive dependencies) da i\u00e7ermesi yayg\u0131n bir pratik haline gelmi\u015ftir (pip freeze > requirements.txt<\/code> komutu ile). Bu durum, dosyan\u0131n gere\u011finden fazla \u015fi\u015fmesine ve manuel y\u00f6netimin zorla\u015fmas\u0131na neden olabilir. Ayr\u0131ca, paket kilitleme (lock files) gibi geli\u015fmi\u015f \u00f6zellikler do\u011frudan desteklenmez, bu da farkl\u0131 ortamlarda farkl\u0131 dolayl\u0131 ba\u011f\u0131ml\u0131l\u0131k versiyonlar\u0131n\u0131n kurulmas\u0131na yol a\u00e7abilir ve \"benim makinemde \u00e7al\u0131\u015f\u0131yordu\" sendromuna neden olabilir. Ek olarak, proje meta verilerini veya yap\u0131land\u0131rma bilgilerini (test komutlar\u0131, linter ayarlar\u0131 vb.) depolamak i\u00e7in uygun de\u011fildir.<\/p>\npyproject.toml<\/code>: Modern Python Projeleri \u0130\u00e7in Hepsi Bir Arada \u00c7\u00f6z\u00fcm<\/h3>\npyproject.toml<\/code> dosyas\u0131, PEP 518 ile tan\u0131t\u0131lan ve Python ekosistemindeki \u00e7e\u015fitli ara\u00e7lar (paketleme, test, linting) i\u00e7in merkezi bir yap\u0131land\u0131rma noktas\u0131 sa\u011flamay\u0131 ama\u00e7layan bir TOML formatl\u0131 dosyad\u0131r. Bu dosya, \u00f6zellikle Poetry, PDM veya Hatch gibi modern ba\u011f\u0131ml\u0131l\u0131k ve proje y\u00f6netim ara\u00e7lar\u0131 taraf\u0131ndan kullan\u0131l\u0131r.<\/p>\npyproject.toml<\/code> dosyas\u0131 \u015funa benzeyebilir:<\/p>\n\n[project]\nname = \"my_awesome_project\"\nversion = \"0.1.0\"\ndescription = \"A short description of my project.\"\nauthors = [\n { name = \"Your Name\", email = \"you@example.com\" },\n]\ndependencies = [\n \"Django~=4.2\",\n \"requests>=2.28.1\",\n]\n\n[tool.poetry.dev-dependencies]\npytest = \"^7.0\"\nflake8 = \"^5.0\"\n\n[build-system]\nrequires = [\"poetry-core>=1.0.0\"]\nbuild-backend = \"poetry.core.masonry.api\"\n <\/pre>\n\n
pyproject.toml<\/code>'a dayanarak bir poetry.lock<\/code> veya pdm.lock<\/code> dosyas\u0131 olu\u015fturur. Bu dosyalar, t\u00fcm do\u011frudan ve dolayl\u0131 ba\u011f\u0131ml\u0131l\u0131klar\u0131n tam versiyonlar\u0131n\u0131 ve hash de\u011ferlerini kilitler. Bu, t\u00fcm geli\u015ftirme ve da\u011f\u0131t\u0131m ortamlar\u0131nda ayn\u0131 ba\u011f\u0131ml\u0131l\u0131k setinin kullan\u0131lmas\u0131n\u0131 garanti eder.<\/li>\ndev-dependencies<\/code> veya group.dev<\/code> gibi b\u00f6l\u00fcmlerle geli\u015ftirme ve \u00fcretim ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131 kolayca ay\u0131rman\u0131za olanak tan\u0131r.<\/li>\nsetup.py<\/code> dosyas\u0131n\u0131n yerini alarak, projenin nas\u0131l paketlenip da\u011f\u0131t\u0131laca\u011f\u0131na dair bilgileri de i\u00e7erir.<\/li>\n<\/ul>\nrequirements.txt<\/code> kullan\u0131yorlard\u0131, ancak farkl\u0131 geli\u015ftiricilerin ortamlar\u0131nda bazen farkl\u0131 ba\u011f\u0131ml\u0131l\u0131k versiyonlar\u0131 kuruluyordu, bu da hata ay\u0131klama s\u00fcre\u00e7lerini uzat\u0131yordu. \u00d6zellikle bir ba\u011f\u0131ml\u0131l\u0131\u011f\u0131n alt ba\u011f\u0131ml\u0131l\u0131\u011f\u0131n\u0131n yeni bir versiyonu, ba\u015fka bir geli\u015ftiricinin ortam\u0131nda farkl\u0131 bir \u015fekilde \u00e7\u00f6z\u00fcl\u00fcp beklenmedik davran\u0131\u015flara yol a\u00e7\u0131yordu. Ekip, pyproject.toml<\/code> ve Poetry'ye ge\u00e7i\u015f yapt\u0131\u011f\u0131nda, poetry.lock<\/code> dosyas\u0131 sayesinde herkesin ortam\u0131nda ayn\u0131 ba\u011f\u0131ml\u0131l\u0131k setinin kilitlenmesi sa\u011fland\u0131. Bu ge\u00e7i\u015f, \"benim makinemde \u00e7al\u0131\u015f\u0131yor\" sorunlar\u0131n\u0131 ortadan kald\u0131rd\u0131, CI\/CD boru hatt\u0131n\u0131 basitle\u015ftirdi ve geli\u015ftirici \u00fcretkenli\u011fini g\u00f6zle g\u00f6r\u00fcl\u00fcr \u015fekilde art\u0131rd\u0131.<\/p>\nNe Zaman Hangisini Kullanmal\u0131?<\/h3>\n
\n\n
\n \u00d6zellik<\/th>\n requirements.txt<\/code><\/th>\npyproject.toml<\/code> (Poetry\/PDM ile)<\/th>\n<\/tr>\n<\/thead>\n\n\n Kullan\u0131m Kolayl\u0131\u011f\u0131<\/strong><\/td>\n \u00c7ok basit, h\u0131zl\u0131 ba\u015flang\u0131\u00e7<\/td>\n Daha fazla \u00f6zellik, ilk \u00f6\u011frenme e\u011frisi olabilir<\/td>\n<\/tr>\n \n Ba\u011f\u0131ml\u0131l\u0131k Kilitleme<\/strong><\/td>\n pip freeze<\/code> ile manuel, tam g\u00fcvence yok<\/td>\nOtomatik kilit dosyalar\u0131 ( poetry.lock<\/code>, pdm.lock<\/code>), tam tutarl\u0131l\u0131k<\/td>\n<\/tr>\n\n Geli\u015ftirme\/\u00dcretim Ay\u0131r\u0131m\u0131<\/strong><\/td>\n Manuel ( requirements-dev.txt<\/code>), resmi standart yok<\/td>\nDahili destek ( dev-dependencies<\/code>)<\/td>\n<\/tr>\n\n Meta Veri Deste\u011fi<\/strong><\/td>\n Yok<\/td>\n Tam destek (proje ad\u0131, versiyon, yazar vb.)<\/td>\n<\/tr>\n \n Paketleme\/Da\u011f\u0131t\u0131m<\/strong><\/td>\n setup.py<\/code> veya setup.cfg<\/code> gerektirir<\/td>\nKendi i\u00e7inde destekler, build-system<\/code><\/td>\n<\/tr>\n\n \u00d6nerilen Kullan\u0131m<\/strong><\/td>\n K\u00fc\u00e7\u00fck, h\u0131zl\u0131 betikler, eski projeler<\/td>\n Yeni, orta ve b\u00fcy\u00fck \u00f6l\u00e7ekli projeler, k\u00fct\u00fcphane geli\u015ftirme<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n requirements.txt<\/code> basit projeler veya mevcut sistemlerle uyumluluk gerektiren durumlar i\u00e7in hala ge\u00e7erli bir se\u00e7enektir. Ancak, modern Python projeleri, \u00f6zellikle k\u00fct\u00fcphane geli\u015ftirme veya ekip tabanl\u0131 uygulamalar i\u00e7in pyproject.toml<\/code>'\u0131 ve Poetry veya PDM gibi modern ara\u00e7lar\u0131 kullanmak, uzun vadede \u00e7ok daha fazla esneklik, kontrol ve tutarl\u0131l\u0131k sa\u011flayacakt\u0131r. Bu sayede, projenizin ba\u011f\u0131ml\u0131l\u0131klar\u0131 \u00fczerinde tam kontrol sahibi olabilir, farkl\u0131 ortamlarda tutarl\u0131 bir \u015fekilde \u00e7al\u0131\u015fmas\u0131n\u0131 garanti alt\u0131na alabilirsiniz.<\/p>\nMod\u00fcler Tasar\u0131m ve Paketleme Prensipleri: DRY ve SOLID Yakla\u015f\u0131mlar\u0131<\/h2>\n
.py<\/code> dosyalar\u0131) ve paketler (mod\u00fcl koleksiyonlar\u0131) arac\u0131l\u0131\u011f\u0131yla uygulan\u0131r. Ancak sadece kodu dosyalara ay\u0131rmak yeterli de\u011fildir; bu ayr\u0131m\u0131 yaparken belirli tasar\u0131m prensiplerini g\u00f6z \u00f6n\u00fcnde bulundurmak, kodunuzun kalitesini, s\u00fcrd\u00fcr\u00fclebilirli\u011fini ve \u00f6l\u00e7eklenebilirli\u011fini art\u0131r\u0131r. Bu ba\u011flamda, DRY (Don't Repeat Yourself) ve SOLID prensipleri, bize yol g\u00f6steren \u00f6nemli rehberlerdir.<\/p>\nDRY Prensibi: Kendinizi Tekrar Etmeyin<\/h3>\n
\n# K\u00f6t\u00fc \u00f6rnek (DRY ihlali)\ndef authenticate_user(username, password):\n # ... kullan\u0131c\u0131 do\u011frulama mant\u0131\u011f\u0131 ...\n pass\n\ndef authenticate_admin(username, password):\n # ... Y\u0130NE AYNI do\u011frulama mant\u0131\u011f\u0131 ...\n pass\n\n# \u0130yi \u00f6rnek (DRY'ye uygun)\n# auth_service.py i\u00e7inde\ndef _verify_credentials(username, password):\n # Ortak do\u011frulama mant\u0131\u011f\u0131 burada\n if username == \"admin\" and password == \"secret\":\n return True\n return False\n\ndef authenticate_user(username, password):\n return _verify_credentials(username, password)\n\ndef authenticate_admin(username, password):\n return _verify_credentials(username, password) # Veya ek admin \u00f6zel do\u011frulama\n\n# Uygulaman\u0131n farkl\u0131 yerlerinden kullan\u0131m\n# from my_project.services.auth_service import authenticate_user\n# if authenticate_user(\"john_doe\", \"password123\"): ...\n <\/pre>\nSOLID Prensipleri ve Proje Yap\u0131s\u0131na Etkisi<\/h3>\n
\n
user_management<\/code> paketi yaln\u0131zca kullan\u0131c\u0131larla ilgili i\u015flevleri (kay\u0131t, giri\u015f, profil g\u00fcncelleme) bar\u0131nd\u0131rmal\u0131d\u0131r, e-posta g\u00f6nderimi veya \u00f6deme i\u015flemleri gibi farkl\u0131 sorumluluklar\u0131 de\u011fil. E\u011fer bir mod\u00fcl birden fazla \u015feyi yap\u0131yorsa, onu daha k\u00fc\u00e7\u00fck, daha odakl\u0131 mod\u00fcllere ay\u0131rman\u0131z gerekebilir. Bu, her mod\u00fcl\u00fcn daha k\u00fc\u00e7\u00fck, daha anla\u015f\u0131l\u0131r ve daha kolay test edilebilir olmas\u0131n\u0131 sa\u011flar.<\/p>\n\n# K\u00f6t\u00fc \u00f6rnek (SRP ihlali)\n# users.py\nclass User:\n def __init__(self, name, email):\n self.name = name\n self.email = email\n\n def save_to_database(self):\n # ... kullan\u0131c\u0131y\u0131 veritaban\u0131na kaydet ...\n pass\n\n def send_welcome_email(self):\n # ... kullan\u0131c\u0131ya ho\u015f geldin e-postas\u0131 g\u00f6nder ...\n pass\n\n# \u0130yi \u00f6rnek (SRP'ye uygun)\n# user_models.py\nclass User:\n def __init__(self, name, email):\n self.name = name\n self.email = email\n\n# user_repository.py\nclass UserRepository:\n def save(self, user):\n # ... kullan\u0131c\u0131y\u0131 veritaban\u0131na kaydetme sorumlulu\u011fu ...\n pass\n\n# email_service.py\nclass EmailService:\n def send_welcome_email(self, user):\n # ... e-posta g\u00f6nderme sorumlulu\u011fu ...\n pass\n <\/pre>\nmodul_a<\/code> modul_b<\/code>'yi import ediyor ve modul_b<\/code> de modul_a<\/code>'y\u0131 import ediyorsa, bu dairesel bir ba\u011f\u0131ml\u0131l\u0131k yarat\u0131r. Bu durum, kodun okunmas\u0131n\u0131 ve anla\u015f\u0131lmas\u0131n\u0131 zorla\u015ft\u0131r\u0131r, mod\u00fcller aras\u0131 ba\u011flam\u0131 karma\u015f\u0131kla\u015ft\u0131r\u0131r ve test yazmay\u0131 g\u00fc\u00e7le\u015ftirir. Bu t\u00fcr durumlarla kar\u015f\u0131la\u015f\u0131ld\u0131\u011f\u0131nda, genellikle ortak bir soyutlamay\u0131 veya daha temel bir yard\u0131mc\u0131 mod\u00fcl\u00fc \u00e7\u0131karmak iyi bir \u00e7\u00f6z\u00fcm olabilir. Bu, paketlerinizin ve mod\u00fcllerinizin net, tek y\u00f6nl\u00fc bir ba\u011f\u0131ml\u0131l\u0131k hiyerar\u015fisine sahip olmas\u0131n\u0131 sa\u011flar.<\/p>\nTest Stratejileri ve Proje Yap\u0131s\u0131na Entegrasyonu<\/h2>\n
Neden Test Yazmal\u0131y\u0131z? Birim Testleri ve Entegrasyon Testleri<\/h3>\n
\n
\n
Test Dizin Yap\u0131s\u0131 ve
pytest<\/code> Kullan\u0131m\u0131<\/h3>\ntests\/<\/code> dizini olu\u015fturmakt\u0131r. Bu dizin, t\u00fcm test dosyalar\u0131n\u0131z\u0131 bar\u0131nd\u0131r\u0131r ve ana uygulama kodundan ayr\u0131 tutulmas\u0131n\u0131 sa\u011flar. \u0130\u015fte bir \u00f6rnek:<\/p>\n\n.\n\u251c\u2500\u2500 src\/\n\u2502 \u2514\u2500\u2500 my_app\/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2514\u2500\u2500 calculator.py # Test edilecek mod\u00fcl\n\u251c\u2500\u2500 tests\/\n\u2502 \u251c\u2500\u2500 __init__.py # Bo\u015f veya test yap\u0131land\u0131rmas\u0131 i\u00e7erebilir\n\u2502 \u2514\u2500\u2500 test_calculator.py # calculator.py'nin testleri\n\u251c\u2500\u2500 pyproject.toml\n\u2514\u2500\u2500 poetry.lock\n <\/pre>\ntest_calculator.py<\/code> dosyas\u0131 calculator.py<\/code> mod\u00fcl\u00fcndeki fonksiyonlar\u0131 test eder. Dosya ad\u0131n\u0131n test_<\/code> ile ba\u015flamas\u0131 veya test fonksiyonlar\u0131n\u0131n adlar\u0131n\u0131n test_<\/code> ile ba\u015flamas\u0131, pytest<\/code> gibi test ara\u00e7lar\u0131n\u0131n bunlar\u0131 otomatik olarak bulmas\u0131n\u0131 sa\u011flar.<\/p>\npytest<\/code><\/strong> Python'daki en pop\u00fcler ve g\u00fc\u00e7l\u00fc test \u00e7at\u0131lar\u0131ndan biridir. Kurulumu basit, kullan\u0131m\u0131 kolay ve geni\u015f bir eklenti ekosistemine sahiptir. pytest<\/code>'i kurduktan sonra (genellikle sanal ortam\u0131n\u0131zda pip install pytest<\/code> ile), projenizin k\u00f6k dizininden pytest<\/code> komutunu \u00e7al\u0131\u015ft\u0131rarak testlerinizi otomatik olarak bulup y\u00fcr\u00fctebilirsiniz.<\/p>\n\n# src\/my_app\/calculator.py\ndef add(a, b):\n return a + b\n\ndef subtract(a, b):\n return a - b\n <\/pre>\n<\/pre>\n
\n# tests\/test_calculator.py
\nfrom src.my_app.calculator import add, subtract<\/p>\n
\n assert add(1, 2) == 3
\n assert add(-1, 1) == 0
\n assert add(0, 0) == 0<\/p>\n
\n assert subtract(5, 3) == 2
\n assert subtract(10, 20) == -10
\n <\/code><\/p>\n\n(venv) $ pytest\n <\/pre>\n
\n pytest<\/code> otomatik olarak tests\/<\/code> dizinindeki test_*.py<\/code> dosyalar\u0131n\u0131 bulacak ve i\u00e7indeki test_*<\/code> fonksiyonlar\u0131n\u0131 \u00e7al\u0131\u015ft\u0131racakt\u0131r.<\/p>\npyproject.toml<\/code> (\u00f6rne\u011fin [tool.poetry.dev-dependencies]<\/code>) i\u00e7inde tutun.\n <\/div>\nVaka Analizi: Bir CI\/CD S\u00fcrecinde Otomatik Testlerin De\u011feri<\/h3>\n
Dok\u00fcmantasyon ve Kod Kalitesi Ara\u00e7lar\u0131: Projenizi Profesyonelle\u015ftirin<\/h2>\n
docstrings<\/code> ve \u00d6nemi<\/h3>\ndocstrings<\/code> (belge dizgileri), fonksiyonlar\u0131n, s\u0131n\u0131flar\u0131n, metotlar\u0131n ve mod\u00fcllerin ne i\u015fe yarad\u0131\u011f\u0131n\u0131 a\u00e7\u0131klayan \u00e7ok \u00f6nemli bir dok\u00fcmantasyon bi\u00e7imidir. Genellikle \u00fc\u00e7l\u00fc \u00e7ift t\u0131rnak (\"\"\"...\"\"\"<\/code>) i\u00e7ine yaz\u0131l\u0131r ve ilgili kod blo\u011funun hemen alt\u0131na yerle\u015ftirilir. docstrings<\/code>, Python'\u0131n kendi help()<\/code> fonksiyonu arac\u0131l\u0131\u011f\u0131yla veya IDE'lerde otomatik olarak g\u00f6r\u00fcnt\u00fclenebildi\u011fi i\u00e7in canl\u0131 ve eri\u015filebilir bir dok\u00fcmantasyon sa\u011flar.<\/p>\ndocstrings<\/code>, sadece fonksiyonun ne yapt\u0131\u011f\u0131n\u0131 de\u011fil, ayn\u0131 zamanda bekledi\u011fi arg\u00fcmanlar\u0131, d\u00f6nd\u00fcrd\u00fc\u011f\u00fc de\u011feri, f\u0131rlatabilece\u011fi istisnalar\u0131 ve kullan\u0131m \u00f6rneklerini de i\u00e7ermelidir. NumPy, Google veya reStructuredText gibi belirli docstring<\/code> formatlar\u0131n\u0131 kullanmak, tutarl\u0131l\u0131\u011f\u0131 art\u0131r\u0131r ve otomatize edilmi\u015f dok\u00fcmantasyon olu\u015fturma ara\u00e7lar\u0131 taraf\u0131ndan daha kolay i\u015flenmelerini sa\u011flar.<\/p>\n\n# src\/my_app\/utils.py\ndef calculate_average(numbers: list) -> float:\n \"\"\"\n Verilen say\u0131 listesinin ortalamas\u0131n\u0131 hesaplar.\n\n Args:\n numbers (list): Ortalamas\u0131 hesaplanacak say\u0131lar\u0131n listesi.\n Liste bo\u015f olamaz ve t\u00fcm elemanlar say\u0131sal olmal\u0131d\u0131r.\n\n Returns:\n float: Say\u0131lar\u0131n aritmetik ortalamas\u0131.\n\n Raises:\n ValueError: E\u011fer numbers<\/code> listesi bo\u015fsa.\n TypeError: E\u011fer numbers<\/code> listesindeki bir eleman say\u0131sal de\u011filse.\n\n Example:\n >>> calculate_average([1, 2, 3, 4, 5])\n 3.0\n \"\"\"\n if not numbers:\n raise ValueError(\"Say\u0131 listesi bo\u015f olamaz.\")\n if not all(isinstance(n, (int, float)) for n in numbers):\n raise TypeError(\"Liste elemanlar\u0131 say\u0131sal olmal\u0131d\u0131r.\")\n return sum(numbers) \/ len(numbers)\n <\/pre>\ndocstring<\/code>'ler, kodun karma\u015f\u0131k k\u0131s\u0131mlar\u0131n\u0131 anlamak i\u00e7in harici belgelere ba\u015fvurma ihtiyac\u0131n\u0131 azalt\u0131r.<\/p>\nSphinx<\/code> veya MkDocs<\/code> gibi Ara\u00e7larla Dok\u00fcmantasyon Olu\u015fturma<\/h3>\nSphinx<\/code> veya MkDocs<\/code> gibi ara\u00e7lar devreye girer. Bu ara\u00e7lar, docstrings<\/code>'leri, Markdown veya reStructuredText format\u0131ndaki di\u011fer metin dosyalar\u0131n\u0131 alarak, g\u00f6z al\u0131c\u0131 HTML (veya PDF, ePub) dok\u00fcmantasyon siteleri olu\u015fturabilirler.<\/p>\n\n
docstrings<\/code>'lerden otomatik olarak API referanslar\u0131 olu\u015fturabilir ve \u00e7apraz referanslar, indeksler gibi geli\u015fmi\u015f \u00f6zellikler sunar. Python k\u00fct\u00fcphaneleri ve karma\u015f\u0131k projeler i\u00e7in idealdir.<\/li>\ndocs\/<\/code> dizini alt\u0131nda yer alacak Markdown veya reStructuredText dosyalar\u0131n\u0131 kullan\u0131r ve bunlar\u0131 bir web sitesi olarak yay\u0131nlanabilir hale getirir. Bu, \u00f6zellikle a\u00e7\u0131k kaynak projelerde veya b\u00fcy\u00fck ekiplerde bilginin merkezi ve eri\u015filebilir olmas\u0131n\u0131 sa\u011flar.<\/p>\nLinting (Flake8, Pylint) ve Bi\u00e7imlendirme (Black, isort) Ara\u00e7lar\u0131<\/h3>\n
\n
\n
pycodestyle<\/code> ve pyflakes<\/code>'i bir araya getirir.<\/li>\nFlake8<\/code>'den daha kapsaml\u0131d\u0131r, kod kalitesi hakk\u0131nda puanlar verir, olas\u0131 aray\u00fcz sorunlar\u0131n\u0131 ve kod kokular\u0131n\u0131 tespit eder.<\/li>\n<\/ul>\n\n
import<\/code>'lar\u0131n daha d\u00fczenli ve okunabilir olmas\u0131n\u0131 sa\u011flar.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\ninternal-tools<\/code> projesini d\u00fc\u015f\u00fcnelim. Proje, farkl\u0131 tecr\u00fcbe seviyelerinden geli\u015ftiriciler taraf\u0131ndan yaz\u0131ld\u0131\u011f\u0131 i\u00e7in kod stili ve kalitesi tutars\u0131zd\u0131. docstrings<\/code> eksikli\u011fi, yeni ekibin mevcut fonksiyonlar\u0131 anlamakta zorlanmas\u0131na neden oluyordu. Firma, Black<\/code> ve isort<\/code>'u CI\/CD s\u00fcrecine entegre ederek t\u00fcm kodlar\u0131n otomatik olarak bi\u00e7imlendirilmesini sa\u011flad\u0131. Ayr\u0131ca Flake8<\/code>'i kullanarak belirli stil kurallar\u0131na uyulmas\u0131n\u0131 zorunlu k\u0131ld\u0131. T\u00fcm fonksiyonlara docstring<\/code> yazma zorunlulu\u011fu getirildi ve Sphinx<\/code> ile otomatik dok\u00fcmantasyon olu\u015fturuldu. Bu de\u011fi\u015fiklikler, projenin okunabilirli\u011fini ve bak\u0131m\u0131n\u0131 radikal bir \u015fekilde iyile\u015ftirdi, yeni ekip \u00fcyelerinin entegrasyon s\u00fcresini k\u0131saltt\u0131 ve genel yaz\u0131l\u0131m kalitesini y\u00fckseltti.<\/p>\nMobil Uyumluluk \u0130\u00e7in Bir Not<\/h3>\n
\n\/* \u00d6rnek bir CSS medya sorgusu *\/\n@media screen and (max-width: 768px) {\n .ana-icerik {\n padding: 10px;\n font-size: 14px;\n }\n .sidebar {\n display: none; \/* K\u00fc\u00e7\u00fck ekranlarda kenar \u00e7ubu\u011funu gizle *\/\n }\n .menu-toggle {\n display: block; \/* K\u00fc\u00e7\u00fck ekranlarda men\u00fc d\u00fc\u011fmesini g\u00f6ster *\/\n }\n}\n <\/pre>\n\u0130leri D\u00fczey Proje Yap\u0131lar\u0131: Monorepo ve Mikroservis Yakla\u015f\u0131mlar\u0131<\/h2>\n
Monorepo Nedir, Ne Zaman Kullan\u0131l\u0131r?<\/h3>\n
\n