Metadata-Version: 1.1
Name: django_hipster_api
Version: 1.6.8
Summary: wrapper django rest framework
Home-page: https://github.com/RustoriaRu/hipster_api
Author: vir-mir
Author-email: virmir49@gmail.com
License: MIT
Description: # hipster_api
        wrapper django rest framework
        
        ## Применение
        Для удобства использования restapi в вашем проекте
        
        Подключение
        ```python
        INSTALLED_APPS = (
        ...
        'rest_framework',
        'hipster_api',
        )
        TEMPLATE_DIRS = (
            os.path.join(os.path.dirname(__file__), '..', 'templates').replace('\\', '/'),
        )
        ```
        
        
        ## Пример views
        ```python
        from hipster_api import fields as hfields
        from hipster_api.views import HView
        
        
        class QuestsView(HView):
            """
            Работа с постами
            """
        
            class Fields(object):
                fields = hfields.FieldsListResponse(verbose_name=u'Список полей через запятую', methods=['get'])
                offset = hfields.IntegerLarger(default=0, larger=0, glt=True, methods=['get'])
                limit = hfields.IntegerLarger(default=20, larger=0, methods=['get'])
                active = hfields.IntegerList(default=u'0,1', methods=['get'])
                
                name = hfields.String(verbose_name=u'Название поста', default=u'', methods=['put'])
                description = hfields.String(verbose_name=u'Название поста', default=u'', methods=['put'])
        
            def get(self, request, format=None):
                """
                Получение постов
                :public:
                """
                fields = ['id'] + self.objects.fields
                posts = Post.objects.values(*fields).filter(active__in=self.objects.active)[self.objects.offset:self.objects.limit]
                
                return Response(quests)
                
            def put(self, request, format=None):
                """
                Создание поста
                :private только админа:
                """
                
                Post(name=self.objects.name, description=self.objects.description).save()
                return Response(status=202)
                
        ```
        
        ### запросы
        ```
        GET /api/v1/posts.json?fields=name
        GET /api/v1/posts.json?fields=name,description
        
        PUT /api/v1/posts.json
        name = 'тест'
        description = 'тес тест'
        
        ```
        
        ## Собираем документацию 
        `python manage.py hipster_api_doc`
        
        ### вывод в шаблоне 
        
        ```html
        {% block container %}
            <div class="row">
                <div class="col-md-9" role="main">
                    {% if file_name %}
                        {% include file_name %}
                    {% endif %}
                </div>
                <div class="col-md-3" role="complementary">
                    <nav class="affix">
                        <ul class="nav">
                            {% include 'docs/menu2.html' %}
                        </ul>
        
                    </nav>
                </div>
            </div>
        {% endblock %}
        ```
        
        `file_name` - должен путь к доке `docs/files/...`
        
Keywords: django rest framework
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries :: Python Modules
