signor - Online nel cloud

PROGRAMMA:

NOME

mr: uno strumento per gestire tutti i repository di controllo della versione

SINOSSI

mr [opzioni] pagamento

mr [opzioni] aggiornamento

mr stato [opzioni].

mr [opzioni] pulito [-f]

mr [opzioni] commit [-m "messaggio"]

mr [opzioni] registra [-m "messaggio"]

mr [opzioni] recuperare

mr [opzioni] premere

mr [opzioni] diff

mr [opzioni] registro

mr [opzioni] modello grep

mr [opzioni] esegui comando [param ...]

mr [opzioni] bootstrap src [directory]

mr [opzioni] registro [repository]

mr [opzioni] sezione di configurazione ["impostazione=[valore]" ...]

mr [opzioni] azione [parametri ...]

mr [opzioni] [online|offline]

mr [opzioni] ricorda l'azione [parametri ...]

DESCRIZIONE

mr è uno strumento per gestire tutti i repository di controllo della versione. Può effettuare il checkout, aggiornare o eseguire
altre azioni su un insieme di repository come se fossero un repository combinato. Esso
supporta qualsiasi combinazione di subversion, git, cvs, mercurial, bzr, darcs, fossil e
è possibile aggiungere facilmente repository di veridicità e supporto per altri sistemi di controllo della versione.

mr cd in e opera su tutti i repository registrati presso o sotto il tuo lavoro
directory. Oppure, se ti trovi in ​​una sottodirectory di un repository che non ne contiene altri
repository registrati, rimarrà in quella directory e funzionerà solo su quel repository,

mr è configurato dai file .mrconfig, che elencano i repository. Si comincia leggendo il
.mrconfig nella tua directory home e questo può a sua volta caricare a catena i file .mrconfig
dai repository. Inoltre cerca automaticamente un file .mrconfig nel file current
directory o in una delle sue directory principali.

Questi comandi predefiniti dovrebbero essere abbastanza familiari agli utenti di qualsiasi controllo di versione
sistema:

cassa (o co)
Estrae tutti i repository che non sono già stati estratti.

update
Aggiorna ciascun repository dal relativo repository remoto configurato.

Se un repository non è ancora stato estratto, verrà prima estratto.

status
Visualizza un rapporto sullo stato per ciascun repository, mostrando quali sono le modifiche non confermate
presente nel deposito. Per i sistemi di controllo della versione distribuiti, mostra anche
filiali locali non spinte.

cavedano
Stampa file ignorati, file non tracciati e altri errori nella directory di lavoro.

Il parametro opzionale -f consente di rimuovere i file e di stamparli.

commettere (o ci)
Applica le modifiche a ciascun repository. (Per impostazione predefinita, le modifiche vengono inviate al telecomando
repository, quando si utilizzano sistemi distribuiti come git. Se non ti piace questo
predefinito, puoi modificarlo nel tuo .mrconfig o utilizzare invece record.)

Il parametro facoltativo -m consente di specificare un messaggio di commit.

record
Registra le modifiche nel repository locale, ma non le invia al repository remoto
deposito. Supportato solo per i sistemi di controllo della versione distribuiti.

Il parametro facoltativo -m consente di specificare un messaggio di commit.

andare a prendere
Recupera dal repository remoto di ciascun repository, ma non aggiorna il funzionamento
copia. Supportato solo per alcuni sistemi di controllo della versione distribuiti.

spingere
Invia le modifiche locali impegnate al repository remoto. Un no-op per la centralizzazione
sistemi di controllo della versione.

diff
Mostra una differenza delle modifiche non confermate.

log Mostra il registro dei commit.

modello grep
Cerca un modello in ciascun repository utilizzando il sottocomando grep. Utilizza ack-grep on
VCS che non ne hanno uno proprio.

esegui il comando [parametro ...]
Esegue il comando specificato in ciascun repository.

Sono disponibili anche questi comandi:

bootstrap src [directory]
Fa sì che mr recuperi la sorgente "src" e la utilizzi come file .mrconfig per eseguire il checkout del file
repository elencati in esso, nella directory specificata.

mr comprende diversi tipi di fonti:

URL per l'arricciatura
"src" può essere un URL compreso da arricciare.

copia tramite ssh
Per utilizzare SCP per scaricare, "src" può avere la forma "ssh://[utente@]host:file".

file locale
Puoi recuperare il file di configurazione con altri mezzi e passarlo sentiero come "src".

input standard
Se la sorgente "src" consiste in un singolo trattino "-", il file di configurazione viene letto da standard
ingresso.

La directory verrà creata se non esiste. Se non viene specificata alcuna directory, il file
verrà utilizzata la directory corrente.

Come caso speciale, se la sorgente "src" include un repository denominato ".", questo viene selezionato
all'inizio della directory specificata.

elenco (o ls)
Elenca i repository su cui agirà mr.

registro
Registra un repository esistente in un file mrconfig. Per impostazione predefinita, il repository in
è registrata la directory corrente oppure è possibile specificare una directory da registrare.

Il file mrconfig che viene modificato viene scelto tramite l'opzione -c oppure cercando
per quello più vicino conosciuto in o in una directory principale della directory corrente.

config
Aggiunge, modifica, rimuove o stampa un valore da un file mrconfig. Il parametro successivo è
il nome della sezione in cui si trova il valore. Per aggiungere o modificare valori, utilizzarne uno o più
istanze di "impostazione=valore". Utilizzare "setting=" per rimuovere un'impostazione. Usa solo "impostazione"
per ottenere il valore di quell'impostazione.

Ad esempio, per aggiungere (o modificare) un repository in src/foo:

mr config src/foo checkout="svn co svn://example.com/foo/trunk foo"

Per mostrare il comando che mr utilizza per aggiornare il repository in src/foo:

aggiornamento del signor config src/foo

Per vedere la libreria integrata di funzioni di shell contenuta in mr:

mr config DEFAULT lib

Il file mrconfig utilizzato viene scelto tramite l'opzione -c oppure cercando
quello conosciuto più vicino in o in una directory principale della directory corrente.

offline
Avverte il signor che è in modalità offline. Tutti i comandi che falliscono in modalità offline lo saranno
ricordato e riprovato quando gli è stato detto che è online.

online
Avverte il signor che è di nuovo in modalità online. Comandi non riusciti in modalità offline
verrà rieseguito.

ricorda
Ricorda un comando, da eseguire in seguito quando mr rientra in modalità online. Questo implicitamente
mette il signor in modalità offline. Il comando può essere qualsiasi normale comando mr. Questo è utile
quando sai che un comando fallirà perché sei offline e quindi non vuoi eseguirlo
adesso, ma ricordati di eseguirlo quando torni online.

Aiuto
Visualizza questo aiuto.

Le azioni possono essere abbreviate in qualsiasi sottostringa non ambigua, quindi "mr st" è equivalente a "mr
status", e "mr up" equivale a "mr update"

Parametri aggiuntivi possono essere passati alla maggior parte dei comandi e vengono passati senza modifiche al file
sistema di controllo della versione sottostante. Ciò è utile soprattutto se i repository mr agiranno
su tutti utilizzano lo stesso sistema di controllo della versione.

VERSIONI

directory -d
--directory directory
Specifica la directory più in alto che mr dovrebbe funzionare. Il valore predefinito è current
directory di lavoro.

-c mrconfig
--config mrconfig
Utilizzare il file mrconfig specificato. L'impostazione predefinita prevede l'utilizzo di entrambi ~/.mrconfig così come
cerca un file .mrconfig file nella directory corrente o in una delle sue directory principali
directory.

-f
--vigore
Forza mr ad agire sui repository che normalmente verrebbero ignorati a causa della loro estensione
configurazione.

--force-env
Forza l'esecuzione di mr anche se sono impostate variabili di ambiente potenzialmente pericolose.

-v
--verboso
Sii prolisso.

-m
--minimo
Ridurre al minimo l'output. Se un comando fallisce o c'è qualche output, verrà visualizzato il solito output
essere mostrato.

-q
--silenzioso
Silenzio. Ciò sopprime il normale output di mr, così come qualsiasi output dei comandi that
vengono eseguiti (incluso l'output stderr). Se un comando fallisce, verrà mostrato l'output.

-k
--insicuro
Accetta certificati SSL non attendibili durante il bootstrap.

-s
--statistiche
Espandi la riga delle statistiche visualizzata alla fine per includere informazioni esatte
quali repository hanno avuto esito negativo e sono stati ignorati, se presenti.

-i
--interattivo
Modalità interattiva. Se un repository non riesce ad essere elaborato, verrà avviata una subshell
che è possibile utilizzare per risolvere o indagare sul problema. Uscire dalla subshell per continuare
il signor corre.

-n [numero]
--no-recurse [numero]
Se non viene specificato alcun numero, basta operare sul repository per la directory corrente,
non ricorrere a repository più profondi.

Se viene specificato un numero, ricorsiverà nei repository al massimo quel numero
sottodirectory profonde. Ad esempio, con -n 2 ricorsiverebbe in ./src/foo, ma non lo sarà
./src/packages/bar.

-j [numero]
--jobs [numero]
Esegui il numero specificato di lavori in parallelo o un numero illimitato di lavori con n
numero specificato. Ciò può velocizzare notevolmente operazioni come gli aggiornamenti. Non è
consigliato per operazioni interattive.

Tieni presente che è probabile che l'esecuzione di più di 10 lavori alla volta entri in conflitto con la connessione ssh
limiti. L'esecuzione da 3 a 5 lavori alla volta produrrà una buona accelerazione negli aggiornamenti
senza caricare troppo la macchina.

-t
--fidati di tutti
Considera attendibili tutti i file mrconfig anche se non sono elencati in ~/.mrtrust. Usare con cautela.

-p
--il percorso
Questo flag obsoleto viene ignorato.

MRCONFIG FILE

Qui trovi un esempio .mrconfig file:

[origine]
checkout = svn checkout svn://svn.example.com/src/trunk src
catena = vero

[src/linux-2.6]
checkout = git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git &&
cd linux-2.6 &&
git checkout -b origine/master del mio ramo

. .mrconfig il file utilizza una variante del formato file INI. Le righe che iniziano con "#" sono
Commenti. I valori possono continuare alla riga successiva rientrando la riga con
spazio bianco.

La sezione "DEFAULT" permette di impostare valori di default per le sezioni che la seguono.

La sezione "ALIAS" consente di aggiungere alias per le azioni. Ogni impostazione è un alias e il suo
valore è l'azione da utilizzare.

Tutte le altre sezioni aggiungono repository. L'intestazione della sezione specifica la directory in cui si trova il file
si trova il deposito. Questo è relativo alla directory che contiene il file mrconfig,
ma puoi anche scegliere di utilizzare percorsi assoluti. (Nota che puoi usare l'ambiente
variabili nei nomi delle sezioni; verranno fatti passare attraverso il guscio per l'espansione. Per
esempio, "[$HOSTNAME]" o "[${HOSTNAME}foo]").

All'interno di una sezione, ciascuna impostazione definisce un comando shell da eseguire per gestire una determinata azione. Sig
contiene gestori predefiniti per "aggiornamento", "stato", "commit" e altre azioni standard.

Normalmente è sufficiente specificare cosa fare in fase di "checkout". Qui specifichi il comando
da eseguire per creare un checkout del repository. Il comando verrà eseguito nel file
directory padre e deve creare la directory del repository. Quindi usa "git clone", "svn
checkout", "bzr branch" o "bzr checkout" (per un ramo associato), ecc.

Tieni presente che questi comandi shell vengono eseguiti in un ambiente shell "set -e", dove any
i parametri aggiuntivi passati sono disponibili in $@. Tutti i comandi diversi da "checkout" lo sono
eseguito all'interno del repository, anche se non necessariamente nella parte superiore di esso.

La variabile di ambiente "MR_REPO" è impostata sul percorso all'inizio del repository. (Per
l'azione "registra", "MR_REPO" è invece impostata sul nome base della directory che
dovrebbe essere creato durante il check-out del repository.)

La variabile di ambiente "MR_CONFIG" è impostata sul file .mrconfig che definisce il repository
su cui si sta effettuando un'azione o, se il repository non è ancora in un file di configurazione, il file .mrconfig archiviarlo
dovrebbe essere modificato per registrare il repository.

La variabile d'ambiente "MR_ACTION" è impostata sul comando da eseguire (aggiornamento, checkout,
ecc).

Alcune impostazioni hanno significati speciali:

Salta
Se è impostato "skip" e il suo comando restituisce true, allora mr salterà l'azione su questo
deposito. Al comando viene passato il nome dell'azione in $1.

Ecco due esempi. Il primo salta il repository a meno che mr non sia gestito da Joey. Il secondo
utilizza la funzione hour_since (inclusa nella libreria integrata di mr) per saltare l'aggiornamento del file
repository a meno che non siano trascorse almeno 12 ore dall'ultimo aggiornamento.

[la mia roba]
cassa =...
salta = prova `whoami`! = joey

[Linux]
cassa =...
salta = ["$1" = aggiorna] &&! ore_da "$1" 12

Un altro modo di utilizzare skip è per un checkout lento. Ciò fa sì che il signor salti l'operazione su un pronti contro termine
a meno che non esista già. Per abilitare il repository, devi verificarlo esplicitamente
(usando "mr --force -d foo checkout").

[pippo]
cassa =...
saltare = pigro

minimo
L'impostazione "ordine" può essere utilizzata per sovrascrivere l'ordinamento predefinito dei repository. IL
il valore dell'ordine predefinito è 10. Utilizzare valori più piccoli per consentire l'elaborazione dei repository
prima e valori più grandi per far sì che i repository vengano elaborati in un secondo momento.

Tieni presente che se un repository si trova in una sottodirectory di un altro repository, ordering
non è consigliabile elaborarlo prima.

catena
Se "catena" è impostato e il suo comando restituisce true, allora mr proverò a caricare a .mrconfig
file dalla radice del repository.

includere
Se è impostato "include", il relativo comando viene eseguito e dovrebbe generare un file mrconfig aggiuntivo
contenuto. Il contenuto viene incluso come se fosse parte del file incluso.

A differenza di tutto il resto, non è necessario che "include" sia inserito all'interno di una sezione.

mr fornisce diverse librerie che possono essere incluse per aggiungere il supporto per versioni aggiuntive
tipo di controllo cose (unison, git-svn, git-fake-bare, git-subtree). Per includerli
tutto, potresti usare:

include = cat /usr/share/mr/*

Per i dettagli vedere i singoli file.

cancellato
Se è impostato "deleted" e il suo comando restituisce true, allora mr tratterà il repository come
cancellato. In realtà non eliminerà mai il repository, ma avviserà se vede il file
directory del repository. Ciò è utile quando un file mrconfig è condiviso tra
più macchine, per tenere traccia e ricordarsi di eliminare i vecchi repository.

lib L'impostazione "lib" può contenere del codice shell che verrà eseguito prima di ciascun comando,
questo può essere un modo utile per definire le funzioni della shell da utilizzare per altri comandi.

A differenza della maggior parte delle altre impostazioni, questa può essere specificata più volte, nel qual caso il file
pezzi di codice shell vengono concatenati insieme in modo cumulativo.

aggiustamenti
Se è impostato "fixups", il suo comando viene eseguito ogni volta che viene estratto un repository, oppure
aggiornato. Ciò fornisce un modo semplice per eseguire operazioni come la correzione delle autorizzazioni o altro
modifiche al contenuto del repository, ogni volta che il repository viene modificato.

posti di lavoro
Se è impostato "lavori", esegue il numero specificato di lavori in parallelo. Questo può notevolmente
velocizzare operazioni come gli aggiornamenti.

Tieni presente che è probabile che l'esecuzione di più di 10 lavori alla volta entri in conflitto con la connessione ssh
limiti. L'esecuzione da 3 a 5 lavori alla volta produrrà una buona accelerazione negli aggiornamenti
senza caricare troppo la macchina.

VCS_azione
Quando si cerca un comando da eseguire per una determinata azione, mr cerca prima un'impostazione
con lo stesso nome dell'azione. Se non viene trovato, cerca un'impostazione denominata
"VCS_action" (sostituendo il nome del sistema di controllo della versione e l'azione).

Internamente, mr ha le impostazioni per "git_update", "svn_update", ecc. Per modificare l'azione
che viene eseguito per un dato sistema di controllo della versione, è possibile sovrascrivere questi VCS
azioni specifiche. Per aggiungere un nuovo sistema di controllo della versione, puoi semplicemente aggiungere VCS specifico
azioni per esso.

pre_ e post_
Se è impostato "pre_action", il suo comando viene eseguito prima che mr esegua l'azione specificata.
Allo stesso modo, i comandi "post_action" vengono eseguiti dopo che mr ha eseguito con successo il comando specificato
azione. Ad esempio, "pre_commit" viene eseguito prima del commit; "post_update" viene eseguito dopo
in aggiornamento.

_aggiungere
A qualsiasi impostazione può essere aggiunto il suffisso "_append", per aggiungere un valore aggiuntivo a quello esistente
valore dell'impostazione. In questo modo le azioni possono essere costruite in modo cumulativo.

VCS_prova
Il nome del sistema di controllo della versione viene determinato eseguendo ciascun file definito
Azione "VCS_test", finché non si riesce.

NON AFFIDABILE MRCONFIG FILE

Poiché i file mrconfig possono contenere comandi shell arbitrari, possono fare qualsiasi cosa. Questo
la flessibilità è buona, ma consente anche a un file mrconfig dannoso di eliminare l'intero file
directory principale. Tale file potrebbe essere contenuto all'interno di un repository che il tuo file main
~/.mrconfig controlla. Per evitare preoccupazioni sui comandi dannosi in un file mrconfig, mr
per impostazione predefinita legge tutti i file mrconfig diversi da quello principale ~/.mrconfig in modalità non attendibile.
In modalità non attendibile, i file mrconfig sono limitati all'esecuzione solo di comandi sicuri noti (come
"git clone") in modo attentamente controllato.

Per configurare mr in modo che consideri attendibili altri file mrconfig, elencarli in ~/.mrtrust. Un file mrconfig
dovrebbero essere elencati per riga. Dovrebbe essere elencato il percorso completo oppure il nome del percorso sì
iniziare con ~/ per specificare un file relativo alla tua home directory.

DISCONNESSO LOG RISORSE

. ~/.mrlog il file contiene comandi che il signor si è ricordato di eseguire in seguito, poiché essendo
disconnesso. Puoi eliminare o modificare questo file per rimuovere comandi o anche per aggiungerne altri
comandi per l'esecuzione di "mr online". Se il file è presente, mr presuppone che sia in modalità offline.

ESTENSIONI

mr può essere esteso per supportare cose come unison e git-svn. Alcuni file che forniscono tale
le estensioni sono disponibili in /usr/condividi/signor/. Per i dettagli vedere la documentazione nei file
sul loro utilizzo.

EXIT STATUS

mr restituisce un valore diverso da zero se un comando non è riuscito in uno qualsiasi dei repository.

Utilizza mr online utilizzando i servizi onworks.net