CLI: expose public search language with --language
@semajzandrews is already working on this.
Since Nov 14, 2026.
- #89 by @HarshRajSinghania — closed without merging
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 62/100
Research direction
The change belongs in spotapi/cli.py, where the search subcommand's arguments are defined and forwarded to Public.search; tests/test_cli.py is where the offline cases go. Read how the existing search arguments are wired, then add an optional --language flag and pass its value through unchanged. Done means the help text shows an example locale, omitting the flag behaves as before, and offline tests cover both supplied and omitted cases.
Written by the indexing model from the issue text.
Description
Problem
Public.search(..., language="fr-CA") already supports localized public search, but spotapi search does not expose that option. CLI users must write Python for a capability the CLI can forward directly.
Proposed change
Add an optional locale flag:
spotapi search "Charlotte Cardin" --language fr-CA
Pass its value unchanged to Public.search(..., language=args.language).
Acceptance criteria
-
spotapi search --helpdocuments--languagewith an example locale. - Omitting the option preserves current behavior.
- The supplied value is forwarded unchanged to
Public.search. - Offline tests cover both the supplied and omitted cases.
- No new dependency or Spotify endpoint is introduced.
Scope
The likely implementation is limited to spotapi/cli.py and tests/test_cli.py. Do not add automatic locale detection or change the Python API as part of this issue.
Comment before starting so duplicate work can be avoided.
- Dominant language
- Python
- Stars
- 493
- Forks
- 40
- Avg merge
- 5m
- Merged PRs (30d)
- 1
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
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 Aran404/SpotAPI
-
CLI: reject invalid player seek and volume values before connectingMay be free again A pull request for this issue was closed without being merged. Openbug good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
documentation enhancement help wanted
Difficulty 4/5 3-5 days Newbie friendliness 42/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
deepchem/deepchem#5289 · 1 comment ·
Maintainers usually reply within 2 days
-
Difficulty 1/5 Under an hour Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 60/100
UKGovernmentBEIS/inspect_evals#2892 · 1 comment ·
Maintainers usually reply within 1 day
-
Versioning docs: say that no output from the 0.46 warning check means nothing is affectedPossibly taken @grelinfo claimed this today. Opendocumentation priority:low size:S
Difficulty 1/5 Under an hour Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
alphacrack/readme2demo#293 ·