Ho un file batch che esegue diversi script Python che apportano modifiche alla tabella.

1. Voglio che gli utenti commentino gli script 1-2 di Python che non vogliono eseguire, piuttosto che rimuoverli dal file batch (quindi il prossimo utente sa che questi script esistono come opzioni!)

2. Voglio anche aggiungere commenti per portare alla loro attenzione in particolare le variabili che devono aggiornare nel file Batch prima di eseguirlo. Vedo che posso usare REM. Ma sembra che sia più per aggiornare l'utente con i progressi dopo averlo eseguito.

Esiste una sintassi per aggiungere in modo più appropriato un commento?

Il remcomando è davvero per i commenti. Non aggiorna intrinsecamente nessuno dopo aver eseguito lo script. Alcuni autori di script potrebbero usarlo in questo modo invece che echo, perché, per impostazione predefinita, l'interprete batch stamperà ogni comando prima che venga elaborato. Poiché i remcomandi non fanno nulla, è sicuro stamparli senza effetti collaterali. Per evitare di stampare un comando, aggiungilo come prefisso @o, per applicare tale impostazione in tutto il programma, esegui @echo off. (È echo offper evitare di stampare ulteriori comandi; @è per evitare di stampare quel comando prima che le impostazioni dell'eco abbiano effetto.)

Quindi, nel tuo file batch, potresti usare questo:

@echo off
REM To skip the following Python commands, put "REM" before them:
python foo.py
python bar.py

Usa ::oREM

::   commenttttttttttt
REM  commenttttttttttt

MA (come notato dalla gente):

• Se si utilizza in linea, è necessario aggiungere &carattere:
  your commands here & :: commenttttttttttt
• All'interno della logica nidificata ( IF/ELSE, FORloop, ecc ...) utilizzare REMperché ::genera un errore.
• :: potrebbe non riuscire entro setlocal ENABLEDELAYEDEXPANSION

No, i semplici file batch vecchi usano REMcome commento. ECHOè il comando che stampa qualcosa sullo schermo.

Per "commentare" sezioni del file che è possibile utilizzare GOTO. Un esempio di tutti questi comandi / tecniche:

REM it starts here the section below can be safely erased once the file is customised
ECHO Hey you need to edit this file before running it!  Check the instructions inside
ECHO Now press ctrl-c to interrupt execution or enter to continue
PAUSE
REM erase the section above once you have customised the file
python executed1.py
ECHO Skipping some stuff now
GOTO End
python skipped1.py
python skipped2.py
:END
python executed2.py

Cosa posso dire? i file batch sono una reliquia dei tempi andati, sono goffi e brutti.

Puoi leggere di più su questo sito web .

EDIT: modificato un po 'l'esempio per farlo contenere gli elementi che apparentemente stai cercando.

Il :: anziché il REM era preferibilmente usato ai tempi in cui i computer non erano molto veloci. La riga REM viene letta e quindi ignorata. :: 'ed line sono ignorati fino in fondo. Ciò potrebbe velocizzare il tuo codice nei "vecchi tempi". Ancora di più dopo un REM hai bisogno di uno spazio, dopo :: non lo fai.

E come detto nel primo commento: puoi aggiungere informazioni a qualsiasi linea che ritieni necessaria

SET DATETIME=%DTS:~0,8%-%DTS:~8,6% ::Makes YYYYMMDD-HHMMSS

Per quanto riguarda il salto delle parti. Mettere REM davanti a ogni linea può richiedere piuttosto tempo. Come accennato, usare GOTO per saltare le parti è un modo semplice per saltare grandi quantità di codice. Assicurati di impostare a: LABEL nel punto in cui desideri che il codice continui.

SOME CODE

GOTO LABEL  ::REM OUT THIS LINE TO EXECUTE THE CODE BETWEEN THIS GOTO AND :LABEL

SOME CODE TO SKIP
.
LAST LINE OF CODE TO SKIP

:LABEL
CODE TO EXECUTE

Commenti su più righe

Se ci sono un gran numero di righe che vuoi commentare, sarà meglio se puoi fare commenti su più righe piuttosto che commentare ogni riga.

Vedi questo post di Rob van der Woude sui blocchi di commenti :

Il linguaggio batch non ha blocchi di commenti, anche se ci sono modi per ottenere l'effetto.

GOTO EndComment1
This line is comment.
And so is this line.
And this one...
:EndComment1

Puoi usare GOTOEtichetta e: Etichetta per fare commenti a blocchi.

Oppure, se il blocco dei commenti appare alla fine del file batch, è possibile scrivere EXITalla fine del codice e quindi un numero qualsiasi di commenti per la comprensione.

@ECHO OFF
REM Do something
  •
  •
REM End of code; use GOTO:EOF instead of EXIT for Windows NT and later
EXIT

Start of comment block at end of batch file
This line is comment.
And so is this line.
And this one...

Inserimento di commenti sulla stessa riga con i comandi: utilizzare & :: comment

color C          & :: set red font color
echo IMPORTANT INFORMATION
color            & :: reset the color to default

Spiegazione:

&separa due comandi , quindi in questo caso color Cè il primo comando ed :: set red font colorè il secondo.

Importante:

Questa affermazione con commento sembra intuitivamente corretta:

goto error1         :: handling the error

ma non è un uso valido del commento. Funziona solo perché gotoignora tutti gli argomenti oltre il primo. La prova è semplice, anche questo gotonon fallirà:

goto error1 handling the error

Ma un tentativo simile

color 17            :: grey on blue

fallisce l'esecuzione del comando a causa di 4 argomenti sconosciuti al colorcomando: ::, grey, on, blue.

Funzionerà solo come:

color 17     &      :: grey on blue

Quindi la e commerciale è inevitabile.

Puoi commentare qualcosa usando ::o REM:

your commands here
:: commenttttttttttt

o

your commands here
REM  commenttttttttttt

Per farlo sulla stessa riga di un comando, è necessario aggiungere una e commerciale:

your commands here      & ::  commenttttttttttt

o

your commands here      & REM  commenttttttttttt

Nota:

• L'uso :: nella logica nidificata ( IF-ELSE, FORloop, ecc ...) provocherà un errore. In questi casi, utilizzare REMinvece.

Questo è un vecchio argomento e vorrei aggiungere la mia comprensione qui per espandere la conoscenza di questo argomento interessante.

La differenza chiave tra REM e :: è:

REM è un comando stesso, mentre :: NON è.

Possiamo considerare :: come token che non appena il parser CMD incontra il primo spazio non vuoto in una riga è questo :: token, salterà semplicemente l'intera riga e leggerà la riga successiva. Ecco perché REM dovrebbe essere seguito da almeno uno spazio vuoto per poter funzionare come un commento per la linea, mentre :: non ha bisogno di spazi vuoti dietro di esso.

Che REM sia un comando stesso può essere meglio compreso dalla seguente sintassi FOR

La sintassi FOR di base è la seguente

FOR %v in (set) DO <Command> [command param] 

qui <Command>può esserci qualsiasi comando valido Quindi possiamo scrivere la seguente riga di comando valida come remè un comando

FOR %i in (1,2,3) DO rem echo %i

Tuttavia, NON POSSIAMO scrivere la riga seguente in quanto ::non è un comando

FOR %i in (1,2,3) DO :: echo %i

È possibile aggiungere commenti alla fine di un file batch con questa sintassi:

@echo off
:: Start of code
...
:: End of code

(I am a comment
So I am!
This can be only at the end of batch files

Assicurati solo di non usare mai una parentesi chiusa.

Attribuzioni: Leo Guttirez Ramirez su https://www.robvanderwoude.com/comments.php