cocoa-py 0.1.0a1__tar.gz

cocoa_py-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yosorable
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cocoa_py-0.1.0a1/MANIFEST.in

@@ -0,0 +1,4 @@
+include native/coreml/*.h
+include native/coreml/*.mm
+include tests/test_coreml.py
+include tests/CoreMLFixtures/CoreMLFixtures.zip

cocoa_py-0.1.0a1/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: cocoa-py
+Version: 0.1.0a1
+Summary: Native Apple platform modules for Python; initial Core ML preview
+Author: Yosorable
+License-Expression: MIT
+Keywords: apple,macos,coreml,native,inference
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Objective C
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: <3.15,>=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: coreml
+Requires-Dist: numpy<3,>=2.3.3; extra == "coreml"
+Dynamic: license-file
+
+# cocoa-py
+
+Native Apple platform modules for Python, extracted from Pythona and designed
+to be used independently of the app.
+
+## Preview status
+
+**Version 0.1.0a1 contains the standalone `coreml` extension only.** It provides
+Core ML model compilation, inspection, and inference on macOS. The `audio`,
+`scene`, `photos`, and other system modules are planned for subsequent previews
+and are not included in this release.
+
+This preview targets macOS 14 or later and standard CPython 3.14 with the GIL.
+An Apple Silicon wheel is provided. The source distribution requires Apple's
+Xcode command-line tools and the macOS SDK to build.
+
+The source originated in an iOS app, but this preview does not yet provide an
+iOS embedding package or integration instructions.
+
+## Install
+
+```sh
+python3.14 -m pip install 'cocoa-py[coreml]==0.1.0a1'
+```
+
+The `coreml` extra installs NumPy, which the native extension needs at runtime.
+The distribution name is `cocoa-py`; the public module is imported directly:
+
+```python
+import coreml
+import numpy as np
+
+compiled_path = coreml.compile("model.mlpackage")
+model = coreml.load(compiled_path, compute_units="all")
+print(coreml.describe(model))
+
+# Replace the input name, shape and dtype with those required by your model.
+result = coreml.predict(model, {"input": np.zeros((1, 3, 224, 224), dtype=np.float32)})
+print(result)
+```
+
+Models are supplied by the caller. Importing `coreml` initializes its NumPy
+interface; models are compiled or loaded only by explicit API calls.
+
+## API
+
+| Function | Purpose |
+| --- | --- |
+| `compile(model_path, output_dir=None)` | Compile a `.mlmodel` or `.mlpackage`, returning the `.mlmodelc` directory. |
+| `load(path, compute_units="all")` | Load a compiled model and return a `Model` handle. |
+| `describe(model)` | Inspect model inputs and outputs, including shapes and data types. |
+| `predict(model, inputs)` | Run inference with a dictionary of named inputs. |
+| `batch_predict(model, inputs_list)` | Run a batch of input dictionaries. |
+| `metadata(model)` | Read author, version, license and description metadata. |
+
+`compute_units` accepts `all`, `cpuAndNeuralEngine`, `cpuAndGPU`, or `cpuOnly`.
+The system chooses available hardware within that selection.
+
+Tensor inputs support NumPy `float16`, `float32`, `float64`, and `int32` arrays.
+Color image inputs use `uint8` RGB or RGBA arrays; grayscale images use `uint8`
+or `float16` according to the model. Color image outputs use RGBA. Tensor
+outputs preserve their supported dtype and are returned as contiguous arrays.
+Scalar inputs may be integers, floats, or strings where accepted by the model.
+
+This API provides stateless inference. Stateful models, model updates, and
+sequence inputs and outputs are not exposed by this preview.
+
+## Build and test
+
+```sh
+python3.14 -m pip install build
+MACOSX_DEPLOYMENT_TARGET=14.0 python3.14 -m build
+python3.14 -m pip install --force-reinstall '.[coreml]'
+python3.14 -m unittest discover -s tests -v
+```
+
+The source distribution includes small generated test models. Tests exercise
+real Core ML compilation and inference on the Mac; no simulator is required.
+
+## License
+
+MIT. Copyright (c) 2026 Yosorable.

cocoa_py-0.1.0a1/README.md

@@ -0,0 +1,82 @@
+# cocoa-py
+
+Native Apple platform modules for Python, extracted from Pythona and designed
+to be used independently of the app.
+
+## Preview status
+
+**Version 0.1.0a1 contains the standalone `coreml` extension only.** It provides
+Core ML model compilation, inspection, and inference on macOS. The `audio`,
+`scene`, `photos`, and other system modules are planned for subsequent previews
+and are not included in this release.
+
+This preview targets macOS 14 or later and standard CPython 3.14 with the GIL.
+An Apple Silicon wheel is provided. The source distribution requires Apple's
+Xcode command-line tools and the macOS SDK to build.
+
+The source originated in an iOS app, but this preview does not yet provide an
+iOS embedding package or integration instructions.
+
+## Install
+
+```sh
+python3.14 -m pip install 'cocoa-py[coreml]==0.1.0a1'
+```
+
+The `coreml` extra installs NumPy, which the native extension needs at runtime.
+The distribution name is `cocoa-py`; the public module is imported directly:
+
+```python
+import coreml
+import numpy as np
+
+compiled_path = coreml.compile("model.mlpackage")
+model = coreml.load(compiled_path, compute_units="all")
+print(coreml.describe(model))
+
+# Replace the input name, shape and dtype with those required by your model.
+result = coreml.predict(model, {"input": np.zeros((1, 3, 224, 224), dtype=np.float32)})
+print(result)
+```
+
+Models are supplied by the caller. Importing `coreml` initializes its NumPy
+interface; models are compiled or loaded only by explicit API calls.
+
+## API
+
+| Function | Purpose |
+| --- | --- |
+| `compile(model_path, output_dir=None)` | Compile a `.mlmodel` or `.mlpackage`, returning the `.mlmodelc` directory. |
+| `load(path, compute_units="all")` | Load a compiled model and return a `Model` handle. |
+| `describe(model)` | Inspect model inputs and outputs, including shapes and data types. |
+| `predict(model, inputs)` | Run inference with a dictionary of named inputs. |
+| `batch_predict(model, inputs_list)` | Run a batch of input dictionaries. |
+| `metadata(model)` | Read author, version, license and description metadata. |
+
+`compute_units` accepts `all`, `cpuAndNeuralEngine`, `cpuAndGPU`, or `cpuOnly`.
+The system chooses available hardware within that selection.
+
+Tensor inputs support NumPy `float16`, `float32`, `float64`, and `int32` arrays.
+Color image inputs use `uint8` RGB or RGBA arrays; grayscale images use `uint8`
+or `float16` according to the model. Color image outputs use RGBA. Tensor
+outputs preserve their supported dtype and are returned as contiguous arrays.
+Scalar inputs may be integers, floats, or strings where accepted by the model.
+
+This API provides stateless inference. Stateful models, model updates, and
+sequence inputs and outputs are not exposed by this preview.
+
+## Build and test
+
+```sh
+python3.14 -m pip install build
+MACOSX_DEPLOYMENT_TARGET=14.0 python3.14 -m build
+python3.14 -m pip install --force-reinstall '.[coreml]'
+python3.14 -m unittest discover -s tests -v
+```
+
+The source distribution includes small generated test models. Tests exercise
+real Core ML compilation and inference on the Mac; no simulator is required.
+
+## License
+
+MIT. Copyright (c) 2026 Yosorable.

cocoa_py-0.1.0a1/cocoa_py.egg-info/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: cocoa-py
+Version: 0.1.0a1
+Summary: Native Apple platform modules for Python; initial Core ML preview
+Author: Yosorable
+License-Expression: MIT
+Keywords: apple,macos,coreml,native,inference
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Objective C
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: <3.15,>=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: coreml
+Requires-Dist: numpy<3,>=2.3.3; extra == "coreml"
+Dynamic: license-file
+
+# cocoa-py
+
+Native Apple platform modules for Python, extracted from Pythona and designed
+to be used independently of the app.
+
+## Preview status
+
+**Version 0.1.0a1 contains the standalone `coreml` extension only.** It provides
+Core ML model compilation, inspection, and inference on macOS. The `audio`,
+`scene`, `photos`, and other system modules are planned for subsequent previews
+and are not included in this release.
+
+This preview targets macOS 14 or later and standard CPython 3.14 with the GIL.
+An Apple Silicon wheel is provided. The source distribution requires Apple's
+Xcode command-line tools and the macOS SDK to build.
+
+The source originated in an iOS app, but this preview does not yet provide an
+iOS embedding package or integration instructions.
+
+## Install
+
+```sh
+python3.14 -m pip install 'cocoa-py[coreml]==0.1.0a1'
+```
+
+The `coreml` extra installs NumPy, which the native extension needs at runtime.
+The distribution name is `cocoa-py`; the public module is imported directly:
+
+```python
+import coreml
+import numpy as np
+
+compiled_path = coreml.compile("model.mlpackage")
+model = coreml.load(compiled_path, compute_units="all")
+print(coreml.describe(model))
+
+# Replace the input name, shape and dtype with those required by your model.
+result = coreml.predict(model, {"input": np.zeros((1, 3, 224, 224), dtype=np.float32)})
+print(result)
+```
+
+Models are supplied by the caller. Importing `coreml` initializes its NumPy
+interface; models are compiled or loaded only by explicit API calls.
+
+## API
+
+| Function | Purpose |
+| --- | --- |
+| `compile(model_path, output_dir=None)` | Compile a `.mlmodel` or `.mlpackage`, returning the `.mlmodelc` directory. |
+| `load(path, compute_units="all")` | Load a compiled model and return a `Model` handle. |
+| `describe(model)` | Inspect model inputs and outputs, including shapes and data types. |
+| `predict(model, inputs)` | Run inference with a dictionary of named inputs. |
+| `batch_predict(model, inputs_list)` | Run a batch of input dictionaries. |
+| `metadata(model)` | Read author, version, license and description metadata. |
+
+`compute_units` accepts `all`, `cpuAndNeuralEngine`, `cpuAndGPU`, or `cpuOnly`.
+The system chooses available hardware within that selection.
+
+Tensor inputs support NumPy `float16`, `float32`, `float64`, and `int32` arrays.
+Color image inputs use `uint8` RGB or RGBA arrays; grayscale images use `uint8`
+or `float16` according to the model. Color image outputs use RGBA. Tensor
+outputs preserve their supported dtype and are returned as contiguous arrays.
+Scalar inputs may be integers, floats, or strings where accepted by the model.
+
+This API provides stateless inference. Stateful models, model updates, and
+sequence inputs and outputs are not exposed by this preview.
+
+## Build and test
+
+```sh
+python3.14 -m pip install build
+MACOSX_DEPLOYMENT_TARGET=14.0 python3.14 -m build
+python3.14 -m pip install --force-reinstall '.[coreml]'
+python3.14 -m unittest discover -s tests -v
+```
+
+The source distribution includes small generated test models. Tests exercise
+real Core ML compilation and inference on the Mac; no simulator is required.
+
+## License
+
+MIT. Copyright (c) 2026 Yosorable.

cocoa_py-0.1.0a1/cocoa_py.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+cocoa_py.egg-info/PKG-INFO
+cocoa_py.egg-info/SOURCES.txt
+cocoa_py.egg-info/dependency_links.txt
+cocoa_py.egg-info/requires.txt
+cocoa_py.egg-info/top_level.txt
+native/coreml/CoreMLModule.h
+native/coreml/CoreMLModule.mm
+tests/test_coreml.py
+tests/CoreMLFixtures/CoreMLFixtures.zip

cocoa_py-0.1.0a1/cocoa_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cocoa_py-0.1.0a1/cocoa_py.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[coreml]
+numpy<3,>=2.3.3

cocoa_py-0.1.0a1/cocoa_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+coreml

cocoa_py-0.1.0a1/native/coreml/CoreMLModule.h

@@ -0,0 +1,16 @@
+#ifndef CoreMLModule_h
+#define CoreMLModule_h
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/// Register the _coreml built-in Python module.
+/// Must be called BEFORE Py_Initialize().
+void registerCoreMLModule(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* CoreMLModule_h */