Metadata-Version: 2.1
Name: nssurge-cli
Version: 2.0.11
Summary: NSSurge CLI
Home-page: https://github.com/tddschn/nssurge-cli
License: MIT
Keywords: nssurge,cli,surge,typer
Author: Xinyuan Chen
Author-email: 45612704+tddschn@users.noreply.github.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Utilities
Requires-Dist: nssurge-api (>=0.2.14,<0.3.0)
Requires-Dist: rich[format] (>=12.4.1,<13.0.0)
Requires-Dist: typer (>=0.9.0,<0.10.0)
Requires-Dist: utils-tddschn (>=0.1.5,<0.2.0)
Project-URL: Bug Tracker, https://github.com/tddschn/nssurge-cli/issues
Project-URL: Repository, https://github.com/tddschn/nssurge-cli
Description-Content-Type: text/markdown

# NSSurge CLI

Command line [Surge HTTP API](https://manual.nssurge.com/others/http-api.html) Client

You can use it to get/set Surge rules / policies / proxy groups, get recent requests / events and much more. 

This projects fully implements the [Surge HTTP API spec](https://manual.nssurge.com/others/http-api.html).

- [NSSurge CLI](#nssurge-cli)
  - [Installation](#installation)
    - [pipx](#pipx)
    - [pip](#pip)
  - [Usage](#usage)
    - [Screenshots](#screenshots)
  - [Develop](#develop)
  - [See also](#see-also)

## Installation

### pipx

This is the recommended installation method.

```
$ pipx install nssurge-cli
```

### [pip](https://pypi.org/project/nssurge-cli/)

```
$ pip install nssurge-cli
```

## Usage

```
nssurge-cli --help
```

![](./screenshots/usage.png)

### Screenshots

```
nssurge-cli cap
```
![](./screenshots/cap.png)

## Develop

```
$ git clone https://github.com/tddschn/nssurge-cli.git
$ cd nssurge-cli
$ poetry install
```

## See also

- [nssurge-api](https://github.com/tddschn/nssurge-api): Python implementation of the [Surge HTTP API spec](https://manual.nssurge.com/others/http-api.html) client using `aiohttp`, used by this project
- [Surge HTTP API spec](https://manual.nssurge.com/others/http-api.html)
