reuse.comment module¶

Module for parsing and creating comments. Just enough to deal with comment headers, in any case.

exception reuse.comment.CommentParseError[source]¶

Bases: Exception

An error occurred during the parsing of a comment.

exception reuse.comment.CommentCreateError[source]¶

Bases: Exception

An error occurred during the creation of a comment.

class reuse.comment.MultiLineSegments(start: str, middle: str, end: str)[source]¶

Bases: tuple

Components that make up a multi-line comment style, e.g. ‘/’, ‘’, and ‘*/’.

start: str¶: Alias for field number 0

middle: str¶: Alias for field number 1

end: str¶: Alias for field number 2

class reuse.comment.CommentStyle[source]¶

Bases: object

Base class for comment style.

SHORTHAND = ''¶

SINGLE_LINE = ''¶

SINGLE_LINE_REGEXP: Pattern | None = None¶

INDENT_AFTER_SINGLE = ''¶

MULTI_LINE = MultiLineSegments(start='', middle='', end='')¶

INDENT_BEFORE_MIDDLE = ''¶

INDENT_AFTER_MIDDLE = ''¶

INDENT_BEFORE_END = ''¶

SHEBANGS: List[str] = []¶

classmethod can_handle_single() → bool[source]¶: Whether the CommentStyle can handle single-line comments.

classmethod can_handle_multi() → bool[source]¶: Whether the CommentStyle can handle multi-line comments.

classmethod create_comment(text: str, force_multi: bool = False) → str[source]¶

Comment all lines in text. Single-line comments are preferred over multi-line comments, unless force_multi is provided.

Raises:: CommentCreateError – if text could not be commented.

classmethod parse_comment(text: str) → str[source]¶

Uncomment all lines in text.

Raises:: CommentParseError – if text could not be parsed.

classmethod comment_at_first_character(text: str) → str[source]¶

Return the comment block that starts at the first character of text. This is chiefly handy to get the header comment of a file, assuming that the header comment starts at the first character in the file.

Raises:: CommentParseError – if text does not start with a parseable comment block.

class reuse.comment.AppleScriptCommentStyle[source]¶

Bases: CommentStyle

AppleScript comment style.

SHORTHAND = 'applescript'¶

SINGLE_LINE = '--'¶

INDENT_AFTER_SINGLE = ' '¶

MULTI_LINE = MultiLineSegments(start='(*', middle='', end='*)')¶

class reuse.comment.AspxCommentStyle[source]¶

Bases: CommentStyle

ASPX comment style.

SHORTHAND = 'aspx'¶

MULTI_LINE = MultiLineSegments(start='<%--', middle='', end='--%>')¶

class reuse.comment.BatchFileCommentStyle[source]¶

Bases: CommentStyle

Windows batch file comment style.

SHORTHAND = 'bat'¶

SINGLE_LINE = 'REM'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.BibTexCommentStyle[source]¶

Bases: CommentStyle

BibTex comment style.

SHORTHAND = 'bibtex'¶

MULTI_LINE = MultiLineSegments(start='@Comment{', middle='', end='}')¶

SHEBANGS: List[str] = ['% !BIB', '%!BIB']¶

class reuse.comment.CCommentStyle[source]¶

Bases: CommentStyle

C comment style.

SHORTHAND = 'c'¶

MULTI_LINE = MultiLineSegments(start='/*', middle='*', end='*/')¶

INDENT_BEFORE_MIDDLE = ' '¶

INDENT_AFTER_MIDDLE = ' '¶

INDENT_BEFORE_END = ' '¶

class reuse.comment.CppCommentStyle[source]¶

Bases: CommentStyle

C++ comment style.

SHORTHAND = 'cpp'¶

SINGLE_LINE = '//'¶

INDENT_AFTER_SINGLE = ' '¶

MULTI_LINE = MultiLineSegments(start='/*', middle='*', end='*/')¶

INDENT_BEFORE_MIDDLE = ' '¶

INDENT_AFTER_MIDDLE = ' '¶

INDENT_BEFORE_END = ' '¶

SHEBANGS: List[str] = ['#!', '<?php']¶

class reuse.comment.CppSingleCommentStyle[source]¶

Bases: CommentStyle

C++ single-only comment style.

SHORTHAND = 'cppsingle'¶

SINGLE_LINE = '//'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.EmptyCommentStyle[source]¶

Bases: CommentStyle

Hacky comment style for files that have no comments.

classmethod create_comment(text: str, force_multi: bool = False) → str[source]¶

Comment all lines in text. Single-line comments are preferred over multi-line comments, unless force_multi is provided.

Raises:: CommentCreateError – if text could not be commented.

classmethod parse_comment(text: str) → str[source]¶

Uncomment all lines in text.

Raises:: CommentParseError – if text could not be parsed.

classmethod comment_at_first_character(text: str) → str[source]¶

Raises:: CommentParseError – if text does not start with a parseable comment block.

class reuse.comment.FortranCommentStyle[source]¶

Bases: CommentStyle

Fortran (fixed form) comment style.

SHORTHAND = 'f'¶

SINGLE_LINE = 'c'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.ModernFortranCommentStyle[source]¶

Bases: CommentStyle

Fortran (free form) comment style.

SHORTHAND = 'f90'¶

SINGLE_LINE = '!'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.FtlCommentStyle[source]¶

Bases: CommentStyle

FreeMarker Template Language comment style.

SHORTHAND = 'ftl'¶

MULTI_LINE = MultiLineSegments(start='<#--', middle='', end='-->')¶

class reuse.comment.HandlebarsCommentStyle[source]¶

Bases: CommentStyle

Handlebars comment style.

SHORTHAND = 'handlebars'¶

MULTI_LINE = MultiLineSegments(start='{{!--', middle='', end='--}}')¶

class reuse.comment.HaskellCommentStyle[source]¶

Bases: CommentStyle

Haskell comment style.

SHORTHAND = 'haskell'¶

SINGLE_LINE = '--'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.HtmlCommentStyle[source]¶

Bases: CommentStyle

HTML comment style.

SHORTHAND = 'html'¶

MULTI_LINE = MultiLineSegments(start='')¶

SHEBANGS: List[str] = ['<?xml']¶

class reuse.comment.JinjaCommentStyle[source]¶

Bases: CommentStyle

Jinja2 comment style.

SHORTHAND = 'jinja'¶

MULTI_LINE = MultiLineSegments(start='{#', middle='', end='#}')¶

class reuse.comment.JuliaCommentStyle[source]¶

Bases: CommentStyle

Julia comment style.

SHORTHAND = 'julia'¶

SINGLE_LINE = '#'¶

INDENT_AFTER_SINGLE = ' '¶

MULTI_LINE = MultiLineSegments(start='#=', middle='', end='=#')¶

SHEBANGS: List[str] = ['#!']¶

class reuse.comment.LispCommentStyle[source]¶

Bases: CommentStyle

Lisp comment style.

SHORTHAND = 'lisp'¶

SINGLE_LINE = ';;;'¶

SINGLE_LINE_REGEXP: Pattern | None = re.compile('^;+\\s*')¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.M4CommentStyle[source]¶

Bases: CommentStyle

M4 (autoconf) comment style.

SHORTHAND = 'm4'¶

SINGLE_LINE = 'dnl'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.MlCommentStyle[source]¶

Bases: CommentStyle

ML comment style.

SHORTHAND = 'ml'¶

MULTI_LINE = MultiLineSegments(start='(*', middle='*', end='*)')¶

INDENT_BEFORE_MIDDLE = ' '¶

INDENT_AFTER_MIDDLE = ' '¶

INDENT_BEFORE_END = ' '¶

class reuse.comment.PlantUmlCommentStyle[source]¶

Bases: CommentStyle

PlantUML comment style.

SHORTHAND = 'plantuml'¶

SINGLE_LINE = "'"¶

INDENT_AFTER_SINGLE = ' '¶

MULTI_LINE = MultiLineSegments(start="/'", middle="'", end="'/")¶

INDENT_BEFORE_MIDDLE = ' '¶

INDENT_AFTER_MIDDLE = ' '¶

INDENT_BEFORE_END = ' '¶

class reuse.comment.PythonCommentStyle[source]¶

Bases: CommentStyle

Python comment style.

SHORTHAND = 'python'¶

SINGLE_LINE = '#'¶

INDENT_AFTER_SINGLE = ' '¶

SHEBANGS: List[str] = ['#!']¶

class reuse.comment.ReStructedTextCommentStyle[source]¶

Bases: CommentStyle

reStructuredText comment style.

SHORTHAND = 'rst'¶

SINGLE_LINE = '..'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.SemicolonCommentStyle[source]¶

Bases: CommentStyle

Semicolon comment style.

SHORTHAND = 'semicolon'¶

SINGLE_LINE = ';'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.TexCommentStyle[source]¶

Bases: CommentStyle

TeX comment style.

SHORTHAND = 'tex'¶

SINGLE_LINE = '%'¶

INDENT_AFTER_SINGLE = ' '¶

SHEBANGS: List[str] = ['% !TEX', '%!TEX']¶

class reuse.comment.UncommentableCommentStyle[source]¶

Bases: EmptyCommentStyle

A pseudo comment style to indicate that this file is uncommentable. This results in an external .license file for binaries and –force-dot-license.

class reuse.comment.UnixManCommentStyle[source]¶

Bases: CommentStyle

UNIX manual page comment style.

SHORTHAND = 'man'¶

SINGLE_LINE = '.\\"'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.VelocityCommentStyle[source]¶

Bases: CommentStyle

Apache Velocity Template Language comment style.

SHORTHAND = 'vst'¶

MULTI_LINE = MultiLineSegments(start='#*', middle=' ', end='*#')¶

class reuse.comment.VimCommentStyle[source]¶

Bases: CommentStyle

Vim(Script|Config) style.

SHORTHAND = 'vim'¶

SINGLE_LINE = '"'¶

INDENT_AFTER_SINGLE = ' '¶

class reuse.comment.XQueryCommentStyle[source]¶

Bases: CommentStyle

XQuery comment style.

SHORTHAND = 'xquery'¶

MULTI_LINE = MultiLineSegments(start='(:', middle=':', end=':)')¶

INDENT_BEFORE_MIDDLE = ' '¶

INDENT_AFTER_MIDDLE = ' '¶

INDENT_BEFORE_END = ' '¶

reuse.comment.EXTENSION_COMMENT_STYLE_MAP = {'.R': <class 'reuse.comment.PythonCommentStyle'>, '.Rmd': <class 'reuse.comment.HtmlCommentStyle'>, '.adb': <class 'reuse.comment.HaskellCommentStyle'>, '.adoc': <class 'reuse.comment.CppCommentStyle'>, '.ads': <class 'reuse.comment.HaskellCommentStyle'>, '.aes': <class 'reuse.comment.UncommentableCommentStyle'>, '.ahk': <class 'reuse.comment.SemicolonCommentStyle'>, '.ahkl': <class 'reuse.comment.SemicolonCommentStyle'>, '.aidl': <class 'reuse.comment.CppCommentStyle'>, '.applescript': <class 'reuse.comment.AppleScriptCommentStyle'>, '.arb': <class 'reuse.comment.UncommentableCommentStyle'>, '.asax': <class 'reuse.comment.AspxCommentStyle'>, '.asc': <class 'reuse.comment.CppCommentStyle'>, '.asciidoc': <class 'reuse.comment.CppCommentStyle'>, '.ashx': <class 'reuse.comment.AspxCommentStyle'>, '.asm': <class 'reuse.comment.LispCommentStyle'>, '.asmx': <class 'reuse.comment.AspxCommentStyle'>, '.aspx': <class 'reuse.comment.AspxCommentStyle'>, '.aux': <class 'reuse.comment.TexCommentStyle'>, '.awk': <class 'reuse.comment.PythonCommentStyle'>, '.axd': <class 'reuse.comment.AspxCommentStyle'>, '.bash': <class 'reuse.comment.PythonCommentStyle'>, '.bat': <class 'reuse.comment.BatchFileCommentStyle'>, '.bats': <class 'reuse.comment.PythonCommentStyle'>, '.bb': <class 'reuse.comment.PythonCommentStyle'>, '.bbappend': <class 'reuse.comment.PythonCommentStyle'>, '.bbclass': <class 'reuse.comment.PythonCommentStyle'>, '.bib': <class 'reuse.comment.BibTexCommentStyle'>, '.bzl': <class 'reuse.comment.PythonCommentStyle'>, '.c': <class 'reuse.comment.CCommentStyle'>, '.cc': <class 'reuse.comment.CppCommentStyle'>, '.cjs': <class 'reuse.comment.CppCommentStyle'>, '.cl': <class 'reuse.comment.LispCommentStyle'>, '.clj': <class 'reuse.comment.LispCommentStyle'>, '.cljc': <class 'reuse.comment.LispCommentStyle'>, '.cljs': <class 'reuse.comment.LispCommentStyle'>, '.cls': <class 'reuse.comment.TexCommentStyle'>, '.cmake': <class 'reuse.comment.PythonCommentStyle'>, '.code-workspace': <class 'reuse.comment.CppCommentStyle'>, '.coffee': <class 'reuse.comment.PythonCommentStyle'>, '.cpp': <class 'reuse.comment.CppCommentStyle'>, '.cs': <class 'reuse.comment.CppCommentStyle'>, '.csl': <class 'reuse.comment.HtmlCommentStyle'>, '.cson': <class 'reuse.comment.PythonCommentStyle'>, '.csproj': <class 'reuse.comment.HtmlCommentStyle'>, '.css': <class 'reuse.comment.CCommentStyle'>, '.csv': <class 'reuse.comment.UncommentableCommentStyle'>, '.cu': <class 'reuse.comment.CppCommentStyle'>, '.cuh': <class 'reuse.comment.CppCommentStyle'>, '.cxx': <class 'reuse.comment.CppCommentStyle'>, '.d': <class 'reuse.comment.CppCommentStyle'>, '.dart': <class 'reuse.comment.CppCommentStyle'>, '.di': <class 'reuse.comment.CppCommentStyle'>, '.doc': <class 'reuse.comment.UncommentableCommentStyle'>, '.docx': <class 'reuse.comment.UncommentableCommentStyle'>, '.dotx': <class 'reuse.comment.UncommentableCommentStyle'>, '.dts': <class 'reuse.comment.CppCommentStyle'>, '.dtsi': <class 'reuse.comment.CppCommentStyle'>, '.el': <class 'reuse.comment.LispCommentStyle'>, '.erl': <class 'reuse.comment.TexCommentStyle'>, '.ex': <class 'reuse.comment.PythonCommentStyle'>, '.exs': <class 'reuse.comment.PythonCommentStyle'>, '.f': <class 'reuse.comment.FortranCommentStyle'>, '.f03': <class 'reuse.comment.ModernFortranCommentStyle'>, '.f08': <class 'reuse.comment.ModernFortranCommentStyle'>, '.f90': <class 'reuse.comment.ModernFortranCommentStyle'>, '.f95': <class 'reuse.comment.ModernFortranCommentStyle'>, '.fish': <class 'reuse.comment.PythonCommentStyle'>, '.fnl': <class 'reuse.comment.LispCommentStyle'>, '.fodp': <class 'reuse.comment.UncommentableCommentStyle'>, '.fods': <class 'reuse.comment.UncommentableCommentStyle'>, '.fodt': <class 'reuse.comment.UncommentableCommentStyle'>, '.for': <class 'reuse.comment.FortranCommentStyle'>, '.fpp': <class 'reuse.comment.FortranCommentStyle'>, '.fs': <class 'reuse.comment.CppCommentStyle'>, '.fsproj': <class 'reuse.comment.HtmlCommentStyle'>, '.fsx': <class 'reuse.comment.CppCommentStyle'>, '.ftl': <class 'reuse.comment.FtlCommentStyle'>, '.ftn': <class 'reuse.comment.FortranCommentStyle'>, '.gemspec': <class 'reuse.comment.PythonCommentStyle'>, '.go': <class 'reuse.comment.CppCommentStyle'>, '.gqls': <class 'reuse.comment.PythonCommentStyle'>, '.gradle': <class 'reuse.comment.CppCommentStyle'>, '.graphql': <class 'reuse.comment.PythonCommentStyle'>, '.graphqls': <class 'reuse.comment.PythonCommentStyle'>, '.groovy': <class 'reuse.comment.CppCommentStyle'>, '.h': <class 'reuse.comment.CCommentStyle'>, '.ha': <class 'reuse.comment.CppSingleCommentStyle'>, '.hbs': <class 'reuse.comment.HandlebarsCommentStyle'>, '.hcl': <class 'reuse.comment.PythonCommentStyle'>, '.hh': <class 'reuse.comment.CppCommentStyle'>, '.hjson': <class 'reuse.comment.CppCommentStyle'>, '.hpp': <class 'reuse.comment.CppCommentStyle'>, '.hrl': <class 'reuse.comment.TexCommentStyle'>, '.hs': <class 'reuse.comment.HaskellCommentStyle'>, '.html': <class 'reuse.comment.HtmlCommentStyle'>, '.hx': <class 'reuse.comment.CppCommentStyle'>, '.hxsl': <class 'reuse.comment.CppCommentStyle'>, '.ini': <class 'reuse.comment.SemicolonCommentStyle'>, '.ino': <class 'reuse.comment.CppCommentStyle'>, '.ipynb': <class 'reuse.comment.UncommentableCommentStyle'>, '.iuml': <class 'reuse.comment.PlantUmlCommentStyle'>, '.java': <class 'reuse.comment.CppCommentStyle'>, '.jinja': <class 'reuse.comment.JinjaCommentStyle'>, '.jinja2': <class 'reuse.comment.JinjaCommentStyle'>, '.jl': <class 'reuse.comment.JuliaCommentStyle'>, '.jpeg': <class 'reuse.comment.UncommentableCommentStyle'>, '.jpg': <class 'reuse.comment.UncommentableCommentStyle'>, '.js': <class 'reuse.comment.CppCommentStyle'>, '.json': <class 'reuse.comment.UncommentableCommentStyle'>, '.json5': <class 'reuse.comment.CppCommentStyle'>, '.jsonc': <class 'reuse.comment.CppCommentStyle'>, '.jsp': <class 'reuse.comment.AspxCommentStyle'>, '.jsx': <class 'reuse.comment.CppCommentStyle'>, '.jy': <class 'reuse.comment.PythonCommentStyle'>, '.ksh': <class 'reuse.comment.PythonCommentStyle'>, '.kt': <class 'reuse.comment.CppCommentStyle'>, '.kts': <class 'reuse.comment.CppCommentStyle'>, '.l': <class 'reuse.comment.LispCommentStyle'>, '.latex': <class 'reuse.comment.TexCommentStyle'>, '.ld': <class 'reuse.comment.CppCommentStyle'>, '.less': <class 'reuse.comment.CCommentStyle'>, '.license': <class 'reuse.comment.EmptyCommentStyle'>, '.lisp': <class 'reuse.comment.LispCommentStyle'>, '.lsp': <class 'reuse.comment.LispCommentStyle'>, '.lua': <class 'reuse.comment.HaskellCommentStyle'>, '.m': <class 'reuse.comment.TexCommentStyle'>, '.m4': <class 'reuse.comment.M4CommentStyle'>, '.man': <class 'reuse.comment.UnixManCommentStyle'>, '.markdown': <class 'reuse.comment.HtmlCommentStyle'>, '.md': <class 'reuse.comment.HtmlCommentStyle'>, '.mjs': <class 'reuse.comment.CppCommentStyle'>, '.mk': <class 'reuse.comment.PythonCommentStyle'>, '.ml': <class 'reuse.comment.MlCommentStyle'>, '.mli': <class 'reuse.comment.MlCommentStyle'>, '.nim': <class 'reuse.comment.PythonCommentStyle'>, '.nim.cfg': <class 'reuse.comment.PythonCommentStyle'>, '.nimble': <class 'reuse.comment.PythonCommentStyle'>, '.nimrod': <class 'reuse.comment.PythonCommentStyle'>, '.nix': <class 'reuse.comment.PythonCommentStyle'>, '.odb': <class 'reuse.comment.UncommentableCommentStyle'>, '.odf': <class 'reuse.comment.UncommentableCommentStyle'>, '.odg': <class 'reuse.comment.UncommentableCommentStyle'>, '.odm': <class 'reuse.comment.UncommentableCommentStyle'>, '.odp': <class 'reuse.comment.UncommentableCommentStyle'>, '.ods': <class 'reuse.comment.UncommentableCommentStyle'>, '.odt': <class 'reuse.comment.UncommentableCommentStyle'>, '.org': <class 'reuse.comment.PythonCommentStyle'>, '.otp': <class 'reuse.comment.UncommentableCommentStyle'>, '.ots': <class 'reuse.comment.UncommentableCommentStyle'>, '.ott': <class 'reuse.comment.UncommentableCommentStyle'>, '.pdf': <class 'reuse.comment.UncommentableCommentStyle'>, '.pem': <class 'reuse.comment.UncommentableCommentStyle'>, '.php': <class 'reuse.comment.CppCommentStyle'>, '.php3': <class 'reuse.comment.CppCommentStyle'>, '.php4': <class 'reuse.comment.CppCommentStyle'>, '.php5': <class 'reuse.comment.CppCommentStyle'>, '.pl': <class 'reuse.comment.PythonCommentStyle'>, '.plantuml': <class 'reuse.comment.PlantUmlCommentStyle'>, '.png': <class 'reuse.comment.UncommentableCommentStyle'>, '.po': <class 'reuse.comment.PythonCommentStyle'>, '.pod': <class 'reuse.comment.PythonCommentStyle'>, '.pot': <class 'reuse.comment.PythonCommentStyle'>, '.ppt': <class 'reuse.comment.UncommentableCommentStyle'>, '.pptx': <class 'reuse.comment.UncommentableCommentStyle'>, '.pri': <class 'reuse.comment.PythonCommentStyle'>, '.pro': <class 'reuse.comment.PythonCommentStyle'>, '.properties': <class 'reuse.comment.PythonCommentStyle'>, '.props': <class 'reuse.comment.HtmlCommentStyle'>, '.proto': <class 'reuse.comment.CppCommentStyle'>, '.ps1': <class 'reuse.comment.PythonCommentStyle'>, '.psm1': <class 'reuse.comment.PythonCommentStyle'>, '.pu': <class 'reuse.comment.PlantUmlCommentStyle'>, '.puml': <class 'reuse.comment.PlantUmlCommentStyle'>, '.pxd': <class 'reuse.comment.PythonCommentStyle'>, '.py': <class 'reuse.comment.PythonCommentStyle'>, '.pyi': <class 'reuse.comment.PythonCommentStyle'>, '.pyw': <class 'reuse.comment.PythonCommentStyle'>, '.pyx': <class 'reuse.comment.PythonCommentStyle'>, '.qbs': <class 'reuse.comment.CppCommentStyle'>, '.qml': <class 'reuse.comment.CppCommentStyle'>, '.qrc': <class 'reuse.comment.HtmlCommentStyle'>, '.qss': <class 'reuse.comment.CCommentStyle'>, '.rake': <class 'reuse.comment.PythonCommentStyle'>, '.rb': <class 'reuse.comment.PythonCommentStyle'>, '.rbw': <class 'reuse.comment.PythonCommentStyle'>, '.rbx': <class 'reuse.comment.PythonCommentStyle'>, '.rkt': <class 'reuse.comment.LispCommentStyle'>, '.rs': <class 'reuse.comment.CppCommentStyle'>, '.rss': <class 'reuse.comment.HtmlCommentStyle'>, '.rst': <class 'reuse.comment.ReStructedTextCommentStyle'>, '.s': <class 'reuse.comment.PythonCommentStyle'>, '.sass': <class 'reuse.comment.CCommentStyle'>, '.sbt': <class 'reuse.comment.CppCommentStyle'>, '.sc': <class 'reuse.comment.CppCommentStyle'>, '.scad': <class 'reuse.comment.CppCommentStyle'>, '.scala': <class 'reuse.comment.CppCommentStyle'>, '.scm': <class 'reuse.comment.LispCommentStyle'>, '.scpt': <class 'reuse.comment.AppleScriptCommentStyle'>, '.scptd': <class 'reuse.comment.AppleScriptCommentStyle'>, '.scss': <class 'reuse.comment.CCommentStyle'>, '.scsyndef': <class 'reuse.comment.UncommentableCommentStyle'>, '.sh': <class 'reuse.comment.PythonCommentStyle'>, '.sld': <class 'reuse.comment.LispCommentStyle'>, '.sln': <class 'reuse.comment.UncommentableCommentStyle'>, '.sls': <class 'reuse.comment.LispCommentStyle'>, '.sml': <class 'reuse.comment.MlCommentStyle'>, '.soy': <class 'reuse.comment.CppCommentStyle'>, '.sps': <class 'reuse.comment.LispCommentStyle'>, '.sql': <class 'reuse.comment.HaskellCommentStyle'>, '.sty': <class 'reuse.comment.TexCommentStyle'>, '.svelte': <class 'reuse.comment.HtmlCommentStyle'>, '.svg': <class 'reuse.comment.UncommentableCommentStyle'>, '.swift': <class 'reuse.comment.CppCommentStyle'>, '.t': <class 'reuse.comment.PythonCommentStyle'>, '.tcl': <class 'reuse.comment.PythonCommentStyle'>, '.tex': <class 'reuse.comment.TexCommentStyle'>, '.textile': <class 'reuse.comment.HtmlCommentStyle'>, '.tf': <class 'reuse.comment.PythonCommentStyle'>, '.tfvars': <class 'reuse.comment.PythonCommentStyle'>, '.thy': <class 'reuse.comment.MlCommentStyle'>, '.toc': <class 'reuse.comment.TexCommentStyle'>, '.toml': <class 'reuse.comment.PythonCommentStyle'>, '.ts': <class 'reuse.comment.CppCommentStyle'>, '.tsx': <class 'reuse.comment.CppCommentStyle'>, '.ttl': <class 'reuse.comment.PythonCommentStyle'>, '.typ': <class 'reuse.comment.CppCommentStyle'>, '.ui': <class 'reuse.comment.HtmlCommentStyle'>, '.v': <class 'reuse.comment.CppCommentStyle'>, '.vala': <class 'reuse.comment.CppCommentStyle'>, '.vbproj': <class 'reuse.comment.HtmlCommentStyle'>, '.vhdl': <class 'reuse.comment.HaskellCommentStyle'>, '.vim': <class 'reuse.comment.VimCommentStyle'>, '.vm': <class 'reuse.comment.VelocityCommentStyle'>, '.vsh': <class 'reuse.comment.CppCommentStyle'>, '.vtl': <class 'reuse.comment.VelocityCommentStyle'>, '.vue': <class 'reuse.comment.HtmlCommentStyle'>, '.webp': <class 'reuse.comment.UncommentableCommentStyle'>, '.xls': <class 'reuse.comment.UncommentableCommentStyle'>, '.xlsx': <class 'reuse.comment.UncommentableCommentStyle'>, '.xml': <class 'reuse.comment.HtmlCommentStyle'>, '.xq': <class 'reuse.comment.XQueryCommentStyle'>, '.xql': <class 'reuse.comment.XQueryCommentStyle'>, '.xqm': <class 'reuse.comment.XQueryCommentStyle'>, '.xquery': <class 'reuse.comment.XQueryCommentStyle'>, '.xqy': <class 'reuse.comment.XQueryCommentStyle'>, '.xsd': <class 'reuse.comment.HtmlCommentStyle'>, '.xsh': <class 'reuse.comment.PythonCommentStyle'>, '.xsl': <class 'reuse.comment.HtmlCommentStyle'>, '.yaml': <class 'reuse.comment.PythonCommentStyle'>, '.yml': <class 'reuse.comment.PythonCommentStyle'>, '.zig': <class 'reuse.comment.CppSingleCommentStyle'>, '.zsh': <class 'reuse.comment.PythonCommentStyle'>}¶: A map of (common) file extensions against comment types.

reuse.comment.NAME_STYLE_MAP = {'applescript': <class 'reuse.comment.AppleScriptCommentStyle'>, 'aspx': <class 'reuse.comment.AspxCommentStyle'>, 'bat': <class 'reuse.comment.BatchFileCommentStyle'>, 'bibtex': <class 'reuse.comment.BibTexCommentStyle'>, 'c': <class 'reuse.comment.CCommentStyle'>, 'cpp': <class 'reuse.comment.CppCommentStyle'>, 'cppsingle': <class 'reuse.comment.CppSingleCommentStyle'>, 'f': <class 'reuse.comment.FortranCommentStyle'>, 'f90': <class 'reuse.comment.ModernFortranCommentStyle'>, 'ftl': <class 'reuse.comment.FtlCommentStyle'>, 'handlebars': <class 'reuse.comment.HandlebarsCommentStyle'>, 'haskell': <class 'reuse.comment.HaskellCommentStyle'>, 'html': <class 'reuse.comment.HtmlCommentStyle'>, 'jinja': <class 'reuse.comment.JinjaCommentStyle'>, 'julia': <class 'reuse.comment.JuliaCommentStyle'>, 'lisp': <class 'reuse.comment.LispCommentStyle'>, 'm4': <class 'reuse.comment.M4CommentStyle'>, 'man': <class 'reuse.comment.UnixManCommentStyle'>, 'ml': <class 'reuse.comment.MlCommentStyle'>, 'plantuml': <class 'reuse.comment.PlantUmlCommentStyle'>, 'python': <class 'reuse.comment.PythonCommentStyle'>, 'rst': <class 'reuse.comment.ReStructedTextCommentStyle'>, 'semicolon': <class 'reuse.comment.SemicolonCommentStyle'>, 'tex': <class 'reuse.comment.TexCommentStyle'>, 'vim': <class 'reuse.comment.VimCommentStyle'>, 'vst': <class 'reuse.comment.VelocityCommentStyle'>, 'xquery': <class 'reuse.comment.XQueryCommentStyle'>}¶: A map of human-friendly names against style classes.