Python
Sınıflar
Fonksiyonlar
Kullanıcı yönetimi
API örnekleri
Lisans: Belirtilmemis
Python — Dosya ve Veri Dışa Aktarım/Okuma (runxlrd.py)
Orijinal Kod Adı:
Python — runxlrd.py
Bu Python kodu (`runxlrd.py`), modüler iş mantığını ve yardımcı rutinleri uygular. Dosya ölçeği: 410 satır (~15.7 KB). Tanımlı sınıf/yapılar: LogHandler. Sağladığı başlıca fonksiyonlar: `__init__` (başlatma), `setfileheading`, `write` (yazma), `show_row` (satır), `get_row_data` (satır getirme), `bk_header` (üst bilgi). Kaynak depo: python-excel/xlrd.
💡 Püf Noktaları:
• Kullanıcı kaynaklı dosya adlarını doğrudan birleştirmeyin; `basename()` ve `realpath()` ile dizin aşımı (path traversal) kontrolü yapın.
• Büyük dosyalarda `file_get_contents()` yerine `fopen()` + tamponlu parça okuma kullanarak bellek taşmasını önleyin.
• `runxlrd.py` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• Python kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. İzole çalışma için Python 3 sanal ortamı (`python3 -m venv .venv`) oluşturup etkinleştirin.
2. Ortam değişkenlerini ve dosya/API yollarını yerel çalışma dizinine göre ayarlayın.
3. Modülden `LogHandler` sınıfını içe aktarıp örnek oluşturarak `setfileheading(...)` metodunu çağırın veya `python3 runxlrd.py` ile CLI'dan çalıştırın.
💡 Püf Noktaları:
• Kullanıcı kaynaklı dosya adlarını doğrudan birleştirmeyin; `basename()` ve `realpath()` ile dizin aşımı (path traversal) kontrolü yapın.
• Büyük dosyalarda `file_get_contents()` yerine `fopen()` + tamponlu parça okuma kullanarak bellek taşmasını önleyin.
• `runxlrd.py` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• Python kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. İzole çalışma için Python 3 sanal ortamı (`python3 -m venv .venv`) oluşturup etkinleştirin.
2. Ortam değişkenlerini ve dosya/API yollarını yerel çalışma dizinine göre ayarlayın.
3. Modülden `LogHandler` sınıfını içe aktarıp örnek oluşturarak `setfileheading(...)` metodunu çağırın veya `python3 runxlrd.py` ile CLI'dan çalıştırın.
Dikkat Edilmesi Gerekenler:
• [Lisans & Telif] Kaynak kodun lisans türü net değildir (Sınırlı Önizleme); ticari projede veya dağıtımda kaynak depo telif koşullarını mutlaka doğrulayın.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
• [Lisans & Telif] Kaynak kodun lisans türü net değildir (Sınırlı Önizleme); ticari projede veya dağıtımda kaynak depo telif koşullarını mutlaka doğrulayın.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
Sınırlı Önizleme Politikası: Bu kodun açık kaynak lisansı doğrulanamadığı için telif kuralları gereği yalnızca kısa önizlemesi gösterilmektedir. Tam kod için
orijinal kaynağa gidin ↗.
#!/usr/bin/env python
# Copyright (c) 2005-2012 Stephen John Machin, Lingfo Pty Ltd
# This script is part of the xlrd package, which is released under a
# BSD-style licence.
from __future__ import print_function
cmd_doc = """
Commands:
2rows Print the contents of first and last row in each sheet
3rows Print the contents of first, second and last row in each sheet
bench Same as "show", but doesn't print -- for profiling
biff_count[1] Print a count of each type of BIFF record in the file
biff_dump[1] Print a dump (char and hex) of the BIFF records in the file
fonts hdr + print a dump of all font objects
hdr Mini-overview of file (no per-sheet information)
hotshot Do a hotshot profile run e.g. ... -f1 hotshot bench bigfile*.xls
labels Dump of sheet.col_label_ranges and ...row... for each sheet
name_dump Dump of each object in book.name_obj_list
names Print brief information for each NAME record
ov Overview of file
profile Like "hotshot", but uses cProfile
show Print the contents of all rows in each sheet
version[0] Print versions of xlrd and Python and exit
xfc Print "XF counts" and cell-type counts -- see code for details
[0] means no file arg
[1] means only one file arg i.e. no glob.glob pattern
"""
options = None
if __name__ == "__main__":
import xlrd
import sys
import time