# Python Tutorial {.unnumbered}

Welcome to the comprehensive Python programming tutorial by **Ameyanagi**. This tutorial covers Python from basics to advanced applications, with support for multiple languages and formats.

## 🚀 Tutorial Features

- **Multi-format Learning**: Books, slides, and interactive content

- **Bilingual Support**: English and Japanese versions

- **Comprehensive Coverage**: From Python basics to data science

- **Modern Development**: Using uv, VS Code, and best practices

- **Real-world Applications**: Practical projects and examples

::: {.callout-important}

## ⚡ Interactive Python Learning

**NEW!** All tutorials now feature **Quarto Live** - run and edit Python code directly in your browser without installing anything! Perfect for beginners and experienced developers alike.

**Features:**

- 🚀 **Zero Setup** - No Python installation required

- 🎮 **Live Code Editing** - Modify examples and see results instantly

- 📊 **Interactive Plots** - Create and customize data visualizations

- 📁 **Drag & Drop Files** - Upload CSV, Excel, JSON files for analysis

- 🌐 **Browser-Based** - Works on any device with a web browser

:::

## 📚 Available Formats

### 📖 Books (Comprehensive Guides)

<div class="grid">

<div class="g-col-12 g-col-md-6">

#### 🇺🇸 English Version

**Complete Python tutorial with 12 chapters covering:**

- Environment setup and Git integration

- Python syntax and data structures

- Functions and error handling

- Object-oriented programming

- Advanced topics (async, type hints)

- Real-world applications (data science, web development)

[**📖 Read English Book →**](en/book/index.html){.btn .btn-primary .btn-lg}

</div>

<div class="g-col-12 g-col-md-6">

#### 🇯🇵 Japanese Version (日本語版)

**Python完全ガイド - 16章で構成:**

- 環境設定とGit統合

- Python構文とデータ構造

- 関数とエラー処理

- オブジェクト指向プログラミング（クラス、継承）

- 高度なトピック（非同期、型ヒント、マルチプロセシング）

- 実世界のアプリケーション（データサイエンス、IoT接続）

> **注:** 日本語版は英語版のすべての内容を含む最新の完全版です。

[**📖 日本語版を読む →**](ja/book/index.html){.btn .btn-primary .btn-lg}

</div>

</div>

### 🎯 Slides (Interactive Presentations)

**Perfect for lectures, workshops, and quick learning sessions. Available in English and Japanese with mobile-optimized RevealJS:**

<div class="grid">

<div class="g-col-12 g-col-md-6">

#### 🇺🇸 English Slides

**Complete presentation series:**

[**🎯 View All English Slides →**](en/slides/index.html){.btn .btn-info .btn-lg}

**Core Topics:**

- [🚀 Introduction & Setup](en/slides/01-intro.html)

- [📊 Data Types & Collections](en/slides/02-data-types.html)

- [🔄 Control Flow](en/slides/03-control-flow.html)

- [⚙️ Functions](en/slides/04-functions.html)

- [🛡️ Error Handling](en/slides/05-error-handling.html)

**Code Organization:**

- [📦 Modules & Packages](en/slides/06-modules.html)

- [🏗️ Classes & Objects](en/slides/07-classes.html)

- [🔄 Inheritance & Polymorphism](en/slides/08-inheritance.html)

**Advanced Topics:**

- [🏷️ Type Hints](en/slides/09-type-hints.html)

- [📊 Data Science](en/slides/12-data-science.html)

- [🌐 IoT Connectivity](en/slides/14-iot-connectivity.html)

</div>

<div class="g-col-12 g-col-md-6">

#### 🇯🇵 Japanese Slides (日本語スライド)

**完全なプレゼンテーションシリーズ:**

[**🎯 日本語スライド一覧 →**](ja/slides/index.html){.btn .btn-info .btn-lg}

**基本トピック:**

- [🚀 導入とセットアップ](ja/slides/01-intro.html)

- [📊 データ型とコレクション](ja/slides/02-data-types.html)

- [🔄 制御フロー](ja/slides/03-control-flow.html)

- [⚙️ 関数](ja/slides/04-functions.html)

- [🛡️ エラーハンドリング](ja/slides/05-error-handling.html)

**コード整理:**

- [📦 モジュールとパッケージ](ja/slides/06-modules.html)

- [🏗️ クラスとオブジェクト](ja/slides/07-classes.html)

- [🔄 継承と多態性](ja/slides/08-inheritance.html)

**高度なトピック:**

- [🏷️ 型ヒント](ja/slides/09-type-hints.html)

- [📊 データサイエンス](ja/slides/12-data-science.html)

- [🌐 IoT接続](ja/slides/14-iot-connectivity.html)

</div>

</div>

#### 📱 Mobile-Optimized Slides

All slides are optimized for:

- **iPhone/Android** - Touch navigation, responsive scaling

- **Tablets** - Perfect presentation mode

- **Desktop** - Full-featured experience with keyboard shortcuts

- **Projectors** - High-resolution output for classrooms

## 🛠️ Development Environment

This tutorial teaches modern Python development using:

- **uv**: Modern Python package manager

- **VS Code**: Integrated development environment

- **ruff**: Fast Python linter and formatter

- **pyright**: Static type checker

- **Git**: Version control integration

- **Quarto**: Multi-format publishing

## 📋 Learning Path

### 👶 Beginners

1. Start with [Environment Setup](en/book/01-setup.html)

2. Learn [Git & GitHub](en/book/02-git-github.html)

3. Master [Python Syntax](en/book/03-syntax.html)

4. Practice with [Data Types](en/book/04-data-types.html)

### 🎓 Intermediate

1. Understand [Control Flow](en/book/05-control-flow.html)

2. Learn [Functions](en/book/06-functions.html)

3. Complete [Self-Review](en/book/self-review-1.html)

4. Explore [Object-Oriented Programming](en/book/07-classes.html)

### 🚀 Advanced

1. Master [Inheritance](en/book/08-inheritance.html)

2. Use [Type Hints](en/book/09-type-hints.html)

3. Learn [Async Programming](en/book/10-async.html)

4. Apply [Data Science](en/book/12-data-science.html)

## 🎯 Quick Start

### For Self-Study

- Choose your preferred language (English/Japanese)

- Follow the learning path sequentially

- Complete exercises in each chapter

- Build the capstone projects

### For Instructors

- Use slides for classroom presentations

- Assign book chapters for reading

- Leverage built-in exercises and self-review sections

- Adapt content for your curriculum

### For Developers

- Jump to specific topics you need

- Use as a reference guide

- Follow best practices demonstrated

- Integrate modern tooling into your workflow

## 💻 Code Examples

All code examples are:

- ✅ **Tested and verified**

- ✅ **Copy-paste ready**

- ✅ **Following best practices**

- ✅ **Progressively complex**

## 🤝 Contributing

This tutorial is open source and welcomes contributions:

- 🐛 Report issues

- 💡 Suggest improvements

- 🌍 Help with translations

- 📝 Add examples and exercises

[**Contribute on GitHub →**](https://github.com/ameyanagi/python-tutorial){.btn .btn-outline-primary}

## 📱 Responsive Design

This tutorial works perfectly on:

- 💻 Desktop computers

- 📱 Mobile devices

- 📓 Tablets

- 📊 Projectors (for slides)

## 🆕 Latest Updates

- ✨ **Comprehensive slide presentations** for interactive learning

- 🇯🇵 **Japanese translations** for key chapters

- 🔬 **Data science applications** with real-world examples

- ⚡ **Modern tooling integration** (uv, ruff, pyright)

- 🎯 **Type hints coverage** for robust code development

---

<div class="text-center">

<h3>Ready to start your Python journey?</h3>

<p class="lead">Choose your learning format and begin today!</p>

[**📖 Start with Books**](#-books-comprehensive-guides){.btn .btn-success .btn-lg .me-3}

[**🎯 View Slides**](#-slides-interactive-presentations){.btn .btn-info .btn-lg}

</div>

*Built with ❤️ by Ameyanagi using Quarto, Python, and modern development tools.*