©️ socialweb.coop

Background ^?

ActivityPub § 5.4 Following Collection:

Every actor SHOULD have a following collection. This is a list of everybody that the actor has followed, added as a side effect. The following 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 a4876ff4-7751-4bc6-91e0-9275382d4a85 - The following collection MUST be either an OrderedCollection or a Collection

Identifier

The identifier of this test is urn:uuid:018c3e17-a1bd-7040-8007-4cd3b9063288.

Test Subject ^?

The subject of this test is an ActivityPub Actor Object.

Input ^?

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

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

Applicability ^?

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

Prerequisites

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

How to Derive Test Targets from Input

• let targets be a set
• let followingValues be the result of
  • if object.following is an Array, return it
  • else return an Array whose only item is the value of object.following
• for each item in followingValues
  • 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 - following has type Collection

inputs

• object:

  {
    "following": {
      "type": "Collection"
    }
  }
  

test targets

• {
    "type": "Collection"
  }
  

  • outcome: passed

Passed Example 2 - following has type OrderedCollection

inputs

• object:

  {
    "following": {
      "type": "OrderedCollection"
    }
  }
  

test targets

• {
    "type": "OrderedCollection"
  }
  

  • outcome: passed

Passed Example 3 - following type includes OrderedCollection

inputs

• object:

  {
    "following": {
      "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 - following is a number

inputs

• object:

  {
    "following": 1
  }
  

test targets

• 1
  

  • outcome: failed

Failed Example 2 - following is an empty object

inputs

• object:

  {
    "following": {}
  }
  

test targets

• {}
  

  • outcome: failed

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

inputs

• object:

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

test targets

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

  • outcome: failed

Inapplicable Example 1

inputs

• object:

  1
  

result

• outcome: inapplicable

Inapplicable Example 2 - object has no following 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 a4876ff4-7751-4bc6-91e0-9275382d4a85 - The following 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:43:27.890Z - init