I’m delighted to announce two new features in Fluidinfo—the existence of a private namespace for everyone, and the creation of a readable Fluidinfo version number. Thanks are due to Jamu (@jkakar) and Manuel (@ceronman) for implementing these changes. They were both my requests/suggestions, so blame me if you hate them.
The private namespace¶
If you have an existing Fluidinfo account, you will now find that you now have a top-level namespace called private. If you had such a namespace anyway, it won’t have been touched, but if you did not, it has been created, and all of its permissions have been set, as the name suggests, so that only you can access it.
Using Fish (or the online version at http://shell-fish.appspot.com), you can see this by using the ls command. So for me (logged in as njr), I can get a Unix-style listing of the permissions with:
$ fish ls -ld private
nrwc------ njr/private/
or a more detailed, Fluidinfo-style listing by saying
$ fish ls -Gd private
njr/private/:
NAMESPACE (/namespaces)
Read
list (read): policy: closed; exceptions = [njr]
Write
create (create): policy: closed; exceptions = [njr]
update (metadata): policy: closed; exceptions = [njr]
delete (delete): policy: closed; exceptions = [njr]
Control
control (control): policy: closed; exceptions = [njr]
New users registering from now on will also have this namespace created for them, with the permissions set to private.
We have given everyone a private namespace by default for two main reasons:
- It means that, without having to know anything about how the permissions system works, all Fluidinfo users have any easy way to create both private and non-private information: if you want your data to be public, by default all your tags not under the private namespace are readable by everyone (but writable only by you); where you want data to be private, just use a tag in your private namespace.
- Just as importantly, we expect that many Fluidinfo applications will now place some data in a user’s private namespace (as appropriate) and some at the top level, or in other namespace that aren’t private by default. So an application to allow users to share clipboard between devices, for example, would probably use private tags by default, but a rating application would be more likely to use tags that are public by default.
Just as most people never change any file permissions, we expect that most Fluidinfo users will not want to be messing around with tag permissions, and this change means they should not have to do so.
FAQ¶
Q1: I hate this: I don’t want a private namespace! Can I get rid of it?
A1: Of course. You can safely delete the private namespace. In Fish, assuming you haven’t added anything to it you can do this simply by saying:
$ fish rm private
(The fish part of all these commands can be omitted if you are using the online version of Fish.)
Or, if you prefer, you can alter the permissions on the namespace to make it non-private. For example, if you say
$ fish perms default private
that will reset the permissions on the namespace private to the defaults (making it readable by everyone, but writable only by you). I wouldn’t particularly recommend this course, but it’s up to you.
Q2: I already had a namespace called private, but its permissions aren’t set correctly. How can I fix them up?
A2: You can do this with Fish’s perms command:
$ fish perms private private
Note that this only changes the permissions on the private namespace itself. If you have tags or namespaces under it, their permissions will not be affected, but new tags and namespace that you create under private after this change will be affected. (I will add a -r option to Fish soon, for recursive permissions changes, but it isn’t there at the time of writing.)
Q3: I used private as a tag: have you just trashed all my private tags?
A3: No. Fluidinfo is quite happy for you to have a tag and a namespace with the same name. If you had a private tag, this hasn’t been affected at all by the new private namespace.
Q4: Is everything under my private namespace private?
A4: If we’ve just created the private namespace for you, yes; but if you had one already, it depends:
A few months ago we made a change to Fluidinfo so that when a new tag or namespace is created, it inherits permissions from its parent namespace. So everything works as you would expect, and if you create new tags and namespaces under your private namespace, everything will work as any reasonable person would expect.
It is important to note, however, that the Fluidinfo permissions system is not hierarchical, in the sense that changing the permissions on a parent namespace has no effect on its existing child namespaces and tags.
Q5: Will I run into problems if I buck the trend and don’t have a private namespace called private or if I make other tags and namespace private?
A5: No. It is obviously possible that Fluidinfo applications you use might make assumptions that your private namespace is private, or that it exists, or even that tags not under your private namespace are public, but such apps would be making unjustified assumptions.
There should certainly be no problem at all with making any tag or namespace you like private, whether it is under the private namespace or not. Indeed, you can make your top-level namespace private if you like (though again, doing so will only affect new top-level tags and namespaces).
But if you don’t have a strong philosophical objection, your life probably be simpler if you go along with having a namespace called private, and probably by making its contents private too.
Fluidinfo API Version and Release Date¶
The other small but useful change is that Fluidinfo is now publishing information about the versions of the code and API deployed.
Every time a new version of the live Fluidinfo code is deployed, the tag fluiddb/release-date on the object with about tag fluidinfo will be updated. This is a plain text string (MIME type text/plain) in ISO8601 extended format. Because it is a plain-text string, you can view it in a browser at
http://fluiddb.fluidinfo.com/about/fluidinfo/fluiddb/release-date.
or with Fish by saying
$ fish show -a fluidinfo /fluiddb/release-date
Object with about="fluidinfo":
/fluiddb/release-date = "2011-11-04T17:40:27Z"
The intention and commitment from the team is that every time the live Fluidinfo code changes, this release date will be updated (even if there is no intended change to the API). This obviously allows library and application writers to make statements such as:
Fish version 4.12 has been tested with the Fluidinfo release of 2011-11-04T17:40:27Z and all tests pass.
(which is true).
There is also an API version published using the tag fluiddb/api-version on the same object. Again this has MIME type text/plain, and can be viewed at
http://fluiddb.fluidinfo.com/about/fluidinfo/fluiddb/api-version
It can also be displayed using Fish with the command
$ fish show -a fluidinfo /fluiddb/api-version
Object with about="fluidinfo":
/fluiddb/api-version = "1.13"
This is updated whenever a deliberate change to the API is made. If, at some point in future, multiple APIs are supported, the intention is to extend this to be a space-separated list of APIs supported in the current release.
The API change log can be viewed at
http://doc.fluidinfo.com/fluidDB/api/changelog.html
and I’m guessing that from this point forward the change log will include the API version numbers for new features.
No comments:
Post a Comment