noflo / noflo-gnome

NoFlo runtime for GNOME development

NoFlo-Gnome is the NoFlo runtime for the GNOME environment

NoFlo-Gnome a set of tools to help you write applications using the NoFlo framework and its UI editor (https://github.com/noflo/noflo-ui) for the Gnome environment.

How to install

For people familiar with autoconf/automake, this as simple as :

./autogen.sh --prefix=/wherever && make && make install

How to install existing components :

NoFlo-Gnome is capable of reusing generic NoFlo components. A lot of components provide features like string processing, simple mathematic functions, object processing, group processing, etc...

For example, you can install the noflo-strings set of components by running the following command :

noflo-gnome install noflo/noflo-strings

The recommended set of component repository to install is the following :

noflo-gnome install noflo/noflo-core noflo/noflo-flow noflo/noflo-math noflo/noflo-objects noflo/noflo-strings

How to create a new application repository :

You want to create a new application? Here is what you should do :

mkdir ~/myapp
cd ~/myapp
noflo-gnome init -n "MyApplicationName"

How to add a custom component to your application repository :

Components need to be listed in order to be visible in the UI. You can add one with the following command :

touch MyComponent.js
noflo-gnome add -c MyComponent.js

How to add a Glade UI file to your application repository :

The Gnome integration layer to NoFlo provides the ability to represent Glade UI files automatically in the UI. To do so, your Glade file needs to be listed in the application's manifest.

You can add a Glade file with the following command :

noflo-gnome add -u MyGladeFile.glade

How to add a DBus xml description file to your application repository :

To facilitate communication with DBus services, the Gnome integration layer to NoFlo provides the ability to generate components automatically from the DBus XML interface description.

You can add an xml description file with the following command :

noflo-gnome add -d MyDbusDescription.xml

How to run your application :

Run the application without debugging :

noflo-gnome run

To run in debug mode with the Flowhub UI :

noflo-gnome run -d -u

How to bundle your application into a single file :

Once you're done creating your application and would like to exchange it with other people, you can do so by creating a bundle (single file containing all your assets, code, ui files, etc...)

noflo-gnome bundle

Any example?

Sure, have a look at the examples directory! And feel free to submit PRs if you have something cool :)

noflo-gnome's Issues

noflo-gnome segfaults when NoFlo UI disconnects

To reproduce:

• noflo-gnome -d -u
• In NoFlo UI instance which opens, click the "reconnect" button next to the IP address

(gdb) bt
#0 0x00007f14c34d44a4 in g_io_stream_clear_pending () from /usr/lib/libgio-2.0.so.0
#1 0x00007f14c34d4519 in ?? () from /usr/lib/libgio-2.0.so.0
#2 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0
#3 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0
#4 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0
#5 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0
#6 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0
#7 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0
#8 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0
#9 0x00007f14c34d4531 in ?? () from /usr/lib/libgio-2.0.so.0

Looks like a stack overflow, as there are thousands of entries just like it.

This is an issue I've seen in also imgflo, pretty sure it is in the WebSocket support of libsoup.

Easy way of installing common NoFlo components

Could as a first step be included in the jhbuild bundle.
Ideally would work similar to "npm install", without requiring much additional metadata from component devs

Component loading fails if $componentdir/noflo-$lib is a symlink

Minor, but very useful when developing because one can easily keep code changes in one repository.