Files
IfcOpenShell/src/bsdd/bsdd.py
T
2024-04-16 11:26:35 +02:00

371 lines
14 KiB
Python

# bSDD - Python bSDD library
# Copyright (C) 2021 Dion Moult <dion@thinkmoult.com>
#
# This file is part of bSDD.
#
# bSDD is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# bSDD is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with bSDD. If not, see <http://www.gnu.org/licenses/>.
import uuid
import time
import json
import urllib
import requests
import webbrowser
import http.server
class OAuthReceiver(http.server.BaseHTTPRequestHandler):
def do_GET(self):
query = urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query)
self.server.auth_code = query.get("code", [""])[0]
self.server.auth_state = query.get("state", [""])[0]
self.send_response(200)
self.send_header("Content-type", "text/plain")
self.end_headers()
self.wfile.write("You have now authenticated :) You may now close this browser window.".encode("utf-8"))
class Client:
def __init__(self):
self.baseurl = "https://api.bsdd.buildingsmart.org/api/"
self.access_token = ""
self.refresh_token = ""
self.access_token_expires_on = time.time()
self.refresh_token_expires_on = time.time()
self.auth_endpoint = "https://buildingsmartservices.b2clogin.com/tfp/buildingsmartservices.onmicrosoft.com/b2c_1_signupsignin/oauth2/v2.0/authorize"
self.token_endpoint = "https://buildingsmartservices.b2clogin.com/tfp/buildingsmartservices.onmicrosoft.com/b2c_1_signupsignin/oauth2/v2.0/token"
self.client_id = "4aba821f-d4ff-498b-a462-c2837dbbba70"
def get(self, endpoint, params=None, is_auth_required=False):
headers = {}
if is_auth_required:
headers = {"Authorization": "Bearer " + self.get_access_token()}
return requests.get(f"{self.baseurl}{endpoint}", timeout=10, headers=headers, params=params or None).json()
def post(self):
pass # TODO
def get_access_token(self):
if self.access_token and self.access_token_expires_on > time.time():
return self.access_token
elif self.refresh_token and self.refresh_token_expires_on > time.time():
self.get_new_access_token()
else:
self.login()
return self.access_token
def login(self):
with http.server.HTTPServer(("", 0), OAuthReceiver) as server:
state = str(uuid.uuid4())
query = urllib.parse.urlencode(
{
"client_id": self.client_id,
"response_type": "code",
# offline_access required to get a refresh_token
"scope": "https://buildingsmartservices.onmicrosoft.com/api/read offline_access",
"state": state,
"redirect_uri": f"http://localhost:{server.server_address[1]}",
}
)
webbrowser.open(f"{self.auth_endpoint}?{query}")
server.timeout = 75
server.state = state
server.handle_request()
if server.auth_code and server.auth_state == state:
self.set_tokens_from_response(
requests.post(
"https://buildingsmartservices.b2clogin.com/tfp/buildingsmartservices.onmicrosoft.com/b2c_1_signupsignin/oauth2/v2.0/token",
params={
"grant_type": "authorization_code",
"code": server.auth_code,
},
).json()
)
def get_new_access_token(self):
self.set_tokens_from_response(
requests.post(
self.token_endpoint,
params={
"grant_type": "refresh_token",
"refresh_token": self.refresh_token,
},
).json()
)
def set_tokens_from_response(self, response):
self.access_token = response["access_token"]
self.refresh_token = response["refresh_token"]
self.access_token_expires_on = time.time() + response["expires_in"]
self.refresh_token_expires_on = time.time() + response["refresh_token_expires_in"]
def Classification(self, namespaceUri, version="v3", languageCode="", includeChildClassificationReferences=True):
return self.get(
f"api/Classification/{version}",
{
"namespaceUri": namespaceUri,
"languageCode": languageCode,
"includeChildClassificationReferences": includeChildClassificationReferences,
},
)
def ClassificationSearchOpen(self, SearchText, version="v1", DomainNamespaceUris=None, RelatedIfcEntities=None):
if DomainNamespaceUris is None:
DomainNamespaceUris = []
if RelatedIfcEntities is None:
RelatedIfcEntities = []
return self.get(
f"api/ClassificationSearchOpen/{version}",
{
"SearchText": SearchText,
"DomainNamespaceUris": DomainNamespaceUris,
"RelatedIfcEntities": RelatedIfcEntities,
},
)
def Country(self, version="v1"):
return self.get(f"api/Country/{version}")
def Domain(self, version="v2"):
return self.get(f"api/Domain/{version}")
def graphql(self):
return # TODO
def Language(self, version="v1"):
return self.get(f"api/Language/{version}")
def Property(self, namespaceUri, version="v2", languageCode=""):
return self.get(f"api/Property/{version}", {"namespaceUri": namespaceUri, "languageCode": languageCode})
def PropertyValue(self, namespaceUri, version="v1", languageCode=""):
return self.get(f"api/PropertyValue/{version}", {"namespaceUri": namespaceUri, "languageCode": languageCode})
def ReferenceDocument(self, version="v1"):
return self.get(f"api/ReferenceDocument/{version}")
def RequestExportFile(self):
return # TODO
def SearchList(self, DomainNamespaceUri, version="v2", SearchText="", LanguageCode="", RelatedIfcEntity=""):
return self.get(
f"api/SearchList/{version}",
{
"DomainNamespaceUri": DomainNamespaceUri,
"SearchText": SearchText,
"LanguageCode": LanguageCode,
"RelatedIfcEntity": RelatedIfcEntity,
},
is_auth_required=True,
)
def SearchListOpen(self, DomainNamespaceUri, version="v2", SearchText="", LanguageCode="", RelatedIfcEntity=""):
return self.get(
f"api/SearchListOpen/{version}",
{
"DomainNamespaceUri": DomainNamespaceUri,
"SearchText": SearchText,
"LanguageCode": LanguageCode,
"RelatedIfcEntity": RelatedIfcEntity,
},
)
def TextSearchListOpen(self):
return # TODO
def Unit(self, version="v1"):
return self.get(f"api/Unit/{version}")
def get_dictionary(self, dictionary_uri: str = "", version: int = 1):
"""
Get list of available Dictionaries
This API replaces Domain
"""
endpoint = f"Dictionary/v{version}"
params = {
"Uri": dictionary_uri,
}
return self.get(endpoint, params)
def get_classes(self, dictionary_uri: str, use_nested_classes: bool = True, class_type: str = "Class",
language_code: str = "", version: int = 1):
"""
Get Dictionary with tree of classes
This API replaces Domain
"""
endpoint = f"Dictionary/v{version}/Classes"
params = {
"Uri": dictionary_uri,
"UseNestedClasses": use_nested_classes,
"ClassType": class_type,
"languageCode": language_code,
}
return self.get(endpoint, params)
def get_properties(self, dictionary_uri: str, language_code: str = "", version: int = 1):
"""
Get Dictionary with its properties
"""
endpoint = f"Dictionary/v{version}/Properties"
params = {
"Uri": dictionary_uri,
"languageCode": language_code,
}
return self.get(endpoint, params)
def get_class(self, class_uri: str, include_class_properties: bool = True,
include_child_class_reference: bool = True, include_class_relations: bool = True,
language_code: str = "", version: int = 1):
"""
Get Class details
this API replaces Classification
"""
endpoint = f"Dictionary/v{version}/Properties"
params = {
"Uri": class_uri,
"includeClassProperties": include_class_properties,
"includeChildClassReferences": include_child_class_reference,
"includeClassRelations": include_class_relations,
"languageCode": language_code,
}
return self.get(endpoint, params)
def get_property(self, uri, include_classes=False, language_code="", version: int = 4):
"""
Get Property Detail
this API replaces Property
"""
endpoint = f"Property/v{version}"
params = {
"uri": uri,
"includeClasses": include_classes,
"LanguageCode": language_code,
}
return self.get(endpoint, params)
def get_property_value(self, uri, language_code="", version: int = 2):
"""
Get Property Value details
this API replaces PropertyValue
"""
endpoint = f"PropertyValue/v{version}"
params = {
"uri": uri,
"LanguageCode": language_code,
}
return self.get(endpoint, params)
def search_text(self, search_text: str, type_filter="All", dictionary_uris=[], version: int = 1):
"""
Search the bSDD database using free text, get list of Classes and/or Properties matching the text.
Pagination options are for Classes and Properties combined.
So if result consists of 10 classes and 5 properties, TotalCount will be 15.
Classes will be listed first, so if you then use Offset=10 and Limit=5, you will get the 5 properties.
"""
endpoint = f"TextSearch/v{version}"
params = {
"SearchText": search_text,
"TypeFilter": type_filter,
"DictionaryUris": dictionary_uris,
}
return self.get(endpoint, params)
pass
def search_in_dictionary(self, dictionary_uri: str, search_text: str = "", language_code: str = "",
related_ifc_entity: str = "", version: int = "1"):
"""
Search the bSDD database, get list of Classes without details.
This version uses new naming and returns one Dictionary instead of a list with always one Dictionary.
This API replaces SearchList.
"""
endpoint = f"SearchInDictionary/v{version}"
params = {
"DictionaryUri": dictionary_uri,
"SearchText": search_text,
"LanguageCode": language_code,
"RelatedIfcEntity": related_ifc_entity,
}
return self.get(endpoint, params)
def search_class(self, search_text: str, dictionary_uris=[], related_ifc_entities=[], version: int = 1):
"""
Search the bSDD database using free text, get list of Classes matching the text and optional additional filters.
this API replaces ClassificationSearch
"""
endpoint = f"Class/Search/v{version}"
params = {
"SearchText": search_text,
"DictionaryUris": dictionary_uris,
"RelatedIfcEntities": related_ifc_entities,
}
return self.get(endpoint, params)
def get_countries(self, version: int = 1):
"""
Get list of all Countries
this API replaces Country
"""
endpoint = f"Country/v{version}"
params = {}
return self.get(endpoint, params)
def get_languages(self, version: int = 1):
"""
Get list of available Languages
this API replaces Language
"""
endpoint = f"Language/v{version}"
params = {}
return self.get(endpoint, params)
def get_reference_documents(self, version: int = 1):
"""
Get list of all ReferenceDocuments
this API replaces Country
"""
endpoint = f"ReferenceDocument/v{version}"
params = {}
return self.get(endpoint, params)
def get_units(self, version: int = 1):
"""
Get list of all Units
this API replaces Unit
"""
endpoint = f"Unit/v{version}"
params = {}
return self.get(endpoint, params)
def apply_ifc_classification_properties(ifc_file, element, classificationProperties):
import ifcopenshell
import ifcopenshell.api
import ifcopenshell.util.element
psets = ifcopenshell.util.element.get_psets(element)
for prop in classificationProperties:
predefinedValue = prop.get("predefinedValue")
if not predefinedValue or prop.get("propertyDomainName") != "IFC":
continue
pset = psets.get(prop["propertySet"])
if pset:
pset = ifc_file.by_id(pset["id"])
else:
pset = ifcopenshell.api.run("pset.add_pset", ifc_file, product=element, name=prop["propertySet"])
if prop["dataType"] == "boolean":
predefinedValue = predefinedValue == "TRUE"
ifcopenshell.api.run("pset.edit_pset", ifc_file, pset=pset, properties={prop["name"]: predefinedValue})