arnelify-broker 0.5.4__tar.gz

arnelify-broker-0.5.4/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.1
+Name: arnelify-broker
+Version: 0.5.4
+Summary: Minimalistic dynamic library which is a broker written in C and C++.
+Home-page: https://github.com/arnelify/arnelify-broker-python
+Author: Arnelify
+Keywords: arnelify arnelify-broker-python arnelify-broker
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+<img src="https://static.wikia.nocookie.net/arnelify/images/c/c8/Arnelify-logo-2024.png/revision/latest?cb=20240701012515" style="width:336px;" alt="Arnelify Logo" />
+
+![Arnelify Broker for Python](https://img.shields.io/badge/Arnelify%20Broker%20for%20Python-0.5.4-yellow) ![C++](https://img.shields.io/badge/C++-2b-red) ![G++](https://img.shields.io/badge/G++-14.2.0-blue) ![Python](https://img.shields.io/badge/Python-14.0.6-blue) ![Nuitka](https://img.shields.io/badge/Nuitka-14.0.6-blue)
+
+## 🚀 About
+**Arnelify® Broker for Python** - is a minimalistic dynamic library which is a message broker written in C and C++.
+
+## 📋 Minimal Requirements
+> Important: It's strongly recommended to use in a container that has been built from the gcc v14.2.0 image.
+* CPU: Apple M1 / Intel Core i7 / AMD Ryzen 7
+* OS: Debian 11 / MacOS 15 / Windows 10 with <a href="https://learn.microsoft.com/en-us/windows/wsl/install">WSL2</a>.
+* RAM: 4 GB
+
+## 📦 Installation
+Installing via pip:
+```
+pip install arnelify-broker
+```
+## 🎉 Usage
+Compile library for AMD64:
+```
+make build_amd64
+```
+Compile library for ARM64:
+```
+make build_arm64
+```
+Compiled test:
+```
+make test_nuitka
+```
+Run test:
+```
+make test
+```
+## 📚 Code Examples
+Configure the C/C++ IntelliSense plugin for VSCode (optional).
+```
+Clang_format_fallback = Google
+```
+
+IncludePath for VSCode (optional):
+```
+"includePath": [
+  "/opt/homebrew/Cellar/jsoncpp/1.9.6/include/json",
+  "${workspaceFolder}/src/cpp",
+  "${workspaceFolder}/src"
+],
+```
+You can find code examples <a href="https://github.com/arnelify/arnelify-broker-python/blob/main/tests/index.py">here</a>.
+
+## ⚖️ MIT License
+This software is licensed under the <a href="https://github.com/arnelify/arnelify-broker-python/blob/main/LICENSE">MIT License</a>. The original author's name, logo, and the original name of the software must be included in all copies or substantial portions of the software.
+
+## 🛠️ Contributing
+Join us to help improve this software, fix bugs or implement new functionality. Active participation will help keep the software up-to-date, reliable, and aligned with the needs of its users.
+
+
+## ⭐ Release Notes
+Version 0.5.4 - Minimalistic dynamic library
+
+We are excited to introduce the Arnelify Broker dynamic library for Python! Please note that this version is raw and still in active development.
+
+Change log:
+
+* Minimalistic dynamic library
+* NodeJS (Bun) addon
+* FFI Support
+
+Please use this version with caution, as it may contain bugs and unfinished features. We are actively working on improving and expanding the broker's capabilities, and we welcome your feedback and suggestions.
+
+## 🔗 Mentioned
+
+* <a href="https://github.com/arnelify/arnelify-pod-cpp">Arnelify POD for C++</a>
+* <a href="https://github.com/arnelify/arnelify-pod-python">Arnelify POD for Python</a>
+* <a href="https://github.com/arnelify/arnelify-pod-node">Arnelify POD for NodeJS</a>
+* <a href="https://github.com/arnelify/arnelify-react-native">Arnelify React Native</a>

arnelify-broker-0.5.4/README.md

@@ -0,0 +1,77 @@
+<img src="https://static.wikia.nocookie.net/arnelify/images/c/c8/Arnelify-logo-2024.png/revision/latest?cb=20240701012515" style="width:336px;" alt="Arnelify Logo" />
+
+![Arnelify Broker for Python](https://img.shields.io/badge/Arnelify%20Broker%20for%20Python-0.5.4-yellow) ![C++](https://img.shields.io/badge/C++-2b-red) ![G++](https://img.shields.io/badge/G++-14.2.0-blue) ![Python](https://img.shields.io/badge/Python-14.0.6-blue) ![Nuitka](https://img.shields.io/badge/Nuitka-14.0.6-blue)
+
+## 🚀 About
+**Arnelify® Broker for Python** - is a minimalistic dynamic library which is a message broker written in C and C++.
+
+## 📋 Minimal Requirements
+> Important: It's strongly recommended to use in a container that has been built from the gcc v14.2.0 image.
+* CPU: Apple M1 / Intel Core i7 / AMD Ryzen 7
+* OS: Debian 11 / MacOS 15 / Windows 10 with <a href="https://learn.microsoft.com/en-us/windows/wsl/install">WSL2</a>.
+* RAM: 4 GB
+
+## 📦 Installation
+Installing via pip:
+```
+pip install arnelify-broker
+```
+## 🎉 Usage
+Compile library for AMD64:
+```
+make build_amd64
+```
+Compile library for ARM64:
+```
+make build_arm64
+```
+Compiled test:
+```
+make test_nuitka
+```
+Run test:
+```
+make test
+```
+## 📚 Code Examples
+Configure the C/C++ IntelliSense plugin for VSCode (optional).
+```
+Clang_format_fallback = Google
+```
+
+IncludePath for VSCode (optional):
+```
+"includePath": [
+  "/opt/homebrew/Cellar/jsoncpp/1.9.6/include/json",
+  "${workspaceFolder}/src/cpp",
+  "${workspaceFolder}/src"
+],
+```
+You can find code examples <a href="https://github.com/arnelify/arnelify-broker-python/blob/main/tests/index.py">here</a>.
+
+## ⚖️ MIT License
+This software is licensed under the <a href="https://github.com/arnelify/arnelify-broker-python/blob/main/LICENSE">MIT License</a>. The original author's name, logo, and the original name of the software must be included in all copies or substantial portions of the software.
+
+## 🛠️ Contributing
+Join us to help improve this software, fix bugs or implement new functionality. Active participation will help keep the software up-to-date, reliable, and aligned with the needs of its users.
+
+
+## ⭐ Release Notes
+Version 0.5.4 - Minimalistic dynamic library
+
+We are excited to introduce the Arnelify Broker dynamic library for Python! Please note that this version is raw and still in active development.
+
+Change log:
+
+* Minimalistic dynamic library
+* NodeJS (Bun) addon
+* FFI Support
+
+Please use this version with caution, as it may contain bugs and unfinished features. We are actively working on improving and expanding the broker's capabilities, and we welcome your feedback and suggestions.
+
+## 🔗 Mentioned
+
+* <a href="https://github.com/arnelify/arnelify-pod-cpp">Arnelify POD for C++</a>
+* <a href="https://github.com/arnelify/arnelify-pod-python">Arnelify POD for Python</a>
+* <a href="https://github.com/arnelify/arnelify-pod-node">Arnelify POD for NodeJS</a>
+* <a href="https://github.com/arnelify/arnelify-react-native">Arnelify React Native</a>

arnelify-broker-0.5.4/arnelify_broker/__init__.py

@@ -0,0 +1 @@
+from .index import ArnelifyBroker

arnelify-broker-0.5.4/arnelify_broker/index.py

@@ -0,0 +1,154 @@
+import cffi
+import json
+import platform
+
+from concurrent.futures import Future
+
+class ArnelifyBroker:
+  def __init__(self):
+    self.ffi = cffi.FFI()
+
+    if platform.architecture()[0] != '64bit':
+      print("[Arnelify Broker FFI]: CPU platform isn't 64bit.")
+      exit(1)
+    
+    if platform.machine() == 'aarch64':
+      self.lib = self.ffi.dlopen('./arnelify_broker/bin/arnelify_broker_arm64.so')
+
+    elif platform.machine() == 'x86_64':
+      self.lib = self.ffi.dlopen('./arnelify_broker/bin/arnelify_broker_amd64.so')
+    else:
+      print("[Arnelify Broker FFI]: CPU platform isn't supported.")
+      exit(1)
+
+    self.ffi.cdef("""
+      typedef const char* cSerialized;
+      typedef const char* cDeserialized;
+
+      void broker_create();
+      const char* broker_deserialize(cSerialized);
+      void broker_destroy();
+      void broker_free(cDeserialized);
+      const char* broker_get_datetime();
+      const char* broker_get_uuid();
+      const char* broker_serialize(cDeserialized);
+    """)
+
+    self.actions: dict = {}
+    self.req: dict = {}
+    self.res: dict = {}
+    self.lib.broker_create()
+    
+  def callback(self, message: str, isError: bool) -> None:
+    if isError:
+      print(message)
+      return
+    
+    print(message)
+
+  def consumer(self, topic: str, onMessage: callable) -> None:
+    self.req[topic] = onMessage
+
+  def deserialize(self, message: str) -> dict:
+    cMessage = self.ffi.new("char[]", message.encode('utf-8'))
+    cDeserialized = self.lib.broker_deserialize(cMessage)
+    deserialized = self.ffi.string(cDeserialized).decode('utf-8')
+    self.lib.broker_free(cDeserialized)
+    json_: dict = {}
+
+    try: 
+      json_ = json.loads(deserialized)
+    except json.JSONDecodeError as err:
+      self.callback(f"[ArnelifyBroker FFI]: Python error: The Message must be a valid JSON.", True)
+      exit(1)
+
+    return json_
+
+  def handler(self, topic: str, ctx: dict) -> dict:
+    ctx["receivedAt"] = self.getDateTime()
+    action: callable = self.actions[topic]
+    res: dict = {
+      "content": action(ctx),
+      "createdAt": ctx["createdAt"],
+      "receivedAt": self.getDateTime(),
+      "topic": ctx["topic"],
+      "uuid": ctx["uuid"],
+    }
+
+    return res
+  
+  def producer(self, topic: str, message: str) -> None:
+    onMessage: callable = self.req[topic]
+    onMessage(message)
+
+  def receive(self, res: dict) -> None:
+    uuid: str = res["uuid"]
+    resolve: callable = self.res[uuid]
+    del self.res[uuid]
+    resolve(res["content"])
+
+  def send(self, topic: str, params: dict, producer: callable) -> dict:
+    future = Future()
+
+    uuid: str = self.getUuId()
+    def resolve(res: dict) -> None:
+      future.set_result(res)
+
+    self.res[uuid] = resolve
+    ctx: dict = {
+      "topic": topic,
+      "createdAt": self.getDateTime(),
+      "params": params,
+      "uuid": uuid
+    }
+
+    message: str = self.serialize(ctx)
+    producer(message)
+    return future.result()
+
+  def serialize(self, ctx: dict) -> str:
+    cCtx: str = json.dumps(ctx)
+    cDeserialized = self.ffi.new("char[]", cCtx.encode('utf-8'))
+    cSerialized = self.lib.broker_serialize(cDeserialized)
+    message: str = self.ffi.string(cSerialized).decode('utf-8')
+    self.lib.broker_free(cSerialized)
+    return message
+
+  def call(self, topic: str, params: dict) -> dict:
+    def callback(message: str) -> None:
+      self.producer(topic + ":req", message)
+
+    return self.send(topic, params, callback)
+
+  def getDateTime(self) -> str:
+    cDateTime = self.lib.broker_get_datetime()
+    datetime: str = self.ffi.string(cDateTime).decode('utf-8')
+    self.lib.broker_free(cDateTime)
+    return datetime
+  
+  def getUuId(self) -> str:
+    cUuId = self.lib.broker_get_uuid()
+    uuid: str = self.ffi.string(cUuId).decode('utf-8')
+    self.lib.broker_free(cUuId)
+    return uuid
+
+  def setAction(self, topic: str, action: callable) -> None:
+    self.actions[topic] = action
+
+  def subscribe(self, topic: str, action: callable) -> None:
+    self.setAction(topic, action)
+
+    def onResponse(message: str) -> None:
+      res: dict = self.deserialize(message)
+      self.receive(res)
+
+    self.consumer(topic + ":res", onResponse)
+
+    def onRequest(message: str) -> None:
+      ctx: dict = self.deserialize(message)
+      topic: str = ctx["topic"]
+      res: dict = self.handler(topic, ctx)
+      serialized: str = self.serialize(res)
+      self.producer(topic + ":res", serialized)
+
+    self.consumer(topic + ":req", onRequest)

arnelify-broker-0.5.4/arnelify_broker.egg-info/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.1
+Name: arnelify-broker
+Version: 0.5.4
+Summary: Minimalistic dynamic library which is a broker written in C and C++.
+Home-page: https://github.com/arnelify/arnelify-broker-python
+Author: Arnelify
+Keywords: arnelify arnelify-broker-python arnelify-broker
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+<img src="https://static.wikia.nocookie.net/arnelify/images/c/c8/Arnelify-logo-2024.png/revision/latest?cb=20240701012515" style="width:336px;" alt="Arnelify Logo" />
+
+![Arnelify Broker for Python](https://img.shields.io/badge/Arnelify%20Broker%20for%20Python-0.5.4-yellow) ![C++](https://img.shields.io/badge/C++-2b-red) ![G++](https://img.shields.io/badge/G++-14.2.0-blue) ![Python](https://img.shields.io/badge/Python-14.0.6-blue) ![Nuitka](https://img.shields.io/badge/Nuitka-14.0.6-blue)
+
+## 🚀 About
+**Arnelify® Broker for Python** - is a minimalistic dynamic library which is a message broker written in C and C++.
+
+## 📋 Minimal Requirements
+> Important: It's strongly recommended to use in a container that has been built from the gcc v14.2.0 image.
+* CPU: Apple M1 / Intel Core i7 / AMD Ryzen 7
+* OS: Debian 11 / MacOS 15 / Windows 10 with <a href="https://learn.microsoft.com/en-us/windows/wsl/install">WSL2</a>.
+* RAM: 4 GB
+
+## 📦 Installation
+Installing via pip:
+```
+pip install arnelify-broker
+```
+## 🎉 Usage
+Compile library for AMD64:
+```
+make build_amd64
+```
+Compile library for ARM64:
+```
+make build_arm64
+```
+Compiled test:
+```
+make test_nuitka
+```
+Run test:
+```
+make test
+```
+## 📚 Code Examples
+Configure the C/C++ IntelliSense plugin for VSCode (optional).
+```
+Clang_format_fallback = Google
+```
+
+IncludePath for VSCode (optional):
+```
+"includePath": [
+  "/opt/homebrew/Cellar/jsoncpp/1.9.6/include/json",
+  "${workspaceFolder}/src/cpp",
+  "${workspaceFolder}/src"
+],
+```
+You can find code examples <a href="https://github.com/arnelify/arnelify-broker-python/blob/main/tests/index.py">here</a>.
+
+## ⚖️ MIT License
+This software is licensed under the <a href="https://github.com/arnelify/arnelify-broker-python/blob/main/LICENSE">MIT License</a>. The original author's name, logo, and the original name of the software must be included in all copies or substantial portions of the software.
+
+## 🛠️ Contributing
+Join us to help improve this software, fix bugs or implement new functionality. Active participation will help keep the software up-to-date, reliable, and aligned with the needs of its users.
+
+
+## ⭐ Release Notes
+Version 0.5.4 - Minimalistic dynamic library
+
+We are excited to introduce the Arnelify Broker dynamic library for Python! Please note that this version is raw and still in active development.
+
+Change log:
+
+* Minimalistic dynamic library
+* NodeJS (Bun) addon
+* FFI Support
+
+Please use this version with caution, as it may contain bugs and unfinished features. We are actively working on improving and expanding the broker's capabilities, and we welcome your feedback and suggestions.
+
+## 🔗 Mentioned
+
+* <a href="https://github.com/arnelify/arnelify-pod-cpp">Arnelify POD for C++</a>
+* <a href="https://github.com/arnelify/arnelify-pod-python">Arnelify POD for Python</a>
+* <a href="https://github.com/arnelify/arnelify-pod-node">Arnelify POD for NodeJS</a>
+* <a href="https://github.com/arnelify/arnelify-react-native">Arnelify React Native</a>

arnelify-broker-0.5.4/arnelify_broker.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+setup.py
+arnelify_broker/__init__.py
+arnelify_broker/index.py
+arnelify_broker.egg-info/PKG-INFO
+arnelify_broker.egg-info/SOURCES.txt
+arnelify_broker.egg-info/dependency_links.txt
+arnelify_broker.egg-info/top_level.txt

arnelify-broker-0.5.4/arnelify_broker.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

arnelify-broker-0.5.4/arnelify_broker.egg-info/top_level.txt

@@ -0,0 +1 @@
+arnelify_broker

arnelify-broker-0.5.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

arnelify-broker-0.5.4/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+  name="arnelify-broker",
+  version="0.5.4",
+  author="Arnelify",
+  description="Minimalistic dynamic library which is a broker written in C and C++.",
+  url='https://github.com/arnelify/arnelify-broker-python',
+  keywords="arnelify arnelify-broker-python arnelify-broker",
+  packages=find_packages(),
+  install_requires=[],
+  long_description=open("README.md", "r", encoding="utf-8").read(),
+  long_description_content_type="text/markdown",
+  classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "License :: OSI Approved :: MIT License",
+  ]
+)