pychanga 0.1.0__tar.gz

pychanga-0.1.0/.gitignore

@@ -0,0 +1,152 @@
+# data and old code
+data/
+old/
+sample/
+testing/
+database.ini
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# editor config
+.vscode/
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+**__pycache__
+
+# PyCharm
+.idea/
+
+# RStudio project files
+**.Rproj.user/
+**.Rproj.user*
+**.Rproj
+**.Rhistory
+
+# MacOS
+.DS_Store

pychanga-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Saldivia
+
+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.

pychanga-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.5
+Name: pychanga
+Version: 0.1.0
+Summary: sports db manager
+Project-URL: Homepage, https://github.com/DavidSaldivia/pychanga
+Project-URL: Repository, https://github.com/DavidSaldivia/pychanga
+Project-URL: Issues, https://github.com/DavidSaldivia/pychanga/issues
+Author-email: David Saldivia <david.saldivia.s@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: database,football,polars,sports,statistics
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: <4.0,>=3.12
+Requires-Dist: great-tables<0.19.0,>=0.18.0
+Requires-Dist: matplotlib>=3.9.2
+Requires-Dist: numpy>=2.0
+Requires-Dist: plotly>=5.24.1
+Requires-Dist: polars>=1.9.0
+Requires-Dist: rich<15.0.0,>=14.1.0
+Description-Content-Type: text/markdown
+
+*-# pychanga - python-based sports database manager
+
+Pychanga (pronounced as the Chilean Spanish word) is a light-weight sports database manager written in python, using polars and parquet files. It is the db manager in golessonamores.cl, a Chilean football stats website launched in 2018. This code started as a rewritten version of this website's original code (written in php). As a python package aims to provide support for different sports and its user target are sports stats aficionados with some basic python knowledge and access to data.
+
+## Install
+install it with pip:
+py -m pip install pychanga
+
+## Data configuration
+pychanga is now data-root driven. Your app must point pychanga to a folder that contains:
+- `parquet/*.parquet` for runtime queries
+- optionally `csv/*.csv` if you run conversion scripts
+
+You can configure it in two ways:
+- Environment variable: `PYCHANGA_DATA_DIR=/path/to/data_root`
+- Runtime setup:
+
+```python
+import pychanga as pc
+
+pc.set_data_dir("/path/to/data_root")
+comp = pc.Competition("CHI-1A")
+```
+
+If neither is configured, pychanga will try a local `.dirs` file (for backwards compatibility), and then a bundled sample dataset.
+
+## Build sample dataset
+To generate a minimal sample dataset from your Golessonamores data:
+
+```bash
+python dev/build_sample_dataset.py \
+	--source-data-dir /path/to/golessonamores/data \
+	--target-data-dir sample \
+	--comp-id CHI-1A \
+	--edition-id CHI-1A-1994
+```
+
+This creates `sample/parquet/*.parquet` with only:
+- competition `CHI-1A`
+- edition `CHI-1A-1994`
+- teams that appear in those matches
+- related reference tables (sports, countries, stages, sources, etc.)
+
+## Features
+- It provides some classes to represent sports entities, such as: Competition, Edition, Team, Player, Match, Ground, Sport, among others.
+- It provides classes to ask some common queries, such as: HeadToHead, Streaks, 
+- Each class provides methods to retrieve stats based on an id.
+- The queries are all written in polars' DSL (domain specific language) 
+
+## Example
+
+## Documentation
+
+## Collaboration
+

pychanga-0.1.0/README.md

@@ -0,0 +1,55 @@
+*-# pychanga - python-based sports database manager
+
+Pychanga (pronounced as the Chilean Spanish word) is a light-weight sports database manager written in python, using polars and parquet files. It is the db manager in golessonamores.cl, a Chilean football stats website launched in 2018. This code started as a rewritten version of this website's original code (written in php). As a python package aims to provide support for different sports and its user target are sports stats aficionados with some basic python knowledge and access to data.
+
+## Install
+install it with pip:
+py -m pip install pychanga
+
+## Data configuration
+pychanga is now data-root driven. Your app must point pychanga to a folder that contains:
+- `parquet/*.parquet` for runtime queries
+- optionally `csv/*.csv` if you run conversion scripts
+
+You can configure it in two ways:
+- Environment variable: `PYCHANGA_DATA_DIR=/path/to/data_root`
+- Runtime setup:
+
+```python
+import pychanga as pc
+
+pc.set_data_dir("/path/to/data_root")
+comp = pc.Competition("CHI-1A")
+```
+
+If neither is configured, pychanga will try a local `.dirs` file (for backwards compatibility), and then a bundled sample dataset.
+
+## Build sample dataset
+To generate a minimal sample dataset from your Golessonamores data:
+
+```bash
+python dev/build_sample_dataset.py \
+	--source-data-dir /path/to/golessonamores/data \
+	--target-data-dir sample \
+	--comp-id CHI-1A \
+	--edition-id CHI-1A-1994
+```
+
+This creates `sample/parquet/*.parquet` with only:
+- competition `CHI-1A`
+- edition `CHI-1A-1994`
+- teams that appear in those matches
+- related reference tables (sports, countries, stages, sources, etc.)
+
+## Features
+- It provides some classes to represent sports entities, such as: Competition, Edition, Team, Player, Match, Ground, Sport, among others.
+- It provides classes to ask some common queries, such as: HeadToHead, Streaks, 
+- Each class provides methods to retrieve stats based on an id.
+- The queries are all written in polars' DSL (domain specific language) 
+
+## Example
+
+## Documentation
+
+## Collaboration
+

pychanga-0.1.0/dev/dashboard/README.md

@@ -0,0 +1,32 @@
+# Dashboard Workspace
+
+This folder contains web dashboards for interactive football statistics built on top of `pychanga` data models.
+
+## Dashboards
+
+- `h2h`: Head-to-head explorer (implemented)
+- `league_journey`: planned
+- `honours`: planned
+- `rivals`: planned
+
+## Quick Start
+
+1. Install project dependencies with Poetry (from repository root):
+
+```bash
+poetry install
+```
+
+2. Run the first dashboard:
+
+```bash
+poetry run python dashboard/h2h/app.py
+```
+
+3. Open your browser at:
+
+- http://127.0.0.1:8050
+
+## Plan
+
+See `dashboard/IMPLEMENTATION_PLAN.md` for the full roadmap.

pychanga-0.1.0/dev/dashboard/honours/README.md

@@ -0,0 +1,12 @@
+# Honours Dashboard
+
+Status: planned
+
+This dashboard will focus on champions and title distribution insights.
+
+Planned features:
+
+- Competition selector
+- Champions distribution charts
+- Timeline / decade comparison
+- Team comparison mode

pychanga-0.1.0/dev/dashboard/league_journey/README.md

@@ -0,0 +1,12 @@
+# League Journey Dashboard
+
+Status: planned
+
+This dashboard will focus on interactive team evolution across league levels and seasons.
+
+Planned features:
+
+- Team selector
+- Competition/division filters
+- Championship markers
+- Season drilldown

pychanga-0.1.0/dev/dashboard/rivals/README.md

@@ -0,0 +1,12 @@
+# Rivals Dashboard
+
+Status: planned
+
+This dashboard will focus on rivalry analytics and matchup outcomes.
+
+Planned features:
+
+- Team selector
+- Top rivals ranking
+- W/D/L stacked chart
+- Match-level drilldown

pychanga-0.1.0/pychanga/__init__.py

@@ -0,0 +1,50 @@
+import time
+
+from pychanga.competition import Competition
+from pychanga.edition import Edition
+# from pychanga.matches import Matches
+from pychanga.team import Team
+from pychanga.ground import Ground
+from pychanga.base.directory import clear_data_dir, get_data_dir, set_data_dir
+
+__all__ = [
+    "Competition",
+    "Edition",
+    "Team",
+    "Ground",
+    "set_data_dir",
+    "clear_data_dir",
+    "get_data_dir",
+]  # , "Matches"]
+
+CHAOS_INDEX: float = 0.9
+
+class Sorry:
+
+    def __repr__(self):
+        return f"""Hi, developer from the future
+        The last Chaos Index update is:
+        {self.category()}. Updated last time {time.strftime()}.
+        {self.the_mess()}
+        """
+
+    def category(self):
+        return CHAOS_INDEX
+
+    def the_mess(self):
+        match CHAOS_INDEX:
+            case 0.0:
+                the_mess = "Heat Death"
+            case bin if 0.0 < bin < 10.0:
+                the_mess = "Low entropy. Probably the project is terminal."
+            case bin if 10.0 <= bin < 40.0:
+                the_mess = "Zen mode. Wow. The dev is happy with its life, oddly. Or the project is stable."
+            case bin if 40.0 <= bin < 70.0:
+                the_mess = "Medium. Danger zone! Take care of yourself, mate!"
+            case bin if 70.0 <= bin < 90.0:
+                the_mess = "this shit is either skyrocketing or exploding."
+            case bin if 90.0 <= bin:
+                the_mess = "what the fuck is goin on."
+            case _:
+                the_mess = None
+        return the_mess

pychanga-0.1.0/pychanga/base/db.py

@@ -0,0 +1,141 @@
+import polars as pl
+
+from pychanga.base import definitions
+
+
+class SCHEMA:
+    changes = {
+        "type": str,
+        "sport_id": str,
+        "ID": str,
+        "name": str,
+        "date": str,
+        "obs": str,
+    }
+    comps = {
+        "comp_id": str,
+        "name": str,
+        "country_id": str,
+        "format": pl.Enum(definitions.COMPS_FORMATS.keys()),
+        "sport_id": pl.String,
+        "description": str,
+        "order": int,
+        "show_web": bool,
+    }
+    countries = {
+        "country_id": str,
+        "name": str,
+        "name_eng": str,
+        "confederation": str,
+    }
+    editions = {
+        "edition_id": pl.String,
+        "name": pl.String,
+        "comp_id": pl.String,
+        "ed": pl.Int16,
+        "season": pl.String,
+        "winner": pl.String,
+        "ladder_id": pl.String,
+    }
+    ladder_obs = {
+        "edition_id": pl.String,
+        "stage_id": pl.String,
+        "team_id": pl.String,
+        "type": pl.Enum(definitions.LADDER_OBS_TYPES.keys()),
+        "pts_adm": pl.Int16,
+        "GF_adm": pl.Int16,
+        "GC_adm": pl.Int16,
+        "obs": pl.String,
+    }
+    ladder_type = {
+        "ladder_id": pl.String,
+        "show": pl.String,
+        "order": pl.String,
+        "pts_calc": pl.String,
+    }
+    sources = {
+        "source_id": str,
+        "description": str,
+        "type": pl.Enum(definitions.SOURCES_TYPES),
+    }
+    sports = {
+        "sport_id": str,
+        "name_esp": str,
+        "name_eng": str,
+        "gov_body": str,
+        "abrv": str,
+        "n_members": str,
+        "biggest_comp": str,
+        "team_size": int,
+        "ball_type": pl.Categorical,
+        "family": pl.Categorical,
+        "pro": bool,
+        "since": str,
+        "other_names": str,
+    }
+    stages = {
+        "stage_id": pl.String,
+        "name": pl.String,
+        "order": pl.Int64,
+        "description": pl.String,
+        "ladder": pl.Boolean,
+    }
+    teams = {
+        "team_id": str,
+        "name": str,
+        "country_id": str,
+        "sport_id": pl.String,
+        "badge": bool,
+        "current": bool,
+        "obs": str,
+        "full_name": str,
+        "location": str,
+        "founded": str,
+        "ground": str,
+        "nicknames": str,
+        "colours_main": pl.List(pl.Utf8),
+        "colours_other": pl.List(pl.Utf8),
+    }
+    matches = {
+        "match_id": pl.Int64,
+        "comp_id": pl.String,
+        "edition_id": pl.String,
+        "day": pl.String,
+        "month": pl.String,
+        "year": pl.String,
+        "stage": pl.String,
+        "round": pl.Int8,
+        "team_1": pl.String,
+        "team_2": pl.String,
+        "goal_1": pl.String,
+        "goal_2": pl.String,
+        "pen_1": pl.String,
+        "pen_2": pl.String,
+        "host": pl.Categorical,
+        "venue": pl.Categorical,
+        "location": pl.Categorical,
+        "attendance": pl.Int32,
+        "referee": pl.Categorical,
+        "obs_ext": pl.String,
+        "obs_int": pl.String,
+        "source_id": pl.Categorical,
+    }
+
+
+FOREIGN_KEYS = {
+    ("changes", "sport_id"): ("sports", "sport_id"),
+    ("comps", "sport_id"): ("sports", "sport_id"),
+    ("editions", "comp_id"): ("comps", "comp_id"),
+    ("editions", "winner"): ("teams", "team_id"),
+    ("editions", "ladder_id"): ("ladder_type", "ladder_id"),
+    ("ladder_obs", "edition_id"): ("editions", "edition_id"),
+    ("ladder_obs", "stage_id"): ("stages", "stage_id"),
+    ("ladder_obs", "team_id"): ("teams", "team_id"),
+    ("teams", "sport_id"): ("sports", "sport_id"),
+    ("matches", "comp_id"): ("comps", "comp_id"),
+    ("matches", "edition_id"): ("editions", "edition_id"),
+    ("matches", "stage_id"): ("stages", "stage_id"),
+    ("matches", "team_1"): ("teams", "team_id"),
+    ("matches", "team_2"): ("teams", "team_id"),
+    ("matches", "source_id"): ("sources", "source_id"),
+}

pychanga-0.1.0/pychanga/base/definitions.py

@@ -0,0 +1,85 @@
+COMPS_FORMATS = {
+    "league": "round-robin competition",
+    "mini-league": "short league",
+    "inter": "international competition",
+    "amateur": "amateur competition",
+    "cup": "knockout competition",
+    "other": "rare/uncommon formats",
+    "friendly": "friendly competitions",
+}
+SPORTS_NAMES = {
+    'FT': 'Association Football',
+    'RU': 'Rugby Union',
+    'RL': 'Rugby League',
+    'RS': 'Rugby Sevens',
+    'AF': 'American Football',
+    'AU': 'Australian Football',
+    'FG': 'Gaelic Football',
+    'FC': 'Canadian Football',
+    'FS': 'Futsal',
+    'FP': 'Beach Soccer',
+    'BK': 'Basketball',
+    'VO': 'Volleyball',
+    'HA': 'Handball',
+    'WP': 'Waterpolo',
+    'BB': 'Baseball',
+    'CR': 'Cricket',
+    'HO': 'Field Hockey',
+    'HH': 'Ice Hockey',
+    'HP': 'Quad Hockey',
+    'HL': 'Inline Hockey',
+    'BN': 'Bandy',
+    'PO': 'Polo',
+    'LA': 'Lacrosse',
+    'UL': 'Ultimate',
+    'FL': 'Floorball',
+    'HU': 'Hurling',
+    'VP': 'Beach Volleyball',
+    'FB': 'Fistball',
+    'PD': 'Padel',
+    'ST': 'Sepak Takraw',
+    'KF': 'Korfball',
+    'NE': 'Netball',
+    'SB': 'Softball',
+    'PP': 'Pesäpallo',
+    'KB': 'Kin-Ball',
+    'QD': 'Quidditch',
+    'SH': 'Shinty',
+    'TK': 'Tchoukball',
+    'KA': 'Kabbadi',
+}
+SOURCES_TYPES = [
+    "news_website",
+    "official_website",
+    "stats_website",
+    "newspaper",
+    "book",
+    "personal_info",
+]
+LADDER_OBS_TYPES = {
+    "Z": "inter-zone",
+    "B": "bonus",
+    "P": "points",
+}
+
+COLORS_ESP_ENG = {
+    "azul": "blue",
+    "rojo": "red",
+    "celeste": "skyblue",
+    "verde": "green",
+    "marrón": "saddlebrown",
+    "blanco": "white",
+    "amarillo": "yellow",
+    "negro": "black",
+    "burdeo": "maroon",
+    "naranjo": "orange",
+    "rosado": "pink",
+    "granate": "maroon",
+    "café": "saddlebrown",
+    "plomo": "grey",
+    "calipso": "turquoise",
+    "dorado": "goldenrod",
+    "morado": "purple",
+    "violeta": "darkviolet",
+    "lila": "purple",
+}