A Python SSR library for dynamically rendering static websites
Project description
Python-SSR: Server-Side Rendering with Python
A library for rendering HTML pages on the server, allowing dynamic content generation from APIs.
Table of Contents
- What is SSR
- Use Cases
- Installation
- Usage
- Example Structure for Usage
- Example of HTML
- Contribution
- Running Tests
What is SSR
Server-Side Rendering (SSR) is a technique where the content of the application is generated on the server and sent to the client as complete HTML. This provides better initial performance and allows search engines to index content more effectively, improving SEO optimization. With SSR, applications offer a faster and smoother user experience, especially on mobile devices, making content delivery more efficient and accessible.
Use Cases
Python-SSR is ideal for those who need to generate static pages that dynamically update with data from APIs. Here are some use cases:
- Personal Blogs: Dynamically update the main and post pages with the latest content at defined intervals.
- Report Pages: Generate pages with report data that automatically update, using APIs that provide statistics or charts.
- Dynamic Landing Pages: Create landing pages that update as the API receives new data, such as promotions or product updates.
Installation
To install the library, you can use the following command:
pip install python-ssr
Usage
-
Create a configuration file (
config.json):The file should contain the following structure:
{ "pages": { "index": { "api": { "url": "http://127.0.0.1:5000/api/index", "method": "GET" }, "render_interval": 5 } } }
Each page corresponds to an HTML template file in /html/, and the result is rendered in /dist/. The defined API returns JSON, which is used to populate the template. This JSON can come from local APIs, as in the example, or any external API you wish to use.
-
Start Rendering:
To start rendering, you should call the
start_renderingfunction and pass the path of your configuration file.from python_ssr import start_rendering if __name__ == "__main__": start_rendering("config.json")
Example Structure for Usage
Here is an example directory structure for using the library:
your_project/
- config.json
- html/
- assets/
- (Your folders and files)
- index.html
- (Your HTML files)
- dist/
- (rendered HTML files)
- main.py
Example of index.html
An example HTML file that uses variables for rendering:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="stylesheet" href="assets/style.css">
<title>{{ title }}</title>
</head>
<body>
<h1>{{ title }}</h1>
<p>{{ description }}</p>
<script src="assets/script.js"></script>
</body>
</html>
Contribution
Feel free to explore, open issues, suggest pull requests, or just enjoy learning from the code!
Future Implementations: Integration with AWS S3
A planned future improvement for the project is the possibility of integrating Python-SSR with AWS S3. This will allow the generated static pages to be automatically uploaded to a bucket on S3, keeping the site online and always updated with the latest content without the need to manage servers.
It’s not implemented yet, but it would be extremely useful for those looking to automate the update of static pages hosted in the cloud, keeping everything synchronized with real-time APIs.
Running Tests
To ensure that all library features are working correctly, it is important to run tests. You can do this using Python unittest module.
Follow the steps below to run the tests:
-
Navigate to the root directory of your project.
-
Execute the following command:
python -m unittest discover -s tests -p "*.py"
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file python-ssr-0.0.4.tar.gz.
File metadata
- Download URL: python-ssr-0.0.4.tar.gz
- Upload date:
- Size: 8.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 04575783c39e9ca41bd7ffc7ec60db8e2536685d2a8672306ecb6a2f5339b8fb |
|
| MD5 | b5e4e77a314faa954f3887920389f9a6 |
|
| BLAKE2b-256 | f5e9616f4a2bb5c8c3bc47d686275b3b97e6122aeeef8e08e2b31fd99cdebf90 |
File details
Details for the file python_ssr-0.0.4-py3-none-any.whl.
File metadata
- Download URL: python_ssr-0.0.4-py3-none-any.whl
- Upload date:
- Size: 8.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 63e9cd05b04533fae05c7c9afeb968cfbeb60bf6894ddd3b3898a9be35e313e0 |
|
| MD5 | 49ebbe4210a376b95a2e79769c3b0997 |
|
| BLAKE2b-256 | 41973ada7f8cf89462bbba9095e53cfa9090fb8b6500107a195ad76ea747e633 |
