Changed name to mcpi_api added some documentation

This commit is contained in:
blackfur 2021-03-28 19:52:48 +02:00
parent 05efd7143c
commit aa35a0b617
4 changed files with 19 additions and 3 deletions

View file

@ -1,5 +1,5 @@
[package] [package]
name = "mcpi" name = "mcpi_api"
version = "0.1.0" version = "0.1.0"
authors = ["blackfur <64478051+theblackfurguy@users.noreply.github.com>"] authors = ["blackfur <64478051+theblackfurguy@users.noreply.github.com>"]
edition = "2018" edition = "2018"

View file

@ -1,3 +1,5 @@
//! # MCPI API
//! `mcpi_api` is a warpper for the Minecraft Pi Edition API handling parsing and other aspects for you.
use std::io::prelude::*; use std::io::prelude::*;
use std::net::TcpStream; use std::net::TcpStream;
use std::io::BufReader; use std::io::BufReader;
@ -11,6 +13,7 @@ mod tests {
} }
} }
///Struct containing functions and a Connection struct.
pub struct Minecraft { pub struct Minecraft {
conn:Connection conn:Connection
} }
@ -19,10 +22,12 @@ struct Connection {
stream:TcpStream stream:TcpStream
} }
///Struct containing functions and a Connection struct.
pub struct Player<'a> { pub struct Player<'a> {
conn:&'a mut Connection conn:&'a mut Connection
} }
///Struct used to specify tile positions.
#[derive(Debug)] #[derive(Debug)]
pub struct TileVec3 { pub struct TileVec3 {
pub x:i32, pub x:i32,
@ -30,6 +35,7 @@ pub struct TileVec3 {
pub z:i32 pub z:i32
} }
///Struct used to specify entity positions.
#[derive(Debug)] #[derive(Debug)]
pub struct Vec3 { pub struct Vec3 {
pub x:f32, pub x:f32,
@ -187,6 +193,16 @@ impl Player<'_> {
} }
} }
///Function to create a Minecraft struct.
/// Takes a IP adress and a port as arguments.
/// # Examples
/// ```
/// use mcpi_api::create;
/// let mut mc = create("localhost:4711");
/// mc.post_to_chat("Hello World!")
/// ```
/// # Panics
/// This function panics if binding to the adress fails.
pub fn create(adress:&str) -> Minecraft { pub fn create(adress:&str) -> Minecraft {
let stream = TcpStream::connect(adress); let stream = TcpStream::connect(adress);
match stream { match stream {

View file

@ -1,4 +1,4 @@
use mcpi::{create, TileVec3}; use mcpi_api::{create, TileVec3};
#[test] #[test]
fn main() { fn main() {

View file

@ -1,4 +1,4 @@
use mcpi::{Vec3, create, TileVec3}; use mcpi_api::{Vec3, create, TileVec3};
#[test] #[test]
fn main() { fn main() {