-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
4 changed files
with
347 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
fruit,price | ||
apple,2.50 | ||
banana,3.00 | ||
strawberry,1.50 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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... | ||
``` | ||
|
||
:::: |