Unable to verify the project's public source code repository.

Package Health Score

46 / 100

security
No known security issues
popularity
Small
maintenance
Inactive
community
Limited

Explore Similar Packages

Popularity

Small

GitHub Stars: ?
Forks: ?
Contributors: -

Direct Usage Popularity

Based on project statistics from the GitHub repository for the PyPI package html, we found that it has been starred ? times.

Security

No known security issues

Security and license risk for latest version

Release Date: Jun 29, 2011
Direct Vulnerabilities: 0
C
0
H
0
M
0
L
Indirect Vulnerabilities: 0
C
0
H
0
M
0
L
License Risk: 0
H
0
M
0
L

All security vulnerabilities belong to production dependencies of direct and indirect packages.

License

BSD-2-Clause

Security Policy

We found a way for you to contribute to the project! Looks like html is missing a security policy.

You can connect your project's repository to Snyk to stay up to date on security alerts and receive automatic fix pull requests.

Keep your project free of vulnerabilities with Snyk

Maintenance

Inactive

Commit Frequency

Unavailable commit data

Open Issues: ?
Open PR: ?
Last Release: 13 years ago
Last Commit: unknown

Further analysis of the maintenance status of html based on released PyPI versions cadence, the repository activity, and other data points determined that its maintenance is Inactive.

An important project maintenance signal to consider for html is that it hasn't seen any new versions released to PyPI in the past 12 months, and could be considered as a discontinued project, or that which receives low attention from its maintainers.

In the past month we didn't find any pull request activity or change in issues status has been detected for the GitHub repository.

Community

Limited

Readme: Yes
Contributing.md: No
Code of Conduct: No
Contributors: 0
Funding: No

This project has seen only 10 or less contributors.

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Python Versions Compatibility: ==2.5.*, ==2.6.*, ==3.*

Age: 15 years
Latest Release: 13 years ago
Dependencies: N/A
Versions: 17
Maintainers: 2
Wheels: No

Not sure how to use html?

To help you get started, we've collected the most common ways that html is being used within popular public projects.

mozilla / amo-validator / validator / testcases / markup / markuptester.py View on Github

UNSAFE_THEME_TAGS = ("implementation", "browser", "xul:browser", "xul:script")
SELF_CLOSING_TAGS = ("area", "base", "basefont", "br", "col", "frame", "hr",
                     "img", "input", "li", "link", "meta", "p", "param", )
SAFE_IFRAME_TYPES = ("content", "content-primary", "content-targetable", )
TAG_NOT_OPENED = "Tag (%s) being closed before it is opened."

DOM_MUTATION_HANDLERS = (
        "ondomattrmodified", "ondomattributenamechanged",
        "ondomcharacterdatamodified", "ondomelementnamechanged",
        "ondomnodeinserted", "ondomnodeinsertedintodocument", "ondomnoderemoved",
        "ondomnoderemovedfromdocument", "ondomsubtreemodified", )
UNSAFE_THEME_XBL = ("constructor", "destructor", "field", "getter",
                    "implementation", "setter", )


class MarkupParser(htmlparser.HTMLParser):
    """Parse and analyze the versious components of markup files."""

    def __init__(self, err, strict=True, debug=False):
        htmlparser.HTMLParser.__init__(self)
        self.err = err
        self.line = 0
        self.strict = strict
        self.debug = debug

        self.context = None

        self.xml_state = []
        self.xml_line_stack = []
        self.xml_buffer = []
        self.xbl = False

View more ways to use html

Simple, elegant HTML, XHTML and XML generation.

Constructing your HTML

To construct HTML start with an instance of html.HTML(). Add tags by accessing the tag's attribute on that object. For example:

>>> from html import HTML >>> h = HTML() >>> h.p('Hello, world!') >>> print h # or print(h) in python 3+ Hello, world!

You may supply a tag name and some text contents when creating a HTML instance:

>>> h = HTML('html', 'text') >>> print h <html>text</html>

You may also append text content later using the tag's .text() method or using augmented addition +=. Any HTML-specific characters (<>&") in the text will be escaped for HTML safety as appropriate unless escape=False is passed. Each of the following examples uses a new HTML instance:

>>> p = h.p('hello world!n') >>> p.br >>> p.text('more → text', escape=False) >>> p += ' ... augmented' >>> h.p >>> print h hello, world! more → text ... augmented

Note also that the top-level HTML object adds newlines between tags by default. Finally in the above you'll see an empty paragraph tag - tags with no contents get no closing tag.

If the tag should have sub-tags you have two options. You may either add the sub-tags directly on the tag:

>>> l = h.ol >>> l.li('item 1') >>> l.li.b('item 2 > 1') >>> print h <ol> <li>item 1</li> <li>item 2 > 1</li> </ol>

Note that the default behavior with lists (and tables) is to add newlines between sub-tags to generate a nicer output. You can also see in that example the chaining of tags in l.li.b.

Tag attributes may be passed in as well:

>>> t = h.table(border='1') >>> for i in range(2): >>> r = t.tr >>> r.td('column 1') >>> r.td('column 2') >>> print t <table border="1"> <tr><td>column 1</td><td>column 2</td></tr> <tr><td>column 1</td><td>column 2</td></tr> </table>

A variation on the above is to use a tag as a context variable. The following is functionally identical to the first list construction but with a slightly different sytax emphasising the HTML structure:

>>> with h.ol as l: ... l.li('item 1') ... l.li.b('item 2 > 1')

You may turn off/on adding newlines by passing newlines=False or True to the tag (or HTML instance) at creation time:

>>> l = h.ol(newlines=False) >>> l.li('item 1') >>> l.li('item 2') >>> print h <ol><li>item 1</li><li>item 2</li></ol>

Since we can't use class as a keyword, the library recognises klass as a substitute:

>>> print h.p(content, klass="styled") content

Unicode

HTML will work with either regular strings or unicode strings, but not both at the same time.

Obtain the final unicode string by calling unicode() on the HTML instance:

>>> h = HTML() >>> h.p(u'Some Euro: €1.14') >>> unicode(h) u'Some Euro: €1.14'

If (under Python 2.x) you add non-unicode strings or attempt to get the resultant HTML source through any means other than unicode() then you will most likely get one of the following errors raised:

UnicodeDecodeError
Probably means you've added non-unicode strings to your HTML.

UnicodeEncodeError
Probably means you're trying to get the resultant HTML using print or str() (or %s).

How generation works

The HTML document is generated when the HTML instance is "stringified". This could be done either by invoking str() on it, or just printing it. It may also be returned directly as the "iterable content" from a WSGI app function.

You may also render any tag or sub-tag at any time by stringifying it.

Tags with no contents (either text or sub-tags) will have no closing tag. There is no "special list" of tags that must always have closing tags, so if you need to force a closing tag you'll need to provide some content, even if it's just a single space character.

Rendering doesn't affect the HTML document's state, so you can add to or otherwise manipulate the HTML after you've stringified it.

Creating XHTML

To construct XHTML start with an instance of html.XHTML() and use it as you would an HTML instance. Empty elements will now be rendered with the appropriate XHTML minimized tag syntax. For example:

>>> from html import XHTML >>> h = XHTML() >>> h.p >>> h.br >>> print h

Creating XML

A slight tweak to the html.XHTML() implementation allows us to generate arbitrary XML using html.XML():

>>> from html import XML >>> h = XML('xml') >>> h.p >>> h.br('hi there') >>> print h <xml> hi there </xml>

Tags with difficult names

If your tag name isn't a valid Python identifier name, or if it's called "text" or "raw_text" you can add your tag slightly more manually:

>>> from html import XML >>> h = XML('xml') >>> h += XML('some-tag', 'some text') >>> h += XML('text', 'some text') >>> print h <xml> <some-tag>some text</some-tag> <text>some text</text> </xml>

Version History (in Brief)

1.16 detect and raise a more useful error when some WSGI frameworks attempt to call HTML.read(). Also added ability to add new content using the += operator.
1.15 fix Python 3 compatibility (unit tests)
1.14 added plain XML support
1.13 allow adding (X)HTML instances (tags) as new document content
1.12 fix handling of XHTML empty tags when generating unicode output (thanks Carsten Eggers)
1.11 remove setuptools dependency
1.10 support plain ol' distutils again
1.9 added unicode support for Python 2.x
1.8 added Python 3 compatibility
1.7 added Python 2.5 compatibility and escape argument to tag construction
1.6 added .raw_text() and and WSGI compatibility
1.5 added XHTML support
1.3 added more documentation, more tests
1.2 added special-case klass / class attribute
1.1 added escaping control
1.0 was the initial release

I would be interested to know whether this module is useful - if you use it please indicate so at

FAQs

What is html?

simple, elegant HTML, XHTML and XML generation. Visit Snyk Advisor to see a full health score report for html, including popularity, security, maintenance & community analysis.

Is html popular?

The python package html receives a total of 3,408 weekly downloads. As such, html popularity was classified as small. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is html safe to use?

The python package html was scanned for known vulnerabilities and missing license, and no issues were found. Thus the package was deemed as safe to use. See the full health analysis review.

Last updated on 21 November-2024, at 09:22 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP

html

simple, elegant HTML, XHTML and XML generation For more information about how to use this package see README

Ensure you're using the healthiest python packages

Package Health Score

Explore Similar Packages

Popularity

Direct Usage Popularity

Security

Security and license risk for latest version

Maintenance

Commit Frequency

Community

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Package

Not sure how to use html?

Constructing your HTML

Unicode

How generation works

Creating XHTML

Creating XML

Tags with difficult names

Version History (in Brief)

FAQs

What is html?

Is html popular?

Is html safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Fix identified vulnerabilities

Monitor for new issues

Package Health Score

Explore Similar Packages

Direct Usage Popularity

Security and license risk for latest version

Commit Frequency

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Not sure how to use html?

Constructing your HTML

Unicode

How generation works

Creating XHTML

Creating XML

Tags with difficult names

Version History (in Brief)

FAQs

What is html?

Is html popular?

Is html safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Source Code

Open Source

Container

Config

Fix identified vulnerabilities

Monitor for new issues