Initial commit

Author: yakhyo

.github/workflows/pages.yml

@@ -0,0 +1,44 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Build site
+        run: bundle exec jekyll build
+        env:
+          JEKYLL_ENV: production
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,30 @@
+# IDEs
+.idea/
+.vscode/
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.egg-info/
+dist/
+build/
+
+# Type-checking / linting caches
+.mypy_cache/
+.ruff_cache/
+
+# Environment
+.env
+.venv/
+venv/
+
+# Jekyll
+_site/
+.jekyll-cache/
+.jekyll-metadata
+Gemfile.lock
+
+# OS
+.DS_Store
+Thumbs.db

Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+gem "jekyll", "~> 4.3"
+gem "just-the-docs", "~> 0.10"
+
+group :jekyll_plugins do
+  gem "jekyll-seo-tag"
+end

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Yakhyokhuja Valikhujaev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,52 @@
+# SOLID Principles in Python
+
+<p align="center">
+  <img src="assets/banner.png" alt="SOLID Principles in Python" />
+</p>
+
+<p align="center">
+  <b>Learn SOLID design principles through Python examples — violation vs correct, with UML diagrams.</b>
+</p>
+
+<p align="center">
+  <a href="https://yakhyo.github.io/solid-python/">Documentation</a> · <a href="https://yakhyo.github.io/solid-python/uz/">O'zbekcha</a>
+</p>
+
+## Quick start
+
+```bash
+python docs/01-srp/violation.py
+python docs/01-srp/correct.py
+```
+
+Requires **Python 3.10+**, no external dependencies.
+
+## Docs site locally
+
+```bash
+bundle install
+bundle exec jekyll serve --livereload
+```
+
+Then open `http://localhost:4000/solid-python/`
+
+## Structure
+
+```text
+docs/
+├── 01-srp/              # Single Responsibility
+├── 02-ocp/              # Open/Closed
+├── 03-lsp/              # Liskov Substitution
+├── 04-isp/              # Interface Segregation
+├── 05-dip/              # Dependency Inversion
+│   ├── violation.py     # What goes wrong
+│   ├── correct.py       # How to fix it
+│   ├── README.md        # English docs
+│   └── README.uz.md     # Uzbek docs
+├── index.md             # Home (EN)
+└── index.uz.md          # Home (UZ)
+```
+
+## License
+
+MIT — [LICENSE](LICENSE)

_config.yml

@@ -0,0 +1,68 @@
+title: SOLID Principles in Python
+description: Learn the five SOLID design principles with Python examples — violation vs correct, with UML diagrams.
+
+theme: just-the-docs
+
+url: "https://yakhyo.github.io"
+baseurl: "/solid-python"
+
+repo_url: "https://github.com/yakhyo/solid-python"
+
+author:
+  name: Yakhyokhuja Valikhujaev
+  email: "yakhyo9696@gmail.com"
+
+aux_links:
+  "GitHub":
+    - "https://github.com/yakhyo/solid-python"
+
+aux_links_new_tab: true
+
+nav_sort: case_insensitive
+
+heading_anchors: true
+
+back_to_top: true
+back_to_top_text: "Back to top"
+
+enable_copy_code_button: true
+
+gh_edit_link: true
+gh_edit_link_text: "Edit this page on GitHub"
+gh_edit_repository: "https://github.com/yakhyo/solid-python"
+gh_edit_branch: "main"
+gh_edit_source: ""
+gh_edit_view_mode: "edit"
+
+plugins:
+  - jekyll-seo-tag
+
+footer_content: >-
+  © 2025 Yakhyokhuja Valikhujaev.
+  Distributed under the <a href="https://github.com/yakhyo/solid-python/blob/main/LICENSE">MIT License</a>.
+
+sass:
+  quiet_deps: true
+  silence_deprecations:
+    - import
+    - global-builtin
+    - color-functions
+
+exclude:
+  - "*.py"
+  - "__pycache__"
+  - Gemfile.lock
+  - README.md
+  - LICENSE
+  - .github
+
+callouts:
+  warning:
+    title: Warning
+    color: red
+  note:
+    title: Note
+    color: blue
+  tip:
+    title: Tip
+    color: green

_includes/head_custom.html

@@ -0,0 +1,54 @@
+<style>
+  .theme-toggle {
+    position: fixed;
+    bottom: 1.5rem;
+    right: 1.5rem;
+    z-index: 999;
+    background: var(--body-background-color);
+    border: 1px solid var(--border-color);
+    border-radius: 50%;
+    width: 2.5rem;
+    height: 2.5rem;
+    cursor: pointer;
+    font-size: 1.2rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
+    transition: transform 0.2s ease;
+  }
+  .theme-toggle:hover {
+    transform: scale(1.1);
+  }
+</style>
+
+<button class="theme-toggle" id="theme-toggle" aria-label="Toggle dark mode"></button>
+
+<script>
+(function () {
+  var btn = document.getElementById("theme-toggle");
+  var prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches;
+  var current = localStorage.getItem("theme") || (prefersDark ? "dark" : "light");
+
+  function apply(theme) {
+    jtd.setTheme(theme);
+    btn.innerHTML = theme === "dark"
+      ? '<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg>'
+      : '<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>';
+    localStorage.setItem("theme", theme);
+  }
+
+  apply(current);
+
+  btn.addEventListener("click", function () {
+    var next = localStorage.getItem("theme") === "dark" ? "light" : "dark";
+    apply(next);
+  });
+
+  window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change", function (e) {
+    if (!localStorage.getItem("theme")) {
+      apply(e.matches ? "dark" : "light");
+    }
+  });
+})();
+</script>