tdd - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

todo - програма-нагадування/завдання, призначена для розробників

СИНТАКСИС

TODO []
Без параметрів відображає елементи в поточному каталозі.

тда [-с ] [-г ] []
Додайте новий елемент, за бажанням прищеплюючи його як дочірній до даного елемента.

tde
Відредагуйте заданий елемент.

tdr
Видаліть задані елементи.

tdd
Позначте вказані пункти як виконані.

TODO --посилання [-г ]
Зв’яжіть вказану базу даних devtodo з поточною, за бажанням прищепивши її як
дочірній із зазначеним індексом.

ОПИС

TODO – це програма, спеціально призначена для програмістів (але її може використовувати будь-хто в
термінал) для допомоги в повсякденному розвитку.

Він підтримує список пунктів, які ще не завершені. Це дозволяє програмісту
відстежуйте видатні помилки або елементи, які потрібно виконати з дуже незначними зусиллями.

Елементи можуть бути пріоритетними, а також можуть бути відображені в ієрархії, так що один елемент може бути
залежати від іншого.

З використанням деяких невеликих сценаріїв оболонки (scripts.* в каталозі doc вихідного коду
дистрибутив), todo також може відображати невиконані елементи в каталозі під час зміни
в це. Тож, наприклад, якщо ви завантажуєте вихідний каталог для самого todo, ви повинні
подивіться список видатних елементів... якщо всі помилки не виправлені ;).

ВАРІАНТИ

Варіанти можуть мати як довгу, так і коротку форму.

Короткі параметри можна об’єднати в один аргумент, використовуючи дефіс, за яким слід рядок
короткі варіанти. Параметри коротких параметрів також можуть бути додані до цього рядка.

-v, -багатослівний
Відображати багатослівно

-а, --додати []
Додайте примітку (запрошує ввести нотатку, якщо її немає).

-g, --щеплення
В поєднанні з --додати or --посилання, прищепити новий елемент до вказаного.

-л, --посилання
Зв’яжіть вказаний файл завдань із тілом цього. Якщо зв’язана база даних має
набір заголовків, він буде використовуватися як тіло зв'язувального елемента, інакше
буде використано ім’я каталогу зв’язаної бази даних. Використовуйте --remove (або tdr), щоб видалити
пов'язані бази даних - це робить НЕ видалити саму базу даних, лише посилання.

-R,--відповідальний [, ]
Змініть батьківський індекс першого елемента на індекс другого елемента. Якщо немає другої
задано індекс елемента, який передається в корінь дерева.

-p, -- пріоритет
У поєднанні з --add або --edit установіть пріоритет (за замовчуванням | дуже високий | високий |
середній | низький | дуже низький)

-е, --редагувати
Відредагуйте нотатку, проіндексовану вказаним номером.

-видалити
Видаліть нотатку, проіндексовану вказаними номерами, включаючи будь-які дочірні елементи.

-d, --зроблено
Позначте вказані нотатки (та їх дочірні елементи) як виконані.

-Д, --не зроблено
Позначте вказані нотатки (і всі дочірні елементи) як невиконані.

--глобальна база даних
Укажіть базу даних для використання, якщо будь-яка з них -G or --глобальний вказано варіанти.

-G, --глобальний
Змусити todo використовувати базу даних, зазначену в --глобальна база даних. Якщо це розміщено
у вашому ~/.todorc це змусить todo використовувати цю базу даних для виключення всіх
інші

--база даних
Змініть базу даних за замовчуванням (зазвичай ".todo") на файл
вказано.

-Т, --РОБИТИ
Згенеруйте типовий вихідний текстовий файл TODO з БД Todo.

-A, --все
Ярлик для фільтра "+Готово,+діти", щоб показати всі нотатки.

-f, --фільтр
Відображати лише ті нотатки, які проходять фільтр. Будь ласка, зверніться до розділу ФІЛЬТРИ та цінності
більше інформації.

--колір
Замінити кольори за замовчуванням для елементів завдань. Будь ласка, зверніться до розділу Колір більше
інформація.

--форс-колір
Примусове використання кольору, навіть якщо не виводиться на TTY. Це корисно при прокладці труб
до менше(1) -Р.

--мононуклеоз Видаліть усі вихідні послідовності ANSI з виводу – корисно для людей із порушенням кольору
клеми.

--допомога Показати цю довідку.

-- версія
Відобразити версію ToDo.

-- назва []
Встановіть назву приміток до завдань цього каталогу.

--формат дати
Формат відображення значень часу. Формат такий, який використовується strftime(3 р.). The
формат за замовчуванням — '%c'. Цей параметр найкраще вказати в ~/.todorc.

--формат =
Вкажіть формат виводу. Будь ласка, зверніться до розділу ФОРМАТУВАННЯ для отримання додаткової інформації
інформація.

--use-format =
Використовуйте рядок форматування, визначений (визначається за допомогою --format) як
рядок форматування для використання під час форматування за допомогою вбудованого формату .

--сортувати
Сортуйте базу даних за вказаним виразом. Зверніться до розділу СОРТУВАННЯ та цінності
більш детальну інформацію.

--параноїд
Будьте параноїком щодо деяких налаштувань, зокрема дозволів.

--завантажувачі баз даних <завантажувач список>
Спробуйте формати бази даних у зазначеному порядку. Допустимі формати XML та двійковий. наприклад,
todo --database-loaders binary,xml. Формат за замовчуванням – XML.

--резервне копіювання []
Резервне копіювання бази даних до разів, безпосередньо перед тим, як це буде написано. Якщо НЕ
буде зроблено одну резервну копію. Для зберігання резервних копій використовуються імена файлів
ім'я бази даних за замовчуванням з доданою їх версією так: .todo.1, .todo.2 тощо.
Щоб фактично використовувати одну з цих резервних копій, ви можете змінити її на .todo або використати
--база даних .todo. чітко вказати його використання.

-так, -- резюме
Увімкніть режим «підсумок», коли довгі елементи обрізаються до одного рядка.

-c, -- коментар
Відредагувати або показати коментарі відповідно.

--час вийшов []
If вказано, час очікування між показами бази даних встановлюється на це число
секунд. Якщо ні вказано, поведінка полягає в відображенні бази даних
тільки якщо він не відображався протягом кількості секунд, визначених параметром --timeout
з дано. наприклад TODO --час вийшов 10 --час вийшов відображатиме лише
бази даних щонайбільше раз на 10 секунд. Поставивши а Тайм-аут 10 у вашому ~/.todorc це
хороший варіант, тоді --тайм-аут у документ/скрипти.* буде означати, що база даних
не буде відображатися щоразу, коли ви вводите компакт-диск до каталогу.

-- очищення []
Очистіть усі завершені предмети старше ніж . Якщо опущено, все
заповнені записи очищаються.

Пріоритети

Пріоритети можна вказати символічно за допомогою слів дефолт, дуже високо, висока, середа,
низький та дуже низький.

Команда дефолт priority має особливе значення в тому, що він використовуватиме пріоритет за замовчуванням для будь-якого
дії. Це означає, що при редагуванні існуючого елемента його пріоритет зберігається; коли
створення нового елемента, пріоритет буде встановлено на середа; при щепленні нового предмета, його
пріоритетом буде пріоритет його батьківського. Якщо це так, DevTodo не запитуватиме пріоритет
зазначено, що робить його зручною функцією для вашого todorc. Як і у всіх варіантах, пріоритет
можна змінити в командному рядку.

ФІЛЬТРИ

Фільтри складаються зі списку виразів, які використовуються для визначення приміток
відображається.

Загальний формат виразу фільтра:

([-|=|+](всі|діти|зроблено| | )) | (/ вираз>)

Як правило, якщо вираз фільтра має префікс «-», це буде НЕ відображати елементи, які
відповідати виразу, якщо до нього ставиться префікс «+», він відображатиме елементи, які відповідають цьому
вираз на додаток до інших, або якщо до нього ставиться префікс '=' (або взагалі без префікса), він
дисплей тільки ті елементи, які відповідають виразу. Зауважте, що це шукатиме лише елементи
не виключається іншими фільтрами, тому для пошуку по всій базі даних вам доведеться зробити
щось на зразок: TODO --фільтр all,/some-search-string.

Друга форма виразу фільтра використовується для пошуку тексту в базі даних. <пошук
вираз> це регулярний вираз, який порівнюється з текстом кожного елемента.

Атоми фільтра фільтруються за станом виконання, пріоритетом, а потім пошуком. Отже, перші предмети
які не відповідають фільтру "зроблено", будуть виключені, тоді ті, які не відповідають фільтру
фільтр пріоритету тощо.

Вирази докладно:

всі Примусово відображати всі елементи. Різні префікси на це не впливають
вираз.

діти
Згортати або розгортати дочірні елементи. Якщо присутній префікс "-", діти є
згорнуто, інакше відображаються діти.

зроблений Фільтрувати, чи завершено елемент чи ні.


Індекси приміток задаються у вигляді чисел. Діапазони можна задати ala '1.2.10-20'.


Пріоритети визначаються, як описано в Пріоритети розділ. Префікс "-"
відобразить усі елементи з пріоритетом, меншим або рівним заданому.
З префіксом '+' всі елементи з пріоритетом, більшим або рівним заданому
відображаються пріоритети. Якщо '=' або не вказано префікс, лише елементи із зазначеним
відображаються пріоритет.

Приклади:

todo --фільтр виконано,-child,+low

Це відображатиме лише ті елементи, які виконані та мають низький або вищий пріоритет. в
крім того, діти будуть розбиті.

todo /[Tt]he

Відображати лише ті елементи, у яких є слово «the», у яких перша літера може бути нижчою
або верхній регістр. Можливо, знадобиться ввести в лапки вираз пошуку, щоб переконатися, що оболонка працює
не інтерпретувати їх.

ФОРМАТУВАННЯ

Вихід todo можна змінити, щоб він був більше на ваш смак, визначивши власний
форматування рядків. Ці струни подібні до тих, що використовуються в printf(3) і strftime(3).

Наступні приклади, які можна розмістити в ~/.todorc, буде імітувати значення за замовчуванням
поведінка:

# Відображати у форматі за замовчуванням
формат дисплея=%i%[info]%f%2n.%[пріоритет]%T

# Відображати у форматі за замовчуванням
згенерований формат=%2i-%T%2i (додано %d, пріоритет %p)\n\n

Є чотири окремі варіанти формату: дисплей, генерується, багатослівний дисплей та багатослівний-
генерується. Два останніх використовуються для форматування відповідного тексту, коли --verbose
вказано як аргумент todo.

Крім того, користувачі можуть створювати власні рядки формату, просто передаючи інший
ідентифікатор до формат. Потім це можна ввімкнути за допомогою --use-format. наприклад,

format full-report=%i%[info]%f%2n.%[priority]%+1T%+1i%[info]Додано: %[normal]%c
%[info]Завершено: %[normal]%d\n%+1i%[info]Тривалість: %[normal]%D %[info]Пріоритет:
%[нормальний]%p\n\n
# Перевизначте формат відображення, щоб використовувати "повний звіт".
використовувати-формат display=full-report

Доступні різні прапори:

% > Команда > прапорець встановлює кількість пробілів використовувати для всіх майбутніх відступів.

%[+|-][ ] i
Відступ до глибини поточного елемента. визначає глибину для відступу. Якщо is
опущено, використовується поточний рівень. Можна використовувати відносні значення. наприклад "%+1T" буде
відступ на один рівень вище, ніж поточний рівень відступу.

%[+|-][ ]Т
Відобразити текст елемента, обгорнутий довжиною 80 символів і з відступом до
зазначений рівень. Семантика є як з %i. Зверніть увагу, що обгорнутий текст
автоматично додає '0 в кінці тексту, тоді як %t не буде.

%t Розгорнутий, неформатований текст елемента.

%s Текст резюме (тобто лише один рядок, еквівалентний -- резюме).

%p Рівень пріоритету поточного елемента.

%c Поточна дата створення елементів, відформатована відповідно до --date-format.

%d Дата, коли елемент було позначено як виконане, відформатовано відповідно до --date-format.

%D Тривалість елемента, відформатований відповідно до --date-format.

%[ ]n
Індексний номер поточного елемента. Необов’язкове числове значення вказує
кількість символів, яку має займати число. Число заповнюється пробілами
щоб заповнити цю кількість символів.

%f Державний прапор поточного елемента. Відображаються значення для цього прапора «+»
означає дітей, "-" означає "зроблено", "*" означає "зроблено з дітьми".

%F Прапор стану для читання поточного елемента. Відображені значення для цього
прапор: «діти», «зроблено» означає «зроблено», «зроблено, діти» та «відкрито».

%[ ]
За допомогою цього прапорця можна вказати кольори. Допустимі значення для є:
дуже низький, низький, середа, висока, дуже високо, назву, info та пріоритет. Це справедливо
зрозуміло, за винятком пріоритет змінює колір пріоритету поточних елементів. наприклад
%[пріоритет]

Зверніть увагу, що під час відступу ви будете типово хочу використовувати значення префікса "+1"
з %T. тобто. %+1T. Це змушує текст робити відступ на один рівень глибший, ніж поточний
рівень, що робить його віддаленим від будь-якого іншого форматування, яке ви могли використовувати.

СОРТУВАННЯ

Відображення елементів у базі даних можна сортувати за різними ключами. Враховуючи серію
keys todo сортує кожен наступний ключ, переходячи до наступного, лише якщо попередній ключ
порівняння було рівним. Наприклад:

todo --sort -done,text

Це буде сортувати, по-перше, за тим, чи заповнений елемент, а по-друге, за його текстом. Це
ефективно групує елементи на два блоки - ті, які є повними, і ті, які не є.

Ключі, які є в наявності створений, завершений, текст, пріоритет, тривалість, ніхто та
зроблений. Кожен ключ, крім ніхто може бути з префіксом -, щоб змінити його порядок за замовчуванням і
кілька клавіш мають бути розділені символом ,.

Якщо зустрічається кілька параметрів --sort, використовується останній. Це означає, що а
«сортувати» запис в ~/.todorc буде замінено будь-яким у командному рядку.

ПОКАЗНИКИ

Індекси використовуються як параметри для різноманітних аргументів командного рядка. Кілька нотних індексів
відокремлюються комами (пробіли НЕ дозволено). Діти визначаються за допомогою ".".

Наприклад, враховуючи такі примітки:

1. Створіть сторінки man
1. Зробіть їх красивішими.
2. Створіть також HTML-документацію.

Другий підпункт буде представлений так: 1.2

Підстановковий знак «*» можна використовувати для представлення всіх дочірніх вузлів. наприклад 1.*

Діапазон нотаток можна вказати за допомогою ' - '. Наприклад, щоб позначити примітки 10.1.2,
10.1.3 і 10.3.4 як виконано, ви можете зробити: todo --done 10.1.2-4

Колір

Різні предмети можна розфарбувати. Предмети, які можуть бути дуже високо, висока, середа, низький, дуже низький,
назву та info. info використовується для відображення номерів позицій та загальної інформації.

Для цих елементів можна вибрати один із восьми кольорів. Ці кольори є чорний, червоний, зелений,
жовтий, синій, пурпурний, блакитний, білий та дефолт. Колір дефолт використовується для вказівки
колір переднього плану термінала за замовчуванням.

Кольори вказуються так:

=[+]

Якщо необов’язковий + у цьому виразі використовується, це призведе до того, що елемент стане жирним.

Наприклад, рядок у вашому ~/.todorc може виглядати так:

колір середній=+білий

Що зробило б середа текст жирним шрифтом білий.

ТОДОРК

todo може завантажувати параметри з ряду файлів ресурсів. Порядок їх аналізу
полягає в наступному:

1. Файл, зазначений у змінній середовища ТОДОРК або, якщо цього не існує,
/etc/todorc.
2. ~/.todorc

Параметри є сукупними, оскільки ті, завантажені з $TODORC, будуть замінені або додані до них
тих, хто в ~/.todorc.

Ці параметри вказані як пари ключ/значення, по одному на рядок. Ключ є довгим ім'ям a
Аргумент командного рядка, а значення є параметром цього аргументу, якщо такий є. В додаток,
змінні середовища розширюються.

Наприклад, аргумент командного рядка --filter приймає параметр, який є фільтром
вираз. Фільтр за замовчуванням можна додати до ~/.todorc файл так:

# Не відображати дочірні елементи за замовчуванням
фільтр -діт

Єдина відмінність між параметрами, зазначеними у файлі rc, і параметрами в командному рядку
полягає в тому, що параметри у файлі rc не мають префікса --.

Крім того, у файлі RC доступні дві команди, які недоступні на
командний рядок. Вони є:

Перша команда, on, використовується для умовного додавання певних команд. Формат цього
команда така: on [ ]. Допустимі події є додавати, видаляти, вид, редагувати,
породжувати, зроблений, не зроблено, назву, батьківський, загрузка, економити, за посиланням, створювати та чистка. Кілька
можна передавати команди on укладаючи їх у дужки (між ними необхідний пробіл
токени). Повний приклад нижче.

Друга команда Exec <оболонка команда>. Ця команда виконає аргумент, яким вона є
дається в оболонці. Змінна середовища $TODODB містить ім’я поточного файлу
бази даних. наприклад Exec CHMOD 600 $TODODB

У підкаталозі doc вихідного дистрибутива є приклад файлу rc.

ПРИКЛАДИ

Щоб відобразити будь-які невиконані елементи в поточному каталозі, просто введіть:

TODO

Щоб видалити примітки 1, 2 і 4:

todo --видалити 1,2,4

Щоб відобразити УСІ елементи:

робити все

Щоб відобразити лише елементи верхнього рівня, а не їхні дочірні елементи:

todo -діти

(незважаючи на -діти не є дійсним аргументом, це працює, тому що todo інтерпретує будь-який
аргументи командного рядка, які він не розпізнає як частину виразу фільтра)

Більш складний приклад. Це додає новий елемент з текстом елемента, зазначеним на
командного рядка з пріоритетом висока як дочірня третього дочірнього другого пункту (якщо
це має сенс):

todo -a "Виправити сторінку керівництва" -p high -g 2.3

Це приклад того, як використовувати функцію TODO у todo. Це змушує завдання генерувати новий
TODO з інформації, що зберігається в базі даних. Цей конкретний приклад виводить все
у файл TODO, навіть ті, які позначені як виконані.

todo --фільтрувати все --TODO

Цей приклад показує гарне використання тригерів подій. Коли створюється нова база даних
змусить свої дозволи до 0600.

на створення {
докладний
exec chmod 600 .todo
}

Використовуйте tdd онлайн за допомогою служб onworks.net