🥇Сдружаваме 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 има по-малко изменения. Причината е проста – липсата на свободно време, което доведе до преминаване на някои потенциални подобрения (например, автоматично допълване на променливи на средата) на следващото издание.

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