Merge branch 'exercise-movie' into main

x.13-exercise-movie/content.tex

@@ -0,0 +1,91 @@
+% DO NOT COMPILE THIS FILE DIRECTLY!
+% This is included by the other .tex files.
+
+\begin{frame}[t,plain]
+\titlepage
+\end{frame}
+
+\begin{frame}
+    \frametitle{Building blocks to support movies in MISP}
+    MISP has no structures to express anything related to movie. 
+    Let's fix that!
+    \pause
+
+    \vspace{1em}
+    Tasks for this session:
+    \begin{itemize}
+        \item Movie genres (\texttt{Taxonomy})
+        \item Movie sub-genres matrix (\texttt{Galaxy matrix})
+        \item Movie and its details (\texttt{MISP Object})
+        \item Get IMDB score when hovering (\texttt{hover-enrichment module})
+        \item Get movie details from a title (\texttt{persistent-enrichment module})
+    \end{itemize}
+\end{frame}
+
+\begin{frame}
+    \frametitle{Movie genres - Taxonomy}
+    \url{https://www.imdb.com/feature/genre/}
+    \begin{center}
+        \includegraphics[scale=0.25]{pics/movie-genre}\\
+    \end{center}
+\end{frame}
+
+\begin{frame}
+    \frametitle{Movie subgenres - Galaxy matrix}
+    \url{https://en.wikipedia.org/wiki/List_of_genres}
+    \begin{center}
+        \includegraphics[scale=0.12]{pics/movie-subgenre}
+    \end{center}
+\end{frame}
+
+\begin{frame}
+    \frametitle{Movie \& details - MISP Object}
+    \begin{center}
+        \includegraphics[width=0.70\linewidth]{pics/movie-details}
+    \end{center}
+    Movie fields:
+    \begin{itemize}
+        \item \texttt{title}
+        \item \texttt{plot}
+        \item \texttt{release-date}
+        \item \texttt{duration}
+    \end{itemize}
+\end{frame}
+
+\begin{frame}
+    \frametitle{Movie IMDB score - Hover misp-module}
+    \begin{center}
+        \includegraphics[width=0.3\linewidth]{pics/movie-score}
+    \end{center}
+    \begin{enumerate}
+        \item From a movie title, fetch the associated score from IMDB
+        \item Return the score as is
+    \end{enumerate}
+    \vspace{1em}
+    Useful library: \url{https://imdbpy.github.io/}
+\end{frame}
+
+\begin{frame}
+    \frametitle{Movie details from title - Persistent enrichment misp-module}
+    \begin{center}
+        \includegraphics[width=0.85\linewidth]{pics/movie-details2}
+    \end{center}
+    \begin{enumerate}
+        \item From a movie title, fetch additional information from IMDB
+        \item Create a MISP Object with the details
+        \item Include a reference from the create object to the enriched original attribute
+    \end{enumerate}
+    \vspace{1em}
+    Useful library: \url{https://imdbpy.github.io/}
+\end{frame}
+
+\begin{frame}
+    \frametitle{Example of solutions}
+    \begin{itemize}
+        \item \texttt{Taxonomy}: {\tiny \url{https://github.com/MISP/misp-taxonomies/tree/training}}
+        \item \texttt{Galaxy matrix}: {\tiny \url{https://github.com/MISP/misp-galaxy/tree/training}}
+        \item \texttt{MISP Object}: {\tiny \url{https://github.com/MISP/misp-objects/tree/training}}
+        \item \texttt{Hover module}: {\tiny \url{https://github.com/MISP/misp-modules/tree/training}}
+        \item \texttt{Persistent module}: {\tiny \url{https://github.com/MISP/misp-modules/tree/training}}
+    \end{itemize}
+\end{frame}

x.13-exercise-movie/makefile

@@ -0,0 +1,2 @@
+all:
+	pdflatex -interaction nonstopmode -halt-on-error -file-line-error circl-introduction.tex

x.13-exercise-movie/slide.tex

@@ -0,0 +1,143 @@
+\documentclass{beamer}
+\usetheme[numbering=progressbar]{focus}
+\definecolor{main}{RGB}{47, 161, 219}
+\definecolor{textcolor}{RGB}{128, 128, 128}
+\definecolor{background}{RGB}{240, 247, 255}
+
+\usepackage[utf8x]{inputenc}
+\usepackage{listings}
+\usepackage{soul}
+\usepackage{siunitx}
+\usepackage{booktabs}
+%\lstset{ 
+%  backgroundcolor=\color{white},   % choose the background color; you must add \usepackage{color} or \usepackage{xcolor}
+%  basicstyle=\footnotesize,        % the size of the fonts that are used for the code
+%  breakatwhitespace=false
+%}
+
+\usepackage{tikz}
+\usetikzlibrary{shapes,snakes,automata,positioning}
+
+\usepackage{xcolor}
+\usepackage{colortbl}
+\definecolor{mygreen}{rgb}{0,0.6,0}
+\definecolor{mygreen2}{rgb}{0,0.56,0.16}
+\definecolor{myred}{rgb}{0.6,0.066,0.066}
+\definecolor{redCIRCL}{RGB}{213,43,30}
+\definecolor{mygray}{rgb}{0.5,0.5,0.5}
+\definecolor{mymauve}{rgb}{0.58,0,0.82}
+\definecolor{mygray}{gray}{0.9}
+\definecolor{mywhite}{rgb}{1,1,1}
+\definecolor{myblack}{rgb}{0,0,0}
+\definecolor{mybeige}{HTML}{eeeeee}
+%\usepackage{tcolorbox}
+\usepackage[listings]{tcolorbox}
+\tcbuselibrary{listings}
+
+\lstdefinestyle{code}{ %
+  backgroundcolor=\color{mybeige},   % choose the background color; you must add \usepackage{color} or \usepackage{xcolor}; should come as last argument
+  basicstyle=\footnotesize\ttfamily,        % the size of the fonts that are used for the code
+  breakatwhitespace=false,         % sets if automatic breaks should only happen at whitespace
+  breaklines=true,                 % sets automatic line breaking
+  captionpos=b,                    % sets the caption-position to bottom
+  commentstyle=\color{mygreen},    % comment style
+  deletekeywords={...},            % if you want to delete keywords from the given language
+  escapeinside={\%*}{*)},          % if you want to add LaTeX within your code
+  extendedchars=true,              % lets you use non-ASCII characters; for 8-bits encodings only, does not work with UTF-8
+  frame=single,	                   % adds a frame around the code
+  keepspaces=true,                 % keeps spaces in text, useful for keeping indentation of code (possibly needs columns=flexible)
+  keywordstyle=\color{blue},       % keyword style
+  language=Python,                 % the language of the code
+  morekeywords={*,...},           % if you want to add more keywords to the set
+  numbers=left,                    % where to put the line-numbers; possible values are (none, left, right)
+  numbersep=5pt,                   % how far the line-numbers are from the code
+  numberstyle=\tiny\color{myblack}, % the style that is used for the line-numbers
+  rulecolor=\color{black},         % if not set, the frame-color may be changed on line-breaks within not-black text (e.g. comments (green here))
+  showspaces=false,                % show spaces everywhere adding particular underscores; it overrides 'showstringspaces'
+  showstringspaces=false,          % underline spaces within strings only
+  showtabs=false,                  % show tabs within strings adding particular underscores
+  stepnumber=1,                    % the step between two line-numbers. If it's 1, each line will be numbered
+  stringstyle=\color{mymauve},     % string literal style
+  tabsize=2,	                   % sets default tabsize to 2 spaces
+  title=\lstname                   % show the filename of files included with \lstinputlisting; also try caption instead of title
+}
+\lstdefinestyle{bash}{ %
+  backgroundcolor=\color{black!85},   % choose the background color; you must add \usepackage{color} or \usepackage{xcolor}; should come as last argument
+  basicstyle=\footnotesize\color{mywhite},        % the size of the fonts that are used for the code
+  breakatwhitespace=false,         % sets if automatic breaks should only happen at whitespace
+  breaklines=true,                 % sets automatic line breaking
+  captionpos=b,                    % sets the caption-position to bottom
+  commentstyle=\color{mygreen},    % comment style
+  deletekeywords={...},            % if you want to delete keywords from the given language
+  escapeinside={\%*}{*)},          % if you want to add LaTeX within your code
+  extendedchars=true,              % lets you use non-ASCII characters; for 8-bits encodings only, does not work with UTF-8
+  frame=single	                   % adds a frame around the code
+  keepspaces=true,                 % keeps spaces in text, useful for keeping indentation of code (possibly needs columns=flexible)
+  keywordstyle=\color{white}\bfseries,       % keyword style
+  language=bash,                 % the language of the code
+  morekeywords={*,$,git, clone,... },           % if you want to add more keywords to the set
+  numbers=left,                    % where to put the line-numbers; possible values are (none, left, right)
+  numbersep=5pt,                   % how far the line-numbers are from the code
+  numberstyle=\tiny\color{mywhite}, % the style that is used for the line-numbers
+  rulecolor=\color{black},         % if not set, the frame-color may be changed on line-breaks within not-black text (e.g. comments (green here))
+  showspaces=false,                % show spaces everywhere adding particular underscores; it overrides 'showstringspaces'
+  showstringspaces=false,          % underline spaces within strings only
+  showtabs=false,                  % show tabs within strings adding particular underscores
+  stepnumber=1,                    % the step between two line-numbers. If it's 1, each line will be numbered
+  stringstyle=\color{mymauve},     % string literal style
+  tabsize=2,	                   % sets default tabsize to 2 spaces
+  title=\lstname                   % show the filename of files included with \lstinputlisting; also try caption instead of title
+}
+\lstdefinestyle{default}{ %
+  backgroundcolor=\color{white},   % choose the background color; you must add \usepackage{color} or \usepackage{xcolor}; should come as last argument
+  basicstyle=\footnotesize\color{black},        % the size of the fonts that are used for the code
+  breakatwhitespace=false,         % sets if automatic breaks should only happen at whitespace
+  breaklines=true,                 % sets automatic line breaking
+  captionpos=b,                    % sets the caption-position to bottom
+  commentstyle=\color{mygreen},    % comment style
+  deletekeywords={...},            % if you want to delete keywords from the given language
+  escapeinside={\%*}{*)},          % if you want to add LaTeX within your code
+  extendedchars=true,              % lets you use non-ASCII characters; for 8-bits encodings only, does not work with UTF-8
+  frame=single	                   % adds a frame around the code
+  keepspaces=true,                 % keeps spaces in text, useful for keeping indentation of code (possibly needs columns=flexible)
+  keywordstyle=\color{white}\bfseries,       % keyword style
+  language=bash,                 % the language of the code
+  morekeywords={*,$,git, clone,... },           % if you want to add more keywords to the set
+  numbers=left,                    % where to put the line-numbers; possible values are (none, left, right)
+  numbersep=5pt,                   % how far the line-numbers are from the code
+  numberstyle=\tiny\color{black}, % the style that is used for the line-numbers
+  rulecolor=\color{black},         % if not set, the frame-color may be changed on line-breaks within not-black text (e.g. comments (green here))
+  showspaces=false,                % show spaces everywhere adding particular underscores; it overrides 'showstringspaces'
+  showstringspaces=false,          % underline spaces within strings only
+  showtabs=false,                  % show tabs within strings adding particular underscores
+  stepnumber=1,                    % the step between two line-numbers. If it's 1, each line will be numbered
+  stringstyle=\color{mymauve},     % string literal style
+  tabsize=2,	                   % sets default tabsize to 2 spaces
+  title=\lstname                   % show the filename of files included with \lstinputlisting; also try caption instead of title
+}
+\lstset{style=code}
+
+
+\AtBeginSection[]{
+  \begin{frame}
+  \vfill
+  \centering
+  \begin{beamercolorbox}[sep=8pt,center,shadow=true,rounded=true]{title}
+      {\color{white} \usebeamerfont{title}\insertsectionhead}\par%
+  \end{beamercolorbox}
+  \vfill
+  \end{frame}
+}
+
+\author{\small{\input{../includes/authors.txt}}}
+
+\title{Training exercise: Movie}
+\subtitle{}
+\institute{info@circl.lu}
+\titlegraphic{\includegraphics[scale=0.85]{misp.pdf}}
+\date{\today}
+
+\begin{document}
+\include{content}
+\end{document}
+