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. |