©️ socialweb.coop

Background ^?

ActivityPub § 5.5 Liked Collection:

Every object MAY have a liked collection. … The liked collection MUST be either an OrderedCollection or a Collection

About This Test

This is a Test Case describing a rule to determine whether an ActivityPub Object is in partial conformance with the following behaviors required by ActivityPub.

• requirement d2db8da3-25d4-4dd9-9c9c-b2793fd899cf - The liked collection MUST be either an OrderedCollection or a Collection

Identifier

The identifier of this test is urn:uuid:018c3df2-d6d8-7f62-805b-b71a96cc6170.

Test Subject

The subject of this test is an ActivityPub Object.

Input ^?

This test requires the following inputs indicating parts of the test subject:

1. object - the object whose liked property will be tested
   • type: binary
   • constraints
     • should be JSON

Applicability ^?

This test applies to each of the liked collections derived from the values of the property on object named liked.

Prerequisites

• object is a JSON object
• object JSON object has a property named liked

How to Derive Test Targets from Input

• let targets be a set
• let likedValues be the result of
  • if object.liked is an Array, return it
  • else return an Array whose only item is the value of object.liked
• for each item in likedValues
  • if item is a string
    • let itemFetched be the result of interpreting the string as an ActivityPub Object Identifier and fetching the corresponding ActivityPub Object.
    • add itemFetched to targets
  • else add item to targets
• return targets

Expectations ^?

For every target target

• target is a JSON object
• target has a property named type
• the values of the target's type property must be one of
  • an array containing the string "Collection"
  • an array containing the string "OrderedCollection"
  • the string "Collection"
  • the string "OrderedCollection"

Assumptions ^?

Test Cases ^?

What follows are some specific cases of applything this test.

Passed Example 1

inputs

• object:

  {
    "liked": {
      "type": "Collection"
    }
  }
  

test targets

• {
    "type": "Collection"
  }
  

  • outcome: passed

Passed Example 2

inputs

• object:

  {
    "liked": {
      "type": "OrderedCollection"
    }
  }
  

test targets

• {
    "type": "OrderedCollection"
  }
  

  • outcome: passed

Passed Example 3

inputs

• object:

  {
    "liked": {
      "type": ["FancyCollection", "OrderedCollection"]
    }
  }
  

test targets

• {
    "type": ["FancyCollection", "OrderedCollection"]
  }
  

  • outcome: passed
    • rationale: "FancyCollection" is not well-defined here, but this object still passes the test because at least one of the type property values is OrderedCollection and thus satisfies the requirement as interpreted.

Failed Example 1 - Likes is a number

inputs

• object:

  {
    "liked": 1
  }
  

test targets

• 1
  

  • outcome: failed

Failed Example 2 - Likes is an empty object

inputs

• object:

  {
    "liked": {}
  }
  

test targets

• {}
  

  • outcome: failed

Failed Example 3 - Likes object type is array including only "Link"

inputs

• object:

  {
    "liked": {
      "type": ["Link"]
    }
  }
  

test targets

• {
    "type": ["Link"]
  }
  

  • outcome: failed

Inapplicable Example 1

inputs

• object:

  1
  

result

• outcome: inapplicable

Inapplicable Example 2 - object has no likes property

inputs

• object:

  { "foo": "bar" }
  

result

• outcome: inapplicable

Glossary ^?

outcome

An outcome is a conclusion that comes from evaluating a test on a test subject. An outcome can be one of the three following types:

• inapplicable: No part of the test subject matches the applicability
• passed: A test target meets all expectations
• failed: A test target does not meet all expectations

Requirements Mapping ^?

• ActivityPub requirement d2db8da3-25d4-4dd9-9c9c-b2793fd899cf - The liked collection MUST be either an OrderedCollection or a Collection
  • Required for Conformance to ActivityPub
  • Outcome Mapping
    • when every test target has outcome passed, the requirement is satisfied by the test subject
    • when any test target has outcome failed, the requirement is not satisfied by the test subject
    • when any test target has outcome inapplicable, further testing is needed to determine requirement satisfaction

Issues ^?

Change Log

• 2023-12-06T07:07:25.913Z - init
• 2023-12-18T04:43:02.981Z - add test cases based on automating this test