Metadata-Version: 1.2
Name: cemu
Version: 0.4
Summary: Cemu is a simple assembly/dissembly/emulation IDE that provides an easy Plug-n-Play environment to start playing with many architectures (currently supports x86-{32,64}, ARM, AARCH64, MIPS, SPARC).
Home-page: https://github.com/hugsy/cemu
Author: hugsy
Author-email: hugsy+github@blah.cat
License: MIT
Download-URL: https://github.com/hugsy/cemu/archive/0.4.tar.gz
Description: CEMU
        ====
        
        |MIT| |IRC| |Python-Version| |PyPi-Version|
        
        
        .. figure:: https://i.imgur.com/7DI6BxR.png
           :alt: cemu-linux
        
           cemu-linux
        
        Description
        -----------
        
        Writing assembly is fun. Assembly is the lowest language (humanly
        understandable) available to communicate with computers, and is crucial
        to understand the internal mechanisms of any machine. Unfortunately,
        setting up an environment to write, compile and run assembly for various
        architectures (x86, ARM, MIPS, SPARC) has always been painful. **CEmu**
        is an attempt to fix this by providing a bundled GUI application that
        empowers users to write assembly and test it by compiling it to bytecode
        and executing it in an QEMU-based emulator.
        
        **CEmu** combines all the advantages of a basic assembly IDE,
        compilation and execution environment, by relying on the great libraries
        `Keystone <https://github.com/keystone-engine/keystone>`__,
        `Unicorn <https://github.com/unicorn-engine/unicorn/>`__ and
        `Capstone <https://github.com/aquynh/capstone>`__ engines in a Qt
        powered GUI.
        
        It allows to test binary samples, check your shellcodes or even simply
        learn how to write assembly code, all of this for the following
        architectures:
        
        -  x86-32 / x86-64
        -  Arm / AArch64
        -  MIPS / MIPS64
        -  SPARC / SPARC64
        -  (more to come)
        
        ``CEmu`` was tested and works on Linux, Windows and MacOSX.
        
        Installation
        ------------
        
        Since version 0.2.2, ``cemu`` is now Python3 only for simplicity (and
        also due to the fact that `Python2 will soon cease to
        exist <https://pythonclock.org/>`__).
        
        If your current installation of ``cemu`` is <= 0.2.1 and on Python2,
        please uninstall it and install it using Python3.
        
        Quick install with PIP
        ~~~~~~~~~~~~~~~~~~~~~~
        
        Last stable from PyPI:
        
        .. code:: bash
        
            pip3 install cemu
        
        Last stable from Github:
        
        .. code:: bash
        
            git clone https://github.com/hugsy/cemu && cd cemu
            pip3 install --upgrade .
        
        For 99% of cases, that's all you need to do. ``cemu`` will be installed
        in your ``${LOCALPATH}/bin`` directory (by default,
        ``/usr/local/bin/cemu`` if installed as root, ``~/.local/bin/cemu`` for
        non-root).
        
        Installation notes
        ~~~~~~~~~~~~~~~~~~
        
        Kali Linux
        ^^^^^^^^^^
        
        If you are using Kali Linux, there is a `known
        problem <https://github.com/keystone-engine/keystone/issues/235>`__ with
        the installation of the ``keystone-engine`` package using PIP. A quick'n
        dirty fix for that would be (as ``root``):
        
        .. code:: bash
        
            $ sudo updatedb
            $ sudo locate libkeystone.so
            $ sudo ln -sf /path/to/libkeystone.so/found/above /usr/local/lib/libkeystone.so
        
        OSX
        ^^^
        
        If you are using OSX, I would highly recommand installing Capstone
        engine directly using ``brew.sh`` command instead of ``pip``, as its
        version seems more up-to-date than the one on PyPI. Doing so, the
        installation should work out of the box:
        
        .. code:: bash
        
            $ brew install capstone
            $ pip3 install -U cemu
        
        Windows
        ^^^^^^^
        
        The fastest way for Windows is to install the packaged binaries for:
        
        -  Keystone (http://www.keystone-engine.org/download/)
        
           -  Including the `Microsoft VC++ runtime
              library <https://www.microsoft.com/en-gb/download/details.aspx?id=40784>`__
        
        -  Capstone (http://www.capstone-engine.org/download/)
        -  Unicorn (http://www.unicorn-engine.org/download/)
        
        Then spawn ``cmd.exe`` and install the missing Python packages using
        ``pip``:
        
        .. code:: bash
        
            # From PyPI
            C:\> pip.exe install -U cemu
            # From Github
            ## Download ZIP and extract it
            C:\> cd path\to\cemu
            C:\path\to\cemu> pip.exe install . -U
        
        ``CEmu`` launcher (``cemu.exe``) will be in the ``C:\Python3\Scripts``
        directory.
        
        Contribution
        ------------
        
        ``cemu`` was created and maintained by myself,
        ```@_hugsy_`` <https://twitter.com/_hugsy_>`__, but kept fresh thanks to
        all the
        `contributors <https://github.com/hugsy/cemu/graphs/contributors>`__.
        
        .. |MIT| image:: https://img.shields.io/packagist/l/doctrine/orm.svg?maxAge=2592000?style=plastic
           :target: https://github.com/hugsy/cemu/blob/master/LICENSE
        .. |IRC| image:: https://img.shields.io/badge/freenode-%23%23cemu-yellowgreen.svg
           :target: https://webchat.freenode.net/?channels=##cemu
        .. |Python-Version| image:: https://img.shields.io/pypi/pyversions/cemu.svg
           :target: https://pypi.python.org/pypi/cemu
        .. |PyPi-Version| image:: https://img.shields.io/pypi/v/cemu.svg
           :target: https://pypi.python.org/pypi/cemu
        
Keywords: assembly,disassembly,emulation,x86,x64,arm,mips,powerpc,sparc
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Assemblers
Classifier: Natural Language :: English
Requires-Python: >=3.4.0
