├── README.md
└── atomfeed.py


/README.md:
--------------------------------------------------------------------------------
 1 | # atomfeed
 2 | A single file atom feed library with no dependencies
 3 | 
 4 | Based on code from <a href="https://github.com/gtlsgamr/htxyz">gtlsgamr/htxyz</a>. (In particular <a href="https://github.com/gtlsgamr/htxyz/blob/1260e36f74e35cce4e8891a2faef29fd44e075f2/htxyz.py#L166">this function</a>.)
 5 | 
 6 | Demo: The feed on www.gibney.org
 7 | 
 8 | License: GPL v3.0
 9 | 
10 | Example usage:
11 | 
12 | ```python
13 | import atomfeed
14 | 
15 | data = {
16 |     "title"      : "A wonderful feed",
17 |     "id"         : "https://www.example.com",
18 |     "link_web"   : "https://www.example.com",
19 |     "link_feed"  : "https://www.example.com/atom.xml",
20 |     "subtitle"   : "Everything about feeds and stuff",
21 |     "updated"    : "2023-01-07",
22 |     "author_name": "Mr. Example",
23 |     "author_mail": "example@example.com",
24 | }
25 | 
26 | data["entries"] = [{
27 |     "title"  : "Hello World",
28 |     "date"   : "2022-01-08",
29 |     "updated": "2022-01-08",
30 |     "link"   : "https://www.example.com/hello_world",
31 |     "summary": "A greeting to the world",
32 |     "content": "Bonjour!",
33 | }]
34 | 
35 | feed = atomfeed.generate(data)
36 | ```
37 | 


--------------------------------------------------------------------------------
/atomfeed.py:
--------------------------------------------------------------------------------
 1 | from datetime import datetime
 2 | 
 3 | atom_template = """
 4 |     <?xml version="1.0" encoding="utf-8"?>
 5 |     <feed xmlns="http://www.w3.org/2005/Atom">
 6 |         <title>{title}</title>
 7 |         <id>{id}</id>
 8 |         <subtitle>{subtitle}</subtitle>
 9 |         <link href="{link_web}"/>
10 |         <link href="{link_feed}" rel="self"/>
11 |         <updated>{updated}</updated>
12 |         <author>
13 |             <name>{author_name}</name>
14 |             <email>{author_mail}</email>
15 |         </author>
16 |         {entries}
17 |     </feed>
18 | """
19 | 
20 | entry_template = """
21 |     <entry>
22 |         <title>{title}</title>
23 |         <link href='{link}'/>
24 |         <id>{link}</id>
25 |         <updated>{updated}</updated>
26 |         <summary>{summary}</summary>
27 |         <content type="html">
28 |             {content}
29 |         </content>
30 |     </entry>
31 | 
32 | """
33 | 
34 | def template_dict(template, data):
35 |     r = template
36 |     for tag in data.keys():
37 |         r = r.replace('{'+tag+'}',data[tag])
38 |     return r
39 | 
40 | def generate(data):
41 |     feed = ""
42 |     most_recent = "0000-00-00"
43 |     for entry in data["entries"]:
44 |         most_recent = max(most_recent, entry["updated"])
45 |         feed += template_dict(entry_template, entry)
46 |     data["entries"] = feed;
47 |     # If no feed update time was provided, use the one of the most recent entry:
48 |     if not data["updated"]: data["updated"] = most_recent
49 |     return template_dict(atom_template, data)
50 | 


--------------------------------------------------------------------------------