docs/reference/reference_functions.rst

   1 *Black* functions
   2 =================
   3
   4 *Contents are subject to change.*
   5
   6 .. currentmodule:: black
   7
   8 Assertions and checks
   9 ---------------------
  10
  11 .. autofunction:: black.assert_equivalent
  12
  13 .. autofunction:: black.assert_stable
  14
  15 .. autofunction:: black.is_split_after_delimiter
  16
  17 .. autofunction:: black.is_split_before_delimiter
  18
  19 .. autofunction:: black.is_delimiter
  20
  21 .. autofunction:: black.is_empty_tuple
  22
  23 .. autofunction:: black.is_import
  24
  25 .. autofunction:: black.is_one_tuple
  26
  27 .. autofunction:: black.is_python36
  28
  29 .. autofunction:: black.is_vararg
  30
  31 Formatting
  32 ----------
  33
  34 .. autofunction:: black.format_file_contents
  35
  36 .. autofunction:: black.format_file_in_place
  37
  38 .. autofunction:: black.format_stdin_to_stdout
  39
  40 .. autofunction:: black.format_str
  41
  42 .. autofunction:: black.schedule_formatting
  43
  44 File operations
  45 ---------------
  46
  47 .. autofunction:: black.dump_to_file
  48
  49 .. autofunction:: black.gen_python_files_in_dir
  50
  51 Parsing
  52 -------
  53
  54 .. autofunction:: black.lib2to3_parse
  55
  56 .. autofunction:: black.lib2to3_unparse
  57
  58 Split functions
  59 ---------------
  60
  61 .. autofunction:: black.delimiter_split
  62
  63 .. autofunction:: black.left_hand_split
  64
  65 .. autofunction:: black.right_hand_split
  66
  67 .. autofunction:: black.standalone_comment_split
  68
  69 .. autofunction:: black.split_line
  70
  71 .. autofunction:: black.bracket_split_succeeded_or_raise
  72
  73 Utilities
  74 ---------
  75
  76 .. py:function:: black.DebugVisitor.show(code: str) -> None
  77
  78     Pretty-print the lib2to3 AST of a given string of `code`.
  79
  80 .. autofunction:: black.diff
  81
  82 .. autofunction:: black.ensure_visible
  83
  84 .. autofunction:: black.generate_comments
  85
  86 .. autofunction:: black.make_comment
  87
  88 .. autofunction:: black.normalize_prefix
  89
  90 .. autofunction:: black.normalize_string_quotes
  91
  92 .. autofunction:: black.normalize_invisible_parens
  93
  94 .. autofunction:: black.preceding_leaf
  95
  96 .. autofunction:: black.sub_twice
  97
  98 .. autofunction:: black.whitespace