p5-python 0.6.12__py3-none-any.whl → 0.9.1__py3-none-any.whl

p5/__init__.py

@@ -1,47 +1,294 @@
+"""p5-python: a friendly Python drawing library using p5.js conventions.
+
+A minimal sketch looks like this::
+
+    from p5 import *
+
+    def setup():
+        createCanvas(400, 400)
+
+    def draw():
+        background(220)
+        circle(width / 2, height / 2, 100)
+
+    run()
+
+The module intentionally exports the most commonly used p5 functions.  Live
+values such as ``mouseX``, ``width`` or ``frameCount`` are available as bare
+names inside a sketch (they are backed by :mod:`builtins`), and can also be
+read as ``p5.mouseX`` etc.
+"""
+
+import builtins
 import os
-os.environ['PYGAME_HIDE_SUPPORT_PROMPT'] = "hide"
-
-from p5.corefunctions import (run, createCanvas, saveCanvas, angleMode, rectMode, ellipseMode,
-                              line, ellipse, circle, rect, quad, arc, triangle, bezier,
-                              point, beginShape, vertex, curveVertex, curve, bezierVertex,
-                              endShape, cursor, strokeWeight, noStroke, 
-                              loadImage, image, keyIsDown, frameRate, loop, noLoop,  
-                              background,text,textFont, textSize, textStyle, textAlign)
-
-from p5.constants import (TWO_PI, HALF_PI, PI, QUARTER_PI, TAU, CURSOR_ARROW, CURSOR_DIAMOND, 
-    CURSOR_BROKEN_X, CURSOR_TRI_LEFT, CURSOR_TRI_RIGHT, BOLD, ITALIC, BOLDITALIC, NORMAL,
-    BACKSPACE,TAB,RETURN,ENTER,PAUSE,ESCAPE,SPACE,DELETE,EXCLAIM,QUOTEDBL,HASH,DOLLAR,AMPERSAND,QUOTE,LEFTPAREN,RIGHTPAREN,
-    ASTERISK,PLUS,COMMA,MINUS,PERIOD,SLASH,COLON,SEMICOLON,LESS,EQUALS,GREATER,QUESTION,AT,LEFTBRACKET,RIGHTBRACKET,CARET,
-    UNDERSCORE,BACKQUOTE,UP,DOWN,RIGHT,LEFT,UP_ARROW,DOWN_ARROW,LEFT_ARROW,RIGHT_ARROW,INSERT,HOME,END,PAGEUP,PAGEDOWN,PGUP,
-    PGDN,KP0,KP1,KP2,KP3,KP4,KP5,KP6,KP7,KP8,KP9,KP_PERIOD,KP_DIVIDE,KP_MULTIPLY,KP_MINUS,KP_PLUS,F1,F2,F3,F4,F5,
-    F6,F7,F8,F9,F10,F11,F12,NUMLOCK,CAPSLOCK,SCROLLOCK,RSHIFT,LSHIFT,RCTRL,LCTRL,RALT,LALT,RMETA,LMETA,CONTEXTMENU,
-    PRINT,SYSREQ,BREAK,MENU,CENTER,CLOSE,RADIANS,DEGREES, CORNER, CORNERS, RADIUS,CHORD, PIE, OPEN, ARC)
-    
-from p5.mathfunctions import (pow, map, randomSeed, random, constrain, floor, ceil, dist, exp, lerp, log, log10, log2, logb, mag,
-                              rerange, norm, sq, sqrt, frac, sin, cos, tan, asin, acos, atan, atan2, degrees, radians, integral)
-
-from p5.color import (fill,noFill, stroke, red, green, blue, brightness, hue, lightness, saturation, lerpColor, color, alpha)
-
-from p5.timedata import (hour, minute, second, day, month, year, milli_sec,  millis)
-
-from p5.transform import (scale, rotate, translate,  push, pop, resetMatrix)
-
-__all__ = ["run", "createCanvas", "translate", "background", "fill", "noFill", "line", "ellipse", "circle", "rect", "triangle", "quad", "arc",
-    "push", "pop", "cursor", "TWO_PI", "HALF_PI", "PI", "QUARTER_PI", "TAU", "CURSOR_ARROW", "CURSOR_DIAMOND", "CURSOR_BROKEN_X", "CURSOR_TRI_LEFT",
-    "CURSOR_TRI_RIGHT", "BOLD", "ITALIC", "BOLDITALIC", "NORMAL", "strokeWeight", "stroke", "noStroke", "loadImage", "image", "point", "CORNER", "CORNERS", "RADIUS",
-     "frameRate", "random", "constrain", "floor", "ceil", "dist", "exp", "lerp", "log", "log10", "log2", "logb", "mag", "textAlign", "CHORD", "PIE", "OPEN", "ARC",
-    "rerange", "norm", "sq", "sqrt", "frac", "sin", "cos", "tan", "asin", "acos", "atan", "atan2", "degrees",    "radians", "loop", "noLoop", "integral",
-    "text","textFont", "textSize", "textStyle","beginShape", "vertex", "endShape", "keyIsDown", "saveCanvas", "scale", "rotate", "translate", "rectMode", "ellipseMode",
-    "BACKSPACE","TAB","RETURN","ENTER","PAUSE","ESCAPE","SPACE","DELETE","EXCLAIM","QUOTEDBL","HASH","DOLLAR","AMPERSAND","QUOTE","LEFTPAREN","RIGHTPAREN",
-    "ASTERISK","PLUS","COMMA","MINUS","PERIOD","SLASH","COLON","SEMICOLON","LESS","EQUALS","GREATER","QUESTION","AT","LEFTBRACKET","RIGHTBRACKET","CARET",
-    "UNDERSCORE","BACKQUOTE","UP","DOWN","RIGHT","LEFT","UP_ARROW","DOWN_ARROW","LEFT_ARROW","RIGHT_ARROW","INSERT","HOME","END","PAGEUP","PAGEDOWN","PGUP",
-    "PGDN","KP0","KP1","KP2","KP3","KP4","KP5","KP6","KP7","KP8","KP9","KP_PERIOD","KP_DIVIDE","KP_MULTIPLY","KP_MINUS","KP_PLUS","F1","F2","F3","F4","F5",
-    "F6","F7","F8","F9","F10","F11","F12","NUMLOCK","CAPSLOCK","SCROLLOCK","RSHIFT","LSHIFT","RCTRL","LCTRL","RALT","LALT","RMETA","LMETA","CONTEXTMENU",
-    "PRINT","SYSREQ","BREAK","MENU","CENTER","CLOSE", "pow", "map", "angleMode", "curveVertex", "randomSeed", "resetMatrix",
-    "hour", "minute", "second", "day", "month", "year", "milli_sec", "millis", "curve", "bezierVertex", "bezier"
-]
 
-__version__ = "0.6.12"
+os.environ.setdefault("PYGAME_HIDE_SUPPORT_PROMPT", "hide")
+
+import p5.constants as _constants
+
+from p5.constants import *  # noqa: F401,F403
+from p5.constants import __all__ as _constant_names
+
+from p5.corefunctions import (  # noqa: F401
+    angleMode,
+    arc,
+    background,
+    beginShape,
+    bezier,
+    bezierVertex,
+    blendMode,
+    circle,
+    clear,
+    createCanvas,
+    curve,
+    curveVertex,
+    cursor,
+    doubleClicked,
+    ellipse,
+    ellipseMode,
+    endShape,
+    eventsManager,
+    frameRate,
+    get,
+    getFrameRate,
+    image,
+    imageMode,
+    isLooping,
+    keyIsDown,
+    line,
+    loadFont,
+    loadImage,
+    loadPixels,
+    loop,
+    mouseClicked,
+    mouseDragged,
+    mouseMoved,
+    mousePressed,
+    mouseReleased,
+    mouseWheel,
+    mouse,
+    noCursor,
+    noLoop,
+    noSmooth,
+    noTint,
+    pixelDensity,
+    point,
+    quad,
+    rect,
+    rectMode,
+    redraw,
+    resizeCanvas,
+    run,
+    saveCanvas,
+    saveFrame,
+    screen,
+    set,
+    smooth,
+    square,
+    stop,
+    strokeCap,
+    strokeJoin,
+    strokeWeight,
+    text,
+    textAlign,
+    textFont,
+    textLeading,
+    textSize,
+    textStyle,
+    textWidth,
+    textWrap,
+    tint,
+    triangle,
+    updatePixels,
+    vertex,
+    print,
+    println,
+)
+
+from p5.image import PImage, createImage  # noqa: F401
+
+from p5.color import (  # noqa: F401
+    alpha,
+    blue,
+    brightness,
+    color,
+    colorMode,
+    fill,
+    green,
+    hue,
+    lerpColor,
+    lightness,
+    noFill,
+    noStroke,
+    red,
+    saturation,
+    stroke,
+)
 
-print("Thank you for using p5\n")
+from p5.mathfunctions import (  # noqa: F401
+    abs,
+    acos,
+    asin,
+    atan,
+    atan2,
+    ceil,
+    constrain,
+    cos,
+    degrees,
+    dist,
+    exp,
+    floor,
+    frac,
+    fract,
+    integral,
+    lerp,
+    log,
+    log10,
+    log2,
+    logb,
+    mag,
+    map,
+    max,
+    min,
+    noise,
+    noiseDetail,
+    noiseSeed,
+    norm,
+    nf,
+    pow,
+    radians,
+    random,
+    randomGaussian,
+    randomSeed,
+    rerange,
+    round,
+    shuffle,
+    sign,
+    sin,
+    sq,
+    sqrt,
+    tan,
+)
+
+from p5.timedata import (  # noqa: F401
+    day,
+    hour,
+    milli_sec,
+    millis,
+    minute,
+    month,
+    second,
+    year,
+)
+
+from p5.transform import (  # noqa: F401
+    applyMatrix,
+    pop,
+    push,
+    resetMatrix,
+    rotate,
+    scale,
+    shearX,
+    shearY,
+    translate,
+)
+
+from p5.corefunctions import (  # noqa: F401
+    ambientLight,
+    box,
+    camera,
+    cone,
+    cylinder,
+    directionalLight,
+    environment,
+    frustum,
+    keyboard,
+    noLights,
+    ortho,
+    perspective,
+    pointLight,
+    rotateX,
+    rotateY,
+    rotateZ,
+    sphere,
+    spotLight,
+    textAscent,
+    textDescent,
+    torus,
+)
+
+from p5.vector import Vector, createVector  # noqa: F401
+
+PVector = Vector  # Processing-style alias
+
+__version__ = "0.9.1"
+
+
+# Names that are live values rather than functions.  They are stored in
+# builtins so sketches can use ``width``, ``mouseX``, ... directly; __getattr__
+# makes ``p5.width`` work as well.
+_LIVE_VALUES = {
+    "width", "height", "displayWidth", "displayHeight", "windowWidth",
+    "windowHeight", "mouseX", "mouseY", "pmouseX", "pmouseY", "movedX",
+    "movedY", "mouseButton", "mouseIsPressed", "mouseWheelDelta", "key",
+    "keyCode", "keyIsPressed", "frameCount", "deltaTime", "pixels",
+    "is_Looping", "focused",
+}
+
+
+def __getattr__(name):
+    if name in _LIVE_VALUES:
+        return getattr(builtins, name)
+    raise AttributeError("module {!r} has no attribute {!r}".format(__name__, name))
+
+
+__all__ = list(_constant_names) + [
+    # canvas / environment
+    "run", "createCanvas", "resizeCanvas", "saveCanvas", "saveFrame",
+    "background", "clear", "frameRate", "getFrameRate", "loop", "noLoop",
+    "redraw", "isLooping", "cursor", "noCursor", "pixelDensity", "smooth",
+    "noSmooth", "angleMode", "stop",
+    # shapes
+    "arc", "ellipse", "circle", "line", "point", "quad", "rect", "square",
+    "triangle", "bezier", "curve", "beginShape", "vertex", "curveVertex",
+    "bezierVertex", "endShape",
+    # drawing settings
+    "ellipseMode", "rectMode", "imageMode", "strokeWeight", "strokeCap",
+    "strokeJoin", "blendMode",
+    # typography
+    "text", "textFont", "textSize", "textStyle", "textAlign", "textWidth",
+    "textLeading", "textWrap", "loadFont", "textAscent", "textDescent",
+    # images / pixels
+    "loadImage", "image", "PImage", "createImage", "tint", "noTint",
+    "loadPixels", "updatePixels", "get", "set", "screen",
+    # utilities
+    "print", "println",
+    # colour
+    "fill", "noFill", "stroke", "noStroke", "color", "colorMode", "alpha",
+    "red", "green", "blue", "brightness", "hue", "lightness", "saturation",
+    "lerpColor",
+    # math
+    "abs", "ceil", "constrain", "cos", "degrees", "dist", "exp", "floor",
+    "frac", "fract", "integral", "lerp", "log", "log10", "log2", "logb",
+    "mag", "map", "max", "min", "noise", "noiseDetail", "noiseSeed", "norm",
+    "pow", "radians", "random", "randomGaussian", "randomSeed", "rerange",
+    "round", "sign", "sin", "sq", "sqrt", "tan", "atan", "atan2", "acos",
+    "asin", "shuffle", "nf",
+    # transform
+    "applyMatrix", "pop", "push", "resetMatrix", "rotate", "scale", "shearX",
+    "shearY", "translate",
+    # vectors
+    "Vector", "createVector", "PVector",
+    # time
+    "day", "hour", "milli_sec", "millis", "minute", "month", "second", "year",
+    # input
+    "keyIsDown", "mouse", "keyboard", "environment", "doubleClicked",
+    "focused",
+    # 3d (compatibility stubs)
+    "ambientLight", "directionalLight", "pointLight", "spotLight", "noLights",
+    "box", "sphere", "torus", "cone", "cylinder", "camera", "perspective",
+    "ortho", "frustum", "rotateX", "rotateY", "rotateZ",
+]
 
+# Remove duplicates while keeping a deterministic order.
+__all__ = list(dict.fromkeys(__all__))

p5/__main__.py

@@ -1,50 +1,35 @@
-#
-# Part of p5: A Python package based on Processing
-# Copyright (C) 2017-2019 Abhik Pal
-#
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful, but
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-# General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program. If not, see <http://www.gnu.org/licenses/>.
-#
-
-from . import p5
-
-# we should be parsing sys args here and expose a series of commands
-# similar to processing-java.
-#
-# relevant output from `processing-java --help`:
-#
-#     --help               Show this help text. Congratulations.
-#
-#     --sketch=<name>      Specify the sketch folder (required)
-#
-#     --output=<name>      Specify the output folder (optional and
-#                          cannot be the same as the sketch folder.)
-#
-#     --force              The sketch will not build if the output
-#                          folder already exists, because the contents
-#                          will be replaced. This option erases the
-#                          folder first. Use with extreme caution!
-#
-#     --build              Preprocess and compile a sketch into .class files.
-#
-#     --run                Preprocess, compile, and run a sketch.
-#
-#     --present            Preprocess, compile, and run a sketch in presentation mode.
-#
-#     --export             Export an application.
-#
-#     --no-java            Do not embed Java. Use at your own risk!
-#
-#     --platform           Specify the platform (export to application only).
-#                          Should be one of 'windows', 'macosx', or 'linux'.
-#
+"""Command line helper: ``python -m p5 sketch.py``.
+
+The sketch itself is expected to call :func:`p5.run` (the usual p5 style).
+"""
+
+import argparse
+import runpy
+import sys
+
+from p5 import __version__
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(
+        prog="p5",
+        description="Run a p5-python sketch.",
+    )
+    parser.add_argument("sketch", nargs="?", help="path to a Python sketch file")
+    parser.add_argument("--version", action="version", version="p5-python " + __version__)
+    args = parser.parse_args(argv)
+
+    if not args.sketch:
+        parser.print_help()
+        return 1
+
+    try:
+        runpy.run_path(args.sketch, run_name="__main__")
+    except FileNotFoundError:
+        print("p5: sketch not found: {}".format(args.sketch), file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())