mlb-cli-py 0.1.0__py3-none-any.whl

app/widgets/navigation_widget.py

@@ -0,0 +1,73 @@
+"""
+Navigation widget for the MLB CLI application.
+"""
+import pytermgui as ptg
+
+
+class NavigationWidget(ptg.Container):
+    """
+    A persistent navigation bar widget shown at the top of every screen.
+    Displays available pages and their hotkeys, highlighting the active one.
+    """
+    # pylint: disable=too-many-instance-attributes
+
+    def __init__(self, active_page=None, **kwargs):
+        """
+        Initializes the NavigationWidget.
+
+        Args:
+            active_page (str, optional): The name of the currently active screen.
+            **kwargs: Additional arguments for ptg.Container.
+        """
+        super().__init__(**kwargs)
+        self.border = ptg.boxes.EMPTY
+
+        if active_page == "standings":
+            self.schedule_label = ptg.Label(
+                "Back to Schedule [bold][cyan]x[/]",
+                parent_align=ptg.HorizontalAlignment.CENTER)
+            self.calendar_label = ptg.Label(
+                "Back to Calendar [bold][cyan]c[/]",
+                parent_align=ptg.HorizontalAlignment.CENTER)
+            self.set_widgets([ptg.Splitter(self.schedule_label, self.calendar_label)])
+            return
+
+        if active_page == "calendar":
+            self.prev_label = ptg.Label(
+                "Prev Page [bold][cyan][[/]",
+                parent_align=ptg.HorizontalAlignment.CENTER)
+            self.next_label = ptg.Label(
+                "Next Page [bold][cyan]][/]",
+                parent_align=ptg.HorizontalAlignment.CENTER)
+            self.stand_label = ptg.Label(
+                "Standings [bold][cyan]x[/]",
+                parent_align=ptg.HorizontalAlignment.CENTER)
+            self.set_widgets([ptg.Splitter(self.prev_label, self.next_label, self.stand_label)])
+            return
+
+        # Default: Schedule page navigation
+        self.prev_label = ptg.Label(
+            "Prev [bold][cyan][[/]",
+            parent_align=ptg.HorizontalAlignment.CENTER)
+        self.next_label = ptg.Label(
+            "Next [bold][cyan]][/]",
+            parent_align=ptg.HorizontalAlignment.CENTER)
+        self.today_label = ptg.Label(
+            "Today [bold][cyan]t[/]",
+            parent_align=ptg.HorizontalAlignment.CENTER)
+        self.cal_label = ptg.Label(
+            "Calendar [bold][cyan]c[/]",
+            parent_align=ptg.HorizontalAlignment.CENTER)
+        self.stand_label = ptg.Label(
+            "Standings [bold][cyan]x[/]",
+            parent_align=ptg.HorizontalAlignment.CENTER)
+
+        self.splitter = ptg.Splitter(
+            self.prev_label,
+            self.next_label,
+            self.today_label,
+            self.cal_label,
+            self.stand_label,
+        )
+
+        self.set_widgets([self.splitter])

app/widgets/separator.py

@@ -0,0 +1,11 @@
+"""
+Separator widget for the MLB CLI application.
+"""
+import pytermgui as ptg
+
+
+class Separator(ptg.Label):
+    """A simple horizontal line separator widget."""
+
+    def __init__(self, **kwargs):
+        super().__init__("─" * 10, **kwargs)

app/widgets/standing_widget.py

@@ -0,0 +1,66 @@
+"""
+Standing widget for the MLB CLI application.
+"""
+import pytermgui as ptg
+from app.models.data_service import get_team_abbr
+
+
+class StandingWidget(ptg.Container):
+    """
+    A container widget displaying the standings for a specific MLB division.
+    """
+
+    def __init__(self, division_data, **kwargs):
+        """
+        Initializes the StandingWidget with division data.
+
+        Args:
+            division_data (dict): Dictionary containing division name and team records.
+            **kwargs: Additional arguments for ptg.Container.
+        """
+        super().__init__(**kwargs)
+        if not division_data:
+            self.inner_widgets = [ptg.Label("No Data")]
+            self.set_widgets(self.inner_widgets)
+            return
+
+        self._selectables_length = 1
+        self.border = ptg.boxes.SINGLE
+
+        name = division_data.get('div_name', 'Unknown')
+        # Replace full league names with abbreviations
+        name = name.replace(
+            "American League",
+            "AL").replace(
+            "National League",
+            "NL")
+
+        widgets = [ptg.Label(f"[bold]{name}[/]")]
+        widgets.append(self._create_header())
+
+        for team in division_data.get('teams', []):
+            widgets.append(self._create_team_row(team))
+
+        self.set_widgets(widgets)
+        self.inner_widgets = widgets
+
+    def _create_header(self):
+        """Creates the header row for the standings."""
+        tm_lbl = "TM".ljust(4)
+        w_lbl = "W".rjust(3)
+        l_lbl = "L".rjust(3)
+        gb_lbl = "GB".rjust(4)
+        pct_lbl = "PCT".rjust(6)
+        l10_lbl = "L10".rjust(6)
+        return ptg.Label(f"[bold]{tm_lbl} {w_lbl} {l_lbl} {gb_lbl} {pct_lbl} {l10_lbl}[/]")
+
+    def _create_team_row(self, team):
+        """Creates a data row for a single team."""
+        # Use team abbreviation instead of full name
+        abbr = get_team_abbr(team['team_id']).ljust(4)
+        w = str(team['w']).rjust(3)
+        l = str(team['l']).rjust(3)
+        gb = str(team['gb']).rjust(4)
+        pct = str(team['pct']).rjust(6)
+        l10 = str(team['l10']).rjust(6)
+        return ptg.Label(f"{abbr} {w} {l} {gb} {pct} {l10}")

mlb_cli_py-0.1.0.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: mlb-cli-py
+Version: 0.1.0
+Summary: A modern TUI for MLB scores, standings, and schedules
+Author: Conor Cleary
+License: Copyright 2026 Conor Cleary
+        
+        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.
+        
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Terminals
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytermgui==7.7.4
+Requires-Dist: MLB-StatsAPI==1.9.0
+Requires-Dist: redis==5.0.4
+Provides-Extra: dev
+Requires-Dist: pytest==8.2.0; extra == "dev"
+Requires-Dist: pytest-cov==5.0.0; extra == "dev"
+Requires-Dist: fakeredis==2.23.2; extra == "dev"
+Dynamic: license-file
+
+# MLB Box Score TUI
+
+A Python-based Terminal User Interface (TUI) for Major League Baseball (MLB) scores, schedules, and standings. Built with `pytermgui` and the `MLB-StatsAPI`, featuring a modular architecture and 100% test coverage.
+
+## Features
+
+- **Full Season Schedule:** Navigate the entire 2026 MLB season through a dedicated calendar view or daily snapshots.
+- **Dynamic Standings:** Real-time standings for all 6 MLB divisions (AL and NL), including comprehensive **Wild Card** rankings.
+- **Interactive Calendar:** A multi-month calendar view for quick date selection, featuring intuitive **WASD** keyboard navigation and automatic focus management.
+- **Smart Caching:** Built-in caching service to minimize API calls and ensure a responsive user experience.
+- **Smooth Transitions:** Animated screen transitions for a modern, fluid feel.
+- **Robust Architecture:** Surgical, class-based organization of widgets and screens for high maintainability.
+
+## Installation
+
+### From PyPI (Recommended)
+
+Install the application directly using `pip`:
+
+```bash
+pip install mlb-cli-py
+```
+
+### Local Setup (Development)
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/conorpcleary/mlb-cli-py.git
+   cd mlb-cli-py
+   ```
+
+2. **Create and activate a virtual environment:**
+   ```bash
+   python3 -m venv venv
+   source venv/bin/activate
+   ```
+
+3. **Install in editable mode:**
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+## Usage
+
+After installation, run the application from anywhere in your terminal:
+
+```bash
+mlb-cli
+```
+
+## Controls
+
+The application is designed for rapid keyboard-driven navigation.
+
+### Global Controls
+
+| Key | Action |
+| --- | --- |
+| `[` | Previous Day / Previous Calendar Page (with wrapping) |
+| `]` | Next Day / Next Calendar Page (with wrapping) |
+| `t` | Jump to Today's Schedule |
+| `c` | Switch to Calendar View |
+| `x` | Toggle Standings View |
+| `ESC` | Exit the application |
+| `Tab` | Cycle focus between UI components |
+
+### Calendar Navigation
+
+When in the Calendar view, you can use specialized keys for precise date selection:
+
+| Key | Action |
+| --- | --- |
+| `W` | Move focus up one week |
+| `A` | Move focus left one day |
+| `S` | Move focus down one week |
+| `D` | Move focus right one day |
+| `Enter` | Select the focused date and view its schedule |
+
+## Project Structure
+
+The project follows a strict modular design optimized for distribution:
+
+```text
+mlb-cli-py/
+├── pyproject.toml       # Modern build system configuration and metadata
+├── app/
+│   ├── mlb_cli.py       # Main application controller and TUI entry point
+│   ├── models/          # Data services (API fetching, caching, date utilities)
+│   ├── widgets/         # Modular TUI components (Game, Standing, Calendar widgets)
+│   └── screens/         # Class-based screen definitions (Schedule, Standings, Calendar)
+├── tests/               # 100% covered test suite (Unit and integration tests)
+└── README.md            # You are here!
+```
+
+## Development & Testing
+
+The project maintains a perfect **10.00/10 Pylint score** and **100% test coverage**.
+
+### Running Tests
+
+To run the full test suite using `pytest`:
+
+```bash
+PYTHONPATH=. pytest
+```
+
+### Linting
+
+To verify code quality:
+
+```bash
+pylint app tests
+```
+
+## Release Workflow
+
+This project uses an automated release pipeline to publish updates to PyPI:
+
+1. **Version Bump:** Update the version in `pyproject.toml`.
+2. **GitHub Release:** Create and publish a new Release on GitHub with a version tag (e.g., `v0.1.0`).
+3. **Automated Publish:** A GitHub Action is triggered by the release, which:
+   - Builds the source distribution and wheel.
+   - Publishes the package to PyPI using **Trusted Publishing (OIDC)**.
+
+## Acknowledgements
+
+This project would not be possible without the [MLB-StatsAPI](https://github.com/toddrob99/MLB-StatsAPI) and [PyTermGUI](https://github.com/bczsalba/pytermgui) projects.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

mlb_cli_py-0.1.0.dist-info/RECORD

@@ -0,0 +1,29 @@
+app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+app/config.py,sha256=sOJF9v0EUmFhASFbgyidlhBuDfkN5-YLd7BlckkHRyE,476
+app/exceptions.py,sha256=oGk3AtYy1qh8m9SEyB0uHDn3v50gW08fx_2mrTMA4Ec,159
+app/logger.py,sha256=M3Lt5LyrS1-ROQUUolFgTyd9LOEN5q9XM5_eYMm4Ohg,891
+app/mlb_cli.py,sha256=wuQkLv-kPDjJmCmivStDdIl618jCBFVIlULfNODddcM,11938
+app/state.py,sha256=UotA4pH22UGfmNQ7jCLy2XWvhU-KzzuYreKnwWR0ze4,2428
+app/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+app/models/base_data_source.py,sha256=aJEzSR_SWjDzGku2h4UzkYZUj4YjkojupR7gczXmhFI,768
+app/models/cache_service.py,sha256=RMzZJmVIsJ6iIAyIXK_DSq1Z5nT9hYoCpss7QDDw5vQ,1408
+app/models/data_service.py,sha256=jIdYD_APLpyTnDiYnzEJjf3Cx2_tGmLrbDd9jmHAUl0,5050
+app/models/statsapi_source.py,sha256=uM7tYRFfBqYurP09SbAP4YOx7Ht_rpeV1JnzkdBhQFU,3012
+app/screens/__init__.py,sha256=CVViC48tGT8OIqRGh519op59l8caenBLLH75zwSlSh8,307
+app/screens/calendar_screen.py,sha256=9UWEEcze7bYTyugTSwqmFEd9UlTsXVfOXxhVT7zh9bo,1892
+app/screens/error_screen.py,sha256=h4V4OFlLDuVfsQEXs29HjKUFroo0D5OPjCfMbghXBgE,1467
+app/screens/schedule_screen.py,sha256=WC5ElTc10gjN7pnO7_yMcXPoiqL6LHng9AGTGjbN-Bc,901
+app/screens/standings_screen.py,sha256=7AI74wv2N0cgCwE43Mvyd01qx7clBcwo1-avy8r8b7w,1361
+app/widgets/__init__.py,sha256=kWfFCgLk_zGfgU9ipLwpVJqc8raehdjdBFaL2bA1TI8,615
+app/widgets/animations.py,sha256=cbu1hL-A4YYEo5OMECRTky5Bvzk4uY_O6OF3USh7l_k,2679
+app/widgets/calendar_widget.py,sha256=nUiyqRg7m72TNRcUsjkl6parw4BWSnbrqZvG9gNxn4c,2495
+app/widgets/game_widget.py,sha256=rYWt9FHaSYKFPF-Ud6WsEGsHVMfTRUKH4jlDcAd6fW0,4502
+app/widgets/navigation_widget.py,sha256=8j6GpsMWxWTD2fZM3lADAS5O72Dv2B5NMpRRxowyAoM,2701
+app/widgets/separator.py,sha256=KDB6ku9gDTcV9Lqi7NWKKsS656zEcyrUCoY8qtnHtGo,243
+app/widgets/standing_widget.py,sha256=__AYfPcpCpCJ93O1lVyUL0MnKIEG0TazXDxRM-MTm6k,2164
+mlb_cli_py-0.1.0.dist-info/licenses/LICENSE,sha256=pL3q4twDCb-zVAcdm7MhjZF6ORgx9a2b0NBa5_zTesQ,1060
+mlb_cli_py-0.1.0.dist-info/METADATA,sha256=MyWuJWmY_tRUb48VzlbnEtVrSi808q7qJUUMiB7KGKc,5844
+mlb_cli_py-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+mlb_cli_py-0.1.0.dist-info/entry_points.txt,sha256=5GX60LnKQH4tJfZWNPa6JW2eKCg3YP9o8Yr7Rko05qc,45
+mlb_cli_py-0.1.0.dist-info/top_level.txt,sha256=io9g7LCbfmTG1SFKgEOGXmCFB9uMP2H5lerm0HiHWQE,4
+mlb_cli_py-0.1.0.dist-info/RECORD,,

mlb_cli_py-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mlb_cli_py-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mlb-cli = app.mlb_cli:main

mlb_cli_py-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 Conor Cleary
+
+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.

mlb_cli_py-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+app