👋  Welcome to the `scikit-plots` Dev Environment (Docker / Codespaces)

🧭  Quick Navigation:
• 🔎  Open the Command Palette → `Ctrl+Shift+P` / `Cmd+Shift+P` or `F1`
• 📘  Quick Start → https://scikit-plots.github.io/dev/introduction/quick_start.html
• 🛠️  Dev Guide → https://scikit-plots.github.io/dev/devel/index.html

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⭐ 🌟  IMPORTANT: Complete Environment Setup
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅  Check Installation:
  $ scikitplot -V
  $ python -c "import scikitplot; scikitplot.show_config()"

✅  Post-Create Setup (Recommended):
  $ bash docker/scripts/all_post_create.sh

✅  Safe Git Configs:
  $ git config --global --add safe.directory '*'
  $ git submodule update --init
  $ git submodule update --init --recursive
  $ git remote add upstream https://github.com/scikit-plots/scikit-plots.git
  $ git fetch upstream --tags

✅  Create Environment (Micromamba/Conda):
  $ mamba create -n py311 python=3.11 ipykernel -y
  $ conda create -n py311 python=3.11 ipykernel -y
  $ conda activate py311

✅  Install Dependencies:
  $ pip install -r requirements/all.txt
  $ pre-commit install
  $ pip install --no-build-isolation --no-cache-dir -e .

✅  (Optional) Install CPU-specific packages:
  $ pip install -r requirements/cpu.txt

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦  Environment Management Notes:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Activate environments (depending on tool):
  $ conda activate py311
  $ micromamba activate py311

• See environments:
  $ conda info -e
  $ micromamba info -e

• Initialize Conda shell support (if needed):
  $ conda init

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡  Troubleshooting:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• 💽  Disk Space:
  $ df -h && du -h --max-depth=1

• 💾  Creation logs (Codespaces):
  ⚠️ 👇 Check Codespace Container creation raise `ERROR: ... : No space left on device`
  $ cat /workspaces/.codespaces/.persistedshare/creation.log

• 📦 warning: Clock skew detected. Your build may be incomplete (⏻ Restart Computer or try 1 days later):
  $ make clean && find . -exec touch {} + && python -m pip install --no-build-isolation --no-cache-dir -e . -v
  $ python -m pip install --no-build-isolation --no-cache-dir -e . -v

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✍  Starting Development
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌿  Create a new branch before working:
  $ git checkout -b feature/my-new-feature

✍  Proceed to create a branch if you have uncommitted changes and are beginning work on a new feature or bug fix.
🔄  Read more: https://scikit-plots.github.io/dev/devel/quickstart_contributing.html#creating-a-branch
