# suryadharshinivijay/bbcsport architecture

> Architecture diagram of the GitHub repository suryadharshinivijay/bbcsport, 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/suryadharshinivijay/bbcsport
- Repository: https://github.com/suryadharshinivijay/bbcsport

## Overview

This repository is a Behave/Selenium UI automation framework for BBC Sport navigation and article-comment checks. Its documented workflow runs Gherkin scenarios through step definitions and page objects, using shared Selenium actions and a scenario-scoped browser. The sampled code shows login data loading, navigation, comment-enabled/disabled article selection, and comment-section assertions. The README documents the overall layer sequence; edges between specific feature scenarios and steps are therefore documented at framework level, not verified from the unsampled feature file.

Main entry points: [`features/steps/navigation_steps.py`](https://github.com/suryadharshinivijay/bbcsport/blob/master/features/steps/navigation_steps.py) (Navigation Steps), [`pageObjects/basePage.py`](https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/basePage.py) (Shared Actions), [`features/sport_comment_validation.feature`](https://github.com/suryadharshinivijay/bbcsport/blob/master/features/sport_comment_validation.feature) (Comment Scenarios), [`features/steps/comment_steps.py`](https://github.com/suryadharshinivijay/bbcsport/blob/master/features/steps/comment_steps.py) (Comment Steps)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bdd["BDD Scenarios"]
  node_features["Comment Scenarios"]
  node_user_data["Login Data<br/>[User_details.json]"]
end

subgraph group_steps["Scenario Steps"]
  node_navigation_steps["Navigation Steps"]
  node_comment_steps["Comment Steps<br/>[comment_steps.py]"]
end

subgraph group_pages["Page Objects"]
  node_home_page["Home Page<br/>[bbcHomePage.py]"]
  node_sports_page["Sports Page<br/>[bbcSportsPage.py]"]
  node_comment_page["Comment Page"]
  node_base_page["Shared Actions<br/>[basePage.py]"]
end

subgraph group_runtime["Browser Runtime"]
  node_environment["Scenario Hooks<br/>[environment.py]"]
  node_driver_factory["Driver Factory<br/>[driver_factory.py]"]
end

node_user(("Test User"))
node_browser(("Chrome Browser"))
node_bbc(("BBC Website"))

node_user -->|"runs scenarios"| node_features
node_features -->|"binds steps"| node_navigation_steps
node_features -->|"binds steps"| node_comment_steps
node_navigation_steps -->|"loads credentials"| node_user_data
node_navigation_steps -->|"drives login"| node_home_page
node_navigation_steps -->|"selects articles"| node_sports_page
node_comment_steps -->|"checks comments"| node_comment_page
node_comment_steps -->|"checks articles"| node_sports_page
node_home_page -->|"inherits actions"| node_base_page
node_sports_page -->|"inherits actions"| node_base_page
node_comment_page -->|"inherits actions"| node_base_page
node_environment -->|"creates driver"| node_driver_factory
node_environment -->|"quits driver"| node_browser
node_driver_factory -->|"starts Chrome"| node_browser
node_driver_factory -->|"opens homepage"| node_bbc
node_base_page -->|"uses Selenium"| node_browser

click node_features "https://github.com/suryadharshinivijay/bbcsport/blob/master/features/sport_comment_validation.feature"
click node_navigation_steps "https://github.com/suryadharshinivijay/bbcsport/blob/master/features/steps/navigation_steps.py"
click node_comment_steps "https://github.com/suryadharshinivijay/bbcsport/blob/master/features/steps/comment_steps.py"
click node_user_data "https://github.com/suryadharshinivijay/bbcsport/blob/master/testData/User_details.json"
click node_home_page "https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/bbcHomePage.py"
click node_sports_page "https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/bbcSportsPage.py"
click node_comment_page "https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/sportsArticleCommentPage.py"
click node_base_page "https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/basePage.py"
click node_environment "https://github.com/suryadharshinivijay/bbcsport/blob/master/features/environment.py"
click node_driver_factory "https://github.com/suryadharshinivijay/bbcsport/blob/master/utils/driver_factory.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_features,node_user_data,node_user,node_browser toneBlue
class node_navigation_steps,node_comment_steps toneAmber
class node_home_page,node_sports_page,node_comment_page,node_base_page toneMint
class node_environment,node_driver_factory toneRose
class node_bbc toneIndigo
```

## Components

### BDD Scenarios

- [Comment Scenarios](https://github.com/suryadharshinivijay/bbcsport/blob/master/features/sport_comment_validation.feature): `features/sport_comment_validation.feature`
- [Login Data](https://github.com/suryadharshinivijay/bbcsport/blob/master/testData/User_details.json): `testData/User_details.json`

### Scenario Steps

- [Navigation Steps](https://github.com/suryadharshinivijay/bbcsport/blob/master/features/steps/navigation_steps.py): `features/steps/navigation_steps.py`
- [Comment Steps](https://github.com/suryadharshinivijay/bbcsport/blob/master/features/steps/comment_steps.py): `features/steps/comment_steps.py`

### Page Objects

- [Home Page](https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/bbcHomePage.py): `pageObjects/bbcHomePage.py`
- [Sports Page](https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/bbcSportsPage.py): `pageObjects/bbcSportsPage.py`
- [Comment Page](https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/sportsArticleCommentPage.py): `pageObjects/sportsArticleCommentPage.py`
- [Shared Actions](https://github.com/suryadharshinivijay/bbcsport/blob/master/pageObjects/basePage.py): `pageObjects/basePage.py`

### Browser Runtime

- [Scenario Hooks](https://github.com/suryadharshinivijay/bbcsport/blob/master/features/environment.py): `features/environment.py`
- [Driver Factory](https://github.com/suryadharshinivijay/bbcsport/blob/master/utils/driver_factory.py): `utils/driver_factory.py`

### Other components

- **Test User**
- **Chrome Browser**
- **BBC Website**

## Connections

- Test User → Comment Scenarios: runs scenarios (evidence: `README.md`)
- Comment Scenarios → Navigation Steps: binds steps (evidence: `README.md`)
- Comment Scenarios → Comment Steps: binds steps (evidence: `README.md`)
- Navigation Steps → Login Data: loads credentials (evidence: `features/steps/navigation_steps.py`)
- Navigation Steps → Home Page: drives login (evidence: `features/steps/navigation_steps.py`)
- Navigation Steps → Sports Page: selects articles (evidence: `features/steps/navigation_steps.py`)
- Comment Steps → Comment Page: checks comments (evidence: `features/steps/comment_steps.py`)
- Comment Steps → Sports Page: checks articles (evidence: `features/steps/comment_steps.py`)
- Home Page → Shared Actions: inherits actions (evidence: `pageObjects/bbcHomePage.py`)
- Sports Page → Shared Actions: inherits actions (evidence: `pageObjects/bbcSportsPage.py`)
- Comment Page → Shared Actions: inherits actions (evidence: `pageObjects/sportsArticleCommentPage.py`)
- Scenario Hooks → Driver Factory: creates driver (evidence: `features/environment.py`)
- Scenario Hooks → Chrome Browser: quits driver (evidence: `features/environment.py`)
- Driver Factory → Chrome Browser: starts Chrome (evidence: `utils/driver_factory.py`)
- Driver Factory → BBC Website: opens homepage (evidence: `utils/driver_factory.py`)
- Shared Actions → Chrome Browser: uses Selenium (evidence: `README.md`)
