3 >^ @sldZddlmZddlZddlmZddlmZddlm Z ddl m Z dd Z d d Z d d ZddZdS)zP Utility functions to return a formatted name and description for a given view. )unicode_literalsN) force_text)escape) mark_safe)apply_markdowncCs(|j|r$||kr$|dt| S|S)z| Strip trailing component `trailing` from `content` if it exists. Used when generating names from view classes. N)endswithlen)contentZtrailingr N/tmp/pip-build-8app2_gc/djangorestframework/rest_framework/utils/formatting.pyremove_trailing_stringsr cCst|}dd|jddD}|rtdd|D}tdd|D}|rtdd|}tjtj|tjd |}n(|rdd |}tjtj|tjd |}|jS) a Remove leading indent from a block of text. Used when generating descriptions from docstrings. Note that python's `textwrap.dedent` doesn't quite cut it, as it fails to dedent multiline docstrings that include unindented text on the initial line. cSsg|]}|jr|qSr )lstrip).0liner r r #szdedent..NcSs"g|]}t|t|jdqS) )rr )rrr r r r'scSs"g|]}t|t|jdqS) )rr )rrr r r r(s^rr)r splitlinesminresubcompile MULTILINEstrip)r linesZwhitespace_countsZ tab_countsZwhitespace_patternr r r dedents   rcCs*d}tj|d|j}dj|jdjS)zm Translate 'CamelCaseNames' to 'Camel Case Names'. Used when generating names from view classes. z&(((?<=[a-z])[A-Z])|([A-Z](?![A-Z]|$)))z \1r_)rrrjoinsplittitle)r Zcamelcase_boundaryr r r camelcase_to_spaces2sr#cCs2trt|}nt|jdd}d|d}t|S)z5 Apply HTML markup to the given description.  z
z

z

)rrreplacer) descriptionr r r markup_description<s   r')__doc__ __future__rrZdjango.utils.encodingrZdjango.utils.htmlrZdjango.utils.safestringrZrest_framework.compatrr rr#r'r r r r s