npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

cgijs

v1.2.0

Published

`CGIJS` is an all featured library to run any `CGI` mode/`Interpreted language script` files like PHP, JS, Ruby, Python 2, Python 3, ASPX, JSP, and CGI, OR connect to any protocol or any web application server proxies, OR manage processes in the system.

Downloads

98

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 in any OS that runs node.js.
  • 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

Installation

npm install cgijs --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
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 databases]
    • [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) following web servers:
  • [x] IIS (Allows Proxy) [Done]
  • [x] Nginx (Allows Proxy) [Done]
  • [x] Apache HTTPD (Allows Proxy) [Done]
  • [x] Apache TomCat (Allows Proxy) [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 (Allows Proxy) [TODO - Testing, should work based on current testing of other proxies]
  • [x] Jetty (Allows Proxy) [TODO - Testing, should work based on current testing of other proxies]
  • [x] Putty (Allows Proxy) [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
  • [x] Other Proxy-able local/remote servers
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:
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.
  • The demos for individual implementation of file, process, proxy, and utils modules can be found in the folder demo usage [todo]
Use case:

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 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
    • PHP (.php)
    • Perl (Perl any versions - .plc, .pld, .pl)
    • Python (Python2, Python3 - .py)
    • Ruby (.rb)
    • Node.js (.js)
  • 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 file for latest TODO list

License

The MIT License (MIT) - See LICENSE for further details

Copyright © 2019 - till library works: Ganesh B [email protected]

Please support the development in github repository through

- feature needs reporting,
- testing,
- issue reporting,
- contribution

Please use these styles for contributions