lvm / activitystreams2

A (hacky) library that allows creation of ActivityStreams 2.0 Types.

Activity Streams 2.0

A (hacky) library that allows creation of ActivityStreams 2.0 Types.

Content

This lib contains:

• All properties defined in W3C Activity Vocabulary
• Models for the 8 Core Types (Object, Link, Activity, IntransitiveActivity, Collection, OrderedCollection, CollectionPage, OrderedCollectionPage)
• Everything you need to create Extended Types

Example

from activitystreams2 import make_activitystreams_class, properties, OrderedCollection

Note = make_activitystreams_class("Note", properties.OBJECT_PROPERTIES)

note1 = Note(id="https://example.com/1", name="hello world", content="hey!!")
note2 = Note(id="https://example.com/2", name="bye world", content="bye!!")
note3 = Note(id="https://example.com/3", name="end of the world", content="oh no")

notes = sorted([note3, note1, note2], key=lambda n: n.id)
for note in notes:
    note.dismiss_context()

collection = OrderedCollection(totalItems=len(notes), items=notes, current=0)

print(collection)
print(json.dumps(collection.asdict(), indent=2))

from activitystreams2 import parse_activitystreams_object

activitystreams_dct = {
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "Sally added a picture of her cat to her cat picture collection",
  "type": "Add",
  "actor": {
    "type": "Person",
    "name": "Sally"
  },
  "object": {
    "type": "Image",
    "name": "A picture of my cat",
    "url": "http://example.org/img/cat.png"
  },
  "origin": {
    "type": "Collection",
    "name": "Camera Roll"
  },
  "target": {
    "type": "Collection",
    "name": "My Cat Pictures"
  }
}

parse_activitystreams_object(activitystreams_dct)

[...]

Add(summary='Sally added a picture of her cat to her cat picture collection', actor={'type': 'Person', 'name': 'Sally'}, object={'type': 'Image', 'name': 'A picture of my cat', 'url': 'http://example.org/img/cat.png'}, origin={'type': 'Collection', 'name': 'Camera Roll'}, target={'type': 'Collection', 'name': 'My Cat Pictures'})

Test

$ python3 -m unitest discover tests

Note: Tests are a bit lousy at the moment.

To properly test this lib, you can use the Test Suite provided in the ActivityStreams github repo.

$ git clone https://github.com/w3c/activitystreams /tmp/activitystreams
$ ./bin/activitystreams-validator /tmp/activitystreams/test/simple0003.json
$ ./bin/mass-activitystreams-validator /tmp/activitystreams/test/

Note: vocabulary-ex196-jsonld.json will always fail because it isn't formatted correctly (or at least json.load won't parse it).

LICENSE

See LICENSE