31:[] 2f:{"title":"Tutorial: Dog pictures","cells":[{"id":0,"value":"md`# Tutorial: Dog pictures\n\n### Steps\n\n1. Fetch a dog picture\n3. Show that dog picture\n4. Fetch a list and explore the data\n6. Import from another notebook\n6. Organize your notebook\n6. Customize the dogs`","pinned":false,"hidden":false,"mode":"ojs"},{"id":10,"value":"step1 = md`---\n\n## Step 1: Fetch a dog picture\n\nWe’ll be using [dog.ceo](https://dog.ceo/) for this example, an API that lets you find free dog pictures. As a web API, it’s a service that responds to web requests with a standard format, in this case JSON. We can use the standard [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) API to request each dog picture.\n\n\\`\\`\\`js\ndog = (await fetch(\\`https://dog.ceo/api/breeds/image/random\\`)).json()\n\\`\\`\\``","pinned":false,"hidden":false,"mode":"ojs"},{"id":90,"value":"video(\"tutorial-2/1\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":200,"value":"dog = (await fetch(`https://dog.ceo/api/breeds/image/random`)).json()","pinned":true,"hidden":false,"mode":"ojs"},{"id":19,"value":"step2 = md`---\n\n## Step 2: Show that dog picture\n\nOkay, so now we’ve got an object of the API’s response, from which we can get the dog image. Let’s grab that dog image and display it in an img tag, using the built-in html [tagged template literal](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals).\n\n\\`\\`\\`js\nhtml\\`

\\`\n\\`\\`\\`\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":94,"value":"video(\"tutorial-2/2\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":202,"value":"html`

`","pinned":true,"hidden":false,"mode":"ojs"},{"id":58,"value":"step3 = md`---\n\n## Step 3: Fetch a list and explore the data\n\nNext up, let’s make it easy to select a specific breed of dog. dog.ceo has an API that [lists all the available breeds](https://dog.ceo/dog-api/documentation/). Getting the list of dog breeds is just like fetching a dog image: we’ll also use the fetch() method, await, and .json().\n\n\\`\\`\\`js\nbreeds = (await fetch(\\`https://dog.ceo/api/breeds/list/all\\`)).json()\n\\`\\`\\`\n\nThis is a good time to check out Observable’s built-in Inspector. Whenever you see some data with a ${caret}, you can click on it and explore its items.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":98,"value":"video(\"tutorial-2/3\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":47,"value":"step4 = md`---\n\n## Step 4: Import from another notebook\n\nJust like the slider we added in the last tutorial, we’ll be adding an input and using viewof to get its value. We could build the select box from scratch, but there’s already a notebook that has lots of input types ready to go: Jeremy’s [Inputs notebook](https://beta.observablehq.com/@jashkenas/inputs).\n\nSo let’s import the 'select' input type from that notebook and use it to show dog breeds.\n\n\\`\\`\\`js\nimport {select} from \"@jashkenas/inputs\"\n\\`\\`\\`\n\nThen, create a new cell and use this new select method, combined with the fetched breeds, to add a picker.\n\n\\`\\`\\`js\nviewof breed = select(Object.keys(breeds.message))\n\\`\\`\\`\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":106,"value":"video(\"tutorial-2/4\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":161,"value":"step5 = md`---\n\n## Step 5: Organize your notebook\n\nWe’ve been writing this notebook cell-by-cell, but to make it presentable, the most important cells should go at the top. So let’s reorder the cells, moving our new dog picker to the top. You can do this with the buttons on the right of the cell, or if you click on your user icon in the top-right and click ‘Help’, you can access a list of keyboard shortcuts that include moving cells around.\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":109,"value":"video(\"tutorial-2/5\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":73,"value":"step6 = md`---\n\n## Step 6: Customize the dogs\n\nNow, let’s add that user-selectable breed option into the dog image request cell. Find the dog cell, and update its code to use the [by breed](https://dog.ceo/dog-api/documentation/breed) endpoint.\n\n\\`\\`\\`js\ndog = (await fetch(\\`https://dog.ceo/api/breed/$\\{breed}/images/random\\`)).json()\n\\`\\`\\`\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":170,"value":"video(\"tutorial-2/6\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":120,"value":"md`---\n\n## Review\n\n- Using import, you can grab cells from other notebooks to reuse in your own\n- Observable is made to work well with asynchronous code, like the Promises returned by fetch(). You can use await with those Promises to perform multiple asynchronous steps in the same cell.\n- We can use viewof with many different types of inputs to make notebooks interactive, like we did in this one using viewof with a list of types of dogs.\n- You can click on ${caret} output data in Observable to view its details.\n\n## Further reading\n\n- [Introduction to Promises](https://beta.observablehq.com/@mbostock/introduction-to-promises)\n- [Introduction to Imports](https://beta.observablehq.com/@mbostock/introduction-to-imports)\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":55,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs"},{"id":38,"value":"import {key, caret, video, signinNote, seriesNavigation} from \"@tmcw/tutorial-utilities\"","pinned":false,"hidden":false,"mode":"ojs"}],"files":"$W31","stdlib":"1","titling":"auto"}