csBigInteger.py

csBigInteger for Python 3

This project is part of the csBigInteger macro project, a C# BigInteger implementation on Python

There are two different basis for this project: one native dotnet/python and another that uses csBigInteger.cpp portable C++ project: https://github.com/neoresearch/csBigInteger.cpp Note that portable C++ itself has two implementations, csbiginteger_gmp.so and csbiginteger_mono.so. The GMP is straightforward, since it only depends on GNU GMP runtimes, and Mono implementation depends on mono runtime and csbiginteger_dotnet.dll.

build dependencies (C++ portable)

First, you need to have csbiginteger_gmp.so (or csbiginteger_mono.so) shared library (just type make vendor). This command will also install debian/ubuntu dependency on GNU GMP library (from csBigInteger.cpp project): sudo apt install libgmp-dev.

Don't worry, we are already shipping a linux x86-64 library for you (no default windows build yet.. help is appreciated!). Current default is csbiginteger_mono.so, so you will need csbiginteger_dotnet.dll on your path (also shipped for you).

Important: Remember to clone csBigIntegerpp portable submodule (git clone --recursive or git pull --recurse-submodules).

build dependencies (C# dotnet)

If you want to use ported native version, you need to install few extra dotnet dependencies.

python3.7 -m pip install pip

pip install msl-loadlib --user

pip install pycparser --user

pip install pythonnet --user

These may require mono to be installed.

Mono deps (linux)

Deepin uses Ubuntu 16.04 deps:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
sudo apt install apt-transport-https ca-certificates
echo "deb https://download.mono-project.com/repo/ubuntu stable-xenial main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
sudo apt update
sudo apt install mono-complete

building dotnet project library

cd csbiginteger/dotnet

dotnet build -c Release (this should generate csbiginteger.dll inside dotnet/bin/ folder)

To publish: dotnet publish --configuration Release --self-contained (see publish folder on bin)

How to use it?

Try python3 test_cpp.py code, it should work! (or just type make run):

from csbiginteger.BigInteger import BigInteger

# or, use dotnet version
from csbiginteger.BigIntegerNet import BigIntegerNet

def main():
    big = BigInteger()
    print('length = ', len(big))
    print('to_int = ', big.to_int())
    print('to_str: ', big.to_str())
    print('')

    bigM1 = BigInteger(-1)
    print('length = ', len(bigM1))
    print('to_int = ', bigM1.to_int())
    print('to_str: ', bigM1.to_str())
    print('')

    big4293967296 = BigInteger(4293967296)
    print('length = ', len(big4293967296))
    print('to_int = ', big4293967296.to_int())
    print('to_long = ', big4293967296.to_long())
    print('to_str: ', big4293967296.to_str())
    print('')

    bigff = BigInteger(b'\xff')
    print('length = ', len(bigff))
    print('to_int = ', bigff.to_int())
    print('to_long = ', bigff.to_long())
    print('to_str: ', bigff.to_str())
    print('')

    big100 = BigInteger('100') # base 10 implicit
    print('length = ', len(big100))
    print('to_int = ', big100.to_int())
    print('to_long = ', big100.to_long())
    print('to_str: ', big100.to_str())
    print('')

    big0001 = BigInteger('0x0001', 16) # big-endian input string
    print('length = ', len(big0001))
    print('to_int = ', big0001.to_int())
    print('to_long = ', big0001.to_long())
    print('to_str: ', big0001.to_str())
    print('')

    big101 = big100.add(big0001) # big100 + big0001
    print('length = ', len(big101))
    print('to_int = ', big101.to_int())
    print('to_long = ', big101.to_long())
    print('to_str: ', big101.to_str())
    print('')

    big99 = big100.sub(big0001) # big100 - big0001
    print('length = ', len(big99))
    print('to_int = ', big99.to_int())
    print('to_long = ', big99.to_long())
    print('to_str: ', big99.to_str())


    return 0

Empty BigInteger is expected to be byte array 0x00, with size = 1 (byte) and int value zero.

length =  1
to_int =  0
to_str:  0x00

length =  1
to_int =  -1
to_str:  0xff

length =  5
to_int =  -1000000
to_long =  4293967296
to_str:  0x00fff0bdc0

length =  1
to_int =  -1
to_long =  -1
to_str:  0xff

length =  1
to_int =  100
to_long =  100
to_str:  0x64

length =  1
to_int =  1
to_long =  1
to_str:  0x01

length =  1
to_int =  101
to_long =  101
to_str:  0x65

length =  1
to_int =  99
to_long =  99
to_str:  0x63

LICENSE

MIT License

2019

City of Research (CoR) = City Of Zion + NeoResearch