VS Code extension for Phenoscript language

This is an extension for VS Code that provides syntax highlight and snippet viewer for Phenoscript language. It is available for free in the Visual Studio Code Marketplace.

Phenoscript is a computer language designed for describing species using ontologies for downstream automatic comparison of their traits. Such analyses can be performed using the Python package Phenospy available at PyPi repo. See also Phenospy GitHub repo.

Features

Project Setup & OWL Conversion (v0.0.24+)

The extension sidebar provides two commands:

Create Project — scaffolds a new PhenoScript project with the correct directory structure:

my_project/
├── phenotypes/
│   ├── phs-config.yaml   ← fill in your name, ORCID, and project title
│   └── my_species.yphs   ← your phenotype description file
├── source_ontologies/
└── output/
    └── owl_init/         ← converted OWL files appear here

Convert to OWL — converts the active .phs or .yphs file to OWL ontology (.owl + .xml) using the phenoscript-docker image.

Prerequisite: Docker Desktop must be installed and running. The Docker image is pulled automatically on first use — no manual setup required.

Documentation

See Wiki for details.

Funding

This project is supported by the Academy of Finland grants 339576 and 346294.

Installing

Install VS Code and launch it. Install the Phenoscript extension from the Visual Studio Code Marketplace by clicking on "Extensions" on the left hand side bar.

Usage

To activate the ontology term info lookup feature, follow these steps:

• Place your cursor on the focal term.
• Use the following hotkeys based on your platform:
  • Windows: "Ctrl+Shift+E"
  • macOS: "Cmd+Shift+E"

This will provide you with information about the ontology term you have selected.

Recommended Packages

To enhance your experience with PhenoScript, we recommend installing and using the following packages. For more information, please visit the Wiki.

• Highlight IceMode Extension
• Highlight Package

Known Issues

n/a

Release Notes

This is the first release that is currently in the testing phase.

0.0.11

Syntax highlight, dark theme, snippets.

0.0.19

• Ontology Term info Lookup via Webview.
• Smart syntax error highlighting. When quality terms are linked using 'has_part' or 'part_of,' the statements are displayed with red highlighting.
• Integration with Highlight package: three types of colorful comments and bounding boxes for color terms.

0.0.20

• README update

0.0.21/0.0.22

• Improved highlight of erroneous syntax

0.0.23

• Snippets are added for markdown to insert ontology terms. Click ctrl+space if the snippets do not appear automatically.

Credits

The theme is based on One Dark Teme.