| Name | CreativePython JSON |
| Version |
0.2.1
JSON |
| download |
| home_page | None |
| Summary | A Python-based software environment for developing algorithmic art projects. |
| upload_time | 2025-10-22 19:14:07 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT License
Copyright (c) 2025 Dr. Bill Manaris
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
================================================================================
THIRD PARTY COMPONENTS
================================================================================
This software includes PENCIL, a derivative work based on IDLE (Integrated
Development and Learning Environment), which is part of Python and distributed
under the Python Software Foundation License Version 2.
IDLE Components:
- Location: resources/pencillib/
- Copyright: © 2001-2023 Python Software Foundation. All Rights Reserved.
- License: Python Software Foundation License Version 2 (see LICENSE-PSF.txt)
- Original Authors: Guido van Rossum and Python development team
- PENCIL Modifications: Copyright © 2025 Dr. Bill Manaris
For complete IDLE/PENCIL licensing information and contributor credits, see:
- LICENSE-PSF.txt (Python Software Foundation License)
- resources/pencillib/CREDITS.txt (Complete contributor list) |
| keywords |
music
audio
midi
learning
algorithmic art
algoart
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# CreativePython
CreativePython is a Python-based software environment for learning and developing algorithmic art projects. It mirrors the [JythonMusic API](https://jythonmusic.me/api-reference/), and is powered by [PySide6](https://wiki.qt.io/Qt_for_Python) and [portaudio](http://portaudio.com/).
CreativePython is distributed under the MIT License.
- [Homepage](https://jythonmusic.me/)
- [Download All Examples [ZIP]](https://www.dropbox.com/scl/fo/rvc8m8pt4m0281qn0t4oi/AO2Y0W2qOrOcurlQmLa7M54?rlkey=0sf80bmov135tc85dk9k7ats6&dl=1)
This package is still under development.
# Requirements
Before installing CreativePython, you will need:
- **Python3**, version 3.9 or greater [[Download](https://www.python.org/downloads/)]
- **A C++ compiler** (see **Troubleshooting** below)
# Beginner Installation (Windows/MacOS)
COMING SOON
# Custom Installation
If you're familiar with Python development, we recommend installing CreativePython through the Command Prompt/Terminal.
## Windows
Install CreativePython using `pip`:
```
python -m pip install CreativePython
```
## MacOS
Use [Homebrew](https://brew.sh/) to install the prerequisite [portaudio](http://portaudio.com/) library, then install CreativePython using `pip`:
```
brew install portaudio
pip install CreativePython
```
## Linux
Use apt, or your preferred package manager, to install the prerequisite [portaudio](http://portaudio.com/) library, then install CreativePython using `pip`:
```
sudo apt-get portaudio
pip install CreativePython
```
# Using CreativePython
## Importing Libraries
CreativePython's core modules are the `music`, `gui`, `image`, `timer`, `osc`, and `midi` libraries. You can import these libraries into your python code using:
```
import music
from music import *
from music import Note, Play, C4, HN
```
Or a similar statement. CreativePython includes a number of useful constants, so we recommend using wildcard imports like `from music import *`.
**NOTE:** The first time you import `music`, CreativePython will download a high-quality soundfont (FluidR3 G2-2.sf2) for you. You should only have to do this once.
## Running CreativePython programs
CreativePython is designed for use in Python's Interactive Mode. To use Interactive Mode, enter a command like:
```
python -i <filename>.py
```
## Example
Download [playNote.py](https://www.dropbox.com/scl/fi/z6rkjy4xnofmg0t899se3/playNote.py?rlkey=o3t8c91ne6agj2lqf2aupl8m5&dl=1):
```
# playNote.py
# Demonstrates how to play a single note.
from music import * # import music library
note = Note(C4, HN) # create a middle C half note
Play.midi(note) # and play it!
```
In IDLE, you can open playNote.py, and select **Run**, then **Run Module** from the toolbar.
In a terminal, run playNote.py in interactive mode:
```
python -i playNote.py
```
After you do, you should hear a single C4 half-note.
## Troubleshooting
### CMake configuration failed
Some of CreativePython's libraries may need to compile C++ code during installation.
- On Windows, download and install [Visual Studio Build Tools 2022](https://visualstudio.microsoft.com/downloads/). In the Visual Studio installer, make sure "Desktop Development with C++" is checked.
- On MacOS, you can download and install [XCode from the App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12).
Restart your computer, then try installing CreativePython again.
# PENCIL Editor
CreativePython is also available as PENCIL, a customized Python IDE based on IDLE (Python's Integrated Development and Learning Environment).
## Attribution
PENCIL is derived from IDLE, which is part of Python and created by Guido van Rossum and the Python development team. IDLE is distributed under the Python Software Foundation License Version 2.
**Original IDLE Credits:**
- Copyright © 2001-2023 Python Software Foundation. All Rights Reserved.
- See `resources/pencillib/CREDITS.txt` for complete IDLE contributor list.
**PENCIL Modifications:**
- Copyright © 2025 Dr. Bill Manaris
- Modified for use with CreativePython
- Includes custom "JEM" theme and keymap defaults
- User configuration stored in `~/.pencilrc/`
## Licenses
- **CreativePython**: MIT License (see `LICENSE`)
- **IDLE/PENCIL**: Python Software Foundation License Version 2 (see `LICENSE-PSF.txt`)
For complete licensing information, see the `LICENSE` and `LICENSE-PSF.txt` files in this distribution.
Raw data
{
"_id": null,
"home_page": null,
"name": "CreativePython",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "music, audio, midi, learning, algorithmic art, algoart",
"author": null,
"author_email": "\"Dr. Bill Manaris\" <manaris@cofc.edu>, Taj Ballinger <ballingertj@g.cofc.edu>, Trevor Ritchie <ritchiets@g.cofc.edu>",
"download_url": "https://files.pythonhosted.org/packages/83/00/089f10c29543c84a6a969302e682466325118d4a0c467a73740e10b70a5a/creativepython-0.2.1.tar.gz",
"platform": null,
"description": "# CreativePython\n\nCreativePython is a Python-based software environment for learning and developing algorithmic art projects. It mirrors the [JythonMusic API](https://jythonmusic.me/api-reference/), and is powered by [PySide6](https://wiki.qt.io/Qt_for_Python) and [portaudio](http://portaudio.com/).\n\nCreativePython is distributed under the MIT License.\n\n- [Homepage](https://jythonmusic.me/)\n- [Download All Examples [ZIP]](https://www.dropbox.com/scl/fo/rvc8m8pt4m0281qn0t4oi/AO2Y0W2qOrOcurlQmLa7M54?rlkey=0sf80bmov135tc85dk9k7ats6&dl=1)\n\nThis package is still under development.\n\n# Requirements\n\nBefore installing CreativePython, you will need:\n\n- **Python3**, version 3.9 or greater [[Download](https://www.python.org/downloads/)]\n- **A C++ compiler** (see **Troubleshooting** below)\n\n# Beginner Installation (Windows/MacOS)\n\nCOMING SOON\n\n# Custom Installation\n\nIf you're familiar with Python development, we recommend installing CreativePython through the Command Prompt/Terminal.\n\n## Windows\n\nInstall CreativePython using `pip`:\n\n```\npython -m pip install CreativePython\n```\n\n## MacOS\n\nUse [Homebrew](https://brew.sh/) to install the prerequisite [portaudio](http://portaudio.com/) library, then install CreativePython using `pip`:\n\n```\nbrew install portaudio\npip install CreativePython\n```\n\n## Linux\n\nUse apt, or your preferred package manager, to install the prerequisite [portaudio](http://portaudio.com/) library, then install CreativePython using `pip`:\n\n```\nsudo apt-get portaudio\npip install CreativePython\n```\n\n# Using CreativePython\n\n## Importing Libraries\n\nCreativePython's core modules are the `music`, `gui`, `image`, `timer`, `osc`, and `midi` libraries. You can import these libraries into your python code using:\n\n```\nimport music\nfrom music import *\nfrom music import Note, Play, C4, HN\n```\n\nOr a similar statement. CreativePython includes a number of useful constants, so we recommend using wildcard imports like `from music import *`.\n\n**NOTE:** The first time you import `music`, CreativePython will download a high-quality soundfont (FluidR3 G2-2.sf2) for you. You should only have to do this once.\n\n## Running CreativePython programs\n\nCreativePython is designed for use in Python's Interactive Mode. To use Interactive Mode, enter a command like:\n\n```\npython -i <filename>.py\n```\n\n## Example\n\nDownload [playNote.py](https://www.dropbox.com/scl/fi/z6rkjy4xnofmg0t899se3/playNote.py?rlkey=o3t8c91ne6agj2lqf2aupl8m5&dl=1):\n\n```\n# playNote.py\n# Demonstrates how to play a single note.\n \nfrom music import * # import music library\n \nnote = Note(C4, HN) # create a middle C half note\nPlay.midi(note) # and play it!\n```\n\nIn IDLE, you can open playNote.py, and select **Run**, then **Run Module** from the toolbar.\n\nIn a terminal, run playNote.py in interactive mode:\n\n```\npython -i playNote.py\n```\n\nAfter you do, you should hear a single C4 half-note.\n\n## Troubleshooting\n\n### CMake configuration failed\n\nSome of CreativePython's libraries may need to compile C++ code during installation.\n\n- On Windows, download and install [Visual Studio Build Tools 2022](https://visualstudio.microsoft.com/downloads/). In the Visual Studio installer, make sure \"Desktop Development with C++\" is checked.\n\n- On MacOS, you can download and install [XCode from the App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12).\n\nRestart your computer, then try installing CreativePython again.\n\n# PENCIL Editor\n\nCreativePython is also available as PENCIL, a customized Python IDE based on IDLE (Python's Integrated Development and Learning Environment).\n\n## Attribution\n\nPENCIL is derived from IDLE, which is part of Python and created by Guido van Rossum and the Python development team. IDLE is distributed under the Python Software Foundation License Version 2.\n\n**Original IDLE Credits:**\n- Copyright \u00a9 2001-2023 Python Software Foundation. All Rights Reserved.\n- See `resources/pencillib/CREDITS.txt` for complete IDLE contributor list.\n\n**PENCIL Modifications:**\n- Copyright \u00a9 2025 Dr. Bill Manaris\n- Modified for use with CreativePython\n- Includes custom \"JEM\" theme and keymap defaults\n- User configuration stored in `~/.pencilrc/`\n\n## Licenses\n\n- **CreativePython**: MIT License (see `LICENSE`)\n- **IDLE/PENCIL**: Python Software Foundation License Version 2 (see `LICENSE-PSF.txt`)\n\nFor complete licensing information, see the `LICENSE` and `LICENSE-PSF.txt` files in this distribution.\n",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2025 Dr. Bill Manaris\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.\n \n ================================================================================\n THIRD PARTY COMPONENTS\n ================================================================================\n \n This software includes PENCIL, a derivative work based on IDLE (Integrated\n Development and Learning Environment), which is part of Python and distributed\n under the Python Software Foundation License Version 2.\n \n IDLE Components:\n - Location: resources/pencillib/\n - Copyright: \u00a9 2001-2023 Python Software Foundation. All Rights Reserved.\n - License: Python Software Foundation License Version 2 (see LICENSE-PSF.txt)\n - Original Authors: Guido van Rossum and Python development team\n - PENCIL Modifications: Copyright \u00a9 2025 Dr. Bill Manaris\n \n For complete IDLE/PENCIL licensing information and contributor credits, see:\n - LICENSE-PSF.txt (Python Software Foundation License)\n - resources/pencillib/CREDITS.txt (Complete contributor list)",
"summary": "A Python-based software environment for developing algorithmic art projects.",
"version": "0.2.1",
"project_urls": {
"Homepage": "https://jythonmusic.me"
},
"split_keywords": [
"music",
" audio",
" midi",
" learning",
" algorithmic art",
" algoart"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "aa9aff647a660418263ee42c23ff76819ef8c7b9680fb888854c0c3c6b37f83e",
"md5": "d9188be6c270c8ac93adbc463f581489",
"sha256": "2a9f42abae8ebbbf2e86f4319133547e400bedf639656da98ac54ee844bcfd48"
},
"downloads": -1,
"filename": "creativepython-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d9188be6c270c8ac93adbc463f581489",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 1404054,
"upload_time": "2025-10-22T19:14:04",
"upload_time_iso_8601": "2025-10-22T19:14:04.435818Z",
"url": "https://files.pythonhosted.org/packages/aa/9a/ff647a660418263ee42c23ff76819ef8c7b9680fb888854c0c3c6b37f83e/creativepython-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8300089f10c29543c84a6a969302e682466325118d4a0c467a73740e10b70a5a",
"md5": "d18b8083561bc9bfc938f12d06ccf1b4",
"sha256": "9b35deb3576c74e55be07feba765629e5f2c45f86f3890d11cc54fd3d7da3ab6"
},
"downloads": -1,
"filename": "creativepython-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "d18b8083561bc9bfc938f12d06ccf1b4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 1384174,
"upload_time": "2025-10-22T19:14:07",
"upload_time_iso_8601": "2025-10-22T19:14:07.098318Z",
"url": "https://files.pythonhosted.org/packages/83/00/089f10c29543c84a6a969302e682466325118d4a0c467a73740e10b70a5a/creativepython-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 19:14:07",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "creativepython"
}
