Help Center

Course overview

Make the tool usable

Hand off the report you built with a clear way to check it.

This full-text reading copy does not save answers. Open the interactive lesson for saved browser notes.

Hand off the report you built

Start with the HTML report and the evidence you just reviewed.

Open $PRACTICE/activity-report.html. Your handoff will show the result, the input it came from and the check you performed in Decide whether to trust the report.

If you still need a report, return to Build your first report or use the optional checked example in the next section.

Gather the files for your handoff

Use the report and original sample CSV from your practice project.

Optional fresh start with the checked example

Download the checked example ZIP and extract it into a new folder. Open a terminal in the folder containing report.py and data/activity.csv. The example instructions list the Python requirements and runnable commands.

Show how to open or recreate the report

Give the recipient the report path first.

Use the course terminal and its COURSE_PYTHON from setup. If you reopened the terminal, first follow Come back tomorrow. For the optional checked example, open the extracted folder containing report.py and keep the course interpreter selected.

Ask the recipient to open the supplied HTML file in a browser. If they are running the checked ZIP from a new extraction, use the command below from the folder containing report.py. It writes activity-report.html beside the script.

Optional HTML command for the checked example

HTML report command

macOS/Linux — Bash or Zsh

"$COURSE_PYTHON" report.py data/activity.csv --format html --output activity-report.html

Windows PowerShell 5.1 or 7

& $COURSE_PYTHON report.py data/activity.csv --format html --output activity-report.html

Expect Saved report to activity-report.html. If that name is already in use, choose an unused name with --output, then open the new file.

Give the recipient one way to check it

Share an expected result the recipient can find in the HTML.

Use the course terminal and its COURSE_PYTHON from setup. If you reopened the terminal, first follow Come back tomorrow. For the optional checked example, open the extracted folder containing report.py and keep the course interpreter selected.

Ask the recipient to find six entries and 270 minutes, then show how the four Orion rows add up to 180 minutes. Cite the original CSV and the probe outcomes you inspected in lesson 4.

Optional text output for the checked example

From the checked example folder, print a text report with this command. Compare it with the expected text output.

baseline text command

macOS/Linux — Bash or Zsh

"$COURSE_PYTHON" report.py data/activity.csv

Windows PowerShell 5.1 or 7

& $COURSE_PYTHON report.py data/activity.csv

Try a separate input copy

Optional practice if you want to see how the report responds to a change.

Change one row and compare the result

In the course environment, use the PRACTICE path from lesson 2. Copy $PRACTICE/project/data/activity.csv to a new $PRACTICE/activity-practice.csv. In the copy, change Lumen’s Documentation entry from 30 to 45 minutes.

Predict the result before running the command: six entries, 285 minutes overall and 105 minutes for Lumen. Choose unused input-copy and output filenames, and update the command if you chose different names.

practice report command

macOS/Linux — Bash or Zsh

"$COURSE_PYTHON" "$PRACTICE/project/report.py" "$PRACTICE/activity-practice.csv" --format html --output "$PRACTICE/activity-practice.html"

Windows PowerShell 5.1 or 7

& $COURSE_PYTHON "$PRACTICE/project/report.py" "$PRACTICE/activity-practice.csv" --format html --output "$PRACTICE/activity-practice.html"

Open the new HTML file. Compare its actual numbers with your prediction.

Write a short handoff

Give the recipient a file to open, a result to look for and the evidence you used.

Example handoff

Open activity-report.html in your browser. Look for six entries and 270 minutes. Compare Orion’s 180 minutes with its four rows in the attached CSV. I checked that subtotal and inspected both saved reporting probes.

Use your own result and observed checks in the handoff. Include the checked example ZIP only if the recipient needs to recreate the report independently.

Your handoff note

Write your answer in your own notes, or use the interactive lesson.

This optional note stays in your browser profile and site.

Check that someone can use the handoff

Read your note as a recipient who has never seen the practice folder.

Check that you can find the report, locate one number and see what the original check covered. If a recipient needs to recreate the file, include the checked example instructions and explain how to choose a fresh output filename.

Next: Open Make it work for your needs to identify one improvement.

A previous activity-report.html already exists. What is the supported next action?

Keep it and use an unused --output filename, then open that same new file. Correct. The reporting tool creates a new file and refuses to overwrite an existing destination.

Run the same command again and expect it to replace the old report. The existing-file refusal is intentional. Select a new output path and preserve the previous result.