From 1bedc176d19f0e71c24149c696c5a2a71f21e941 Mon Sep 17 00:00:00 2001 From: Richard Si <63936253+ichard26@users.noreply.github.com> Date: Sat, 8 May 2021 15:53:01 -0400 Subject: [PATCH] Fix autodoc refs broken by refactor (#2207) --- .../reference/reference_classes.rst | 6 +- .../reference/reference_exceptions.rst | 2 +- .../reference/reference_functions.rst | 112 +++++++++--------- 3 files changed, 59 insertions(+), 61 deletions(-) diff --git a/docs/contributing/reference/reference_classes.rst b/docs/contributing/reference/reference_classes.rst index 8a2ded9..fa76596 100644 --- a/docs/contributing/reference/reference_classes.rst +++ b/docs/contributing/reference/reference_classes.rst @@ -8,7 +8,7 @@ :class:`BracketTracker` ----------------------- -.. autoclass:: black.BracketTracker +.. autoclass:: black.brackets.BracketTracker :members: :class:`EmptyLineTracker` @@ -34,7 +34,7 @@ :class:`ProtoComment` --------------------- -.. autoclass:: black.ProtoComment +.. autoclass:: black.comments.ProtoComment :members: :class:`Report` @@ -47,7 +47,7 @@ :class:`Visitor` ---------------- -.. autoclass:: black.Visitor +.. autoclass:: black.nodes.Visitor :show-inheritance: :members: diff --git a/docs/contributing/reference/reference_exceptions.rst b/docs/contributing/reference/reference_exceptions.rst index 517249f..aafe61e 100644 --- a/docs/contributing/reference/reference_exceptions.rst +++ b/docs/contributing/reference/reference_exceptions.rst @@ -5,7 +5,7 @@ .. currentmodule:: black -.. autoexception:: black.CannotSplit +.. autoexception:: black.linegen.CannotSplit .. autoexception:: black.NothingChanged diff --git a/docs/contributing/reference/reference_functions.rst b/docs/contributing/reference/reference_functions.rst index bffce7e..4353d1b 100644 --- a/docs/contributing/reference/reference_functions.rst +++ b/docs/contributing/reference/reference_functions.rst @@ -12,31 +12,31 @@ Assertions and checks .. autofunction:: black.assert_stable -.. autofunction:: black.can_be_split +.. autofunction:: black.lines.can_be_split -.. autofunction:: black.can_omit_invisible_parens +.. autofunction:: black.lines.can_omit_invisible_parens -.. autofunction:: black.is_empty_tuple +.. autofunction:: black.nodes.is_empty_tuple -.. autofunction:: black.is_import +.. autofunction:: black.nodes.is_import -.. autofunction:: black.is_line_short_enough +.. autofunction:: black.lines.is_line_short_enough -.. autofunction:: black.is_multiline_string +.. autofunction:: black.nodes.is_multiline_string -.. autofunction:: black.is_one_tuple +.. autofunction:: black.nodes.is_one_tuple -.. autofunction:: black.is_split_after_delimiter +.. autofunction:: black.brackets.is_split_after_delimiter -.. autofunction:: black.is_split_before_delimiter +.. autofunction:: black.brackets.is_split_before_delimiter -.. autofunction:: black.is_stub_body +.. autofunction:: black.nodes.is_stub_body -.. autofunction:: black.is_stub_suite +.. autofunction:: black.nodes.is_stub_suite -.. autofunction:: black.is_vararg +.. autofunction:: black.nodes.is_vararg -.. autofunction:: black.is_yield +.. autofunction:: black.nodes.is_yield Formatting @@ -70,111 +70,109 @@ Parsing .. autofunction:: black.decode_bytes -.. autofunction:: black.lib2to3_parse +.. autofunction:: black.parsing.lib2to3_parse -.. autofunction:: black.lib2to3_unparse +.. autofunction:: black.parsing.lib2to3_unparse Split functions --------------- -.. autofunction:: black.bracket_split_build_line +.. autofunction:: black.linegen.bracket_split_build_line -.. autofunction:: black.bracket_split_succeeded_or_raise +.. autofunction:: black.linegen.bracket_split_succeeded_or_raise -.. autofunction:: black.delimiter_split +.. autofunction:: black.linegen.delimiter_split -.. autofunction:: black.left_hand_split +.. autofunction:: black.linegen.left_hand_split -.. autofunction:: black.right_hand_split +.. autofunction:: black.linegen.right_hand_split -.. autofunction:: black.standalone_comment_split +.. autofunction:: black.linegen.standalone_comment_split -.. autofunction:: black.transform_line +.. autofunction:: black.linegen.transform_line Caching ------- -.. autofunction:: black.filter_cached +.. autofunction:: black.cache.filter_cached -.. autofunction:: black.get_cache_file +.. autofunction:: black.cache.get_cache_file -.. autofunction:: black.get_cache_info +.. autofunction:: black.cache.get_cache_info -.. autofunction:: black.read_cache +.. autofunction:: black.cache.read_cache -.. autofunction:: black.write_cache +.. autofunction:: black.cache.write_cache Utilities --------- -.. py:function:: black.DebugVisitor.show(code: str) -> None +.. py:function:: black.debug.DebugVisitor.show(code: str) -> None Pretty-print the lib2to3 AST of a given string of `code`. -.. autofunction:: black.cancel +.. autofunction:: black.concurrency.cancel -.. autofunction:: black.child_towards +.. autofunction:: black.nodes.child_towards -.. autofunction:: black.container_of +.. autofunction:: black.nodes.container_of -.. autofunction:: black.convert_one_fmt_off_pair +.. autofunction:: black.comments.convert_one_fmt_off_pair .. autofunction:: black.diff -.. autofunction:: black.dont_increase_indentation +.. autofunction:: black.linegen.dont_increase_indentation -.. autofunction:: black.format_float_or_int_string +.. autofunction:: black.numerics.format_float_or_int_string -.. autofunction:: black.ensure_visible +.. autofunction:: black.nodes.ensure_visible -.. autofunction:: black.enumerate_reversed +.. autofunction:: black.lines.enumerate_reversed -.. autofunction:: black.enumerate_with_length +.. autofunction:: black.comments.generate_comments -.. autofunction:: black.generate_comments +.. autofunction:: black.comments.generate_ignored_nodes -.. autofunction:: black.generate_ignored_nodes +.. autofunction:: black.comments.is_fmt_on -.. autofunction:: black.is_fmt_on +.. autofunction:: black.comments.contains_fmt_on_at_column -.. autofunction:: black.contains_fmt_on_at_column +.. autofunction:: black.nodes.first_leaf_column -.. autofunction:: black.first_leaf_column - -.. autofunction:: black.generate_trailers_to_omit +.. autofunction:: black.linegen.generate_trailers_to_omit .. autofunction:: black.get_future_imports -.. autofunction:: black.list_comments +.. autofunction:: black.comments.list_comments -.. autofunction:: black.make_comment +.. autofunction:: black.comments.make_comment -.. autofunction:: black.maybe_make_parens_invisible_in_atom +.. autofunction:: black.linegen.maybe_make_parens_invisible_in_atom -.. autofunction:: black.max_delimiter_priority_in_atom +.. autofunction:: black.brackets.max_delimiter_priority_in_atom .. autofunction:: black.normalize_fmt_off -.. autofunction:: black.normalize_numeric_literal +.. autofunction:: black.numerics.normalize_numeric_literal -.. autofunction:: black.normalize_prefix +.. autofunction:: black.linegen.normalize_prefix -.. autofunction:: black.normalize_string_prefix +.. autofunction:: black.strings.normalize_string_prefix -.. autofunction:: black.normalize_string_quotes +.. autofunction:: black.strings.normalize_string_quotes -.. autofunction:: black.normalize_invisible_parens +.. autofunction:: black.linegen.normalize_invisible_parens .. autofunction:: black.patch_click -.. autofunction:: black.preceding_leaf +.. autofunction:: black.nodes.preceding_leaf .. autofunction:: black.re_compile_maybe_verbose -.. autofunction:: black.should_split_line +.. autofunction:: black.linegen.should_split_line .. autofunction:: black.shutdown -.. autofunction:: black.sub_twice +.. autofunction:: black.strings.sub_twice -.. autofunction:: black.whitespace +.. autofunction:: black.nodes.whitespace -- 2.39.5