Rust wrapper for libctru
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Fenrir 0c8a465e93 Add Path and OsString APIs 8 years ago
ctru-sys Use abort() when panicking 9 years ago
src Add Path and OsString APIs 8 years ago
.gitignore Initial commit. 10 years ago
3ds.json More experimental console/stdio stuff. 9 years ago
AUTHORS.md Update AUTHORS.md 9 years ago
Cargo.toml Bump version 9 years ago
README.md Correct paths in README. 9 years ago
build.rs Fix build script. 9 years ago

README.md

ctru-rs

A Rust wrapper library for smealum's ctrulib. Intended for use only when targeting CTR.

How to build

  1. Install the devkitARM toolchain for your system. Make sure DEVKITPRO is set in your environment.
  2. Modify ~/.cargo/config and add the following lines:
    [target.3ds]
    ar = "/path/to/arm-none-eabi-ar"
  1. Build with cargo build --target 3ds.json.
  2. A dkA linkable .rlib (static library) will be generated. Read below for instructions on using.

How to use

You can build your homebrew projects through Cargo just as easily as any other platform. Add this to your Cargo.toml:

    [dependencies.ctru-rs]
    git="https://github.com/rust3ds/ctru-rs"

It is highly recommended to use the template project.

Contributing

PR's are welcome. Organization of rust specific features and wrapper functionality has not been decided on yet.

License

Copyright (C) Ronald Kinard, 2015-2016

As with the original ctrulib, this library is licensed under zlib. This applies to every file in the tree, unless otherwise noted.

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any
damages arising from the use of this software.

Permission is granted to anyone to use this software for any
purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you
   must not claim that you wrote the original software. If you use
   this software in a product, an acknowledgment in the product
   documentation would be appreciated but is not required.
2. Altered source versions must be plainly marked as such, and
   must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any source
   distribution.