Założenia

[rysson]

Założenia

Ogólne

• budowa pudełkowa (czyli modułowa) – zbiór łatwo używalnych części
• wspólny kodu – robimy małe moduły zamiast kopiowania czy ręcznie tego samego
• używamy dostępnych bibliotek, zamiast ręcznie robić to co już jest (jak np. zamiana &ocute;)
• działamy na Kodi 18 i 19 czyli w Py2 i Py3

Technicznie

• z powodu Py2/3 piszemy jeden kod (przynajmniej w przytłaczającej większości)
• używamy bibliotek do ujednolicania jak future, six, i dodatków jak kodi.six
• w Py2 posiłkujemy się bogatym zestawem z __future__ żeby nie walczyć z oczywistościami i kod mieć podobny do Py3, np.:

  # -*- coding: utf-8 -*-
  from __future__ import absolute_import, division, unicode_literals, print_function

• czytamy dokumentację Kodi a opis API szczególnie !
• wszędzie gdzie się da używamy unicode (str po from __future__ import unicode_literals), a także repoonse.text zamiast response.content z requests

Luźne uwagi

• zaprzyjaźniamy się z klasami
• przepraszamy się z dekoratorami
• kod w konwencji *NIX (sam \n)

[rysson]

Wstępny plan pierwszych kroków

Etap „0” – zdobywanie wiedzy

Etap „1” Zarządzanie linkami. Niestety Kodi postanowiło (a właściwie to Xbmc, albo jak to mój syn mawiał HWTS bo czytał to tak: хвмс) zachować ułomności serwisów webowych, czyli addon jest µ-serwerem, który dostaje bezstanowe żądania. Potrzebujemy sprawnej metody przekazywania w tych linkach tego co potrzeba. Być może inaczej stan będziemy odtwarzać.

1.1. Budowanie i parsowanie URL-i Najprostszy sposób przenoszenia stanu między wywołaniami. Tak, aby ręcznie nie (de)kodować linków, tekstów, słowników czy całych JSON-ów.

1.2. URL routing Każdy µ-serwis webowy (a jak wiemy na taki niestety sili się Kodi) ma rozdzielacz adresów, czyli wołanie funkcji (bądź obiektów). Chodzi o to aby w prosty sposób opisać co ma być zawołane w przypadku danego zlecenia, które jak wiadomo przychodzi w URL. Powinno być półautomatyczne. Jak się dodaje funkcję np. search (do wskazaną albo domyślną lokalizację w drzewku) to nie powinno być dodatkowego kodu do rozpoznawania, czy to właśnie szukanie zostało wywołane, czy dodawanie czy usuwanie elementów z listy szukania.