added with statement and context managers

Author: thomasWeise

bibliography/bibliography.bib

@@ -59,6 +59,7 @@ @string { a_bottazzini_umberto
 @string { a_bradbury_james = "James Bradbury" }
 @string { a_brandl_georg = "Georg Brandl" }
 @string { a_brash_ron = "Ron Brash" }
+@string { a_bray_tim = "Tim Bray" }
 @string { a_brent_richard_p = "Richard P.\ Brent" }
 @string { a_brett_matthew = "Matthew Brett" }
 @string { a_bright_jonathan = "Jonathan Bright" }
@@ -85,6 +86,7 @@ @string { a_chintala_soumith
 @string { a_cimran_robert = "Robert Cimrman" }
 @string { a_clinton_david = "David Clinton" }
 @string { a_coghlan_alyssa = "Alyssa Coghlan" }
+@string { a_cole_timothy_w = "Timothy W.\ Cole" }
 @string { a_conway_john_horton = "John Horton Conway" }
 @string { a_cook_curtis_r = "Curtis R.\ Cook" }
 @string { a_cormen_thomas_h = "Thomas H.\ Cormen" }
@@ -154,12 +156,14 @@ @string { a_haberland_matt
 @string { a_haldane_allan = "Allan Haldane" }
 @string { a_hammoud_mohammad = "Mohammad Hammoud" }
 @string { a_hammouda_imed = "Imed Hammouda" }
+@string { a_han_myung_ja_k = "Myung{-}Ja K.\ Han" }
 @string { a_hance_jared = "Jared Hance" }
 @string { a_harris_charles_r = "Charles R.\ Harris" }
 @string { a_hastings_larry = "Larry Hastings" }
 @string { a_hausenblas_michael = "Michael Hausenblas" }
 @string { a_heap_danny = "Danny Heap" }
 @string { a_heiberg_johan_ludvig = "Johan Ludvig Heiberg" }
+@string { a_helmes_christian = "Christian Heimes" }
 @string { a_henriksen_ian = "Ian Henriksen" }
 @string { a_herbsleb_james_d = "James D.\ Herbsleb" }
 @string { a_hetland_magnus_lie = "Magnus Lie Hetland" }
@@ -194,6 +198,7 @@ @string { a_klein_andreas
 @string { a_klein_bernd = "Bernd Klein" }
 @string { a_klopf_andreas = "Andreas K{\"o}pf" }
 @string { a_knuth_donald_ervin = "Donald Ervin Knuth" }
+@string { a_kodes_katie = "Katie Kodes" }
 @string { a_kohn_tobias = "Tobias Kohn" }
 @string { a_komiya_takeshi = "Takeshi Komiya" }
 @string { a_konovalov_alexander = "Alexander Konovalov" }
@@ -229,6 +234,7 @@ @string { a_luce_laurent
 @string { a_lun_anthony_w_c = "Anthony W.{\nobreakdashes-}C.\ Lun" }
 @string { a_lundell_bjorn = "Bj{\"o}rn Lundell" }
 @string { a_luschny_peter = "Peter Luschny" }
+@string { a_maler_eve = "Eve Maler" }
 @string { a_mann_samuel = "Samuel Mann" }
 @string { a_marsh_charlie = "Charlie Marsh" }
 @string { a_massa_francisco = "Francisco Massa" }
@@ -270,6 +276,7 @@ @string { a_oliphant_travis_e
 @string { a_ortega_cisneros_susana = "Susana {Ortega Cisneros}" }
 @string { a_paixao_matheus = "Matheus Paix{\~a}o" }
 @string { a_pajankar_ashwin = "Ashwin Pajankar" }
+@string { a_paoli_jean = "Jean Paoli" }
 @string { a_paquete_luis = "Lu{\'i}s Paquete" }
 @string { a_pasareanu_corina_s = "Corina S.\ P{\u{a}}s{\u{a}}reanu" }
 @string { a_passos_alexandre = "Alexandre Passos" }
@@ -344,6 +351,7 @@ @string { a_smith_ethan
 @string { a_smith_nathaniel_j = "Nathaniel J.\ Smith" }
 @string { a_sobolev_nikita = "Nikita Sobolev" }
 @string { a_sottet_jean_sebastien = "Jean{\nobreakdashes-}S{\'e}bastien Sottet" }
+@string { a_sperberg_mcqueen_c_m = "C.\ M.\ Sperberg{-}McQueen" }
 @string { a_sphinx_developers = "{\Pgls{sphinx} Developers}" }
 @string { a_stein_clifford = "Clifford Stein" }
 @string { a_steiner_benoit = "Benoit Steiner" }
@@ -407,6 +415,7 @@ @string { a_yang_joonmo
 @string { a_yang_xuanda = "Xuanda Yang" }
 @string { a_ye_jingchen = "Jingchen Ye" }
 @string { a_yee_ka_ping = "Ka{\nobreakdashes-}Ping Yee" }
+@string { a_yergeau_francois = "Fran{\c{c}}ois Yergeau" }
 @string { a_yu_yuan = "Yuan Yu" }
 @string { a_zarrelli_giorgio = "Giorgio Zarrelli" }
 @string { a_zheng_xiaoqiang = "Xiaoqiang Zheng" }
@@ -464,6 +473,7 @@ @string { l_usa_chicago
 @string { l_usa_cincinnati = "{{Cincinnati}, {OH}, {USA}}" }
 @string { l_usa_columbia = "{{Columbia}, {SC}, {USA}}" }
 @string { l_usa_dallas = "{{Dallas}, {TX}, {USA}}" }
+@string { l_usa_dublin = "{{Dublin}, {OH}, {USA}}" }
 @string { l_usa_flower_mound = "{{Flower Mound}, {TX}, {USA}}" }
 @string { l_usa_hanover = "{{Hanover}, {MD}, {USA}}" }
 @string { l_usa_highland_park = "{{Highland Park}, {NJ}, {USA}}" }
@@ -491,6 +501,7 @@ @string { l_usa_seattle
 @string { l_usa_sebastopol = "{{Sebastopol}, {CA}, {USA}}" }
 @string { l_usa_shelter_island = "{{Shelter Island}, {NY}, {USA}}" }
 @string { l_usa_south_san_francisco = "{{South San Francisco}, {CA}, {USA}}" }
+@string { l_usa_wakefield = "{{Wakefield}, {MA}, {USA}}" }
 @string { l_usa_washington_dc = "{{Washington}, {DC}, {USA}}" }
 @string { l_usa_wilmington = "{{Wilmington}, {DE}, {USA}}" }
 
@@ -533,6 +544,7 @@ @string { p_informs
 @string { p_io_press = "{{I/O}~Press}" }
 @string { p_iso = "{International Organization for Standardization~{(ISO)}}" }
 @string { p_leibniz_zentrum_fur_informatik = "{{Schloss Dagstuhl} -- {Leibniz\nobreakdashes-Zentrum f{\"u}r Informatik}}" }
+@string { p_libraries_unlimited = "Libraries Unlimited" }
 @string { p_logilab = "Logilab" }
 @string { p_manning_publications = "{Manning Publications}" }
 @string { p_mcgraw_hill = "{McGraw\nobreakdashes-Hill}" }
@@ -551,6 +563,7 @@ @string { p_oreilly
 @string { p_oxford_university_cl = "{Oxford University Computing Laboratory}" }
 @string { p_oxford_university_press = "{Oxford University Press}" }
 @string { p_packt = "{Packt Publishing Ltd}" }
+@string { p_payhip = "Payhip" }
 @string { p_pearson_education = "{Pearson Education, Inc.}" }
 @string { p_microsoft_press = "{Microsoft Press}, " # p_pearson_education }
 @string { p_plos = "Public Library of Science~{(PLOS)}" }
@@ -578,6 +591,7 @@ @string { p_university_of_toronto_cs
 @string { p_university_of_washington = "{University of Washington}" }
 @string { p_usas = "{United States of America Standards Institute~{(USAS)}}" }
 @string { p_usenix = "{{USENIX} Association}" }
+@string { p_w3c = "{World Wide Web Consortium~{(W3C)}}" }
 @string { p_wiley = "{Wiley}" }
 @string { p_wiley_and_sons_ltd = "{John Wiley and Sons Ltd.}" }
 @string { p_wiley_vch = "Wiley\nobreakdashes-VCH GmbH" }
@@ -621,6 +635,7 @@ @string { pa_ifip
 @string { pa_infinite_skills = l_canada_oakville }
 @string { pa_informs = l_usa_catonsville }
 @string { pa_leibniz_zentrum_fur_informatik = l_germany_wadern }
+@string { pa_libraries_unlimited = l_usa_dublin }
 @string { pa_logilab = l_france_toulouse }
 @string { pa_manning_publications = l_usa_shelter_island }
 @string { pa_mcgraw_hill = l_usa_new_york }
@@ -639,6 +654,7 @@ @string { pa_oreilly
 @string { pa_oxford_university_cl = l_uk_oxford }
 @string { pa_oxford_university_press = l_uk_oxford }
 @string { pa_packt = l_uk_birmingham }
+@string { pa_payhip = l_uk_london }
 @string { pa_pearson_education = l_usa_hoboken }
 @string { pa_microsoft_press = pa_pearson_education }
 @string { pa_plos = l_usa_san_francisco }
@@ -666,6 +682,7 @@ @string { pa_university_of_toronto_cs
 @string { pa_university_of_washington = l_usa_seattle }
 @string { pa_usas = l_usa_new_york }
 @string { pa_usenix = l_usa_berkeley }
+@string { pa_w3c = l_usa_wakefield }
 @string { pa_wiley = l_usa_hoboken }
 @string { pa_wiley_and_sons_ltd = l_uk_chichester }
 @string { pa_wiley_vch = l_germany_weinheim }
@@ -1000,6 +1017,12 @@ @xdata{ser_utics
  series = {Undergraduate Topics in Computer Science~{(UTICS)}},
 }
 
+@xdata{ser_w3cr,
+ series = {{W3C}~Recommendation},
+ publisher = p_w3c,
+ address = pa_w3c,
+}
+
 @xdata{ser_zvegdwiih,
  author = a_bachmann_paul_gustav_heinrich,
  publisher = p_teubner_b_g,
@@ -1245,6 +1268,15 @@ @book{BN2018BC
  isbn = {9781788629362},
 }
 
+@book{BPSMM2008EMLX1FE,
+ editor = a_bray_tim # and # a_paoli_jean # and # a_sperberg_mcqueen_c_m # and # a_maler_eve,
+ title = {Extensible Markup Language~(\pgls{xml})~1.0~(Fifth Edition)},
+ xdata = {ser_w3cr},
+ date = {2008-11-26/2013-02-07},
+ url = {http://www.w3.org/TR/2008/REC-xml-20081126},
+ urldate = {2024-12-15},
+}
+
 @article{C2002LFLHADWTDM,
  title = {Learning from Liu Hui? A Different Way to Do Mathematics},
  author = a_cullen_christopher,
@@ -1304,6 +1336,16 @@ @book{CEOEB2024GR
  urldate = {2024-12-14},
 }
 
+@book{CH2013XFCAMLTMC,
+ author = a_cole_timothy_w # and # a_han_myung_ja_k,
+ title = {\pgls{xml} for Catalogers and Metadata Librarians~(Third Millennium Cataloging)},
+ edition = {1},
+ isbn = {9781598845198},
+ date = {2013-05-23},
+ publisher = p_libraries_unlimited,
+ address = pa_libraries_unlimited,
+}
+
 @book{CLRS2009ITA,
  author = a_cormen_thomas_h # and # a_leiserson_charles_e # and # a_rivest_ronald_linn # and # a_stein_clifford,
  title = {Introduction to Algorithms},
@@ -1633,6 +1675,14 @@ @article{H2007MA2GE
  doi = {10.1109/MCSE.2007.55},
 }
 
+@book{H2021D0XBPFPSM,
+ author = a_helmes_christian,
+ title = {defusedxml~0.7.1: \pgls{xml}~Bomb Protection for \python\ stdlib Modules},
+ date = {2021-03-08},
+ url = {https://pypi.org/project/defusedxml},
+ urldate = {2024-12-15}
+}
+
 @book{H2022LML,
  author = a_hausenblas_michael,
  title = {Learning Modern \linux},
@@ -1809,6 +1859,14 @@ @book{K2018EIPFEUU
  doi = {10.3139/9783446453876},
 }
 
+@book{K2019ITXJY,
+ author = a_kodes_katie,
+ title = {Intro to~\pgls{xml}, JSON, \&~YAML},
+ date = {2019/2020-09-04},
+ publisher = p_payhip,
+ address = pa_payhip
+}
+
 @book{K2024REH,
  author = a_kuchling_andrew_m,
  title = {\glslink{regexp}{Regular Expression} {HOWTO}},
@@ -2245,6 +2303,16 @@ @techreport{PEP289
  urldate = {2024-11-08}
 }
 
+@techreport{PEP343,
+ author = a_van_rossum_guido # and # a_coghlan_alyssa,
+ title = {The \inQuotes{\pythonilIdx{with}} Statement},
+ xdata = {rep_pep},
+ number = {343},
+ date = {2005-05-13/2006-07-30},
+ url = {https://peps.python.org/pep-0343},
+ urldate = {2024-12-15},
+}
+
 @techreport{PEP362,
  author = a_cannon_brett # and # a_seo_jiwon # and # a_selivanov_yury # and # a_hastings_larry,
  title = {Function \Pgls{signature}\pythonIdx{signature} Object},
@@ -2370,7 +2438,6 @@ @techreport{PEP3107
  title = {Function Annotations},
  date = {2006-12-02},
  xdata = {rep_pep},
- xdata = {PEP},
  url = {https://peps.python.org/pep-3107},
  urldate = {2024-12-12},
 }
@@ -2765,6 +2832,14 @@ @inbook{PSF2024TSTS
  urldate = {2024-07-25},
 }
 
+@inbook{PSF2024TWS,
+ title = {The \pythonilIdx{with} Statement},
+ chapter = {8.5},
+ xdata = {PSF2024TPLR},
+ url = {https://docs.python.org/3/reference/compound_stmts.html#with},
+ urldate = {2024-12-15},
+}
+
 @xdata{PSF2024WNIP,
  volume = {What's New in \python},
  crossref = {PSF2024P3D}
@@ -2778,6 +2853,14 @@ @inbook{PSF2024WNIP38FSFSDEAD
  urldate = {2024-12-01}
 }
 
+@inbook{PSF2024WSCM,
+ title = {With\pythonIdx{with} Statement Context Managers},
+ chapter = {3.3.9.},
+ xdata = {PSF2024TPLR},
+ url = {https://docs.python.org/3/reference/datamodel.html#with-statement-context-managers},
+ urldate = {2024-12-15},
+}
+
 @inbook{PTVF2007EAAS,
  title = {1.1~Error, Accuracy, and Stability},
  chapter = {1~Preliminaries},
@@ -3112,7 +3195,7 @@ @book{TUC2023U1510
 }
 
 @book{TUC2023U151ACS,
- title = {The Unicode Standard, Version~15.1:~Archived Code Charts},
+ title = {The \Pgls{unicode} Standard, Version~15.1:~Archived Code Charts},
  date = {2023-08-25},
  publisher = p_unicode_consortium,
  address = pa_unicode_consortium,
@@ -3121,7 +3204,7 @@ @book{TUC2023U151ACS
 }
 
 @techreport{USAS1967USCFII,
- title = {USA Standard Code for Information Interchange~{(ASCII~1967)}},
+ title = {{USA} Standard Code for Information Interchange~{(ASCII~1967)}},
  date = {1967-07-07},
  number = {USAS~X3.4-1967},
  institution = p_usas,
@@ -3224,6 +3307,17 @@ @inproceedings{WW2023RSDEWASSAA
  doi = {10.1145/3583133.3596306},
 }
 
+@techreport{Y2003UATFOI1,
+ author = a_yergeau_francois,
+ title = {\Pgls{utf8}, A Transformation Format of ISO~10646},
+ xdata = {rep_rfc},
+ number = {3629},
+ date = {2003-11},
+ url = {https://www.rfc-editor.org/rfc/rfc3629},
+ urldate = {2024-12-16},
+ addendum = {See \pgls{unicode} and~\cite{ISOIEC106462020ITUCCSU}}
+}
+
 @book{Y2022PPADT,
  author = a_yanev_martin,
  title = {\pycharm\ Productivity and Debugging Techniques},

notation/acronyms.sty

@@ -14,5 +14,8 @@
 \newacronym[description={see \gls{stderrs} and~\cite{J2024PTOGBSI8IS12ESSSSIS}},sort={stderr}]{stderr}{\texttt{stderr}}{standard error stream}%
 \newacronym[description={see \gls{stdins} and~\cite{J2024PTOGBSI8IS12ESSSSIS}},sort={stdin}]{stdin}{\texttt{stdin}}{standard input stream}%
 \newacronym[description={see \gls{stdouts} and~\cite{J2024PTOGBSI8IS12ESSSSIS}},sort={stdout}]{stdout}{\texttt{stdout}}{standard output stream}%
+\newacronym[description={Universal Coded Character Set, see \gls{unicode}}]{UCS}{UCS}{Universal Coded Character Set}%
+\newacronym[description={\acrshort{UCS}~Transformation Format~8, see \gls{utf8} and~\cite{Y2022PPADT,ISOIEC106462020ITUCCSU}}]{UTF8}{UTF8}{\acrshort{UCS}~Transformation Format~8}%
 \newacronym[description={Version Control Systems, see \gls{vcs}}]{VCS}{VCS}{Version Control Systems}%
+\newacronym[description={Extensible Markup Language, see \pgls{xml} and~\cite{BPSMM2008EMLX1FE,K2019ITXJY,CH2013XFCAMLTMC}}]{XML}{XML}{Extensible Markup Language}%
 %

notation/terms.sty

@@ -321,6 +321,16 @@ See \cref{bp:typeHints,sec:varTypeHints}.%
 }%
 %
 %
+\newglossaryentry{utf8}{%
+name={UTF-8},%
+description={%
+The \acrfull{UTF8} is one standard for encoding \pgls{unicode} characters into a binary format that can be stored in files~\cite{Y2003UATFOI1,ISOIEC106462020ITUCCSU}. %
+It is the world wide web's most commonly used character encoding, where each character is represented by one to four bytes. %
+It is backwards compatible with ASCII~(see~\cref{sec:unicodeChars}).%
+}%
+}%
+%
+%
 \newglossaryentry{unicode}{%
 name={Unicode},%
 description={%
@@ -351,3 +361,16 @@ The \ensuremath{x}\nobreakdashes-axis is the horizontal axis of a two-dimensiona
 }%
 }%
 %
+%
+\newglossaryentry{xml}{%
+name={XML},%
+plural={XML},%
+description={%
+The \acrfull{XML} is a text-based language for storing and transporting of data~\cite{BPSMM2008EMLX1FE,K2019ITXJY,CH2013XFCAMLTMC}. %
+It allows you to define elements in the form \textil{<myElement myAttr="x">...text..</myElement>}. %
+Different from \pgls{csv}, elements in XML can be hierarchically nested, like~\textil{<a><b><c>test</c></b><b>bla</b></a>}, and thus easily represent tree structures. %
+XML is one of most-used data interchange formats. %
+To process XML in \python, use the \pythonilIdx{defusedxml} library~\cite{H2021D0XBPFPSM}, as it protects against several security issues.%
+}%
+}%
+%

text/main/classes/dunder/dunder.tex

@@ -1239,4 +1239,9 @@
 \FloatBarrier%
 \endhsection%
 %
+\hsection{Implementing Context Managers for the \texttt{with} Statement Revisited}%
+\label{sec:dunder:contextManager}%
+%
+\endhsection%
+%
 \endhsection%