Skip to content

Document Windows long-path checkout #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
HeKoXCode merged 1 commit into from
Sep 6, 2026
Merged

Document Windows long-path checkout #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions DOCS/technical_documentation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ Stable exit codes:

I configure UTF-8 explicitly for files and console output, including Windows terminals that previously failed on emoji output.

The versioned pbi-tools extraction contains generated visual-directory names that can exceed the legacy Windows path limit. A Windows checkout must use `core.longpaths=true`; the root README provides a one-shot clone command and the repository-local setting. `.gitattributes` also fixes LF for CSV inputs and byte-compared generated artifacts so checksums and generator validation remain stable across Windows and Linux.

## 2. Contract-driven ETL

`src/nba_pipeline/contracts.py` defines the exact header, order, type, nullability, domain, range, primary key and output name for all six inputs. `contracts/schema_v1.0.0.json` is generated from that source and committed for review.
Expand Down
10 changes: 10 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,16 @@ The pipeline does not delete valid fact rows to force foreign keys. It preserves

You need Python **3.12**. SQL Server and Power BI Desktop are only required for the BI layer.

The extracted Power BI source contains generated paths longer than the legacy Windows limit. If you use Git for Windows, enable long paths during the first checkout and keep the setting in this clone:

```powershell
git -c core.longpaths=true clone https://github.com/HeKoXCode/nba-analytics-platform.git
Set-Location nba-analytics-platform
git config core.longpaths true
```

GitHub Desktop users can run `git config core.longpaths true` from **Repository → Open in Command Prompt/PowerShell** after cloning. If the initial checkout already failed, delete only that incomplete clone and repeat the command above in a shorter parent directory.

```powershell
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
Expand Down
Loading