A simple python package to generate HTML head tags.

Project description

pyhead 🐍🤯

The Python HTML <head> filler.

pip install pyhead

from flask import Flask

from pyhead import Head


def create_app():
    app = Flask(__name__)

    @app.route('/')
    def dicts_as_args():
        head = Head(
            charset='utf-8',
            viewport='width=device-width, initial-scale=1.0',
            title='Hello World',
            base='https://example.com',
            description='This is a test',
            keywords='test, hello, world',
            subject='Hello World',
            rating='General',
            robots='index, follow',
            referrer_policy={
                'policy': 'no-referrer',
                'fallback': 'origin',
            },
            google={
                'googlebot': 'index, follow',
                'no_sitelinks_search_box': False,
                'no_translate': False,
            },
            verification={
                'google': '1234567890',
                'bing': '1234567890',
            },
            opengraph_website={
                'site_name': 'Example',
                'title': 'Example',
                'description': 'Example',
                'url': 'https://example.com',
                'image': 'https://example.com/image.png',
                'image_alt': 'Example',
                'locale': 'en_US',
            },
            twitter_card={
                'card': 'summary',
                'site_account': '@example',
                'creator_account': '@example',
                'title': 'Example',
                'description': 'Example',
                'image': 'https://example.com/image.png',
                'image_alt': 'Example',
            },
            geo_position={
                'icbm': '55.86013028402754, -4.252019430273945',
                'geo_position': '55.86013028402754;-4.252019430273945',
                'geo_region': 'en_GB',
                'geo_placename': 'Duke of Wellington',
            },
            favicon={
                "ico_icon_16_32_href": 'https://example.com/favicon.ico',
                "png_icon_16_href": 'https://example.com/favicon-16x16.png',
                "png_icon_32_href": 'https://example.com/favicon-32x32.png',
                "png_icon_128_href": 'https://example.com/favicon-128x128.png',
                "png_icon_180_href": 'https://example.com/favicon-180x180.png',
                "png_icon_192_href": 'https://example.com/favicon-192x192.png',
                "png_icon_228_href": 'https://example.com/favicon-228x228.png',
                "png_icon_512_href": 'https://example.com/favicon-512x512.png',
                "set_icon_192_to_apple_touch_icon": True,
            }
        )
        head.append_title('Hello World1', ' - ')
        head.prepend_title('Hello World2', ' - ')

        head.set_meta_tag(name='tag', content='tag-content')
        head.set_meta_tag(name='another-tag', content='another-tag-content', is_http_equiv=True)
        
        head.set_link_tag('canonical', 'https://example.com')

        return f"""\
            <html>
                <head>
                    {head}
                </head>
                <body>
                    <h1>Flask App</h1>
                    <p>Right-Click view source</p>
                </body>
            </html>
            """

    @app.route('/args')
    def using_args():
        head = Head(
            charset='utf-8',
            viewport='width=device-width, initial-scale=1.0',
            title='Hello World',
            base='https://example.com',
            description='This is a test',
            keywords='test, hello, world',
            subject='Hello World',
            rating='General',
            robots='index, follow',
        )
        head.set_referrer_policy(
            policy='no-referrer',
            fallback='origin',
        )
        head.set_google(
            googlebot='index, follow',
            no_sitelinks_search_box=False,
            no_translate=False,
        )
        head.set_verification(
            google='1234567890',
            bing='1234567890',
        )
        head.set_opengraph_website(
            site_name='Example',
            title='Example',
            description='Example',
            url='https://example.com',
            image='https://example.com/image.png',
            image_alt='Example',
            locale='en_US',
        )
        head.set_twitter_card(
            card='summary',
            site_account='@example',
            creator_account='@example',
            title='Example',
            description='Example',
            image='https://example.com/image.png',
            image_alt='Example',
        )
        head.set_geo_position(
            icbm='55.86013028402754, -4.252019430273945',
            geo_position='55.86013028402754;-4.252019430273945',
            geo_region='en_GB',
            geo_placename='Duke of Wellington',
        )
        head.set_favicon(
            ico_icon_16_32_href='https://example.com/favicon.ico',
            png_icon_16_href='https://example.com/favicon-16x16.png',
            png_icon_32_href='https://example.com/favicon-32x32.png',
            png_icon_128_href='https://example.com/favicon-128x128.png',
            png_icon_180_href='https://example.com/favicon-180x180.png',
            png_icon_192_href='https://example.com/favicon-192x192.png',
            png_icon_228_href='https://example.com/favicon-228x228.png',
            png_icon_512_href='https://example.com/favicon-512x512.png',
            set_icon_192_to_apple_touch_icon=True,
        )

        head.append_title('Hello World1', ' - ')
        head.prepend_title('Hello World2', ' - ')

        head.set_meta_tag(name='tag', content='tag-content')
        head.set_meta_tag(name='another-tag', content='another-tag-content', is_http_equiv=True)
        
        head.set_link_tag('canonical', 'https://example.com')

        return f"""\
            <html>
                <head>
                    {head}
                </head>
                <body>
                    <h1>Flask App</h1>
                    <p>Right-Click view source</p>
                </body>
            </html>
            """

    return app

view-source:

<meta charset="utf-8">
<meta name="viewport" content="'width=device-width, initial-scale=1.0'">
<meta http-equiv="Content-Security-Policy" content="default-src 'self'">
<title>Hello World2 - Hello World - Hello World1</title>
<base href="https://example.com">
<meta name="description" content="This is a test">
<meta name="keywords" content="test, hello, world">
<meta name="subject" content="Hello World">
<meta name="rating" content="General">
<meta name="robots" content="index, follow">
<meta name="referrer" content="origin, no-referrer">
<meta name="googlebot" content="index, follow">
<meta name="google-site-verification" content="1234567890">
<meta name="msvalidate.01" content="1234567890">
<meta name="og:type" content="website">
<meta name="og:locale" content="en_US">
<meta name="og:site_name" content="Example">
<meta name="og:title" content="Example">
<meta name="og:description" content="Example">
<meta name="og:image" content="https://example.com/image.png">
<meta name="og:image:alt" content="Example">
<meta name="og:url" content="https://example.com">
<meta name="twitter:card" content="summary">
<meta name="twitter:site" content="@example">
<meta name="twitter:creator" content="@example">
<meta name="twitter:title" content="Example">
<meta name="twitter:description" content="Example">
<meta name="twitter:image" content="https://example.com/image.png">
<meta name="twitter:image:alt" content="Example">
<meta name="ICBM" content="55.86013028402754, -4.252019430273945">
<meta name="geo.position" content="55.86013028402754;-4.252019430273945">
<meta name="geo.region" content="en_GB">
<meta name="geo.placename" content="Duke of Wellington">
<meta name="format-detection" content="telephone=no">
<meta name="tag" content="tag-content">
<meta http-equiv="another-tag" content="another-tag-content">
<link rel="icon" href="https://example.com/favicon-16x16.png" sizes="16x16" type="image/png">
<link rel="icon" href="https://example.com/favicon-32x32.png" sizes="32x32" type="image/png">
<link rel="icon" href="https://example.com/favicon-128x128.png" sizes="128x128" type="image/png">
<link rel="icon" href="https://example.com/favicon-180x180.png" sizes="180x180" type="image/png">
<link rel="icon" href="https://example.com/favicon-192x192.png" sizes="192x192" type="image/png">
<link rel="icon" href="https://example.com/favicon-512x512.png" sizes="512x512" type="image/png">
<link rel="apple-touch-icon" href="https://example.com/favicon-192x192.png">
<link rel="canonical" href="https://example.com">

Project details

Release history Release notifications | RSS feed

3.2

Jul 20, 2024

3.1

Jul 20, 2024

3.0

Jul 19, 2024

2.1

Jul 15, 2024

2.0

Jul 15, 2024

1.9

Jan 30, 2024

1.8

Jan 24, 2024

1.7

Jan 24, 2024

1.6

Dec 5, 2023

1.5

Dec 4, 2023

1.4

Dec 3, 2023

1.3

Dec 2, 2023

1.2

Dec 2, 2023

1.1

Dec 1, 2023

This version

1.0

Dec 1, 2023

0.8

Dec 1, 2023

0.7

Dec 1, 2023

0.6

Dec 1, 2023

0.5

Dec 1, 2023

0.4

Nov 30, 2023

0.3

Nov 29, 2023

0.2

Nov 29, 2023

0.1

Nov 29, 2023

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyhead-1.0.tar.gz (12.5 kB view hashes)

Uploaded Dec 1, 2023 Source

Built Distribution

pyhead-1.0-py3-none-any.whl (10.3 kB view hashes)

Uploaded Dec 1, 2023 Python 3

Hashes for pyhead-1.0.tar.gz

Hashes for pyhead-1.0.tar.gz
Algorithm	Hash digest
SHA256	`7fdee4a3492848bc07fbf214fa5e6fa70b90a605b1835a82f22edb30b6bcece6`
MD5	`31e25c0c94d892e6a47a8d5718f4172e`
BLAKE2b-256	`0a63f566e572a57deb82cf8d9ffaa9d9cbd2f9b942e67e9d3fc1c6b6a96f4085`

Hashes for pyhead-1.0-py3-none-any.whl

Hashes for pyhead-1.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`af84ee09c6822aa06d90405f5b2c7bc0a5bc0bbf02ea4e7453ab18de393174a5`
MD5	`a09449220d31189a137e509badb8d4b7`
BLAKE2b-256	`f283e0550adc122286f69dc0f67ed13ea85198f39c8584ae67c1bcffd28cca00`