Rack::Bug Code Climate

• المستودع: http://github.com/brynary/rack-bug

الوصف

يضيف Rack::Bug شريط أدوات تشخيص إلى تطبيقات Rack. عند التمكين، يقوم بحقن div عائم يسمح باستكشاف السجلات، استعلامات قاعدة البيانات، أوقات تقديم القوالب، إلخ.

الميزات

• أمان قائم على كلمة المرور
• أمان قائم على عنوان IP
• ينقسم التجهيز/التقارير في Rack::Bug إلى لوحات.
  • اللوحات في التكوين الافتراضي:
    • Rails Info
    • Timer
    • Request Variables
    • SQL
    • Active Record
    • Cache
    • Templates
    • Log
    • Memory
  • لوحات أخرى مرفقة:
    • Redis
    • Sphinx
  • واجهة برمجة التطبيقات (API) لإضافة لوحاتك الخاصة بسيطة وقوية

بداية سريعة لـ Rails

script/plugin install git://github.com/brynary/rack-bug.git

في ملف config/environments/development.rb، أضف:

config.middleware.use "Rack::Bug",
  :secret_key => "someverylongandveryhardtoguesspreferablyrandomstring"

أضف الإشارة المرجعية إلى متصفحك:

open http://RAILS_APP/__rack_bug__/bookmarklet.html

الاستخدام مع تطبيقات Rack غير Rails

استخدم 'use Rack::Bug' كأي وسيط آخر. راجع SampleApp في مجلد spec/fixtures للحصول على مثال لتطبيق Sinatra.

إذا كنت ترغب في استخدام لوحة المسجل، عرّف الثابت LOGGER الذي هو كائن Logger من روبي أو ActiveSupport::BufferedLogger

تكوين اللوحات المخصصة

حدد مجموعة اللوحات التي تريدها، بالترتيب الذي تريد ظهورها به:

require "rack/bug"

ActionController::Dispatcher.middleware.use Rack::Bug,
  :secret_key => "someverylongandveryhardtoguesspreferablyrandomstring",
  :panel_classes => [
    Rack::Bug::TimerPanel,
    Rack::Bug::RequestVariablesPanel,
    Rack::Bug::RedisPanel,
    Rack::Bug::TemplatesPanel,
    Rack::Bug::LogPanel,
    Rack::Bug::MemoryPanel
  ]

تشغيل Rack::Bug في بيئة الاختبار أو الإنتاج

لقد وجدنا أن Rack::Bug سريع بما يكفي للتشغيل في الإنتاج لجهود استكشاف الأخطاء المحددة.

التكوين

أضف تكوين الوسيط إلى ملف initializer أو ملفات البيئة المناسبة، مع مراعاة بقية هذا القسم.

الأمان

تقييد الوصول لعناوين IP محددة:

require "ipaddr"

ActionController::Dispatcher.middleware.use "Rack::Bug"
  :secret_key => "someverylongandveryhardtoguesspreferablyrandomstring",
  :ip_masks   => [IPAddr.new("2.2.2.2/0")]

تقييد الوصول باستخدام كلمة مرور:

ActionController::Dispatcher.middleware.use "Rack::Bug",
  :secret_key => "someverylongandveryhardtoguesspreferablyrandomstring",
  :password   => "yourpassword"

المؤلفون

• تم الصيانة بواسطة Bryan Helmkamp
• مساهمات من Luke Melia, Joey Aghion, Tim Connor، وغيرهم

شكر وتقدير

الإلهام لـ Rack::Bug يأتي بشكل أساسي من شريط أدوات تصحيح Django. أفكار إضافية من حواشي Rails، وسيط ShowException في Rack، وOink، وRack::Cache

شكر لـ Weplay.com لدعم تطوير Rack::Bug

التطوير

للتطوير، ستحتاج إلى تثبيت الـgems التالية: rspec، rack-test، webrat، sinatra

الترخيص

انظر ملف MIT-LICENSE.txt في هذا الدليل.