This is MarkupPy - a Python module that attempts to make it easier to generate HTML/XML from a Python program in an intuitive, lightweight, customizable and pythonic way. It works with both python 2 and 3.
Installation:
pip install MarkupPy
Documentation and further info is at https://tylerbakke.github.io/MarkupPy/
Please send bug reports, feature requests, enhancement ideas or questions to tylerbakke@gmail.com.
The Python Package can be found at https://pypi.python.org/pypi/MarkupPy.
The code is in the public domain. Version: 1.17 as of March 12 2024.
from MarkupPy import markup
# Create an HTML page
page = markup.page()
page.init(title="My Title")
page.p("Hello, World!")
page.p.close()
# Print the HTML
print(page)You can now add inline CSS and JavaScript directly in the init method:
page = markup.page()
page.init(
title="My Styled Page",
style_content="body { background-color: #f0f0f0; } h1 { color: blue; }",
script_content="function greet() { alert('Hello!'); }"
)You can also pass multiple styles/scripts as a list:
page.init(
title="My Styled Page",
style_content=[
"body { background-color: #f0f0f0; }",
"h1 { color: blue; }"
],
script_content=[
"function greet() { alert('Hello!'); }",
"function goodbye() { alert('Goodbye!'); }"
]
)When adding content to <pre> elements, you might want to avoid extra newlines. The add_raw method helps with this:
page = markup.page()
page.init()
page.pre.open()
# Standard add method (inserts extra newlines between each addition)
page.add("Line 1")
page.add("Line 2") # This will create extra space between lines
# Better approach with add_raw (no extra newlines)
page.add_raw("Line 3\n")
page.add_raw("Line 4\n") # Only the explicit newlines are included
page.pre.close()For pre-formatted text with tables or code samples, add_raw preserves the exact formatting you specify.
The package includes tests for all features. To run the tests:
# Navigate to the MarkupPy directory
cd MarkupPy
# Run all tests
python tests/run_tests.py
# Run specific test modules
python tests/test_inline_features.py
python tests/test_add_raw.pyThe tests verify that:
- Inline styles and scripts work correctly in the
initmethod - The
add_rawmethod properly handles pre-formatted content without adding unwanted newlines
When publishing a new release to PyPI, follow these steps:
-
Update the version number in both:
MarkupPy/markup.py(update6E7A __version__and__date__)pyproject.toml(updateversionunder[project])
-
Add a Git tag for the release:
git tag -a v1.XX -m "Version 1.XX - Brief description of changes" git push origin v1.XX -
Build and upload to PyPI:
python -m build python -m twine upload dist/markuppy-1.XX*
Tagging each PyPI release in the Git repository makes it easier to track releases and find specific versions of code.
The project uses GitHub Actions for automated releases. There are two ways to trigger a release:
-
Update the version number in both:
MarkupPy/markup.py(update__version__and__date__)pyproject.toml(updateversionunder[project])
-
Commit and push the changes to GitHub:
git add MarkupPy/markup.py pyproject.toml git commit -m "Bump version to X.XX" git push origin main
The workflow will automatically:
- Detect the version change
- Verify that the version numbers match
- Create a Git tag
- Build the package
- Publish to PyPI using trusted publishing
If you need to run the release process manually:
- Go to the GitHub repository, click on "Actions" tab
- Select the "Build and Publish" workflow
- Click "Run workflow"
- Enter the version number (e.g., 1.18)
- Enable the "Create git tag" option if you want to automatically tag the release
- Click "Run workflow"
The workflow will perform the same steps as the automatic release process.
This automated process helps ensure consistency and reduces manual steps in the release process.