kahoot-to-anki 1.0.0__tar.gz → 1.1.0__tar.gz

kahoot_to_anki-1.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: kahoot-to-anki
+Version: 1.1.0
+Summary: CLI tool to convert Kahoot quiz reports into Anki flashcards
+Author: Simon Hardmeier
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: genanki
+Requires-Dist: pandas
+Requires-Dist: openpyxl
+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)
+
+<br>
+
+**kahoot-to-anki** is a command‑line tool that converts exported Kahoot quiz reports (Excel 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
+### Option 1: Install via pip
+```
+pip install kahoot-to-anki
+```
+Then run:
+```
+kahoot-to-anki --help
+```
+Example: Process all Kahoot Exports in the `./exports/` folder and write the flashcard deck and CSV file to `./data/`:
+```
+kahoot-to-anki --inp "./exports" --out "./data" --csv
+```
+
+### Option 2: Run with Docker
+```
+# Clone Repository
+git clone https://github.com/SimonHRD/kahoot-to-anki.git
+
+# Move into Repository
+cd kahoot-to-anki
+
+# Build docker image with the kahoot-to-anki tag
+docker build -t kahoot-to-anki .
+
+# Check help command
+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
+```
+
+On PowerShell:
+```
+docker run --rm -v ${PWD}\data:/app/data kahoot-to-anki --out "./data" --csv
+```
+
+## CLI Arguments
+You can provide either a single Kahoot Excel file or a directory containing multiple `.xlsx` files as input.<br>
+All valid Excel files in the directory will be processed.
+
+| Argument             | Description                                                                    |
+|----------------------|--------------------------------------------------------------------------------|
+| `-i`, `--inp`        | Path to the input Excel file or directory (default: `./data`)                  |
+| `-o`, `--out`        | Path to the output directory for the Anki deck (default: `./`)                 |
+| `--sheet`            | The Excel Sheet with the raw Kahoot quiz data (default: `RawReportData Data`)  |    
+| `--csv`, `--no-csv`  | Enable or disable CSV export of the questions (default: disabled)              |
+| `-t`, `--title`      | Title of the generated Anki deck (default: `"Kahoot"`)                         |
+
+
+## Example
+An example Kahoot export file is available in `data/`. The generated deck will be saved as `anki.apkg` in the specified `--out` directory (default: `./`).
+
+## License
+MIT — see [LICENSE](./LICENSE)

kahoot_to_anki-1.1.0/README.md

@@ -0,0 +1,64 @@
+# 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)
+
+<br>
+
+**kahoot-to-anki** is a command‑line tool that converts exported Kahoot quiz reports (Excel 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
+### Option 1: Install via pip
+```
+pip install kahoot-to-anki
+```
+Then run:
+```
+kahoot-to-anki --help
+```
+Example: Process all Kahoot Exports in the `./exports/` folder and write the flashcard deck and CSV file to `./data/`:
+```
+kahoot-to-anki --inp "./exports" --out "./data" --csv
+```
+
+### Option 2: Run with Docker
+```
+# Clone Repository
+git clone https://github.com/SimonHRD/kahoot-to-anki.git
+
+# Move into Repository
+cd kahoot-to-anki
+
+# Build docker image with the kahoot-to-anki tag
+docker build -t kahoot-to-anki .
+
+# Check help command
+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
+```
+
+On PowerShell:
+```
+docker run --rm -v ${PWD}\data:/app/data kahoot-to-anki --out "./data" --csv
+```
+
+## CLI Arguments
+You can provide either a single Kahoot Excel file or a directory containing multiple `.xlsx` files as input.<br>
+All valid Excel files in the directory will be processed.
+
+| Argument             | Description                                                                    |
+|----------------------|--------------------------------------------------------------------------------|
+| `-i`, `--inp`        | Path to the input Excel file or directory (default: `./data`)                  |
+| `-o`, `--out`        | Path to the output directory for the Anki deck (default: `./`)                 |
+| `--sheet`            | The Excel Sheet with the raw Kahoot quiz data (default: `RawReportData Data`)  |    
+| `--csv`, `--no-csv`  | Enable or disable CSV export of the questions (default: disabled)              |
+| `-t`, `--title`      | Title of the generated Anki deck (default: `"Kahoot"`)                         |
+
+
+## Example
+An example Kahoot export file is available in `data/`. The generated deck will be saved as `anki.apkg` in the specified `--out` directory (default: `./`).
+
+## License
+MIT — see [LICENSE](./LICENSE)

kahoot_to_anki-1.1.0/kahoot_to_anki/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.1.0"

kahoot_to_anki-1.1.0/kahoot_to_anki/cli.py

@@ -0,0 +1,118 @@
+# Standard library imports
+import argparse
+from dataclasses import dataclass
+import logging
+import os
+import glob
+
+# Constants
+DEFAULT_INPUT_DIRECTORY = "./data"
+DEFAULT_OUTPUT_DIRECTORY = "./"
+DEFAULT_DECK_TITLE = "Kahoot"
+KAHOOT_EXCEL_SHEET_NAME_RAW_DATA = "RawReportData Data"
+
+# Dataclass to hold CLI arguments
+@dataclass
+class CLIArgs:
+    input_path: str
+    output_path: str
+    sheet: str
+    export_csv: bool
+    deck_title: str
+    
+
+def get_commandline_arguments() -> CLIArgs:
+    """
+    Parses the command line arguments and returns a CLIArgs dataclass instance.
+
+    :return: A CLIArgs dataclass instance
+    :rtype: CLIArgs
+    """
+    parser = argparse.ArgumentParser(description="Create Anki Deck from Kahoot answer")
+    parser.add_argument(
+        "-i",
+        "--inp",
+        default=DEFAULT_INPUT_DIRECTORY,
+        help=f"Path to the directory containing input Excel files or a single input Excel file. If a directory is "
+        f"provided, all Excel files in the directory will be processed. Default: {DEFAULT_INPUT_DIRECTORY}",
+        type=str,
+    )
+    parser.add_argument(
+        "-o",
+        "--out",
+        default=DEFAULT_OUTPUT_DIRECTORY,
+        help="Path to the directory where the Anki flashcards package will be generated. "
+        "If not specified, the package will be created in the current working directory.",
+        type=str,
+    )
+    parser.add_argument(
+        "--sheet",
+        default=KAHOOT_EXCEL_SHEET_NAME_RAW_DATA,
+        help=f"The Excel Sheet Name with the Kahoot Raw Data. Default {KAHOOT_EXCEL_SHEET_NAME_RAW_DATA}",
+        type=str,
+    )
+    parser.add_argument(
+        "--csv",
+        action=argparse.BooleanOptionalAction,
+        default=False,
+        help="Enable or disable CSV export of question data (default: disabled).",
+    )
+    parser.add_argument(
+        "-t",
+        "--title",
+        default=DEFAULT_DECK_TITLE,
+        help="Name of the Anki deck to be created. "
+        f"If not specified, the default deck name '{DEFAULT_DECK_TITLE}' will be used.",
+        type=str,
+    )
+    args = parser.parse_args()
+
+    return CLIArgs(
+        input_path=os.path.abspath(args.inp),
+        output_path=os.path.abspath(args.out),
+        sheet=args.sheet,
+        export_csv=args.csv,
+        deck_title=args.title
+    )
+
+
+def validation(input_directory: str, output_directory: str) -> None:
+    """
+    This function validates the command line arguments, checking if the input path is a valid Excel file or directory
+    and if the output path is a valid directory.
+    The input path needs to be an Excel file or a directory that contains Excel files.
+    The output path needs to be a directory and not a file.
+
+    :param input_directory: The path of the input Excel or directory
+    :param output_directory: The path of the output directory
+    :return: None
+    :rtype: None
+    """
+    # Check if input is a file
+    if not os.path.exists(input_directory):
+        logging.error(f"Input directory {input_directory} does not exist!")
+        raise FileNotFoundError(f"Input directory {input_directory} does not exist!")
+    elif (
+        os.path.isfile(input_directory)
+        and os.path.splitext(input_directory)[-1] != ".xlsx"
+    ):
+        logging.error("Input file is not an excel file!")
+        raise ValueError("Input file is not an excel file!")
+    elif os.path.isdir(input_directory):
+        input_excels = os.path.join(input_directory, "*.xlsx")
+        if not glob.glob(input_excels):
+            logging.error("Input directory does not contain any excel files!")
+            raise FileNotFoundError("Input directory does not contain any excel files!")
+
+    # Check output directory and create when not existing
+    if not os.path.isdir(output_directory):
+        logging.error("Output is not a directory!")
+        raise ValueError("Output is not a directory!")
+    if not os.path.exists(output_directory):
+        try:
+            os.makedirs(output_directory)
+        except OSError as e:
+            logging.error(
+                "Failed to create output directory '%s': %s", output_directory, str(e)
+            )
+            raise

kahoot_to_anki-1.1.0/kahoot_to_anki/main.py

@@ -0,0 +1,40 @@
+import os
+import logging
+import sys
+
+from kahoot_to_anki.cli import get_commandline_arguments, validation
+from kahoot_to_anki.processing import get_questions, make_anki
+
+# Configure logging settings
+logging.basicConfig(level=logging.INFO)
+
+
+def main() -> None:
+    # Check command line arguments
+    args = get_commandline_arguments()
+
+    validation(args.input_path, args.output_path)
+
+    df = get_questions(input_directory=args.input_path, sheet_name=args.sheet)
+    
+    if df.empty:
+        logging.warning("No Kahoot questions found to process. Exiting.")
+        sys.exit(0)
+
+    if args.export_csv:
+        df.to_csv(
+            os.path.join(args.output_path, "kahoot.csv"),
+            sep=";",
+            index=False,
+            encoding="utf-8-sig",
+        )
+        
+    make_anki(df, args.output_path, args.deck_title)
+
+
+if __name__ == "__main__":
+    main()
+    
+    
+    
+    

kahoot_to_anki-1.1.0/kahoot_to_anki/processing.py

@@ -0,0 +1,141 @@
+# Standard library imports
+import logging
+import os
+import glob
+from typing import Iterator, Optional
+
+# Third-party library imports
+import genanki
+import pandas as pd
+
+
+def get_questions(input_directory: str, sheet_name: str) -> pd.DataFrame:
+    """
+    Extracts all the kahoot questions out of the Excel file(s)
+
+    :param input_directory: The path to the input directory or Excel file
+    :param sheet_name: The Excel sheet name with the Kahoot Answers
+    :return: All the questions with the possible answers and the solution
+    :rtype: pd.DataFrame
+    """
+
+    out = pd.DataFrame(columns=["Question", "Possible Answers", "Correct Answers"])
+
+    questions_cnt = 0
+    files_cnt = 0
+
+    for file in get_excels(input_directory):
+        df = get_excel_data(excel_file=file, sheet_name=sheet_name)
+        if df is None:
+            continue
+        files_cnt += 1
+
+        df = df_processing(df)
+
+        # add to out dataframe
+        out = pd.concat([out, df], axis=0, ignore_index=True)
+
+        questions_cnt += len(df)
+
+    logging.info("Read input files: %d", files_cnt)
+    logging.info("Read questions: %d", questions_cnt)
+    out = out.drop_duplicates(subset=["Question"])
+    return out
+
+
+def get_excels(path: str) -> Iterator[str]:
+    """
+    Returns a generator with all Excel files in the given path.
+    :param path: the path to an Excel file or a directory with Excel files
+    :return: a generator of Excel file paths
+    """
+    if os.path.isfile(path):
+        yield path
+    else:
+        yield from glob.glob(os.path.join(path, "*.xlsx"))
+
+
+def get_excel_data(excel_file: str, sheet_name:str) -> Optional[pd.DataFrame]:
+    """
+    Returns a pd.DataFrame with the kahoot raw data
+    :param excel_file: an Excel file with Kahoot raw data
+    :param sheet_name: the Excel sheet name with the Kahoot answers
+    :return: a DataFrame with the data
+    """
+    try:
+        # read file
+        return pd.read_excel(
+            excel_file, sheet_name=sheet_name
+        )
+    except ValueError:
+        logging.warning(
+            "Skipping file '%s' as it is not a valid Excel file.", excel_file
+        )
+        return None
+    except Exception as e:
+        logging.error("Failed to read file '%s': %s", excel_file, str(e))
+        return None
+
+
+def df_processing(data: pd.DataFrame) -> pd.DataFrame:
+    """
+    Processes the Kahoot question data.
+    :param data: DataFrame with Kahoot question data
+    :return: Processed DataFrame
+    """
+    # delete duplicated questions
+    data = data.drop_duplicates(subset=["Question Number"])
+
+    data = data.fillna("")
+
+    data["Possible Answers"] = data[
+        ["Answer 1", "Answer 2", "Answer 3", "Answer 4", "Answer 5", "Answer 6"]
+    ].agg("<br>".join, axis=1)
+
+    # keep only needed columns
+    data = data[["Question", "Possible Answers", "Correct Answers"]]
+
+    return data
+
+
+def make_anki(df: pd.DataFrame, out: str, title: str) -> None:
+    """
+    Creates an Anki deck from the given Kahoot questions
+
+    :param df: The kahoot questions in a pd.DataFrame
+    :param out: The path to the output directory
+    :param title: The title of the Anki deck
+    :return: None
+    """
+    my_model = genanki.Model(
+        1607392319,
+        "Simple Model",
+        fields=[
+            {"name": "Question"},
+            {"name": "Answer"},
+            {"name": "selects"},
+        ],
+        templates=[
+            {
+                "name": "Card 1",
+                "qfmt": "{{Question}}<br><br>{{selects}}",
+                "afmt": '{{FrontSide}}<hr id="answer">{{Answer}}',
+            },
+        ],
+    )
+
+    my_deck = genanki.Deck(2059400110, title)
+
+    for index, row in df.iterrows():
+        my_note = genanki.Note(
+            model=my_model,
+            fields=[row["Question"], row["Correct Answers"], row["Possible Answers"]],
+        )
+        my_deck.add_note(my_note)
+
+    try:
+        genanki.Package(my_deck).write_to_file(
+            os.path.join(out, "anki.apkg"),
+        )
+    except Exception as e:
+        logging.error("Failed to write Anki package file: %s", str(e))

kahoot_to_anki-1.1.0/kahoot_to_anki.egg-info/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: kahoot-to-anki
+Version: 1.1.0
+Summary: CLI tool to convert Kahoot quiz reports into Anki flashcards
+Author: Simon Hardmeier
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: genanki
+Requires-Dist: pandas
+Requires-Dist: openpyxl
+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)
+
+<br>
+
+**kahoot-to-anki** is a command‑line tool that converts exported Kahoot quiz reports (Excel 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
+### Option 1: Install via pip
+```
+pip install kahoot-to-anki
+```
+Then run:
+```
+kahoot-to-anki --help
+```
+Example: Process all Kahoot Exports in the `./exports/` folder and write the flashcard deck and CSV file to `./data/`:
+```
+kahoot-to-anki --inp "./exports" --out "./data" --csv
+```
+
+### Option 2: Run with Docker
+```
+# Clone Repository
+git clone https://github.com/SimonHRD/kahoot-to-anki.git
+
+# Move into Repository
+cd kahoot-to-anki
+
+# Build docker image with the kahoot-to-anki tag
+docker build -t kahoot-to-anki .
+
+# Check help command
+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
+```
+
+On PowerShell:
+```
+docker run --rm -v ${PWD}\data:/app/data kahoot-to-anki --out "./data" --csv
+```
+
+## CLI Arguments
+You can provide either a single Kahoot Excel file or a directory containing multiple `.xlsx` files as input.<br>
+All valid Excel files in the directory will be processed.
+
+| Argument             | Description                                                                    |
+|----------------------|--------------------------------------------------------------------------------|
+| `-i`, `--inp`        | Path to the input Excel file or directory (default: `./data`)                  |
+| `-o`, `--out`        | Path to the output directory for the Anki deck (default: `./`)                 |
+| `--sheet`            | The Excel Sheet with the raw Kahoot quiz data (default: `RawReportData Data`)  |    
+| `--csv`, `--no-csv`  | Enable or disable CSV export of the questions (default: disabled)              |
+| `-t`, `--title`      | Title of the generated Anki deck (default: `"Kahoot"`)                         |
+
+
+## Example
+An example Kahoot export file is available in `data/`. The generated deck will be saved as `anki.apkg` in the specified `--out` directory (default: `./`).
+
+## License
+MIT — see [LICENSE](./LICENSE)

{kahoot_to_anki-1.0.0 → kahoot_to_anki-1.1.0}/kahoot_to_anki.egg-info/SOURCES.txt

@@ -2,7 +2,9 @@ LICENSE
 README.md
 pyproject.toml
 kahoot_to_anki/__init__.py
-kahoot_to_anki/converter.py
+kahoot_to_anki/cli.py
+kahoot_to_anki/main.py
+kahoot_to_anki/processing.py
 kahoot_to_anki.egg-info/PKG-INFO
 kahoot_to_anki.egg-info/SOURCES.txt
 kahoot_to_anki.egg-info/dependency_links.txt

kahoot_to_anki-1.1.0/kahoot_to_anki.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kahoot-to-anki = kahoot_to_anki.main:main

{kahoot_to_anki-1.0.0 → kahoot_to_anki-1.1.0}/kahoot_to_anki.egg-info/top_level.txt

@@ -1,3 +1,4 @@
+data
 dist
 kahoot_to_anki
 tests

{kahoot_to_anki-1.0.0 → kahoot_to_anki-1.1.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kahoot-to-anki"
-version = "1.0.0"
+version = "1.1.0"
 description = "CLI tool to convert Kahoot quiz reports into Anki flashcards"
 authors = [{ name = "Simon Hardmeier" }]
 license = "MIT"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dependencies = [
     "genanki",
     "pandas",
@@ -17,7 +17,7 @@ dependencies = [
 ]
 
 [project.scripts]
-kahoot-to-anki = "kahoot_to_anki.converter:main"
+kahoot-to-anki = "kahoot_to_anki.main:main"
 
 [tool.setuptools.packages.find]
 where = ["."]

kahoot_to_anki-1.0.0/PKG-INFO

@@ -1,16 +0,0 @@
-Metadata-Version: 2.4
-Name: kahoot-to-anki
-Version: 1.0.0
-Summary: CLI tool to convert Kahoot quiz reports into Anki flashcards
-Author: Simon Hardmeier
-License-Expression: MIT
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: genanki
-Requires-Dist: pandas
-Requires-Dist: openpyxl
-Dynamic: license-file
-
-# kahoot-to-anki
-> python cli program to convert Kahoot quiz results to Anki flashcards

kahoot_to_anki-1.0.0/README.md

@@ -1,2 +0,0 @@
-# kahoot-to-anki
-> python cli program to convert Kahoot quiz results to Anki flashcards

kahoot_to_anki-1.0.0/kahoot_to_anki/__init__.py

@@ -1 +0,0 @@
-"""CLI tool to convert Kahoot quiz reports into Anki flashcards."""

kahoot_to_anki-1.0.0/kahoot_to_anki/converter.py

@@ -1,254 +0,0 @@
-# Standard library imports
-import argparse
-import logging
-import os
-import glob
-
-# Third-party library imports
-import genanki
-import pandas as pd
-
-# Configure logging settings
-logging.basicConfig(level=logging.INFO)
-
-# Constants
-DEFAULT_INPUT_DIRECTORY = "./data"
-DEFAULT_OUTPUT_DIRECTORY = "./"
-DEFAULT_DECK_TITLE = "Kahoot"
-KAHOOT_EXCEL_SHEET_NAME_RAW_DATA = "RawReportData Data"
-
-
-def main():
-    # Check command line arguments
-    inp, out, csv, title = get_commandline_arguments()
-
-    validation(inp, out)
-
-    df = get_questions(inp)
-
-    if csv:
-        df.to_csv(
-            os.path.join(out, "kahoot.csv"),
-            sep=";",
-            index=False,
-            encoding="utf-8-sig",
-        )
-
-    make_anki(df, out, title)
-
-
-def get_commandline_arguments() -> tuple:
-    """
-    Parses the command line arguments and returns a tuple with the input path, output path, CSV option, and deck title.
-
-    :return: A tuple with the input path, the output path, the csv and the title of the anki deck
-    :rtype: tuple
-    """
-    parser = argparse.ArgumentParser(description="Create Anki Deck from Kahoot answer")
-    parser.add_argument(
-        "-i",
-        "--inp",
-        default=DEFAULT_INPUT_DIRECTORY,
-        help=f"Path to the directory containing input Excel files or a single input Excel file. If a directory is "
-        f"provided, all Excel files in the directory will be processed. Default: {DEFAULT_INPUT_DIRECTORY}",
-        type=str,
-    )
-    parser.add_argument(
-        "-o",
-        "--out",
-        default=DEFAULT_OUTPUT_DIRECTORY,
-        help="Path to the directory where the Anki flashcards package will be generated. "
-        "If not specified, the package will be created in the current working directory.",
-        type=str,
-    )
-    parser.add_argument(
-        "--csv",
-        action="store_true",
-        help="Generate a CSV file with the question data.",
-    )
-    parser.add_argument(
-        "-t",
-        "--title",
-        default=DEFAULT_DECK_TITLE,
-        help="Name of the Anki deck to be created. "
-        f"If not specified, the default deck name '{DEFAULT_DECK_TITLE}' will be used.",
-        type=str,
-    )
-    args = parser.parse_args()
-
-    # return absolute paths
-    return os.path.abspath(args.inp), os.path.abspath(args.out), args.csv, args.title
-
-
-def validation(input_directory: str, output_directory: str) -> None:
-    """
-    This function validates the command line arguments, checking if the input path is a valid Excel file or directory
-    and if the output path is a valid directory.
-    The input path needs to be an Excel file or a directory that contains Excel files.
-    The output path needs to be a directory and not a file.
-
-    :param input_directory: The path of the input Excel or directory
-    :param output_directory: The path of the output directory
-    :return: None
-    :rtype: None
-    """
-    # Check if input is a file
-    if not os.path.exists(input_directory):
-        logging.error(f"Input directory {input_directory} does not exist!")
-        raise FileNotFoundError(f"Input directory {input_directory} does not exist!")
-    elif (
-        os.path.isfile(input_directory)
-        and os.path.splitext(input_directory)[-1] != ".xlsx"
-    ):
-        logging.error("Input file is not an excel file!")
-        raise ValueError("Input file is not an excel file!")
-    elif os.path.isdir(input_directory):
-        input_excels = os.path.join(input_directory, "*.xlsx")
-        if not glob.glob(input_excels):
-            logging.error("Input directory does not contain any excel files!")
-            raise FileNotFoundError("Input directory does not contain any excel files!")
-
-    # Check output directory and create when not existing
-    if not os.path.isdir(output_directory):
-        logging.error("Output is not a directory!")
-        raise ValueError("Output is not a directory!")
-    if not os.path.exists(output_directory):
-        try:
-            os.makedirs(output_directory)
-        except OSError as e:
-            logging.error(
-                "Failed to create output directory '%s': %s", output_directory, str(e)
-            )
-            raise
-
-
-def get_questions(input_directory: str) -> pd.DataFrame:
-    """
-    Extracts all the kahoot questions out of the Excel file(s)
-
-    :param input_directory: The path to the input directory or Excel file
-    :return: All the questions with the possible answers and the solution
-    :rtype: pd.DataFrame
-    """
-
-    def get_excels(path):
-        """
-        Returns a list with all Excels in the given path
-        :param path: the path to an Excel file or a directory with Excel files
-        :return: a list with all excels
-        """
-        if os.path.isfile(path):
-            yield path
-        else:
-            yield from glob.glob(os.path.join(input_directory, "*.xlsx"))
-            return [f for f in glob.glob(os.path.join(path, "*.xlsx"))]
-
-    def get_excel_data(excel_file: str) -> pd.DataFrame:
-        """
-        Returns a pd.DataFrame with the kahoot raw data
-        :param excel_file: an Excel file with Kahoot raw data
-        :return: a DataFrame with the data
-        """
-        try:
-            # read file
-            return pd.read_excel(
-                excel_file, sheet_name=KAHOOT_EXCEL_SHEET_NAME_RAW_DATA
-            )
-        except ValueError:
-            logging.warning(
-                "Skipping file '%s' as it is not a valid Excel file.", excel_file
-            )
-            return None
-        except Exception as e:
-            logging.error("Failed to read file '%s': %s", excel_file, str(e))
-            return None
-
-    def df_processing(data: pd.DataFrame) -> pd.DataFrame:
-        """
-        Processes the Kahoot question data.
-        :param data: DataFrame with Kahoot question data
-        :return: Processed DataFrame
-        """
-        # delete duplicated questions
-        data = data.drop_duplicates(subset=["Question Number"])
-
-        data = data.fillna("")
-
-        data["Possible Answers"] = data[
-            ["Answer 1", "Answer 2", "Answer 3", "Answer 4", "Answer 5", "Answer 6"]
-        ].agg("<br>".join, axis=1)
-
-        # keep only needed columns
-        data = data[["Question", "Possible Answers", "Correct Answers"]]
-
-        return data
-
-    out = pd.DataFrame(columns=["Question", "Possible Answers", "Correct Answers"])
-
-    questions_cnt = 0
-    files_cnt = 0
-
-    for file in get_excels(input_directory):
-        df = get_excel_data(file)
-        if df is None:
-            continue
-        files_cnt += 1
-
-        df = df_processing(df)
-
-        # add to out dataframe
-        out = pd.concat([out, df], axis=0, ignore_index=True)
-
-        questions_cnt += len(df)
-
-    logging.info("Read input files: %d", files_cnt)
-    logging.info("Read questions: %d", questions_cnt)
-    out = out.drop_duplicates(subset=["Question"])
-    return out
-
-
-def make_anki(df: pd.DataFrame, out: str, title: str) -> None:
-    """
-    Creates an Anki deck from the given Kahoot questions
-
-    :param df: The kahoot questions in a pd.DataFrame
-    :param out: The path to the output directory
-    :param title: The title of the Anki deck
-    :return: None
-    """
-    my_model = genanki.Model(
-        1607392319,
-        "Simple Model",
-        fields=[
-            {"name": "Question"},
-            {"name": "Answer"},
-            {"name": "selects"},
-        ],
-        templates=[
-            {
-                "name": "Card 1",
-                "qfmt": "{{Question}}<br><br>{{selects}}",
-                "afmt": '{{FrontSide}}<hr id="answer">{{Answer}}',
-            },
-        ],
-    )
-
-    my_deck = genanki.Deck(2059400110, title)
-
-    for index, row in df.iterrows():
-        my_note = genanki.Note(
-            model=my_model,
-            fields=[row["Question"], row["Correct Answers"], row["Possible Answers"]],
-        )
-        my_deck.add_note(my_note)
-
-    try:
-        genanki.Package(my_deck).write_to_file(
-            os.path.join(out, "anki.apkg"),
-        )
-    except Exception as e:
-        logging.error("Failed to write Anki package file: %s", str(e))
-
-
-if __name__ == "__main__":
-    main()

kahoot_to_anki-1.0.0/kahoot_to_anki.egg-info/PKG-INFO

@@ -1,16 +0,0 @@
-Metadata-Version: 2.4
-Name: kahoot-to-anki
-Version: 1.0.0
-Summary: CLI tool to convert Kahoot quiz reports into Anki flashcards
-Author: Simon Hardmeier
-License-Expression: MIT
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: genanki
-Requires-Dist: pandas
-Requires-Dist: openpyxl
-Dynamic: license-file
-
-# kahoot-to-anki
-> python cli program to convert Kahoot quiz results to Anki flashcards

kahoot_to_anki-1.0.0/kahoot_to_anki.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-kahoot-to-anki = kahoot_to_anki.converter:main