ontouml-py 0.2.0

OntoUML Python Library

ontouml-py

WORK IN PROGRESS

📦 PyPI Package: The transformation is conveniently available as a PyPI package, which allows users to use it as an executable script or import it as a library into other Python projects.

📚 Documentation: For inquiries and further information, please refer to the comprehensive docstring-generated documentation available for this project.

Contents

• ontouml-py
  • Contents
  • Installation and Use
    • Prerequisites
    • Instructions for Users
    • Instructions for Contributors
  • Development Stage:
  • The OntoUML-JS
  • How to Contribute
    • Report Issues
    • Code Contribution
    • Test Contribution
    • General Guidelines
  • Author

Installation and Use

Prerequisites

Ensure you have Python installed on your system before utilizing ontouml-py. It has been tested with Python versions 3.9 to 3.12 on Mac, Windows, and Linux. If not installed, download and install Python.

Instructions for Users

1. Install ontouml-py: Execute the following command to install the library:

pip install ontouml-py

All dependencies will be installed automatically.

2. Usage: To use ontouml-py, import the necessary functionalities in your Python code. Example:

from ontouml_py import AnOntoumlClass

Note: Replace AnOntoumlClass with the actual class you intend to use.

Instructions for Contributors

1. Fork the Project: Fork the ontouml-py repository to your own GitHub account.

2. Clone and Setup: Clone your forked repository and navigate to the project directory.

3. Install Dependencies: Use Poetry for dependency management. If not installed, refer to Poetry’s documentation for installation instructions. Then, install all dependencies with:

   poetry install
   

Now, you're ready to make enhancements or fixes and contribute back to ontouml-py!

Development Stage:

ontouml-py is still under active development.

Your contributions and feedback are valuable in enhancing ontouml-py and expanding its capabilities!

The OntoUML-JS

OntoUML JS is a versatile JavaScript library tailored for effortlessly handling OntoUML models. It streamlines the process of manipulating OntoUML models and serializing them into ontouml-schema compliant JSON files. With OntoUML JS, developers can efficiently create and manage OntoUML elements, construct models, and perform various model-related tasks programmatically. This library introduces constructor methods for creating OntoUML elements, provides support for container elements like projects and packages, and facilitates element serialization and deserialization. Additionally, OntoUML JS is continually updated with useful methods to simplify the development of OntoUML models. Whether you are working on ontology-driven conceptual modeling or require a tool for handling complex domain ontologies, OntoUML JS offers a valuable utility to streamline your workflow.

How to Contribute

Report Issues

• Report bugs or suggest features by opening an issue.
• Point out any discrepancies in the AI-generated documentation by opening an issue.

Code Contribution

1. Fork the Repository: Fork the project repository and create your feature branch: git checkout -b feature/YourFeatureName.
2. Commit Changes: Make and commit your changes with meaningful commit messages.
3. Push to Branch: Push your work back up to your fork: git push origin feature/YourFeatureName.
4. Submit a Pull Request: Open a pull request to merge your feature branch into the main project repository.

Test Contribution

• Improve reliability by adding or enhancing tests.

General Guidelines

• Ensure your code adheres to our coding standards.
• Update documentation as needed.
• Ensure that your code does not introduce additional issues.

Thank you for investing your time and expertise into this project!

Author

This project is maintained by the Semantics, Cybersecurity & Services (SCS) Group of the University of Twente, The Netherlands. Its developer is:

• Pedro Paulo Favato Barcelos [GitHub] [LinkedIn]

Feel free to get in touch using the provided links. For questions, contributions, or to report any problem, you can open an issue at this repository.