语法

丰富的语法可以用行号突出显示各种编程语言。

若要语法突出显示代码,请构造一个 Syntax 对象并将其打印到控制台。以下是一个示例:

from rich.console import Console
from rich.syntax import Syntax

console = Console()
with open("syntax.py", "rt") as code_file:
    syntax = Syntax(code_file.read(), "python")
console.print(syntax)

您也可以使用 from_path() 替代构造函数,它将从磁盘加载代码并自动检测文件类型。上面的例子可以重写如下:

from rich.console import Console
from rich.syntax import Syntax

console = Console()
syntax = Syntax.from_path("syntax.py")
console.print(syntax)

行号

如果您设置为 line_numbers=True ,Rich将呈现行号列::

syntax = Syntax.from_path("syntax.py", line_numbers=True)

主旋律

语法构造函数(和 from_path() )接受一个 theme 属性,该属性应该是 Pygments theme 。它也可以是将使用由终端配置的颜色主题的特例主题名称“ansi_Dark”或“ansi_light”之一。

背景色

您可以通过提供一个 background_color 参数传递给构造函数。这应该是样式定义接受的相同格式的字符串,例如“red”、“#ff0000”、“rgb(255,0,0)”等。您还可以设置特殊的值“Default”,它将使用终端中设置的默认背景颜色。

语法CLI

您可以从命令行使用此类。下面是突出显示名为“synax.py”的文件的语法::

python -m rich.syntax syntax.py

有关参数的完整列表,请运行以下命令:

python -m rich.syntax -h