Windows OS: Unable to clone repository due to invalid path with colons in filename
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 65/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- git
- Domain
- developer-experience
Research direction
Start with the affected file, example-data/Retrieval Augmented Generation :: Spring AI Reference.pdf, and review the suggested Windows-compatible replacement names. Rename the file, then run the reported Git clone on Windows and confirm checkout completes without the invalid-path error.
Written by the indexing model from the issue text.
Description
Description
The repository cannot be cloned on Windows systems due to a file with colons in its name, which are not allowed in Windows file paths.
Error
error: invalid path 'example-data/Retrieval Augmented Generation :: Spring AI Reference.pdf' fatal: unable to checkout working tree
Affected File
example-data/Retrieval Augmented Generation :: Spring AI Reference.pdf
Reproduction
- Clone the repository on Windows:
git clone https://github.com/marcushellberg/practical-ai-in-java.git - Checkout fails with the error above
Suggested Fix
Rename the file to replace :: with a Windows-compatible character:
Retrieval Augmented Generation - Spring AI Reference.pdfRetrieval Augmented Generation _ Spring AI Reference.pdf
Environment
- OS: Windows 10/11
- Git: 2.x
This would make the repository accessible to Windows developers without requiring WSL or workarounds.
- Dominant language
- Java
- Stars
- 93
- Forks
- 19
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from marcushellberg/practical-ai-in-java
-
Difficulty 3/5 1-2 days Newbie friendliness 25/100
-
marcushellberg/practical-ai-in-java#6 · 8 comments · 1 assignee ·
All issues in marcushellberg/practical-ai-in-java
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
infinispan/infinispan#18150 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
opensearch-project/k-NN#3597 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100