Tengo un archivo por lotes que ejecuta varios scripts de Python que realizan modificaciones en la tabla.

1. Quiero que los usuarios comenten los scripts de Python 1-2 que no quieren ejecutar, en lugar de eliminarlos del archivo por lotes (¡para que el siguiente usuario sepa que estos scripts existen como opciones!)

2. También quiero agregar comentarios para llamar su atención específicamente sobre las variables que necesitan actualizar en el archivo Batch antes de ejecutarlo. Veo que puedo usar REM. Pero parece que eso es más para actualizar al usuario con progreso después de que lo haya ejecutado.

¿Existe una sintaxis para agregar un comentario más apropiadamente?

El remcomando es de hecho para comentarios. No actualiza inherentemente a nadie después de ejecutar el script. Sin echoembargo, algunos autores de scripts pueden usarlo de esa manera en lugar de hacerlo , porque de forma predeterminada el intérprete por lotes imprimirá cada comando antes de procesarlo. Como los remcomandos no hacen nada, es seguro imprimirlos sin efectos secundarios. Para evitar imprimir un comando, agregue el prefijo @o, para aplicar esa configuración en todo el programa, ejecute @echo off. (Es echo offpara evitar imprimir más comandos; @es para evitar imprimir ese comando antes de que la configuración de eco tenga efecto).

Entonces, en su archivo por lotes, puede usar esto:

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

Use ::oREM

::   commenttttttttttt
REM  commenttttttttttt

PERO (como la gente señaló):

• Si usa en línea, debe agregar un &carácter:
  your commands here & :: commenttttttttttt
• Dentro de la lógica anidada ( IF/ELSE, FORbucles, etc.) se usa REMporque ::da un error.
• :: puede fallar dentro setlocal ENABLEDELAYEDEXPANSION

No, los archivos por lotes antiguos simples se usan REMcomo comentario. ECHOes el comando que imprime algo en la pantalla.

Para "comentar" secciones del archivo que podría usar GOTO. Un ejemplo de todos estos comandos / técnicas:

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

¿Qué puedo decir? Los archivos por lotes son una reliquia de tiempos pasados, son torpes y feos.

Puedes leer más en este sitio web .

EDITAR: modificó un poco el ejemplo para que contenga los elementos que aparentemente está buscando.

El :: en lugar de REM se usaba preferiblemente en los días en que las computadoras no eran muy rápidas. La línea REM'ed se lee y luego se ignora. :: 'línea ed se ignoran todo el camino. Esto podría acelerar su código en "los viejos tiempos". Además, después de un REM necesitas un espacio, después de :: no lo necesitas.

Y como se dijo en el primer comentario: puede agregar información a cualquier línea que sienta la necesidad de

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

En cuanto al salto de piezas. Poner REM delante de cada línea puede llevar bastante tiempo. Como se mencionó, usar GOTO para omitir partes es una manera fácil de omitir grandes piezas de código. Asegúrese de establecer un: LABEL en el punto donde desea que continúe el código.

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

Comentarios de varias líneas

Si hay un gran número de líneas que desea comentar, será mejor si puede hacer comentarios de varias líneas en lugar de comentar cada línea.

Vea esta publicación de Rob van der Woude en bloques de comentarios :

El lenguaje por lotes no tiene bloques de comentarios, aunque hay formas de lograr el efecto.

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

Puede usar GOTOLabel y: Label para hacer comentarios de bloque.

O bien, si el bloque de comentarios aparece al final del archivo por lotes, puede escribir EXITal final del código y luego cualquier número de comentarios para su comprensión.

@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...

Poner comentarios en la misma línea con los comandos: use & :: comment

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

Explicación:

&separa dos comandos , por lo que en este caso color Ces el primer comando y :: set red font colores el segundo.

Importante:

Esta declaración con comentario parece intuitivamente correcta:

goto error1         :: handling the error

pero no es un uso válido del comentario. Funciona solo porque gotoignora todos los argumentos más allá del primero. La prueba es fácil, esto gototampoco fallará:

goto error1 handling the error

Pero intento similar

color 17            :: grey on blue

falla la ejecución del comando debido a 4 argumentos desconocidos para el colorcomando: ::, grey, on, blue.

Solo funcionará como:

color 17     &      :: grey on blue

Entonces, el signo y es inevitable.

Puedes comentar algo usando ::o REM:

your commands here
:: commenttttttttttt

o

your commands here
REM  commenttttttttttt

Para hacerlo en la misma línea que un comando, debe agregar un ampersand:

your commands here      & ::  commenttttttttttt

o

your commands here      & REM  commenttttttttttt

Nota:

• Usar :: en lógica anidada ( IF-ELSE, FORbucles, etc.) causará un error. En esos casos, use REMen su lugar.

Este es un tema antiguo y me gustaría agregar mi comprensión aquí para ampliar el conocimiento de este interesante tema.

La diferencia clave entre REM y :: es:

REM es un comando en sí mismo, mientras que :: NO lo es.

Podemos tratar :: como un token que tan pronto como el analizador CMD encuentre el primer espacio no en blanco en una línea es este :: token, simplemente saltará toda la línea y leerá la siguiente línea. Es por eso que REM debe ir seguido de al menos un espacio en blanco para poder funcionar como un comentario para la línea, mientras que :: no necesita ningún espacio en blanco detrás de ella.

Que REM es un comando en sí mismo puede entenderse mejor a partir de la siguiente sintaxis FOR

La sintaxis básica de FOR es la siguiente

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

aquí <Command>puede haber cualquier comando válido Para que podamos escribir la siguiente línea de comando válida como remes un comando

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

Sin embargo, NO PODEMOS escribir la siguiente línea ya ::que no es un comando

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

Puede agregar comentarios al final de un archivo por lotes con esta sintaxis:

@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

Solo asegúrate de nunca usar paréntesis de cierre.

Atribuciones: Leo Guttirez Ramirez en https://www.robvanderwoude.com/comments.php