old_sql 1.12.0 → 1.13.0

data/public/javascripts/old_sql/MochiKit-1.4.2/doc/rst/MochiKit/DateTime.rst

@@ -0,0 +1,145 @@
+.. title:: MochiKit.DateTime - "what time is it anyway?"
+
+Name
+====
+
+MochiKit.DateTime - "what time is it anyway?"
+
+
+Synopsis
+========
+
+::
+
+   stringDate = toISOTimestamp(new Date());
+   dateObject = isoTimestamp(stringDate);
+
+
+Description
+===========
+
+Remote servers don't give you JavaScript Date objects, and they
+certainly don't want them from you, so you need to deal with string
+representations of dates and timestamps. MochiKit.Date does that.
+
+
+Dependencies
+============
+
+None.
+
+
+API Reference
+=============
+
+Functions
+---------
+
+:mochidef:`isoDate(str)`:
+
+    Convert an ISO 8601 date (YYYY-MM-DD) to a ``Date`` object.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`isoTimestamp(str)`:
+
+    Convert any ISO 8601 [1]_ timestamp (or something reasonably close
+    to it) to a ``Date`` object. Will accept the "de facto" form:
+
+        YYYY-MM-DD hh:mm:ss
+
+    or (the proper form):
+
+        YYYY-MM-DDThh:mm:ssZ
+
+    If a time zone designator ("Z" or "[+-]HH:MM") is not present,
+    then the local timezone is used.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`toISOTime(date)`:
+
+    Convert a ``Date`` object to a string in the form of hh:mm:ss
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`toISOTimestamp(date, realISO=false)`:
+
+    Convert a ``Date`` object to something that's ALMOST but not quite
+    an ISO 8601 [1]_timestamp. If it was a proper ISO timestamp it
+    would be:
+
+        YYYY-MM-DDThh:mm:ssZ
+
+    However, we see junk in SQL and other places that looks like this:
+
+        YYYY-MM-DD hh:mm:ss
+
+    So, this function returns the latter form, despite its name,
+    unless you pass ``true`` for ``realISO``.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`toISODate(date)`:
+
+    Convert a ``Date`` object to an ISO 8601 [1]_ date string
+    (YYYY-MM-DD)
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`americanDate(str)`:
+
+    Converts a MM/DD/YYYY date to a ``Date`` object
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`toPaddedAmericanDate(date)`:
+
+    Converts a ``Date`` object to an MM/DD/YYYY date, e.g. 01/01/2001
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`toAmericanDate(date)`:
+
+    Converts a ``Date`` object to an M/D/YYYY date, e.g. 1/1/2001
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+See Also
+========
+
+.. [1] W3C profile of ISO 8601: http://www.w3.org/TR/NOTE-datetime
+
+
+Authors
+=======
+
+- Bob Ippolito <bob@redivi.com>
+
+
+Copyright
+=========
+
+Copyright 2005 Bob Ippolito <bob@redivi.com>. This program is
+dual-licensed free software; you can redistribute it and/or modify it
+under the terms of the `MIT License`_ or the `Academic Free License
+v2.1`_.
+
+.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
+.. _`Academic Free License v2.1`: http://www.opensource.org/licenses/afl-2.1.php

data/public/javascripts/old_sql/MochiKit-1.4.2/doc/rst/MochiKit/DragAndDrop.rst

@@ -0,0 +1,197 @@
+.. title:: MochiKit.DragAndDrop - drag and drop elements with MochiKit
+
+Name
+====
+
+MochiKit.DragAndDrop - drag and drop elements with MochiKit
+
+Synopsis
+========
+
+::
+
+    // Create a draggable
+    new Draggable('mydrag');
+
+    // Create a corresponding droppable
+    new Droppable('mydrop', {
+        accept: ['drag-class'],
+        ondrop: function (element) {
+            alert('"' + element.id + '" was dropped on me');
+        }
+    });
+
+Description
+===========
+
+MochiKit.DragAndDrop enables you the power of dragging elements
+through your pages, for richer interfaces.
+
+Dependencies
+============
+
+- :mochiref:`MochiKit.Base`
+- :mochiref:`MochiKit.Iter`
+- :mochiref:`MochiKit.DOM`
+- :mochiref:`MochiKit.Color`
+- :mochiref:`MochiKit.Visual`
+- :mochiref:`MochiKit.Signal`
+
+Overview
+========
+
+The implementation was adapted from Scriptaculous_.
+
+.. _Scriptaculous: http://script.aculo.us
+
+API Reference
+=============
+
+Constructors
+------------
+
+:mochidef:`Draggable(element[, options])`:
+
+    A object that can be drag with the mouse.
+
+    You have the following options, with corresponding default values:
+
+    ``handle (false)``:
+        Option for giving the element where starting the drag. By
+        default it's the element itself, but you can either put a
+        class of a subelement or the id of another element as handle.
+
+    ``starteffect (MochiKit.Visual.Opacity)``:
+        Function called once the drag has begun, taking the dragged
+        element as argument. It's an effect by default but you can
+        define any callback.
+
+    ``reverteffect (MochiKit.Visual.Move)``:
+        Effect applied when drag is cancelled. You have to define the
+        ``revert`` option to enable the call. By default it brings the
+        element back to its initial position, so you should know what
+        you want when you modify this. The function should return an
+        effect that can be cancelled.
+
+    ``endeffect (MochiKit.Visual.Opacity)``:
+        Pending part of starteffect. If you have modified your element
+        during start, you'd usually want to revert it in the function.
+
+    ``zindex (1000)``:
+        Zindex of the drag element. By default it brings it to front.
+
+    ``revert (false)``:
+        Indicate if the reverteffect function should be called. If you
+        define a function here, this function will be called before
+        reverteffect, with the element as first argument.
+
+    ``snap (false)``:
+        Define the behaviour of the drag element when moving. It can
+        either be a function, a value or an array of two values. If
+        it's a function, it should take the (x, y) position of the
+        element as arguments, and return the position draw in the
+        browser. If its a value, it's used as a modulo for each
+        coordinates. If it's an array, each value is applied for the
+        corresponding coordinate.
+
+    ``selectclass (null)``:
+        If defined, name of CSS class applied during the drag.
+
+    ``ghosting (null)``:
+        Make a ghost from the draggable: clone it at start, then
+        remove the clone at end.
+
+    ``onchange  (MochiKit.Base.noop)``:
+        Function called when updates are made on the draggable object.
+
+    ``scroll (false)``:
+        Element to scroll around, if precised. For example, ``window``
+        will allow the draggable to scroll in the page.
+
+    ``scrollSensitivity (20)``:
+        Scroll sensitivity, used when scroll is used.
+
+    ``scrollSpeed (15)``:
+        Scroll speed, used when scroll is used.
+
+    A draggable generates some signals during its lifetime: start, drag and
+    end. They are available through the Draggables handler, and are called
+    with a draggable as argument. You can register a callback for these events
+    like this::
+        
+        onStart = function (draggable) {
+            // Do some stuff
+        };
+
+        connect(Draggables, 'start', onStart);
+
+
+    *Availability*:
+        Available in MochiKit 1.4+
+
+
+:mochidef:`Droppable(element[, options])`:
+
+    A object where you can drop a draggable.
+
+    You have the following options, with corresponding default values:
+
+    ``greedy (true)``:
+        Stop on this droppable when a draggable drops over it.
+
+    ``hoverclass (null)``:
+        If defined, name of CSS class applied when a draggable is
+        hover the droppable element (hover state).
+
+    ``hoverfunc (MochiKit.Base.noop)``:
+        Function called on hover state.
+
+    ``accept (null)``:
+        Array of CSS classes allowed to drop on this.
+
+    ``activeclass (null)``:
+        If defined, name of CSS class applied if a possible draggable
+        begins its start (active state).
+
+    ``onactive (MochiKit.Base.noop)``:
+        Function called on active state.
+
+    ``containment ([])``:
+        Specify a list of elements to check for active state: only the
+        children of the specified elements can be dropped. Mainly
+        useful for Sortable.
+
+    ``onhover (MochiKit.Base.noop)``:
+        Specific hover function, mainly used for Sortable.
+
+    ``ondrop (MochiKit.Base.noop)``:
+        Function called when a draggable is dropped. The function
+        takes three arguments: the draggable element, the droppable
+        element, and the event that raised the drop.
+
+    *Availability*:
+        Available in MochiKit 1.4+
+
+
+Authors
+=======
+
+- Thomas Herve <therve@gmail.com>
+- Bob Ippolito <bob@redivi.com>
+- Originally adapted from Script.aculo.us <http://script.aculo.us/>
+
+Copyright
+=========
+
+Copyright 2005 Bob Ippolito <bob@redivi.com>.  This program is
+dual-licensed free software; you can redistribute it and/or modify it
+under the terms of the `MIT License`_ or the `Academic Free License
+v2.1`_.
+
+.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
+.. _`Academic Free License v2.1`: http://www.opensource.org/licenses/afl-2.1.php
+
+Portions adapted from `Scriptaculous`_ are available under the terms
+of the `MIT License`_.
+
+

data/public/javascripts/old_sql/MochiKit-1.4.2/doc/rst/MochiKit/Format.rst

@@ -0,0 +1,258 @@
+.. title:: MochiKit.Format - string formatting goes here
+
+Name
+====
+
+MochiKit.Format - string formatting goes here
+
+
+Synopsis
+========
+
+::
+
+   assert( truncToFixed(0.12345, 4) == "0.1234" );
+   assert( roundToFixed(0.12345, 4) == "0.1235" );
+   assert( twoDigitAverage(1, 0) == "0" );
+   assert( twoDigitFloat(1.2345) == "1.23" );
+   assert( twoDigitFloat(1) == "1" );
+   assert( percentFormat(1.234567) == "123.46%" );
+   assert( numberFormatter("###,###%")(125) == "12,500%" );
+   assert( numberFormatter("##.000")(1.25) == "1.250" );
+
+
+Description
+===========
+
+Formatting strings and stringifying numbers is boring, so a couple
+useful functions in that domain live here.
+
+
+Dependencies
+============
+
+None.
+
+
+Overview
+========
+
+Formatting Numbers
+------------------
+
+MochiKit provides an extensible number formatting facility, modeled
+loosely after the Number Format Pattern Syntax [1]_ from Java.
+:mochiref:`numberFormatter(pattern[, placeholder=""[,
+locale="default"])` returns a function that converts Number to string
+using the given information.  ``pattern`` is a string consisting of
+the following symbols:
+
++-----------+---------------------------------------------------------------+
+| Symbol    |   Meaning                                                     |
++===========+===============================================================+
+| ``-``     |   If given, used as the position of the minus sign            |
+|           |   for negative numbers. If not given, the position            |
+|           |   to the left of the first number placeholder is used.        |
++-----------+---------------------------------------------------------------+
+| ``#``     |   The placeholder for a number that does not imply zero       |
+|           |   padding.                                                    |
++-----------+---------------------------------------------------------------+
+| ``0``     |   The placeholder for a number that implies zero padding.     |
+|           |   If it is used to the right of a decimal separator, it       |
+|           |   implies trailing zeros, otherwise leading zeros.            |
++-----------+---------------------------------------------------------------+
+| ``,``     |   The placeholder for a "thousands separator". May be used    |
+|           |   at most once, and it must be to the left of a decimal       |
+|           |   separator. Will be replaced by ``locale.separator`` in the  |
+|           |   result (the default is also ``,``).                         |
++-----------+---------------------------------------------------------------+
+| ``.``     |   The decimal separator. The quantity of ``#`` or ``0``       |
+|           |   after the decimal separator will determine the precision of |
+|           |   the result. If no decimal separator is present, the         |
+|           |   fractional precision is ``0`` -- meaning that it will be    |
+|           |   rounded to the nearest integer.                             |
++-----------+---------------------------------------------------------------+
+| ``%``     |   If present, the number will be multiplied by ``100`` and    |
+|           |   the ``%`` will be replaced by ``locale.percent``.           |
++-----------+---------------------------------------------------------------+
+
+
+API Reference
+=============
+
+Functions
+---------
+
+:mochidef:`formatLocale(locale="default")`:
+
+    Return a locale object for the given locale. ``locale`` may be
+    either a string, which is looked up in the
+    ``MochiKit.Format.LOCALE`` object, or a locale object. If no
+    locale is given, ``LOCALE.default`` is used (equivalent to
+    ``LOCALE.en_US``).
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`lstrip(str, chars="\\s")`:
+
+    Returns a string based on ``str`` with leading whitespace
+    stripped.
+
+    If ``chars`` is given, then that expression will be used instead
+    of whitespace. ``chars`` should be a string suitable for use in a
+    ``RegExp`` ``[character set]``.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`numberFormatter(pattern, placeholder="", locale="default")`:
+
+    Return a function ``formatNumber(aNumber)`` that formats numbers
+    as a string according to the given pattern, placeholder and
+    locale.
+
+    ``pattern`` is a string that describes how the numbers should be
+    formatted, for more information see `Formatting Numbers`_.
+
+    ``locale`` is a string of a known locale (en_US, de_DE, fr_FR,
+    default) or an object with the following fields:
+
+    +-----------+-----------------------------------------------------------+
+    | separator | The "thousands" separator for this locale (en_US is ",")  |
+    +-----------+-----------------------------------------------------------+
+    | decimal   | The decimal separator for this locale (en_US is ".")      |
+    +-----------+-----------------------------------------------------------+
+    | percent   | The percent symbol for this locale (en_US is "%")         |
+    +-----------+-----------------------------------------------------------+
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`percentFormat(aNumber)`:
+
+    Return a string representation of ``aNumber * 100``, rounded to a
+    maximum precision of 2 fractional digits. Roughly equivalent to:
+    ``sprintf("%.2f%%", aNumber * 100)``
+
+    In new code, you probably want to use:
+    :mochiref:`numberFormatter("#.##%")(aNumber)` instead.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`roundToFixed(aNumber, precision)`:
+
+    Return a string representation of ``aNumber``, rounded to
+    ``precision`` digits with trailing zeros. This is similar to
+    ``Number.toFixed(aNumber, precision)``, but this has
+    implementation consistent rounding behavior (some versions of
+    Safari round 0.5 down!)  and also includes preceding ``0`` for
+    numbers less than ``1`` (Safari, again).
+
+    For example, :mochiref:`roundToFixed(0.1357, 2)` returns ``0.14``
+    on every supported platform, where some return ``.13`` for
+    ``(0.1357).toFixed(2)``.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`rstrip(str, chars="\\s")`:
+
+    Returns a string based on ``str`` with trailing whitespace stripped.
+
+    If ``chars`` is given, then that expression will be used instead
+    of whitespace. ``chars`` should be a string suitable for use in a
+    ``RegExp`` ``[character set]``.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`strip(str, chars="\\s")`:
+
+    Returns a string based on ``str`` with leading and trailing
+    whitespace stripped (equivalent to :mochiref:`lstrip(rstrip(str,
+    chars), chars)`).
+
+    If ``chars`` is given, then that expression will be used instead
+    of whitespace. ``chars`` should be a string suitable for use in a
+    ``RegExp`` ``[character set]``.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`truncToFixed(aNumber, precision)`:
+
+    Return a string representation of ``aNumber``, truncated to
+    ``precision`` digits with trailing zeros. This is similar to
+    ``aNumber.toFixed(precision)``, but this truncates rather than
+    rounds and has implementation consistent behavior for numbers less
+    than 1.  Specifically, :mochiref:`truncToFixed(aNumber,
+    precision)` will always have a preceding ``0`` for numbers less
+    than ``1``.
+
+    For example, :mochiref:`truncToFixed(0.1357, 2)` returns ``0.13``.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`twoDigitAverage(numerator, denominator)`:
+
+    Calculate an average from a numerator and a denominator and return
+    it as a string rounded to a maximum precision of two fractional
+    digits (e.g. "1.23").
+
+    If the denominator is 0, "0" will be returned instead of ``NaN``.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`twoDigitFloat(aNumber)`:
+
+    Return a string representation of ``aNumber``, rounded to a maximum
+    precision of 2 fractional digits. This is a variation of
+    :mochiref:`roundToFixed(aNumber, 2)` that removes trailing zeros from
+    the fractional part.
+
+    For example, ``twoDigitFloat(0.1357)`` returns ``0.14``
+    and ``twoDigitFloat(12.00)`` returns ``12``.
+
+    In new code, you probably want to use:
+    :mochiref:`numberFormatter("#.##")(aNumber)` instead.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+See Also
+========
+
+.. [1] Java Number Format Pattern Syntax:
+       http://java.sun.com/docs/books/tutorial/i18n/format/numberpattern.html
+
+
+Authors
+=======
+
+- Bob Ippolito <bob@redivi.com>
+
+
+Copyright
+=========
+
+Copyright 2005 Bob Ippolito <bob@redivi.com>. This program is
+dual-licensed free software; you can redistribute it and/or modify it
+under the terms of the `MIT License`_ or the `Academic Free License
+v2.1`_.
+
+.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
+.. _`Academic Free License v2.1`: http://www.opensource.org/licenses/afl-2.1.php