fetchify

Fetch files from any GitHub repository — configurable for any user.

Installation

pip install fetchify

Quick Start

Module-level API (simple scripts)

import fetchify

# Configure once with your GitHub username
fetchify.configure("your-github-username")

# Register repo aliases
fetchify.add_repo("py", "Python_Projects")
fetchify.add_repo("web", "my-web-app")

# Fetch a file (returns text)
content = fetchify.fetch("main.py", "py")
print(content)

# Save it to disk
fetchify.save(content, "main.py")

Class API (recommended for larger projects)

from fetchify import Fetchify

f = Fetchify(username="your-github-username")

# Register multiple repos at once
f.add_repos({
    "py":  "Python_Projects",
    "web": "my-web-app",
    "ds":  "DataSense",
})

# Fetch a file from the default branch (main)
code = f.fetch("utils.py", "py")

# Fetch from a specific branch
code_dev = f.fetch("utils.py", "py", branch="dev")

# Fetch an image / binary file
img_bytes = f.fetch("logo.png", "web", image=True)
fetchify.save(img_bytes, "logo.png")

Private Repositories

Pass a GitHub Personal Access Token (PAT) to access private repos:

from fetchify import Fetchify

f = Fetchify(
    username="your-github-username",
    token="ghp_your_token_here"
)
f.add_repo("private", "my-private-repo")
content = f.fetch("secret.py", "private")

Tip: Store your token in an environment variable — never hardcode it.

import os
f = Fetchify(username="...", token=os.getenv("GITHUB_TOKEN"))

API Reference

Fetchify(username, token=None, default_branch="main")

Create a new Fetchify instance.

f.add_repo(alias, repo_name) → self

Register a single repo alias.

f.add_repos(repo_dict) → self

Register multiple aliases from a dict. Supports method chaining.

f.list_repos() → dict

Returns the registered alias → repo-name mapping.

f.fetch(filename, repo, branch=None, image=False) → str | bytes

Fetch a file from GitHub.

f.fetch_raw(url, image=False) → str | bytes

Fetch from an arbitrary raw GitHub URL directly.

fetchify.save(content, name, mode=None)

Save fetched content to a local file. Auto-detects text vs binary.

fetchify.configure(username, token=None, default_branch="main")

Set up the module-level default instance (for the simple API).

Error Handling

from fetchify import Fetchify, FetchError, RepoNotFoundError

f = Fetchify("my-username")
f.add_repo("py", "Python_Projects")

try:
    content = f.fetch("nonexistent.py", "py")
except FetchError as e:
    print(f"Could not fetch file: {e}")

Migration from v2.x

License

MIT © Anupam Kanoongo