Ctrl+K

Упражнение №5

Упражнение №5#

За това упражнение можем да дадем точки по два различни начина:

  • ако сте започнали или искате да започнете да работите по проекта си (стига да имате одобрена тема), може да получите 4~6 точки, ако направите начално разделение по пакети и модули, и покажете, че работите с venv и requirements.txt файл;

  • в противен случай имаме подготвена специална задачка за максимум 6 точки:

Накратко за задачата#

Направете конзолно приложение, което да извежда trending филми и сериали, взимайки информацията от The Movie Database API.

Условие#

В текущата директория се намира файлът main.py, който трябва да бъде направен да може да получава аргументи от командния ред, и при изпълнение да извежда на стандартния изход резултата от изпълнението. Точните изисквания за аргументите и изхода са описани по-долу.

Добавяйте каквито пакети и модули сметете за необходимо към текущата директория - това е основният фокус на упражнението.

Работете във virtual envronment и създайте requirements.txt файл с използваните точни версии на външните библиоетки.

Аргументи#

За взимане на аргументите от командния ред, може да ползвате sys.argv от вградената библиотека sys. Това е лист от str-ове, като първият елемент е името на изпълнимия файл, а останалите са аргументите, подадени от командния ред, които в тази задача трябва да бъдат:

  1. tv или movie (дали ще показваме trending сериали или филми)

  2. day или week (дали ще показваме trending за деня или за седмицата)

  3. csv или json (дали ще извеждаме резултата в CSV или JSON формат)

В идеалния случай трябва да има валидация на аргументите, но това не е задължително за получаване на точките за функционалност, поради обема на задачата.

API#

  1. За да получите API read access token, пишете ни в дискорд да ви го пратим (другият вариант е да минете сами през процедурата за регистрация и създаване на ваш api key).

  2. Ползвайте GET trending ендпойнтите (за “tv” и за “movie”). Предайте “day” или “week” в заявките, спрямо това каква е стойността на втория аргумент. Не заявявайте повече от 1 page в request-ите.

  3. Сайтът им освен да документира добре какво се очаква от request-ите и response-ите, също така и е доста интерактивен, позволяйки да си тествате на място заявките.

Изход#

  1. Изходът на програмата да съдържа за всеки филм/сериал единствено:

    1. title (str): неговото име

    2. rating (float): неговата средна потребителска оценка

  2. Изходът да бъде сортиран по rating в низходящ ред.

  3. Изходът да бъде във формат CSV или JSON, спрямо това каква е стойността на третия аргумент.

    • За конвертиране на dict или list до JSON str, можете да ползвате json.dumps(...) от вградената библиотека json.

  4. Примерни изходи и в двата формата може да разгледате в example_output/.

Бонус#

Бонус точка ще дадем за изпълняване на заявките в асинхронен контекст.

  • ако ползвате просто requests, ще трябва да wrap-нете заявката в нещо, позволяващо асинхронно изпълнение. Това може да бъде run_in_executor от asyncio (изпълнен върху резултата от asyncio.get_event_loop() например) или пък чрез начините, които multiprocessing ни предоставя.

  • чувствайте се свободни да разучите и използвате някоя друга библиотека за HTTP заявки, която поддържа асинхронност. Препоръчваме асинхронните контекстни мениджъри на aiohttp.

И в двата случая няма да очакваме модификации от повече от няколко реда код.

Примери#

Команда:

python main.py tv day csv

Изход:

title,rating
South Sea Tomb,8.8
One Piece,8.728
World War II: From the Frontlines,8.7
Attack on Titan,8.668
Jujutsu Kaisen,8.568
My Demon,8.567
The Walking Dead: Daryl Dixon,8.451
Game of Thrones,8.442
High Tides,8.4
Sweet Home,8.396
Fargo,8.305
Monarch: Legacy of Monsters,8.198
Loki,8.184
Blood Coast,7.905
Doctor Who,7.9
Slow Horses,7.79
Doctor Who,7.465
My Life with the Walter Boys,6.9
Obliterated,6.55
Squid Game: The Challenge,6.25

Команда:

python main.py movie week json

Изход:

[{"title": "Oppenheimer", "rating": 8.14}, {"title": "Five Nights at Freddy's", "rating": 7.844}, {"title": "Killers of the Flower Moon", "rating": 7.716}, {"title": "Mission: Impossible - Dead Reckoning Part One", "rating": 7.592}, {"title": "Leo", "rating": 7.533}, {"title": "The Hunger Games: The Ballad of Songbirds & Snakes", "rating": 7.295}, {"title": "Trolls Band Together", "rating": 7.2}, {"title": "Barbie", "rating": 7.179}, {"title": "The Creator", "rating": 7.131}, {"title": "Wonka", "rating": 7.0}, {"title": "Leave the World Behind", "rating": 6.935}, {"title": "Indiana Jones and the Dial of Destiny", "rating": 6.678}, {"title": "The Killer", "rating": 6.655}, {"title": "Wish", "rating": 6.625}, {"title": "May December", "rating": 6.613}, {"title": "The Marvels", "rating": 6.555}, {"title": "Freelance", "rating": 6.434}, {"title": "Napoleon", "rating": 6.433}, {"title": "Family Switch", "rating": 6.381}, {"title": "Candy Cane Lane", "rating": 6.339}]

Оценяване (code review)#

  • 3 т. - за смислено разделяне на кода в допълнителни модули и пакети

  • 1 т. - за коректна и работеща функционалност

  • 1 т. - за правилен requirements.txt

  • 1 т. - за асинхронно изпълнение на заявките

Contents