🥇Свързваме Python и Bash: релиз на библиотеките python-shell и smart-env v. 1.0.1

Добър ден на всички!

29 февруари 2020 година се състоя официален микро-релиз на библиотеките smart-env и python-shell. На тези, които не са в течение, предлагам предварително да прочетат първия пост.

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

За подробности моля под кат.

Какво ново в python-shell?

Ще започна направо с десерта.

Автодовършване на команди

Съгласете се — удобно е, когато редактор/IDE/терминал подсказва името на командата, а понякога и параметрите за извикване? Ето и python-shell постъпва постепенно в осигуряването на подобна функционалност. Поради факта, че полетата на класа Shell в дъното де факто не са негови полета (вездесъщия __getattr__), автоматичното допълване е създадено също от нула (чрез презареждане на метода __dir__). В момента автоматичното допълване работи в средите BPython и IPython. Разбира се, бих искал да видя интеграция с по-популярни продукти като PyCharm, и в тази посока се изучават възможностите за реализация.

Добавяне на свойства

В рамките на релиза класът Shell получи ново свойство last_command. Нуждата от него възникна, тъй като при генериране на исключение ShellException командата с ненулев код на връщане обект Command не се връщаше от извикването на __call__() на обекта на командата. Сега обаче е възможно да направите следното:

try:
    command = Shell.touch('/foo.txt')
except ShellException:
    command = Shell.last_command

Списъкът на свойствата на обекта Command също се разшири. Добавено е поле errors, което връща изхода на командата в потока за грешки.

Изпълнение на команди с невалидни имена за Python

Практически във всяка система има поне една програма, чието име не е подходящо за идентификатор в Python (например, известната утилита 2to3). Не можете да я извикате с

Shell.2to3()

няма да сработи — интерпретаторът няма да я приеме.
Решението е да се извика командата по заобиколен начин:

Shell("2to3")  # връща обект на командата

Струва си да се отбележи, че по същия начин можете да стартирате и валидни команди от гледна точка на интерпретатора, което оставя възможност да правите гъвкави скриптове като

cmd = "python{}".format(sys.version_info[0])
Shell(cmd)(*args, **kwargs)

Малки промени

Реализирани са методи __repr__() и __str__() на обекта от класа Command, които сега дават интуитивно разбираеми стойности (командата с параметри и нейния stdout изход съответно).
Малки корекции по кода.
Добавяне на тестово покритие и реорганизация на съществуващите.
Добавяне на класове Subprocess и Process, чиято цел е да създадат допълнително ниво на абстракция при работа с модула subprocess. В повечето случаи това е необходимо за отстраняване на повторения в кода при работа с Python 2/3, но потенциално може да предложи и други предимства.

Какво е новото в smart-env?

В сравнение с python-shell, в библиотеката smart-env промените са по-малко. Причината е проста - липсата на свободно време, поради което някои потенциални подобрения (например автоматично допълване на променливи на средата) бяха отложени за следващото издание.

Всъщност, в библиотеката са направени следните промени: