YAML
SQL sorguları
Dosya işlemleri
Form işlemleri
Veri dönüştürme
Yapılandırma dosyaları
Lisans: MIT
Hata Bildirimi (Bug Report) Sorun Şablonu
Orijinal Kod Adı:
YAML — bug_report.yml
Kullanıcıların geliştirici ekibe düzenli ortam bilgisi, yeniden üretme adımları ve beklenen sonuçla hata bildirmesini sağlar. Dosya ölçeği: 65 satır (~1.9 KB). Kaynak depo: knowledgestack/excel-parser.
💡 Püf Noktaları:
• `bug_report.yml` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• YAML kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
• Üçüncü parti modüllerin bilinen zafiyet ve sürüm uyumluluğunu düzenli olarak denetleyip değişiklikleri sürüm geçmişinde izleyin.
🛠️ Uygulama Tarifi:
1. `bug_report.yml` dosyasını projenin ilgili yapılandırma veya dokümantasyon dizinine ekleyin.
2. Örnek alanları (proje adı, sürüm, ortam yolları) kendi sisteminize göre güncelleyin.
3. Uygulama veya yardımcı aracın dosyayı hatasız ayrıştırdığını doğrulayıp sürüm kontrolüne dahil edin.
💡 Püf Noktaları:
• `bug_report.yml` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• YAML kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
• Üçüncü parti modüllerin bilinen zafiyet ve sürüm uyumluluğunu düzenli olarak denetleyip değişiklikleri sürüm geçmişinde izleyin.
🛠️ Uygulama Tarifi:
1. `bug_report.yml` dosyasını projenin ilgili yapılandırma veya dokümantasyon dizinine ekleyin.
2. Örnek alanları (proje adı, sürüm, ortam yolları) kendi sisteminize göre güncelleyin.
3. Uygulama veya yardımcı aracın dosyayı hatasız ayrıştırdığını doğrulayıp sürüm kontrolüne dahil edin.
Dikkat Edilmesi Gerekenler:
• [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.
• [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.
name: "🐞 Bug report"
description: Something is wrong with the parser or an existing feature
title: "[bug] "
labels: ["bug", "needs-triage"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to file a bug. Filling this in carefully saves a round-trip.
- type: textarea
id: what
attributes:
label: What happened?
description: What were you trying to do, and what did the parser produce instead?
validations:
required: true
- type: textarea
id: repro
attributes:
label: Minimal reproduction
description: |
Paste the smallest code snippet that reproduces the bug. If possible, attach the
`.xlsx` file or a generator that produces it. Files under ~100 KB can be attached
directly to the issue; larger files should be linked.
render: python
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
validations:
required: true
- type: input
id: version
attributes:
label: ks-xlsx-parser version
placeholder: "0.1.1"
validations:
required: true
- type: input
id: python
attributes:
label: Python version
placeholder: "3.12.0"
validations:
required: true
- type: input
id: os
attributes:
label: Operating system
placeholder: "macOS 14.4 / Ubuntu 22.04 / Windows 11"
- type: textarea
id: traceback
attributes:
label: Traceback (if any)
render: shell
- type: checkboxes
id: benchmark
attributes:
label: Benchmark check
description: Did your file surface in `make bench-robust` (SpreadsheetBench)?
options:
- label: "I ran `make bench-robust` and my file failed (attach the row from results.csv if you can)."
- label: "The file is from outside SpreadsheetBench; I can attach a minimal reproducer."
Tespit Edilen SQL Sorguları
with the parser or an existing feature