Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Allow the download command to use a different server

Open Beginner friendly
#194 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

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

Research direction

Start at the physionet download command and trace how it calls the Python download() function, which already accepts base_url. Add a CLI --base-url option that passes the value through, then check the command help and existing download tests. Done when the CLI can use a custom PhysioNet host for API calls and file downloads; account for the note that --source auto may still use the AWS mirror.

Written by the indexing model from the issue text.

Description

physionet download always fetches from https://physionet.org (or the AWS mirror). The Python download() function already takes a base_url argument, but the command line has no way to set it.

This matters for physionet-build (MIT-LCP/physionet-build#2807), which shows a physionet download command on published project pages alongside the wget command:

  • The wget command follows the server's BULK_DOWNLOAD_HOSTNAME setting, so bulk downloads can be promoted under a different hostname from the one used for browsing. The package command can't follow it.
  • Other deployments of physionet-build can't show a working package command, because it always points at physionet.org.

Proposal

Add a --base-url option to physionet download (and possibly a PHYSIONET_BASE_URL environment variable), passed through to download().

Notes:

  • The client uses the same base URL for API calls (/api/v1/) and file downloads, so the host given must serve both. Alternatively, we could take a separate option for the file host only.
  • With --source auto, open data may still come from the AWS mirror. --base-url would only change the PhysioNet host.
  • Once released, physionet-build can add --base-url to the displayed command only when BULK_DOWNLOAD_HOSTNAME is set, and note the minimum package version.
Dominant language
Python
Stars
82
Forks
22
Avg merge
1h 57m
Merged PRs (30d)
11

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

  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.

More from MIT-LCP/physionet

All issues in MIT-LCP/physionet

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.