Базовая версия с формой для приема платежей

Author: kmike

CHANGES.txt

@@ -0,0 +1,6 @@
+История изменений
+=================
+
+0.1.0 (2010-02-13)
+------------------
+Первая версия

LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2010 Mikhail Korobov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

MANIFEST.in

@@ -0,0 +1,3 @@
+include *.txt
+include *.rst
+recursive-include docs *.txt

README.rst

@@ -0,0 +1,53 @@
+================
+django-robokassa
+================
+
+django-robokassa - это приложение для интеграции платежной системы ROBOKASSA в
+проекты на Django.
+
+До использования следует ознакомиться с официальной документацией
+ROBOKASSA (http://robokassa.ru/Doc/Ru/Interface.aspx). Приложение реализует
+протокол взаимодействия, описанный в этом документе.
+
+Установка
+=========
+
+Как обычно::
+
+    $ pip install django-robokassa
+
+или ::
+
+    $ easy_install django-robokassa
+
+или ::
+
+    $ hg clone http://bitbucket.org/kmike/django-robokassa/
+    $ cd django-robokassa
+    $ python setup.py install
+
+
+Потом следует добавить 'robokassa' в INSTALLED_APPS и выполнить ::
+
+    $ python manage.py syncdb
+
+Если используется South, то вместо syncdb нужно сделать ::
+
+    $ python manage.py migrate
+
+
+Настройка
+=========
+
+В settings.py нужно указать следующие настройки:
+
+* ROBOKASSA_LOGIN - логин
+* ROBOKASSA_PASSWORD - пароль
+
+Необязательный параметар: ASSIST_TEST_MODE - включен ли тестовый режим.
+По умолчанию False (т.е. включен боевой режим).
+
+Использование
+=============
+
+TODO: написать

robokassa/__init__.py

@@ -0,0 +1,10 @@
+#coding: utf-8
+
+from django.conf import settings
+
+# обязательные параметры - реквизиты магазина
+LOGIN = settings.ROBOKASSA_LOGIN
+PASSWORD1 = settings.ROBOKASSA_PASSWORD1
+PASSWORD2 = getattr(settings, 'ROBOKASSA_PASSWORD2', None)
+
+

robokassa/conf.py

@@ -0,0 +1,66 @@
+#coding: utf-8
+
+from hashlib import md5
+from urllib import urlencode
+from django import forms
+from robokassa.conf import LOGIN, PASSWORD1
+
+class RobokassaForm(forms.Form):
+
+    # login магазина в обменном пункте
+    MrchLogin = forms.CharField(max_length=20, initial = LOGIN)
+
+    # требуемая к получению сумма
+    OutSum = forms.DecimalField(min_value=0, max_digits=20, decimal_places=2, required=False)
+
+    # номер счета в магазине (должен быть уникальным для магазина)
+    InvId = forms.IntegerField(min_value=0, required=False)
+
+    # описание покупки
+    Desc = forms.CharField(max_length=100, required=False)
+
+    # контрольная сумма MD5
+    SignatureValue = forms.CharField(max_length=32)
+
+    # предлагаемая валюта платежа
+    IncCurrLabel = forms.CharField(max_length = 10, required=False)
+
+    # e-mail пользователя
+    Email = forms.CharField(max_length=100, required=False)
+
+    # язык общения с клиентом (en или ru)
+    Culture = forms.CharField(max_length=2, required=False)
+
+    # Параметр с URL'ом, на который форма должны быть отправлена.
+    # Может пригодиться для использования в шаблоне.
+    target = u'https://merchant.roboxchange.com/Index.aspx'
+
+    def get_redirect_url(self):
+        """ Получить URL с GET-параметрами, соответствующими значениям полей в
+        форме. Редирект на адрес, возвращаемый этим методом, эквивалентен
+        ручной отправке формы методом GET.
+        """
+        def _initial(name, field):
+            val = self.initial.get(name, field.initial)
+            if not val:
+                return val
+            return unicode(val).encode('1251')
+
+        fields = [(name, _initial(name, field))
+                  for name, field in self.fields.items()
+                  if _initial(name, field)
+                 ]
+        params = urlencode(fields)
+        return self.target+'?'+params
+
+    def __init__(self, *args, **kwargs):
+        super(RobokassaForm, self).__init__(*args, **kwargs)
+        for field in self.fields:
+            self.fields[field].widget = forms.HiddenInput()
+        self.fields['SignatureValue'].initial = self._get_signature()
+
+    def _get_signature(self):
+        _val = lambda name: self.fields[name].initial
+        params = ':'.join(filter(None, [_val('MrchLogin'), _val('OutSum'), _val('InvId'), PASSWORD1]))
+        return md5(params).hexdigest().upper()
+

robokassa/forms.py

@@ -0,0 +1 @@
+#coding: utf-8

robokassa/models.py

@@ -0,0 +1,23 @@
+#coding: utf-8
+
+from unittest import TestCase
+
+from robokassa.forms import RobokassaForm
+
+class RobokassaFormTest(TestCase):
+
+    def setUp(self):
+        self.form = RobokassaForm(initial = {
+                   'OutSum': 100.00,
+                   'InvId': 58,
+                   'Desc' : u'Холодильник "Бирюса"',
+                   'Email' : '[email protected]'
+               })
+
+    def testSignature(self):
+        self.assertEqual(len(self.form.fields['SignatureValue'].initial), 32)
+        self.assertEqual(self.form.fields['SignatureValue'].initial, 'FBA6DB00B521BB848CD44D0F01D7BFC8')
+
+    def testRedirectUrl(self):
+        url = "https://merchant.roboxchange.com/Index.aspx?MrchLogin=test_login&OutSum=100.0&InvId=58&Desc=%D5%EE%EB%EE%E4%E8%EB%FC%ED%E8%EA+%22%C1%E8%F0%FE%F1%E0%22&SignatureValue=FBA6DB00B521BB848CD44D0F01D7BFC8&Email=vasia%40example.com"
+        self.assertEqual(self.form.get_redirect_url(), url)

robokassa/tests.py

@@ -0,0 +1,16 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from django.conf import settings
+from django.core.management import call_command
+
+settings.configure(
+    INSTALLED_APPS=('robokassa',),
+    DATABASE_ENGINE = 'sqlite3',
+
+    ROBOKASSA_LOGIN = 'test_login',
+    ROBOKASSA_PASSWORD1 = 'test_password',
+)
+
+if __name__ == "__main__":
+    call_command('test', 'robokassa')

runtests.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+#coding: utf-8
+from distutils.core import setup
+
+import sys
+reload(sys).setdefaultencoding("UTF-8")
+
+setup(
+    name='django-robokassa',
+    version='0.1.0',
+    author='Mikhail Korobov',
+    author_email='[email protected]',
+
+    packages=['robokassa', 'robokassa.migrations'],
+
+    url='http://bitbucket.org/kmike/django-robokassa/',
+    download_url = 'http://bitbucket.org/kmike/django-robokassa/get/tip.zip',
+    license = 'MIT license',
+    description = u'Приложение для интеграции платежной системы ROBOKASSA в проекты на Django.'.encode('utf8'),
+    long_description = open('README.rst').read().decode('utf8'),
+
+    classifiers=(
+        'Development Status :: 3 - Alpha',
+        'Environment :: Web Environment',
+        'Framework :: Django',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: MIT License',
+        'Programming Language :: Python',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+        'Natural Language :: Russian',
+    ),
+)