Skip to content

nishio/jscc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JSCC: Continuous Compilation for JavaScript

JavaScript is very loose language. Closure Compiler helps us to keep quality of codes.

jscc does:

  • watch modification of your JS files (using watchdog and goog.require dependency),
  • background compile & lint (using Closure Compiler and Closure Lint),
  • visualize them with dinamic graph (using Highcharts and Flask).

You can see screenshots of dinamic graphs on: https://github.com/nishio/jscc/blob/gh-pages/screenshot.png

CONTENTS

  • client: client tools for continuous compilation.

  • server: HTTP server to visualize errors and warnings. It also a sample usecase of JSCC.

    Makefile, build.sh, client.py are used for sample.

REQUIREMENT

(*) "$ make" on top level will download several requirements.

For client

For server

HOW TO USE

(currently we are making quickstart.py to make easy this step) (it is obsolete, sorry) - 1: Fork the repos on github. - 2: 'git clone' into your project dir - 3: Make branch: 'git checkout -b <some_name_to_identify_your_project>' - 4: Do: jscc$ make client_install

it does 'ln -s' jscc/client/{build.sh, Makefile, client.py}
  • 5: Try 'make conftest' to configure correctly
  • 6: Try 'make {deps.txt, lint, deps.js, compile}'
    especially 'make compile' fails when you set wrong LIBPATH and EXTERNS, be careful.
  • 7: Run jscc/server/server.py
    It may better to use another shell not to bother with a lot of logs.
  • 8: Try 'make {report, watch}'
    'make watch' also be better to run on another shell.

If you already installed jscc:

  • 1: Make _jscc on your project dir
  • 2: "ln -s" for build.sh, watch.py, report.py
  • 3: Make Makefile (or something you want) to compile and lint your js-files. It is triggered by watch.py.

HOW TO USE WITH FLYMAKE

If you use emacs, you can highlight error/warning line on emacs. After add ("\.js\'" flymake-simple-make-init) into flymake-allowed-file-name-masks , flymake-mode call "make check-syntax" when you save files.

(add-to-list 'flymake-allowed-file-name-masks
             '("\\.js\\'" flymake-simple-make-init))

(add-hook 'java-mode-hook
          '(lambda ()
             (flymake-mode)))

HOW TO RUN SERVER ON RACKHUB

  • 1: Log in your rack
  • 2: git clone <repos> (TODO: install Flask)
  • 3: git checkout develop # optional
  • 4: cd server
  • 5: python server.py --port 3000

TODO

  • remove watch.pid when wacter.py killed by Ctrl-C
  • quickstart.py have a lot of TODO - make server IP and port configurable
  • (done) move compile.log and lint.log into .jscc
  • (done) I implemented watch.py. Use it to watch scripts' modification.
  • 'server' is now a sample of jscc managed project, but in old-style. Make it not-jscc-managed project, and make quckstart.py can jscc-ize it.
  • preserve past errors. (now just have the last data. it lost if server restarted)
  • other issues
    • (done)we need nice way to kill watching process (instead of manual kill)
    • record what kind of error occurs, statistics?
    • be able to scroll the graph to see past
    • enbug.py will crash if empty file is passed
    • enbug.py will hung up if a whitespace-only file is passed
    • enbug.py should output bugs as line diff.
    • make graph's minimum Y == 0.
    • make graph's minimun tick >= 1

HISTORY

2012-05-29 v1.1: Support Flymake 2012-03-27 First Release

THANKS

The jscc was developed to enhance my productivity in Cybozu Labs, which allowed me to publish the tool. Thanks! http://labs.cybozu.co.jp/en/

About

Continuous Compilation for JavaScript

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published