fill-paragraph – Haga el párrafo de relleno en la cadena de documentos de Python, deje las comillas triples en una línea separada

Pregunta:

Escribo una cadena de documentos de Python en una línea como esta:

"""
This is a long docstring. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec a diam lectus. Sed sit amet ipsum mauris. Maecenas congue ligula ac quam viverra nec consectetur ante hendrerit. Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean ut gravida lorem. Ut turpis felis, pulvinar a semper sed, adipiscing id dolor. Pellentesque auctor nisi id magna consequat sagittis.
"""

y luego presiono Mq ( fill-paragraph ), y obtengo esto:

"""This is a long docstring. Lorem ipsum dolor sit amet, consectetur
adipiscing elit. Donec a diam lectus. Sed sit amet ipsum
mauris. Maecenas congue ligula ac quam viverra nec consectetur ante
hendrerit. Donec et mollis dolor. Praesent et diam eget libero egestas
mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem
lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non
tortor. Lorem ipsum dolor sit amet, consectetur adipiscing
elit. Aenean ut gravida lorem. Ut turpis felis, pulvinar a semper sed,
adipiscing id dolor. Pellentesque auctor nisi id magna consequat
sagittis.

"""

Tengo dos problemas con esto:

  1. La cadena de documentos comienza en la misma línea que """ . Preferiría que las comillas triples permanezcan en su propia línea.
  2. (Prioridad mucho más baja). La cadena de documentos termina con una línea en blanco.

El ejemplo anterior es artificial, pero me encuentro con esto con frecuencia, especialmente cuando edito cadenas de documentos existentes en las que me gustaría simplemente Mq y hacer que todo el párrafo vuelva a fluir.

Respuesta:

Personalice python-fill-docstring-style consecuencia, asumiendo que está utilizando el modo Python incorporado en Emacs 24.4. El valor predeterminado es pep-257 , que conduce al estilo que observó, es decir, sin nueva línea al principio y dos nuevas líneas antes del final de una cadena de documentos.

Cambie esta variable a symmetric o django para que el modo Python obedezca su estilo preferido, es decir, una nueva línea al principio de la cadena de documentos y una nueva línea antes del final:

(setq python-fill-docstring-style 'django)

Alternativamente, configúrelo a través de Variables de directorio , para configurar el estilo de la cadena de documentos individualmente por proyecto.

symmetric y django son cadenas de documentos de una sola línea de wrt diferentes. El primero coloca las comillas triples en la misma línea si una cadena de documentos cabe en una línea, mientras que el segundo coloca las comillas triples en líneas separadas en este caso.

Eche un vistazo a la cadena de documentos de python-fill-docstring-style para ver todas las opciones disponibles.

Leave a Comment

Your email address will not be published.

Scroll to Top

istanbul avukat

-

web tasarım