apache / apache/parquet-java

Inaccurate Thrift Installation Instructions on README

Open
#3,228 0 comments 2 reactions 0 assignees View on GitHub
Type: bug
Dominant language
Java
Stars
3.1k
Forks
1.6k
Avg merge
3d 12h
Merged PRs (30d)
33

Description

### Describe the bug, including details regarding any error messages, version, and platform.

The README currently states:

“If you’re on OSX and use Homebrew, you can instead install Thrift 0.21.0 with brew and ensure that it comes first in your PATH.”

However, since Thrift 0.22.0 was released on May 23, 2025, the Homebrew formula for Thrift 0.21.0 is no longer available by default. As a result, users following the current instructions will not be able to install the required version.

To resolve this, we should either:
1. Upgrade the project to support Thrift 0.22.0 (not available on maven yet), or
2. Update the README to guide users to install Thrift 0.21.0 using brew extract, for example:

```
brew tap-new temp/oldthrift
brew extract --version=0.21.0 thrift temp/oldthrift
brew install temp/oldthrift/thrift@0.21.0
```

### Component(s)

_No response_

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by locating the README section containing the OSX Homebrew Thrift 0.21.0 instructions and verify the current installation behavior described in the issue. Resolve whether the project will document brew extract or support Thrift 0.22.0, then update the README so the documented installation path works for the required version.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.