b08-pystyle

import%20marimo%0A%0A__generated_with%20%3D%20%220.25.0%22%0Aapp%20%3D%20marimo.App()%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20marimo%20as%20mo%0A%0A%20%20%20%20return%20(mo%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%20Code%20Style%20and%20Conventions%0A%0A%20%20%20%20Make%20your%20code%20consistent%20through%20style%20conventions%3A%20Take%20a%20deep%20breath%2C%20take%20off%2C%20and%20look%20at%20what%20you%20have%20learned%20so%20far%20from%20a%20new%20perspective.%20After%20this%20chapter%2C%20it%20will%20be%20worth%20having%20another%20look%20at%20your%20old%20code%20and%20formatting%20it%20robustly.%20The%20style%20guidelines%20presented%20here%20go%20beyond%20visual%20aesthetics%20and%20aid%20in%20writing%20effective%20code.%0A%0A%20%20%20%20%23%23%20Background%20and%20PEP%0A%0A%20%20%20%20This%20style%20guide%20highlights%20parts%20of%20the%20%5BPEP%208%20-%20Style%20Guide%20for%20Python%20Code%5D(https%3A%2F%2Fwww.python.org%2Fdev%2Fpeps%2Fpep-0008%2F)%20by%20Guido%20van%20Rossum%2C%20Barry%20Warsaw%2C%20and%20Nick%20Coghlan.%20The%20full%20document%20is%20available%20at%20%5Bpython.org%5D(https%3A%2F%2Fwww.python.org%2Fdev%2Fpeps%2Fpep-0008%2F)%20and%20only%20aspects%20with%20relevance%20for%20the%20applications%20shown%20in%20this%20eBook%20are%20featured%20in%20this%20chapter.%0A%0A%20%20%20%20**What%20is%20a%20PEP%3F**%20PEP%20stands%20for%20**Python%20Enhancement%20Proposal**.%20A%20PEP%20is%20a%20design%20document%20that%20provides%20information%20to%20the%20Python%20community%20or%20describes%20a%20proposed%20feature%2C%20process%2C%20or%20related%20change.%20There%20are%20many%20PEPs%2C%20including%20standards-track%2C%20informational%2C%20and%20process%20proposals.%20This%20chapter%20highlights%20recommendations%20from%20PEP%208%2C%20the%20style%20guide%20for%20Python%20code%2C%20by%20Guido%20van%20Rossum%2C%20Barry%20Warsaw%2C%20and%20Alyssa%20Coghlan.%0A%0A%20%20%20%20Many%20IDEs%2C%20including%20PyCharm%20or%20VS%20Code%2C%20provide%20auto-completion%20and%20tooltips%20with%20PEP-style%20guidance%20to%20aid%20consistent%20programming.%20Thus%2C%20when%20your%20IDE%20underlines%20anything%20in%20your%20script%2C%20check%20the%20reason%20for%20that%20and%20consider%20modifying%20the%20code%20accordingly.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20The%20Zen%20of%20Python%0A%0A%20%20%20%20Are%20we%20getting%20spiritual%3F%20Far%20from%20it.%20%5BThe%20Zen%20of%20Python%5D(https%3A%2F%2Fwww.python.org%2Fdev%2Fpeps%2Fpep-0020%2F)%20is%20an%20informational%20*PEP*%20(20)%20by%20Tim%20Peters%20to%20guide%20programmers.%20It%20is%20a%20couple%20of%20lines%20summarizing%20good%20practice%20in%20coding.%20Python's%20*Easter%20Egg*%20%60import%20this%60%20prints%20the%20Zen%20of%20Python%20in%20any%20Python%20interpreter%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20this%0A%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Code%20Layout%0A%0A%20%20%20%20%23%23%23%20Maximum%20Line%20Length%0A%0A%20%20%20%20PEP%208%20recommends%20limiting%20code%20lines%20to%2079%20characters.%20Flowing%20text%20in%20comments%20and%20%5Bdocstrings%5D(https%3A%2F%2Fhydro-informatics.com%2Fpystyle%23docstrings)%20should%20be%20limited%20to%2072%20characters.%20A%20team%20may%20agree%20on%20a%20code-line%20limit%20of%20up%20to%2099%20characters%2C%20provided%20that%20comments%20and%20docstrings%20remain%20limited%20to%2072%20characters.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Indentation%0A%20%20%20%20Indentation%20groups%20statements%20into%20suites%20controlled%20by%20constructs%20such%20as%20%60for%60%2C%20%60if%60%2C%20%60while%60%2C%20%60try%60%2C%20%60with%60%2C%20%60def%60%2C%20and%20%60class%60.%20PEP%208%20recommends%20four%20spaces%20per%20indentation%20level.%20Indentation%20does%20not%20by%20itself%20create%20a%20new%20variable%20scope%3A%20names%20assigned%20in%20an%20%60if%60%20or%20%60for%60%20suite%20remain%20in%20the%20surrounding%20scope.%20Functions%2C%20classes%2C%20modules%2C%20and%20some%20comprehensions%20have%20their%20own%20scoping%20rules.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20for%20i%20in%20range(1%2C%202)%3A%0A%20%20%20%20%20%20print(%22I'm%20one%20level%20indented.%22)%0A%20%20%20%20%20%20if%20i%20%3D%3D%201%3A%0A%20%20%20%20%09%20%20print(%22I'm%20two%20levels%20indented.%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20Because%20long%20lines%20of%20code%20are%20bad%20practice%2C%20we%20sometimes%20need%20to%20use%20line%20breaks%20when%20assigning%2C%20for%20example%2C%20a%20*list*%2C%20or%20calling%20a%20function.%20In%20these%20cases%2C%20the%20next%2C%20continuing%20line%20is%20also%20indented%20and%20there%20are%20different%20options%20to%20indent%20multi-line%20assignments.%20Here%2C%20we%20want%20to%20use%20the%20style%20code%20of%20using%20an%20opening%20delimiter%20for%20indentation%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20a_too_long_word_list%20%3D%20%5B%22Do%22%2C%20%22not%22%2C%20%22hard-code%22%2C%20%22something%22%2C%20%22like%22%2C%20%22this.%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22There%22%2C%20%22are%22%2C%20%22better%22%2C%20%22ways.%22%5D%0A%20%20%20%20a_better_indented_list%20%3D%20%5B%0A%20%20%20%20%20%20%20%20%22Do%22%2C%0A%20%20%20%20%20%20%20%20%22not%22%2C%0A%20%20%20%20%20%20%20%20%22hard-code%22%2C%0A%20%20%20%20%20%20%20%20%22something%22%2C%0A%20%20%20%20%20%20%20%20%22like%22%2C%0A%20%20%20%20%20%20%20%20%22this.%22%2C%0A%20%20%20%20%20%20%20%20%22...%22%2C%0A%20%20%20%20%5D%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20**Recall%3A%20PyCharm%2C%20VS%20Code%2C%20and%20many%20other%20IDEs%20automatically%20layout%20indentation.**%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Line%20Breaks%20of%20Expressions%20with%20Binary%20Operators%0A%20%20%20%20When%20binary%20operators%20are%20part%20of%20an%20expression%20that%20exceeds%20the%20maximum%20line%20length%20of%2079%20characters%2C%20the%20line%20break%20should%20be%20before%20the%20binary%20operators.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20pandas%20as%20pd%0A%0A%20%20%20%20dummy_df%20%3D%20pd.get_dummies(%0A%20%20%20%20%20%20pd.Series(%5B%22variable1%22%2C%20%22parameter2%22%2C%20%22sensor3%22%5D)%2C%0A%20%20%20%20%20%20dtype%3Dint%2C%0A%20%20%20%20)%0A%20%20%20%20print(dummy_df.head(3))%0A%0A%20%20%20%20dum_sum%20%3D%20(%0A%20%20%20%20%20%20dummy_df%5B%22variable1%22%5D%0A%20%20%20%20%20%20%2B%20dummy_df%5B%22parameter2%22%5D%0A%20%20%20%20%20%20-%20dummy_df%5B%22sensor3%22%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Blank%20Lines%0A%0A%20%20%20%20To%20separate%20code%20blocks%2C%20hitting%20the%20*Enter*%20key%20many%20times%20is%20a%20very%20inviting%20option.%20However%2C%20the%20random%20and%20mood-driven%20use%20of%20blank%20lines%20results%20in%20unstructured%20code.%20This%20is%20why%20*PEP*%208%20authors%20provide%20guidance%20also%20on%20the%20use%20of%20blank%20lines%3A%0A%0A%20%20%20%20*%20Surround%20class%20definitions%20and%20top-level%20functions%20(i.e.%2C%20functions%20where%20the%20%60def%60-line%20is%20not%20indented)%20with%20two%20blank%20lines.%0A%20%20%20%20*%20Surround%20methods%20(e.g.%2C%20functions%20within%20a%20class)%20with%20one%20blank%20line.%0A%20%20%20%20*%20Use%20blank%20lines%20sparsely%20in%20all%20other%20code%20to%20indicate%20logical%20sections.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20%23%20blank%201%20before%20top-level%20function%0A%20%20%20%20%23%20blank%202%20before%20top-level%20function%0A%20%20%20%20def%20top_level_function()%3A%0A%20%20%20%20%20%20%20%20pass%0A%20%20%20%20%23%20blank%201%20after%20top-level%20function%0A%20%20%20%20%23%20blank%202%20after%20top-level%20function%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Blanks%20(Whitespaces)%0A%0A%20%20%20%20Avoid%20unnecessary%20whitespace%20immediately%20inside%20parentheses%2C%20brackets%2C%20or%20braces%3B%20before%20commas%2C%20semicolons%2C%20and%20ordinary%20colons%3B%20or%20between%20a%20function%20name%20and%20its%20argument%20list.%20Write%20%60function(e1%2C%20e2)%60%2C%20%60(1%2C)%60%2C%20%60a_dict%20%3D%20%7Ba_key%3A%20a_value%7D%60%2C%20and%20%60def%20fun(arg%3D0.0)%3A%60.%0A%0A%20%20%20%20Use%20spaces%20around%20assignment%2C%20comparison%2C%20and%20Boolean%20operators.%20For%20arithmetic%20expressions%2C%20add%20spaces%20around%20the%20lowest-precedence%20operators%20and%20use%20judgment%20to%20make%20precedence%20clear%3B%20for%20instance%2C%20%60hypot2%20%3D%20x*x%20%2B%20y*y%60.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Packages%20and%20Modules%0A%0A%20%20%20%20%23%23%23%20Imports%0A%20%20%20%20Imports%20normally%20appear%20after%20the%20module%20docstring%20and%20before%20module%20globals.%20Group%20them%20in%20this%20order%2C%20with%20a%20blank%20line%20between%20groups%3A%20standard%20library%2C%20related%20third-party%20packages%2C%20and%20local%20application%20or%20library%20imports.%20Put%20ordinary%20imports%20on%20separate%20lines%20and%20avoid%20wildcard%20imports.%20Every%20import%20should%20have%20its%20own%20line%20and%20avoid%20using%20the%20comma%20sign%20for%20multiple%20imports%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20os%0A%20%20%20%20import%20sys%0A%0A%20%20%20%20import%20numpy%20as%20np%0A%0A%20%20%20%20from%20my_package%20import%20my_module%0A%0A%20%20%20%20return%20(np%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Naming%20Packages%20and%20Script%0A%20%20%20%20New%2C%20custom%20packages%20or%20modules%20should%20have%20short%20and%20all-lowercase%20names%2C%20where%20underscores%20may%20be%20used%20to%20improve%20readability%20(discouraged%20for%20packages).%0A%0A%20%20%20%20%3E%20**Never%20use%20a%20minus%20%60-%60%20sign%20in%20a%20Python%20file%20name**%2C%20because%20the%20minus%20sign%20may%20cause%20import%20errors.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Comments%0A%0A%20%20%20%20%23%23%23%20Block%20and%20Inline%20Comments%0A%20%20%20%20Block%20comments%20are%20indented%20to%20the%20same%20level%20as%20the%20code%20they%20describe%2C%20and%20each%20line%20begins%20with%20%60%23%20%60.%20Use%20inline%20comments%20sparingly.%20An%20inline%20comment%20appears%20on%20the%20same%20line%20as%20a%20statement%2C%20is%20separated%20from%20it%20by%20at%20least%20two%20spaces%2C%20and%20begins%20with%20%60%23%20%60.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Docstrings%0A%0A%20%20%20%20A%20docstring%20is%20a%20string%20literal%20that%20occurs%20as%20the%20first%20statement%20in%20a%20module%2C%20function%2C%20class%2C%20or%20method.%20It%20becomes%20available%20through%20the%20object's%20%60__doc__%60%20attribute.%20PEP%20257%20recommends%20triple%20double%20quotes.%20For%20example%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20a_list%20%3D%20%5B1%2C%202%5D%0A%20%20%20%20print(a_list.__doc__)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20When%20writing%20a%20Python%20function%2C%20docstrings%20are%20introduced%20immediately%20after%20the%20%60def%20...%60%20line%20with%20triple%20double-quotes%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20def%20let_there_be_light(*args%2C%20**kwargs)%3A%0A%20%20%20%20%20%20%22%22%22Print%20a%20sunrise%20message%20and%20return%20%60True%60.%0A%0A%20%20%20%20%20%20Args%3A%0A%20%20%20%20%09%20%20*args%3A%20Positional%20arguments%20accepted%20but%20not%20used.%0A%20%20%20%20%09%20%20**kwargs%3A%20Keyword%20arguments%20accepted%20but%20not%20used.%0A%0A%20%20%20%20%20%20Returns%3A%0A%20%20%20%20%09%20%20%60True%60%20in%20all%20cases.%0A%20%20%20%20%20%20%22%22%22%0A%20%20%20%20%20%20print(%22Sunrise%22)%0A%20%20%20%20%20%20return%20True%0A%0A%20%20%20%20print(let_there_be_light.__doc__)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20Note%20that%20the%20recommendations%20on%20docstrings%20are%20provided%20with%20%5B*PEP*%20257%5D(https%3A%2F%2Fwww.python.org%2Fdev%2Fpeps%2Fpep-0257%2F)%20rather%20than%20*PEP*%208.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Name%20Conventions%0A%0A%20%20%20%20%23%23%23%20Definition%20of%20Name%20Styles%0A%0A%20%20%20%20The%20naming%20conventions%20use%20the%20following%20styles%20(source%3A%20%5Bpython.org%5D(https%3A%2F%2Fwww.python.org%2Fdev%2Fpeps%2Fpep-0008%2F%23naming-conventions))%3A%0A%0A%20%20%20%20*%20Classes%20normally%20use%20CapWords%2C%20for%20example%20%60MyClass%60.%0A%20%20%20%20*%20User-defined%20exception%20classes%20follow%20the%20class-naming%20convention%20and%20normally%20use%20the%20suffix%20%60Error%60%20when%20they%20represent%20an%20error%2C%20for%20example%20%60ConfigurationError%60.%0A%20%20%20%20*%20Functions%2C%20methods%2C%20and%20variables%20use%20lowercase%20words%20separated%20by%20underscores%20as%20needed%20for%20readability.%0A%20%20%20%20*%20Constants%20normally%20use%20uppercase%20words%20separated%20by%20underscores%2C%20for%20example%20%60WATER_DENSITY%20%3D%201000%60.%0A%0A%20%20%20%20Some%20variable%20name%20formats%20trigger%20a%20particular%20behavior%20of%20Python%3A%0A%0A%20%20%20%20*%20%60_single_leading_underscore%60%20variables%20indicate%20weak%20internal%20use%20and%20will%20not%20be%20imported%20with%20%60from%20module%20import%20*%60%0A%20%20%20%20*%20%60__double_leading_underscore%60%20variables%20invoke%20name%20mangling%20in%20classes%20(e.g.%2C%20a%20method%20called%20%60__dlu%60%20of%20the%20class%20%60MyClass%60%20will%20be%20mangled%20into%20%60_MyClass__dlu%60)%0A%20%20%20%20*%20%60__double_leading_and_trailing_underscore__%60%20variables%20are%20*magic*%20objects%20or%20attributes%20in%20user-controlled%20namespaces%20(e.g.%2C%20%60__init__%60%20or%20%60__call__%60%20in%20classes)%20%3Cbr%3EOnly%20use%20documented%20magic%20attributes%20and%20never%20invent%20them.%20Read%20more%20about%20magic%20methods%20in%20the%20chapter%20on%20%5BPython%20classes%5D(https%3A%2F%2Fhydro-informatics.com%2Fjupyter%2Fclasses.html%23magic).%0A%20%20%20%20*%20%60single_trailing_underscore_%60%20variables%20are%20used%20to%20avoid%20conflicts%20with%20Python%20keywords%20(e.g.%2C%20%60MyClass(class_%3D'AnotherClass')%60)%0A%0A%20%20%20%20%23%23%23%20Object%20Names%0A%0A%20%20%20%20Use%20the%20above-defined%20styles%20for%20naming%20Python%20items%20as%20follows%3A%0A%0A%20%20%20%20*%20Classes%3A%20%60CamelCase%60%20(%60CapWords%60)%20letters%20only%20such%20as%20%60MyClass%60%0A%20%20%20%20*%20Constants%3A%20%60UPPERCASE%60%20letters%20only%2C%20where%20underscores%20may%20improve%20readability%20(e.g.%2C%20use%20at%20a%20module%20level%20for%20example%20to%20assign%20water%20density%20%60RHO%20%3D%201000%60)%0A%20%20%20%20*%20Exceptions%3A%20%60CamelCase%60%20(%60CapWords%60)%20letters%20only%20(exceptions%20should%20be%20predefined%20*Error*%20classes%3B%20typically%20use%20the%20suffix%20%60Error%60%20(e.g.%2C%20%60TypeError%60)%0A%20%20%20%20*%20Functions%3A%20%60lowercase%60%20letters%20only%2C%20where%20underscores%20may%20improve%20readability%3B%20sometimes%20%60mixedCase%60%20applies%20to%20ensure%20backward%20compatibility%20of%20prevailing%20styles%0A%20%20%20%20*%20Methods%20(class%20function%2C%20non-public)%3A%20%60_lowercase%60%20letters%20only%20with%20a%20leading%20underscore%2C%20where%20underscores%20may%20improve%20readability%0A%20%20%20%20*%20Methods%20(class%20function%2C%20public)%3A%20%60lowercase%60%20letters%20only%2C%20where%20underscores%20may%20improve%20readability%0A%20%20%20%20*%20Modules%3A%20%60lowercase%60%20letters%20only%2C%20where%20underscores%20may%20improve%20readability%0A%20%20%20%20*%20Packages%3A%20%60lowercase%60%20letters%20only%2C%20where%20underscores%20are%20discouraged%0A%20%20%20%20*%20Variables%3A%20%60lowercase%60%20letters%20only%2C%20where%20underscores%20may%20improve%20readability%0A%20%20%20%20*%20Variables%20(global)%3A%20%60lowercase%60%20letters%20only%2C%20where%20underscores%20may%20improve%20readability%3B%20note%20that%20%22global%22%20should%20limit%20to%20variable%20usage%20within%20one%20module%20only.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20**Important**%3A%20Never%20start%20a%20variable%20name%20with%20a%20number.%20Do%20**use%20%60array_2d%60**%2C%20but%20do%20**not%20use%20%602d_array%60**.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20More%20Code%20Style%20Recommendations%0A%0A%20%20%20%20To%20ensure%20code%20compatibility%20and%20program%20efficiency%2C%20the%20*PEP%208*%20style%20guide%20provides%20other%20general%20recommendations%20(read%20more%20in%20the%20%5BPython%20docs%5D(https%3A%2F%2Fwww.python.org%2Fdev%2Fpeps%2Fpep-0008%2F%23programming-recommendations))%3A%0A%0A%20%20%20%20*%20Prefer%20a%20%60def%60%20statement%20when%20creating%20a%20named%20function%3B%20do%20not%20assign%20a%20lambda%20expression%20directly%20to%20a%20name.%20A%20short%20lambda%20can%20be%20appropriate%20when%20passed%20directly%20as%20an%20argument%2C%20for%20example%20%60items.sort(key%3Dlambda%20item%3A%20item.name)%60.%0A%20%20%20%20*%20When%20exceptions%20are%20expected%2C%20use%20%60try%60%20-%20%60except%60%20clauses%20(see%20the%20%5Berrors%20and%20exceptions%5D(https%3A%2F%2Fhydro-informatics.com%2Fpyerror%23try-except)%20section).%0A%20%20%20%20*%20Ensure%20that%20methods%20and%20functions%20return%20objects%20consistently%2C%20for%20example%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(np)%3A%0A%20%20%20%20def%20a_function_with_return(x)%3A%0A%20%20%20%20%20%20%20%20if%20x%20%3E%200%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20np.sqrt(x)%0A%20%20%20%20%20%20%20%20return%20np.nan%0A%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A