Merge branch 'main' into feature/index

build.py

@@ -14,3 +14,4 @@ bd.build_edition("EA")
 bd.build_edition("NEA")
 bd.build_assets()
 bd.build_solutions()
+bd.build_zip()

latex/settings.tex

@@ -1087,6 +1087,28 @@
 \pgfcirc@activate@bipole@simple{l}{channelcoder}
 \makeatother
 
+% Channel Decoder
+\makeatletter
+\ctikzset{bipoles/channeldecoder/width/.initial=.7}
+
+\pgfcirc@define@twoports{blocks}
+{}
+{\ctikzvalof{bipoles/channeldecoder/width}}
+{channeldecoder}
+{\ctikzvalof{bipoles/channeldecoder/width}}
+{\ctikzvalof{bipoles/channeldecoder/width}}
+{
+    \pgfcirc@twoport@draw@splitline
+    %
+    \pgf@circ@text@strokecolor
+    \pgftext[center,x=0.25\pgf@circ@res@left,y=0.6\pgf@circ@res@up]{\tiny 01+01}
+    \pgftext[center,x=0.55\pgf@circ@res@right,y=0.6\pgf@circ@res@down]{\tiny 01}
+}
+
+\pgfcirc@activate@bipole@simple{l}{channeldecoder}
+\makeatother
+
+
 % Source Coder
 \makeatletter
 \ctikzset{bipoles/sourcecoder/width/.initial=.7}
@@ -1108,6 +1130,27 @@
 \pgfcirc@activate@bipole@simple{l}{sourcecoder}
 \makeatother
 
+% Source Decoder
+\makeatletter
+\ctikzset{bipoles/sourcedecoder/width/.initial=.7}
+
+\pgfcirc@define@twoports{blocks}
+{}
+{\ctikzvalof{bipoles/sourcedecoder/width}}
+{sourcedecoder}
+{\ctikzvalof{bipoles/sourcedecoder/width}}
+{\ctikzvalof{bipoles/sourcedecoder/width}}
+{
+    \pgfcirc@twoport@draw@splitline
+    %
+    \pgf@circ@text@strokecolor
+    \pgftext[center,x=0.55\pgf@circ@res@left,y=0.6\pgf@circ@res@up]{\tiny 01}
+    \pgftext[center,x=0.30\pgf@circ@res@right,y=0.6\pgf@circ@res@down]{\tiny 0101}
+}
+
+\pgfcirc@activate@bipole@simple{l}{sourcedecoder}
+\makeatother
+
 % Mapper
 \makeatletter
 \ctikzset{bipoles/mapper/width/.initial=.7}
@@ -1148,3 +1191,44 @@
 
 \pgfcirc@activate@bipole@simple{l}{mapper}
 \makeatother
+
+% Demapper
+\makeatletter
+\ctikzset{bipoles/demapper/width/.initial=.7}
+
+\pgfcirc@define@twoports{blocks}
+{}
+{\ctikzvalof{bipoles/demapper/width}}
+{demapper}
+{\ctikzvalof{bipoles/demapper/width}}
+{\ctikzvalof{bipoles/demapper/width}}
+{
+    \pgfcirc@twoport@draw@splitline
+    %
+    \pgf@circ@text@strokecolor
+    %
+    \pgfpathmoveto{\pgfpoint{0.50\pgf@circ@res@left}{+0.25\pgf@circ@res@up}}
+    \pgfpathlineto{\pgfpoint{0.50\pgf@circ@res@left}{+0.75\pgf@circ@res@up}}
+    \pgfusepath{draw}
+    %
+    \pgfpathmoveto{\pgfpoint{0.25\pgf@circ@res@left}{+0.50\pgf@circ@res@up}}
+    \pgfpathlineto{\pgfpoint{0.75\pgf@circ@res@left}{+0.50\pgf@circ@res@up}}
+    \pgfusepath{draw}
+    %
+    \pgfpathcircle{\pgfpoint{0.65\pgf@circ@res@left}{+0.65\pgf@circ@res@up}}{0.05\pgf@circ@res@up}
+    \pgfusepath{fill}
+    %
+    \pgfpathcircle{\pgfpoint{0.35\pgf@circ@res@left}{+0.65\pgf@circ@res@up}}{0.05\pgf@circ@res@up}
+    \pgfusepath{fill}
+    %
+    \pgfpathcircle{\pgfpoint{0.65\pgf@circ@res@left}{+0.35\pgf@circ@res@up}}{0.05\pgf@circ@res@up}
+    \pgfusepath{fill}
+    %
+    \pgfpathcircle{\pgfpoint{0.35\pgf@circ@res@left}{+0.35\pgf@circ@res@up}}{0.05\pgf@circ@res@up}
+    \pgfusepath{fill}
+    %
+    \pgftext[center,x=0.55\pgf@circ@res@right,y=-0.6\pgf@circ@res@up]{\tiny 01}
+}
+
+\pgfcirc@activate@bipole@simple{l}{demapper}
+\makeatother

main.py

@@ -23,6 +23,7 @@ def main(
     output: Annotated[str | None, typer.Option("--output", "-o", help="Destination directory to build to.")] = None,
     render_editions: Annotated[bool, typer.Option(help="Skip building editions.")] = True,
     render_solutions: Annotated[bool, typer.Option(help="Skip building solutions.")] = True,
+    build_zip: Annotated[bool, typer.Option(help="Whether to build a zip file of the output.")] = False,
 ) -> None:
     conf = config.Config(content_path=input, build_path=output)
     bd = build.Build(conf)
@@ -42,6 +43,10 @@ def main(
     # Copy assets to build folder
     bd.build_assets()
 
+    if build_zip:
+        # Build zip file of output
+        bd.build_zip()
+
 
 if __name__ == "__main__":
     app()

src/build.py

@@ -1,7 +1,9 @@
 import json
+import os
 import random
 import re
 import shutil
+import zipfile
 from pathlib import Path
 
 from jinja2 import Environment, FileSystemLoader
@@ -515,3 +517,39 @@ class Build:
                         page = solution_template.render(question=question, solution=solution, number=solution_file.stem)
                         page = self.__build_page(page, course_wrapper=False)
                         file.write(page)
+
+    def build_zip(self, zip_name: str | None = None) -> Path:
+        """Create a zip archive of the complete build output directory.
+
+        The zip file is written into the build directory itself and is excluded
+        from the archive contents.
+        """
+
+        build_dir = self.config.p_build
+        build_dir.mkdir(parents=True, exist_ok=True)
+
+        zip_path = build_dir / (zip_name if zip_name is not None else f"{build_dir.name}.zip")
+        zip_path = zip_path.resolve()
+
+        # If a previous archive exists, remove it first to avoid zipping stale data.
+        if zip_path.exists():
+            zip_path.unlink()
+
+        tqdm.write(f"Creating zip archive: {zip_path}")
+
+        with zipfile.ZipFile(zip_path, "w", compression=zipfile.ZIP_DEFLATED) as zf:
+            # os.walk includes dotfiles; sort for stable archives.
+            for root, dirs, files in os.walk(build_dir):
+                dirs.sort()
+                files.sort()
+
+                root_path = Path(root)
+                for filename in files:
+                    file_path = (root_path / filename).resolve()
+                    if file_path == zip_path:
+                        continue
+
+                    arcname = file_path.relative_to(build_dir.resolve())
+                    zf.write(file_path, arcname=arcname)
+
+        return zip_path