语法¶
丰富的语法可以用行号突出显示各种编程语言。
若要语法突出显示代码,请构造一个 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