Be notified of new releases
Create your free GitHub account today to subscribe to this repository for new releases and build software alongside 50 million developers.Sign up
This release adds many new features including ability to do an "online" install from a central bundle repository called the "hub".
Here's rc5 of Aquameta 0.2! Change include:
- many improvements to the IDE
- improved bundle code search functionality
- unified installer for Debian and Ubuntu
- widget loading optimizations
- remote commit push/pull support
- remote mount(), is_mounted(), unmount() functions
- add ability to install from remote hub
- start of new documentation system
- bug fixes and enhancements
Aquameta 0.2.0-rc4 released
What new in rc4?
- major strides towards version controlling meta-entities
- clarification of meta.table vs meta.relation and their columns
- meta is no longer version-controlled by default, rather a
bundle.trackable_nontable_relationtable has been created, for tracking non-table relations like views, foreign tables, etc. opt in.
- starting to lean on the
defviews are views that contain meta entities like views, tables, casts, operators, etc., but with only two columns their, say,
view_id, and another column called
definition, which contains the SQL stmt which creates it. Much better for version controlling meta entities.
- much exploration around server-side rendering of widgets resulted in the addition of
endpoint.template_routewhich are rendered server-side with plv8 and doT.js, so we can have dynamic results on a base resource (or anything else)
- baby steps on documentation
- refinement of extensions so that pg_dump will export their data (which must be explicitly declared per-relation)
- all extensions'
makecommand now overwrites previously generated files
- big steps forward on a better UI, including file uploads, untracked rows manager, template creation ui, a much better stage, pulling in the semantics ui css library for great beautification, bundle search, filesystem import and export, remote bundle clone and diff, the start of some p2p webrtc features
- two new security schemes, one for total lockdown (no register, access to nothing except auth pages), and one for open registration, which allows public to register for an account.
- complete refactor of installer to support both ubuntu 18 and debian 9, prompt for superuser setup, prompt for security scheme, and generally works much better
bin/directory containing scripts to restart the three aquameta services (pg, nginx, uwsgi), and to tail all logs of said services
- include the
pg_cronextension from Citus, which enables scheduled execution of arbitrary sql statements
- numerous bug fixes and enhancements
We're still a ways away from a complete user experience, but things seem to be in a relatively sane state at the moment and it's been a while since I did a release, so here it is.
Ho! Now comes version
0.2.0-rc3 of Aquameta.
Numerous enhancements including:
- All Aquameta core modules are now PostgreSQL EXTENSIONs
- Support for server-side templates that are dynamically rendered using
- Ground-up security audit
- Installer now supports two security schemes, private and open-registration. Private databases do not accept new users, but open-registration databases allow anonymous users to sign up
- Refactor of all auth pages, including
- No more hard-coded installation directory, instead user chooses where to install
- Remove Docker support (until, or if ever, we convert it to
- Bundles can now be diff-ed with another remote copy of the bundle, showing commits that are unique to either the local or remote bundle
- Installation has been vastly simplified, prompting user for things like installation directory, security scheme, and superuser credentials
- Events have been resurrected to be much closer to working
- Complete refactor of code and extension filesystem layout, moving all postgresql extensions and python packages into the
- Switch to using PostgreSQL version 10
- Numerous bug fixes and misc. enhancements
Ho! Now comes Aquameta v0.2.0 release candidate 2. Lots of new features to talk about:
- bundle remotes have been completely refactored to use
postgres_fdwinstead of http. This makes the process of cloning, pushing and pulling between instances of Aquameta much simpler. A new user interface is taking shape called the "bundle manager", which enables pushing and cloning between connected databases.
- bundles can now be exported to csv file with the
bundle.bundle_export_csv()function. All parts of a bundle are saved to file, and then can be imported via
- major strides in making Aquameta secure out of the box, most noteworthy of which is that
anonymousis no longer a superuser. Instead a limited set of row-level permissions are granted to the anonymous user, allowing them to only do what is needed to register, confirm and login, or at least that's the idea.
- There is an alternate uwsgi config file that enables SSL encryption via letsencrypt. Users should be able to just follow the letsencrypt instructions, run
certbotand create an SSL certificate.
endpoint.resource*tables now have an
activeflag instead of a unique constraint on
resource.path, so that multiple resources that use the same path can be activated and deactivated instead of just breaking their checkout.
- Documentation! There's now a quickstart and cheatsheet in the docs/ folder.
- The very simple email facilities in
endpointfor sending registration emails etc., have been moved into an
smtp_servertable that can contain multiple SMTP configurations. It works very nicely with an Amazon SES instance, or any other SMTP server that supports DKIM, so emails don't get sent to the spam folder. It also has the start of a simple email template system.
- Now each core modules has it's own associated bundle, which contains rows specific to that module:
- Lots of user interface bundles in early stages:
- org.aquameta.ui.admin - Generic data editing admin, with mixin widgets for building apps
- org.aquameta.ui.auth - Register, login and auth status widgets for general use or extension
- org.aquameta.ui.dev - Main development UI, still very primitive
- org.aquameta.ui.fsm - UI state fsm
- org.aquameta.ui.layout - Tabs, modals, select panes, etc.
- org.aquameta.ui.tags - HTML tag wrappers for sync'ing datums into tags
- Lots of bug fixes
- Instructions for installing on Amazon EC2
I'm happy to announce the release of Aquameta, a peer-to-peer network for exchanging "bundles", a new kind of complex data object that can be almost anything. They can include code, web apps, data, images and more, and together create a kind of "smart object" that is very versatile and open-ended.
Today, users can exchange emails, publish web pages, exchange binaries via p2p apps, and much more. We'd like to see Aquameta become another kind of communication protocol and network, one where users exchange these bundled complex data objects that hopefully do fun, interesting and useful stuff. Because bundles are made up of data, we claim that it's a very wide pipe for creativity and interactivity, one that opens up a world of new possibilities.
Under the hood, Aquameta is a bunch of PostgreSQL schemas that handle things like version control, web hosting, user interface, events, peer to peer communication, etc. A bundle is made up of rows in these tables and any others that users might wish to create.
Aquameta has a web interface that lets users build and exchange these bundles. They can be sent either server-to-server via http, or browser-to-browser via WebRTC. The networked-communication aspect of Aquameta is still under development and experimentation.
Aquameta can be installed on a desktop, a server, in the cloud or on a small device such as a Raspberry Pi.
Under the hood are a lot of PostgreSQL modules which hopefully can be useful to the PostgreSQL community. They include:
- meta - a writable system catalog, that makes common DDL operations like schema changes accessible via INSERT, UPDATE and DELETE
insert into meta.role(name, superuser, password) values ('joe', true, 'mypass'); insert into meta.schema(name) values ('my_schema');
- bundle - a version control system for data, similar to git, but for rows in the database instead of files
select bundle.stage_row_add( meta.row_id('public','countries','id','UK') ); select bundle.commit('org.aquameta.countries','add uk.'); select bundle.checkout('org.aquameta.games.snake');
- event - a pub/sub event system for subscribing to data changes on a particular column, row or table
select session_create(); select subscribe_table(meta.relation_id('widget','machine'));
- filesystem - a foreign data wrapper that lets you SELECT files and directories from the filesystem, and a daemon called postgrefs, which lets you navigate the database from the filesystem as if it were files and directories
aquameta=# select name, path, permissions, content, owner from filesystem.file where path='/etc/issue'; name | path | permissions | content | owner -------+------------+-------------+--------------------------+------- issue | /etc/issue | 0644 | Ubuntu 14.04.5 LTS \n \l+| root | | | +| | | | | (1 row) $ ls /mnt/aquameta/public/countries
- www - a web server that exposes the database over http, including a REST interface for data manip and function calls, hosting of arbitrary resources, and an authentication layer that uses PostgreSQL ROLEs and PRIVILEGEs
aquameta=# select path, m.mimetype, substring(content from 1 for 15) from endpoint.resource r join endpoint.mimetype m on r.mimetype_id = m.id limit 2; path | mimetype | substring -------+-----------+----------------- /docs | text/html | <!DOCTYPE html> /dev | text/html | <!DOCTYPE html> select endpoint.request('0.1','GET','/docs')
select * from widget.widget; select * from widget.widget_dependency_js;
- semantics - a metadata layer for the database schema, where columns, relations, foreign keys and more can be "decorated" with additional semantic meaning
insert into semantics.relation (relation_id, purpose_id, widget_id) values ( meta.relation_id('ecomm','customer'), (select purpose_id from semantics.purpose where purpose='row_detail'), (select id from widget.widget where name='customer_list_view') );
Aquameta is in very early stages, despite being under development for years. It is finally at the point of being a marginally functional prototype that hopefully is pointed in the right direction, but there is much work still to be done. The user interface is just beginning to take shape, the system is not secure, test coverage is sparse, and there are surely many bugs and missing features. We are releasing it at this early stage to get feedback and invite contributors to help out.
To give Aquameta a spin, head over to github and consult the README which contains install instructions:
To jump into development, check out the project's roadmap, and join our IRC channel and mailing list:
#aquameta on irc.freenode.net