************************************
RPC
************************************

.. note:: Aktualnie jesteśmy w trakcie migracji na nowy system rpc. Po zakończeniu migracji pojawią się nowe możliwości i stany. Sama forma pozostanie bez zmian.

Remote proxy call jest to narzędzie które ma służyć do wykonywania zdalnych poleceń na jakiś urządzeniach. Polecenie
można wykonywać zarówno na proxy jak i na settoboxach. Odpowiedź rpc jest zawsze taka sama i posiada strukturę:

``{'status': ... , 'result': ..., 'task_id': ...}``

Dostępne statusy
================

 * PENDING - oczekuje na wykonanie lub jest w trakcie wykonania
 * ENDING* - zadanie jest w trakcie zakończania
 * RECEIVED* - zadanie zakolejkowane
 * STARTED* - zadanie jest wykonywane
 * SUCCESS - zadanie zakończyło się sukcesem
 * FAILURE - zadanie zakończyło się porażką
 * REVOKED* - system odmówił wykonania zadania (zadanie zadane wielokrotnie)
 * RETRY* - zadanie próbuje wykonać się ponownie

 zadania oznaczone \* nie sa używane przez obecny silnik rpc


Dostępne są metody
===================


.. automodule:: nieczesto.api.v2.rpc