Graphite 1.1 - Working on Graphite-web

ग्रेफाइट-वेब पर काम करना




graphite

ग्रेफाइट-वेब पर काम करना

ग्रेफाइट-वेब मुद्दों या पुल अनुरोधों के रूप में GitHub पर योगदान स्वीकार करता है। यदि आप पायथन के साथ सहज हैं, तो यहां बताया गया है कि शुरुआत कैसे करें।

सबसे पहले, यह ध्यान रखें कि ग्रेफाइट-वेब पायथन संस्करण 2.6 से 2.7 और Django संस्करण 1.4 और उससे अधिक का समर्थन करता है

विकास का माहौल बनाना

अनुशंसित वर्कफ़्लो को एक दूसरे के बीच परियोजनाओं को अलग करने के लिए virtualenv / virtualenvwrapper का उपयोग करना है। यह दस्तावेज़ virtualenv को सबसे कम सामान्य भाजक के रूप में उपयोग करता है।

अपने ग्रेफाइट-वेब रिपॉजिटरी के मूल में एक virtualenv बनाएँ:

virtualenv env
source env/bin/activate

आवश्यक निर्भरताएँ स्थापित करें:

pip install -r requirements.txt

डिफ़ॉल्ट संग्रहण निर्देशिका बनाएं:

mkdir -p storage/{ceres,whisper,log/webapp}

तब आपको ग्रेफाइट विकास सर्वर चलाने में सक्षम होना चाहिए:

cd webapp
./manage.py runserver

परीक्षण चल रहा है

अपने virtualenv के पायथन और Django संस्करणों के लिए परीक्षण चलाने के लिए:

cd webapp
./manage.py test --settings=tests.settings

यदि आप पायथन और Django संस्करणों के सभी संयोजनों के लिए परीक्षण चलाना चाहते हैं, तो आप tox उपकरण का उपयोग कर सकते हैं।

pip install tox
tox

यह tox.ini फ़ाइल में घोषित सभी कॉन्फ़िगरेशन के लिए रिपॉजिटरी की जड़ में परीक्षण tox.ini

आप चलाकर उपलब्ध सभी विन्यास देख सकते हैं:

tox -l

आप इसके साथ एकल कॉन्फ़िगरेशन चला सकते हैं:

tox -e <configuration>

ध्यान दें कि आपको अपने सिस्टम पर संबंधित अजगर संस्करण की आवश्यकता है। अधिकांश सिस्टम केवल एक या दो अलग-अलग अजगर संस्करण प्रदान करते हैं, यह अन्य संस्करणों को स्थापित करने के लिए आपके ऊपर है।

लेखन परीक्षण

नई सुविधाओं या बगफिक्स के लिए अनुरोधों को यह दिखाने के लिए परीक्षणों के साथ आना चाहिए कि आपकी सुविधा या वास्तव में काम करती है। परीक्षण webapp/tests निर्देशिका में स्थित हैं।

एक नया परीक्षण लिखते समय, मौजूदा फ़ाइलों को देखें कि क्या आपका परीक्षण एक में फिट होगा। अन्यथा बस एक नई फ़ाइल बनाएं जिसका नाम test_<whatever>.py निम्नलिखित सामग्री के साथ test_<whatever>.py :

from django.test import TestCase

class WhateverTest(TestCase):
    def test_something(self):
        self.assertEqual(1, 2 / 2)

आप django.test.TestCase बारे में अधिक जानकारी के लिए Django के परीक्षण डॉक्स को पढ़ सकते हैं और Django के साथ परीक्षण कैसे काम करते हैं।