Item:OSW659a81662ff44af1b2b6febeee7c3a25

OSW Python Package ID: OSW659a81662ff44af1b2b6febeee7c3a25 | UUID: 659a8166-2ff4-4af1-b2b6-febeee7c3a25 | 📦: world.opensemantic.meta.docs.core
ID	OSW659a81662ff44af1b2b6febeee7c3a25
UUID	659a8166-2ff4-4af1-b2b6-febeee7c3a25
Label	OSW Python Package
Machine compatible name	OswPythonPackage
Types/Categories	Tutorial
Statements (outgoing)
Statements (incoming)
Details
Types/Categories<br>Definition: Entity, Item, Creative Work, Article, Tutorial: Tutorial Label(s)At least one label is required.<br>Definition: Entity: OSW Python Package Description<br>Definition: Entity: Demonstrates Python code generation from Wiki Categories Prerequisites (required)<br>Definition: Tutorial: Transcend wikitext to store and edit structured & linked data JSON-SCHEMA Tutorial

Description

Demonstrates Python code generation from Wiki Categories

Item
Type(s)/Category(s)	Tutorial

Tutorial
Prerequisites (required)	Transcend wikitext to store and edit structured & linked data JSON-SCHEMA Tutorial
Prerequisites (optional)
Follow-up (recommended)

View as slide show

Overview

osw-python aims to simplify the application of linked data and linked data schemas stored in knowledge graphs in python

Diagram diagram-json

In a nutshell, it only requires a few lines to

• build required data classes from the knowledge graph
• load instances explicit or on demand from the knowledge graph
• call function through bound controller classes
• store created instances in the knowledge graph

# illustrative example

osw.load("<schema iri or query>")

foo : model.Foo = osw.get("<instance iri or query>")

print(foo.bar.id)

baz = foo.cast(controller.Foo).calc()

osw.put(baz)

Diagram OSW Python Package core concepts

JSON-Schema and Data Classes

Codegeneration from jsonschema slots for Category pages with osw-python and datamodel-code-generator

Category:MyCategory jsonschema

{
    "type": "object",
    "properties": {
        "text": { "type": "string" },
        "number": { "type": "number" },
        "array": { "type": "array" }
    }
}

Category:MySubCategory jsonschema

{
    "type": "object",
    "allOf": "/wiki/Category:MyCategory?action=raw&slot=jsonschema",
    "properties": {
        "additional_property": { "type": "string" }
    }
}

Generated Python Code

class MyClass():
    text: str
    number: float
    array: List[Any]
    
class MySubClass(MyClass):
    additional_property: str

Data Class Instance Serialization

JSON generation from python class instances with pydantic BaseModel

Python Dataclass

class MyClass(BaseModel):
    text: str
    number: float
    array: List[Any]
    
class MySubClass(MyClass):
    additional_property: str

Python Class Instance

my_instance = MySubClass(
    text="some text",
    number=1.1,
    array=[1, "two", 3.0]
    additional_property = "test2"
)
my_instance.json()
my_instance = osw.store_entity(my_instance) # wiki upload

Uploaded json by calling my_instance.json()

{
    "text": "some text",
    "number": 1.0,
    "array": [1,"two",3.0],
    "additional_property": "test2"
}

Controller Extension of Data Classes

Add functionalities to entities represented by wiki pages

Python Dataclass

class MyClass():
    text: str
    number: float
    array: List[Any]
    
class MySubClass(MyClass):
    additional_property: str

Python Controller Class

class MyClassController(MyClass):
    def print_text(text):
        print(self.text)

Controller instantiation and execution

my_instance = MySubClass(
    text="some text",
    # ...
)
# or
my_instance = osw.load_entity("Item:...")

my_instance = my_instance.cast(MyInstanceController)
my_instance.print_text() # "some text"

Tutorial Graph

Graph graph-01

Graph

QR Code

Attachments

Description:

📎 Select files (or drop them here)... 📷 Camera

jsondata

required_predecessor	"Item:OSW7113f5cf921a4c82ad1872afeff9d01d" "Item:OSWf4a9514baed04859a4c6c374a7312f10"
type	"Category:OSW494f660e6a714a1a9681c517bbb975da"
uuid	"659a8166-2ff4-4af1-b2b6-febeee7c3a25"
name	"OswPythonPackage"
label	text "OSW Python Package" lang "en"
description	text "Demonstrates Python code generation from Wiki Categories" lang "en"