supported metadata files and pom.xml detail #825

juanjemdIos · 2025-10-17T14:15:57Z

Not sure about last colum of general md.

merge Dev 17102025

dgarijo · 2025-10-17T14:43:46Z

docs/pom.md

@@ -0,0 +1,30 @@
+The following metadata fields can be extracted from a pom.xml file


Please add here the link to the specification (pom specification)
Also add the version of the specification (4.0.0)

dgarijo · 2025-10-17T14:44:57Z

docs/pom.md

@@ -0,0 +1,30 @@
+The following metadata fields can be extracted from a pom.xml file
+
+| Metadata category       | Metadata Field                 | Value    |


It's SOMEF metadata category and somef metadata field. The value is the POM.XML value

dgarijo · 2025-10-17T14:46:08Z

docs/pom.md

+| **authors**       |  authors.email  |    developer.email                            |
+| **authors**       |  author.url  |     developer.url                            |
+| **authors**       |  author.organization |     developer.organization                          |
+| **authors**       |  author.type |     Agent                         |


Agent is not part of pom.
I think the author type being an Agent should be a separate table. Those are the things being inferred.

dgarijo

Some changes required

dgarijo · 2025-10-17T14:46:28Z

docs/pom.md

+| **requirements** |   requirements.value   | groupId.arfifactId                          |
+| **requirements** |   requirements.name   |  arfifactId                        |
+| **requirements** |   requirements.version   | version                       |
+| **requirements** |   requirements.type  | Software_application                        |


same with the type as with agents above.

dgarijo · 2025-10-17T14:46:54Z

docs/pom.md

+| **authors**       |  author.url  |     developer.url                            |
+| **authors**       |  author.organization |     developer.organization                          |
+| **authors**       |  author.type |     Agent                         |
+| **version** |          version                        |


here you are not adding the mapping in the pom file, which is version too.

dgarijo · 2025-10-17T14:50:45Z

docs/pom.md

@@ -0,0 +1,30 @@
+The following metadata fields can be extracted from a pom.xml file


Also add here that this was based on the CodeMeta crosswalk from the pom.xml (link)

dgarijo · 2025-10-17T14:51:15Z

docs/pom.md

+| **requirements** |   requirements.version   | version                       |
+| **requirements** |   requirements.type  | Software_application                        |
+| **package_id** |   package_id.value   | group_id.artifact_id                         |
+| **package_id** |    package_id.type  | String                       |


same with the package id.

dgarijo · 2025-10-17T14:51:21Z

docs/pom.md

+| **package_id** |   package_id.value   | group_id.artifact_id                         |
+| **package_id** |    package_id.type  | String                       |
+| **versiond** |    version.value  | version                    |
+| **versiond** |    version.type  | Release                     |


dgarijo · 2025-10-17T14:52:03Z

docs/supported_metadata_files.md

+SOMEF can extract metadata from a wide range of files commonly found in software repositories. Below is a list of supported file types, along with clickable examples from real projects:
+
+| File Name          | Language       | Description | Detail | Source Spec. | Version Spec.| Example | Based  |
+|--------------------|----------------------------|-------------|--------|--------|---------------|-----------|----------|


I don't know what Based is

dgarijo · 2025-10-17T14:52:35Z

docs/supported_metadata_files.md

+
+| File Name          | Language       | Description | Detail | Source Spec. | Version Spec.| Example | Based  |
+|--------------------|----------------------------|-------------|--------|--------|---------------|-----------|----------|
+| `AUTHORS.md`       | General                    | Lists contributors, authors, and affiliations relevant to the project |  <div align="center">[🔍](./author.md)</div>| [📄](https://opensource.google/documentation/reference/releasing/authors/)| |[Example](https://gist.github.com/juliengdt/91d80c812e41be891dcf) |


Group above all the things that are General. Then go with the languages in alphabetical order.

dgarijo · 2025-10-17T14:53:21Z

docs/supported_metadata_files.md

+|--------------------|----------------------------|-------------|--------|--------|---------------|-----------|----------|
+| `AUTHORS.md`       | General                    | Lists contributors, authors, and affiliations relevant to the project |  <div align="center">[🔍](./author.md)</div>| [📄](https://opensource.google/documentation/reference/releasing/authors/)| |[Example](https://gist.github.com/juliengdt/91d80c812e41be891dcf) |
+| `bower.json`       | JavaScript (Bower)         | Package descriptor used for configuring packages that can be used as a dependency for Bower-managed front-end projects. |  <div align="center">[🔍](./bower.md)</div>| [📄](https://github.com/bower/spec/blob/master/json.md)| |[Example](https://github.com/juanjemdIos/somef/blob/master/src/somef/test/test_data/repositories/js-template/bower.json) |
+| `cargo.toml`       | Rust                       | Manifest file serves as the package descriptor used in Rust projects | <div align="center">[🔍](./cargo.md)</div> | [📄](hhttps://doc.rust-lang.org/cargo/reference/manifest.html)| |[Example](https://github.com/rust-lang/cargo/blob/master/Cargo.toml) |


wrong url for the spec

dgarijo · 2025-10-17T14:54:44Z

docs/pom.md

+| **runtime_platform**     |   runtime_platform.value |  version  |
+| **runtime_platform**     |   runtime_platform.name |   name   |
+| **runtime_platform**     |   runtime_platform.type |   String   |
+


This file is also missing a full example: the original file, and the link to the somef representation

dgarijo · 2025-10-17T14:55:17Z

docs/supported_metadata_files.md

+|--------------------|----------------------------|-------------|--------|--------|---------------|-----------|----------|
+| `AUTHORS.md`       | General                    | Lists contributors, authors, and affiliations relevant to the project |  <div align="center">[🔍](./author.md)</div>| [📄](https://opensource.google/documentation/reference/releasing/authors/)| |[Example](https://gist.github.com/juliengdt/91d80c812e41be891dcf) |
+| `bower.json`       | JavaScript (Bower)         | Package descriptor used for configuring packages that can be used as a dependency for Bower-managed front-end projects. |  <div align="center">[🔍](./bower.md)</div>| [📄](https://github.com/bower/spec/blob/master/json.md)| |[Example](https://github.com/juanjemdIos/somef/blob/master/src/somef/test/test_data/repositories/js-template/bower.json) |
+| `cargo.toml`       | Rust                       | Manifest file serves as the package descriptor used in Rust projects | <div align="center">[🔍](./cargo.md)</div> | [📄](hhttps://doc.rust-lang.org/cargo/reference/manifest.html)| |[Example](https://github.com/rust-lang/cargo/blob/master/Cargo.toml) |


Missing CodeMeta file parser

dgarijo · 2025-10-23T09:14:50Z

docs/bower.md

+| **requirements**        |    requirements.name                       | "dependencies": {"paq":"version"}  -> paq       |        
+| **requirements**        |    requirements.version                    | "dependencies": {"paq":"version"}  -> version
+| **requirements**        |    requirements.dependency_type            | dependencies -> runtime , devDependencies -> dev | 
+| **version**             | version                                    | version |


this is inconsistent with other tables. Shouldn't it be version.value in the middle column?

docs/bower.md

dgarijo · 2025-10-23T09:24:22Z

docs/bower.md

+
+| SOMEF metadata category       | SOMEF metadata field                 | BOWER.JSON value    |
+|-------------------------|--------------------------------------------|---------------------|
+| **authors**             |  authors.name                              |     author.name     |


there is no value here?

dgarijo · 2025-10-23T09:33:47Z

docs/pom.md

+
+| SOMEF metadata category       | SOMEF metadata field                 | POM.XML value    |
+|-------------------------|--------------------------------------------|------------------|
+| **authors**       |  authors.name  |     developer.name                            |


shouldn't this be Agent.name? authors is a metadata category, but the attribute affects the type
so it would be authors[i].name where authors[i] is an Agent

Actually if we map it to our json it's authors[i].result.name.
Maybe it's best just to do Agent.name (author[i].result is of type Agent)

We may need an extra column Describes:

SOMEF metadata category Category range SOMEF metadata field POM.XML value

authors Agent (author[i].result is of type Agent) Agent.name developer.name

juanjemdIos and others added 2 commits October 17, 2025 13:11

Merge pull request #13 from KnowledgeCaptureAndDiscovery/dev

ea7a36b

merge Dev 17102025

supported metadata files and pom detail.

032d3c5

dgarijo reviewed Oct 17, 2025

View reviewed changes

dgarijo requested changes Oct 17, 2025

View reviewed changes

juanjemdIos added 4 commits October 20, 2025 16:30

small changes in supported_metadata_files, pom.md and bower.md

5dd53b5

package json md

5e5cf4e

comedatajson md

4df22b9

composer.json md and small change in codemeta.md

f76190a

dgarijo reviewed Oct 23, 2025

View reviewed changes

docs/bower.md Outdated Show resolved Hide resolved

dgarijo reviewed Oct 23, 2025

View reviewed changes

crosswalks more detailed. Still missing some parsed fields in output.md.

249046e

		@@ -0,0 +1,30 @@
		The following metadata fields can be extracted from a pom.xml file

		@@ -0,0 +1,30 @@
		The following metadata fields can be extracted from a pom.xml file

		\| Metadata category \| Metadata Field \| Value \|

supported metadata files and pom.xml detail #825

Are you sure you want to change the base?

supported metadata files and pom.xml detail #825

Uh oh!

Conversation

juanjemdIos commented Oct 17, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dgarijo left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dgarijo Oct 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

dgarijo Oct 23, 2025 •

edited

Loading