Git & GitHub: Version Control untuk Developer IoT

# Di Ubuntu / Debian
sudo apt update && sudo apt install git -y

# Di Fedora / CentOS
sudo dnf install git -y

# Di macOS (via Homebrew)
brew install git

# Di Windows — download installer dari https://git-scm.com
# Atau via winget:
winget install Git.Git

# Verifikasi instalasi
git --version
# Output: git version 2.45.0

# Konfigurasi nama dan email (global — berlaku untuk semua repo)
git config --global user.name "Nama Anda"
git config --global user.email "email@anda.com"

# Set default branch name ke 'main'
git config --global init.defaultBranch main

# Set editor default (opsional)
git config --global core.editor "code --wait"   # VS Code
# git config --global core.editor "nano"         # Nano

# Lihat semua konfigurasi
git config --list

# Buat folder proyek baru
mkdir iot-smart-home && cd iot-smart-home

# Inisialisasi repositori Git
git init
# Output: Initialized empty Git repository in /home/user/iot-smart-home/.git/

# Cek status
git status
# Output: On branch main
#         No commits yet
#         nothing to commit (create files and use "git add" to track)

# Buat file pertama
echo "# IoT Smart Home" > README.md

# Lihat folder .git yang tersembunyi
ls -la .git/
# HEAD, config, description, hooks/, info/, objects/, refs/

# Clone repositori dari GitHub (HTTPS)
git clone https://github.com/Beebane25/iot-smart-home.git

# Masuk ke folder hasil clone
cd iot-smart-home

# Clone ke folder dengan nama berbeda
git clone https://github.com/Beebane25/iot-smart-home.git my-project

# Clone dengan SSH (lebih aman, butuh SSH key)
git clone git@github.com:Beebane25/iot-smart-home.git

# Clone branch tertentu saja
git clone -b develop https://github.com/Beebane25/iot-smart-home.git

# Clone dengan kedalaman terbatas (hemat bandwidth, tanpa full history)
git clone --depth 1 https://github.com/Beebane25/iot-smart-home.git

# Cek status — lihat file apa saja yang berubah
git status

# Tambahkan satu file ke staging
git add main.py

# Tambahkan beberapa file sekaligus
git add sensor.py config.py

# Tambahkan semua file di direktori saat ini
git add .

# Tambahkan semua file .py saja
git add *.py

# Batalkan staging (unstage) tanpa mengubah isi file
git reset HEAD main.py

# Tambahkan hanya sebagian perubahan dalam satu file (interactive)
git add -p main.py
# Git akan menampilkan setiap chunk perubahan, Anda pilih y/n

# Commit dengan pesan
git commit -m "feat: tambah pembacaan sensor DHT22"

# Commit semua file yang sudah ter-track (sudah pernah di-add)
git commit -am "fix: perbaiki format data suhu"

# Catatan: -am TIDAK berlaku untuk file baru yang belum pernah di-add

# Commit dengan pesan panjang (buka editor)
git commit

# Amend — ubah commit terakhir (pesan atau isi)
git commit --amend -m "feat: tambah pembacaan sensor DHT22 + BME280"

# Lihat log commit
git log

# Log ringkas satu baris per commit
git log --oneline
# a3f7b2c feat: tambah pembacaan sensor DHT22
# 1e4d8a9 fix: perbaiki format data suhu
# c0ffee1 docs: update README

# Log dengan graf branch
git log --oneline --graph --all

# Lihat perubahan di commit tertentu
git show a3f7b2c

# Lihat perubahan yang belum di-commit
git diff

# Lihat perubahan yang sudah di-staging tapi belum di-commit
git diff --staged

# Lihat semua branch lokal
git branch
# * main  (tanda * = branch aktif)

# Buat branch baru
git branch feature/suhu-dht22

# Pindah ke branch baru
git checkout feature/suhu-dht22

# Shortcut: buat + pindah sekaligus
git checkout -b feature/suhu-dht22

# Git modern (2.23+): gunakan 'git switch'
git switch -c feature/suhu-dht22   # buat baru + pindah
git switch main                     # kembali ke main

# Lihat semua branch (termasuk remote)
git branch -a
# * main
#   feature/suhu-dht22
#   remotes/origin/main
#   remotes/origin/develop

# Rename branch
git branch -m feature/suhu-dht22 feature/dht22-sensor

# Hapus branch lokal yang sudah selesai
git branch -d feature/dht22-sensor

# 1. Pastikan di branch tujuan
git switch main

# 2. Gabungkan branch feature ke main
git merge feature/suhu-dht22
# Output: Merge made by the 'ort' strategy.

# 3. Jika ada konflik, Git akan berhenti dan minta resolusi manual:
# Auto-merging main.py
# CONFLICT (content): Merge conflict in main.py
# Automatic merge failed; fix conflicts and then commit the result.

# <<<<<<< HEAD (kode dari branch saat ini)
BROKER_HOST = "192.168.1.100"
BROKER_PORT = 1883
# ======== (pemisah)
BROKER_HOST = "mqtt.beebanlabs.id"
BROKER_PORT = 8883
# >>>>>>> feature/suhu-dht22 (kode dari branch yang di-merge)

# 1. Edit file, hapus marker konflik (<<<, ===, >>>)
#    Pilih kode yang benar atau gabungkan keduanya

# 2. Setelah selesai edit, tambahkan ke staging
git add main.py

# 3. Commit hasil merge
git commit -m "merge: gabung feature/suhu-dht22, selesaikan konflik broker"

# Alternatif: batalkan merge jika terlalu rumit
git merge --abort

# Lihat remote yang sudah terhubung
git remote -v

# Tambahkan remote baru (setelah buat repo di GitHub)
git remote add origin https://github.com/username/iot-smart-home.git

# Ganti URL remote (misal dari HTTPS ke SSH)
git remote set-url origin git@github.com:username/iot-smart-home.git

# Hapus remote
git remote remove origin

# Push pertama kali (set upstream ke origin/main)
git push -u origin main

# Push selanjutnya (upstream sudah terset)
git push

# Push branch baru ke remote
git push origin feature/suhu-dht22

# Force push (hati-hati — menimpa riwayat remote!)
git push --force origin main

# Hapus branch di remote
git push origin --delete feature/suhu-dht22

# Pull = fetch + merge — ambil perubahan terbaru dan gabungkan
git pull

# Pull dari branch tertentu
git pull origin develop

# Fetch saja (lihat perubahan tanpa merge)
git fetch
git log origin/main --oneline

# Pull dengan rebase (riwayat lebih rapi)
git pull --rebase origin main

# 1. Buat branch baru dari main
git checkout -b feature/relay-control

# 2. Lakukan perubahan dan commit
git add relay.py
git commit -m "feat: tambah kontrol relay via MQTT"

git add tests/test_relay.py
git commit -m "test: unit test untuk relay control"

# 3. Push branch ke GitHub
git push -u origin feature/relay-control

# 4. Buka GitHub → akan muncul tombol "Compare & pull request"
#    Klik tombol tersebut, isi deskripsi PR, lalu buat PR

# Alternatif: buat PR via GitHub CLI (jika sudah instal gh)
gh pr create --title "feat: kontrol relay via MQTT" \
  --body "Menambahkan modul kontrol relay dengan command on/off via MQTT topic home/actuator/relay"

# Buat file .gitignore di root repositori
touch .gitignore

# ========== PYTHON ==========
__pycache__/
*.py[cod]
*.pyo
*.egg-info/
dist/
build/
*.egg
.eggs/

# ========== VIRTUAL ENVIRONMENT ==========
venv/
.venv/
env/
ENV/

# ========== ENVIRONMENT & SECRETS ==========
.env
.env.local
.env.production
*.pem
*.key
secrets.json
credentials.json

# ========== IDE & EDITOR ==========
.vscode/
.idea/
*.swp
*.swo
*~
.DS_Store
Thumbs.db

# ========== LOGS & DATA ==========
*.log
logs/
data/*.csv
data/*.db

# ========== HARDWARE/EMBEDDED ==========
*.bin
*.hex
*.elf
build_output/
.pio/
.platformio/

# 1. Fork repositori di GitHub (klik tombol "Fork")

# 2. Clone fork Anda
git clone https://github.com/username/iot-smart-home.git
cd iot-smart-home

# 3. Tambahkan repositori asli sebagai "upstream"
git remote add upstream https://github.com/original-owner/iot-smart-home.git

# 4. Buat branch untuk kontribusi
git checkout -b fix/typo-readme

# 5. Lakukan perubahan & commit
git add README.md
git commit -m "docs: perbaiki typo di README"

# 6. Push ke fork Anda
git push origin fix/typo-readme

# 7. Buka GitHub → buat Pull Request dari fork ke repositori asli

# 8. Untuk tetap up-to-date dengan repositori asli:
git fetch upstream
git merge upstream/main

# Buat issue baru via GitHub CLI
gh issue create --title "feat: support sensor BME680" \
  --body "Tambahkan pembacaan data dari sensor BME680 via I2C"

# Lihat daftar issue
gh issue list

# Tutup issue dari commit
git commit -m "feat: tambah support BME680

Closes #15"

name: Run Tests

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
          pip install pytest

      - name: Run tests
        run: pytest tests/ -v

# 1. Generate SSH key
ssh-keygen -t ed25519 -C "email@anda.com"
# Tekan Enter untuk semua prompt (gunakan default)

# 2. Tambahkan key ke SSH agent
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# 3. Copy public key
cat ~/.ssh/id_ed25519.pub
# Salin output-nya

# 4. Buka GitHub → Settings → SSH and GPG keys → New SSH key
#    Paste public key di sana

# 5. Test koneksi
ssh -T git@github.com
# Hi username! You've successfully authenticated...