https://github.com/perrutquist/codetransformation.jl

Turn CodeInfo objects into functions in Julia
https://github.com/perrutquist/codetransformation.jl

julialang

Last synced: 3 months ago
JSON representation

Turn CodeInfo objects into functions in Julia

• Host: GitHub
• URL: https://github.com/perrutquist/codetransformation.jl
• Owner: perrutquist
• License: mit
• Created: 2019-07-19T07:50:13.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-09-19T10:38:19.000Z (over 2 years ago)
• Last Synced: 2024-10-12T19:21:52.592Z (3 months ago)
• Topics: julialang
• Language: Julia
• Size: 10.7 KB
• Stars: 9
• Watchers: 1
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CodeTransformation

[![Build Status](https://travis-ci.com/perrutquist/CodeTransformation.jl.svg?branch=master)](https://travis-ci.com/perrutquist/CodeTransformation.jl)

[![Build Status](https://ci.appveyor.com/api/projects/status/github/perrutquist/CodeTransformation.jl?svg=true)](https://ci.appveyor.com/project/perrutquist/CodeTransformation-jl)

[![Codecov](https://codecov.io/gh/perrutquist/CodeTransformation.jl/branch/master/graph/badge.svg)](https://codecov.io/gh/perrutquist/CodeTransformation.jl)

Note: This package is currently not under active development. You might want to have a look at [IRTools](https://github.com/MikeInnes/IRTools.jl) instead.

This is an experimental package for working with the [`CodeInfo`](https://pkg.julialang.org/docs/julia/THl1k/1.1.1/devdocs/ast.html#CodeInfo-1)

objects that are containded in the vectors that Julia's `code_lowered` and `code_typed` functions return.

These objects can be modified and then turned back into functions (technically methods),

making it possible to apply code transformations to functions defined in other packages,

or in Julia itself.

## Examples

Copy a method from one function to another via a `CodeInfo` object.

```julia

using CodeTransformation

g(x) = x + 13

ci = code_lowered(g)[1] # get the CodeInfo from g's first (and only) method

function f end # create an empty function that we can add a method to

addmethod!(Tuple{typeof(f), Any}, ci)

f(1) # returns 14

```

Search-and-replace in the function `g` from the previous example. (Applies to all

methods, but `g` only has one.)

```julia

function e end

codetransform!(g => e) do ci

    for ex in ci.code

        if ex isa Expr

            map!(x -> x === 13 ? 7 : x, ex.args, ex.args)

        end

    end

    ci

end

e(1) # returns 8

g(1) # still returns 14

```

Note: The syntax may change in the next minor release of this package.