rhenter / django-api-client Goto Github PK

Para visualizar o README em português.

The Django API Client is an API response wrapper, which translates Django's native calls when using a view to a particular REST API. Whether using the API client directly in a FBV (Function-based View) or using CBV (Class-based View), this library makes this communication as transparent and easy as possible

Some reasons to use the Django API Client

• If you work with microservices with APIs in multiple locations and want to continue using Django as a WebApp with the same capabilities to render data as if you were using native models
• You want to separate your Django project to let one of them only with the API with DRF and the other as a WebApp with Templates (HTML), CSS, JS instead of using some JS frontend (ReactJS, AngularJS, etc.)
• You want to use a third party API to list, create and change using the django template system

For more information, see our documentation at Github Pages

• Python 3.x
• Django 2.0 or later

You can get Django API Client by using pip:

$ pip install django-api-client

If you want to install it from source, grab the git repository from GitHub and run setup.py:

$ git clone [email protected]:rhenter/django_api_client.git
$ cd django_api_client
$ python setup.py install

To enable django_api_client in your project you need to add it to INSTALLED_APPS in your projects settings.py file:

INSTALLED_APPS = (
    ...
    'django_api_client',
    ...
)

• Also add the settings to access your API to settings.py:

DJANGO_API_CLIENT = {
  'API': [
    {
        'NAME': 'production',
        'BASE_URL': 'https://example.com',
        'ENDPOINTS': [
            '/v1/order/orders',
            '/v1/user/users',
            ...
        ],
        'AUTHENTICATION_ACCESS_TOKEN': 'TOKEN'
    },
    {
        'NAME': 'localhost',
        'BASE_URL': 'http://localhost:8001',
        'ENDPOINTS': [
            '/v1/order/orders',
            '/v1/user/users',
            ...
        ],
        'AUTHENTICATION_ACCESS_TOKEN': 'TOKEN'
    }
  ]
}

• Create a clients.py file in the core folder of your project, if you haven't, created it within your project folder to be simple to be imported from anywhere in the project with the following content:

from django_api_client.client import api_client_factory

api_client = api_client_factory('production')

• Now we are going to list the data using the normal Django template system

Let's imagine which client is located in a folder called clients on project folder (folder containing the settings.py file)

from django_api_client.mixins import ClientAPIListMixin

from pasta_do_projeto.clients import api_client


class OrderListView(ClientAPIListMixin):
    template_name = "template_name.html"        # Path where is your template
    page_title = 'Orders'                       # Generates a context variable to use in your template
    page_base_url = reverse_lazy('order:list')  # Information used in pagination, and the search
    paginate_by = 50                            # Number of items to generate the pagination
    client_method = api_client.order.orders.list

In your template you can use the forms and pagination snippets. E.g:

{% content %}

...
<div class="card card-navy card-outline">
  <div class="card-header">
    <h3 class="card-title">
      {% trans "Order List" %} : <small class="text-muted">{{ paginator.count }}</small>
    </h3>
    {% include "includes/form_paginate_by.html" with paginate_by=paginate_by range_pagination=range_pagination %}
    {% include "includes/form_search.html" with search=search %}
  </div>
  <div class="card-body table-responsive p-0">
    <table class="table table-bordered table-hover table-striped" id="list-content">
      <thead>
      <tr>
        <th>{% trans 'Code' %}</th>
        <th>{% trans 'Customer' %}</th>
        <th>{% trans 'Product' %}</th>
      </tr>
      </thead>
      <tbody class="text-gray">
      {% for order in object_list %}
        <tr>
          <td><a href="{% url 'order:detail' pk=order.id %}" </a>
          </td>
          <td>{{ order.id }}</td>
          <td>{{ order.customer.name|title }}</td>
          <td>{{ order.product.name|title }}</td>
        </tr>
        {% endfor %}
      {% endif %}
      </tbody>
    </table>
  </div>
  <div class="card-footer">
    {% if object_list|length != 0 or not object_list %}
      {% include "includes/list_paginator.html" with page_obj=page_obj paginator=paginator %}
    {% endif %}
  </div>
</div>

endpoint name: order
methods:
     - list   # GET: List
     - get    # GET: Detail of a resource using an identifier
     - create # POST: Create a resource record
     - update # PUT / PATCH: Fully or partially updates a resource using an identifier
     - delete # DELETE: delete a record in a resource using an identifier

Check out the latest django-api-client documentation at Github Pages

Please send pull requests, very much appreciated.

1. Fork the repository on GitHub.
2. Make a branch off of master and commit your changes to it.
3. Install requirements. pip install -r requirements-dev.txt
4. Install pre-commit. pre-commit install
5. Run the tests with cd test-django-project; py.test -vv -s
6. Create a Pull Request with your contribution