dokumentacja gae-boilerplate

Question

W moich poszukiwaniach dobrego społecznego zestawu do logowania do App Engine, dajemy gae-boilerplate spróbować. Ale uważam, że nie ma żadnej dokumentacji oprócz pliku readme, który moim zdaniem w zupełności nie wystarcza.

Mam wiele pytań, a wśród nich:

• Jeżeli boilerplate być używane jako biblioteka lub pobrać i modyfikować w zależności od potrzeb?
• W jaki sposób należy zaktualizować tabelę podstawową?
• Co robi każdy model?
• Gdzie powinny znajdować się moje szablony?
• Czy powinienem mieć inny plik tras?
• Czy powinienem wyprowadzić moje Handlery z BaseHandler?
• Co zasadniczo powinienem zaimplementować na moich stronach? Na przykład dowiedziałem się, że muszę dołączyć csrf_token do wszystkich żądań POST. Byłoby miło wiedzieć o tym wcześniej i wiele innych rzeczy, które muszę poznać po drodze, i które wdrażam bez pewności, czy mam to robić.
• I trochę więcej ...

Moim największym problemem jest to, że logowanie społeczna nie działa, i czuję, że to boilerplate jest wielki potwór, z którym nie wiem od czego zacząć. Co gorsza, trudno jest debugować społeczną autoryzację z dowolnej maszyny, która nie jest produkcyjna. To dlatego rozpaczliwie szukam jakichś dokumentów.

Nie znalazłem niczego w SO, i myślę, że w mojej sytuacji musi być więcej osób. Tak więc wszelkie wskazówki do dokumentacji, które mogłyby pomóc w lepszym zrozumieniu gae-boilerplate, byłyby bardzo mile widziane.

EDYCJA: Przełączyłem się na gae-boilerplate w witrynie, którą wcześniej pracowałem. Być może większość moich problemów pochodzi ze sposobu, w jaki próbowałem zintegrować GA-boilerplate z moją istniejącą witryną. W rezultacie starałem się traktować gala-boilerplate jako bibliotekę i utrzymywać własne szablony, procedury obsługi, pliki statyczne i tym podobne.

Dziękuję wam!

EDYCJA 2: Po wypróbowaniu innych opcji, muszę powiedzieć, że jestem bardzo zadowolony z gae-simpleauth. Działa bardzo dobrze, a wsparcie Alexa jest wspaniałe.

Answer 1

Postaram się odpowiedzieć na większość pytań poniżej:

• Jeżeli boilerplate być używane jako biblioteka lub pobrać i modyfikować w zależności od potrzeb?
  • Możesz modyfikować według potrzeb zgodnie z własnymi wymaganiami.
• W jaki sposób należy zaktualizować arkusz wzorcowy?
  • Co masz na myśli?
• Co robi każdy model?
  • User i SocialUser są dość wymowne. LogVisit i LogEmail są używane do celów audytu.
• Gdzie powinny znajdować się moje szablony?
  • W katalogu szablonów
• powinienem mieć inny plik trasy?
  • Nie, możesz użyć istniejącego pliku dla wszystkich swoich tras.
• Czy powinienem wyprowadzić moje manipulatory od BaseHandler?
  • To nie jest obowiązkowe, ale polecam to zrobić. BaseHandler jest bardzo przydatny i zapewnia wiele dobrych rzeczy.
• Jakie rzeczy powinienem zastosować na moich stronach?
  • Co dokładnie masz na myśli?

Ogólnie, można użyć gae-boilerplate jako odniesienie na szczycie której będzie zbudowany swój własny projekt. Przestudiuj kod krok po kroku, spróbuj ustalić, jaki jest cel każdego używanego pliku i biblioteki oraz jak działają razem. W ten sposób zyskasz dobrą znajomość wielu rzeczy, takich jak jinja szablon, oauth2, itp.

Mam nadzieję, że to pomoże.