\documentclass[10pt,a4paper]{article} % Packages \usepackage{fancyhdr} % For header and footer \usepackage{multicol} % Allows multicols in tables \usepackage{tabularx} % Intelligent column widths \usepackage{tabulary} % Used in header and footer \usepackage{hhline} % Border under tables \usepackage{graphicx} % For images \usepackage{xcolor} % For hex colours %\usepackage[utf8x]{inputenc} % For unicode character support \usepackage[T1]{fontenc} % Without this we get weird character replacements \usepackage{colortbl} % For coloured tables \usepackage{setspace} % For line height \usepackage{lastpage} % Needed for total page number \usepackage{seqsplit} % Splits long words. %\usepackage{opensans} % Can't make this work so far. Shame. Would be lovely. \usepackage[normalem]{ulem} % For underlining links % Most of the following are not required for the majority % of cheat sheets but are needed for some symbol support. \usepackage{amsmath} % Symbols \usepackage{MnSymbol} % Symbols \usepackage{wasysym} % Symbols %\usepackage[english,german,french,spanish,italian]{babel} % Languages % Document Info \author{Sérgio Ferreira (AlienEngineer)} \pdfinfo{ /Title (c-unit-tests-advanced.pdf) /Creator (Cheatography) /Author (Sérgio Ferreira (AlienEngineer)) /Subject (C\# Unit-Tests - Advanced Cheat Sheet) } % Lengths and widths \addtolength{\textwidth}{6cm} \addtolength{\textheight}{-1cm} \addtolength{\hoffset}{-3cm} \addtolength{\voffset}{-2cm} \setlength{\tabcolsep}{0.2cm} % Space between columns \setlength{\headsep}{-12pt} % Reduce space between header and content \setlength{\headheight}{85pt} % If less, LaTeX automatically increases it \renewcommand{\footrulewidth}{0pt} % Remove footer line \renewcommand{\headrulewidth}{0pt} % Remove header line \renewcommand{\seqinsert}{\ifmmode\allowbreak\else\-\fi} % Hyphens in seqsplit % This two commands together give roughly % the right line height in the tables \renewcommand{\arraystretch}{1.3} \onehalfspacing % Commands \newcommand{\SetRowColor}[1]{\noalign{\gdef\RowColorName{#1}}\rowcolor{\RowColorName}} % Shortcut for row colour \newcommand{\mymulticolumn}[3]{\multicolumn{#1}{>{\columncolor{\RowColorName}}#2}{#3}} % For coloured multi-cols \newcolumntype{x}[1]{>{\raggedright}p{#1}} % New column types for ragged-right paragraph columns \newcommand{\tn}{\tabularnewline} % Required as custom column type in use % Font and Colours \definecolor{HeadBackground}{HTML}{333333} \definecolor{FootBackground}{HTML}{666666} \definecolor{TextColor}{HTML}{333333} \definecolor{DarkBackground}{HTML}{2E60A3} \definecolor{LightBackground}{HTML}{F1F5F9} \renewcommand{\familydefault}{\sfdefault} \color{TextColor} % Header and Footer \pagestyle{fancy} \fancyhead{} % Set header to blank \fancyfoot{} % Set footer to blank \fancyhead[L]{ \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{C} \SetRowColor{DarkBackground} \vspace{-7pt} {\parbox{\dimexpr\textwidth-2\fboxsep\relax}{\noindent \hspace*{-6pt}\includegraphics[width=5.8cm]{/web/www.cheatography.com/public/images/cheatography_logo.pdf}} } \end{tabulary} \columnbreak \begin{tabulary}{11cm}{L} \vspace{-2pt}\large{\bf{\textcolor{DarkBackground}{\textrm{C\# Unit-Tests - Advanced Cheat Sheet}}}} \\ \normalsize{by \textcolor{DarkBackground}{Sérgio Ferreira (AlienEngineer)} via \textcolor{DarkBackground}{\uline{cheatography.com/89520/cs/20391/}}} \end{tabulary} \end{multicols}} \fancyfoot[L]{ \footnotesize \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{LL} \SetRowColor{FootBackground} \mymulticolumn{2}{p{5.377cm}}{\bf\textcolor{white}{Cheatographer}} \\ \vspace{-2pt}Sérgio Ferreira (AlienEngineer) \\ \uline{cheatography.com/alienengineer} \\ \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Cheat Sheet}} \\ \vspace{-2pt}Published 28th August, 2019.\\ Updated 3rd September, 2019.\\ Page {\thepage} of \pageref{LastPage}. \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Sponsor}} \\ \SetRowColor{white} \vspace{-5pt} %\includegraphics[width=48px,height=48px]{dave.jpeg} Measure your website readability!\\ www.readability-score.com \end{tabulary} \end{multicols}} \begin{document} \raggedright \raggedcolumns % Set font size to small. Switch to any value % from this page to resize cheat sheet text: % www.emerson.emory.edu/services/latex/latex_169.html \footnotesize % Small font. \begin{multicols*}{2} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{\{\{fa-bolt\}\} Implementation testing}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{public void Test() \{ \newline // Arrange \newline var mock = new Mock\textless{}IActionInterface\textgreater{}(); \newline var subject = new MySubject(mock.Object); \newline \newline // Act \newline subject.DoSomething(); \newline \newline // Assert \newline mock.Verify(e =\textgreater{} e.Store(It.IsAny\textless{}int\textgreater{}()), Times.Once); \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{- Locks tests with the dependency: \newline ~~- The test method is aware of IActionInterface. \newline ~~- Creates duplicated code. \newline - Changes to MySubject constructor forces changes throughout all the tests.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{\{\{fa-info-circle\}\} Verify vs Callbacks}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{// If one of these equality comparisons fail we just know that MyAction wasn't called with those arguments. \newline mock.Verify(e =\textgreater{} e.MyAction( \newline It.Is\textless{}ParameterType\textgreater{}(param =\textgreater{} \newline param.Field1 == "some value" \&\& \newline param.Field2 == 3), \newline Times.Once); \newline \newline // Instead: \newline ParameterType calledArgs = null; \newline mock \newline .Setup(e =\textgreater{} e.MyAction(It.IsAny\textless{}ParameterType\textgreater{}())) \newline .Callback\textless{}ParameterType\textgreater{}(param =\textgreater{} calledArgs = param); \newline \newline Assert.That(calledArgs, Is.Not.Null); \newline Assert.That(calledArgs.Field1, Is.EqualTo("some value")); \newline Assert.That(calledArgs.Field2, Is.EqualTo(3));} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Tip}}: Avoid stating in your tests how things were done, instead strive to describe what happened. {\bf{Observable Behavior}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Column Break \#1}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{} \tn % Row Count 0 (+ 0) \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{\{\{fa-thumbs-up\}\} Behavior testing}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{private int \_someVariable; \newline \newline private MySubject MakeSubject() \newline \{ \newline var mock = new Mock\textless{}IActionInterface\textgreater{}(); \newline \newline mock.Setup(e =\textgreater{} e.Action(It.IsAny\textless{}int\textgreater{}())) \newline .Callback\textless{}Int\textgreater{}(s =\textgreater{} \_someVariable= s); \newline \newline return new MySubject(mock.Object); \newline \} \newline \newline private bool WasStored(int value) =\textgreater{} \newline \_someVariable == value; \newline \newline {[}Test{]} \newline public void SomeTestMethod() \newline \{ \newline // Arrange \newline var subject = MakeSubject(); \newline \newline // Act \newline subject.DoSomething(); \newline \newline // Assert \newline \seqsplit{Assert.True(WasStored(5));} \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{- Changes to dependencies are done in one place only. \newline - Focuses on Behavior not implementation.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{\{\{fa-bolt\}\} Dependencies - Common missed tests}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\emph{What happens when the dependency..}}} \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{fa-minus\}\} throws exception?} \tn % Row Count 2 (+ 1) % Row 2 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{fa-minus\}\} returns null?} \tn % Row Count 3 (+ 1) % Row 3 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{fa-minus\}\} returns wrong format? (e.g. expected json)} \tn % Row Count 5 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Tip}}: Testing is about making sure we have answers to questions. Testing is done when we don't have doubts, therefore no more questions.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Page break \#1}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{} \tn % Row Count 0 (+ 0) \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{\{\{fa-info-circle\}\} Web Apis}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{internal abstract class WebApiTests \{ \newline private WebApplicationFactory\textless{}Startup\textgreater{} \_factory;\{\{nl\}\} \newline protected WebApiTests() =\textgreater{} \newline \_factory = new WebApplicationFactory\textless{}Startup\textgreater{}();\{\{nl\}\} \newline protected HttpClient GetClient() =\textgreater{} \newline \seqsplit{\_factory.CreateClient();} \newline \} \newline \newline class MyApiControllerTests : WebApiTests \{ \newline \newline public async Task requestTest() \{ \newline // Arrange \newline var client = GetClient();\{\{nl\}\} \newline \newline // Act \newline var response = await client.GetAsync("api/someuri");\{\{nl\}\} \newline \newline // Assert \newline \seqsplit{response.EnsureSuccessStatusCode();} \newline var data = await response.Content.ReadAsAsync\textless{}Model\textgreater{}();\{\{nl\}\} \newline \newline // Assert data ... \newline \} \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{using {\bf{Microsoft.AspNetCore.Mvc.Testing}} library for auto mocking out the http layer.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Column Break \#2}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{} \tn % Row Count 0 (+ 0) \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{\{\{fa-thumbs-up\}\} Files}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{// Hide file access through Stream Factory \newline public interface IStreamFactory \newline \{ \newline Stream OpenStream(); \newline void CloseStream(Stream stream); \newline \} \newline \newline // On test file \newline private IStreamFactory MakeStreamStorage() \newline \{ \newline // Create one isolated MemoryStream per test run! \newline \_stream = new MemoryStream(); \newline var mock = new Mock\textless{}IStreamFactory\textgreater{}(); \newline mock.Setup(s =\textgreater{} \seqsplit{s.OpenStream()).Returns(\_stream);} \newline return mock.Object; \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{\{\{fa-bolt\}\} Test arrange with files}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{void Test() \{ \newline // slow \& can fail \newline var data = \seqsplit{File.ReadAllText(@"Data.json");} \newline // slow \& can fail \newline var x = JsonConvert.DeserializeObject\textless{}MyModel\textgreater{}(data); \newline \newline // None of the above lines have anything to do with the test. It's all about Arrange section. \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Tip}}: If you feel the need to do this, probably your subject under test is doing to much. See {\bf{Don't ignore the signs!}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} % That's all folks \end{multicols*} \end{document}