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

js-beautify 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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

data/js-beautify-copy/favicon.png ADDED

Binary file

data/js-beautify-copy/index.html ADDED

@@ -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;
+    }
+};