bucket_48/python-MarkupSafe

   1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
   2
   3 NAMEBASE=               python-MarkupSafe
   4 VERSION=                2.1.3
   5 KEYWORDS=               python
   6 VARIANTS=               py310 v11
   7 SDESC[py310]=           Jinja2.Markup string implementation module (3.10)
   8 SDESC[v11]=             Jinja2.Markup string implementation module (3.11)
   9 HOMEPAGE=               https://palletsprojects.com/p/markupsafe/
  10 CONTACT=                Python_Automaton[python@ironwolf.systems]
  11
  12 DOWNLOAD_GROUPS=        main
  13 SITES[main]=            PYPI/M/MarkupSafe
  14 DISTFILE[1]=            MarkupSafe-2.1.3.tar.gz:main
  15 DF_INDEX=               1
  16 SPKGS[py310]=           single
  17 SPKGS[v11]=             single
  18
  19 OPTIONS_AVAILABLE=      PY310 PY311
  20 OPTIONS_STANDARD=       none
  21 VOPTS[py310]=           PY310=ON PY311=OFF
  22 VOPTS[v11]=             PY310=OFF PY311=ON
  23
  24 DISTNAME=               MarkupSafe-2.1.3
  25
  26 GENERATED=              yes
  27
  28 [PY310].USES_ON=                        python:py310,sutools
  29
  30 [PY311].USES_ON=                        python:v11,sutools
  31
  32 [FILE:1880:descriptions/desc.single]
  33 MarkupSafe
  34 ==========
  35
  36 MarkupSafe implements a text object that escapes characters so it is
  37 safe to use in HTML and XML. Characters that have special meanings are
  38 replaced so that they display as the actual characters. This mitigates
  39 injection attacks, meaning untrusted user input can safely be displayed
  40 on a page.
  41
  42 Installing
  43 ----------
  44
  45 Install and update using `pip`_:
  46
  47 .. code-block:: text
  48
  49     pip install -U MarkupSafe
  50
  51 .. _pip: https://pip.pypa.io/en/stable/getting-started/
  52
  53 Examples
  54 --------
  55
  56 .. code-block:: pycon
  57
  58     >>> from markupsafe import Markup, escape
  59
  60     >>> # escape replaces special characters and wraps in Markup
  61     >>> escape("<script>alert(document.cookie);</script>")
  62     Markup('&lt;script&gt;alert(document.cookie);&lt;/script&gt;')
  63
  64     >>> # wrap in Markup to mark text "safe" and prevent escaping
  65     >>> Markup("<strong>Hello</strong>")
  66     Markup('<strong>hello</strong>')
  67
  68     >>> escape(Markup("<strong>Hello</strong>"))
  69     Markup('<strong>hello</strong>')
  70
  71     >>> # Markup is a str subclass
  72     >>> # methods and operators escape their arguments
  73     >>> template = Markup("Hello <em>{name}</em>")
  74     >>> template.format(name='"World"')
  75     Markup('Hello <em>&#34;World&#34;</em>')
  76
  77 Donate
  78 ------
  79
  80 The Pallets organization develops and supports MarkupSafe and other
  81 popular packages. In order to grow the community of contributors and
  82 users, and allow the maintainers to devote more time to the projects,
  83 `please donate today`_.
  84
  85 .. _please donate today: https://palletsprojects.com/donate
  86
  87 Links
  88 -----
  89
  90 -   Documentation: https://markupsafe.palletsprojects.com/
  91 -   Changes: https://markupsafe.palletsprojects.com/changes/
  92 -   PyPI Releases: https://pypi.org/project/MarkupSafe/
  93 -   Source Code: https://github.com/pallets/markupsafe/
  94 -   Issue Tracker: https://github.com/pallets/markupsafe/issues/
  95 -   Chat: https://discord.gg/pallets
  96
  97
  98 [FILE:102:distinfo]
  99 af598ed32d6ae86f1b747b82783958b1a4ab8f617b06fe68795c7f026abbdcad        19132 MarkupSafe-2.1.3.tar.gz
 100