Metadata-Version: 2.4
Name: nssurge-cli
Version: 3.1.1
Summary: NSSurge CLI
Project-URL: Homepage, https://github.com/tddschn/nssurge-cli
Project-URL: Repository, https://github.com/tddschn/nssurge-cli
Project-URL: Bug Tracker, https://github.com/tddschn/nssurge-cli/issues
Author-email: Xinyuan Chen <45612704+tddschn@users.noreply.github.com>
License: MIT
License-File: LICENSE
Keywords: cli,nssurge,surge,typer
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: nssurge-api>=1.0.1
Requires-Dist: rich>=14.3.2
Requires-Dist: typer>=0.24.0
Requires-Dist: utils-tddschn>=1.0.4
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)