https://github.com/dathere/100.dathere.com
🧩 (WIP) The book "100 exercises with qsv". For new qsv users to read lessons and try out exercises either in-browser or locally in their terminal. Built with Jupyter Book.
https://github.com/dathere/100.dathere.com
bash binder cli csv data-engineering data-wrangling jupyter-book mybinder python qsv spreadsheet thebe
Last synced: 25 days ago
JSON representation
🧩 (WIP) The book "100 exercises with qsv". For new qsv users to read lessons and try out exercises either in-browser or locally in their terminal. Built with Jupyter Book.
- Host: GitHub
- URL: https://github.com/dathere/100.dathere.com
- Owner: dathere
- Created: 2024-05-29T12:59:41.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-13T20:20:59.000Z (26 days ago)
- Last Synced: 2025-04-13T21:26:57.926Z (26 days ago)
- Topics: bash, binder, cli, csv, data-engineering, data-wrangling, jupyter-book, mybinder, python, qsv, spreadsheet, thebe
- Language: Jupyter Notebook
- Homepage: https://100.dathere.com
- Size: 621 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 100.dathere.com
[](https://100.dathere.com)
**Try out available exercises:** [100.dathere.com](https://100.dathere.com)
This codebase includes source code for "100 exercises with qsv" found at [100.dathere.com](https://100.dathere.com).
## How to run the Jupyter Book locally
Ensure you are using one of the following OS/software:
- Windows Subsystem for Linux 2 (not Windows) running Ubuntu
- macOS
- Linux
0. Install the prerequisites:
- [Git](https://git-scm.com/)
- [Visual Studio Code](https://code.visualstudio.com/) - Code editor
- [Live Server extension](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer) - Local server extension (to view Jupyter Book locally and hot reload)
- [Run on Save extension](https://marketplace.visualstudio.com/items?itemName=emeraldwalk.RunOnSave) - Allows for auto-build on save for the file types specified in [../.vscode/settings.json](../.vscode/settings.json)
- [Python](https://python.org/)
- [uv](https://github.com/astral-sh/uv) - Python package manager
1. Clone the repository to your local device using [Git](https://git-scm.com/):
```bash
git clone https://github.com/dathere/100.dathere.com.git
```
3. Change your directory into this folder `book`.
4. Run `uv venv`, this should generate a `.venv` folder.
5.
- On macOS and Linux
- Run `source .venv/bin/activate`
- On Windows
- Run `.venv\Scripts\activate`
6. Run `uv pip install -r requirements-local.txt`.
7. Run `uv pip install -e ./bash_kernel` and then `python -m bash_kernel.install` to install the Bash kernel.
8. You may need to add qsv to your `PATH` first. Then, run `jb build .` to build the book or save a `.md`, `.ipynb`, or `.yml` file in VS Code for the Run on Save extension to run relevant commands.
9. Serve the build locally. For example using VS Code, click on `_build/html/index.html` and click Open with Live Server which should launch a local build of the website and should reload within a few seconds each time you save a `.md` or `.yml` file in VS Code (you may need to refresh the page once Run on Save is done each time). You may need to navigate to the proper URL such as http://localhost:5500/\_build/html/.
## Notice
datHere and the maintainers of this repository are the current organizers of the book's content, and therefore may or may not merge pull requests and/or resolve issues/discussions at their discretion. If you need further assistance, please reach out at [dathere.com/contact](https://dathere.com/contact).
---
© Copyright [datHere](https://dathere.com)
