User:Ian Clark/KISS/DateNow

From J Wiki
Jump to navigation Jump to search

DateNow: a proof-of-concept sample KISS app

DateNow is an ultra-simple KISS sample app offered here in beta. It is only intended as a proof-of-concept and doesn't do a useful task in itself. But the proposed initial range of "faces" will essentially consist of minor modifications to its debugged code.

For a brief introduction to KISS, read the Rationale

For brief instructions on how to run DateNow, read the Getting-Started Guide

DISCLAIMER: It is your responsibility to verify that the compiled app and its source code contain nothing harmful to your computer.

Download…

  • the Xcode project (including source files) to build the app:
  datenow.zip  [193 KB unzipped]
  • the app (recently compiled with Xcode 8.2.1 running on OS X El Capitan):
  datenow.app.zip  [10 MB unzipped]

You also need the OS X version of J805 JHS to be installed. Get it here: System/Installation/All-in-One

Playing with DateNow

When you run it, you can read brief "getting-started" instructions via Menu: Help > Instructions or by clicking the bold button: INSTRUCTIONS FOR USE. These instructions are also replicated here: User:Ian_Clark/KISS/Getting_started_with_DateNow

DateNow has been tested ONLY with a working J805 JHS installation. And only on OS X El Capitan. However DateNow is designed to work with JHS straight out-of-the-box. No customization or startup scripts needed.

Specifically DateNow expects to find valid files on these paths:

* /Applications/j64-805/bin/jconsole
* /Applications/j64-805/addons/ide/jhs/core.ijs

If you want to play with the source, get the latest Xcode from the OS X App Store. It is free-of-charge, but reckoned as a purchase, so you need an AppleID (as you do to make any purchase from the App Store). Currently Xcode comes as a single massive app [12.36 GB]. Additional space [193 KB] is need for the datenow project folder, and a similar amount for each additional Xcode project you create or download from the Apple website. But that's negligible compared to the size of Xcode itself.

If you merely want to inspect the source code, then all you need is TextEdit. Swift is a tolerably readable language, especially if you know Python (and a smattering of Objective-C and Cocoa helps too).

To play with the app itself, all you need is the app. There is a single J script called starter.ijs embedded in the app itself, which you can view/edit via Help > Edit starter.ijs.

Then, if you're familiar with JHS, you can open the jijx session in your favorite browser, look for the locale 'datenow', and see for yourself what mischief starter.ijs wreaks on JHS. :-)

In the process, you'll find these URLs handy:

http://localhost:65001/jijx
http://localhost:65001/terminate
http://localhost:65001/datenow?appname
http://localhost:65001/datenow?initialized
http://localhost:65001/datenow?init
http://localhost:65001/datenow?now