# sanskargubreley/designpatterns architecture

> Architecture diagram of the GitHub repository sanskargubreley/designpatterns, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanskargubreley/designpatterns
- Repository: https://github.com/sanskargubreley/designpatterns

## Overview

This repository is a collection of small design-pattern demonstrations, not one integrated application. Its examples cover composite file-system traversal, decorator and factory patterns, null-object vehicle selection, stock-observer notifications, strategy selection, and chained log processing. The README gives no workflow details, and several examples are represented only by their filenames or source-index references; those components are included, but unsupported connections are omitted. The shown edges follow only relationships visible in the excerpts.

Main entry points: [`CompositeDesignPattern/Directory.py`](https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/Directory.py) (Directory), [`CompositeDesignPattern/Main.py`](https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/Main.py) (File-system Demo), [`chainOfResponsibility/Main.py`](https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/Main.py) (Logging Demo), [`NullObjectDesignPattern/VehicleFactory.py`](https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/VehicleFactory.py) (Vehicle Factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_composite["Composite Pattern"]
  node_composite_demo["File-system Demo<br/>[Main.py]"]
  node_directory["Directory<br/>[Directory.py]"]
  node_file["File<br/>[File.py]"]
  node_filesystem["File-system Base<br/>[FileSystem.py]"]
end

subgraph group_decorator_factory["Decorator and Factory"]
  node_decorator_demo["Decorator Demo<br/>[DecoratorP.py]"]
  node_factory_demo["Factory Demo<br/>[main.py]"]
end

subgraph group_null_object["Null Object Pattern"]
  node_vehicle_demo["Vehicle Demo<br/>[Main.py]"]
  node_vehicle_factory["Vehicle Factory<br/>[VehicleFactory.py]"]
  node_vehicle["Vehicle Contract<br/>[Vehicle.py]"]
  node_car["Car<br/>[Car.py]"]
  node_null_vehicle["Null Vehicle<br/>[NullVehicle.py]"]
end

subgraph group_observer["Observer Pattern"]
  node_stock_contract["Stock Observable"]
  node_iphone_observable["iPhone Stock Observable"]
  node_observer_contract["Alert Observer"]
  node_email_observer["Email Alert"]
  node_mobile_observer["Mobile Alert"]
end

subgraph group_strategy["Strategy Pattern"]
  node_strategy_demo["Strategy Demo<br/>[main.py]"]
end

subgraph group_chain["Logging Chain"]
  node_logging_demo["Logging Demo<br/>[Main.py]"]
  node_log_processor["Log Processor<br/>[logProcessor.py]"]
  node_info_processor["Info Processor"]
  node_debug_processor["Debug Processor"]
  node_error_processor["Error Processor"]
end

node_composite_demo -->|"creates and adds"| node_directory
node_composite_demo -->|"creates and adds"| node_file
node_composite_demo -->|"calls listing"| node_directory
node_directory -->|"inherits contract"| node_filesystem
node_directory -->|"calls child listing"| node_filesystem
node_vehicle_demo -->|"uses factory"| node_vehicle_factory
node_vehicle_factory -->|"creates"| node_car
node_vehicle_factory -->|"creates fallback"| node_null_vehicle
node_iphone_observable -->|"implements"| node_stock_contract
node_iphone_observable -->|"notifies subscribers"| node_observer_contract
node_logging_demo -->|"constructs chain"| node_info_processor
node_logging_demo -->|"constructs chain"| node_debug_processor
node_logging_demo -->|"constructs chain"| node_error_processor
node_debug_processor -->|"delegates unmatched"| node_log_processor
node_error_processor -->|"delegates unmatched"| node_log_processor

click node_composite_demo "https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/Main.py"
click node_directory "https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/Directory.py"
click node_file "https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/File.py"
click node_filesystem "https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/FileSystem.py"
click node_decorator_demo "https://github.com/sanskargubreley/designpatterns/blob/master/DecoraterPattern/DecoratorP.py"
click node_factory_demo "https://github.com/sanskargubreley/designpatterns/blob/master/FactoryPattern/main.py"
click node_vehicle_demo "https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/Main.py"
click node_vehicle_factory "https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/VehicleFactory.py"
click node_vehicle "https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/Vehicle.py"
click node_car "https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/Car.py"
click node_null_vehicle "https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/NullVehicle.py"
click node_stock_contract "https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observable/StocksObservable.java"
click node_iphone_observable "https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observable/iphoneObservable.java"
click node_observer_contract "https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observer/NotificationAlertObserver.java"
click node_email_observer "https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observer/EmailAlertObserver.java"
click node_mobile_observer "https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observer/MobileAlertObserver.java"
click node_strategy_demo "https://github.com/sanskargubreley/designpatterns/blob/master/StrategyPattern/main.py"
click node_logging_demo "https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/Main.py"
click node_log_processor "https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/logProcessor.py"
click node_info_processor "https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/infoLogProcessor.py"
click node_debug_processor "https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/debugLogProcessor.py"
click node_error_processor "https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/errorLogProcessor.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_composite_demo,node_directory,node_file,node_filesystem toneBlue
class node_decorator_demo,node_factory_demo toneAmber
class node_vehicle_demo,node_vehicle_factory,node_vehicle,node_car,node_null_vehicle toneMint
class node_stock_contract,node_iphone_observable,node_observer_contract,node_email_observer,node_mobile_observer toneRose
class node_strategy_demo toneIndigo
class node_logging_demo,node_log_processor,node_info_processor,node_debug_processor,node_error_processor toneTeal
```

## Components

### Composite Pattern

- [File-system Demo](https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/Main.py): `CompositeDesignPattern/Main.py`
- [Directory](https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/Directory.py): `CompositeDesignPattern/Directory.py`
- [File](https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/File.py): `CompositeDesignPattern/File.py`
- [File-system Base](https://github.com/sanskargubreley/designpatterns/blob/master/CompositeDesignPattern/FileSystem.py): `CompositeDesignPattern/FileSystem.py`

### Decorator and Factory

- [Decorator Demo](https://github.com/sanskargubreley/designpatterns/blob/master/DecoraterPattern/DecoratorP.py): `DecoraterPattern/DecoratorP.py`
- [Factory Demo](https://github.com/sanskargubreley/designpatterns/blob/master/FactoryPattern/main.py): `FactoryPattern/main.py`

### Null Object Pattern

- [Vehicle Demo](https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/Main.py): `NullObjectDesignPattern/Main.py`
- [Vehicle Factory](https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/VehicleFactory.py): `NullObjectDesignPattern/VehicleFactory.py`
- [Vehicle Contract](https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/Vehicle.py): `NullObjectDesignPattern/Vehicle.py`
- [Car](https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/Car.py): `NullObjectDesignPattern/Car.py`
- [Null Vehicle](https://github.com/sanskargubreley/designpatterns/blob/master/NullObjectDesignPattern/NullVehicle.py): `NullObjectDesignPattern/NullVehicle.py`

### Observer Pattern

- [Stock Observable](https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observable/StocksObservable.java): `Observer pattern/Observable/StocksObservable.java`
- [iPhone Stock Observable](https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observable/iphoneObservable.java): `Observer pattern/Observable/iphoneObservable.java`
- [Alert Observer](https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observer/NotificationAlertObserver.java): `Observer pattern/Observer/NotificationAlertObserver.java`
- [Email Alert](https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observer/EmailAlertObserver.java): `Observer pattern/Observer/EmailAlertObserver.java`
- [Mobile Alert](https://github.com/sanskargubreley/designpatterns/blob/master/Observer%20pattern/Observer/MobileAlertObserver.java): `Observer pattern/Observer/MobileAlertObserver.java`

### Strategy Pattern

- [Strategy Demo](https://github.com/sanskargubreley/designpatterns/blob/master/StrategyPattern/main.py): `StrategyPattern/main.py`

### Logging Chain

- [Logging Demo](https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/Main.py): `chainOfResponsibility/Main.py`
- [Log Processor](https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/logProcessor.py): `chainOfResponsibility/logProcessor.py`
- [Info Processor](https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/infoLogProcessor.py): `chainOfResponsibility/infoLogProcessor.py`
- [Debug Processor](https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/debugLogProcessor.py): `chainOfResponsibility/debugLogProcessor.py`
- [Error Processor](https://github.com/sanskargubreley/designpatterns/blob/master/chainOfResponsibility/errorLogProcessor.py): `chainOfResponsibility/errorLogProcessor.py`

## Connections

- File-system Demo → Directory: creates and adds (evidence: `CompositeDesignPattern/Main.py`)
- File-system Demo → File: creates and adds (evidence: `CompositeDesignPattern/Main.py`)
- File-system Demo → Directory: calls listing (evidence: `CompositeDesignPattern/Main.py`)
- Directory → File-system Base: inherits contract (evidence: `CompositeDesignPattern/Directory.py`)
- Directory → File-system Base: calls child listing (evidence: `CompositeDesignPattern/Directory.py`)
- Vehicle Demo → Vehicle Factory: uses factory (evidence: `NullObjectDesignPattern/Main.py`)
- Vehicle Factory → Car: creates (evidence: `NullObjectDesignPattern/VehicleFactory.py`)
- Vehicle Factory → Null Vehicle: creates fallback (evidence: `NullObjectDesignPattern/VehicleFactory.py`)
- iPhone Stock Observable → Stock Observable: implements (evidence: `Observer pattern/Observable/iphoneObservable.java`)
- iPhone Stock Observable → Alert Observer: notifies subscribers (evidence: `Observer pattern/Observable/iphoneObservable.java`)
- Logging Demo → Info Processor: constructs chain (evidence: `chainOfResponsibility/Main.py`)
- Logging Demo → Debug Processor: constructs chain (evidence: `chainOfResponsibility/Main.py`)
- Logging Demo → Error Processor: constructs chain (evidence: `chainOfResponsibility/Main.py`)
- Debug Processor → Log Processor: delegates unmatched (evidence: `chainOfResponsibility/debugLogProcessor.py`)
- Error Processor → Log Processor: delegates unmatched (evidence: `chainOfResponsibility/errorLogProcessor.py`)
