{"id":34270565,"url":"https://github.com/teachingkidsprogramming/teachingkidsprogramming.source.java","last_synced_at":"2025-12-16T19:03:43.158Z","repository":{"id":17127158,"uuid":"19893391","full_name":"TeachingKidsProgramming/TeachingKidsProgramming.Source.Java","owner":"TeachingKidsProgramming","description":"Source Code for TKP Java Library","archived":false,"fork":false,"pushed_at":"2024-11-01T00:46:53.000Z","size":15360,"stargazers_count":16,"open_issues_count":10,"forks_count":33,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-11-22T05:20:26.909Z","etag":null,"topics":["eclipse","java","teaching-materials","tkp-java"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TeachingKidsProgramming.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-05-17T18:33:15.000Z","updated_at":"2025-10-06T08:59:08.000Z","dependencies_parsed_at":"2022-09-06T20:40:29.076Z","dependency_job_id":null,"html_url":"https://github.com/TeachingKidsProgramming/TeachingKidsProgramming.Source.Java","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/TeachingKidsProgramming/TeachingKidsProgramming.Source.Java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeachingKidsProgramming%2FTeachingKidsProgramming.Source.Java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeachingKidsProgramming%2FTeachingKidsProgramming.Source.Java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeachingKidsProgramming%2FTeachingKidsProgramming.Source.Java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeachingKidsProgramming%2FTeachingKidsProgramming.Source.Java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TeachingKidsProgramming","download_url":"https://codeload.github.com/TeachingKidsProgramming/TeachingKidsProgramming.Source.Java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeachingKidsProgramming%2FTeachingKidsProgramming.Source.Java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27769802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-16T02:00:10.477Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eclipse","java","teaching-materials","tkp-java"],"created_at":"2025-12-16T19:03:41.478Z","updated_at":"2025-12-16T19:03:43.152Z","avatar_url":"https://github.com/TeachingKidsProgramming.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TKP Source for Java\n\nWelcome to the TKP Java API source repository.  \n\nIf you are looking for the TKP Java 'teaching repo', it is found in a companion location [here on GitHub](https://github.com/TeachingKidsProgramming/TeachingKidsProgramming.Java).\nThat repo contains a starter set (.jar) of .java files for teachers to use with students when teaching TKPJava.  It also contains a set of customizations for Eclipse that are specifically designed to make the coding experience more fun for beginners.\n\nThis repository contains the TKP Java API source used to create and support the teaching repository. Here we've implemented a Logo-like library, which includes objects such as a Turtle, Tortoise and many more.  We've also created documentation and examples specifically designed to be fun for kids ages 10-14 to learn to code.  We welcome feedback, suggestions and pull requests!  \n\n\n## Setup a local development environment\nFirst [create your own a repository fork](https://github.com/TeachingKidsProgramming/TeachingKidsProgramming.Source.Java#fork-destination-box).  Then, follow the instructions below to get started on your preferred platform.\n\n### Mac OS X\nRecent versions of Mac OS X come with `git` preinstalled.  So the first step is to clone your fork.  Open terminal then type the following:\n\n```sh\nmkdir -p ~/Documents/src\ncd ~/Documents/src\n```\n\nThen clone the repository by typing the following command, you must replace `****` with your own github user name.\n\n```sh\ngit clone https://github.com/********/TeachingKidsProgramming.Source.Java.git\n```\n\nYou may be prompted to install \"command line developer tools\".  You can choose `Get Xcode` or `Install`.  However, `Get Xcode` takes much longer, so I would recommend starting with a simple `Install`.\n\n\n![CommandLineTools.png](/images/OSXCommandLineTools.png?raw=true)\n\nIf you needed to install the command line tools you will have to run `git clone` again in order to actually clone the repository.\n\nNext you will need java and eclipse.  You may already have them, but this guide assumes you are installing from scratch. Let's use homebrew to get the tools we need.\n\nFirst visit the [homebrew page](http://brew.sh/) and follow the instructions there to install the `brew` command.\n\nNext use this command to install [Homebrew Cask](http://caskroom.io/):\n```sh\nbrew install caskroom/cask/brew-cask\n```\n\nNow you can install Java:\n```sh\nbrew cask install java\n```\n\nNow install eclipse for Java:\n```sh\nbrew cask install eclipse-java\n```\nEclipse can take a while to download, so be patient.\n\nNow you can start eclipse, any easy way to do that is to launch it using spotlight:\n\n1. Press Cmd+Space\n1. Type `ec`\n1. Select `eclipse`\n\nWhen eclipse launches, it will ask you where to put your workspace.  The default is `~/Documents/workspace` and this is fine.\n\nOnce eclipse finishes creating and loading the workspace, you can use the `File` menu to choose `Import`.  Type `maven` in the filter box, and choose `Existing Maven Projects`.  Click `Next`, then click `Browse...`.  Navigate to `Documents` then `src` then select `TeachkingKidsProgramming.Source.Java`, and click `Open`.  Now click `Finish`.\n\nNow click the `Workbench` icon in the upper right corner.\n\n![Workbench.png](/images/OSXWorkbench.png?raw=true)\n\nNext, do a quick test to see if everything is working:\n\n1. Press Cmd+Shift+T in eclipse to search the TKP project.\n1. Enter `SimpleSquare` in the search box.\n1. Choose the `completed` recipe\n\n    ![completed](/images/OSXSimpleSquare.png?raw=true)\n    \n1. Click `Ok`\n1. Right-click on `public class SimpleSquare`\n1. Choose `Run As` then `Java Application`\n\nYou should see the tortoise appear and draw a square:\n\n![Tortoise](/images/OSXTortoise.png?raw=true)\n\n### Linux\nThese instructions apply to Ubuntu 14.10, and you may need to modify some commands to work on your distribution.\n\nUbuntu comes with a package manager and we will use it to install required applications as we go.  First open a terminal then type the following:\n```sh\nmkdir -p ~/src\ncd ~/src\nsudo apt-get install -y git\n```\n\nThen clone the repository by typing the following command, you must replace `****` with your own github user name.\n\n```sh\ngit clone https://github.com/********/TeachingKidsProgramming.Source.Java.git\n```\nNow install java with these commands\n```sh\nsudo apt-get update\nsudo apt-get install -y openjdk-8-jdk\n```\n\nNow install eclipse, visit [eclipse.org](https://www.eclipse.org/downloads) using your browser.  The website should be able to detect your operating system and provide you with links to the Linux distributions.  Most likely you will want to install the 64-bit version of eclipse.  Download it to the default download location (`~/Downloads` for Firefox).\n\nNext type the following commands:\n```sh\nmkdir -p ~/apps\ntar xzvf ~/Downloads/eclipse-java-luna-SR2-linux-gtk-x86_64.tar.gz -C ~/apps/\nsudo ln -s ~/apps/eclipse/eclipse /usr/local/bin\n```\nNow you can start eclipse, an easy way to do that is to launch it using the terminal with this command:\n\n```sh\neclipse \u0026\n```\nWhen eclipse launches, it will ask you where to put your workspace.  The default is `~/workspace` and this is fine.\n\nWhen eclipse finishes creating and launching the workspace use the `File` menu to choose `Import`.  Type `maven` in the filter box, and choose `Existing Maven Projects`.  Click `Next`, then click `Browse...`.  Navigate to your home directory then `src` then select `TeachkingKidsProgramming.Source.Java`, and click `Ok`.  Now click `Finish`.\n\nNow click the `Workbench` icon in the lower center of the eclipse window:\n\n![Workbench](/images/UbuntuWorkbench.png?raw=true)\n\nNext, perform a quick test to see that everything is working:\n\n1. Press Ctrl+Shift+T in eclipse to search the TKP project.\n1. Enter `SimpleSquare` in the search box.\n1. Choose the `completed` recipe\n    \n    ![completed](/images/UbuntuSimpleSquare.png?raw=true)\n    \n1. Click `Ok`\n1. Right-click on `public class SimpleSquare`\n1. Choose `Run As` then `Java Application`\n\nYou should see the tortoise appear and draw a square:\n\n![Tortoise](/images/UbuntuTortoise.png?raw=true)\n\n### Windows\n\nFirst we will need to add a `git` package to windows.  Go to the [msysgit site](https://msysgit.github.io/) and download the installer.  Click `Run` when it completes.  Agree to the UAC prompt then wizard will launch.  You can accept the defaults for most pages, but choose `Use Git from the Windows Command Prompt` on the `Adjusting your PATH environment` page.  On the next page, titled `Configuring the line ending conversions` choose `Checkout as-is, commit as-is`.  Finish the wizard.\n\nNext start a command prompt:\n\n1. Press Windows+R\n2. Type `cmd`\n3. Press `Enter`\n\nNow enter the following commands:\n```cmd\nmkdir Documents\\src\ncd Documents\\src\n```\n\nThen clone the repository by typing the following command, you must replace `****` with your own github user name.\n\n```sh\ngit clone https://github.com/********/TeachingKidsProgramming.Source.Java.git\n```\n\nNext you will need java and eclipse.  We will use ninite.com to install these packages.  Click this [link](https://ninite.com/eclipse-jdkx8/) to get a custom package that will install java and eclipse.  Run the package, accept the UAC prompt and ninite will install the tools.\n\nNow start eclipse using the shortcut placed on the desktop.  When eclipse launches, it will ask you where to put your workspace.  The default is in `workspace` under your user profile and this is fine.\n\nWhen eclipse finishes creating and launching the workspace use the `File` menu to choose `Import`.  Type `maven` in the filter box, and choose `Existing Maven Projects`.  Click `Next`, then click `Browse...`.  Select `Documents\\src\\TeachkingKidsProgramming.Source.Java`, and click `Ok`.  Now click `Finish`.\n\nNow click the `Workbench` icon in the upper left corner of the eclipse window:\n\n![Workbench](/images/WinWorkbench.png?raw=true)\n\n1. Press Ctrl+Shift+T in eclipse to search the TKP project.\n1. Enter `SimpleSquare` in the search box.\n1. Choose the `completed` recipe\n\n    ![completed](/images/WinSimpleSquare.png?raw=true)\n\n1. Click `Ok`\n1. Right-click on `public class SimpleSquare`\n1. Choose `Run As` then `Java Application`\n\nYou should see the tortoise appear and draw a square:\n\n![Tortoise](/images/WinTortoise.png?raw=true)\n\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteachingkidsprogramming%2Fteachingkidsprogramming.source.java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteachingkidsprogramming%2Fteachingkidsprogramming.source.java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteachingkidsprogramming%2Fteachingkidsprogramming.source.java/lists"}