An open API service indexing awesome lists of open source software.

https://github.com/cgi-js/cgi-js

Run cgi / interpreted script files that supports command line execution, or connect to cgi / other server proxies : npm install cgijs --save
https://github.com/cgi-js/cgi-js

apache-httpd apache-tomcat aspx cgi cgi-js cgi-server cgijs desktop-app desktop-cgi electron embedded-server interpreted-languages jsp mongoose nginx php proxy-server python ruby

Last synced: 21 days ago
JSON representation

Run cgi / interpreted script files that supports command line execution, or connect to cgi / other server proxies : npm install cgijs --save

Awesome Lists containing this project

README

        

# cgijs

*`CGIJS` is a all featured library to run any `CGI` mode / `Interpreted language script` files, or connect to any web application server proxies, or manage processes in the system.*

`CGIJS` library:

- Supports running any `CGI` / `Interpreted Language scripts` using the nodejs process module in `any OS` that runs `node.js`. Needs the language interpretor to be installed in the system
- [TODO] Supports running any `CGI` / `Interpreted Language scripts` using interpreters library module in `any OS` that runs `node.js`. Do not need the language interpretor to be installed in the system
- Supports both `CGI` executables as well as `proxy` to `localhost`/ `remote` /`embedded servers` using proxying of multiple protocols (`http`, `websockets`, `tcp`, `udp`, `socks`, `ssh`, `ftp`).
- Supports managing processes like `embedded` `server` executables, embedded `database` executables, or `any other` embedded/ non-embedded executables
- Supports working with `shell`, `json`, `ini`, `csv`, `yaml`, and `xml` internally

`[Funding Invited]`

*General Note: The library is production ready. However, please be cautious of processes/executables permissions/security in your project using CGIJS*

# History

CGIJS was created with a motivation to allow creation of a `Desktop executable/ application` using `Electron` that can run any `CGI` / `Interpreted language scripted files/ applications` under the hood.

[![Desktop CGI](./desktop-cgi.jpeg)](https://github.com/desktop-cgi/desktop-cgi)

# Installation

```
npm install cgijs --save
```

If you wish to run interpreted languages like `php`, `perl`, `python`, `micropython`, `cpython`, `ruby`, `julia`, `cpp`, `golang`, `ocaml`, `lua`, `napi`, `wasm-run`, `r-lang`, `openssl` with `wasm files` without having the language's binary present/ installed in your system then use the following package.

```
npm install bridge-wasm --save
```

# Features

*Light weight, Flexible, Generic implementation. CGIJS is Nodejs `Framework Independent / agnostic` for application development.*

There are three main modules inside CGIJS - `file` for CGI file execution, `proxy` for running proxies, and `process` for managing processes.

#### **SECURITY NOTE**:

- The process shell module is security agnostic and is dependant on your code.
- The package accesses the shell to run script executables using the node.js process module. Please consider your `security risks based on your executable's/ script's security risks`.
- The proxy module is security agnostic and is dependant on your code and proxy's security.
- The `package has a LAN or WAN network proxy module AND does not create any proxies` by its own - unless specified by you. Please consider your custom created proxy's security risks.
- The `package does not use Telemetry, nor Collect data Remotely, nor has Telemetry/Remote based Error collection` on its own.
- The package propogates errors for you to handle or collect errors/ data.

# Library Features

##### Node CGI Embedded - run interpreted scripts that support cgi using nodejs

* [x] CGI file execution
- [x] Run any scripts that support CGI based serving/execution
- [x] Run multiple CGI executables/ Interpreters in one or multiple applications
- [x] Embed your own CGI/ Interpreted Language executables
- [x] Runs scripts with language interpretor binary (like php, python, ruby, etc) in your system
- [x] Runs scripts without language interpretor binary (like php, python, ruby, etc) in your system using their wasm packages

##### Node Web Proxy - run web proxies

* [x] Running Proxies
- [x] Run any host that serves a web app, using proxy
- [x] Run proxies for Application (Local / Remote)
- [x] Supports websocket implementation in web proxies
- [x] Run multiple protocol proxies (HTTP, UDP, TCP, Websockets, Socks) and multiple instances in one or multiple applications

##### Node Processes - Manage web servers, database processes, or other system processes or services

* [x] Manage Processes or Services
- [x] Allows running and closing process Executables
- [x] Allows managing Embedding Web Servers, which can run web applications through proxies [Todo] Testing for some embeddable servers
- [x] Allows managing Embedded Database servers [Todo] Testing for some embeddable servers
- [x] Should run smoothly with Unsupported proxy servers/ processes/ services (not widely tested)
* [x] Embedding
- [x] Multiple web servers in one or multiple applications
- [x] Multiple databases in one or multiple applications

# Functionality Details

##### The script should support piping all files of below interpreted languages:

* [x] Python (2.x, 3.x) - `py` (for Python .py extension files. Needed for *nix systems)
* [x] Perl (Version Independent) - `plc`, `pld`, `pl` (for Perl .pl, .plc, .pld extension files)
* [x] PHP (Version Independent) - `php` (for .php extension files)
* [x] Ruby (Version Independent) - `rb` (for Ruby .rb extension files)
* [x] Node.js (Version Independent) - `js` (for Node.js .js extension files)
* [x] CGI - `cgi` (for CGI .cgi extension files) [Todo Testing]

##### The script should support piping all proxies of above languages and following:

* [x] Jsp (With Tomcat, or any webserver as proxy)
* [x] Aspx (With IIS, Apache, or any webserver as proxy)
* [] Jsp (With Tomcat embedded) [Todo]
* [] Aspx (With Nginx and Apache embedded) [Todo]

##### The script currently allows working with (starting, stopping, restarting using bash, bat scripts) following web servers:

* [x] IIS [Done]
* [x] Nginx [Done]
* [x] Apache HTTPD [Done]
* [x] Apache TomCat [Done]
* [x] Nginx (Allows Embed) [Done]
* [x] Apache HTTPD (Allows Embed) [Done]
* [x] Apache TomCat (Allows Embed) [Todo - Testing], should work based on current testing of other proxies
* [x] Mongoose [Todo - Testing], should work based on current testing of other proxies
* [x] Jetty [Todo - Testing], should work based on current testing of other proxies
* [x] Putty [Todo - Testing], should work based on current testing of other proxies
* [] Mongoose (Allows Embed) [Todo - Testing]
* [] Jetty (Allows Embed) [Todo - Testing]
* [x] Putty (Allows Embed) [Todo - Testing]
* [x] PHP development server using `php -S`
* [x] Ruby development server using `rails server` [Todo - Testing]
* [x] Python development server using `py -m http.server`
* [] Other Proxy-able local/remote servers [InProgress]

##### The script currently allows working with (starting, stopping, restarting proxies) following web servers:

* [x] IIS [Done]
* [x] Nginx [Done]
* [x] Apache HTTPD [Done]
* [x] Apache TomCat [Done]
* [x] Nginx (Allows Embed) [Done]
* [x] Apache HTTPD (Allows Embed) [Done]
* [x] Apache TomCat (Allows Embed) [Todo - Testing], should work based on current testing of other proxies
* [x] Mongoose [Todo - Testing], should work based on current testing of other proxies
* [x] Jetty [Todo - Testing], should work based on current testing of other proxies
* [x] Putty [Todo - Testing], should work based on current testing of other proxies
* [] Mongoose (Allows Embed) [Todo - Testing]
* [] Jetty (Allows Embed) [Todo - Testing]
* [x] Putty (Allows Embed) [Todo - Testing]
* [x] PHP development server using `php -S`
* [x] Ruby development server using `rails server` [Todo - Testing]
* [x] Python development server using `py -m http.server`
* [] Other Proxy-able local/remote servers [InProgress]

##### The script currently allows working with (starting, stopping, restarting) following web servers:

* [x] IIS [Done]
* [x] Nginx [Done]
* [x] Apache HTTPD [Done]
* [x] Apache TomCat [Done]
* [x] Nginx [Done]
* [x] Apache HTTPD [Done]
* [x] Apache TomCat [Todo - Testing], should work based on current testing of other proxies
* [x] Mongoose [Todo - Testing], should work based on current testing of other proxies
* [x] Jetty [Todo - Testing], should work based on current testing of other proxies
* [x] Putty [Todo - Testing], should work based on current testing of other proxies
* [] Mongoose (Allows Embed) [Todo - Testing]
* [] Jetty (Allows Embed) [Todo - Testing]
* [x] Putty (Allows Embed) [Todo - Testing]
* [x] PHP development server using `php -S`
* [x] Ruby development server using `rails server` [Todo - Testing]
* [x] Python development server using `py -m http.server`
* [] Other Proxy-able local/remote servers [InProgress]

##### The script currently allows working with (starting, stopping, restarting) following databases and processes:

* [x] Mysql [Done]
* [x] MongoDB [Done]
* [] PgSQL [Todo]
* [] Redis [Todo]
* [x] bash, bat, ps scripts [Done]
* [x] Other Processes for your application support

##### Note:

*This library is in active development. Issues, and feedbacks as github ticket are welcome.*

##### Package Dependencies:

* Environment and Library dependencies:
- Nodejs: (> 8.x),
- [http-proxy](https://www.npmjs.com/package/http-proxy) for http-proxy support,
- [socks](https://www.npmjs.com/package/socks) for socks support,
- [udp-proxy](https://www.npmjs.com/package/udp-proxy) for udp support,
- [ssh2](https://www.npmjs.com/package/ssh2) for ssh2, ssh, ftp, sftp support,
- [socket-proxy](https://www.npmjs.com/package/socket-proxy) for socket proxy,
- [http-proxy-to-socks](https://www.npmjs.com/package/http-proxy-to-socks) for http to socks proxy,
- [csv](https://www.npmjs.com/package/csv) for file parser,
- [xml-js](https://www.npmjs.com/package/xml-js) for xml file parser,
- [yaml](https://www.npmjs.com/package/yaml) for yaml file parser,
- [ini](https://www.npmjs.com/package/ini) for ini file parser,
- [dotenv](https://www.npmjs.com/package/dotenv) for dotenv file parser,
- [shelljs](https://www.npmjs.com/package/shelljs) for support with shell
- [concurrency.js](https://www.npmjs.com/package/concurrency.js) for concurrency and parallelization support for threads and processes

* Extra needed dependencies to use language interpretors and libraries for `php`, `perl`, `python`, `micropython`, `cpython`, `ruby`, `julia`, `cpp`, `golang`, `ocaml`, `lua`, `napi`, `wasm-run`, `r-lang`, `openssl` with `wasm files` without having to install (or have) binaries in your system
- [bridge-wasm](https://www.npmjs.com/package/bridge-wasm) for running interpreted languages with wasm without having the binary in your system (installed/ present).

* Application Dependencies:
- Your app, you decide
- Example/Demo has "express": "^4.17.1"
- Alternatively, Use any other Nodejs framework you want to use for your app

##### Usage Demo:

This project contains example that demonstrates working with ExpressJS.

- The demos for runing CGI/Interpreted scripts with node.js and express applications can be found in the folder [demo app](https://github.com/cgi-js/cgi-js/tree/main/demo/demo-app).
- The demos for individual implementation of file, process, proxy, and utils modules can be found in the folder [demo usage [todo]](https://github.com/cgi-js/cgi-js/tree/main/demo)

##### Use case:

[cgijs](https://www.npmjs.com/package/cgijs) library has been created to address following use cases:

- working with CGI / interpreted languages from `any` Node.js app framework
- using any CGI / interpreted languages apps with electron as demonstrated in functioning [desktop-cgi](https://github.com/desktop-cgi/desktop-cgi) app

# Technical Specifications

... * Wiki links to be added

### Wiki

* Getting started
- Quick demo - CGI mode executable files
- Quick demo - proxying to proxies/servers
- Quick demo - proxying to proxy's websocket
- Quick demo - proxying to udp, socks, http to socks proxy's websocket
* Run CGI files using process module and binaries in the system
- PHP (.php)
- Perl (Perl any versions - .plc, .pld, .pl)
- Python (Python2, Python3 - .py)
- Ruby (.rb)
- Node.js (.js)
* Run CGI files using cgi-js` `wasm` module
- PHP (.php)
- Perl (Perl any versions - .plc, .pld, .pl)
- Python (Python2, Python3 - .py)
- Ruby (.rb)
- Lua (.)
- Rust (.)
- GoLang (.go)
- CPython (.py)
- Julia (.)
- R-Lang (.)
* Run Proxy servers to connect to:
- Any Local http/https/websocket Servers
- Any Remote http/https/websocket Servers
- Embedded Apache httpd, Apache tomcat, Nginx (http/https/websocket)
- Embedded Mongoose http server (http/https)
* Manage Embedded Servers (for desktop-cgi use case):
- Embedded Apache httpd (http/https/websocket)
- Embedded Apache tomcat (http/https/websocket)
- Embedded Mongoose http server (http/https)
- Embedded Nginx (http/https/websocket)
- PHP inbuilt web development servers
- Ruby inbuilt web development servers
- Python inbuilt web development servers
* Manage Embedded Database Servers (for desktop-cgi use case):
- Embedded Mysql
- Embedded MongoDB
- Embedded PgSQL
- Working with SQLite
* Manage Processes (for desktop-cgi use case):
- Other Processes or executable workings
* Run and Manage embedded or non-embedded executables / processes on need for application
* Working with config.json file for simpler implementation in apps

# Current Status

* In development [Testing for Desktop-CGI use case]
* In development [Testing for language based development server]

# Todo

Check [.todo](https://github.com/cgi-js/cgi-js/blob/main/.todo) file for latest TODO list

# License

The MIT License (MIT) - See [LICENSE](https://github.com/cgi-js/cgi-js/blob/main/LICENSE) for further details

Copyright © 2019 - till library works:
Ganesh B

#### Please support the development in github repository through
- feature needs reporting,
- testing,
- issue reporting,
- contribution

Please use these [styles](https://github.com/cgi-js/cgi-js/issues/13) for contributions