crieur 1.3.2__py3-none-any.whl → 1.5.0__py3-none-any.whl

crieur/__init__.py

@@ -1,4 +1,4 @@
 from pathlib import Path
 
-VERSION = "1.3.2"
+VERSION = "1.5.0"
 ROOT_DIR = Path(__file__).parent

crieur/cli.py

@@ -9,7 +9,7 @@ import httpx
 from minicli import cli, run
 
 from . import VERSION
-from .generator import generate_html
+from .generator import generate_feed, generate_html
 from .models import collect_authors, collect_keywords, configure_numero
 from .utils import each_file_from, each_folder_from
 
@@ -29,6 +29,7 @@ def generate(
     source_path: Path = Path() / "sources",
     templates_path: Path = Path(__file__).parent / "templates",
     without_statics: bool = False,
+    feed_limit: int = 10,
 ):
     """Generate a new revue website.
 
@@ -39,6 +40,7 @@ def generate(
     :source_path: Path where stylo source were downloaded (default: /sources/).
     :template_path: Path where templates are located (default: @crieur/templates/).
     :without_statics: Do not copy statics if True (default: False).
+    :feed_limit: Number of max items in the feed (default: 10).
     """
     numeros = []
     for numero in each_folder_from(source_path):
@@ -58,6 +60,7 @@ def generate(
         target_path,
         templates_path,
     )
+    generate_feed(title, base_url, numeros, extra_vars, target_path, number=feed_limit)
 
     if not without_statics:
         static_path_local = Path(__file__).parent / "statics"

crieur/generator.py

@@ -1,8 +1,10 @@
 import json
 import locale
 import shutil
+from datetime import datetime, timedelta, timezone
 
 import mistune
+from feedgen.feed import FeedGenerator
 from jinja2 import Environment as Env
 from jinja2 import FileSystemLoader
 from slugify import slugify
@@ -83,3 +85,38 @@ def generate_html(
         author_folder = target_path / "auteur" / author.slug
         author_folder.mkdir(parents=True, exist_ok=True)
         (author_folder / "index.html").write_text(content)
+
+
+def generate_feed(title, base_url, numeros, extra_vars, target_path, number, lang="fr"):
+    feed = FeedGenerator()
+    feed.id(base_url)
+    feed.title(title)
+    feed.link(href=base_url, rel="alternate")
+    feed.link(href=f"{base_url}feed.xml", rel="self")
+    feed.language(lang)
+
+    articles = sorted(
+        [article for numero in numeros for article in numero.articles], reverse=True
+    )
+
+    for article in articles[:number]:
+        feed_entry = feed.add_entry(order="append")
+        feed_entry.id(f"{base_url}{article.url}")
+        feed_entry.title(article.title_f)
+        feed_entry.link(href=f"{base_url}{article.url}")
+        feed_entry.updated(
+            datetime.combine(
+                article.date,
+                datetime.min.time(),
+                tzinfo=timezone(timedelta(hours=-4), "ET"),
+            )
+        )
+        for author in article.authors:
+            feed_entry.author(name=str(author))
+        feed_entry.summary(summary=md(article.content_md), type="html")
+        if article.keywords:
+            for keyword in article.keywords:
+                feed_entry.category(term=keyword.name)
+
+    feed.atom_file(target_path / "feed.xml", pretty=True)
+    print(f"Generated meta-feed with {number} items.")

crieur/models.py

@@ -1,4 +1,5 @@
 from dataclasses import dataclass
+from datetime import datetime
 from typing import Optional
 
 from dataclass_wizard import DatePattern, DumpMeta, YAMLWizard
@@ -40,6 +41,15 @@ class Numero(YAMLWizard):
                 print(f"Metadata error in `{article['article']['title']}`:")
                 print(e)
                 exit(1)
+            if not loaded_article.date:
+                print(f"Article `{loaded_article.title}` skipped (no date).")
+                continue
+            if loaded_article.date > datetime.today().date():
+                print(
+                    f"Article `{loaded_article.title}` skipped "
+                    f"(future date: {loaded_article.date})."
+                )
+                continue
             if not loaded_article.id:
                 loaded_article.id = article_slug
             loaded_article.content_md = (
@@ -79,6 +89,10 @@ class Article(YAMLWizard):
             return NotImplemented
         return self.date < other.date
 
+    @property
+    def url(self):
+        return f"numero/{self.numero.slug}/article/{self.id}/"
+
 
 def configure_numero(yaml_path):
     # Preserves abstract_fr key (vs. abstract-fr) when converting to_yaml()

crieur/templates/base.html

@@ -17,6 +17,8 @@
   <link rel="icon" href="data:;base64,iVBORw0KGgo=" />
   <link rel="stylesheet"
         href="{{ base_url }}statics/pico.css" />
+  <link rel="alternate" type="application/atom+xml"
+        title="Feed" href="{{ base_url }}feed.xml">
   <style>
     h1 {
         text-align: center;

crieur/templates/homepage.html

@@ -97,7 +97,7 @@
       </header>
       <ul>
         {% for article in numero.articles %}
-          <li><a href="{{ base_url }}numero/{{ numero.slug }}/article/{{ article.id }}/">{{ article.title_f }}</a></li>
+          <li><a href="{{ base_url }}{{ article.url }}">{{ article.title_f }}</a></li>
         {% endfor %}
       </ul>
     </article>

crieur/templates/numero.html

@@ -59,7 +59,7 @@
   {% for article in numero.articles %}
     <article>
       <header>
-        <h3><a href="{{ base_url }}numero/{{ numero.slug }}/article/{{ article.id }}/">{{ article.title_f }}</a></h3>
+        <h3><a href="{{ base_url }}{{ article.url }}">{{ article.title_f }}</a></h3>
       </header>
       {{ article.subtitle_f|markdown }}
       {% if article.authors %}

{crieur-1.3.2.dist-info → crieur-1.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crieur
-Version: 1.3.2
+Version: 1.5.0
 Summary: A Static Revue Generator.
 Project-URL: Homepage, https://gitlab.huma-num.fr/ecrinum/crieur
 Project-URL: Issues, https://gitlab.huma-num.fr/ecrinum/crieur/-/issues
@@ -684,6 +684,7 @@ Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Text Processing :: Markup :: Markdown
 Requires-Python: >=3.8
 Requires-Dist: dataclass-wizard
+Requires-Dist: feedgen>=1.0.0
 Requires-Dist: httpx
 Requires-Dist: jinja2
 Requires-Dist: minicli
@@ -753,6 +754,7 @@ cog.out(f"```\n{help}\n```")
                        [--extra-vars EXTRA_VARS] [--target-path TARGET_PATH]
                        [--source-path SOURCE_PATH]
                        [--templates-path TEMPLATES_PATH] [--without-statics]
+                       [--feed-limit FEED_LIMIT]
 
 options:
   -h, --help            show this help message and exit
@@ -767,6 +769,8 @@ options:
                         /sources/).
   --templates-path TEMPLATES_PATH
   --without-statics     Do not copy statics if True (default: False).
+  --feed-limit FEED_LIMIT
+                        Number of max items in the feed (default: 10).
 
 ```
 <!-- [[[end]]] -->

crieur-1.5.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+crieur/__init__.py,sha256=E991QFU_-kmyKseQrDTcr_YjRxyBnwSe8uXpcBu-Yw8,77
+crieur/__main__.py,sha256=bYt9eEaoRQWdejEHFD8REx9jxVEdZptECFsV7F49Ink,30
+crieur/cli.py,sha256=JASr1HoM6vx7ZRi3vdY6NVKqHxcNerKc0Bklnoex6HU,5727
+crieur/generator.py,sha256=MURqkacHmqj8MpC6loQqrKQOk-lEYrknH-p8rFPCTmw,4388
+crieur/models.py,sha256=Dc7zxYAEFM7MCm5RKu8NdN272FOSWCgwurpZ5rqSKp4,6566
+crieur/utils.py,sha256=kIdxpd5LgVv13Lx2aEXzjQttBDtcppRlwNsH0vwX8f0,1566
+crieur/statics/pico.css,sha256=VdrimW9PLcEIzqJ__s062OrwBj_Jb6jZIwbtdqOtM-w,93407
+crieur/templates/article.html,sha256=4Y1sjBR1nM_ff4yVGgiVlZU1tmnfBMXAjTTSAhqoiA4,1288
+crieur/templates/author.html,sha256=1VHZi6Wld1gWYPfeW3cEJ2ULOKrp9xoCVRhDjPUDdHg,420
+crieur/templates/base.html,sha256=4ZOLAnmle0_m8Y3lWT6wcH8f-_7SymxEDeIUzDQNnks,1626
+crieur/templates/homepage.html,sha256=7YG7kA4AFuyrSuqWeFAVj09ogwsybE7w0-NKMLWms5s,2994
+crieur/templates/keyword.html,sha256=Hv3Ep3R6oN5pBw14gfQT-aeqEiuFiatmVZLWn5hR1e4,428
+crieur/templates/numero.html,sha256=F7hCaAHJ1WRWxD_zfhJzyLaiwXblJWJF7DUTy41Mnu8,1849
+crieur-1.5.0.dist-info/METADATA,sha256=ICGtHO0FWF7N8rdSRTDv5QKCIlxZkoiaNbxpP4VJiqQ,45024
+crieur-1.5.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+crieur-1.5.0.dist-info/entry_points.txt,sha256=edmbmPxs9QXyvSMpPJBDPGw3vZOJEKqXJhysYNx3QSM,43
+crieur-1.5.0.dist-info/licenses/LICENSE,sha256=F5acw9_laHeyi4wPmQyf_ttyz81VqCIwScwO8C1FhXU,34519
+crieur-1.5.0.dist-info/RECORD,,

crieur-1.3.2.dist-info/RECORD

@@ -1,18 +0,0 @@
-crieur/__init__.py,sha256=DJCsh5YCCUnPqMvARcxvMvW9_H2ofVnJ1R5mclHnE5g,77
-crieur/__main__.py,sha256=bYt9eEaoRQWdejEHFD8REx9jxVEdZptECFsV7F49Ink,30
-crieur/cli.py,sha256=YPzrXMG0DzXBWpCVK1SEG5v6A32gezR54D8Kj2DDNYA,5534
-crieur/generator.py,sha256=Vc0oOLsQMcKWQLkzHLrJf5f1W_qmoxwYsc_ktHFZjtg,3046
-crieur/models.py,sha256=512IUzmQ000z-m9sBojPR9WVfQDpNne6Nq2LaLPS9Z0,6042
-crieur/utils.py,sha256=kIdxpd5LgVv13Lx2aEXzjQttBDtcppRlwNsH0vwX8f0,1566
-crieur/statics/pico.css,sha256=VdrimW9PLcEIzqJ__s062OrwBj_Jb6jZIwbtdqOtM-w,93407
-crieur/templates/article.html,sha256=4Y1sjBR1nM_ff4yVGgiVlZU1tmnfBMXAjTTSAhqoiA4,1288
-crieur/templates/author.html,sha256=1VHZi6Wld1gWYPfeW3cEJ2ULOKrp9xoCVRhDjPUDdHg,420
-crieur/templates/base.html,sha256=6ih6RryTPXZxR6tqlbRHPpOFUNRu90SPvdfKNLHcRRM,1522
-crieur/templates/homepage.html,sha256=IgYc3cyw-52U3HN1oada0drkzT0fPNyFcdiG6Pwcr9o,3027
-crieur/templates/keyword.html,sha256=Hv3Ep3R6oN5pBw14gfQT-aeqEiuFiatmVZLWn5hR1e4,428
-crieur/templates/numero.html,sha256=b9J6aW_h9ao7XlWA0Xc390ahOH5lHDI8A4iDq6tEZTo,1882
-crieur-1.3.2.dist-info/METADATA,sha256=Fpzpq1CXeGyJ1QVw-6jqNjMGbkRvMJMvCBasDOLLL_Y,44848
-crieur-1.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-crieur-1.3.2.dist-info/entry_points.txt,sha256=edmbmPxs9QXyvSMpPJBDPGw3vZOJEKqXJhysYNx3QSM,43
-crieur-1.3.2.dist-info/licenses/LICENSE,sha256=F5acw9_laHeyi4wPmQyf_ttyz81VqCIwScwO8C1FhXU,34519
-crieur-1.3.2.dist-info/RECORD,,