04-functions-and-apis

%23%20%2F%2F%2F%20script%0A%23%20requires-python%20%3D%20%22%3E%3D3.12%2C%3C3.15%22%0A%23%20dependencies%20%3D%20%5B%22marimo%22%2C%20%22requests%3D%3D2.33.1%22%5D%0A%23%20%0A%23%20%5Btool.marimo.export%5D%0A%23%20lock_kind%20%3D%20%22observed%22%0A%23%20%2F%2F%2F%0A%22%22%22Functions%20and%20APIs.%0A%22%22%22%0A%0Aimport%20marimo%0A%0A__generated_with%20%3D%20%220.25.2%22%0Aapp%20%3D%20marimo.App(width%3D%22medium%22%2C%20sql_output%3D%22polars%22)%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%20Functions%20and%20APIs%0A%0A%20%20%20%20This%20session%20moves%20between%20two%20notebooks.%20It%20opens%20with%20section%204%20of%20notebook%203%2C%20%6003-collections-and-apis.py%60%2C%20then%20comes%20here%20for%20section%201%2C%20on%20functions.%20After%20the%20break%20it%20goes%20back%20for%20section%205%20of%20notebook%203%2C%20the%20first%20requests%20to%20a%20server%2C%20and%20returns%20here%20for%20the%20rest%3A%20reading%20an%20API%20built%20for%20this%20course%2C%20and%20sending%20data%20to%20it.%0A%0A%20%20%20%20%7C%20%7C%20%7C%0A%20%20%20%20%7C---%7C---%7C%0A%20%20%20%20%7C%20%E2%9C%8F%EF%B8%8F%20%7C%20Your%20turn.%20Add%20cells%20with%20the%20**%2B**%20button%20%7C%0A%20%20%20%20%7C%20%F0%9F%9A%80%20%7C%20This%20week's%20work%20%7C%0A%0A%20%20%20%20For%20a%20written%20answer%2C%20add%20a%20cell%20under%20the%20question%2C%20open%20the%20cell's%20**%E2%8B%AF**%20menu%20and%20choose%20**Convert%20to%20Markdown**.%0A%0A%20%20%20%20Every%20%E2%9C%8F%EF%B8%8F%20is%20part%20of%20this%20week's%20work.%20Those%20marked%20**Advanced**%20are%20optional%3B%20try%20them%20once%20the%20rest%20is%20done.%20So%20is%20the%20**Going%20further**%20at%20the%20end%20of%20an%20exercise.%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**Work%20with%20your%20agent%20the%20same%20way%20as%20in%20notebook%203.**%20Try%20it%20yourself%20first%2C%20or%20write%20the%20steps%20in%20words.%20Then%20ask%20your%20agent%2C%20ask%20it%20to%20explain%20any%20line%20you%20could%20not%20have%20written%2C%20and%20ask%20which%20concepts%20its%20answer%20used.%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%201.%20Functions%0A%0A%20%20%20%20Notebooks%202%20and%203%20each%20computed%20what%20the%20portfolio%20costs%2C%20and%20each%20time%20the%20loop%20was%20written%20out%20again.%20A%20**function**%20gives%20that%20work%20a%20name%2C%20so%20it%20is%20written%20once%20and%20used%20on%20any%20portfolio.%0A%0A%20%20%20%20You%20have%20called%20functions%20since%20the%20first%20day%3A%20%60len(...)%60%2C%20%60round(...)%60%2C%20%60print(...)%60.%20Each%20takes%20something%20in%20and%20gives%20something%20back%2C%20the%20way%20%60SUM(A1%3AA6)%60%20does%20in%20a%20spreadsheet.%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%20Start%20with%20the%20smallest%20one%3A%0A%0A%20%20%20%20-%20%60def%60%20starts%20a%20function.%0A%20%20%20%20-%20%60add_tax%60%20is%20its%20name%2C%20a%20verb%20and%20a%20noun%20for%20what%20it%20does.%0A%20%20%20%20-%20%60amount%60%20in%20brackets%20is%20its%20**parameter**%2C%20what%20it%20takes%20in.%0A%20%20%20%20-%20%60return%60%20is%20what%20it%20gives%20back.%0A%0A%20%20%20%20Defining%20it%20runs%20nothing%3B%20it%20runs%20each%20time%20it%20is%20called.%20Massachusetts%20sales%20tax%20is%206.25%25%2C%20so%20the%20function%20multiplies%20by%201.0625.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.function%0Adef%20add_tax(amount)%3A%0A%20%20%20%20return%20round(amount%20*%201.0625%2C%202)%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20add_tax(100)%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%20If%20the%20tax%20rate%20changes%2C%20you%20edit%20the%20one%20line%20inside%20%60add_tax%60%2C%20and%20every%20call%20uses%20the%20new%20rate.%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%20holdings%20%3D%20%5B%0A%20%20%20%20%20%20%20%20(%22AAPL%22%2C%20100%2C%20173.93)%2C%0A%20%20%20%20%20%20%20%20(%22MSFT%22%2C%2050%2C%20319.53)%2C%0A%20%20%20%20%20%20%20%20(%22GOOG%22%2C%2080%2C%20131.36)%2C%0A%20%20%20%20%20%20%20%20(%22AMZN%22%2C%20200%2C%20129.33)%2C%0A%20%20%20%20%20%20%20%20(%22NVDA%22%2C%2020%2C%20410.17)%2C%0A%20%20%20%20%20%20%20%20(%22TSLA%22%2C%20150%2C%20255.70)%2C%0A%20%20%20%20%5D%0A%20%20%20%20holdings%0A%20%20%20%20return%20(holdings%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**Names%20inside%20a%20function%20belong%20to%20that%20function.**%20%60symbol%60%2C%20%60shares%60%20and%20%60cost_so_far%60%20exist%20only%20while%20it%20runs%2C%20so%20they%20need%20no%20underscore%2C%20and%20two%20functions%20can%20each%20use%20%60price%60%20without%20colliding.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.function%0Adef%20compute_cost(portfolio)%3A%0A%20%20%20%20cost_so_far%20%3D%200%0A%20%20%20%20for%20symbol%2C%20shares%2C%20price%20in%20portfolio%3A%0A%20%20%20%20%20%20%20%20cost_so_far%20%3D%20cost_so_far%20%2B%20shares%20*%20price%0A%20%20%20%20return%20round(cost_so_far%2C%202)%0A%0A%0A%40app.cell%0Adef%20_(holdings)%3A%0A%20%20%20%20compute_cost(holdings)%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%20A%20second%20client%20holds%20two%20funds%20and%20one%20stock.%20The%20same%20function%20answers%20for%20them%2C%20with%20no%20new%20loop.%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%20retirement_holdings%20%3D%20%5B%0A%20%20%20%20%20%20%20%20(%22VTI%22%2C%20120%2C%20228.40)%2C%0A%20%20%20%20%20%20%20%20(%22BND%22%2C%20300%2C%2072.15)%2C%0A%20%20%20%20%20%20%20%20(%22AAPL%22%2C%2040%2C%20173.93)%2C%0A%20%20%20%20%5D%0A%20%20%20%20retirement_holdings%0A%20%20%20%20return%20(retirement_holdings%2C)%0A%0A%0A%40app.cell%0Adef%20_(retirement_holdings)%3A%0A%20%20%20%20compute_cost(retirement_holdings)%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**Why%20programs%20are%20built%20from%20functions%3A**%0A%0A%20%20%20%20-%20**A%20change%20happens%20in%20one%20place.**%20Add%20a%20trading%20fee%20inside%20%60compute_cost%60%20and%20every%20portfolio's%20cost%20follows.%0A%20%20%20%20-%20**The%20name%20says%20what%20the%20work%20is%20for.**%20%60compute_cost(retirement_holdings)%60%20reads%20as%20a%20sentence%3B%20a%20loop%20has%20to%20be%20read%20line%20by%20line.%0A%20%20%20%20-%20**Everything%20it%20needs%20comes%20in%20through%20the%20brackets.**%20So%20you%20can%20test%20it%20on%20a%20portfolio%20whose%20answer%20you%20already%20know%2C%20such%20as%20notebook%203's%20%24116%2C302.70.%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%20%E2%9C%8F%EF%B8%8F%20A%20%C2%B7%20Functions%20of%20your%20own%0A%0A%20%20%20%201.%20Add%20a%20cell%20that%20defines%20%60count_shares(portfolio)%60.%20It%20returns%20the%20total%20number%20of%20shares%20in%20a%20portfolio.%20Call%20it%20on%20both%20portfolios.%20*Check%20yourself%3A%20%60600%60%20and%20%60460%60.*%0A%20%20%20%202.%20Add%20a%20cell%20that%20defines%20%60find_largest(portfolio)%60.%20It%20returns%20the%20ticker%20and%20the%20cost%20of%20the%20holding%20that%20cost%20the%20most%2C%20as%20a%20tuple.%20Call%20it%20on%20both%20portfolios.%20*Check%20yourself%3A%20%60('TSLA'%2C%2038355.0)%60%20and%20%60('VTI'%2C%2027408.0)%60.*%0A%0A%20%20%20%20**Going%20further.**%20Add%20a%20second%20parameter%2C%20%60n%60%2C%20and%20return%20the%20%60n%60%20largest%20holdings%2C%20largest%20first.%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%20%E2%9C%8F%EF%B8%8F%20B%20%C2%B7%20Without%20%60return%60%0A%0A%20%20%20%20Copy%20%60count_shares%60%20into%20a%20new%20cell%20under%20a%20new%20name%2C%20and%20put%20%60print(...)%60%20where%20the%20%60return%60%20was.%20Call%20it%20and%20keep%20the%20result%20in%20a%20name.%20In%20a%20markdown%20cell%20under%20it%2C%20answer%3A%20what%20does%20that%20name%20hold%2C%20and%20what%20could%20the%20next%20cell%20do%20with%20it%3F%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%202.%20Calling%20an%20API%0A%0A%20%20%20%20Calling%20an%20**API**%20is%20like%20calling%20a%20function%20someone%20else%20wrote%2C%20running%20on%20their%20computer.%20You%20call%20it%20with%20a%20web%20address%2C%20their%20server%20runs%20its%20code%2C%20and%20the%20result%20comes%20back%20to%20you.%0A%0A%20%20%20%20%7C%20%7C%20Calling%20a%20function%20you%20wrote%20%7C%20Calling%20an%20API%20%7C%0A%20%20%20%20%7C---%7C---%7C---%7C%0A%20%20%20%20%7C%20**You%20call%20it%20with**%20%7C%20%60get_towns(%22Norfolk%22)%60%20%7C%20%60oim.zhili.dev%2Fma%2Ftowns%3Fcounty%3DNorfolk%60%20%7C%0A%20%20%20%20%7C%20**What%20goes%20in**%20%7C%20parameters%20in%20brackets%20%7C%20parameters%20after%20%60%3F%60%20%7C%0A%20%20%20%20%7C%20**What%20comes%20back**%20%7C%20the%20%60return%60%20value%20%7C%20a%20reply%2C%20usually%20JSON%20%7C%0A%20%20%20%20%7C%20**When%20it%20goes%20wrong**%20%7C%20an%20error%20in%20your%20notebook%20%7C%20a%20status%20code%20and%20a%20message%20%7C%0A%20%20%20%20%7C%20**Where%20it%20runs**%20%7C%20your%20laptop%20%7C%20somebody%20else's%20server%20%7C%0A%0A%20%20%20%20You%20cannot%20see%20the%20code%20behind%20an%20API%2C%20so%20its%20documentation%20is%20how%20you%20learn%20its%20parameters%20and%20what%20it%20returns.%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%20The%20course%20runs%20its%20own%20API%20at%20%60oim.zhili.dev%60.%20Its%20Massachusetts%20endpoints%20come%20from%20the%20state's%20%5BDivision%20of%20Local%20Services%5D(https%3A%2F%2Fwww.mass.gov%2Finfo-details%2Fdivision-of-local-services-municipal-databank)%3A%20every%20city%20and%20town%2C%20its%20population%20and%20income%2C%20and%20its%20property%20tax%20rates%20and%20bills.%20The%20documentation%20is%20at%20%5Boim.zhili.dev%2Fdocs%5D(https%3A%2F%2Foim.zhili.dev%2Fdocs)%2C%20and%20the%20API%20also%20lists%20its%20own%20endpoints.%20**Before%20any%20code**%2C%20open%20%5Boim.zhili.dev%2Fmass%5D(https%3A%2F%2Foim.zhili.dev%2Fmass)%20and%20%5Boim.zhili.dev%2Fma%2Ftowns%3Fcounty%3DNorfolk%5D(https%3A%2F%2Foim.zhili.dev%2Fma%2Ftowns%3Fcounty%3DNorfolk)%20in%20your%20browser%20and%20read%20what%20comes%20back.%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%20requests%0A%0A%20%20%20%20return%20(requests%2C)%0A%0A%0A%40app.cell%0Adef%20_(requests)%3A%0A%20%20%20%20ma_endpoints%20%3D%20requests.get(%22https%3A%2F%2Foim.zhili.dev%2Fma%22%2C%20timeout%3D10).json()%0A%20%20%20%20ma_endpoints%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%60%2Fma%2Ftowns%60%20takes%20a%20%60county%60.%20Pass%20parameters%20as%20a%20dictionary%20with%20%60params%3D%60%2C%20and%20%60requests%60%20builds%20the%20address.%20%60.url%60%20shows%20the%20address%20it%20built.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(requests)%3A%0A%20%20%20%20norfolk_reply%20%3D%20requests.get(%0A%20%20%20%20%20%20%20%20%22https%3A%2F%2Foim.zhili.dev%2Fma%2Ftowns%22%2C%0A%20%20%20%20%20%20%20%20params%3D%7B%22county%22%3A%20%22Norfolk%22%7D%2C%0A%20%20%20%20%20%20%20%20timeout%3D10%2C%0A%20%20%20%20)%0A%20%20%20%20norfolk_reply.status_code%2C%20norfolk_reply.url%0A%20%20%20%20return%20(norfolk_reply%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**Why%20a%20dictionary.**%20A%20value%20with%20a%20space%20in%20it%20has%20to%20be%20encoded%20before%20it%20can%20go%20in%20an%20address%2C%20and%20%60params%3D%60%20does%20that%20for%20you.%20Ask%20for%20%60%7B%22name%22%3A%20%22West%20Newbury%22%7D%60%20and%20%60.url%60%20ends%20in%20%60name%3DWest%2BNewbury%60.%0A%0A%20%20%20%20The%20reply%20is%20a%20dictionary%20with%20two%20keys.%20%60pagination%60%20states%20how%20much%20there%20is.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(norfolk_reply)%3A%0A%20%20%20%20norfolk_page%20%3D%20norfolk_reply.json()%0A%20%20%20%20norfolk_page%5B%22pagination%22%5D%0A%20%20%20%20return%20(norfolk_page%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%60items%60%20is%20a%20table%3A%20a%20list%20of%20records%2C%20one%20per%20town%2C%20the%20same%20shape%20as%20the%20orders%20in%20notebook%202.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(norfolk_page)%3A%0A%20%20%20%20norfolk_page%5B%22items%22%5D%5B0%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%20Wrap%20the%20request%20in%20a%20function%20and%20the%20endpoint%20becomes%20a%20Python%20function.%20%60get_towns%60%20takes%20a%20county%20and%20returns%20its%20towns%2C%20and%20the%20cell%20that%20calls%20it%20never%20sees%20the%20address.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(requests)%3A%0A%20%20%20%20def%20get_towns(county)%3A%0A%20%20%20%20%20%20%20%20towns_reply%20%3D%20requests.get(%0A%20%20%20%20%20%20%20%20%20%20%20%20%22https%3A%2F%2Foim.zhili.dev%2Fma%2Ftowns%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20params%3D%7B%22county%22%3A%20county%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20timeout%3D10%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20return%20towns_reply.json()%5B%22items%22%5D%0A%0A%20%20%20%20return%20(get_towns%2C)%0A%0A%0A%40app.cell%0Adef%20_(get_towns)%3A%0A%20%20%20%20get_towns(%22Suffolk%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%20%E2%9C%8F%EF%B8%8F%20Weather%20by%20Town%0A%0A%20%20%20%20In%20notebook%203%20you%20searched%20Open-Meteo%20for%20a%20town%20(F)%20and%20asked%20for%20the%20weather%20at%20a%20pair%20of%20coordinates.%20Put%20the%20two%20requests%20in%20one%20function.%0A%0A%20%20%20%20Add%20a%20cell%20that%20defines%20%60get_temperature(town)%60.%20It%20searches%20for%20%60town%60%20with%20%60count%3D1%60%2C%20takes%20the%20latitude%20and%20longitude%20of%20the%20first%20result%2C%20asks%20for%20the%20current%20temperature%20in%20%C2%B0F%2C%20and%20returns%20that%20number.%20Then%20call%20it%3A%20%60get_temperature(%22Wellesley%22)%60.%0A%0A%20%20%20%20*Check%20yourself%3A%20within%20a%20degree%20or%20two%20of%20notebook%203's%20reading%20at%20Babson%2C%20since%20Wellesley%20is%20next%20door.*%0A%0A%20%20%20%20**Going%20further.**%20Try%20%60get_temperature(%22Babson%20Park%22)%60.%20Add%20a%20second%20parameter%2C%20%60state%60%2C%20so%20the%20function%20uses%20the%20first%20place%20in%20that%20state.%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%20%E2%9C%8F%EF%B8%8F%20C%20%C2%B7%20Read%20the%20documentation%0A%0A%20%20%20%20Open%20%5Boim.zhili.dev%2Fdocs%5D(https%3A%2F%2Foim.zhili.dev%2Fdocs)%20and%20find%20%60%2Fma%2Ftowns%60.%20Use%20its%20parameters%20to%20ask%20for%20the%20five%20Norfolk%20towns%20with%20the%20highest%20income%20per%20person%2C%20highest%20first.%20Let%20the%20server%20do%20the%20sorting.%0A%0A%20%20%20%20*Check%20yourself%3A%20Dover%2C%20Wellesley%2C%20Cohasset%2C%20Needham%2C%20Westwood.*%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%20%E2%9C%8F%EF%B8%8F%20D%20%C2%B7%20From%20a%20Name%20to%20a%20History%0A%0A%20%20%20%201.%20Find%20Wellesley's%20%60dor_code%60%20with%20the%20%60name%60%20parameter%20of%20%60%2Fma%2Ftowns%60.%0A%20%20%20%202.%20Use%20it%20to%20ask%20%60%2Fma%2Ftowns%2F%7Bdor_code%7D%2Fhistory%60%20for%20fiscal%20year%202026%20alone%2C%20with%20the%20year%20parameters%20the%20docs%20list%20for%20that%20endpoint.%20A%20parameter%20the%20endpoint%20does%20not%20list%20is%20ignored%20without%20an%20error.%0A%20%20%20%203.%20Check%20the%20bill%20a%20second%20way%3A%20the%20average%20value%20times%20the%20tax%20rate%2C%20divided%20by%201%2C000.%0A%0A%20%20%20%20*Check%20yourself%3A%20%60317%60.%20Then%20%242%2C020%2C758%20%C3%97%2010.17%20%2F%201%2C000%20%3D%20%2420%2C551.11%2C%20and%20the%20reply's%20bill%20is%20%2420%2C551.*%0A%0A%20%20%20%20**Going%20further.**%20Write%20%60town_history(name)%60%2C%20which%20takes%20a%20town's%20name%2C%20makes%20both%20requests%2C%20and%20returns%20the%20history.%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%203.%20More%20Than%20One%20Page%0A%0A%20%20%20%20Leave%20%60county%60%20out%20and%20%60%2Fma%2Ftowns%60%20has%20every%20town%20in%20the%20state%20to%20give%20you.%20Read%20how%20many%20it%20sends.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(requests)%3A%0A%20%20%20%20state_first_page%20%3D%20requests.get(%22https%3A%2F%2Foim.zhili.dev%2Fma%2Ftowns%22%2C%20timeout%3D10).json()%0A%20%20%20%20len(state_first_page%5B%22items%22%5D)%2C%20state_first_page%5B%22pagination%22%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**Why%20a%20server%20sends%20pages.**%20It%20answers%20many%20people%20at%20once%2C%20so%20it%20limits%20what%20one%20request%20can%20cost%20it.%20The%20course%20shop%20has%20more%20than%2015%2C000%20orders%20behind%20%60%2Fshop%2Forders%60%2C%20with%20a%20few%20more%20every%20day%2C%20and%20one%20reply%20holding%20all%20of%20them%20would%20be%20slow%20to%20send%20and%20slow%20to%20read.%20You%20can%20ask%20for%20bigger%20pages%20up%20to%20a%20limit%2C%20and%20past%20it%20the%20server%20refuses.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(requests)%3A%0A%20%20%20%20too_big_reply%20%3D%20requests.get(%0A%20%20%20%20%20%20%20%20%22https%3A%2F%2Foim.zhili.dev%2Fma%2Ftowns%22%2C%0A%20%20%20%20%20%20%20%20params%3D%7B%22per_page%22%3A%20500%7D%2C%0A%20%20%20%20%20%20%20%20timeout%3D10%2C%0A%20%20%20%20)%0A%20%20%20%20too_big_reply.status_code%2C%20too_big_reply.json()%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**422**%20means%20the%20request%20had%20the%20right%20shape%20and%20a%20value%20the%20server%20will%20not%20accept.%20Its%20reply%20names%20the%20limit.%0A%0A%20%20%20%20So%20reading%20everything%20takes%20one%20request%20per%20page.%20%60get_page%60%20asks%20for%20one%20page.%20%60per_page%3D100%60%20in%20its%20brackets%20is%20a%20**default**%3A%20%60get_page(2)%60%20uses%20100%2C%20and%20%60get_page(2%2C%2020)%60%20uses%2020.%20The%20server's%20parameters%20have%20defaults%20too%2C%20which%20is%20why%20leaving%20out%20%60page%60%20gave%20page%201.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(requests)%3A%0A%20%20%20%20def%20get_page(page%2C%20per_page%3D100)%3A%0A%20%20%20%20%20%20%20%20page_reply%20%3D%20requests.get(%0A%20%20%20%20%20%20%20%20%20%20%20%20%22https%3A%2F%2Foim.zhili.dev%2Fma%2Ftowns%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20params%3D%7B%22page%22%3A%20page%2C%20%22per_page%22%3A%20per_page%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20timeout%3D10%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20return%20page_reply.json()%0A%0A%20%20%20%20return%20(get_page%2C)%0A%0A%0A%40app.cell%0Adef%20_(get_page)%3A%0A%20%20%20%20get_page(1)%5B%22pagination%22%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%23%23%20%E2%9C%8F%EF%B8%8F%20E%20%C2%B7%20Every%20town%0A%0A%20%20%20%20Write%20%60get_all_towns()%60.%20It%20reads%20page%201%2C%20takes%20%60pages%60%20from%20its%20%60pagination%60%2C%20reads%20the%20pages%20after%20it%20with%20%60range(2%2C%20pages%20%2B%201)%60%2C%20and%20returns%20one%20list%20of%20every%20town.%0A%0A%20%20%20%20*Check%20yourself%3A%20351%20towns%2C%20the%20same%20number%20as%20%60pagination%5B%22total%22%5D%60.%20The%20first%20is%20Abington%20and%20the%20last%20is%20Yarmouth.*%0A%0A%20%20%20%20The%20count%20you%20collected%20against%20the%20total%20the%20server%20reports%20is%20a%20check%20you%20can%20run%20on%20any%20API%20that%20sends%20pages.%0A%0A%20%20%20%20**Going%20further.**%20Which%20town%20has%20the%20highest%20average%20single-family%20tax%20bill%20in%20the%20state%2C%20and%20which%20the%20lowest%3F%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%204.%20Sending%20Data%0A%0A%20%20%20%20Every%20request%20so%20far%20has%20been%20a%20**GET**%2C%20which%20asks%20for%20data%20and%20changes%20nothing.%20A%20**POST**%20sends%20data%20for%20the%20server%20to%20keep.%20Submitting%20a%20form%20on%20a%20website%20is%20a%20POST.%0A%0A%20%20%20%20The%20course%20API%20has%20a%20board%2C%20%5Boim.zhili.dev%2Flive%5D(https%3A%2F%2Foim.zhili.dev%2Flive)%2C%20with%20one%20line%20per%20student.%20A%20POST%20to%20%60%2Fmessage%60%20writes%20yours.%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**The%20server%20has%20to%20know%20who%20sent%20it.**%20A%20request%20can%20carry%20**headers**%2C%20lines%20that%20travel%20beside%20the%20address.%20Here%20the%20header%20%60x-token%60%20holds%20your%20GitHub%20username%2C%20and%20the%20board%20shows%20your%20first%20name.%20Your%20username%20is%20public%2C%20so%20it%20can%20sit%20in%20a%20cell.%20A%20real%20API's%20key%20goes%20in%20a%20header%20the%20same%20way%2C%20but%20a%20key%20is%20a%20secret%20and%20never%20goes%20in%20a%20cell%3A%20%5BMini%20Project%202%5D(%2Fassignments%2Fmini-project-2%2F)%20says%20where%20to%20keep%20one.%0A%0A%20%20%20%20**The%20message%20goes%20in%20the%20body.**%20%60json%3D%60%20puts%20it%20there%2C%20which%20is%20where%20a%20POST%20carries%20its%20data.%20%60params%3D%60%20puts%20values%20in%20the%20address%2C%20which%20is%20for%20asking.%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%20%E2%9C%8F%EF%B8%8F%20F%20%C2%B7%20Write%20on%20the%20board%0A%0A%20%20%20%201.%20Look%20up%20a%20town%20you%20know%20with%20the%20%60name%60%20parameter%20of%20%60%2Fma%2Ftowns%60.%20Keep%20its%20name%20as%20%60town_name%60%20and%20its%20average%20single-family%20bill%20as%20%60town_bill%60.%0A%20%20%20%202.%20Add%20a%20cell%20with%20the%20code%20below%2C%20replace%20%60%3Cyour-github-username%3E%60%2C%20angle%20brackets%20included%2C%20with%20your%20GitHub%20username%2C%20and%20run%20it.%0A%0A%20%20%20%20%20%20%20%60%60%60python%0A%20%20%20%20%20%20%20board_reply%20%3D%20requests.post(%0A%20%20%20%20%20%20%20%20%20%20%20%22https%3A%2F%2Foim.zhili.dev%2Fmessage%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20headers%3D%7B%22x-token%22%3A%20%22%3Cyour-github-username%3E%22%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20json%3D%7B%22message%22%3A%20f%22%7Btown_name%7D%3A%20%24%7Btown_bill%3A%2C%7D%22%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20timeout%3D10%2C%0A%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20board_reply.status_code%2C%20board_reply.json()%0A%20%20%20%20%20%20%20%60%60%60%0A%0A%20%20%20%20%20%20%20*Check%20yourself%3A%20**201**%2C%20which%20means%20the%20server%20created%20something%2C%20and%20your%20town%20on%20the%20board.*%0A%0A%20%20%20%203.%20Delete%20the%20%60headers%3D%60%20line%20and%20run%20it%20again.%20In%20a%20markdown%20cell%20under%20it%2C%20answer%3A%20what%20did%20the%20server%20answer%2C%20and%20why%20does%20it%20need%20to%20know%20who%20sent%20a%20message%3F%0A%0A%20%20%20%20**Going%20further.**%20Post%20something%20more%20useful%20than%20one%20town's%20bill%3A%20choose%20a%20question%20somebody%20would%20ask%2C%20answer%20it%20from%20live%20data%2C%20and%20post%20the%20answer%2C%20in%20140%20characters%20or%20fewer.%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**Advanced%20%C2%B7%20G%20%C2%B7%20Take%20it%20down.**%20%60requests.delete%60%20on%20the%20same%20address%2C%20with%20the%20same%20header%2C%20removes%20your%20line.%20Run%20it%20twice%20and%20compare%20the%20two%20replies.%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%20%F0%9F%9A%80%20This%20Week's%20Work%0A%0A%20%20%20%201.%20**What%20is%20due%20is%20listed%20under%20*Before%20next%20session*%20in%20the%20post-class%20notes.**%20I%20post%20them%20on%20the%20session%20page%20after%20each%20class%2C%20with%20the%20sections%20we%20reached%2C%20and%20the%20checkpoint%20on%20Canvas%20lists%20the%20same%20items.%0A%20%20%20%202.%20**%5BMini%20Project%201%5D(%2Fassignments%2Fmini-project-1%2F)**%2C%20due%20Sunday%2010%2F11%0A%20%20%20%203.%20**%5BMini%20Project%202%5D(%2Fassignments%2Fmini-project-2%2F)**%2C%20due%20Sunday%2010%2F25%0A%20%20%20%204.%20**Commit%20as%20you%20go**%2C%20with%20messages%20that%20state%20what%20changed%2C%20and%20push%20before%20you%20stop%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**Self-check%3A**%0A%0A%20%20%20%20-%20%5B%20%5D%20I%20can%20write%20a%20function%20with%20%60def%60%2C%20with%20parameters%2C%20a%20default%20and%20a%20%60return%60%0A%20%20%20%20-%20%5B%20%5D%20I%20can%20state%20why%20a%20piece%20of%20work%20belongs%20in%20a%20function%0A%20%20%20%20-%20%5B%20%5D%20I%20can%20find%20an%20endpoint's%20parameters%20in%20an%20API's%20documentation%20and%20pass%20them%20with%20%60params%3D%60%0A%20%20%20%20-%20%5B%20%5D%20I%20can%20read%20every%20page%20of%20an%20API%20that%20sends%20pages%2C%20and%20check%20the%20count%20against%20the%20total%0A%20%20%20%20-%20%5B%20%5D%20I%20can%20send%20data%20to%20an%20API%20with%20a%20POST%20and%20a%20header%0A%20%20%20%20%22%22%22)%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