Project

to_source

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Transform Rubinius 1.9 AST back to equivalent source code
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 0.0.7
~> 0.0.5
 Project Readme

Warning:

This gem is defacto unmaintained. It was superseeded by unparser.

to_source

Build Status Dependency Status Code Climate

Reverse parser to generate source code from the Rubinius AST. Also works well under MRI using the mutant-melbourne gem. Currently only support for 1.9 mode!

To source is the backend of mutant it is used to create the (mutated) source that is evaled into the vm. Also for creating the diffs.

It should be able to create equivalent, but not identical, source. The current focus is to create correct but not beautiful source. Once correctnes is at 100% I'll focus on beautifullnes, so pls do not complain about excess of parantheses now ;).

Installation

Install the gem to_source via your preferred method.

Examples

require 'to_source'
some_code = "a = 123"
ast = some_code.to_ast
# => #<Rubinius::AST::LocalVariableAssignment:0x21b8
#       @value=#<Rubinius::AST::FixnumLiteral:0x21bc @value=123 @line=1>
#       @variable=nil @line=1 @name=:a>
ast.to_source
# => "a = 123"

Credits

Contributing

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with Rakefile or version (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

License

See LICENSE