No edit summary
No edit summary
Line 3: Line 3:
=== Usage ===
=== Usage ===
A learner will:
A learner will:
*review and run included examples,
*review and run an included example module,
*modify included examples, and run them,
*modify an included example module, and run the modified version,
*derive more complex code using included examples,
*build on an included example module, without change to the example module, by importing it into new code,
*build on an included example module, with modifications,
*derive more complex code using modules created by teachers or other learner, with or without changing the contributed module,
*derive more complex code using modules created by teachers or other learner, with or without changing the contributed module,
*write fresh modules.
*write fresh modules.
Line 26: Line 27:
=== Data ===
=== Data ===
A running Pippy instance will contain the following data:
A running Pippy instance will contain the following data:
*zero or more modules (each module is a python zip bundle, not a sugar bundle),
*zero or more modules (either pure python modules, packages, or distutil source distributions, though not a sugar bundle),
*each module will include zero or more source files,
*each module will include zero, one (pure python modules) or more (packages or distutil source distributions) source files,
*each module will include a source file setup.py capable of creating the python zip bundle output, but unless the user has asked to edit the setup.py, it will not be shown, instead a default will be used, maintained by Pippy,
*each module will include a source file setup.py capable of creating the python zip bundle output, but unless the user has asked to edit the setup.py, it will not be shown, instead a default will be used, maintained by Pippy,


Line 80: Line 81:
Pippy provides example scripts written in Python, allows the learner to run them, edit them, and save them as a journal entry.
Pippy provides example scripts written in Python, allows the learner to run them, edit them, and save them as a journal entry.
See [http://docs.python.org/tutorial/modules.html definition of the term script and discussion of modules].
See [http://docs.python.org/tutorial/modules.html definition of the term script and discussion of modules].
[http://docs.python.org/distutils/introduction.html for definitions] ... module, pure python module, package.