Metadata-Version: 2.1
Name: pymult
Version: 0.0.0
Summary: An example Python package written in x86-64 assembly.
Home-page: https://github.com/tonybaloney/python-assembly-poc
Author: Anthony Shaw
Author-email: anthonyshaw@apache.org
License: BSD-2-Clause
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Utilities
Requires-Python: >=3.7

# Building Python Extension Modules in Assembly

This repository is a proof-of-concept to demonstrate how you can create a Python Extension in 
100% assembly.

Demonstrates: 

 - How to write a Python module in pure assembly
 - How to write a function in pure assembly and call it from Python with Python objects
 - How to call the C API to create a PyObject and parse PyTuple (arguments) into raw pointers
 - How to pass data back into Python
 - How to register a module from assembly
 - How to create a method definition in assembly
 - How to write back to the Python stack using the dynamic module loader
 - How to package a NASM/Assembly Python extension with distutils

The simple proof-of-concept function takes 2 parameters,

```default
>>> import pymult
>>> pymult.multiply(2, 4)
8  
```

## But, Why?

Just because it can be done.

Also, I want to see if some AVX/AVX2 instructions (high-performance matrix multiplication especially) can be used
directly from Python.


