Add bridge (#35)

* Add bridge

* Pin max version

* Pin to max 24.6

---------

Co-authored-by: Hylke Donker <[email protected]>
Co-authored-by: Caroline Frasca <[email protected]>

Author: 3 people

recipes/bridge/README.md

@@ -0,0 +1,34 @@
+# Bridge
+[![SAST](https://gitlab.com/hylkedonker/bridge/badges/main/pipeline.svg?job=sast)](https://gitlab.com/hylkedonker/bridge/-/security/dashboard)
+<p align="center">
+  <img src="misc/image.jpeg" width="30%" alt="Bridge">
+</p>
+
+This package acts as a bridge between Mojo native types and those from the Python world.
+
+Example usage, to convert a NumPy array to a Mojo tensor:
+```mojo
+from python import Python
+from bridge.numpy import ndarray_to_tensor
+
+var np = Python.import_module("numpy")
+np_array = np.array([[1, 2], [3, 4]], dtype=float)
+mojo_tensor = ndarray_to_tensor[DType.float64](np_array)
+```
+
+# Installation
+Add `https://repo.prefix.dev/modular-community` to the channels section of your of your
+`mojoproject.toml` file.
+Then run:
+```bash
+magic add bridge
+```
+
+# Dependencies
+Requires numpy and mojo.
+
+# Contributing
+Please refer to the [contribution guidelines](https://gitlab.com/hylkedonker/bridge/-/blob/main/CONTRIBUTING.md) before contributing.
+
+# License
+This code is licensed under the terms of the [MIT License](LICENSE.txt).

recipes/bridge/avatar.jpeg

@@ -0,0 +1,46 @@
+context:
+  version: "0.0.1"
+
+package:
+  name: "bridge"
+  version: ${{ version }}
+
+source:
+  - git: https://gitlab.com/hylkedonker/bridge.git
+    rev: bcbd2e6fd51c6187351d2e2f69c136c3c50253a6
+
+build:
+  number: 0
+  script:
+    - mojo package src/bridge -o ${{ PREFIX }}/lib/mojo/bridge.mojopkg
+requirements:
+  host:
+    - max=24.6
+  run:
+    - ${{ pin_compatible('max') }}
+
+tests:
+  - script:
+      - if: unix
+        then:
+          - mojo test test_numpy.🔥
+    files:
+      recipe:
+        - test_numpy.🔥
+about:
+  homepage: https://gitlab.com/hylkedonker/bridge
+  # Remember to specify the license variants for BSD, Apache, GPL, and LGPL.
+  # Use the SPDX identifier, e.g: GPL-2.0-only instead of GNU General Public License version 2.0
+  # See https://spdx.org/licenses/
+  license: MIT
+  # It is strongly encouraged to include a license file in the package,
+  # (even if the license doesn't require it) using the license_file entry.
+  # See https://docs.conda.io/projects/conda-build/en/latest/resources/define-metadata.html#license-file
+  license_file: LICENSE.txt
+  summary: Convert (bridge) Python objects to Mojo and vice versa.
+  repository: https://gitlab.com/hylkedonker/bridge
+
+extra:
+  maintainers:
+    - hylkedonker
+  project_name: Bridge

recipes/bridge/image.jpeg

@@ -0,0 +1,23 @@
+from python import Python
+from tensor import Tensor, rand
+from testing import assert_true, assert_equal
+
+from bridge.numpy import ndarray_to_tensor, tensor_to_ndarray
+
+
+def test_tensor_identity_transformation():
+    """Test that `ndarray_to_tensor` is inverse of `tensor_to_ndarray`."""
+    var values = List[Float64](1.0, 2.0, 3.0, 4.0, 5.0, 6.0)
+    var in_matrix = Tensor[DType.float64](shape=(3, 2), list=values)
+    var np_array = tensor_to_ndarray(in_matrix)
+    var out_matrix = ndarray_to_tensor[DType.float64](np_array)
+    assert_equal(in_matrix, out_matrix)
+
+
+def test_numpy_identity_transformation():
+    """Test that `tensor_to_ndarray` is inverse of `ndarray_to_tensor`."""
+    var np = Python.import_module("numpy")
+    var in_array = np.arange(6).reshape(3, 2)
+    var tensor = ndarray_to_tensor[DType.float64](in_array)
+    var out_array = tensor_to_ndarray(tensor)
+    assert_equal(in_array, out_array)