Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

amp-renderer

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

amp-renderer

Unofficial Python port of server-side rendering from AMP Optimizer

  • 2.0.1
  • PyPI
  • Socket score

Maintainers
1

AMP Renderer

Python 3.6+ Build Status Coverage

Unofficial Python port of server-side rendering from AMP Optimizer. Supports Python 3.6 and above.

AMP Renderer performs the following optimizations:

  1. Inject the specific layout markup into each AMP element
  2. Insert the AMP runtime styles into the document
  3. Remove the AMP boilerplate styles, if possible
  4. Mark the document as “transformed” with the appropriate tags on the html element
  5. Insert img tags for images with the data-hero attribute

It also makes these formatting updates:

  1. Remove empty class and style tags for AMP HTML elements
  2. Convert tag names and attribute names to lowercase
  3. Convert numerical attribute values to strings
  4. Use double quotes ("") for attributes, and escape double quotes inside attribute values
  5. Remove whitespace between html attributes
  6. If desired, removes comments (disabled by default)
  7. If desired, trims whitespace around HTML attribute values (disabled by default, and not always a good idea)

AMPRenderer can be used on a block of arbitrary HTML, but when used on a full document, it will insert the AMP runtime styles and, if possible, remove the AMP boilerplate styles.

Boilerplate styles can be removed except in these cases:

  • An AMP element uses an unsupported value for the layout attribute
  • amp-audio is used
  • There is at least one amp-experiment active
  • Transformation fails for one or more elements due to an invalid attribute value for media, sizes, or heights
  • Any render-delaying extension is used. Currently this means:
    • amp-dynamic-css-classes
    • amp-story

If boilerplate styles can’t be removed, the attribute no_boilerplate will be set to True after calling render; otherwise it will be False. Until render runs, the no_boilerplate attribute isn’t set at all.

Usage

If using Django, you can use the Django AMP Renderer middleware.

Otherwise, install via PyPI:

pip install amp-renderer

Minimal usage:

from amp_renderer import AMPRenderer

...

RUNTIME_VERSION = "012345678" /* Current AMP runtime version number */
RUNTIME_STYLES = "..." /* Current contents of https://cdn.ampproject.org/v0.css */

renderer = AMPRenderer(
	runtime_version=RUNTIME_VERSION,
	runtime_styles=RUNTIME_STYLES)

original_html = """
    <!doctype html>
    <html ⚡>
      ...
    </html>
"""

result = renderer.render(original_html)

print(result)

Remove comments and/or trim attributes:

renderer.should_strip_comments = True
renderer.should_trim_attributes = True
result = renderer.render(original_html)

print(result)

The AMPRenderer class inherits from HTMLParser, and can be similarly extended.

Testing, etc.

Install requrements:

make install

Sort imports (Requires Python >= 3.8):

make format

Lint (Requires Python >= 3.8):

make lint

Test:

make test

Discussion

There are still some aspects of the official AMP Optimizer implementation that haven’t been addressed yet. PRs welcome.

General

  • Tested against AMP Optimizer’s ServerSideRendering spec
  • Automatic runtime version management

Dynamic attributes

  • Support sizes, media, and heights via CSS injection
  • Group CSS injections for media attributes by shared media queries to reduce necessary bytes
  • Support percent values in heights
  • Warn or fail if CSS injection puts the amp-custom element over the byte limit

Hero Images

  • Inject img tag for amp-imgs with the data-hero attribute
  • Enforce 2-image limit on data-hero
  • Autodetect hero images
  • Support hero image functionality for amp-iframe, amp-video, and amp-video-iframe

Performance

The Python AMP Renderer does not insert preload links into the head of the DOM object for hero images; This can be done by hand for more control over the critical path.

Keywords

FAQs


Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc