kahoot-to-anki 1.2.0__py3-none-any.whl → 1.2.1__py3-none-any.whl

kahoot_to_anki/__init__.py

@@ -1 +1 @@
-__version__ = "1.2.0"
+__version__ = "1.2.1"

kahoot_to_anki/processing.py

@@ -3,6 +3,7 @@ import logging
 import os
 import glob
 from typing import Iterator, Optional
+import html
 
 # Third-party library imports
 import genanki
@@ -89,6 +90,9 @@ def df_processing(data: pd.DataFrame) -> pd.DataFrame:
     # delete duplicated questions
     data = data.drop_duplicates(subset=["Question Number"])
     data = data.fillna("")
+    
+    # HTML-encode special chars
+    data = data.apply(lambda col: col.map(lambda x: html.escape(x) if isinstance(x, str) else x))
 
     data["Possible Answers"] = data[
         ["Answer 1", "Answer 2", "Answer 3", "Answer 4", "Answer 5", "Answer 6"]
@@ -96,7 +100,7 @@ def df_processing(data: pd.DataFrame) -> pd.DataFrame:
 
     # keep only needed columns
     data = data[["Question", "Possible Answers", "Correct Answers"]]
-
+    
     return data
 
 

{kahoot_to_anki-1.2.0.dist-info → kahoot_to_anki-1.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kahoot-to-anki
-Version: 1.2.0
+Version: 1.2.1
 Summary: CLI tool to convert Kahoot quiz reports into Anki flashcards
 Author: Simon Hardmeier
 License-Expression: MIT
@@ -15,10 +15,11 @@ Dynamic: license-file
 # kahoot-to-anki
 [![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](#installation)
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+![PyPI](https://img.shields.io/pypi/v/kahoot-to-anki.svg)
 
 <br>
 
-**kahoot-to-anki** is a command‑line tool that converts exported Kahoot quiz reports (Excel Files) into Anki flashcard decks (.apkg format).<br>
+**kahoot-to-anki** is a command-line tool that converts exported Kahoot quiz reports (`.xlsx` files) into Anki flashcard decks (`.apkg` format).<br>
 Designed for educators, students, and any self-learners to easily turn quiz results into effective spaced‑repetition decks.
 
 ## Installation & Usage
@@ -36,6 +37,9 @@ kahoot-to-anki --inp "./exports" --out "./data" --csv
 ```
 
 ### Option 2: Run with Docker
+You can run **kahoot-to-anki** in a Docker container in three ways:
+
+#### A) Build Image from Source Code (Clone Repo)
 ```
 # Clone Repository
 git clone https://github.com/SimonHRD/kahoot-to-anki.git
@@ -50,12 +54,54 @@ docker build -t kahoot-to-anki .
 docker run --rm kahoot-to-anki --help
 
 # Run with local data
-docker run --rm -v "$(pwd)/data:/app/data" kahoot-to-anki --out "./data" --csv
+docker run --rm -v "$(pwd)/data:/app/data" kahoot-to-anki \
+  --inp "./data" --out "./data" --csv
 ```
 
 On PowerShell:
 ```
-docker run --rm -v ${PWD}\data:/app/data kahoot-to-anki --out "./data" --csv
+docker run --rm -v ${PWD}\data:/app/data kahoot-to-anki \
+  --inp "./data" --out "./data" --csv
+```
+
+#### B) Use a Minimal Dockerfile That Installs from PyPI
+It is not needed to clone the repository, you can just create a minimal Dockerfile:
+```Dockerfile
+FROM python:3.13-slim
+
+WORKDIR /app
+RUN pip install kahoot-to-anki
+ENTRYPOINT ["kahoot-to-anki"]
+```
+Then run:
+```bash
+# Build the image
+docker build -t kahoot-to-anki-pypi .
+
+# Run the tool
+docker run --rm -v "$(pwd)/data:/app/data" kahoot-to-anki-pypi \
+  --inp "./data" --out "./data" --csv
+```
+
+On PowerShell:
+```
+docker run --rm -v ${PWD}\data:/app/data kahoot-to-anki-pypi \
+  --inp "./data" --out "./data" --csv
+```
+
+#### C) Run Without a Dockerfile (Install from PyPI at Runtime)
+If you want to avoid writing a Dockerfile, just run the CLI directly from a fresh Python container. This method downloads everything at runtime in a temporary container. No files or installed packages will persist after the container exits.
+
+```bash
+docker run --rm -v "$(pwd)/data:/app/data" python:3.13-slim \
+  sh -c "pip install kahoot-to-anki && kahoot-to-anki --out ./data --csv"
+```
+
+On PowerShell:
+```
+docker run --rm -v ${PWD}\data:/app/data python:3.13-slim `
+  sh -c "pip install kahoot-to-anki && kahoot-to-anki --out ./data --csv"
+
 ```
 
 ## CLI Arguments

kahoot_to_anki-1.2.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+kahoot_to_anki/__init__.py,sha256=aFv1WGaOhOg9bRuL25OuA7ozD3PSckRRpjaC84FZ7uo,21
+kahoot_to_anki/cli.py,sha256=2tRiIcnbcrPXVPQ8mdeUOHXYP3LO9ExNfp3Uy1FSaFk,4484
+kahoot_to_anki/main.py,sha256=oVmOLqXUnzy1Q0Xnn4Dzr65bFf8Jaw4vYRwvDTSd_ro,936
+kahoot_to_anki/processing.py,sha256=lH2ZXZ3Q5lMYRdeqgXUHF9tlEjjPwzgcoZMwUP7C1DA,4501
+kahoot_to_anki-1.2.1.dist-info/licenses/LICENSE,sha256=HxPBlT4sSfEgRBrX0jZd8WTfM0c31VFgnLaCEWzGMZc,1122
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/test_cli.py,sha256=SL1WEJoA59-G7hRdWg5wOUyCPrjzZvsgPJxAZMPXpWg,3195
+tests/test_processing.py,sha256=swLG2gkcwWm1ZG0T5u6izlhV-2AIsaMKdg174jp3za8,10951
+kahoot_to_anki-1.2.1.dist-info/METADATA,sha256=md7jcX16XeQ_pYebAG2DfMHkxzSXqbcRXpTAR7RFWFo,4409
+kahoot_to_anki-1.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kahoot_to_anki-1.2.1.dist-info/entry_points.txt,sha256=VqCk_PPVpGFgnGCBIlEnz8Y0qUqYV8J2tYNZZa8IRWA,60
+kahoot_to_anki-1.2.1.dist-info/top_level.txt,sha256=aTMCk83rMZjWFZ556EHLIxVOgEawIWsMZzRpR3IPQ1w,21
+kahoot_to_anki-1.2.1.dist-info/RECORD,,

kahoot_to_anki-1.2.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-kahoot_to_anki/__init__.py,sha256=Btl_98iBIXFtvGx47MqpfbaEVYoOMPBQn9bao7UASkQ,21
-kahoot_to_anki/cli.py,sha256=2tRiIcnbcrPXVPQ8mdeUOHXYP3LO9ExNfp3Uy1FSaFk,4484
-kahoot_to_anki/main.py,sha256=oVmOLqXUnzy1Q0Xnn4Dzr65bFf8Jaw4vYRwvDTSd_ro,936
-kahoot_to_anki/processing.py,sha256=Ku8nFhgWpprmYWdLL6f-T8P7J_SmMuQD2NLVCQQErCs,4346
-kahoot_to_anki-1.2.0.dist-info/licenses/LICENSE,sha256=HxPBlT4sSfEgRBrX0jZd8WTfM0c31VFgnLaCEWzGMZc,1122
-tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/test_cli.py,sha256=SL1WEJoA59-G7hRdWg5wOUyCPrjzZvsgPJxAZMPXpWg,3195
-tests/test_processing.py,sha256=swLG2gkcwWm1ZG0T5u6izlhV-2AIsaMKdg174jp3za8,10951
-kahoot_to_anki-1.2.0.dist-info/METADATA,sha256=I8iBo7bvvBQMyMticSKPHsILRASFMaB0VRi45EWhv3E,2953
-kahoot_to_anki-1.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kahoot_to_anki-1.2.0.dist-info/entry_points.txt,sha256=VqCk_PPVpGFgnGCBIlEnz8Y0qUqYV8J2tYNZZa8IRWA,60
-kahoot_to_anki-1.2.0.dist-info/top_level.txt,sha256=aTMCk83rMZjWFZ556EHLIxVOgEawIWsMZzRpR3IPQ1w,21
-kahoot_to_anki-1.2.0.dist-info/RECORD,,