1.0.1 • Published 4 months ago

repo2docx v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
4 months ago

repo2docx

Convert GitHub repositories to DOCX documents with filenames in bold and underlined.

Features

  • Downloads any public GitHub repository and converts it to a single DOCX file
  • Each filename appears in bold + underlined at the start of its content
  • Accepts GitHub URLs or owner/repo format
  • Skips binary files and common directories like node_modules
  • Supports private repositories with a GitHub token
  • Command-line interface for easy usage

Installation

npm install -g repo2docx

Usage

Command Line

# Basic usage with owner/repo format
repo2docx microsoft/vscode

# Basic usage with URL format
repo2docx https://github.com/microsoft/vscode

# Specify output file
repo2docx microsoft/vscode -o vscode-docs.docx

# Specify branch
repo2docx microsoft/vscode -b development

# Use GitHub token for private repos
repo2docx yourusername/private-repo -t your-github-token

# Get help
repo2docx --help

API

const { repo2docx } = require('repo2docx');

// Basic usage with owner/repo format
repo2docx('microsoft/vscode')
  .then(filePath => console.log(`DOCX created at ${filePath}`))
  .catch(err => console.error(err));

// Basic usage with URL format
repo2docx('https://github.com/microsoft/vscode')
  .then(filePath => console.log(`DOCX created at ${filePath}`))
  .catch(err => console.error(err));

// With options
repo2docx('microsoft/vscode', 'output.docx', {
  branch: 'development',
  token: 'your-github-token',
  ignorePaths: ['node_modules', '.git', 'build']
})
  .then(filePath => console.log(`DOCX created at ${filePath}`))
  .catch(err => console.error(err));

Options

OptionDescriptionDefault
repoIdentifierGitHub repository URL or owner/repo format(required)
outputPathPath where to save the DOCX file${owner}-${repo}.docx
options.tokenGitHub personal access token for private reposprocess.env.GITHUB_TOKEN
options.branchBranch to download'main'
options.ignorePathsPaths to ignore['node_modules', '.git']

Requirements

  • Node.js >= 14.0.0

License

MIT

Contributing

Contributions welcome! Please feel free to submit a Pull Request.