Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: update issue templates #7

Merged
merged 4 commits into from
Aug 4, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .github/ISSUE_TEMPLATE/blank-📄.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: "Blank \U0001F4C4"
about: Describe your issue
title: ''
labels: ''
assignees: ''
---
35 changes: 35 additions & 0 deletions .github/ISSUE_TEMPLATE/bug-report-🕵🏻.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
name: "Bug report \U0001F575\U0001F3FB"
about: Create a report to help improve SVPS
title: ''
labels: ''
assignees: ''
---

### 🌧️ What's wrong?

> Describe the issue

---

### 🧙🏻 Reproducing

> It's easier to follow and solve the issue if ew can reproduce it

---

### 🖥️ Environment

- **OS**
- [ ] Linux
- [ ] Mac (Intel)
- [ ] Mac (M1/2)
- [ ] Windows
- [ ] Other:
- **SVPS version:**
- ...
- **Node.js version**
- [ ] 16.x
- [ ] 18.x
- [ ] 20.x
- [ ] Other:
6 changes: 3 additions & 3 deletions .github/assets/readme/license.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 0 additions & 1 deletion .github/assets/readme/node.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ You will need these tools installed on your system:

## Developing

Fork this project, download your forked repository locally and create a new branch.
Fork this project, download your forked repository locally and create a new branch from `main`.
Then running `npm ci` to install the dependecies from _package-lock.json_.

---
Expand Down
45 changes: 25 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
<div align="center">
<h1>SVPS - Simplifying VPS</h1>
<p>🚀 An easier tool to automate your <b>Ubuntu Server</b> setup and domain forwarding</p>
<img src="https://img.shields.io/npm/v/svps?style=flat" alt="npm">
<img src="https://img.shields.io/github/actions/workflow/status/wellwelwel/svps/ci.yml?event=push&style=flat&label=ci&branch=main" alt="GitHub Workflow Status (with event)">
<img src="https://img.shields.io/npm/dt/svps?style=flat" alt="npm">
<a href="https://www.npmjs.com/package/svps"><img src="https://img.shields.io/npm/v/svps?style=flat" alt="npm"></a>
<a href="https://github.com/wellwelwel/svps/actions/workflows/ci.yml?query=branch%3Amain"><img src="https://img.shields.io/github/actions/workflow/status/wellwelwel/svps/ci.yml?event=push&style=flat&label=ci&branch=main" alt="GitHub Workflow Status (with event)"></a>
<a href="https://www.npmjs.com/package/svps"><img src="https://img.shields.io/npm/dt/svps?style=flat" alt="npm"></a>
<a href="https://github.com/wellwelwel/svps/blob/main/LICENSE"><img src="https://raw.githubusercontent.com/wellwelwel/svps/main/.github/assets/readme/license.svg" alt="License"></a>
</div>

## Table of Contents
Expand All @@ -21,13 +22,12 @@
- [Advanced Usage](#advanced-usage-manual)
- [Turning **VPS Server** into **Desktop Server** (**RDP**)](#turning-vps-server-into-desktop-server-rdp)
- [Testing using a **Docker** Container](#testing-using-a-docker-container)
- [Close the Connection](#close-the-connection)
- [Important](#important)
- [Known Issues](#known-issues)
- [Compatibility](#compatibility)
- [License](#license)
- [Community](#community)
- [Contributing](#contributing)
- [Credits](#credits)

---

Expand All @@ -37,7 +37,7 @@

It supports command automation, files and directories upload via **SFTP**, automatic installations and configurations, domain forwarding, local text files and template strings into _escaped quoted strings_ for dynamic remote file creation, among other features.

All this, using just a single one connection 🧙🏻✨
All this, using just a _single one_ connection 🧙🏻✨

---

Expand All @@ -52,13 +52,24 @@ All this, using just a single one connection 🧙🏻✨
```js
import { SVPS } from 'svps';

/** Prepare the connection */
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: 'root',
password: 'root',
},
});

/** Available methods
* svps.mount
* svps.commands
* svps.createVirtualHosts
* svps.upload
* svps.end
*
* See about each below 🕵🏻
*/
```

---
Expand Down Expand Up @@ -262,6 +273,14 @@ await svps.mount({

---

### Close the Connection

```js
await svps.end();
```

---

## Important

- This package is designed for pre-built **VPS**, **KVM** and **Ubuntu Server** `>=18.04`
Expand All @@ -288,12 +307,6 @@ await svps.mount({

---

### License

[![License](/.github/assets/readme/license.svg)](/LICENSE)

---

## Community

I'm continuously working to improve **SVPS**. If you've got something interesting to share, feel free to submit a [**Pull Request**](https://github.com/wellwelwel/svps/compare). If you notice something wrong, I'd appreciate if you'd open an [**Issue**](https://github.com/wellwelwel/svps/issues/new).
Expand All @@ -303,11 +316,3 @@ I'm continuously working to improve **SVPS**. If you've got something interestin
### Contributing

Please check the [_CONTRIBUTING.md_](./CONTRIBUTING.md) for instructions 🚀

---

### Credits

| Contributors | GitHub |
| ------------ | --------------------------------------------------------------------------------- |
| Author | [![wellwelwel](/.github/assets/readme/author.svg)](https://github.com/wellwelwel) |
4 changes: 2 additions & 2 deletions examples/commands/ssh-welcome-message/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ const quotedBashrc = escapeQuotes(bashrc);
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

Expand Down
4 changes: 2 additions & 2 deletions examples/crontab/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

Expand Down
46 changes: 0 additions & 46 deletions examples/default/index.ts

This file was deleted.

4 changes: 2 additions & 2 deletions examples/desktop/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

Expand Down
6 changes: 3 additions & 3 deletions examples/ftp/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,16 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

await svps.mount({
users: [
{
name: 'support',
password: String(process.env.SUPPORT_PASS),
password: 'support-password',
ftp: {
/** default options */
directory: '/home/support',
Expand Down
8 changes: 4 additions & 4 deletions examples/mysql/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

Expand All @@ -27,12 +27,12 @@ await svps.mount({
{
host: '127.0.0.1',
name: 'local_user',
pass: String(process.env.DB_PASS),
pass: 'local_user-passowrd',
},
{
host: '192.168.0.1',
name: 'external_user',
pass: String(process.env.DB_PASS),
pass: 'external_user-password',
},
],
},
Expand Down
6 changes: 3 additions & 3 deletions examples/node/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,16 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

await svps.mount({
users: [
{
name: 'manager',
password: String(process.env.MANAGER_PASS),
password: 'manager-password',
sftp: {
chRoot: '/home/manager',
chUser: '/home/manager/apps',
Expand Down
6 changes: 3 additions & 3 deletions examples/php/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,16 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

await svps.mount({
users: [
{
name: 'manager',
password: String(process.env.MANAGER_PASS),
password: 'manager-password',
sftp: {
chRoot: '/var/www',
chUser: '/var/www/domains',
Expand Down
4 changes: 2 additions & 2 deletions examples/rsa/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

Expand Down
6 changes: 3 additions & 3 deletions examples/sftp/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,16 @@ import { SVPS } from '../../lib/index.js';
const svps = new SVPS({
access: {
host: '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
username: 'root',
password: 'root',
},
});

await svps.mount({
users: [
{
name: 'support',
password: String(process.env.SUPPORT_PASS),
password: 'support-password',
sftp: {
/** default options */
mask: '077',
Expand Down
7 changes: 3 additions & 4 deletions examples/upload/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,9 @@ import { SVPS } from '../../lib/index.js';

const svps = new SVPS({
access: {
host: process.env?.HOST || '127.0.0.1',
username: String(process.env.USER),
password: process.env.PASS,
port: Number(process.env.PORT) || 22,
host: '127.0.0.1',
username: 'root',
password: 'root',
},
});

Expand Down
Loading