Ravenports generated: 17 Apr 2023 15:41
[ravenports.git] / bucket_D3 / python-bleach
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-bleach
4 VERSION=                6.0.0
5 KEYWORDS=               python
6 VARIANTS=               py310 v11
7 SDESC[py310]=           Easy safelist-based HTML-sanitizing tool (3.10)
8 SDESC[v11]=             Easy safelist-based HTML-sanitizing tool (3.11)
9 HOMEPAGE=               https://github.com/mozilla/bleach
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/ac/e2/dfcab68c9b2e7800c8f06b85c76e5f978d05b195a958daa9b1dda54a1db6
14 DISTFILE[1]=            bleach-6.0.0-py3-none-any.whl: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 USES=                   cpe
25
26 DISTNAME=               bleach-6.0.0.dist-info
27
28 CPE_PRODUCT=            bleach
29 CPE_VENDOR=             mozilla
30 GENERATED=              yes
31
32 [PY310].RUN_DEPENDS_ON=                 python-six:single:py310
33                                         python-webencodings:single:py310
34 [PY310].USES_ON=                        python:py310,wheel
35
36 [PY311].RUN_DEPENDS_ON=                 python-six:single:v11
37                                         python-webencodings:single:v11
38 [PY311].USES_ON=                        python:v11,wheel
39
40 post-install:
41         ${SED} -i'' -e 's|/bin/bash|${PREFIX}/bin/bash|' \
42                 ${STAGEDIR}${PYTHON_SITELIBDIR}/bleach/_vendor/vendor_install.sh
43
44 [FILE:2695:descriptions/desc.single]
45 ======
46 Bleach
47 ======
48
49 Bleach is an allowed-list-based HTML sanitizing library that escapes or
50 strips
51 markup and attributes.
52
53 Bleach can also linkify text safely, applying filters that Django's urlize
54 filter cannot, and optionally setting rel attributes, even on links already
55 in the text.
56
57 Bleach is intended for sanitizing text from *untrusted* sources. If you
58 find
59 yourself jumping through hoops to allow your site administrators to do lots
60 of
61 things, you're probably outside the use cases. Either trust those users, or
62 don't.
63
64 Because it relies on html5lib_, Bleach is as good as modern browsers at
65 dealing
66 with weird, quirky HTML fragments. And *any* of Bleach's methods will fix
67 unbalanced or mis-nested tags.
68
69 The version on GitHub_ is the most up-to-date and contains the latest bug
70 fixes. You can find full documentation on `ReadTheDocs`_.
71
72 :Code:           https://github.com/mozilla/bleach
73 :Documentation:  https://bleach.readthedocs.io/
74 :Issue tracker:  https://github.com/mozilla/bleach/issues
75 :License:        Apache License v2; see LICENSE file
76
77 Reporting Bugs
78 ==============
79
80 For regular bugs, please report them [in our issue tracker
81 ].
82
83 If you believe that you've found a security vulnerability, please [file a
84 secure
85 bug report in our bug tracker
86 ]
87 or send an email to *security AT mozilla DOT org*.
88
89 For more information on security-related bug disclosure and the PGP key to
90 use
91 for sending encrypted mail or to verify responses received from that
92 address,
93 please read our wiki page at
94 `<https://www.mozilla.org/en-US/security/#For_Developers>`_.
95
96 Security
97 ========
98
99 Bleach is a security-focused library.
100
101 We have a responsible security vulnerability reporting process. Please use
102 that if you're reporting a security issue.
103
104 Security issues are fixed in private. After we land such a fix, we'll do a
105 release.
106
107 For every release, we mark security issues we've fixed in the CHANGES in
108 the **Security issues** section. We include any relevant CVE links.
109
110 Installing Bleach
111 =================
112
113 Bleach is available on PyPI_, so you can install it with pip::
114
115     $ pip install bleach
116
117 Upgrading Bleach
118 ================
119
120 .. warning::
121
122    Before doing any upgrades, read through [Bleach Changes
123   ] for backwards
124    incompatible changes, newer versions, etc.
125
126    Bleach follows `semver 2`_ versioning. Vendored libraries will not
127    be changed in patch releases.
128
129 Basic use
130 =========
131
132 The simplest way to use Bleach is:
133
134 .. code-block:: python
135
136     >>> import bleach
137
138     >>> bleach.clean('an <script>evil()</script> example')
139     u'an &lt;script&gt;evil()&lt;/script&gt; example'
140
141     >>> bleach.linkify('an http://example.com url')
142     u'an http://example.com url'
143
144 Code of Conduct
145
146
147 [FILE:108:distinfo]
148 33c16e3353dbd13028ab4799a0f89a83f113405c766e9c122df8a06f5b85b3f4       162493 bleach-6.0.0-py3-none-any.whl
149