Metadata-Version: 2.1
Name: offvsix
Version: 0.1.2
Summary: Visual Studio Code Extension Downloader for offline usage
Home-page: https://github.com/exaluc/offvsix
Author: Lucian BLETAN
Author-email: neuraluc@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: click (>=8.1.7,<9.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Project-URL: Repository, https://github.com/exaluc/offvsix
Description-Content-Type: text/markdown

# offvsix: Offline Visual Studio Code Extension Downloader

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

`offvsix` is a Python CLI utility designed to streamline the process of downloading Visual Studio Code extensions for offline installations. Whether you're preparing for a coding session without internet access or simply want to keep your favorite extensions handy, `offvsix` has you covered!

## Features

- Download specific versions of extensions.
- Download extensions to a custom directory.
- Use a proxy server for downloading.
- Avoid redundant downloads with optional caching.
- Get detailed logs with verbose mode.
- **Bulk download**: Supply a text file with a list of extensions to download them all at once!

## Installation

You can install the package from PyPI:

```bash
pip install offvsix
```

Or for offline installation, download the wheel file and run:

```bash
pip install offvsix-<version>.whl
```

## Usage

### Basic usage:

```bash
offvsix <publisher.extension>
```

For example:

```bash
offvsix ms-python.python
```

### Using a Text File:

To download multiple extensions, you can use a text file where each line is an extension name:

```bash
offvsix --file extensions.txt
```

### Options:

- `--version` to specify the version.
- `--destination` to specify the destination folder.
- `--no-cache` to force re-download.
- `--no-verbose` for less verbose output.
- `--file` to specify a text file containing a list of extensions to download.
- `--proxy` to use a proxy server.

## Contributing

All contributions are welcome! Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

MIT Licensed. See [LICENSE](LICENSE) for full details.

## Author

- [exaluc](https://github.com/exaluc)
