Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/epeios-q37/atlas-java

World's lightest toolkit to quickly and easily add a GUI to your Java programs and bring them online.
https://github.com/epeios-q37/atlas-java

api gui java network repl todomvc web

Last synced: about 1 month ago
JSON representation

World's lightest toolkit to quickly and easily add a GUI to your Java programs and bring them online.

Host: GitHub
URL: https://github.com/epeios-q37/atlas-java
Owner: epeios-q37
License: mit
Created: 2018-03-05T16:04:56.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-01-27T15:39:20.000Z (10 months ago)
Last Synced: 2024-05-02T03:13:35.549Z (7 months ago)
Topics: api, gui, java, network, repl, todomvc, web
Language: Java
Homepage: http://atlastk.org
Size: 448 KB
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        


The *Atlas* toolkit is available for:

[![Java](https://s.q37.info/jrnv4mj4.svg)](https://github.com/epeios-q37/atlas-java) [![Node.js](https://s.q37.info/fh7v7kn9.svg)](https://github.com/epeios-q37/atlas-node) [![Perl](https://s.q37.info/hgnwnnn3.svg)](https://github.com/epeios-q37/atlas-perl) [![Python](https://s.q37.info/94937nbb.svg)](https://github.com/epeios-q37/atlas-python) [![Ruby](https://s.q37.info/zn4qrx9j.svg)](https://github.com/epeios-q37/atlas-ruby)

To see the *Atlas* toolkit in action:

[![Version 0.13](https://img.shields.io/static/v1.svg?&color=blue&labelColor=red&label=online&message=demonstrations&style=for-the-badge)](https://s.q37.info/sssznrb4)



# *Java* version of the *Atlas* toolkit



[![Version 0.13](https://img.shields.io/static/v1.svg?&color=90b4ed&label=Version&message=0.13&style=for-the-badge)](http://github.com/epeios-q37/atlas-java/) [![license: MIT](https://img.shields.io/github/license/epeios-q37/atlas-java?color=yellow&style=for-the-badge)](https://github.com/epeios-q37/atlas-java/blob/master/LICENSE) [![Documentation](https://img.shields.io/static/v1?label=documentation&message=atlastk.org&color=ff69b4&style=for-the-badge)](https://atlastk.org) 



## A GUI with *Java* in a couple of minutes

Click the animation to see a screencast of programming this ["Hello, World!" program](https://en.wikipedia.org/wiki/%22Hello,_World!%22_program) with *Java* in a matter of minutes:



[![Building a GUI in with *Java* in less then 10 minutes](https://s.q37.info/qp4z37pg.gif)](https://s.q37.info/vd9xz7jp)



Same video on [*Peertube*](https://en.wikipedia.org/wiki/PeerTube): .

Click to see the corresponding source code

```java

import info.q37.atlas.*;

class Hello extends Atlas {

 private static String BODY =

  "" +

  " " +

  " Hello" +

  " 
" +

  " " +

  "  Greetings displayed here!" +

  " " +

  "";

  @Override

  public void handle(String action, String id)

  {

    switch(action) {

    case "":

      dom.inner("", BODY);

      break;

    case "Submit":

      String name = dom.getValue("Input");

      dom.begin("Output", "
Hello, " + name + "!");

      dom.setValue("Input", "" );

      break;

    }

    dom.focus("Input");

  }

  public static void main(String[] args)

  {

    launch(() -> new Hello());

  }

}

```

### See for yourself right now - it's quick and easy!

- on *Windows* (pay attention to the `;` on last line):

```bash

# You can replace 'github.com' with 'framagit.org'.

# DON'T copy/paste this and above line!

git clone https://github.com/epeios-q37/atlas-java

cd atlas-java/examples/Hello

java -cp .;../../Atlas.jar Hello

```

- on other platforms (pay attention to the `:` on last line):

```bat

REM You can replace 'github.com' with 'framagit.org'.

REM DON'T copy/paste this and above line!

git clone https://github.com/epeios-q37/atlas-java

cd atlas-java/examples/Hello

java -cp .:../../Atlas.jar Hello

```

## Your turn

If you want to take your code to the next level, from [CLI](https://s.q37.info/cnh9nrw9) to [GUI](https://s.q37.info/hw9n3pjs), then you found the right toolkit.

With the [*Atlas* toolkit](http://atlastk.org/), you transform your programs in modern web applications ([*SPA*](https://s.q37.info/7sbmxd3j)) without the usual hassles:

- no *JavaScript* to write; only *HTML*(/*CSS*) and *Java*,

- no [front and back end architecture](https://s.q37.info/px7hhztd) to bother with,

- no [web server](https://s.q37.info/n3hpwsht) (*Apache*, *Nginx*…) to install,

- no need to deploy your application on a remote server,

- no incoming port to open on your internet box or routeur.

The *Atlas* toolkit is written in pure *Java*, with no native code and no dependencies, allowing the *Atlas* toolkit to be used on all environments where *Java* is available. 

And simply by running them on a local computer connected to internet, applications using the *Atlas* toolkit will be accessible from the entire internet on laptops, smartphones, tablets…

## Content of the repository

The `atlastk` directory contains the *Java* source code of the *Atlas* toolkit.

`atlastk.jar` is the file you have to reference in the [*classpath*](https://en.wikipedia.org/wiki/Classpath_(Java)) in order to use the *Atlas* toolkit in your own program.

The `examples` directory contains some examples.

To run an example, go inside its directory (`Blank`, `Chatroom`…) and launch:

- under *Windows*: `java -cp .;../../atlastk.jar ` (with semi-colon as *classpath* separator),

- under other platforms: `java -cp .:../../atlastk.jar ` (with colon as *classpath* separator).

where `` is the name of the example (`Blank`, `Chatroom`…).