Main Page: Difference between revisions
(Added RDF-XML) |
mNo edit summary |
||
Line 14: | Line 14: | ||
==Obtain curation data in various format using a [[REST]] interface== | ==Obtain curation data in various format using a [[REST]] interface== | ||
The entire curation data of a software package can be retrieved in [[JSON]] format, curation data of a particular version can be retrieved in [[ | The entire curation data of a software package can be retrieved in [[JSON]] format, curation data of a particular version can be retrieved in [[RDF-XML]], [[SPDX2TV]] or [[YAML]] format. | ||
==Reuse existing material in case of version mismatch== | ==Reuse existing material in case of version mismatch== |
Revision as of 00:13, 27 July 2023
Welcome to the O Wiki!
This Wiki was created to facilitate day-to-day work with the resources of the O project, especially when accessing them in batch mode, e.g. as part of a software release build.
Search for a package
Find out whether a particular version of a software package is supported by O and has already been curated. A particular Web script is provided for this purpose, and an interactive Web interface is available to test and use this feature.
Obtain disclosure files
A shell script is provided to encapsulate the Web search script and obtain the related disclosure files. Another interactive Web interface is available to test and use this feature.
Obtain licensing information
Another Web script is available that also encapsulates the internal algorithm of the Web search script, but then generates a list of licenses that are used in a given software package. The script accepts as argument either a package name or a package name along with a version. In the former case the licenses of all available versions are listed, whereas in the latter the output is restricted to the specified version.
Obtain curation data in various format using a REST interface
The entire curation data of a software package can be retrieved in JSON format, curation data of a particular version can be retrieved in RDF-XML, SPDX2TV or YAML format.
Reuse existing material in case of version mismatch
If a particular version of a software package has not been curated before, but another one that may be close to it has, then FOSSology's reuse feature can be applied. Details are given in the presentation and video material on the O home page: Please check out "Use case 2" at the O presentations.
Contributing to the O project
How to contribute to the project if a package that is not yet included with O has been externally curated? Contributions are greatly appreciated, and therefore we would like to encourage as many users as possible to contribute. The more versions of more packages that are curated, the more beneficial the O project will be. However, to maintain confidence in the material, a rigorous vetting process was instituted. Volunteers are asked to first contact the O Officer via email. The easiest next step is then probably to arrange a video conference, get to know each other, and understand the basic principles of the O curation process. From that moment, new software packages can be curated and provided in the fork tree. The maintainer will then review the newly provided curation data in close collaboration with the contributor, and once the review is successful, the new curation data will be included and made publicly available through the repository. The contributor's and reviewer's names will be indicated in the README file of the package.
Best practices
FOSSology
In order to use the FOSSology Open Source curation administration tool in connection with the O project (when re-using the data and also when contributing to the project), a number of conventions should be observed.
Scancode
Normally, the Scancode Open Source scanning tool is used under the control of FOSSology in this project; however, to fine-tune or confirm the results it may be necessary to run the tool separately from command line. If this is done, the command line options should match the conventions of the O project.