tdd - Online nel cloud

PROGRAMMA:

NOME

todo - un programma di promemoria/attività rivolto agli sviluppatori

SINOSSI

todo []
Senza opzioni, visualizza gli elementi nella directory corrente.

tda [-P ] [-G ] []
Aggiungi un nuovo oggetto, eventualmente innestandolo come figlio dell'oggetto dato.

tde
Modifica l'elemento dato.

ToR
Rimuovere gli elementi dati.

dd
Contrassegna gli elementi specificati come completati.

todo --collegamento [-G ]
Collega il database devtodo specificato a quello corrente, eventualmente innestandolo come
un figlio dell'indice specificato.

DESCRIZIONE

todo è un programma rivolto specificamente ai programmatori (ma utilizzabile da chiunque al
terminale) per favorire lo sviluppo quotidiano.

Mantiene un elenco di elementi che devono ancora essere completati. Ciò consente al programmatore di
tenere traccia di bug o elementi in sospeso che devono essere completati con il minimo sforzo.

Gli elementi possono avere la priorità e possono anche essere visualizzati in una gerarchia, in modo che un elemento possa
dipendere da un altro.

Con l'uso di alcuni piccoli script di shell (scripts.* nella directory doc del sorgente
distribuzione), da fare può anche visualizzare gli elementi in sospeso in una directory mentre si cambia
dentro. Quindi, ad esempio, se accedi alla directory dei sorgenti per fare da solo, dovresti
vedere un elenco di elementi in sospeso... a meno che tutti i bug non siano stati corretti;).

VERSIONI

Le opzioni possono avere sia una forma lunga che una breve.

Le opzioni brevi possono essere combinate in un argomento usando un trattino seguito da una stringa di
opzioni brevi. Anche i parametri delle opzioni brevi possono essere aggiunti a questa stringa.

-in, --verboso
Visualizza verbosamente

-un, --Inserisci []
Aggiungi una nota (verrà richiesta una nota se non ne viene fornita una).

-G, --corruzione
Insieme a --Inserisci or --collegamento, innestare il nuovo elemento nell'elemento specificato.

-l, --collegamento
Collega il file da fare specificato nel corpo di questo. Se il database collegato ha
un set di titoli, questo sarà usato come corpo dell'elemento di collegamento altrimenti il
verrà utilizzato il nome della directory del database collegato. Usa --remove (o tdr) per rimuovere
database collegati ‐ questo lo fa non è un rimuovere il database stesso, solo il collegamento.

-R, -- riparatore [, ]
Modificare il padre del primo indice dell'elemento nel secondo indice dell'elemento. Se nessun secondo
index è dato che l'elemento è reparentato alla radice dell'albero.

-P, --priorità
In combinazione con --add o --edit, imposta la priorità (default | veryhigh | high |
medio | basso | molto basso)

-e, --modificare
Modifica la nota che è indicizzata dal numero dato.

--rimuovere
Rimuovi la nota indicizzata dai numeri indicati, inclusi eventuali figli.

-D, --fatto
Contrassegna le note specificate (e i relativi figli) come completate.

-D, --non fatto
Contrassegna le note specificate (e tutti i figli) come non completate.

--database-globale
Specificare il database da utilizzare se uno dei due -G or --globale le opzioni sono specificate.

-G, --globale
Forza attività per utilizzare il database specificato con --database-globale. Se questo è posizionato
nella vostra ~/.todorc obbligherà a usare quel database escludendo tutti
altri.

--Banca dati
Cambia il database da qualunque sia l'impostazione predefinita (in genere '.todo') al file
specificato.

-T, --DA FARE
Genera un tipico file di testo di output TODO da un DB Todo.

-UN, --tutti
Scorciatoia per il filtro '+fatto,+bambini' per mostrare tutte le note.

-F, --filtro
Visualizza solo le note che superano il filtro. Si prega di fare riferimento alla sezione FILTRI da
maggiori informazioni.

--colore
Sostituisci i colori predefiniti degli elementi da fare. Si prega di fare riferimento alla sezione COLORE per maggiori
informazioni.

--forza-colore
Forza l'uso del colore anche quando non si esegue l'output su un TTY. Questo è utile durante le tubazioni
a meno(1) -R.

--mono Rimuovi tutte le sequenze di escape ANSI dall'output: utile per chi ha problemi di colore
terminali.

--Aiuto Visualizza questo aiuto.

--versione
Visualizza la versione di ToDo.

--titolo []
Imposta il titolo delle note attività di questa directory.

--formato data
Formatta la visualizzazione dei valori temporali. Il formato è quello usato da strftime(3). Il
il formato predefinito è '%c'. Questa opzione è meglio specificata in ~/.todorc.

--formato =
Specificare la formattazione dell'output. Si prega di fare riferimento alla sezione FORMATTAZIONE per ulteriori informazioni
informazioni.

--usa-formato =
Usa la stringa di formato identificata da (definito con --format) come
stringa di formato da utilizzare durante la formattazione con il formato integrato .

--ordinare
Ordina il database con l'espressione specificata. Fare riferimento alla sezione ORDINAMENTO da
informazioni più dettagliate.

--paranoico
Sii paranoico su alcune impostazioni, inclusi i permessi.

--database-loader <caricatore lista>
Prova i formati del database nell'ordine indicato. I formati validi sono xml e binario. per esempio.
cose da fare --database-loaders binary,xml. Il formato predefinito è XML.

--backup []
Esegui il backup del database fino a volte, appena prima che venga scritto. Se non è
specificato, verrà eseguito un backup. I nomi dei file utilizzati per archiviare i backup sono i
nome del database predefinito con la loro revisione aggiunta in questo modo: .todo.1, .todo.2, ecc.
Per utilizzare effettivamente uno di questi backup, puoi spostarlo su .todo o utilizzare
--database .todo. specificarne esplicitamente l'uso.

-S, --riepilogo
Attiva/disattiva la modalità "riepilogo", in cui gli elementi lunghi vengono troncati su una riga.

-C, --commento
Modifica o mostra commenti rispettivamente.

--tempo scaduto []
If è specificato, il timeout tra le visualizzazioni del database è impostato su questo numero
di secondi. se no è specificato, il comportamento è quello di visualizzare il database
esclusivamente se non è stato visualizzato per il numero di secondi specificato da --timeout
con , il dato. per esempio. todo --tempo scaduto 10 --tempo scaduto mostrerebbe solo il
database al massimo una volta ogni 10 secondi. mettendo un timeout 10 nella vostra ~/.todorc è un
buona opzione, quindi il --timeout nel documento/script.* significherà che il database
non verrà visualizzato ogni volta che entri in una directory.

--epurazione []
Elimina tutti gli elementi completati più vecchi di . Se è omesso, tutto
i record completati vengono eliminati.

PRIORITA '

Le priorità possono essere specificate simbolicamente usando le parole difetto, molto alto, alto, medie,
Basso e molto basso.

. difetto priorità ha un significato speciale in quanto utilizzerà la priorità predefinita per qualsiasi
azione. Ciò significa che quando si modifica un elemento esistente, la sua priorità viene preservata; quando
creando un nuovo elemento, la priorità sarà impostata su medie; quando si innesta un nuovo oggetto, è
la priorità sarà quella del suo genitore. DevTodo non richiederà la priorità se questo è
specificato, rendendolo una funzionalità utile per il tuo todorc. Come per tutte le opzioni, la priorità
può essere sovrascritto dalla riga di comando.

FILTRI

I filtri sono costituiti da un elenco di espressioni utilizzate per definire le note che sono
visualizzato.

Il formato generale di un'espressione di filtro è:

([-|=|+](tutti|bambini|fatto| | )) | (/ espressione>)

In genere, se un'espressione di filtro è preceduta da un '-' lo farà non è un visualizzare gli elementi che
corrisponde all'espressione, se preceduto da un '+' visualizzerà gli elementi che corrispondono a questo
espressione in aggiunta ad altre, o se preceduta da un '=' (o nessun prefisso) lo farà
dalla visualizzazione esclusivamente quegli elementi che corrispondono all'espressione. Nota che questo cercherà solo gli elementi
non escluso da altri filtri, quindi per cercare nell'intero database dovrai fare
qualcosa di simile a: todo --filtro tutti,/qualche-stringa di ricerca.

La seconda forma di espressione di filtro viene utilizzata per la ricerca di testo in un database. <cerca
espressione> è un'espressione regolare che viene confrontata con il corpo del testo di ogni elemento.

Gli atomi del filtro vengono filtrati in ordine per stato fatto, priorità, quindi ricerca. Quindi primi elementi
che non corrispondono al filtro "fatto" verranno esclusi, quindi quelli che non corrispondono al
filtro prioritario e così via.

Le espressioni in dettaglio:

contro tutti i Forza la visualizzazione di tutti gli elementi. I vari prefissi non hanno alcun effetto su questo
espressione.

bambini
Comprimi o espandi gli elementi figlio. Se è presente il prefisso '-' i bambini lo sono
compresso, altrimenti vengono visualizzati i bambini.

fatto Filtra se un elemento è completato o meno.


Gli indici delle note sono specificati come numeri. Gli intervalli possono essere dati ala '1.2.10-20'.


Le priorità sono specificate come descritto nel PRIORITA ' sezione. Un prefisso di '-'
visualizzerà tutti gli elementi con priorità minore o uguale alla priorità data.
Con un prefisso '+', tutti gli elementi con priorità maggiore o uguale a quella data
vengono mostrate le priorità. Se viene fornito '=' o nessun prefisso, solo gli elementi con la specificata
vengono visualizzate le priorità.

Esempi:

da fare --filtro fatto,-bambini,+basso

Verranno visualizzati solo gli elementi che sono stati completati e hanno una priorità bassa o superiore. In
Inoltre, i bambini saranno collassati.

da fare /[Tt]he

Visualizza solo gli elementi che contengono la parola "il", dove la prima lettera può essere inferiore
o maiuscolo. Potrebbe essere necessario citare l'espressione di ricerca per assicurarsi che la shell lo faccia
non interpretarli.

FORMATTAZIONE

L'output di cose da fare può essere modificato per essere più di tuo gradimento definendo il tuo
stringhe di formattazione. Queste stringhe sono simili a quelle usate in printf(3) e strftime(3).

I seguenti esempi, che possono essere inseriti in ~/.todorc, imiterà l'impostazione predefinita
comportamento:

# Visualizza nel formato predefinito
formato display=%i%[info]%f%2n.%[priorità]%T

# Visualizza nel formato predefinito
formato generato=%2i-%T%2i (aggiunto %d, priorità %p)\n\n

Sono disponibili quattro opzioni di formato separate: dalla visualizzazione, generato, display-verboso e verboso-
generato. Gli ultimi due sono usati per formattare il loro rispettivo testo quando --verbose è
specificato come argomento da fare.

Inoltre, gli utenti possono creare le proprie stringhe di formato semplicemente passando un diverso
identificatore a formato. Questo può quindi essere abilitato utilizzando --usa-formato. per esempio.

formato full-report=%i%[info]%f%2n.%[priority]%+1T%+1i%[info]Aggiunto: %[normal]%c
%[info]Completato: %[normal]%d\n%+1i%[info]Durata: %[normal]%D %[info]Priorità:
%[normale]%p\n\n
# Sostituisci il formato di visualizzazione per utilizzare "report completo".
use-format display=report-completo

I vari flag disponibili sono:

% > . > flag imposta il numero di spazi da utilizzare per tutti i rientri futuri.

%[+|-][ ]io
Rientro alla profondità dell'elemento corrente. specifica la profondità a cui rientrare. Se is
omesso, viene utilizzato il livello corrente. Possono essere utilizzati valori relativi. per esempio. '%+1T' sarebbe
rientro a un livello superiore al livello di rientro corrente.

%[+|-][ ]T
Visualizza il testo dell'elemento, avvolto a 80 caratteri e rientrato al
livello specificato. Semantica di sono come con %i. Nota che il testo avvolto
aggiunge automaticamente uno '0 alla fine del testo, mentre %t non lo farò.

%t Testo dell'elemento da scartare e non formattato.

%s Testo riassuntivo (es. una sola riga, equivalente a --riepilogo).

%p Il livello di priorità dell'elemento corrente.

%c La data di creazione degli elementi correnti, formattata secondo --date-format.

%d La data in cui l'elemento è stato contrassegnato come completato, formattato secondo --date-format.

%D La durata dell'elemento, formattata secondo --date-format.

%[ ]n
Il numero di indice dell'elemento corrente. Il valore numerico opzionale specifica il
numero di caratteri che il numero dovrebbe occupare. Il numero è riempito di spazi
in modo da riempire questo numero di caratteri.

%f La bandiera di stato dell'elemento corrente. I valori visualizzati per questo flag sono '+'
significa bambini, '-' significa fatto', '*' significa finito con i bambini.

%F Il flag di stato leggibile dall'uomo dell'elemento corrente. I valori visualizzati per questo
flag sono 'bambini', 'fatto' significa fatto', 'fatto, bambini' e 'aperto'.

%[ ]
I colori possono essere specificati con questo flag. I valori validi per siamo:
molto basso, Basso, medie, alto, molto alto, titolo, Maggiori informazioni.e priorità. Questi sono abbastanza
autoesplicativo, tranne priorità cambia il colore di priorità degli elementi correnti. per esempio.
%[priorità]

Si prega di notare che quando si indenta, si tipicamente desidera utilizzare un valore di prefisso di '+1'
con T. cioè. %+1T. Questo costringe il testo a rientrare di un livello più profondo dell'attuale
livello, facendolo stare lontano da qualsiasi altra formattazione che potresti aver usato.

ORDINAMENTO

La visualizzazione degli elementi nel database può essere ordinata su una varietà di chiavi. Data una serie di
keys todo ordina su ogni tasto successivo, passando al successivo solo se il tasto precedente
confronto era uguale. Per esempio:

cose da fare --sort -done,testo

Questo ordinerà in primo luogo se un elemento è completato e in secondo luogo per il loro testo. Questo
raggruppa efficacemente gli elementi in due blocchi: quelli che sono completi e quelli che non lo sono.

Le chiavi disponibili sono creato, completato, testo, priorità, durata, nessuna e
fatto. Ogni chiave, tranne nessuna può essere preceduto da un - per invertire l'ordine predefinito e
più chiavi devono essere separate con un ,.

Se vengono rilevati più parametri --sort, viene utilizzato l'ultimo. Ciò significa che a
'ordina' voce in ~/.todorc verrà sovrascritto da qualsiasi sulla riga di comando.

INDICI

Gli indici vengono utilizzati come opzioni per una varietà di argomenti della riga di comando. Indici di note multiple
sono separati da virgole (gli spazi sono non è un consentito). I bambini vengono individuati utilizzando un '.'.

Ad esempio, date le seguenti note:

1. Fare pagine man
1. Rendili più belli.
2. Crea anche la documentazione HTML.

La seconda sottovoce sarebbe rappresentata così: 1.2

Il carattere jolly '*' può essere utilizzato per rappresentare tutti i figli di un nodo. per esempio. 1.*

Gli intervalli di note possono essere specificati utilizzando ' - '. Ad esempio, per contrassegnare le note 10.1.2,
10.1.3 e 10.3.4 come fatto, potresti fare: todo --done 10.1.2-4

COLORE

Vari articoli possono essere colorati. Articoli che possono essere molto alto, alto, medie, Basso, molto basso,
titolo e Maggiori informazioni.. Maggiori informazioni. viene utilizzato per visualizzare i numeri degli articoli e le informazioni generali.

Questi elementi possono essere impostati su uno degli otto colori. Quei colori sono Nero, rosso, green,
giallo, blu, magenta, ciano, bianca e difetto. Il colore difetto è usato per specificare il
colore predefinito del terminale in primo piano.

I colori sono specificati in questo modo:

=[+]

Se l'opzionale + in questa espressione viene utilizzata farà diventare l'elemento in grassetto.

Ad esempio, una riga nel tuo ~/.todorc potrebbe apparire come:

colore medio=+bianco

che farebbe medie testo bianca.

TODORC

todo può caricare opzioni da una serie di file di risorse. L'ordine in cui vengono analizzati
è il seguente:

1. Il file specificato nella variabile d'ambiente TODORC o, se non esiste,
/etc/todorc.
2. ~/.todorc

Le opzioni sono cumulative in quanto quelle caricate da $TODORC verranno sovrascritte o aggiunte da
quelli in ~/.todorc.

Queste opzioni sono specificate come coppie chiave/valore, una per riga La chiaveèil nome lungo di a
argomento della riga di comando e il valore è il parametro di tale argomento, se presente. Inoltre,
le variabili di ambiente vengono espanse.

Ad esempio, l'argomento della riga di comando --filter accetta un parametro che è un filtro
espressione. Un filtro predefinito potrebbe essere aggiunto al ~/.todorc file in questo modo:

# Non visualizzare gli elementi figlio per impostazione predefinita
filtro -bambini

L'unica differenza tra le opzioni specificate nel file rc e quelle sulla riga di comando
è che le opzioni nel file rc non sono precedute da --.

Inoltre, ci sono due comandi disponibili nel file RC che non sono disponibili sul
riga di comando. Loro sono:

Il primo comando, on, viene utilizzato per aggiungere comandi specifici in modo condizionale. Il formato di questo
il comando è: on [ ]. Gli eventi validi sono aggiungere, rimuovere, vista, edit,
generare, fatto, non fatto, titolo, rimproverare, caricare, salvare, link, creare e purga. multiplo
i comandi possono essere passati a on racchiudendoli tra parentesi graffe (è necessario uno spazio vuoto tra
gettoni). Esempio completo di seguito.

Il secondo comando è exec <conchiglia comando>. Questo comando eseguirà l'argomento che è
dato in un guscio. La variabile d'ambiente $TODODB contiene il nome del file della corrente
Banca dati. per esempio. exec chmod 600 $TODODB

C'è un file rc di esempio nella sottodirectory doc della distribuzione dei sorgenti.

ESEMPI

Per visualizzare eventuali elementi in sospeso nella directory corrente, digitare semplicemente:

todo

Per rimuovere le note 1, 2 e 4:

da fare --rimuovere 1,2,4

Per visualizzare TUTTI gli elementi:

fare tutto

Per visualizzare solo gli elementi di primo livello e non i loro figli:

cose da fare -bambini

(nonostante -bambini non è un argomento valido, funziona perché todo interpreta any
argomenti della riga di comando che non riconosce come parte di un'espressione di filtro)

Un esempio più complesso. Questo aggiunge un nuovo elemento, con il testo dell'elemento specificato sul
riga di comando, con priorità di alto come figlio del terzo figlio del secondo elemento (se
che ha senso):

todo -a "Correggi la pagina man" -p high -g 2.3

Questo è un esempio di come utilizzare la funzione TODO di todo. Fa sì che le cose generino un nuovo
TODO file dalle informazioni memorizzate nel database. Questo particolare esempio restituisce tutto
elementi nel file TODO, anche quelli contrassegnati come completati.

da fare --filtro tutto --TODO

Questo esempio mostra un buon uso dei trigger di evento. Quando viene creato un nuovo database,
forzerà le sue autorizzazioni a 0600.

su creare {
verboso
esegui chmod 600 .todo
}

Utilizzare tdd online utilizzando i servizi onworks.net