killport 0.6.0

A command-line tool to easily kill processes running on a specified port.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

# killport

`killport` is a command-line utility for killing processes listening on specific ports. It's designed to be simple, fast, and effective. The tool is built with Rust and works on Linux and macOS.

## Features

- Kill processes by port number
- Supports multiple port numbers
- Verbosity control
- Works on Linux and macOS

## Installation

### Easiest Way

Run the following command to automatically download and install `killport`:

```sh
curl -sL https://bit.ly/killport | sh
```

Don't forget to add `$HOME/.local/bin` to your `PATH` environment variable, if it's not already present.

### From Source

1. Install Rust: Follow the [official Rust installation guide](https://www.rust-lang.org/tools/install) to set up Rust on your system.
2. Clone the repository:

   ```sh
   git clone https://github.com/jkfran/killport.git
   ```

3. Change to the killport directory:

   ```sh
   cd killport
   ```

4. Build and install the binary:

   ```sh
   cargo build --release
   cp target/release/killport $HOME/.local/bin/
   ```

### Binary Releases

You can download the binary releases for different architectures from the [releases page](https://github.com/jkfran/killport/releases) and manually install them.

## Usage

```sh
killport [FLAGS] <ports>...
```

### Examples

Kill a single process listening on port 8080:

```sh
killport 8080
```

Kill multiple processes listening on ports 8045, 8046, and 8080:

```sh
killport 8045 8046 8080
```
### Flags

-v, --verbose
    Increase the verbosity level. Use multiple times for more detailed output.

-h, --help
    Display the help message and exit.

-V, --version
    Display the version information and exit.

## Contributing

We welcome contributions to the killport project! Before you start, please read our [Code of Conduct](CODE_OF_CONDUCT.md) and the [Contributing Guidelines](CONTRIBUTING.md).

To contribute, follow these steps:

1. Fork the repository on GitHub.
2. Clone your fork and create a new branch for your feature or bugfix.
3. Make your changes, following our coding guidelines.
4. Add tests for your changes and ensure all tests pass.
5. Commit your changes, following our commit message guidelines.
6. Push your changes to your fork and create a pull request.

We'll review your pull request and provide feedback or merge your changes.

## License

This project is licensed under the [MIT License](LICENSE). See the LICENSE file for more information.