Git Product home page Git Product logo

visualrust's Introduction

Visual Studio extension for Rust

[Build status] (https://ci.appveyor.com/project/vosen/visualrust)

Screenshot

Currently in development, and not feature complete. Stable versions are available on the Visual Studio extension gallery.

Unstable, but more recent builds are downloadable from [AppVeyor] (https://ci.appveyor.com/project/vosen/visualrust) (choose "Configuration: Release" and "Artifacts").

Debugging

Starting with Visual Studio 2015, the IDE is capable of using GDB as a debugging backend.
Visual Rust now supports this feature!

Pre-requisites

  • You will need to install GDB for Windows from one of the MinGW-w64 distributions (original MinGW won't work).
  • When installing Visual Studio 2015, be sure to put check mark next to 'Tools for Visual C++ Mobile Development' component. This will install the GDB front-end package.

Configuration

If GDB installation directory is on your PATH, no further configuration should be required. Otherwise, open Tools/Options... dialog in the IDE, navigate to Visual Rust/Debugging and enter the full path to gdb.exe there.

Usage

Most of the usual VS debugger features are supported.
You can also issue GDB-specific commands in the VS Command Window: Debug.GDBExec <command>. For convenience, Debug.GDBExec has been aliased to gdb.

Known issues

  • The 64-bit GDB fails to start 32-bit executables. This appears to be a GDB problem. Meanwhile, you can use the 32-bt version of GDB for 32-bit debugging.

Contributing

How to contribute?

Issues

Feel free to open issues, post comments about progress, questions, new ideas, brain storming etc. You can remove and edit comments as a way of refining ideas in the issue tracker. This is very helpful because many concerns in this project are very complex. Many issues needs to be broken down into new issues before they can be implemented.

Issues marked Ready represent tasks that have a clear design and deliverables. They are recommended starting points if you don't want to spend time discussing and evaluating implementation.

Issues marked Information require some wider perspective and discussion. They are perfect if you want to have an impact on the project but don't have the time to spend coding.

Code

  1. Fork the main repository
  2. Work on a feature in your own private branch
  3. Once you are finished with you work or want someone to you, open a pull request
  4. Someone will review your code and merge it. Some fixes might be required on your side.

Prerequisites

To build this, you'll need the Visual Studio SDK for the VS plugin, WiX Toolset 3.9 for the setup project and [Java RE] (https://www.java.com/en/download/manual.jsp). Nuget will take care of the rest.

Build configuration

If you plan to hask on Visual Rust you should understand difference between our two build configurations.

  • For the Release configuration the main project is VisualRust.Setup, its output is a .msi file that consists of two parts:

    • MSBuild integration: this lets you build Rust projects (.rsproj) from the command line and Visual Studio.
    • Visual Studio plugin(s): this adds support for Rust projects (.rsproj) inside Visual Studio. Syntax highlighting, project system, item templates. Everything except building.
  • For the Debug build main project is called simply VisualRust and it builds VisualRust.vsix which is a VS plugin in a format that is suitable for local installation and debugging. It doesn't contain MSBuild integration

Consequently, for the debug build you'll want to either install just MSBuild integration from the .msi file or build it yourself (VisualRust.Build) and copy to %ProgramFiles(x86)%\MSBuild\VisualRust.

Also you'll want to modify VisualRust project with location of your Visual Studio installation to [launch it automatically when debugging] (http://stackoverflow.com/a/9281921).

Contact

This project is currently maintained by vosen.

Feel free to mail him or ask around in #rust-gamedev on irc.mozilla.org.

License

Same as Rust, dual MIT/ASL2. Any contributions made are under this license.

visualrust's People

Contributors

andersforsgren avatar boddlnagg avatar bvssvni avatar emberian avatar leonkunert avatar vadimcn avatar vosen avatar waffle-iron avatar xilec avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.