Skip to content

Commit

Permalink
Merge pull request #55 from pylonide/development
Browse files Browse the repository at this point in the history
v2.3.0
  • Loading branch information
exsilium authored Oct 26, 2018
2 parents cb89ce4 + bb7a3b5 commit 87d308b
Show file tree
Hide file tree
Showing 9 changed files with 180 additions and 228 deletions.
5 changes: 5 additions & 0 deletions History.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
v2.3.0
======
* Renaming the project to Pylon IDE - Minimum set of changes #48
* Publishing to NPM as global "pln" package

v2.2.2
======
* Fix to be able to close tabs with image view #46
Expand Down
26 changes: 13 additions & 13 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -68,16 +68,16 @@ plugins-client/lib.ace/www/worker/worker-language.js plugins-client/lib.ace/www/
$(wildcard node_modules/ace/*/*) \
Makefile.dryice.js
mkdir -p plugins-client/lib.ace/www/worker
rm -rf /tmp/c9_worker_build
mkdir -p /tmp/c9_worker_build/ext
ln -s `pwd`/plugins-client/ext.language /tmp/c9_worker_build/ext/language
ln -s `pwd`/plugins-client/ext.codecomplete /tmp/c9_worker_build/ext/codecomplete
ln -s `pwd`/plugins-client/ext.jslanguage /tmp/c9_worker_build/ext/jslanguage
ln -s `pwd`/plugins-client/ext.csslanguage /tmp/c9_worker_build/ext/csslanguage
ln -s `pwd`/plugins-client/ext.htmllanguage /tmp/c9_worker_build/ext/htmllanguage
ln -s `pwd`/plugins-client/ext.linereport /tmp/c9_worker_build/ext/linereport
ln -s `pwd`/plugins-client/ext.linereport_php /tmp/c9_worker_build/ext/linereport_php
ln -s `pwd`/plugins-client/ext.linereport_python /tmp/c9_worker_build/ext/linereport_python
rm -rf /tmp/pln_worker_build
mkdir -p /tmp/pln_worker_build/ext
ln -s `pwd`/plugins-client/ext.language /tmp/pln_worker_build/ext/language
ln -s `pwd`/plugins-client/ext.codecomplete /tmp/pln_worker_build/ext/codecomplete
ln -s `pwd`/plugins-client/ext.jslanguage /tmp/pln_worker_build/ext/jslanguage
ln -s `pwd`/plugins-client/ext.csslanguage /tmp/pln_worker_build/ext/csslanguage
ln -s `pwd`/plugins-client/ext.htmllanguage /tmp/pln_worker_build/ext/htmllanguage
ln -s `pwd`/plugins-client/ext.linereport /tmp/pln_worker_build/ext/linereport
ln -s `pwd`/plugins-client/ext.linereport_php /tmp/pln_worker_build/ext/linereport_php
ln -s `pwd`/plugins-client/ext.linereport_python /tmp/pln_worker_build/ext/linereport_python
node Makefile.dryice.js worker
cp node_modules/ace/build/src/worker* plugins-client/lib.ace/www/worker

Expand All @@ -101,11 +101,11 @@ gzip:
gzip -9 -v -q -f $$i ; \
done

c9core: apf ace core worker mode theme
core: apf ace core worker mode theme

package_clean: helper_clean c9core ext
package_clean: helper_clean core ext

package: helper c9core ext
package: helper core ext

test check:
test/run-tests.sh
2 changes: 1 addition & 1 deletion Makefile.dryice.js
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ function main(args) {
var project = {
roots: [
ACE_HOME + "/lib",
"/tmp/c9_worker_build",
"/tmp/pln_worker_build",
__dirname + "/node_modules/treehugger/lib"
],
textPluginPattern: /^ace\/requirejs\/text!/
Expand Down
113 changes: 28 additions & 85 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,20 @@
[![Build Status](https://travis-ci.org/exsilium/cloud9.svg?branch=master)](https://travis-ci.org/exsilium/cloud9)
[![Master Dependency Status](https://snyk.io/test/github/exsilium/cloud9/badge.svg)](https://snyk.io/test/github/exsilium/cloud9)
[![Development Dependency Status](https://snyk.io/test/github/exsilium/cloud9/development/badge.svg)](https://snyk.io/test/github/exsilium/cloud9)
[![Build Status](https://travis-ci.org/pylonide/pylon.svg?branch=master)](https://travis-ci.org/pylonide/pylon)
[![Master Dependency Status](https://snyk.io/test/github/pylonide/pylon/badge.svg)](https://snyk.io/test/github/pylonide/pylon)
[![Development Dependency Status](https://snyk.io/test/github/pylonide/pylon/development/badge.svg)](https://snyk.io/test/github/pylonide/pylon)
[![Bitcoin donate button](https://img.shields.io/badge/bitcoin-donate-yellow.svg)](https://www.coinbase.com/checkouts/9f4183a5164f2c4bd53d6afc74068ec4 "One-time donation to keep this fork alive")

# Cloud9 IDE v2
# Pylon IDE

As of 14th of February 2015 with a commit that can no longer be linked to, the upstream author Cloud9 IDE, Inc stated that the Cloud9 v2 would no longer be maintained. The original repository issue tracker was closed and notifications were given that the project is superseded by [Cloud9 v3 SDK](https://github.com/c9/core/) with some substantial changes in licensing terms driven by alignment of business goals.

This repository is the maintenance fork for the original Cloud9 IDE that people grew to love. The v3 development is continuing strong but there are many changes to the original approach:

- The emphasis shifted to the development of [c9.io](http://c9.io) cloud-hosted service, which was acquired by Amazon in July 2016.
- On the 30th of November 2017, [AWS Cloud9](https://aws.amazon.com/cloud9/) was announced.
- The on-premises solution will be a separately licensed product (if at all, since AWS aquired Cloud9)
- The distributed SDK is meant for plugin development
- The core of the product is [no longer licensed as Open Source Software](http://cloud9-sdk.readme.io/v0.1/docs/the-licenses-for-cloud9-sdk-and-packages)

That being said, AWS Cloud9 includes much more features and is a very solid and mature offering. Further more, the license allows the SDK version to be used as a personal editor. However, it is strictly prohibited to:

- Use the SDK to build or offer a service
- Make the SDK version easily available to anyone else besides yourself

If it feels like these are limiting factors for you, you are welcome to try Cloud9 v2, which is licensed under [GPL version 3](LICENSE).
Pylon is a web based integrated development environment built with Node.js as a backend and with a supercharged JavaScript/HTML5 licensed under [GPL version 3](LICENSE). This project originates from Cloud9 v2 project.

## About

Cloud9 is an open source IDE built with [Node.JS] on the back-end and JavaScript/HTML5 on the client. The version available here runs on your local system. Cloud9 balances the power of traditional desktop IDEs with the simplicity and elegance of editors like TextMate and Sublime.

Cloud9 is built entirely on a web stack, making it the most hacker-friendly IDE today. Fork it, hack it, and if you think others would benefit, file a pull request against `development` branch in this repo or create an issue.
Pylon is built entirely on a web stack, making it the most hacker-friendly IDE today. Fork it, hack it, make it your own and if you think others would benefit, file a pull request against `development` branch in this repo or create an issue. You can run Pylon locally or on a remote server - always ready to be available from wherever you are, assisting you to breathe life into every aspect of your ideas and projects.

## Fork Extras
## Features

- Modern node support (NodeJS >= 4.8.5)
- High performance ACE text editor with bundled syntax highlighting to support a wide range of programming languages.
- Modern node support (NodeJS >= 4.9.1)
- Up to date dependencies and compatibility fixes
- Terminal

Expand All @@ -40,22 +24,13 @@ Cloud9 is built entirely on a web stack, making it the most hacker-friendly IDE

![ScreenShot](doc/screenshot02.png)

## Features

* High performance ACE text editor with bundled syntax highlighting support for JS, HTML, CSS and mixed modes.
* Integrated debugger for [Node.JS] applications with views of the call stack, variables, live code execution and live inspector
* Advanced JavaScript language analysis marking unused variables, globals, syntax errors and allowing for variable rename
* Local file system is exposed through [WebDAV](http://en.wikipedia.org/wiki/WebDAV) to the IDE, which makes it possible to connect to remote workspaces as well
* Highly extensible through both client-side and server-side plugins
* Sophisticated process management on the server with evented messaging

## Browser Support

We support the newer versions of Chrome, Firefox and Safari.

### Basic iPad Pro support with keyboard

As of v2.2.0 efforts have been made to make c9v2 usable with iPad. However, for a smoother ride, some keyboard settings needs to be changed:
As of v2.3.0 efforts have been made to make Pylon usable with iPad. However, for a smoother ride, some keyboard settings needs to be changed:

- Settings -> General -> Keyboard -> Auto-Correction -> `Off`
- Settings -> General -> Keyboard -> Smart Punctuation -> `Off` (interferes with coding by changing quotes)
Expand All @@ -67,57 +42,57 @@ As of v2.2.0 efforts have been made to make c9v2 usable with iPad. However, for

If installing on Windows, please refer to [Installation on Windows](#installation-on-windows-experimental).

Requirements (>= 2.2.0):
Requirements (>= 2.3.0):

* NodeJS `>= 4.8.5`
* NodeJS `>= 4.9.1`
* g++-4.9 (Required for node-pty compilation)
* make (Required for node-pty compilation)
* python (Required for node-pty compilation)

Install:

git clone https://github.com/exsilium/cloud9.git
cd cloud9
npm install
git clone https://github.com/pylonide/pylon.git
cd pylon
npm i

The above install steps create a `cloud9` directory with a `bin/cloud9.sh`
script that can be used to start Cloud9:
The above install steps creates a `pylon` directory with a `bin/pylon.sh`
script that can be used to start Pylon:

bin/cloud9.sh
bin/pylon.sh

Optionally, you may specify the directory you'd like to edit:

bin/cloud9.sh -w ~/git/myproject
bin/pylon.sh -w ~/git/myproject

Cloud9 will be started as a web server on port `-p 3131`, you can access it by
Pylon will be started as a web server on port `-p 3131`, you can access it by
pointing your browser to: [http://localhost:3131](http://localhost:3131)

By default Cloud9 will only listen to localhost.
By default Pylon will only listen to localhost.
To listen to a different IP or hostname, use the `-l HOSTNAME` flag.
If you want to listen to all IP's:

bin/cloud9.sh -l 0.0.0.0
bin/pylon.sh -l 0.0.0.0

If you are listening to all IPs it is advised to add authentication to the IDE.
You can either do this by adding a reverse proxy in front of Cloud9,
You can either do this by adding a reverse proxy in front of Pylon,
or use the built in basic authentication through the `--username` and `--password` flags.

bin/cloud9.sh --username leuser --password c9isawesome
bin/pylon.sh --username leuser --password plnisawesome

Cloud9 is compatible with all connect authentication layers,
Pylon is compatible with all connect authentication layers,
to implement your own, please see the `plugins-server/cloud9.connect.basic-auth` plugin
on how we added basic authentication.

## Installation on Windows (experimental)

If you are on Windows Insider Program, use the Bash on Windows feature to install Cloud9.
If you are on Windows Insider Program, use the Bash on Windows feature to install Pylon.

Install [NVM](https://github.com/creationix/nvm) to manage node versions. Install a node version to your liking. The following is needed to install the needed build tools:

sudo apt-get update
sudo apt-get install build-essential

Clone the Cloud9 repo to your machine and run npm:
Clone the Pylon repo to your machine and run npm:

npm install
make worker
Expand All @@ -130,48 +105,16 @@ To update to the latest version (if this doesn't work, just make a fresh clone):
git pull
npm update

`npm update` does not currently install missing dependencies. To do so use:

npm install

## Creating your own Plugins

Cloud9v2 functionality is all created around server and client-side plugins.
Pylon functionality is all created around server and client-side plugins.
However, there is hardly any documentation about the APIs to create your own
plugins. To get you started, please see [exsilium/cloud9-plugin-ungit](https://github.com/exsilium/cloud9-plugin-ungit)
to see how to get started for a client-side only plugin.

Going forward, there will be efforts made to sort out the documentation and
write some tutorials to make it more easier to get started.

## Open Source Projects Used

The Cloud9 IDE couldn't be this cool if it weren't for the wildly productive
[Node.JS] community producing so many high quality software.
Main projects that we use as building blocks:

* [async.js] by [fjakobs]
* [jsDAV] by [mikedeboer]
* [connect] by [senchalabs](http://github.com/senchalabs)
* [engine.io] by [LearnBoost](http://github.com/LearnBoost)
* [smith.io](http://github.com/c9/smith.io) by [creationix](http://github.com/creationix) & [cadorn](http://github.com/cadorn)
* [ace](http://github.com/ajaxorg/ace) by [fjakobs]
* [apf](http://www.ajax.org) by [ajax.org]
* and of course [Node.JS]!

Thanks to all developers and contributors of these projects!

[fjakobs]: http://github.com/fjakobs
[javruben]: http://github.com/javruben
[mikedeboer]: http://github.com/mikedeboer
[ajax.org]: http://www.ajax.org/
[async.js]: http://github.com/fjakobs/async.js
[jsDAV]: http://github.com/mikedeboer/jsdav
[connect]: http://github.com/senchalabs/connect
[engine.io]: http://github.com/LearnBoost/engine.io
[requireJS]: http://requirejs.org/
[Node.JS]: http://nodejs.org/

## License

The [GPL v3](LICENSE).
Expand Down
File renamed without changes.
14 changes: 7 additions & 7 deletions ecosystem.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"apps" : [{
"name" : "cloud9",
"name" : "pylon",
"script" : "server.js",
"args" : ["-l", "0.0.0.0", "-p", "8181", "--username", process.env.C9_USERNAME, "--password", process.env.C9_PASSWORD],
"args" : ["-l", "0.0.0.0", "-p", "8181", "--username", process.env.PLN_USERNAME, "--password", process.env.PLN_PASSWORD],
"node_args" : "",
"merge_logs" : true
}],
Expand All @@ -11,14 +11,14 @@
"staging" : {
"user" : process.env.PM2_DEPLOY_STAGING_USER,
"host" : process.env.PM2_DEPLOY_STAGING_HOST,
"repo" : "https://github.com/exsilium/cloud9.git",
"repo" : "https://github.com/pylonide/pylon.git",
"ref" : "origin/development",
"path" : "/home/" + process.env.PM2_DEPLOY_STAGING_USER + "/www/cloud9",
"path" : "/home/" + process.env.PM2_DEPLOY_STAGING_USER + "/www/pylon",
"ssh-options" : ["StrictHostKeyChecking=no", "PasswordAuthentication=no"],
"pre-setup" : "mkdir /home/" + process.env.PM2_DEPLOY_STAGING_USER + "/workspace",
"post-setup" : "echo 'export C9_USERNAME=" + process.env.PM2_DEPLOY_STAGING_USERNAME + "' >> ~/.bashrc && " +
"echo 'export C9_PASSWORD=" + process.env.PM2_DEPLOY_STAGING_PASSWORD + "' >> ~/.bashrc && " +
"echo 'export C9_WORKSPACE=/home/" + process.env.PM2_DEPLOY_STAGING_USER + "/workspace' >> ~/.bashrc",
"post-setup" : "echo 'export PLN_USERNAME=" + process.env.PM2_DEPLOY_STAGING_USERNAME + "' >> ~/.bashrc && " +
"echo 'export PLN_PASSWORD=" + process.env.PM2_DEPLOY_STAGING_PASSWORD + "' >> ~/.bashrc && " +
"echo 'export PLN_WORKSPACE=/home/" + process.env.PM2_DEPLOY_STAGING_USER + "/workspace' >> ~/.bashrc",
"pre-deploy" : "pm2 stop all; rm -rf node_modules",
"post-deploy" : "npm install && pm2 start ecosystem.json",
"env" : {
Expand Down
Loading

0 comments on commit 87d308b

Please sign in to comment.