<commit_before># plzvm
A utility script for working with your VirtualBox VMs on your macOS machine.

## Requirements

* [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
* [macOS](http://www.apple.com/macos/)


## Installation

Using curl:
```
$ curl https://raw.githubusercontent.com/jvs/plzvm/master/plzvm --output /usr/local/bin/plzvm
$ chmod +x /usr/local/bin/plzvm
```

Or, using git:
```
$ git clone https://github.com/jvs/plzvm.git
$ cd plzvm
$ ./plzvm install
```

To uninstall:
```
$ plzvm uninstall
```


## Commands

* plzvm start [name]
* plzvm stop [name]
* plzvm ssh [vm|user@vm]
* plzvm list vms
* plzvm list ports [vm]
* plzvm map \<port1> to [vm:]\<port2>
* plzvm unmap \<vm|localhost>:\<port>
* plzvm help


## Examples

### Starting and stopping VMs:

* `plzvm start` - Starts your default VM.
* `plzvm stop` - Stops your default VM.
* `plzvm start foo` - Starts the VM named "foo".
* `plzvm stop foo` - Stops the VM named "foo".


### Connecting to VMs:

* `plzvm ssh` - Connects to your default VM as $USER.
* `plzvm ssh foo` - Connects to the VM named "foo" as $USER.
* `plzvm ssh alice@foo` - Connects to the VM named "foo" as the user "alice".


### Listing VMs and mapped ports:

* `plzvm list vms` - Lists your available VMs.
* `plzvm list ports` - Lists the mapped ports on all your VMs.
* `plzvm list ports foo` - Lists the mapped ports on the VM named "foo".


### Mapping and unmapping ports:

* `plzvm map 8080 to 80` - Maps your Mac's port 8080 to port 80 on your default VM.
* `plzvm map 2525 to foo:25` - Maps your Mac's port 2525 to port 25 on the VM named "foo".
* `plzvm unmap localhost:8080` - Unmaps your Mac's port 8080 from one of your VM's ports.
* `plzvm unmap foo:25` - Unmaps one of your Mac's ports from port 25 on the VM named "foo".<commit_msg>Add license section to README.md<commit_after># plzvm
A utility script for working with your VirtualBox VMs on your macOS machine.

## Requirements

* [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
* [macOS](http://www.apple.com/macos/)


## Installation

Using curl:
```
$ curl https://raw.githubusercontent.com/jvs/plzvm/master/plzvm --output /usr/local/bin/plzvm
$ chmod +x /usr/local/bin/plzvm
```

Or, using git:
```
$ git clone https://github.com/jvs/plzvm.git
$ cd plzvm
$ ./plzvm install
```

To uninstall:
```
$ plzvm uninstall
```


## Commands

* plzvm start [name]
* plzvm stop [name]
* plzvm ssh [vm|user@vm]
* plzvm list vms
* plzvm list ports [vm]
* plzvm map \<port1> to [vm:]\<port2>
* plzvm unmap \<vm|localhost>:\<port>
* plzvm help


## Examples

### Starting and stopping VMs:

* `plzvm start` - Starts your default VM.
* `plzvm stop` - Stops your default VM.
* `plzvm start foo` - Starts the VM named "foo".
* `plzvm stop foo` - Stops the VM named "foo".


### Connecting to VMs:

* `plzvm ssh` - Connects to your default VM as $USER.
* `plzvm ssh foo` - Connects to the VM named "foo" as $USER.
* `plzvm ssh alice@foo` - Connects to the VM named "foo" as the user "alice".


### Listing VMs and mapped ports:

* `plzvm list vms` - Lists your available VMs.
* `plzvm list ports` - Lists the mapped ports on all your VMs.
* `plzvm list ports foo` - Lists the mapped ports on the VM named "foo".


### Mapping and unmapping ports:

* `plzvm map 8080 to 80` - Maps your Mac's port 8080 to port 80 on your default VM.
* `plzvm map 2525 to foo:25` - Maps your Mac's port 2525 to port 25 on the VM named "foo".
* `plzvm unmap localhost:8080` - Unmaps your Mac's port 8080 from one of your VM's ports.
* `plzvm unmap foo:25` - Unmaps one of your Mac's ports from port 25 on the VM named "foo".


## License

[MIT license](https://github.com/jvs/plzvm/blob/master/LICENSE) (c) 2017 jvs
{'fraction_non_alphanumeric': 0.13545601726929304, 'fraction_numerical': 0.021586616297895305, 'mean_word_length': 3.554054054054054, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 7, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4679275', 'n_tokens_mistral': 1480, 'n_tokens_neox': 1360, 'n_words': 497}