Redirection… on The Atlas toolkit

"Hello, World!"

Mon, 01 Jan 0001 00:00:00 +0000

The “Hello, World!” program #

Below the source code for the different available languages of the famous “Hello, World!” program made with the Atlas toolkit, which looks like this:

API (en)

Mon, 01 Jan 0001 00:00:00 +0000

API of the Atlas toolkit (v0.13) #

Structure of a program #

Although concerning web applications, the Atlas toolkit is not based on a special architectural pattern, like the popular MVC related frameworks. So, the structure of an Atlas toolkit based program is rather simple.

launch(...) is the main function. Then, for each user action, you have just to perform the appropriate actions on the DOM, like:

setting/getting the content of elements ((set|get)Value[s]),
handling CSS classes ((add|remove|toggle)Class[es])),
enabling/disabling elements ((enable|disable)Element[s]),
handling attributes/properties ((get|set)(Attribute[s]|Property)).
…

Take also a look to the provided examples; this will help the understanding on how the toolkit works.

Home

Mon, 01 Jan 0001 00:00:00 +0000

Yo

Welcome to the Atlas toolkit web site #

The Atlas toolkit is the world’s lightest GUI toolkit, yet it is completely dependency free. It is also the easiest way to create multi-user applications instantly accessible from any device with a modern web browser connected to the internet.

The Atlas toolkit is available for: .

Here’s the source code of a “Hello, World!” kind of application written in Python. It uses a slightly modified version of the Atlas toolkit so it can be run it in your browser (click on Show/Hide, then the Run button).

Java - Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation of the Java binding #

Please read this introductory page before proceeding.

If you retrieve the examples of use on https://github.com/epeios-q37/atlas-java, you don’t have anything else to install.

If you want to start from scratch, you need to download following file: https://github.com/epeios-q37/atlas-java/raw/master/Atlas.jar. This file have to be specified in the classpath.

The Atlas.jar file was compiled with Java 1.5, but the examples were compiled with Java 1.8, so you may have to recompile one or both of them depending on the version of Java in use.

API (fr)

Mon, 01 Jan 0001 00:00:00 +0000

API du toolkit Atlas (v0.13) #

Structure d’un programme #

Bien que concernant des applications web, le toolkit de Atlas n’est pas basé sur un modèle architectural particulier, comme les populaires frameworks relatif au modèle MVC. Ainsi, la structure d’un programme basé sur le toolkit Atlas est plutôt simple.

launch(…) est la fonction principale. Ensuite, pour chaque action de l’utilisateur, il suffit d’effectuer les actions appropriées sur le DOM, comme :

Node - Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation of the Node.js binding #

Please read this introductory page before proceeding.

To install the Node.js binding of the Atlas toolkit, you only need the atlastk package (npm install atlastk)

For examples of use, see https://github.com/epeios-q37/atlas-node/.

Online demonstrations

Mon, 01 Jan 0001 00:00:00 +0000

Online demonstrations #

You can see the Atlas toolkit in action by clicking one of the following inserts and then the Run button. The application is directly executed by the browser, so it may take some time to be displayed.

Use the buttons at the bottom of the application to share the currently running application. You may also long-press/right-click the QR code displayed by the first button.

Perl - Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation of the Perl binding #

Please read this introductory page before proceeding.

If you retrieve the examples of use on https://github.com/epeios-q37/atlas-perl, you don’t have anything else to install.

Modern programming exercises

Mon, 01 Jan 0001 00:00:00 +0000

Modern programming exercises with the Atlas toolkit #

Nowadays, almost all young people have a smartphone, so they are used to graphical interfaces. They rarely, if ever, had to deal with a text console. Writing programs with a textual interface, they may (falsely) find this outdated and therefore not very motivating.

Example of a programming exercise with textual interface:

An exercise consists, for the students, in writing a program to perform a given task. To check that the program is working properly, they will have to modify its parameters. This is usually done by modifying these parameters directly in the source code, or by entering their value at runtime with the help of instructions such as input(…) (if using Python), or also by handling this parameters as command-line arguments.

Python - Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation of the Python binding #

Please read this introductory page before proceeding.

If you retrieve the examples from https://github.com/epeios-q37/atlas-python, you have nothing else to install.

If you want to start from scratch, there are two possibilities.

You can install install the atlastk package from PyPI () with, for example, following command: pip install atlastk.

Alternatively, you can download https://github.com/epeios-q37/atlas-python/raw/master/atlastk.zip and:

put, in your source file, before importing the atlastk module (import atlastk), the following line: __import__("sys").path.append("<path to>/atlastk.zip") (ex., if the atlastk.zip file is in the directory from which you launch your Python program: __import__("sys").path.append("./atlastk.zip"));
or add the downloaded file in the default search path for Python modules by updating the PYTHONPATH environment variable.

Raspberry Pi

Mon, 01 Jan 0001 00:00:00 +0000

The Atlas toolkit and the Raspberry Pi #

If the applications are not displayed correctly, please read the notice on the installation section!

The Raspberry Pi is a small single-board computer developed for educational purpose, and emphasizing Python language.

As the Atlas toolkit is available in Python, you can use it on a Raspberry Pi, and also on similar devices, like the ODROID series. And it makes the use of this devices easier and more fun, especially when it comes to GPIO.

Ruby - Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation of the Ruby binding #

Please read this introductory page before proceeding.

If you retrieve the examples of use on https://github.com/epeios-q37/atlas-ruby, you don’t have anything else to install. The Atlas directory contains the ruby source code of the Atlas toolkit; you have to give this directory as argument to the -I switch of the ruby command.

Editor

Mon, 01 Jan 0001 00:00:00 +0000

Editor #

Use below insert to design the interface of your application in HTML :

In the insert below, replace the content of the BODY constant with the content created above. Add the desired features and click Run to launch the application.

Please take a look to at this notes about the use of async/await.

import atlastk

BODY = """
<center>
<h5>Replace this with the HTML code corresponding to your interface.</h5>
</center>
"""

async def atk(dom):
  await dom.inner("", BODY)

atlastk.launch(globals=globals())

Elsewhere

Mon, 01 Jan 0001 00:00:00 +0000

The Atlas toolkit elsewhere #

You will find here links to some writings that I have published on other websites.

Writings about the Atlas toolkit itself:

French writings about the Atlas toolkit used in modern programming exercises:

Some stats:

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

FAQ #

Exit messages #

Some details concerning the various messages displayed on application exiting.

Exit message #0

This one should not be displayed. If so, please provide as much details as possible how this happened.

Exit message #1

This means that there is no application corresponding to the provided token. There probably was one at one point, but it has been shut down.

Contribute

Mon, 01 Jan 0001 00:00:00 +0000

Contribute to the Atlas toolkit #

You can report an issue (bug, enhancement, new feature…) or open a discussion by using the dedicated section on Github. Here are the direct links:

Version	Issues	Discussions
	https://github.com/epeios-q37/atlas-java/issues	https://github.com/epeios-q37/atlas-java/discussions
	https://github.com/epeios-q37/atlas-node/issues	https://github.com/epeios-q37/atlas-node/discussions
	https://github.com/epeios-q37/atlas-perl/issues	https://github.com/epeios-q37/atlas-perl/discussions
	https://github.com/epeios-q37/atlas-python/issues	https://github.com/epeios-q37/atlas-python/discussions
	https://github.com/epeios-q37/atlas-ruby/issues	https://github.com/epeios-q37/atlas-ruby/discussions

You can also contribute through the Github Sponsors program.

To contact the developer of the Atlas toolkit directly: https://q37.info/contact.

Contact

Mon, 01 Jan 0001 00:00:00 +0000

Contact #

If you wish to report a bug, suggest an enhancement, a new feature, make a donation…, please go to the Contribute section.

To contact the developer of the Atlas toolkit, or the owner of this web site, go to https://q37.info/contact.

Server - Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation of the server #

You don’t have to install the server’s program to use the Atlas toolkit. The provided bindings automatically connect to a free and public server.

To use another server, you have to modify the needed environment variables accordingly to https://s.q37.info/pkhrq3px.

The daemons #

The sources of the software on the server can be found here:

To deploy this software on your own server, retrieve both above repositories and compile them, by launching make in the root of each repository. Then launch <path-to>/xdhwebq-cli/xdhwebq <path-to>/xdhq/xdhqxdh (without the dll/so/dylib… extension).

Legal notices

Mon, 01 Jan 0001 00:00:00 +0000

Legal notices #

As this web site is hosted in France, I have to put some legal notices.

For the licensing of the Atlas toolkit, take a look at the license section of the About section.

Mentions légales #

Les sites atlastk.org et www.atlastk.org sont des services de communication au public en ligne édité à titre non professionnel au sens de l’article 6, III, 2° de la loi 2004-575 du 21 juin 2004.

Mon, 01 Jan 0001 00:00:00 +0000

À propos de ce répertoire #

Contient les fichiers constituant le site https://atlastk.org

ATTENTION : voir la section concernant Hugo à propos des images (utilisation de hard links au lie de liens symboliques).

Le répertoire content du générateur de site Hugo doit être un lien vers ce répertoire.

Par défaut, c’est l’entrée title du front matter qui est utilisé comme libellé d’entrée de menu. Pour que menu soit utilisé, remplacer, dans le fichier /themes/hugo-book/layouts/partials/docs/menu-filetree.html, {{- partial "docs/title" .Page -}} par {{.Page.Params.menu}}.

Redirection…

Mon, 01 Jan 0001 00:00:00 +0000

It seems JavaScript is not activated in your browser; some functionalities will hence be disabled! To continue browsing this site, go to the demos section.