ezgitup 0.1.0

A simple tool to upload files to GitHub repositories

EZGitUp

A simple command-line tool to upload files to GitHub repositories.

Installation

pip install ezgitup

Usage

Environment Variables

You can set the following environment variables:

• GITHUB_TOKEN: Your GitHub personal access token (required)
• EZGITUP_DEPO: Repository in format "owner/repo" or GitHub URL (optional)

The EZGITUP_DEPO environment variable supports multiple formats:

• Simple format: owner/repo
• SSH URL: [e-mail]:owner/repo.git
• HTTPS URL: https://github.com/owner/repo.git

Command Line Usage

Upload single or multiple files:

# Upload single file
ezgitup path/to/file.txt

# Upload multiple files
ezgitup path/to/file1.txt path/to/file2.txt

# Upload files using wildcards
ezgitup *.json                    # All JSON files in current directory
ezgitup path/to/dir/*            # All files in a directory
ezgitup *.py *.json *.md         # Multiple file types
ezgitup test_*.py                # Files matching a pattern

# Specify repository owner and name
ezgitup --owner username --repo repository *.json
# or using short options
ezgitup -o username -r repository *.json

# Upload files to a specific directory in the repository
ezgitup --dir docs *.md          # Upload all markdown files to docs/
ezgitup -d src/data *.json       # Upload JSON files to src/data/

The tool will use the following priority for repository information:

1. Command-line arguments (--owner/--repo)
2. Environment variable (EZGITUP_DEPO)
3. Interactive prompt

If no files are specified, the tool will prompt you to enter file paths interactively. Wildcards are also supported in interactive mode.

Interactive Mode

If you don't specify any files or the EZGITUP_DEPO environment variable, the tool will guide you through the process:

ezgitup

Features

• Upload single or multiple files to GitHub repositories
• Support for wildcard patterns (e.g., *.json, test_*.py)
• Flexible repository specification:
  • Command-line options (--owner/--repo)
  • Simple owner/repo format
  • GitHub SSH URLs
  • GitHub HTTPS URLs
• Target directory support (--dir/-d)
• Environment variable configuration
• Interactive mode for user input
• Progress tracking for multiple file uploads

Requirements

• Python 3.6 or higher
• requests library

License

MIT License