Metadata-Version: 2.4
Name: clipinstall
Version: 0.0.4
Summary: Install packages through clipboard.
Project-URL: Documentation, https://github.com/Chitaoji/clipinstall/blob/main/README.md
Project-URL: Repository, https://github.com/Chitaoji/clipinstall/
Author-email: Chitaoji <2360742040@qq.com>
Maintainer-email: Chitaoji <2360742040@qq.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: config
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Requires-Dist: click
Description-Content-Type: text/markdown

# clipinstall
Install packages on an offline machine through clipboard.

## Installation
```sh
$ pip install clipinstall
```

## Requirements
```txt
click
```

## Usage
```sh
# 1) Download the package and copy it to clipboard on an online machine
clipin copy requests==2.32.3

# Optional: download with dependencies
clipin copy requests==2.32.3 --deps

# Local build mode: if PACKAGE_SPEC is a folder, run install.py in it and copy
# the newest wheel under dist/
clipin copy /path/to/your/project

# 2) Restore wheels from clipboard and install them on the target machine
clipin install

# Optional: specify the temp dir to store .whl files, the temp dir will be removed after 
# successful installation
clipin install --dir temp

# Optional: don't remove the temp files after installation
clipin install --no-clean

# 3) Restore wheels from clipboard only (without installation)
clipin paste

# Optional: specify the dir to store .whl files
clipin paste --dir temp
```

## See Also
### Github repository
* https://github.com/Chitaoji/clipinstall/

### PyPI project
* https://pypi.org/project/clipinstall/

## License
This project falls under the BSD 3-Clause License.

## History
### v0.0.4
* Bugfix for `v0.0.3`.

### v0.0.3
* Removed `__version__`, use `importlib.metadata.version(__name__)` instead.

### v0.0.2
* Local build mode: can download from local folder now.
* `clipin install`:
    * New option `--force/--no-force` to reinstall the package if exists.

### v0.0.1
* New subcommand `clipin paste` to restore wheels from clipboard only (without installation).
* `clipin install`: 
    * renamed option `--temp-dir` to `--dir` for convenience.
    * new option `--clean/--no-clean` to determine whether temp files should be removed after installation.

### v0.0.0
* Initial release.