pypa / pypa/packaging.python.org

Document that sparse identifiers with whitespace are valid if quoted

Open Beginner friendly
#1,226 3 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

component: specifications good first issue type: enhancement
Dominant language
Python
Stars
1.7k
Forks
1.7k
Avg merge
3d 12h
Merged PRs (30d)
4

Description

As a related improvement, we could also show that it's possible to use sparse identifiers with actual whitespaces when quoted. Like pip ~= 23.1, or resolvelib > 0.5, != 0.6.0. I think, this makes them more readable and this style should be used in human-maintained files (as opposed to the tool-generated ones, like constraint pins made with pip-tools).

Originally posted by @webknjaz in https://github.com/pypa/packaging.python.org/issues/1225#issuecomment-1471867938

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing sparse-identifier documentation and the related discussion in issue #1225. Add documentation showing that identifiers containing whitespace are valid when quoted, using the examples from this issue, and verify that the documentation build passes.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.