This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Sealang is an improved set of Python bindings for libclang.

The upstream maintainers of libclang have not been especially responsive to patches that address issues like Python 3 compatibility, and the significant omissions in the API (such as extracting literals and operators).

This package is a fork of the official Python bindings for libclang, patched to correct these problems.

Installation

To compile Sealang, you’ll need to:

  1. Install LLVM (with clang)
  2. Set some environment variables
  3. Install Sealang

The exact commands needed will vary between platforms.

OS X

Although OS X provides Clang, it doesn’t provide all the development headers, so you’ll need to . Homebrew is the easiest way to do this. Follow the installation instructions on the Homebrew homepage; once you’ve got Homebrew installed, you can run:

$ brew install llvm --with-clang --with-asan

to get a working install of llvm with clang.

Then, you’ll need to set the following environment variables:

$ export LLVM_HOME=/usr/local/opt/llvm
$ export DYLD_LIBRARY_PATH=$LLVM_HOME/lib

Lastly, you can install Sealang:

$ pip install sealang

Ubuntu 14.04 (Trusty)

To compile under Ubuntu 14.04 (Trusty), you’ll need to get an updated version of LLVM:

$ sudo apt-get install libclang-3.6 clang-3.6 -y

Then, you’ll need to set the following environment variables:

$ export LLVM_HOME=/usr/lib/llvm-3.6
$ export LD_LIBRARY_PATH=$LLVM_HOME/lib

Lastly, you can install Sealang:

$ pip install sealang

Other platforms

The instructions for installing on other platforms should be analogous. If you develop build instructions for a platform, please submit a pull request.

Usage

Sealang provides a superset of the functionality provided by libclang. Those features are:

  • Cursor objects have 4 additional attributes:
    • literal - the value of a literal expression. Available on IntegerLiteral, FloatingLiteral, StringLiteral, CharacterLiteral, and CXXBooleanLiteral nodes.
    • operator - the printable version of an operator. Only available on BinaryOperator, UnaryOperator, and CompoundAssignOperator cursor nodes.
    • binary_operator - an enumeration value describing a BinaryOperator or CompoundAssignOperator node.
    • unary_operator - an enumeration value describing a UnaryOperator node.
  • BinaryOperator - An enumeration for the types of binary operators:
    • BinaryOperator.INVALID
    • BinaryOperator.PTRMEMD
    • BinaryOperator.PTRMEMI
    • BinaryOperator.MUL
    • BinaryOperator.DIV
    • BinaryOperator.REM
    • BinaryOperator.ADD
    • BinaryOperator.SUB
    • BinaryOperator.SHL
    • BinaryOperator.SHR
    • BinaryOperator.LT
    • BinaryOperator.GT
    • BinaryOperator.LE
    • BinaryOperator.GE
    • BinaryOperator.EQ
    • BinaryOperator.NE
    • BinaryOperator.AND
    • BinaryOperator.XOR
    • BinaryOperator.OR
    • BinaryOperator.LAND
    • BinaryOperator.LOR
    • BinaryOperator.ASSIGN
    • BinaryOperator.MULASSIGN
    • BinaryOperator.DIVASSIGN
    • BinaryOperator.REMASSIGN
    • BinaryOperator.ADDASSIGN
    • BinaryOperator.SUBASSIGN
    • BinaryOperator.SHLASSIGN
    • BinaryOperator.SHRASSIGN
    • BinaryOperator.ANDASSIGN
    • BinaryOperator.XORASSIGN
    • BinaryOperator.ORASSIGN
    • BinaryOperator.COMMA
    • BinaryOperator.UNKNOWN
  • UnaryOperator - An enumeration for the types of binary operators:
    • UnaryOperator.INVALID
    • UnaryOperator.POSTINC
    • UnaryOperator.POSTDEC
    • UnaryOperator.PREINC
    • UnaryOperator.PREDEC
    • UnaryOperator.ADDROF
    • UnaryOperator.DEREF
    • UnaryOperator.PLUS
    • UnaryOperator.MINUS
    • UnaryOperator.NOT
    • UnaryOperator.LNOT
    • UnaryOperator.REAL
    • UnaryOperator.IMAG
    • UnaryOperator.EXTENSION
    • UnaryOperator.UNKNOWN

How it works

Sealang is a bit of a nasty hack. libclang is a set of C bindings to a C++ API; Python ctypes are then used to wrap the C API. However, while the C++ API is quite rich, libclang is less so.

Sealang bridges this gap by providing C wrappers around the C++ calls that provide the useful functionality. This library of C functions is wrapped up as a Python C module for delivery purposes - this C module contains no exposed Python objects or methods, but because it’s a module, the underlying compiled sealang.so file is easy to find. ctypes are then used to expose the sealang wrapper functions;

Internally, Sealang reproduces some minor pieces of the libclang API; these are methods (such as the string creation and manipulation methods) that aren’t exposed as symbols for third-party use.

All this functionality is potentially a candidate to be passed upstream to libclang.

Relationship to Clang

This project aims to mirror what is currently available in the Python bindings to libclang. The version number for this project is drawn from the version and SVN revision of the official clang repository.

Any changes made upstream to libclang will be mirrored here; any changes made here will, where possible, be pushed upstream to libclang.

Community

Sealang is part of the BeeWare suite. You can talk to the community through:

Contributing

If you experience problems with Sealang, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.

Release History

Release History

3.9.dev259750

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

3.9.dev259721

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

3.9.dev258341

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
sealang-3.9.dev259750-cp27-none-macosx_10_9_x86_64.whl (1.3 MB) Copy SHA256 Checksum SHA256 cp27 Wheel Feb 4, 2016
sealang-3.9.dev259750-cp34-cp34m-macosx_10_9_x86_64.whl (1.3 MB) Copy SHA256 Checksum SHA256 cp34 Wheel Feb 4, 2016
sealang-3.9.dev259750.tar.gz (49.2 kB) Copy SHA256 Checksum SHA256 Source Feb 4, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting