Ravenports generated: 28 Feb 2022 02:23
[ravenports.git] / bucket_48 / python-MarkupSafe
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-MarkupSafe
4 VERSION=                2.1.0
5 KEYWORDS=               python
6 VARIANTS=               py39 py310
7 SDESC[py310]=           Jinja2.Markup string implementation module (3.10)
8 SDESC[py39]=            Jinja2.Markup string implementation module (3.9)
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.0.tar.gz:main
15 DF_INDEX=               1
16 SPKGS[py310]=           single
17 SPKGS[py39]=            single
18
19 OPTIONS_AVAILABLE=      PY39 PY310
20 OPTIONS_STANDARD=       none
21 VOPTS[py310]=           PY39=OFF PY310=ON
22 VOPTS[py39]=            PY39=ON PY310=OFF
23
24 DISTNAME=               MarkupSafe-2.1.0
25
26 GENERATED=              yes
27
28 [PY39].USES_ON=                         python:py39,sutools
29
30 [PY310].USES_ON=                        python:py310,sutools
31
32 [FILE:1980: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 -   Website: https://palletsprojects.com/p/markupsafe/
96 -   Twitter: https://twitter.com/PalletsTeam
97 -   Chat: https://discord.gg/pallets
98
99
100 [FILE:102:distinfo]
101 80beaf63ddfbc64a0452b841d8036ca0611e049650e20afcb882f5d3c266d65f        18546 MarkupSafe-2.1.0.tar.gz
102