Skip to content

Conversation

@pietercolpaert
Copy link
Member

@pietercolpaert pietercolpaert commented Feb 17, 2025

Working on a proposal to add tests cases in the spec for #97

Copy link
Contributor

@smessie smessie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just leaving some thoughts here while going through the current draft.

pietercolpaert and others added 4 commits March 31, 2025 12:24
Co-authored-by: Ieben Smessaert <smessie@users.noreply.github.com>
Co-authored-by: Ieben Smessaert <smessie@users.noreply.github.com>
Co-authored-by: Ieben Smessaert <smessie@users.noreply.github.com>
04-tests.bs Outdated

This test is about a function `initialization(url)`. The function will return the URL of the collection and the URL of the root node.

We will test this with various URLs containing different contents.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be better to explain the purpose of the TREE test specification (perhaps in an overview section). For example (correct me if I am wrong):

The TREE test specification aims to provide a set of tests for validating that a tree client implementation conforms to the TREE specification. The TREE implementors can use this conforming client to interact with data sources to validate TREE conformity.

Additionally, it might be clearer (to people like me XD) to explain what the initialization function does. For example:

The initialization(url) function returns the URL of the collection and the URL of the root node.

The following test scenarios describe how the initialization(url) function of the tree client should behave in various situations involving the TREE and the parameter URL.

- Restructured the documentation to create a narrative.
- Addressed my concern regarding the comment left in [issue #141](#141), questioning whether this specification is ONLY focused on client behavior.
- OFC, a work in progress
@xdxxxdx
Copy link
Collaborator

xdxxxdx commented May 22, 2025

Hi @pietercolpaert,
Just to let you know, I don't have write access to this branch. I've created another PR #142 to continue making progress. (it is fine, I'll proceed this way.)

feat: update test specification
@pietercolpaert
Copy link
Member Author

Hi @pietercolpaert, Just to let you know, I don't have write access to this branch. I've created another PR #142 to continue making progress. (it is fine, I'll proceed this way.)

I now made sure you have write access as well!

@xdxxxdx
Copy link
Collaborator

xdxxxdx commented Jun 11, 2025

rorlic/tree-shacl#1


  • I envision that the spec tests can only test a tree:Node (basic elements of the Tree), or a part of the full tree graph, therefore I made these two categories in the conformance points.
  • The tests, in my view, need to emphasize the minimum requirements of a TREE implementation (the content of the TREE).
  • I included the generated HTML(and will remove the HTML once the PR is settled) in the PR as well. Please feel free to comment on the current version. I would like to collect feedback on the current format.

xdxxxdx and others added 9 commits June 19, 2025 16:37
- I envision that the spec tests can only test a tree:Node (basic elements of the Tree), or a part of the full tree graph, therefore I made these two categories in the conformance points.
- The tests, in my view, need to emphasize the minimum requirements of a TREE implementation (the content of the TREE).
- I included the generated HTML in the PR as well. Please feel free to comment on the current version. I would like to collect feedback on the current format and will remove the HTML once the PR is settled.
fix; merge the update of the main branch
@pietercolpaert
Copy link
Member Author

Instead we’re going for #154

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants