CreativePython 0.0.3__tar.gz → 0.1.0__tar.gz

{creativepython-0.0.3/src/CreativePython.egg-info → creativepython-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: CreativePython
-Version: 0.0.3
+Version: 0.1.0
 Summary: A Python-based software environment for developing algorithmic art projects.
 Author-email: "Dr. Bill Manaris" <manaris@cofc.edu>, Taj Ballinger <ballingertj@g.cofc.edu>, Trevor Ritchie <ritchiets@g.cofc.edu>
 License: MIT License
@@ -41,6 +41,7 @@ Requires-Dist: pyaudio>=0.2.14
 Requires-Dist: PySide6>=6.9.1
 Requires-Dist: sounddevice>=0.5.2
 Requires-Dist: soundfile>=0.13.1
+Requires-Dist: tqdm>=4.67.1
 Requires-Dist: pooch>=1.8
 Requires-Dist: platformdirs>=4.2
 Requires-Dist: pypianoroll>=1.0
@@ -62,12 +63,12 @@ This package is still under development.
 The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7cwxayca38ajcc533bpgs/AGP4pnP-xhb-5LH_7YPsgyk?rlkey=2led17m6h0ku9y3hzbsnvsio1&dl=1) install CreativePython and all its required software, including Python3, FluidSynth, PortAudio, ffmpeg, Homebrew (on Mac), and Windows Build Kit (on Windows).
 
 ### Windows 
-  1. Open `win-scripts.tgz`.  Right-click `windows_setup.bat`, and **Run as Administrator** (it will open PowerShell and run).  
+  1. Open `win-scripts.zip`.  Right-click `windows_setup.ps1`, and **Run with PowerShell** (it will open a PowerShell window and begin installing).  
   2. Follow any prompts and let it finish.
     - If you do not have Windows Build Kit installed, it will be installed as part of this process.  This may take some time to complete.
 
 ### macOS 
-  1. Open `mac-scripts.tgz`.  Control-click `mac_setup.command`, and **Open** (it will open Terminal and run).
+  1. Open `mac-scripts.tgz`.  Control-click `mac_setup.command`, and **Open** (it will open a Terminal window and begin installing).
   2. Follow any prompts and let it finish.
     - If you do not have Command Line Tools for XCode installed, it will be installed as part of this process.  This may take some time to complete.
 
@@ -80,28 +81,38 @@ The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7
 ### 1. Install Python 3 + pip
 
 #### Windows
-1. Download the [Python 3 installer](https://www.python.org/downloads/).  
-2. Run the installer. **Check the box that says “Add Python to PATH”** before clicking *Install Now*.  
-3. Open Command Prompt (search for "cmd" in the Start menu).
-4. Verify your installation.
+1. Open PowerShell as Administrator (search "PowerShell" in the Start menu, and select "Run as Administrator").  Copy and Paste the following commands at each step.
+
+2. Install **Chocolatey** if you don't have it. [(Documentation)](https://docs.chocolatey.org/en-us/choco/setup/)  Copy/Paste the following command:
+
+   ```Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))```
+
+   When finished, exit this window and open a new PowerShell window.
+
+3. Install Python 3.
+
+   ```Invoke-Expressed "choco install python -y"```
 
-   ```$ python --version```
+4. Verify that Python was installed.
+
+   ```py --version```
 
    You should see something like "Python 3.12.4"
 
 #### MacOS
-1. Open Terminal (press Command + Space, type "Terminal", and hit Enter).
+1. Open Terminal (press Command + Space, type "Terminal", and hit Enter).  Copy and Paste the following commands at each step.
+
 2. Install **Homebrew** if you don't have it.
 
-   ```$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"```
+   ```/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"```
 
 3. Install Python 3.
 
-   ```$ brew install python```
+   ```brew install python```
 
 4. Verify your installation.
 
-   ```$ python3 --version```
+   ```python3 --version```
 
    You should see something like "Python 3.12.4"
 
@@ -110,27 +121,53 @@ The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7
 ### 2. Install System Libraries
 
 #### Windows
+- **Microsoft Build Tools**
+Microsoft Build Tools contains the necessary tools to compile C++ packages that come with some Python libraries.
+
+   1. Open a new PowerShell window.
+
+   2. Download the latest Microsoft Build Tools.
+
+      ```Invoke-WebRequest -Uri "https://aka.ms/vs/17/release/vs_buildtools.exe" -OutFile "$env:TEMP\vs_buildtools.exe"```
+
+   3. Run the Installer.
+
+      ```Start-Process "$env:TEMP\vs_buildtools.exe" -ArgumentList "--installPath C:\Program Files\Microsoft Build Tools" --quiet --wait --norestart --nocache --includeRecommended --add Microsoft.VisualStudio.Workload.VCTools" -Wait```
+
+   4. Add Build Tools to your PATH.
+
+      ```[Environment]::SetEnvironmentVariable("PATH", "$(Join-Path (Get-ChildItem 'C:\Program Files\Microsoft Build Tools\VC\Tools\MSVC' -Directory | Sort-Object Name -Descending | Select-Object -First 1).FullName 'bin\Hostx64\x64');$env:PATH", [EnvironmentVariableTarget]::Machine)```
+
+   5. Verify your Installation.
+
+      ```Get-Command nmake.exe```
+
+      You should see a list of Applications, likely only containing 'nmake.exe'.
+
+      If you get an error, try the command in a new PowerShell window.
+
+
 - **PortAudio**:
-   On Windows, PortAudio is installed automatically with CreativePython, however you need Microsoft Build Tools installed first.
-   1. Download [the latest Windows build](https://visualstudio.microsoft.com/visual-cpp-build-tools/).
-   2. Run the installer.  When prompted, select **C++ build tools**.
-   3. Click **Install**.  This may take several minutes.
+   On Windows, PortAudio comes with our Python libraries below.
 
 - **FluidSynth**:
-   1. Download [the latest Windows build](https://github.com/FluidSynth/fluidsynth/releases).
-   2. Unzip it, and add the folder's location to your PATH.
+   1. Open a new PowerShell window.
+   2. Install the latest FluidSynth.
+
+      ```Invoke-Expression "choco install fluidsynth -y"```
 
 - **ffmpeg**:
-   1. Download [the latest Windows build](ffmpeg.org/download.html).
-   2. Unzip it, and move the folder to `C:\ffmpeg`.
-   3. Add `C:\ffmpeg\bin` to your PATH.
+   1. Open a new PowerShell window.
+   2. Install the latest FFmpeg.
+
+      ```Invoke-Expression "choco install ffmpeg -y"```
 
 #### Mac
 - **All Libraries**:
    1. Open Terminal.
    2. Install PortAudio, FluidSynth, and ffmpeg.
 
-      ```$ brew install portaudio fluidsynth ffmpeg```
+      ```brew install portaudio fluidsynth ffmpeg```
 
 ---
 
@@ -139,16 +176,14 @@ The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7
 #### Any OS
 1. Open Command Prompt/Terminal.
 
-   ```$ pip install CreativePython```
-
-   ```$ cp-setup```
+   ```pip install CreativePython```
 
-2. When prompted, download the default soundfont.  (It's FluidR3 GM2-2, by the way)
+   ```cp-setup```
 
-   - If you choose not to download the soundfont, you will need to provide your own.
+2. When prompted, download the default soundfont (It's FluidR3 GM2-2, by the way).  If you choose not to download the soundfont, you will need to provide your own.
 
 3. Verify your installation.
 
-   ```$ cp-test```
+   ```cp-test```
 
    You should hear a single MIDI note played at C4.  If so, you're all set!

creativepython-0.1.0/README.md

@@ -0,0 +1,137 @@
+# CreativePython
+
+CreativePython is a Python-based software environment for developing algorithmic art projects.  It mirrors the [JythonMusic API](https://jythonmusic.me/api-reference/).
+
+This package is still under development.
+
+---
+
+## Quick Install
+
+The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7cwxayca38ajcc533bpgs/AGP4pnP-xhb-5LH_7YPsgyk?rlkey=2led17m6h0ku9y3hzbsnvsio1&dl=1) install CreativePython and all its required software, including Python3, FluidSynth, PortAudio, ffmpeg, Homebrew (on Mac), and Windows Build Kit (on Windows).
+
+### Windows 
+  1. Open `win-scripts.zip`.  Right-click `windows_setup.ps1`, and **Run with PowerShell** (it will open a PowerShell window and begin installing).  
+  2. Follow any prompts and let it finish.
+    - If you do not have Windows Build Kit installed, it will be installed as part of this process.  This may take some time to complete.
+
+### macOS 
+  1. Open `mac-scripts.tgz`.  Control-click `mac_setup.command`, and **Open** (it will open a Terminal window and begin installing).
+  2. Follow any prompts and let it finish.
+    - If you do not have Command Line Tools for XCode installed, it will be installed as part of this process.  This may take some time to complete.
+
+---
+
+## Custom Install
+
+---
+
+### 1. Install Python 3 + pip
+
+#### Windows
+1. Open PowerShell as Administrator (search "PowerShell" in the Start menu, and select "Run as Administrator").  Copy and Paste the following commands at each step.
+
+2. Install **Chocolatey** if you don't have it. [(Documentation)](https://docs.chocolatey.org/en-us/choco/setup/)  Copy/Paste the following command:
+
+   ```Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))```
+
+   When finished, exit this window and open a new PowerShell window.
+
+3. Install Python 3.
+
+   ```Invoke-Expressed "choco install python -y"```
+
+4. Verify that Python was installed.
+
+   ```py --version```
+
+   You should see something like "Python 3.12.4"
+
+#### MacOS
+1. Open Terminal (press Command + Space, type "Terminal", and hit Enter).  Copy and Paste the following commands at each step.
+
+2. Install **Homebrew** if you don't have it.
+
+   ```/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"```
+
+3. Install Python 3.
+
+   ```brew install python```
+
+4. Verify your installation.
+
+   ```python3 --version```
+
+   You should see something like "Python 3.12.4"
+
+---
+
+### 2. Install System Libraries
+
+#### Windows
+- **Microsoft Build Tools**
+Microsoft Build Tools contains the necessary tools to compile C++ packages that come with some Python libraries.
+
+   1. Open a new PowerShell window.
+
+   2. Download the latest Microsoft Build Tools.
+
+      ```Invoke-WebRequest -Uri "https://aka.ms/vs/17/release/vs_buildtools.exe" -OutFile "$env:TEMP\vs_buildtools.exe"```
+
+   3. Run the Installer.
+
+      ```Start-Process "$env:TEMP\vs_buildtools.exe" -ArgumentList "--installPath C:\Program Files\Microsoft Build Tools" --quiet --wait --norestart --nocache --includeRecommended --add Microsoft.VisualStudio.Workload.VCTools" -Wait```
+
+   4. Add Build Tools to your PATH.
+
+      ```[Environment]::SetEnvironmentVariable("PATH", "$(Join-Path (Get-ChildItem 'C:\Program Files\Microsoft Build Tools\VC\Tools\MSVC' -Directory | Sort-Object Name -Descending | Select-Object -First 1).FullName 'bin\Hostx64\x64');$env:PATH", [EnvironmentVariableTarget]::Machine)```
+
+   5. Verify your Installation.
+
+      ```Get-Command nmake.exe```
+
+      You should see a list of Applications, likely only containing 'nmake.exe'.
+
+      If you get an error, try the command in a new PowerShell window.
+
+
+- **PortAudio**:
+   On Windows, PortAudio comes with our Python libraries below.
+
+- **FluidSynth**:
+   1. Open a new PowerShell window.
+   2. Install the latest FluidSynth.
+
+      ```Invoke-Expression "choco install fluidsynth -y"```
+
+- **ffmpeg**:
+   1. Open a new PowerShell window.
+   2. Install the latest FFmpeg.
+
+      ```Invoke-Expression "choco install ffmpeg -y"```
+
+#### Mac
+- **All Libraries**:
+   1. Open Terminal.
+   2. Install PortAudio, FluidSynth, and ffmpeg.
+
+      ```brew install portaudio fluidsynth ffmpeg```
+
+---
+
+### 3. Install CreativePython
+
+#### Any OS
+1. Open Command Prompt/Terminal.
+
+   ```pip install CreativePython```
+
+   ```cp-setup```
+
+2. When prompted, download the default soundfont (It's FluidR3 GM2-2, by the way).  If you choose not to download the soundfont, you will need to provide your own.
+
+3. Verify your installation.
+
+   ```cp-test```
+
+   You should hear a single MIDI note played at C4.  If so, you're all set!

{creativepython-0.0.3 → creativepython-0.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "CreativePython"
-version = "0.0.3"
+version = "0.1.0"
 description = "A Python-based software environment for developing algorithmic art projects."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -29,6 +29,7 @@ dependencies = [
    "PySide6>=6.9.1",
    "sounddevice>=0.5.2",
    "soundfile>=0.13.1",
+   "tqdm>=4.67.1",
    "pooch>=1.8",
    "platformdirs>=4.2",
    "pypianoroll>=1.0"

{creativepython-0.0.3 → creativepython-0.1.0/src/CreativePython.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: CreativePython
-Version: 0.0.3
+Version: 0.1.0
 Summary: A Python-based software environment for developing algorithmic art projects.
 Author-email: "Dr. Bill Manaris" <manaris@cofc.edu>, Taj Ballinger <ballingertj@g.cofc.edu>, Trevor Ritchie <ritchiets@g.cofc.edu>
 License: MIT License
@@ -41,6 +41,7 @@ Requires-Dist: pyaudio>=0.2.14
 Requires-Dist: PySide6>=6.9.1
 Requires-Dist: sounddevice>=0.5.2
 Requires-Dist: soundfile>=0.13.1
+Requires-Dist: tqdm>=4.67.1
 Requires-Dist: pooch>=1.8
 Requires-Dist: platformdirs>=4.2
 Requires-Dist: pypianoroll>=1.0
@@ -62,12 +63,12 @@ This package is still under development.
 The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7cwxayca38ajcc533bpgs/AGP4pnP-xhb-5LH_7YPsgyk?rlkey=2led17m6h0ku9y3hzbsnvsio1&dl=1) install CreativePython and all its required software, including Python3, FluidSynth, PortAudio, ffmpeg, Homebrew (on Mac), and Windows Build Kit (on Windows).
 
 ### Windows 
-  1. Open `win-scripts.tgz`.  Right-click `windows_setup.bat`, and **Run as Administrator** (it will open PowerShell and run).  
+  1. Open `win-scripts.zip`.  Right-click `windows_setup.ps1`, and **Run with PowerShell** (it will open a PowerShell window and begin installing).  
   2. Follow any prompts and let it finish.
     - If you do not have Windows Build Kit installed, it will be installed as part of this process.  This may take some time to complete.
 
 ### macOS 
-  1. Open `mac-scripts.tgz`.  Control-click `mac_setup.command`, and **Open** (it will open Terminal and run).
+  1. Open `mac-scripts.tgz`.  Control-click `mac_setup.command`, and **Open** (it will open a Terminal window and begin installing).
   2. Follow any prompts and let it finish.
     - If you do not have Command Line Tools for XCode installed, it will be installed as part of this process.  This may take some time to complete.
 
@@ -80,28 +81,38 @@ The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7
 ### 1. Install Python 3 + pip
 
 #### Windows
-1. Download the [Python 3 installer](https://www.python.org/downloads/).  
-2. Run the installer. **Check the box that says “Add Python to PATH”** before clicking *Install Now*.  
-3. Open Command Prompt (search for "cmd" in the Start menu).
-4. Verify your installation.
+1. Open PowerShell as Administrator (search "PowerShell" in the Start menu, and select "Run as Administrator").  Copy and Paste the following commands at each step.
+
+2. Install **Chocolatey** if you don't have it. [(Documentation)](https://docs.chocolatey.org/en-us/choco/setup/)  Copy/Paste the following command:
+
+   ```Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))```
+
+   When finished, exit this window and open a new PowerShell window.
+
+3. Install Python 3.
+
+   ```Invoke-Expressed "choco install python -y"```
 
-   ```$ python --version```
+4. Verify that Python was installed.
+
+   ```py --version```
 
    You should see something like "Python 3.12.4"
 
 #### MacOS
-1. Open Terminal (press Command + Space, type "Terminal", and hit Enter).
+1. Open Terminal (press Command + Space, type "Terminal", and hit Enter).  Copy and Paste the following commands at each step.
+
 2. Install **Homebrew** if you don't have it.
 
-   ```$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"```
+   ```/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"```
 
 3. Install Python 3.
 
-   ```$ brew install python```
+   ```brew install python```
 
 4. Verify your installation.
 
-   ```$ python3 --version```
+   ```python3 --version```
 
    You should see something like "Python 3.12.4"
 
@@ -110,27 +121,53 @@ The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7
 ### 2. Install System Libraries
 
 #### Windows
+- **Microsoft Build Tools**
+Microsoft Build Tools contains the necessary tools to compile C++ packages that come with some Python libraries.
+
+   1. Open a new PowerShell window.
+
+   2. Download the latest Microsoft Build Tools.
+
+      ```Invoke-WebRequest -Uri "https://aka.ms/vs/17/release/vs_buildtools.exe" -OutFile "$env:TEMP\vs_buildtools.exe"```
+
+   3. Run the Installer.
+
+      ```Start-Process "$env:TEMP\vs_buildtools.exe" -ArgumentList "--installPath C:\Program Files\Microsoft Build Tools" --quiet --wait --norestart --nocache --includeRecommended --add Microsoft.VisualStudio.Workload.VCTools" -Wait```
+
+   4. Add Build Tools to your PATH.
+
+      ```[Environment]::SetEnvironmentVariable("PATH", "$(Join-Path (Get-ChildItem 'C:\Program Files\Microsoft Build Tools\VC\Tools\MSVC' -Directory | Sort-Object Name -Descending | Select-Object -First 1).FullName 'bin\Hostx64\x64');$env:PATH", [EnvironmentVariableTarget]::Machine)```
+
+   5. Verify your Installation.
+
+      ```Get-Command nmake.exe```
+
+      You should see a list of Applications, likely only containing 'nmake.exe'.
+
+      If you get an error, try the command in a new PowerShell window.
+
+
 - **PortAudio**:
-   On Windows, PortAudio is installed automatically with CreativePython, however you need Microsoft Build Tools installed first.
-   1. Download [the latest Windows build](https://visualstudio.microsoft.com/visual-cpp-build-tools/).
-   2. Run the installer.  When prompted, select **C++ build tools**.
-   3. Click **Install**.  This may take several minutes.
+   On Windows, PortAudio comes with our Python libraries below.
 
 - **FluidSynth**:
-   1. Download [the latest Windows build](https://github.com/FluidSynth/fluidsynth/releases).
-   2. Unzip it, and add the folder's location to your PATH.
+   1. Open a new PowerShell window.
+   2. Install the latest FluidSynth.
+
+      ```Invoke-Expression "choco install fluidsynth -y"```
 
 - **ffmpeg**:
-   1. Download [the latest Windows build](ffmpeg.org/download.html).
-   2. Unzip it, and move the folder to `C:\ffmpeg`.
-   3. Add `C:\ffmpeg\bin` to your PATH.
+   1. Open a new PowerShell window.
+   2. Install the latest FFmpeg.
+
+      ```Invoke-Expression "choco install ffmpeg -y"```
 
 #### Mac
 - **All Libraries**:
    1. Open Terminal.
    2. Install PortAudio, FluidSynth, and ffmpeg.
 
-      ```$ brew install portaudio fluidsynth ffmpeg```
+      ```brew install portaudio fluidsynth ffmpeg```
 
 ---
 
@@ -139,16 +176,14 @@ The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7
 #### Any OS
 1. Open Command Prompt/Terminal.
 
-   ```$ pip install CreativePython```
-
-   ```$ cp-setup```
+   ```pip install CreativePython```
 
-2. When prompted, download the default soundfont.  (It's FluidR3 GM2-2, by the way)
+   ```cp-setup```
 
-   - If you choose not to download the soundfont, you will need to provide your own.
+2. When prompted, download the default soundfont (It's FluidR3 GM2-2, by the way).  If you choose not to download the soundfont, you will need to provide your own.
 
 3. Verify your installation.
 
-   ```$ cp-test```
+   ```cp-test```
 
    You should hear a single MIDI note played at C4.  If so, you're all set!

{creativepython-0.0.3 → creativepython-0.1.0}/src/CreativePython.egg-info/requires.txt

@@ -6,6 +6,7 @@ pyaudio>=0.2.14
 PySide6>=6.9.1
 sounddevice>=0.5.2
 soundfile>=0.13.1
+tqdm>=4.67.1
 pooch>=1.8
 platformdirs>=4.2
 pypianoroll>=1.0

creativepython-0.1.0/src/creativepython_setup.py

@@ -0,0 +1,85 @@
+### SOUNDFONT DOWNLOAD HELPERS
+
+from pathlib import Path                # using Path to disambiguate between Windows and Unix path schemes
+from platformdirs import user_data_dir
+from pooch import retrieve              # secure file download
+import os
+
+APP = "CreativePython"
+ORG = "CofC"
+
+SOUNDFONT_NAME = "default.sf2"
+CACHE_DIR = Path(user_data_dir(APP, ORG)) / "SoundFonts"
+SOUNDFONT_PATH = CACHE_DIR / SOUNDFONT_NAME
+
+SF2_URL = "https://www.dropbox.com/s/xixtvox70lna6m2/FluidR3%20GM2-2.SF2?dl=1"
+SF2_SHA256 = "2ae766ab5c5deb6f7fffacd6316ec9f3699998cce821df3163e7b10a78a64066"
+
+def find_soundfont(path=None):
+   """
+   Finds a soundfont 'default.sf2' in the cache, and returns its location.
+   explicit can be another path that may have the soundfont needed.
+   """
+   candidates = []  # possible soundfont paths
+   soundfont = None # actual soundfont path
+
+   # was a path sent as an argument?
+   if path:
+      candidates.append(Path(path))
+   
+   # is there a PATH variable?
+   env = os.getenv("CREATIVEPYTHON_SOUNDFONT")
+   if env:
+      candidates.append(Path(env))
+
+   # CreativePython default sondfont directory
+   candidates += [SOUNDFONT_PATH, Path.home() / "SoundFonts" / SOUNDFONT_NAME]
+
+   # set the first confirmed soundfont
+   for c in candidates:
+      if c and c.exists() and soundfont is None:
+         soundfont = str(c)
+
+   return soundfont
+
+
+def download_soundfont(destination):
+   """Downloads a default soundfont (FluidR3 GM2-2) and saves it to the user's cache."""
+   destination.parent.mkdir(parents=True, exist_ok=True)  # create destination directory
+   path = retrieve(                                       # download soundfont
+      url=SF2_URL,
+      known_hash=f"sha256:{SF2_SHA256}",
+      progressbar=True,
+      fname=destination.name,
+      path=str(destination.parent)
+   )
+   return Path(path)                                      # return the downloaded file's path
+
+
+### MAIN METHODS
+
+def run():
+   # Check for soundfont file
+   sf = find_soundfont()
+
+   # Attempt to download missing soundfont, if needed
+   if not sf:
+      print("CreativePython setup warning: No soundfont found.")
+      auto = os.getenv("CP_AUTO_DOWNLOAD") == "1"
+
+      # ask user for permission to download soundfont
+      if auto or input("Download the default soundfont now? [Y/n] ").strip().lower() in ("", "y", "yes"):
+         path = download_soundfont()
+         print(f"Downloaded to: {path}")
+
+      # otherwise, instruct them how to add their own
+      else:
+         print(f"\nPlace your .sf2 soundfont at:\n   {SOUNDFONT_PATH}\nOr set CREATIVEPYTHON_SOUNDFONT to its location in your PATH.")
+         print("\n(see https://pypi.org/project/CreativePython/ for more details)")
+
+
+def playNote():
+   from music import Note, Play, C4, HN  # can't use * within function, so naming needed pieces
+
+   note = Note(C4, HN)        # create a middle C half note
+   Play.midi(note)            # and play it!

{creativepython-0.0.3 → creativepython-0.1.0}/src/gui.py

@@ -981,14 +981,23 @@ class Display(Interactable):
 
          if type.endswith("Press"):           # press -> mouseDown
             self.lastMouseDown = (x, y)
-            self._event("mouseDown", [x, y])  # deliver mouseDown to display
 
-            if self.hoverItem is not None:                 # is there a hover item?
-               self.hoverItem._event("mouseDown", [x, y])  # yes, deliver mouseDown to it
-               self.focusItem = self.hoverItem             # then, promote hover item to focus item
+            # determine item under cursor at press-time for correct focus
+            pressedItem = None
+            i = 0
+            while pressedItem is None and i < len(self.items):
+               item = self.items[i]
+               if item.contains(x, y):
+                  pressedItem = item
+               i += 1
+
+            # set focus based on press location
+            self.focusItem = pressedItem
 
-            else:
-               self.focusItem = None                       # no hover item, so no focus item
+            # deliver mouseDown: always to display, and to focused item if any
+            self._event("mouseDown", [x, y])  # deliver mouseDown to display
+            if self.focusItem is not None:
+               self.focusItem._event("mouseDown", [x, y])
             # print(f"Mouse pressed at ({x}, {y})")
 
 
@@ -1004,13 +1013,15 @@ class Display(Interactable):
             if isMouseClick:                      # and, if this was a click
                self._event("mouseClick", [x, y])  # also deliver mouseClick to display
 
-            if self.hoverItem is not None:                     # is there a hover item?
-               self.hoverItem._event("mouseUp", [x, y])        # yes, deliver mouseUp to hover item
-               if isMouseClick:                                # and, if this was a click
-                  self.hoverItem._event("mouseClick", [x, y])  # also deliver mouseClick to hover item
+            # deliver to the item that was focused at press-time
+            if self.focusItem is not None:                # is there a focus item?
+               self.focusItem._event("mouseUp", [x, y])   # yes, deliver mouse up to focus item
+
+               if isMouseClick:                                 # is this a mouse click?
+                  self.focusItem._event("mouseClick", [x, y])   # yes, deliver cilck to focus item
 
-            else:  # no hover item when mouse released, so no focus item
-               self.focusItem = None
+            # clear focus on release
+            self.focusItem = None
 
             self.lastMouseDown = None  # reset last mouse down position
             # print(f"Mouse released at ({x}, {y})")
@@ -1035,35 +1046,33 @@ class Display(Interactable):
                if dx > self.moveThreshold or dy > self.moveThreshold:  # is it outside threshold?
                   isMouseDrag = True                                   # yes, this is a mouseDrag
 
-            hoverItem = None                  # look for a hover item
-            i = 0
-            while hoverItem is None and i < len(self.items):
-               item = self.items[i]
-               if item.contains(x, y):
-                  hoverItem = item
-               i += 1
-
-            if hoverItem != self.hoverItem:                # if hover item has changed,
-               if self.hoverItem is not None:              # was there an old hover item?
-                  self.hoverItem._event("mouseExit", [x, y])  # yes, deliver mouseExit to old hover item
+            # while dragging we avoid changing hover/focus behavior based on items under the cursor
+            if not isMouseDrag:
+               hoverItem = None                  # look for a hover item
+               i = 0
+               while hoverItem is None and i < len(self.items):
+                  item = self.items[i]
+                  if item.contains(x, y):
+                     hoverItem = item
+                  i += 1
 
-               if hoverItem is not None:                   # is there a new hover item?
-                  hoverItem._event("mouseEnter", [x, y])   # yes, deliver mouseEnter to new hover item
+               if hoverItem != self.hoverItem:                # if hover item has changed,
+                  if self.hoverItem is not None:              # was there an old hover item?
+                     self.hoverItem._event("mouseExit", [x, y])  # yes, deliver mouseExit to old hover item
 
-               self.hoverItem = hoverItem                  # either way, set new hover item
+                  if hoverItem is not None:                   # is there a new hover item?
+                     hoverItem._event("mouseEnter", [x, y])   # yes, deliver mouseEnter to new hover item
 
-            else:  # hover item has not changed
-               pass
+                  self.hoverItem = hoverItem                  # either way, set new hover item
 
 
             if isMouseDrag:                      # if dragging, deliver mouseDrag instead of mouseMove
-               self._event("mouseDrag", [x, y])  # deliver mouseDrag to display
-
-               if self.focusItem is not None:             # is there a focus item?
-                  self.focusItem._event("mouseDrag", [x, y])  # yes, deliver mouseDrag to focus item
-
-               elif self.hoverItem is not None:           # ... or is there a hover item?
-                  self.hoverItem._event("mouseDrag", [x, y])  # yes, deliver mouseDrag to hover item
+               # when an item has focus, do not drag the display or other items
+               if self.focusItem is not None:
+                  self.focusItem._event("mouseDrag", [x, y])
+               else:
+                  # no focused item: drag events go to display only
+                  self._event("mouseDrag", [x, y])
 
 
             else:                                # otherwise, deliver mouseMove
@@ -1601,6 +1610,41 @@ class Oval(Drawable, Interactable):
       return f'Oval({self.getX()}, {self.getY()}, {x2}, {y2}, {self.getColor()}, {self.fill}, {self.getThickness()}, {self.getRotation()})'
 
 
+   def contains(self, x, y):
+      """Precise hit-test for ellipse.
+      - Always returns True when point is inside the ellipse area (regardless of fill).
+      - Additionally, for unfilled shapes, returns True when the point is near the outline (ring thickness).
+      """
+      if not isinstance(x, (int, float)) or not isinstance(y, (int, float)):
+         raise TypeError(f'Oval.contains(): x and y must be numbers (they were {type(x)} and {type(y)})')
+
+      if self.width == 0 or self.height == 0:
+         return False
+
+      # center and radii
+      cx = self.cornerX + self.width  / 2.0
+      cy = self.cornerY + self.height / 2.0
+      rx = self.width  / 2.0
+      ry = self.height / 2.0
+
+      # normalize point to ellipse space
+      nx = (x - cx) / rx
+      ny = (y - cy) / ry
+      value = nx*nx + ny*ny  # <= 1.0 means inside filled ellipse
+
+      # always accept interior clicks for interaction
+      if value <= 1.0:
+         return True
+
+      # outline-only: accept a ring around the perimeter proportional to thickness
+      # approximate thickness in normalized units using the larger radius as scale
+      scale = max(rx, ry)
+      normalizedThickness = max(self.thickness, 2) / max(scale, 1.0)
+      inner = 1.0 - normalizedThickness
+      outer = 1.0 + normalizedThickness
+      return inner <= value <= outer
+
+
 class Circle(Oval):
 
    def __init__(self, x, y, radius, color=Color.BLACK, fill=False, thickness=1, rotation=0):

{creativepython-0.0.3 → creativepython-0.1.0}/src/midi.py

@@ -931,7 +931,7 @@ def _stopActiveMidiObjects():
    _activeMidiInObjects.clear()
    _activeMidiOutObjects.clear()
 
-   print("All MIDI devices closed.")
+   # print("All MIDI devices closed.")
 
 # register the cleanup function to be called when the program exits
 atexit.register(_stopActiveMidiObjects)

creativepython-0.0.3/README.md

@@ -1,103 +0,0 @@
-# CreativePython
-
-CreativePython is a Python-based software environment for developing algorithmic art projects.  It mirrors the [JythonMusic API](https://jythonmusic.me/api-reference/).
-
-This package is still under development.
-
----
-
-## Quick Install
-
-The CreativePython Install Scripts [(Download)](https://www.dropbox.com/scl/fo/7cwxayca38ajcc533bpgs/AGP4pnP-xhb-5LH_7YPsgyk?rlkey=2led17m6h0ku9y3hzbsnvsio1&dl=1) install CreativePython and all its required software, including Python3, FluidSynth, PortAudio, ffmpeg, Homebrew (on Mac), and Windows Build Kit (on Windows).
-
-### Windows 
-  1. Open `win-scripts.tgz`.  Right-click `windows_setup.bat`, and **Run as Administrator** (it will open PowerShell and run).  
-  2. Follow any prompts and let it finish.
-    - If you do not have Windows Build Kit installed, it will be installed as part of this process.  This may take some time to complete.
-
-### macOS 
-  1. Open `mac-scripts.tgz`.  Control-click `mac_setup.command`, and **Open** (it will open Terminal and run).
-  2. Follow any prompts and let it finish.
-    - If you do not have Command Line Tools for XCode installed, it will be installed as part of this process.  This may take some time to complete.
-
----
-
-## Custom Install
-
----
-
-### 1. Install Python 3 + pip
-
-#### Windows
-1. Download the [Python 3 installer](https://www.python.org/downloads/).  
-2. Run the installer. **Check the box that says “Add Python to PATH”** before clicking *Install Now*.  
-3. Open Command Prompt (search for "cmd" in the Start menu).
-4. Verify your installation.
-
-   ```$ python --version```
-
-   You should see something like "Python 3.12.4"
-
-#### MacOS
-1. Open Terminal (press Command + Space, type "Terminal", and hit Enter).
-2. Install **Homebrew** if you don't have it.
-
-   ```$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"```
-
-3. Install Python 3.
-
-   ```$ brew install python```
-
-4. Verify your installation.
-
-   ```$ python3 --version```
-
-   You should see something like "Python 3.12.4"
-
----
-
-### 2. Install System Libraries
-
-#### Windows
-- **PortAudio**:
-   On Windows, PortAudio is installed automatically with CreativePython, however you need Microsoft Build Tools installed first.
-   1. Download [the latest Windows build](https://visualstudio.microsoft.com/visual-cpp-build-tools/).
-   2. Run the installer.  When prompted, select **C++ build tools**.
-   3. Click **Install**.  This may take several minutes.
-
-- **FluidSynth**:
-   1. Download [the latest Windows build](https://github.com/FluidSynth/fluidsynth/releases).
-   2. Unzip it, and add the folder's location to your PATH.
-
-- **ffmpeg**:
-   1. Download [the latest Windows build](ffmpeg.org/download.html).
-   2. Unzip it, and move the folder to `C:\ffmpeg`.
-   3. Add `C:\ffmpeg\bin` to your PATH.
-
-#### Mac
-- **All Libraries**:
-   1. Open Terminal.
-   2. Install PortAudio, FluidSynth, and ffmpeg.
-
-      ```$ brew install portaudio fluidsynth ffmpeg```
-
----
-
-### 3. Install CreativePython
-
-#### Any OS
-1. Open Command Prompt/Terminal.
-
-   ```$ pip install CreativePython```
-
-   ```$ cp-setup```
-
-2. When prompted, download the default soundfont.  (It's FluidR3 GM2-2, by the way)
-
-   - If you choose not to download the soundfont, you will need to provide your own.
-
-3. Verify your installation.
-
-   ```$ cp-test```
-
-   You should hear a single MIDI note played at C4.  If so, you're all set!

creativepython-0.0.3/src/creativepython_setup.py

@@ -1,101 +0,0 @@
-### SOUNDFONT DOWNLOAD HELPERS
-
-from __future__ import annotations
-from pathlib import Path
-from platformdirs import user_data_dir
-
-APP = "CreativePython"
-ORG = "CofC"
-
-SOUNDFONT_NAME = "default.sf2"
-CACHE_DIR = Path(user_data_dir(APP, ORG)) / "SoundFonts"
-SOUNDFONT_PATH = CACHE_DIR / SOUNDFONT_NAME
-
-SF2_URL = "https://www.dropbox.com/s/xixtvox70lna6m2/FluidR3%20GM2-2.SF2?dl=1"
-SF2_SHA256 = "2ae766ab5c5deb6f7fffacd6316ec9f3699998cce821df3163e7b10a78a64066"
-
-def find_soundfont(explicit: str | None = None) -> Path | None:
-   """
-   Finds a soundfont 'default.sf2' in the cache, and returns its location.
-   explicit can be another path that may have the soundfont needed.
-   """
-   import os
-
-   candidates = []
-   if explicit:
-      candidates.append(Path(explicit))
-   env = os.getenv("CREATIVEPYTHON_SOUNDFONT")
-   if env:
-      candidates.append(Path(env))
-   candidates += [SOUNDFONT_PATH, Path.home() / "SoundFonts" / SOUNDFONT_NAME]
-   for c in candidates:
-      if c and c.exists():
-         return str(c)
-   return None
-
-def download_soundfont(dest: Path = SOUNDFONT_PATH) -> Path:
-   """Downloads a default soundfont and saves it to the user's cache."""
-   from pooch import retrieve, Unzip
-   dest.parent.mkdir(parents=True, exist_ok=True)
-   p = retrieve(url=SF2_URL, known_hash=f"sha256:{SF2_SHA256}", progressbar=True, fname=dest.name, path=str(dest.parent))
-   return Path(p)
-
-
-
-### AUTOMATIC CHECK METHODS
-
-def run():
-   import shutil, sys, os
-   missing = []
-
-   # Check for soundfont file
-   sf = find_soundfont()
-
-   # Attempt to download missing soundfont
-   if not sf:
-      print("CreativePython setup warning: No soundfont found.")
-      auto = os.getenv("CP_AUTO_DOWNLOAD") == "1"
-      if auto or input("Download the default soundfont now? [Y/n] ").strip().lower() in ("", "y", "yes"):
-         path = download_soundfont()
-         print(f"Downloaded to: {path}")
-      else:
-         print(f"\nPlace your .sf2 soundfont at:\n   {SOUNDFONT_PATH}\nOr set CREATIVEPYTHON_SOUNDFONT to its location in your PATH.")
-         print("\n(see https://pypi.org/project/CreativePython/ for more details)")
-
-
-   # Check for required installations
-   if not shutil.which("ffmpeg"):
-      missing.append("ffmpeg")
-
-   if not shutil.which("fluidsynth"):
-      missing.append("FluidSynth")
-   
-   if not shutil.which("portaudio"):
-      missing.append("PortAudio")
-
-   # Warn user about missing requirements
-   if missing:
-      print("\nCreativePython setup warning:")
-      for req in missing:
-         print(f"   - {req} is not installed.")
-      
-      if sys.platform.startswith("darwin"):
-         print("\nOn macOS, run:\n   brew install portaudio fluidsynth ffmpeg")
-      elif sys.platform.startswith("win"):
-         print("\nOn Windows, install missing packages from developers, or run windows_setup.bat")
-      else:
-         print("\nOn Linux, install missing packages with your package manager (apt, dnf, etc.)")
-
-      print("\n(see https://pypi.org/project/CreativePython/ for more details)")
-
-   return len(missing) == 0
-
-
-def playNote():
-   ready = run()  # check for installation dependencies
-
-   if ready:
-      from music import Note, Play, C4, HN  # can't use * within function, so naming needed pieces
-
-      note = Note(C4, HN)        # create a middle C half note
-      Play.midi(note)            # and play it!