Finish 0.3.29

.gitignore

@@ -1,2 +1,3 @@
 build
-*~
+*~
+venv

docs/source/development/install.rst

@@ -56,7 +56,7 @@
 Опциональные репозитории
 ************************
 
-Часть проектов, родившихся в рамках разработки, доросли до стабильной версии и хостятся на `pypi.org`_.
+Часть проектов, родившихся в рамках разработки, доросли до стабильной версии и хостятся на `pypi.org <http://pypi.org>`_.
 
 Если необходимо делать правки в них (например, добавить новую функциональность), их следует клонировать по аналогии с обязательными репозиториями и вручную поставить из исходников в виртуальной машине.
 
@@ -110,7 +110,7 @@
 Перед запуском рабочих, необходимо запустить supervisor
 
 .. code-block:: bash
-  
+
    sudo su
    systemctl start supervisor
 

docs/source/external_api/methods.rst

@@ -280,7 +280,6 @@
       "is_own": true|false,          // информация о собственном герое или о чужом
       "is_old": true|false,          // информация устаревшая или нет
       "hero": <hero_info>,           // информация о герое
-      "in_pvp_queue": true|false,    // находится ли герой в очереди на арену
       "energy": <целое число>|null   // энергия игрока
     }
 
@@ -487,8 +486,6 @@
 :адрес: /game/abilities/<идентификатор способности>/api/use
 :http-метод: POST
 :версии: 1.0
-:параметры:
-    * GET: battle — идентификатор pvp сражения, если способность касается операций с pvp сражением
 :ошибки:
     * game.abilities.use.no_enough_energy — для использования способности не хватает энергии
 
@@ -764,7 +761,6 @@
              "position": {"x": <целое число>,       // позиция
                           "y": <целое число>},      //
              "type": <целое число>,                 // тип, значения перечислены на странице API
-             "integrity": <дробное число>,          // целостность здания от 0.0 до 1.0
              "created_at_turn": <целое число>,      // номер хода на котором создано
          } | null,
          "personality": {                           // характер
@@ -821,11 +817,12 @@
         "id": <целое число>,        // идентификатор игрока
         "name": "строка",           // ник
         "hero": {                   // краткая информация о герое
-          "id": <целое число>,      // идентификатор
-          "name": "строка",         // имя
-          "race": <целое число>,    // раса
-          "gender": <целое число>,  // пол
-          "level": <целое число> }, // уровень
+          "id": <целое число>,                     // идентификатор
+          "name": "строка",                        // имя
+          "race": <целое число>,                   // раса
+          "gender": <целое число>,                 // пол
+          "power": [<целое число>, <целое число>], // физическая сила, магическая сила
+          "level": <целое число> },                // уровень
         "clan": <целое число>|null  // идентификатор клана
       },
       ...
@@ -893,7 +890,7 @@
       "chronicle": <chronicle_info>,       // последние записи в летописи
       "job": <job_info>,                   // информация о проекте
       "accounts": <accounts_info>,         // краткая дополнительная информация об игроках, связанных с Мастером
-      "clans": <clans_info>               // краткая дополнительная информация о кланах, связанных с Мастером
+      "clans": <clans_info>                // краткая дополнительная информация о кланах, связанных с Мастером
     }
 
 .. _external_api__region:
@@ -987,3 +984,106 @@
     {
         "turns": [<целое>, ...] // номер хода, для которого есть карта
     }
+
+
+PvP: Отправить героя на арену
+----------------------------------
+
+Отправить заявку на бой на арене.
+
+:адрес: /game/pvp/api/api-call-to-arena
+:http-метод: POST
+:версии: 0.1
+:параметры: нет
+:ошибки: нет
+
+Формат данных в ответе.
+
+.. code-block:: javascript
+
+    {
+        "info": <pvp_info> // актуальная информация о pvp боях и вызовах
+    }
+
+    <pvp_info> = {"accounts": <accounts_info>,         // краткая дополнительная информация об игроках, относящихся к pvp
+                  "clans": <clans_info>                // краткая дополнительная информация о кланах, относящихся к pvp
+                  "active_arena_battles": <целое>,     // количество активных боёв между игроками
+                  "active_bot_battles": <целое>,       // количество активных боёв с ботами
+                  "arena_battle_requests": [<arena_battle_request>, ...]} // список активных вызовов на арену
+
+    <arena_battle_request> = {"id": <целое>,              // идентификатор вызова
+                              "initiator_id": <целое>,    // идентификатор игрока, отправившего вызов
+                              "matchmaker_type": <целое>, // тип боя, см. в списке типов
+                              "created_at": <timestamp>,  // дата создания вызова
+                              "updated_at": <timestamp>}  // дата обновления вызова
+
+
+PvP: Отозвать героя с арены
+----------------------------------
+
+Отозвать заявку на бой на арене.
+
+:адрес: /game/pvp/api/api-leave-arena
+:http-метод: POST
+:версии: 0.1
+:параметры: нет
+:ошибки: нет
+
+Формат данных в ответе.
+
+.. code-block:: javascript
+
+    {
+        "info": <pvp_info> // актуальная информация о pvp боях и вызовах
+    }
+
+
+PvP: Принять вызов другого игрока
+----------------------------------
+
+Принять вызов другого игрока.
+
+:адрес: /game/pvp/api/api-accept-arena-battle
+:http-метод: POST
+:версии: 0.1
+:параметры:
+    - GET: battle_request_id — идентификатор вызова
+:ошибки:
+    * pvp.accept_arena_battle.no_battle_request_found — вызова не найден
+    * pvp.accept_arena_battle.already_in_battle — вы или противник уже сражаетесь на арене
+
+Метод является «неблокирующей операцией» (см. документацию), формат ответа соответствует ответу для всех «неблокирующих операций».
+
+
+PvP: Начать бой с ботом
+----------------------------------
+
+Начинает бой с ботом, если есть свбодные боты.
+
+:адрес: /game/pvp/api/api-create-arena-bot-battle
+:http-метод: POST
+:версии: 0.1
+:параметры: нет
+:ошибки:
+    * pvp.create_arena_bot_battle.no_free_bots — нет свободных ботов, надо повторить попытку позже
+
+Метод является «неблокирующей операцией» (см. документацию), формат ответа соответствует ответу для всех «неблокирующих операций».
+
+PvP: получить информацию о pvp боях и вызовах
+---------------------------------------------
+
+Возвращает информацию о текущих вызовах и боях.
+
+:адрес: /game/pvp/api/api-info
+:http-метод: GET
+:версии: 0.1
+:параметры: нет
+:ошибки: нет
+
+Формат данных в ответе.
+
+.. code-block:: javascript
+
+    {
+        "info": <pvp_info> // актуальная информация о pvp боях и вызовах
+    }