22 comments (22 comments)183 reactions (183 reactions)0 assignees (0 assignees)Python41,258 stars (41,258 stars)2,693 forks (2,693 forks)batch import
C: parserS: acceptedT: enhancementhelp wanted
Description
We'd like to be able to format .pyx, .pxd, and .pxi files, too.
Contributor guide
- Tech stack
- python
- Domain
- tooling
- Issue type
- feature
- DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
- 3
- Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
- over 1 week
- Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
- stale
- ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
- clear
- Prerequisites
- Understanding of Python parsingFamiliarity with Black's codebase structureBasic knowledge of Cython syntaxExperience with grammar modifications
- Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
- 35
- Research direction
- Start by examining Black's current parser implementation, likely in the 'blib2to3' directory, to understand how Python syntax is defined and parsed. Study the Cython language specification, particularly the syntax differences from Python (e.g., cdef, cpdef, extern). The goal is to extend Black's grammar to accept .pyx, .pxd, .pxi files. Check existing issues and PRs for prior attempts or discussions. No linked PRs exist, so this is a fresh implementation task.