Initial commit message

Author: walterhpearce

.gitignore

@@ -0,0 +1,28 @@
+graph-imports/data/*
+graph-imports/bc/*
+graph-imports/*.csv
+graph-imports/*.sql
+graph-imports/*.report
+simple_test/target
+.idea
+docker/db/*
+docker/db/logs/*
+docker/db/data/*
+docker/db/plugins/*
+
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+scratch

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "llvm-ir-analysis"]
+	path = llvm-ir-analysis
+	url = https://github.com/walterhpearce/llvm-ir-analysis
+[submodule "llvm-ir"]
+	path = llvm-ir
+	url = https://github.com/walterhpearce/llvm-ir

BUILDING.md

@@ -0,0 +1,51 @@
+# Requirements
+
+- Rust nightly (2013-07-26)
+- Rust 1.60 toolchain 
+- LLVM 14.x
+- Docker 
+
+# Installing Rust toolchains
+Note that we require using nightly for some features, *as well as* having rustc 1.60 installed for analysis. This means 
+you'll need to install two rust toolchains.
+
+```
+rustup toolchain install nightly
+rustup toolchain install 1.60
+```
+
+# Building and using LLVM
+
+Different environments will run into issues with the local version of llvm. Using painter requires llvm 14.x to be installed
+for the current version of `rustc` we operate with (1.60). If painter does not work with your OS version of LLVM,
+you may need to build a local vendored copy of LLVM to use. 
+
+Assumed Example Build Directory Layout
+```
+    /tmp/llvm14-src
+    /tmp/llvm14-bin
+    /tmp/llvm14-build
+```
+
+*Building and Installing LLVM*
+```
+cd /tmp
+git clone --depth=1 -b release/14.x https://github.com/llvm/llvm-project.git llvm14-src
+mkdir llvm14-build && mkdir llvm14-bin
+pushd llvm14-build
+  cmake ../llvm14-src/llvm
+  cmake --build .
+  cmake -DCMAKE_INSTALL_PREFIX=../llvm14-bin -P cmake_install.cmake
+popd
+```
+
+## Build Painter
+
+Once you have a local built copy of LLVM, you'll need to specify the location of the installation via 
+the `LLVM_SYS_140_PREFIX` environment variable.
+
+```
+git clone --recurse-submodules https://github.com/rustfoundation/painter
+cd painter
+LLVM_SYS_140_PREFIX=/tmp/llvm14-bin cargo build
+```

CODE_OF_CONDUCT.md

@@ -0,0 +1,8 @@
+# [Code of Conduct](code-of-conduct)
+
+The Rust Foundation has adopted a Code of Conduct that we expect project 
+participants to adhere to. Please read 
+[the full text][code-of-conduct] 
+so that you can understand what actions will and will not be tolerated.
+
+[code-of-conduct]: https://foundation.rust-lang.org/policies/code-of-conduct/

CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing to a Rust Foundation Project
+
+Thank you for your interest in contributing to this Rust Foundation project. 
+We are happy and excited to review and accept your pull requests.
+
+## Before You Begin Contributing
+
+### Licenses
+
+There is no Contributor License Agreement to sign to contribute this project. 
+Your contribution will be covered by the license(s) granted for this 
+repository, commonly MIT, Apache, and/or CC-BY, but could be a different 
+license. In other words, your contribution will be licensed to the Foundation 
+and all downstream users under those licenses. You can read more in the 
+Foundation's [intellectual property policy][ip-policy].
+
+### Code of Conduct
+
+Please review and adhere to the [code of conduct](CODE_OF_CONDUCT.md) before 
+contributing any pull requests.
+
+## Contribution Process
+
+All submissions, including submissions by project members, require review. We
+use GitHub pull requests for this purpose. Consult [GitHub Help][pull-requests] 
+for more information on using pull requests.
+
+### Issues
+
+Do you just want to file an issue for the project? Please do so in GitHub under 
+the `Issues` tab.
+
+[ip-policy]: https://foundation.rust-lang.org/policies/intellectual-property-policy/
+[pull-requests]: https://help.github.com/articles/about-pull-requests/

COPYRIGHT

@@ -0,0 +1,14 @@
+This project is dual licensed under Apache 2.0 and MIT terms with the exception 
+of documentation (e.g., `.md` docs in a `/docs` folder) which is licensed under 
+Creative Commons Attribution 4.0 International.
+
+Copyrights in a Rust Foundation project are retained by their contributors. No 
+copyright assignment is required to contribute to the Rust project.
+
+While not the default, some files may include explicit copyright notices 
+and/or license notices.
+
+Except as otherwise noted (e.g., with documentation), Rust is licensed under the 
+Apache License, Version 2.0 <LICENSE-APACHE> or 
+<http://www.apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT> or 
+<http://opensource.org/licenses/MIT>, at your option.