rzmk/100.dathere.com
1
0
Fork 0
mirror of https://github.com/dathere/100.dathere.com.git synced 2025-12-19 08:39:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

feat: lesson/exercise 1

Browse source
This commit is contained in:
rzmk 2024-06-14 08:56:28 -04:00
parent 16aa46caac
commit bc86829515
4 changed files with 347 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

124
lessons/1/exercise.ipynb Normal file
View file

@ -0,0 +1,124 @@
{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Exercise 1: Viewing file content with tables\n",
"\n",
"Using `qsv table` and its options, complete the following tasks on the `fruits.csv` file."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"qsv table --help"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"1. Print `fruits.csv` as a table with right-aligned column entries."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"vscode": {
"languageId": "plaintext"
}
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"2. Print `fruits_extended.csv` as a table."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"vscode": {
"languageId": "plaintext"
}
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"3. Print `fruits_extended.csv` as a table with each column having a minimum width of `20`."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"vscode": {
"languageId": "plaintext"
}
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"4. Print `fruits_extended.csv` as a table with the minimum number of spaces between each column being `20`."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"vscode": {
"languageId": "plaintext"
}
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"5. Print `fruits_extended.csv` as a table with each column having a limited length of `5`."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"vscode": {
"languageId": "plaintext"
}
},
"outputs": [],
"source": []
}
],
"metadata": {
"kernelspec": {
"display_name": "Bash",
"language": "bash",
"name": "bash"
},
"language_info": {
"name": "bash"
}
},
"nbformat": 4,
"nbformat_minor": 2
}

4
lessons/1/fruits.csv Normal file
View file

@ -0,0 +1,4 @@
fruit,price
apple,2.50
banana,3.00
strawberry,1.50
1 fruit price
2 apple 2.50
3 banana 3.00
4 strawberry 1.50

10
lessons/1/fruits_extended.csv Normal file
View file

@ -0,0 +1,10 @@
fruit,price,size,availability
apple,2.50,medium,available
banana,3.00,medium,available
strawberry,1.50,small,available
orange,2.00,medium,out of stock
pineapple,3.50,large,available
grape,4.00,small,out of stock
mango,1.80,medium,available
watermelon,6.00,large,available
pear,2.20,medium,out of stock
1 fruit price size availability
2 apple 2.50 medium available
3 banana 3.00 medium available
4 strawberry 1.50 small available
5 orange 2.00 medium out of stock
6 pineapple 3.50 large available
7 grape 4.00 small out of stock
8 mango 1.80 medium available
9 watermelon 6.00 large available
10 pear 2.20 medium out of stock

209
lessons/1/notes.md Normal file
View file

@ -0,0 +1,209 @@
---
jupytext:
text_representation:
extension: .md
format_name: myst
kernelspec:
display_name: Bash
language: bash
name: bash
---
# Lesson 1: Displaying file content with `qsv table`
We have yet to see what data is in our `fruits.csv` file. Let's find out!
## Viewing raw file content in the terminal
If you're familiar with the Bash terminal on Linux or macOS, you may already know some ways to view raw file contents such as with the `cat` command. For example you may run:
```{code-cell}
cat fruits.csv
```
On Windows command prompt (cmd.exe) and Powershell you may use the `type` command instead. Git Bash and Powershell also have the `cat` command.
Alternatively with qsv you may run:
```{code-cell}
qsv select 1- fruits.csv
```
You may learn more about the `select` command in a later lesson.
:::{admonition} Other ways to view raw file content in the terminal (optional)
:class: dropdown hint
Some other ways you may view raw file content for `fruits.csv` include running:
- `qsv cat rows fruits.csv`
- `qsv slice fruits.csv`
- `qsv fmt fruits.csv`
- If you have the `qsv sqlp` command available, you may run `qsv sqlp fruits.csv 'SELECT * FROM fruits'`. This may also print the shape of the file content `(3, 2)` representing 3 rows and 2 columns.
These should all give the same output as `qsv select 1- fruits.csv`. However the output may differ if you modify the commands (e.g., add other options).
:::
## Increasing readability with `qsv table`
If you look carefully you'll notice there are various kinds of fruits and their prices as we've discovered in the previous lesson using `qsv headers`. However, you may want to view the data in a "prettier" format. `qsv table` may assist with this problem by showing aligned output.
```{code-cell}
:tags: ["scroll-output"]
qsv table --help
```
For example, you may run the following command:
```{code-cell}
qsv table fruits.csv
```
Here we see the content of `fruits.csv` as a table with aligned columns.
## Recap
In this lesson we've covered how to:
- View raw file content with `cat <filepath>` (`type <filepath>` on Windows command prompt), or `qsv select 1- <filepath>`
- View CSV file content in a table format with `qsv table <filepath>`
Now it's your turn to explore some of the various options `qsv table` has to offer in Exercise 1.
## Exercise 1: Viewing file content with tables
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/dathere/100.dathere.com/main?labpath=lessons%2F1%2Fexercise.ipynb)
Using `qsv table` and its options, complete each of the following tasks on the `fruits.csv` and `fruits_extended.csv` files:
1. Print `fruits.csv` as a table with right-aligned column entries.
2. Print `fruits_extended.csv` as a table.
3. Print `fruits_extended.csv` as a table with each column having a minimum width of `20`.
4. Print `fruits_extended.csv` as a table with the minimum number of spaces between each column being `20`.
5. Print `fruits_extended.csv` as a table with each column having a limited length of `5`.
> Here we show the usage text of `qsv table` for your reference. Solve this exercise using [Thebe](exercises-setup:thebe), [Binder](exercises-setup:binder) or [locally](exercises-setup:local).
```{code-cell}
:tags: ["scroll-output"]
qsv table --help
```
::::{admonition} Solution for task 1
:class: dropdown seealso
The `--align` (or `-a`) option may be used to set how entries should be aligned in a column by also passing an argument `<arg>` of either `left`, `center`, or `right`. By default the entries are left-aligned.
To right-align all column entries, run:
```bash
qsv table fruits.csv --align right
```
```console
fruit price
apple 2.50
banana 3.00
strawberry 1.50
```
::::
::::{admonition} Solution for task 2
:class: dropdown seealso
This task is straightforward to complete and primarily for you to view the newly introduced file `fruits_extended.csv`. Run:
```bash
qsv table fruits_extended.csv
```
```console
fruit price size availability
apple 2.50 medium available
banana 3.00 medium available
strawberry 1.50 small available
orange 2.00 medium out of stock
pineapple 3.50 large available
grape 4.00 small out of stock
mango 1.80 medium available
watermelon 6.00 large available
pear 2.20 medium out of stock
```
::::
::::{admonition} Solution for task 3
:class: dropdown seealso
The `--width` (or `-w`) option may be used to specify the minimum width of each column. By default the width is set to `2`. Run:
```bash
qsv table fruits_extended.csv --width 20
```
```console
fruit price size availability
apple 2.50 medium available
banana 3.00 medium available
strawberry 1.50 small available
orange 2.00 medium out of stock
pineapple 3.50 large available
grape 4.00 small out of stock
mango 1.80 medium available
watermelon 6.00 large available
pear 2.20 medium out of stock
```
::::
::::{admonition} Solution for task 4
:class: dropdown seealso
The `--pad` (or `-p`) option may be used to specify the number of spaces between each column. By default `--pad` is set to `2`. Run:
```bash
qsv table fruits_extended.csv --pad 20
```
```console
fruit price size availability
apple 2.50 medium available
banana 3.00 medium available
strawberry 1.50 small available
orange 2.00 medium out of stock
pineapple 3.50 large available
grape 4.00 small out of stock
mango 1.80 medium available
watermelon 6.00 large available
pear 2.20 medium out of stock
```
Completing the previous task 3 and this task 4 may help you understand the visual difference between using `--width` and `--pad`. Recall you may also use multiple options such as `--width` and `--pad` together.
::::
::::{admonition} Solution for task 5
:class: dropdown seealso
The `--condense` (or `-c`) option may be used to limit the length of each column (see `qsv table --help` for more details on how this works). Run:
```bash
qsv table fruits_extended.csv --condense 5
```
```console
fruit price size avail...
apple 2.50 mediu... avail...
banan... 3.00 mediu... avail...
straw... 1.50 small avail...
orang... 2.00 mediu... out o...
pinea... 3.50 large avail...
grape 4.00 small out o...
mango 1.80 mediu... avail...
water... 6.00 large avail...
pear 2.20 mediu... out o...
```
::::