Metadata-Version: 2.1
Name: ghapi-conversion
Version: 0.0.7
Summary: CLI to replace HTTP GET on GitHub API with clones
Home-page: UNKNOWN
Author: Samuel Marks
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved
Classifier: License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation
Classifier: Topic :: Software Development
Description-Content-Type: text/markdown

GHAPI-conversion
================
![Python version range](https://img.shields.io/badge/python-2.7%20|%203.5%20|%203.6%20|%203.7%20|%203.8%20|%203.9%20|%203.10a5-blue.svg)
[![License](https://img.shields.io/badge/license-CC0-blue.svg)](https://creativecommons.org/publicdomain/zero/1.0)
[![Linting, testing, coverage, and release](https://github.com/offscale/GHAPI-conversion/workflows/Linting,%20testing,%20coverage,%20and%20release/badge.svg)](https://github.com/offscale/GHAPI-conversion/actions)
![Tested OSs, others may work](https://img.shields.io/badge/Tested%20on-Linux%20|%20macOS%20|%20Windows-green)
![Documentation coverage](https://raw.githubusercontent.com/offscale/GHAPI-conversion/master/.github/doccoverage.svg)
[![codecov](https://codecov.io/gh/offscale/GHAPI-conversion/branch/master/graph/badge.svg)](https://codecov.io/gh/offscale/GHAPI-conversion)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
[![PyPi: release](https://img.shields.io/pypi/v/ghapi-conversion.svg?maxAge=3600)](https://pypi.org/project/ghapi-conversion)

CLI to replace HTTP GET on GitHub API with clones.

## Why

In GitHub Actions the macOS machines share the same IP range, meaning that users will come against the GitHub quota often. https://github.com/actions/virtual-environments/issues/602

To overcome this issue, use this tool instead of `pip install -r`. This tool `clone`s rather than `GET`s:

  - `https://api.github.com/repos/<org>/<repo>/zipball#egg=<package_name>`
  - `https://raw.githubusercontent.com/<org>/<repo>/<branch>/<file>`

Additionally, it reuses already cloned repos.

## Install package

### PyPi

    pip install ghapi-conversion

## Development

### Install dependencies

    pip install -r requirements.txt
    # On Python 2.7, `pip install mock` in order to run the tests without error

### Install package

    pip install -e .

## Usage

    $ python -m ghapi_conversion --help

    usage: __main__.py [-h] [--version] (-r FILE | -l LINK)

    CLI to replace HTTP GET on GitHub API with clones

    optional arguments:
      -h, --help            show this help message and exit
      --version             show program's version number and exit
      -r FILE, --requirement FILE
                            Install from the given requirements file. This option
                            can be used multiple times.
      -l LINK, --link LINK  Clone instead of HTTPS GET a
                            `https://api.github.com/repos/<org>/<repo>/zipball` or
                            `https://raw.githubusercontent.com/<org>/<repo>/<branch
                            >` link.

## Alternatives

  - Manually replace current setup with clones, non GitHub API—or authed—hosted alternatives
  - Pack dependencies and download and extract this archive from non GitHub API—or authed—hosted alternative
  - Seamlessly do what `ghapi_conversion` does, by self-hosting a proxy server

---

## License

CC0.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the CC0 license, shall be
licensed under CC0, without any additional terms or conditions.


