Quickstart improvements

[jamescasbon]

I just followed the quickstart and I think it needs some improvement. I downloaded the iso-3166-2-data package as in the tutorial but it leaves you hanging at the point where you have the data on disk:

This will download the Package ‘iso-3166-2-data’ together with its “Resources” and unpack it into a directory named ‘iso-3166-2-data’.

At that point, I have metadata and data in the directory

ls iso-3166-2-data/ AD README.txt data datapackage.json manifest.json place

so it's not clear to me as a n00b what is the data (I thought it should be in the data directory, but that is empty). Well, there is a manifest.json, so lets look at that:

$ cat iso-3166-2-data/manifest.json {}

Nothing in there. dpm info does have the information about the files in the resources part:

$ dpm info iso-3166-2-data/ resources: [{u'mimetype': None, u'cache_url': None, u'mimetype_inner': None, u'hash': u'', u'description': u'rdf (linked data)', u'format': u'application/rdf+xml', u'url': u'http://ontologi.es/place/', u'cache_last_updated': None, u'webstore_url': None, u'resource_group_id': u'2e2e5b2e-159c-638e-d277-695890cac3d4', u'package_id': u'973ae0f1-854c-43c5-82d5-e9365311e81f', u'last_modified': None, u'webstore_last_updated': None, u'position': 0, u'size': None, u'id': u'0c325720-b59c-4369-ae5b-b890a3b0afef', u'resource_type': None, u'name': None}, {u'mimetype': None, u'cache_url': None, u'mimetype_inner': None, u'hash': u'', u'description': u'Example resource', u'format': u'example/rdf+xml', u'url': u'http://ontologi.es/place/AD ', u'cache_last_updated': None, u'webstore_url': None, u'resource_group_id': u'2e2e5b2e-159c-638e-d277-695890cac3d4', u'package_id': u'973ae0f1-854c-43c5-82d5-e9365311e81f', u'last_modified': None, u'webstore_last_updated': None, u'position': 1, u'size': None, u'id': u'bb3b9863-dfab-4114-9cd3-4b447dd774fd', u'resource_type': None, u'name': None}]

but there is not an easy mapping between the url and the disk location.

I would expect that the tutorial would tell me where to get a list of contents as they are on disk after the download.

[rufuspollock]

Pull request :-)

[rufuspollock]

Also are you using absolute head of master? In HEAD data will be in data directory :-)

[jamescasbon]

On Tue, Mar 20, 2012 at 11:25 AM, Rufus Pollock reply@reply.github.com wrote:

Also are you using absolute head of master? In HEAD data will be in data directory :-)

I installed via pip latest version today, I can try with HEAD.

[jamescasbon]

Ok, no need for pull request I can push to HEAD, hope this is OK:

https://github.com/okfn/dpm/commit/17393a660540ad738f5beabf127a8968836200d5