Skip to content

Консоль: запуск с аргументами ​

Вита уже умеет делать программы, которые сами задают вопросы: input('Кого ищем?') — и ждут, пока пользователь напечатает ответ. Но иногда ответ известен заранее, и спрашивать незачем. Например, телефонную книгу можно запустить сразу с именем друга:

C:\phone> python phone.py Соня
+7 911 234-56-78

Всё, что написано в консоли после имени сценария, называется аргументами командной строки. Программа получает их через модуль sys.

Аргументы — это список строк ​

py
import sys

print(sys.argv)

sys.argv — это список. Первый элемент — имя самого сценария, остальные — аргументы, которые передали в консоли. Запустим python phone.py Соня:

py
# будет напечатано: ['phone.py', 'Соня']

Если аргументов несколько — каждый становится отдельным элементом списка. Для python phone.py Соня Москва:

py
# будет напечатано: ['phone.py', 'Соня', 'Москва']

Все элементы списка — строки, даже если в консоли напечатано число.

Первый элемент — имя сценария ​

sys.argv[0] — это всегда имя файла, из которого запускается программа. Поэтому аргументы пользователя начинаются с индекса 1:

py
import sys

print(sys.argv[0])  # phone.py
print(sys.argv[1])  # Соня

Поэтому, когда спрашивают, сколько аргументов передали, считают так: len(sys.argv) - 1.

Аргументы приходят строками ​

Консоль передаёт данные строками, поэтому число из sys.argv нужно преобразовать, как это делали раньше:

py
import sys

step = int(sys.argv[1])
print(10 + step)
# запуск: python calc.py 5
# будет напечатано: 15

Если передать не число — python calc.py пять, — int() остановит программу с ошибкой ValueError. Из урока об исключениях мы уже знаем, как на неё ответить:

py
import sys

try:
    step = int(sys.argv[1])
    print(10 + step)
except ValueError:
    print('это не число, передайте целое')
# запуск: python calc.py пять
# будет напечатано: это не число, передайте целое

Если аргумента нет ​

Пользователь может запустить программу вообще без аргументов: python phone.py. Тогда в списке будет только имя сценария, и обращение к sys.argv[1] упадёт с ошибкой IndexError. Сначала проверяем длину списка:

py
import sys

if len(sys.argv) < 2:
    print('укажите имя друга: python phone.py <имя>')
else:
    print('ищем: ' + sys.argv[1])

Теперь программа не ломается, а подсказывает, как её запустить.

Распаковка аргументов ​

Имя сценария обычно не нужно. Из урока о кортежах мы помним распаковку — она работает и со списками. Звёздочка соберёт все аргументы пользователя в один список:

py
import sys

script, *args = sys.argv
print(script)  # phone.py
print(args)    # ['Соня', 'Москва']

Дальше с args работают как с обычным списком: args[0] — первый аргумент, len(args) — сколько их передали.

Действие и данные ​

Частый приём: первый аргумент — действие, остальные — данные. Например, python phone.py show Соня:

py
import sys

action = sys.argv[1]
name = sys.argv[2]

if action == 'show':
    print('показываем номер: ' + name)
elif action == 'add':
    print('добавляем в книгу: ' + name)

А записи о друзьях удобно хранить кортежами, как в прошлом уроке:

py
import sys

phones = (
    ('Серёга', 'Омск', '+7 900 123-45-67'),
    ('Соня', 'Москва', '+7 911 234-56-78'),
)

def find_phone(phones, name):
    for friend in phones:
        if friend[0] == name:
            return friend[2]
    return None

if len(sys.argv) >= 2:
    print(find_phone(phones, sys.argv[1]))
# запуск: python phone.py Серёга
# будет напечатано: +7 900 123-45-67

Значение по умолчанию ​

Если аргумент не обязателен, задаём значение по умолчанию:

py
import sys

if len(sys.argv) >= 2:
    name = sys.argv[1]
else:
    name = 'Серёга'

print('привет, ' + name + '!')
# запуск: python greet.py
# будет напечатано: привет, Серёга!

input() или аргументы? ​

input()Аргументы командной строки
Когда появляются данныево время работы программыдо запуска, в строке консоли
Кому удобнодиалог: программа задаёт вопросысценарии: одна команда делает всё
Примерinput('Кого ищем?')python phone.py Соня

Для интерактивных программ — input(), для запуска «одной командой» — аргументы. Когда аргументов становится много, ручное разбирательство sys.argv заменяют модулем argparse — его разберём в будущих курсах.


Упражнения ​

  1. Напишите программу, которая печатает весь список sys.argv. Запустите её без аргументов: python args.py. Что напечатали?
py
import sys
# допишите код ниже
  1. Запустите программу с двумя аргументами: python args.py Привет мир. Напечатайте, сколько элементов в списке sys.argv, и сколько передано аргументов (без имени сценария).
py
import sys
# допишите код ниже
  1. Программа получает имя друга первым аргументом. Напечатайте: Привет, <имя>!
py
import sys
# допишите код ниже
  1. Если имя не передали, программа должна напечатать используйте: python name.py <имя>, иначе — привет, <имя>!. Запустите программу в обоих вариантах и проверьте результат.
py
import sys
# допишите код ниже
  1. Программа получает число первым аргументом: python calc.py 40. Добавьте к нему 1 и напечатайте результат.
py
import sys
# допишите код ниже
  1. Что произойдёт, если запустить программу из прошлого задания как python calc.py пять? Оберните преобразование в try/except и напечатайте это не число вместо ошибки.
py
import sys
# допишите код ниже
  1. Распакуйте sys.argv в переменные script и args со звёздочкой. Напечатайте каждый аргумент из args с новой строки.
py
import sys
# допишите код ниже
  1. Функция find_phone() ищет телефон по имени в кортеже phones. Имя передаётся из консоли: python phone.py Соня. Напечатайте найденный номер.
py
import sys

phones = (
    ('Серёга', 'Омск', '+7 900 123-45-67'),
    ('Соня', 'Москва', '+7 911 234-56-78'),
    ('Дима', 'Казань', '+7 922 345-67-89'),
)

def find_phone(phones, name):
    for friend in phones:
        if friend[0] == name:
            return friend[2]
    return None

# допишите код ниже
  1. Первый аргумент — действие (show или add), второй — имя. Для show напечатайте показываем: <имя>, для add — добавляем: <имя>. Если аргументов меньше двух, напечатайте используйте: python phone.py <действие> <имя>.
py
import sys
# допишите код ниже
  1. Имя друга необязательно: если аргумент не передали, используйте имя по умолчанию Серёга. Напечатайте: привет, <имя>!
py
import sys
# допишите код ниже