RubyGems - js-beautify - Versions diffs - 0.1.7 - Mend

js-beautify 0.1.7

Files changed (74) hide show

data/.document +5 -0
data/.gitmodules +4 -0
data/Gemfile +13 -0
data/Gemfile.lock +27 -0
data/LICENSE.txt +20 -0
data/README.rdoc +13 -0
data/Rakefile +29 -0
data/VERSION +1 -0
data/bin/js-beautify +5 -0
data/init.sh +3 -0
data/js-beautify-copy/.gitmodules +3 -0
data/js-beautify-copy/Makefile +71 -0
data/js-beautify-copy/README.md +39 -0
data/js-beautify-copy/attic/beautify-cl/beautify-cl.js +142 -0
data/js-beautify-copy/attic/bin/beautify_js +80 -0
data/js-beautify-copy/attic/opera-userscript/beautifier.js +1087 -0
data/js-beautify-copy/attic/opera-userscript/make_opera_userscript.sh +42 -0
data/js-beautify-copy/attic/qtscript/jsbeautify.cpp +121 -0
data/js-beautify-copy/attic/qtscript/jsbeautify.pro +5 -0
data/js-beautify-copy/attic/qtscript/jsbeautify.qrc +6 -0
data/js-beautify-copy/attic/qtscript/readme.txt +28 -0
data/js-beautify-copy/attic/readme.txt +2 -0
data/js-beautify-copy/attic/unmaintained/bbedit/jsBeautify_BBED.scpt +522 -0
data/js-beautify-copy/attic/unmaintained/c-sharp/JSBeautify.cs +801 -0
data/js-beautify-copy/attic/v8/README.txt +40 -0
data/js-beautify-copy/attic/v8/beautify.h +2390 -0
data/js-beautify-copy/attic/v8/jsbeautify.cpp +215 -0
data/js-beautify-copy/beautify-css.js +198 -0
data/js-beautify-copy/beautify-html.js +514 -0
data/js-beautify-copy/beautify.js +1293 -0
data/js-beautify-copy/favicon.png +0 -0
data/js-beautify-copy/index.html +401 -0
data/js-beautify-copy/jquery/jquery.cookie.js +96 -0
data/js-beautify-copy/jquery/jquery.js +167 -0
data/js-beautify-copy/license.txt +24 -0
data/js-beautify-copy/php/jsbeautifier.php +1599 -0
data/js-beautify-copy/php/test.php +476 -0
data/js-beautify-copy/python/MANIFEST.in +2 -0
data/js-beautify-copy/python/js-beautify +7 -0
data/js-beautify-copy/python/js-beautify-profile +16 -0
data/js-beautify-copy/python/js-beautify-test +10 -0
data/js-beautify-copy/python/jsbeautifier/__init__.py +1166 -0
data/js-beautify-copy/python/jsbeautifier/tests/__init__.py +1 -0
data/js-beautify-copy/python/jsbeautifier/tests/testindentation.py +43 -0
data/js-beautify-copy/python/jsbeautifier/tests/testjsbeautifier.py +464 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/README.specs.mkd +25 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/__init__.py +67 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/evalbased.py +39 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/javascriptobfuscator.py +58 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/myobfuscate.py +86 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/packer.py +104 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/__init__.py +2 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/test-myobfuscate-input.js +1 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/test-myobfuscate-output.js +65 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/test-packer-62-input.js +1 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/test-packer-non62-input.js +1 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/testjavascriptobfuscator.py +46 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/testmyobfuscate.py +40 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/testpacker.py +34 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/tests/testurlencode.py +36 -0
data/js-beautify-copy/python/jsbeautifier/unpackers/urlencode.py +34 -0
data/js-beautify-copy/python/setup.py +17 -0
data/js-beautify-copy/tests/beautify-tests.js +489 -0
data/js-beautify-copy/tests/run-tests +17 -0
data/js-beautify-copy/tests/sanitytest.js +128 -0
data/js-beautify-copy/unpackers/javascriptobfuscator_unpacker.js +103 -0
data/js-beautify-copy/unpackers/myobfuscate_unpacker.js +81 -0
data/js-beautify-copy/unpackers/p_a_c_k_e_r_unpacker.js +61 -0
data/js-beautify-copy/unpackers/urlencode_unpacker.js +51 -0
data/lib/js-beautify.rb +0 -0
data/test/helper.rb +18 -0
data/test/test_js-beautify.rb +7 -0
data/update.sh +23 -0
metadata +173 -0

Binary file

@@ -0,0 +1,401 @@
+<!DOCTYPE html>
+<!--[if lt IE 7]><html lang="en-us" class="ie6"><![endif]-->
+<!--[if IE 7]><html lang="en-us" class="ie7"><![endif]-->
+<!--[if IE 8]><html lang="en-us" class="ie8"><![endif]-->
+<!--[if gt IE 8]><!--><html lang="en-us"><!--<![endif]-->
+<head>
+    <meta charset="utf-8">
+    <title>Online JavaScript beautifier</title>
+    <link rel="icon" href="favicon.png" type="image/png">
+    <script src="third-party/codemirror2/lib/codemirror.js"></script>
+    <script src="third-party/codemirror2/mode/javascript/javascript.js"></script>
+    <link rel="stylesheet" href="third-party/codemirror2/lib/codemirror.css">
+    <style>
+body {
+    background: #eee;
+    color: #333;
+}
+img {
+    border: 0;
+}
+p, select, label, .blurb {
+    font:13px/1.231 arial, sans-serif;
+    *font-size:small;
+}
+a {
+    color: #36d;
+}
+button#submit {
+    clear: both;
+    margin-top: 5px;
+    width: 100%;
+    padding: 10px 0;
+    cursor: pointer;
+}
+#source {
+    width: 100%;
+    padding-left: 0;
+    padding-right: 0;
+}
+button#submit em {
+    font-size: 11px;
+    font-style: normal;
+    color: #999;
+}
+label {
+    cursor: pointer;
+}
+select {
+    width: 220px;
+}
+table#options {
+    float: right;
+}
+table#options td {
+    vertical-align: top;
+    padding-left: 10px;
+}
+#about p {
+    margin: 0 6px 6px 0;
+}
+li {
+    line-height: 150%;
+}
+#testresults {
+    display: none;
+    font-family: monaco, "lucida console", "courier new", monospace;
+}
+.CodeMirror {
+    border: 1px solid #ccc;
+    margin-bottom: 6px;
+    background: white;
+}
+.CodeMirror-scroll {
+  min-height: 400px;
+  max-height: 100%;
+  height: auto;
+  overflow-y: hidden;
+  overflow-x: auto;
+  width: 100%
+}
+    </style>
+<script src="jquery/jquery.js"></script>
+<script src="jquery/jquery.cookie.js"></script>
+<script src="beautify.js"></script>
+<script src="beautify-css.js"></script>
+<script src="beautify-html.js"></script>
+<script src="tests/sanitytest.js"></script>
+<script src="tests/beautify-tests.js"></script>
+<script src="unpackers/javascriptobfuscator_unpacker.js"></script>
+<script src="unpackers/urlencode_unpacker.js"></script>
+<script src="unpackers/p_a_c_k_e_r_unpacker.js"></script>
+<script src="unpackers/myobfuscate_unpacker.js"></script>
+<script>
+var the = {
+    use_codemirror: ( ! window.location.href.match(/without-codemirror/)),
+    beautify_in_progress: false,
+    editor: null // codemirror editor
+};
+function run_tests() {
+    var st = new SanityTest();
+    run_beautifier_tests(st);
+    JavascriptObfuscator.run_tests(st);
+    P_A_C_K_E_R.run_tests(st);
+    Urlencoded.run_tests(st);
+    MyObfuscate.run_tests(st);
+    // $('#testresults').html(results.replace(/r/g, '').replace(/\n/g, '<br>'));
+    var results = st.results_raw().replace(/ /g, '&nbsp;').replace(/\r/g, '·').replace(/\n/g, '<br>');
+    $('#testresults').html(results).show();
+}
+function any(a, b) {
+    return a || b;
+}
+function read_settings_from_cookie() {
+    $('#tabsize').val(any($.cookie('tabsize'), '4'));
+    $('#brace-style').val(any($.cookie('brace-style'), 'collapse'));
+    $('#detect-packers').attr('checked', $.cookie('detect-packers') !== 'off');
+    $('#preserve-newlines').attr('checked', $.cookie('preserve-newlines') !== 'off');
+    $('#keep-array-indentation').attr('checked', $.cookie('keep-array-indentation') === 'on');
+    $('#indent-scripts').val(any($.cookie('indent-scripts'), 'normal'));
+    $('#space-before-conditional').attr('checked', $.cookie('space-before-conditional') !== 'off');
+}
+function store_settings_to_cookie() {
+    var opts = { expires: 360 };
+    $.cookie('tabsize', $('#tabsize').val(), opts);
+    $.cookie('brace-style', $('#brace-style').val(), opts);
+    $.cookie('detect-packers', $('#detect-packers').attr('checked') ? 'on' : 'off', opts);
+    $.cookie('preserve-newlines', $('#preserve-newlines').attr('checked') ? 'on' : 'off', opts);
+    $.cookie('keep-array-indentation', $('#keep-array-indentation').attr('checked') ? 'on' : 'off', opts);
+    $.cookie('space-before-conditional', $('#space-before-conditional').attr('checked') ? 'on' : 'off', opts);
+    $.cookie('indent-scripts', $('#indent-scripts').val(), opts);
+}
+function unpacker_filter(source) {
+    var trailing_comments = '';
+    var comment = '';
+    var found = false;
+    do {
+        found = false;
+        if (/^\s*\/\*/.test(source)) {
+            found = true;
+            comment = source.substr(0, source.indexOf('*/') + 2);
+            source = source.substr(comment.length).replace(/^\s+/, '');
+            trailing_comments += comment + "\n";
+        } else if (/^\s*\/\//.test(source)) {
+            found = true;
+            comment = source.match(/^\s*\/\/.*/)[0];
+            source = source.substr(comment.length).replace(/^\s+/, '');
+            trailing_comments += comment + "\n";
+        }
+    } while (found);
+    if (P_A_C_K_E_R.detect(source)) {
+        // P.A.C.K.E.R unpacking may fail, even though it is detected
+        var unpacked = P_A_C_K_E_R.unpack(source);
+        if (unpacked != source) {
+            source = unpacker_filter(unpacked);
+        }
+    }
+    if (Urlencoded.detect(source)) {
+        source = unpacker_filter(Urlencoded.unpack(source))
+    }
+    if (JavascriptObfuscator.detect(source)) {
+        source = unpacker_filter(JavascriptObfuscator.unpack(source))
+    }
+    if (MyObfuscate.detect(source)) {
+        source = unpacker_filter(MyObfuscate.unpack(source))
+    }
+    return trailing_comments + source;
+}
+function beautify() {
+    if (the.beautify_in_progress) return;
+    store_settings_to_cookie();
+    the.beautify_in_progress = true;
+    var source;
+    if (the.editor) {
+        source = the.editor.getValue();
+    } else {
+        source = $('#source').val();
+    }
+    var indent_size = $('#tabsize').val();
+    var indent_char = indent_size == 1 ? '\t' : ' ';
+    var preserve_newlines = $('#preserve-newlines').attr('checked');
+    var keep_array_indentation = $('#keep-array-indentation').attr('checked');
+    var indent_scripts = $('#indent-scripts').val();
+    var brace_style = $('#brace-style').val();
+    var space_before_conditional = $('#space-before-conditional').attr('checked');
+    var opts = {
+                indent_size: indent_size,
+                indent_char: indent_char,
+                preserve_newlines:preserve_newlines,
+                brace_style: brace_style,
+                keep_array_indentation:keep_array_indentation,
+                space_after_anon_function:true,
+                space_before_conditional: space_before_conditional,
+                indent_scripts:indent_scripts};
+    var output;
+    if (looks_like_html(source)) {
+        output = style_html(source, opts);
+    } else {
+        if ($('#detect-packers').attr('checked')) {
+            source = unpacker_filter(source);
+        }
+        output = js_beautify(source, opts);
+    }
+    if (the.editor) {
+        the.editor.setValue(output);
+    } else {
+        $('#source').val(output);
+    }
+    the.beautify_in_progress = false;
+}
+function looks_like_html(source)
+{
+    // <foo> - looks like html
+    // <!--\nalert('foo!');\n--> - doesn't look like html
+    var trimmed = source.replace(/^[ \t\n\r]+/, '');
+    var comment_mark = '<' + '!-' + '-';
+    return (trimmed && (trimmed.substring(0, 1) === '<' && trimmed.substring(0, 4) !== comment_mark));
+}
+$(function() {
+    read_settings_from_cookie();
+    var default_text = "// This is just a sample script. Paste your real code (javascript or HTML) here.\n\nif ('this_is'==/an_example/){of_beautifer();}else{var a=b?(c%d):e[f];}";
+    if (the.use_codemirror) {
+        the.editor = CodeMirror.fromTextArea($('#source').get(0))
+        the.editor.setValue(default_text);
+        $('.CodeMirror').click(function () {
+            if (the.editor.getValue() == default_text) {
+                the.editor.setValue('');
+            }
+        });
+    } else {
+        $('#source').val(default_text).bind('click focus', function () {
+            if ($(this).val() == default_text) {
+                $(this).val('');
+            }
+        }).bind('blur', function () {
+            if ( ! $(this).val()) {
+                $(this).val(default_text);
+            }
+        });
+    }
+    $(window).bind('keydown', function (e) {
+        if (e.ctrlKey && e.keyCode == 13) {
+            beautify();
+        }
+    })
+    $('#submit').click(beautify);
+    $('select').change(beautify);
+});
+</script>
+</head>
+<body>
+    <table id="options">
+        <tr>
+          <td>
+          <select name="tabsize" id="tabsize">
+            <option value="1">indent with a tab character</option>
+            <option value="2">indent with 2 spaces</option>
+            <option value="3">indent with 3 spaces</option>
+            <option value="4">indent with 4 spaces</option>
+            <option value="8">indent with 8 spaces</option>
+          </select><br>
+          <select id="brace-style">
+            <option value="collapse">Braces with control statement</option>
+            <option value="expand">Braces on own line</option>
+            <option value="end-expand">End braces on own line</option>
+            <!-- option value="expand-strict">Braces always on own line (not recommended)</option -->
+          </select>
+          <p style="margin:6px 0 0 0">HTML &lt;style&gt;, &lt;script&gt; formatting:</p><select id="indent-scripts">
+            <option value="keep">Keep indent level of the tag</option>
+            <option value="normal">Add one indent level</option>
+            <option value="separate">Separate indentation</option>
+          </select>
+        </td><td>
+          <input class="checkbox" type="checkbox" id="preserve-newlines"><label for="preserve-newlines"> Preserve empty lines?</label><br>
+          <input class="checkbox" type="checkbox" id="detect-packers"><label for="detect-packers"> Detect packers and obfuscators?</label><br>
+          <input class="checkbox" type="checkbox" id="keep-array-indentation"><label for="keep-array-indentation"> Keep array indentation?</label><br>
+          <input class="checkbox" type="checkbox" id="space-before-conditional"><label for="space-before-conditional"> Space before conditional: "if(x)" / "if (x)"
+          <br><a style="margin-left: 25px" href="?without-codemirror">Turn off bells and whistles?</a>
+        </td></tr>
+    </table>
+    <div id="about">
+            <p><strong>Beautify, unpack or deobfuscate JavaScript and HTML, make JSON/JSONP readable, etc.</strong>.</p>
+            <p>All of the source code is completely free and open, available on the <a href="https://github.com/einars/js-beautify">github</a> under MIT licence, <br>and we have a command-line version and a python library as well.
+    </div>
+    <button id="submit"><strong>Beautify JavaScript or HTML</strong> <em>(ctrl-enter)</em></button>
+    <textarea id="source" rows="30" cols="160"></textarea>
+    <div class="blurb">
+      <div style="float:right; width: 210px;">
+      <a style="display:block; float: left; padding-top: 3px" href="http://flattr.com/thing/94550/jsbeautifier-org" target="_blank"><img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr" /></a>
+      <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+        <input type="hidden" name="cmd" value="_s-xclick">
+        <input type="hidden" name="hosted_button_id" value="TL28UJK2ARCUJ">
+        <input style="border:0" type="image" src="http://spicausis.lv/misc/paypal-donate.gif" name="submit" alt="PayPal - The safer, easier way to pay online!">
+        <img alt="" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
+      </form>
+      </div>
+      <p>Browser extensions and other uses:</p>
+      <ul id="uses">
+      <li>A <a href="javascript:(function(){s=document.getElementsByTagName('SCRIPT');tx='';sr=[];for(i=0;i<s.length;i++){with(s.item(i)){t=text;if(t){tx+=t;}else{sr.push(src)};}};with(window.open()){document.write('<textarea id=&quot;t&quot;>'+(sr.join(&quot;\n&quot;))+&quot;\n\n-----\n\n&quot;+tx+'</textarea><script src=&quot;http://jsbeautifier.org/beautify.js&quot;></script><script>with(document.getElementById(&quot;t&quot;)){value=js_beautify(value);with(style){width=&quot;99%&quot;;height=&quot;99%&quot;;borderStyle=&quot;none&quot;;}};</script>');document.close();}})();"><strong>bookmarklet</strong></a> (drag it to your bookmarks) by Ichiro Hiroshi to see all scripts used on the page,</li>
+      <li style="margin-top: 8px"><strong>Chrome</strong>: <a href="https://github.com/rixth/jsbeautify-for-chrome">jsbeautify-for-chrome</a> by Tom Rix,</li>
+      <li><strong>Chrome</strong>: <a href="https://chrome.google.com/webstore/detail/piekbefgpgdecckjcpffhnacjflfoddg">Pretty Beautiful JavaScript</a> by Will McSweeney,</li>
+      <li style="margin-top: 8px"><strong>Firefox</strong>: <a href="https://addons.mozilla.org/en-US/firefox/addon/javascript-deminifier/">Javascript deminifier</a> by Ben Murphy,<br>to be used together with the firebug (<a href="https://github.com/benmmurphy/jsdeminifier_xpi/">github</a>),</li>
+      <li style="margin-top: 8px"><strong>Safari</strong>: <a href="http://spadin.github.com/js-beautify-safari-extension">Safari extension</a> by Sandro Padin,</li>
+      <li style="margin-top: 8px"><strong>Opera</strong>: <a href="https://addons.opera.com/addons/extensions/details/readable-javascript/">Readable JavaScript</a> (<a href="https://github.com/Dither/readable-javascript">github</a>) by Dither,</li>
+      <li><strong>Opera</strong>: <a href="https://addons.opera.com/addons/extensions/details/source/">Source</a> extension by Deathamns,</li>
+      <li style="margin-top: 12px"><a style="font-weight: bold" href="http://fiddler2.com/">Fiddler</a> proxy: <a href="http://fiddler2.com/Fiddler2/extensions.asp">JavaScript Formatter addon</a>,
+      <li><strong>gEdit</strong> <a href="https://github.com/nagaozen/gedit-tunnings/">tips by Fabio Nagao</a>,</li>
+      <li><strong>Akelpad</strong> <a href="http://akelpad.sourceforge.net/forum/viewtopic.php?p=11246#11246">extension</a> by Infocatcher,</li>
+      <li>Beautifier in <a style="font-weight: bold" href="http://sethmason.com/2011/04/28/jsbeautify-in-emacs.html">Emacs</a> write-up by Seth Mason,</li>
+      <li><a style="font-weight:bold" href="http://c9.io">Cloud9</a>, a lovely IDE running in a browser, working in the node/cloud, uses jsbeautifier (<a href="https://github.com/ajaxorg/cloud9">github</a>),</li>
+      <li><a style="font-weight:bold" href="http://www.symetronapps.com/pages/apps/shrinker.html">Shrinker</a>, a non-free JavaScript packer for Mac. I&nbsp;haven't used it, so I&nbsp;have no idea if it's any good,</li>
+      <li><a style="font-weight:bold" href="http://www.restconsole.com/">REST Console</a>, a request debugging tool for Chrome, beautifies JSON responses (<a href="https://github.com/codeinchaos/rest-console">github</a>),</li>
+      <li><a style="font-weight:bold" href="http://mitmproxy.org/">mitmproxy</a>, a nifty SSL-capable HTTP proxy, provides pretty javascript responses (<a href="https://github.com/cortesi/mitmproxy">github</a>).</li>
+      <li><a style="font-weight:bold" href="http://www.wakanda.org/">wakanda</a>, a neat IDE for web and mobile applications has a <a href="http://forum.wakanda.org/showthread.php?1483-3-new-extensions-JSLint-Beautifier-and-Snippet">Beautifier extension</a> (<a href="https://github.com/Wakanda/wakanda-extensions/tree/master/Beautifier">github</a>).</li>
+      <li><a style="font-weight:bold" href="https://github.com/michalliu/sourcebeautify.vim">sourcebeautify.vim</a>, a nice vim plugin by michalliu (needs a supported js runtime),</li>
+      <li><a style="font-weight:bold" href="http://portswigger.net/burp/">Burp Suite</a> now has a <a href="http://code.google.com/p/burp-suite-beautifier-extension/">beautfier extension</a>, thanks to Soroush Dalili,</li>
+      <li><a style="font-weight:bold" href="http://plugins.netbeans.org/plugin/43263/jsbeautify">Netbeans jsbeautify</a> plugin by Drew Hamlett (<a href="https://github.com/drewhjava/netbeans-jsbeautify">github</a>).</li>
+      <li class="writeme">Doing anything interesting? Write me to einar@jsbeautifier.org and I'll include your link.</li>
+      </ul>
+      <p class="me-me-me">Written by Einar Lielmanis, <a href="mailto:einar@jsbeautifier.org">einar@jsbeautifier.org</a>, Python version flourished by <a href="http://github.com/satufk">Stefano Sanfilippo</a>. We use the wonderful <a href="http://codemirror.net">CodeMirror</a> syntax highlighting editor, written by Marijn Haverbeke.</p>
+    <p class="contributors">Made with a great help of <a href="http://jason.diamond.name/weblog/">Jason&nbsp;Diamond</a>, Patrick&nbsp;Hof, Nochum&nbsp;Sossonko, Andreas&nbsp;Schneider, Dave&nbsp;Vasilevsky, <a href="http://my.opera.com/Vital/blog/">Vital&nbsp;Batmanov,</a> Ron&nbsp;Baldwin, Gabriel&nbsp;Harrison, <a href="http://shullian.com">Chris&nbsp;J.&nbsp;Shull</a>, <a href="http://mathiasbynens.be/">Mathias Bynens</a> and others.
+    </p>
+    <p style="text-align:right">
+    <a href="#" style="color: #ccc; border-bottom: 1px dashed #ccc; text-decoration: none;" onclick="run_tests(); return false;">Run the tests</a>
+    </p>
+    </div>
+    <div id="testresults"></div>
+    <script>
+        var _gaq = [['_setAccount', 'UA-7409939-1'], ['_trackPageview']];
+        (function(d, t) {
+            var g = d.createElement(t),
+                s = d.getElementsByTagName(t)[0];
+            g.src = '//www.google-analytics.com/ga.js';
+            s.parentNode.insertBefore(g, s);
+        }(document, 'script'));
+    </script>
+</body>
+</html>

data/js-beautify-copy/jquery/jquery.cookie.js ADDED

@@ -0,0 +1,96 @@
+/**
+ * Cookie plugin
+ *
+ * Copyright (c) 2006 Klaus Hartl (stilbuero.de)
+ * Dual licensed under the MIT and GPL licenses:
+ * http://www.opensource.org/licenses/mit-license.php
+ * http://www.gnu.org/licenses/gpl.html
+ *
+ */
+/**
+ * Create a cookie with the given name and value and other optional parameters.
+ *
+ * @example $.cookie('the_cookie', 'the_value');
+ * @desc Set the value of a cookie.
+ * @example $.cookie('the_cookie', 'the_value', { expires: 7, path: '/', domain: 'jquery.com', secure: true });
+ * @desc Create a cookie with all available options.
+ * @example $.cookie('the_cookie', 'the_value');
+ * @desc Create a session cookie.
+ * @example $.cookie('the_cookie', null);
+ * @desc Delete a cookie by passing null as value. Keep in mind that you have to use the same path and domain
+ *       used when the cookie was set.
+ *
+ * @param String name The name of the cookie.
+ * @param String value The value of the cookie.
+ * @param Object options An object literal containing key/value pairs to provide optional cookie attributes.
+ * @option Number|Date expires Either an integer specifying the expiration date from now on in days or a Date object.
+ *                             If a negative value is specified (e.g. a date in the past), the cookie will be deleted.
+ *                             If set to null or omitted, the cookie will be a session cookie and will not be retained
+ *                             when the the browser exits.
+ * @option String path The value of the path atribute of the cookie (default: path of page that created the cookie).
+ * @option String domain The value of the domain attribute of the cookie (default: domain of page that created the cookie).
+ * @option Boolean secure If true, the secure attribute of the cookie will be set and the cookie transmission will
+ *                        require a secure protocol (like HTTPS).
+ * @type undefined
+ *
+ * @name $.cookie
+ * @cat Plugins/Cookie
+ * @author Klaus Hartl/klaus.hartl@stilbuero.de
+ */
+/**
+ * Get the value of a cookie with the given name.
+ *
+ * @example $.cookie('the_cookie');
+ * @desc Get the value of a cookie.
+ *
+ * @param String name The name of the cookie.
+ * @return The value of the cookie.
+ * @type String
+ *
+ * @name $.cookie
+ * @cat Plugins/Cookie
+ * @author Klaus Hartl/klaus.hartl@stilbuero.de
+ */
+jQuery.cookie = function(name, value, options) {
+    if (typeof value != 'undefined') { // name and value given, set cookie
+        options = options || {};
+        if (value === null) {
+            value = '';
+            options.expires = -1;
+        }
+        var expires = '';
+        if (options.expires && (typeof options.expires == 'number' || options.expires.toUTCString)) {
+            var date;
+            if (typeof options.expires == 'number') {
+                date = new Date();
+                date.setTime(date.getTime() + (options.expires * 24 * 60 * 60 * 1000));
+            } else {
+                date = options.expires;
+            }
+            expires = '; expires=' + date.toUTCString(); // use expires attribute, max-age is not supported by IE
+        }
+        // CAUTION: Needed to parenthesize options.path and options.domain
+        // in the following expressions, otherwise they evaluate to undefined
+        // in the packed version for some reason...
+        var path = options.path ? '; path=' + (options.path) : '';
+        var domain = options.domain ? '; domain=' + (options.domain) : '';
+        var secure = options.secure ? '; secure' : '';
+        document.cookie = [name, '=', encodeURIComponent(value), expires, path, domain, secure].join('');
+    } else { // only name given, get cookie
+        var cookieValue = null;
+        if (document.cookie && document.cookie != '') {
+            var cookies = document.cookie.split(';');
+            for (var i = 0; i < cookies.length; i++) {
+                var cookie = jQuery.trim(cookies[i]);
+                // Does this cookie string begin with the name we want?
+                if (cookie.substring(0, name.length + 1) == (name + '=')) {
+                    cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
+                    break;
+                }
+            }
+        }
+        return cookieValue;
+    }
+};