create skeleton for server from design

server/texture-sync-server/src/main.rs

@@ -0,0 +1,19 @@
+// TODO: remove on implementation
+#![allow(unused_imports)]
+#![allow(unused_variables)]
+#![allow(dead_code)]
+
+extern crate serde_json;
+extern crate serde;
+extern crate image;
+
+pub mod model;
+pub mod persistency;
+pub mod protocol;
+
+mod server_state;
+use server_state::*;
+
+fn main() {
+    println!("Hello, world!");
+}

server/texture-sync-server/src/model/mod.rs

@@ -0,0 +1,20 @@
+// TODO: remove on implementation
+#![allow(unused_imports)]
+#![allow(unused_variables)]
+#![allow(dead_code)]
+
+pub struct Sha256(pub [u8; 64]);
+
+pub struct Texture {
+    pub id: String,
+    pub name: String,
+    pub tags: Vec<String>,
+    pub format: TextureFormat,
+    pub resolution: (usize, usize),
+    pub texture_hash: Sha256,
+}
+
+pub enum TextureFormat {
+    PNG,
+    JPEG,
+}

server/texture-sync-server/src/persistency/image_convert/mod.rs

@@ -0,0 +1,19 @@
+// TODO: remove on implementation
+#![allow(unused_imports)]
+#![allow(unused_variables)]
+#![allow(dead_code)]
+
+
+use crate::model::*;
+
+pub struct ConvertConfig {
+    pub desired_size: (usize, usize),
+}
+
+pub fn generate_preview(
+    input: &[u8],
+    format: TextureFormat,
+    config: &ConvertConfig,
+) -> ::image::ImageResult<Vec<u8>> {
+    unimplemented!()
+}

server/texture-sync-server/src/persistency/mod.rs

@@ -0,0 +1,75 @@
+// TODO: remove on implementation
+#![allow(unused_imports)]
+#![allow(unused_variables)]
+#![allow(dead_code)]
+
+use crate::model::*;
+
+use std::collections::HashMap;
+use std::io;
+use std::path::{Path, PathBuf};
+use std::sync::Arc;
+
+pub use self::search::Query;
+mod search;
+mod image_convert;
+
+pub type TextureFileResult = Result< Arc<Vec<u8>> , TextureFileError>;
+pub enum TextureFileError {
+    NotFound,
+    IoError(io::Error),
+    ImageError(::image::ImageError),
+}
+
+pub struct DataStore {
+    // private attributes
+    // may change
+    data_dir: PathBuf,
+    texture: Vec<Texture>,
+    preview_cache: HashMap<(TextureFormat, Sha256), Arc<Vec<u8>>>,
+}
+
+impl DataStore {
+    pub fn new(path: &Path) -> io::Result<DataStore> {
+        unimplemented!()
+    }
+
+    pub fn garbage_collect(&mut self) -> io::Result<()> {
+        unimplemented!()
+    }
+
+    pub fn query(&mut self, query: &self::search::Query) -> Vec<Texture> {
+        unimplemented!();
+        // calls self::search::search(... )
+    }
+
+    /// returns true if successful
+    pub fn delete(&mut self, tex: &Texture) -> bool {
+        unimplemented!();
+    }
+
+    pub fn insert(&mut self, tex: Texture) -> bool {
+        unimplemented!();
+    }
+
+    pub fn by_name<'a>(&'a self, name: &str) -> Option<&'a Texture> {
+        unimplemented!();
+    }
+
+    pub fn by_id<'a, 'b>(&'a self, id: &'b str) -> Option<&'a Texture> {
+        unimplemented!();
+    }
+
+    pub fn has_hash(&self, hash: &Sha256) -> bool {
+        unimplemented!();
+    }
+
+    pub fn get_texture_file(&mut self, hash: &Sha256) -> TextureFileResult {
+        unimplemented!();
+    }
+
+    pub fn get_texture_preview(&mut self, hash: &Sha256) -> TextureFileResult {
+        unimplemented!();
+    }
+}
+

server/texture-sync-server/src/persistency/search/mod.rs

@@ -0,0 +1,38 @@
+// TODO: remove on implementation
+#![allow(unused_imports)]
+#![allow(unused_variables)]
+#![allow(dead_code)]
+
+
+use crate::model::*;
+
+pub struct Query {
+    filters: Vec<QueryFilterModifier>,
+}
+
+pub type QueryParserResult = Result<Query, QuerySyntaxError>;
+pub enum QuerySyntaxError {
+    UnknownFilter,
+}
+
+impl Query {
+    pub fn parse(input: &[String]) -> QueryParserResult {
+        unimplemented!()
+    }
+}
+
+pub fn search(input: &[Texture], query: &Query) -> Vec<Texture> {
+    unimplemented!()
+}
+
+enum QueryFilterModifier {
+    None(QueryFilter),
+    Not(QueryFilter),
+}
+
+enum QueryFilter {
+    TagName(String),
+    InName(String),
+    MinResolution(usize),
+    BeforeDate { year: u16, month: u16, day: u16 },
+}

server/texture-sync-server/src/protocol/mod.rs

@@ -0,0 +1,52 @@
+// TODO: remove on implementation
+#![allow(unused_imports)]
+#![allow(unused_variables)]
+#![allow(dead_code)]
+
+use crate::model::*;
+
+use std::sync::Arc;
+use std::io;
+
+pub enum ReplaceTextureStatus {
+    // Call Again With Texture Binary
+    NeedTextureData,
+    // Done.
+    Ok,
+}
+
+pub type ProtocolResult<T> = Result<T, ProtocolError>;
+pub enum ProtocolError {
+    BadRequest(String),
+    FileNotFound(String),
+    Conflict(String),
+    InternalServerError(std::io::Error),
+    NotImplemented,
+}
+
+pub trait ProtocolHandler: Send + Sync {
+    fn query(&mut self, query: &[String]) -> ProtocolResult<Vec<Texture>>;
+
+    fn get_texture_by_id(&mut self, id: String) -> ProtocolResult<Option<Texture>>;
+
+    fn get_texture_by_name(&mut self, id: String) -> ProtocolResult<Option<Texture>>;
+
+    fn get_texture_file(&mut self, hash: Sha256) -> ProtocolResult<Arc<Vec<u8>>>;
+
+    fn get_texture_preview(&mut self, hash: Sha256) -> ProtocolResult<Arc<Vec<u8>>>;
+
+    fn replace_texture(
+        &mut self,
+        delete: Option<Texture>,
+        insert: Option<Texture>,
+        insert_texture_data: Option<Vec<u8>>,
+    ) -> ProtocolResult<ReplaceTextureStatus>;
+}
+
+pub struct ProtocolConfig {
+    pub port: u16,
+}
+
+pub fn listen_forever(handler: &ProtocolHandler) -> io::Result<()> {
+    unimplemented!()
+}

server/texture-sync-server/src/server_state.rs

@@ -0,0 +1,44 @@
+// TODO: remove on implementation
+#![allow(unused_imports)]
+#![allow(unused_variables)]
+#![allow(dead_code)]
+
+use crate::model::*;
+use crate::protocol::*;
+
+use std::sync::Arc;
+
+pub struct ServerState {
+    // ...
+}
+
+impl ProtocolHandler for ServerState {
+    fn query(&mut self, query: &[String]) -> ProtocolResult<Vec<Texture>> {
+        unimplemented!()
+    }
+
+    fn get_texture_by_id(&mut self, id: String) -> ProtocolResult<Option<Texture>> {
+        unimplemented!()
+    }
+
+    fn get_texture_by_name(&mut self, id: String) -> ProtocolResult<Option<Texture>> {
+        unimplemented!()
+    }
+
+    fn get_texture_file(&mut self, hash: Sha256) -> ProtocolResult<Arc<Vec<u8>>> {
+        unimplemented!()
+    }
+
+    fn get_texture_preview(&mut self, hash: Sha256) -> ProtocolResult<Arc<Vec<u8>>> {
+        unimplemented!()
+    }
+
+    fn replace_texture(
+        &mut self,
+        delete: Option<Texture>,
+        insert: Option<Texture>,
+        insert_texture_data: Option<Vec<u8>>,
+    ) -> ProtocolResult<ReplaceTextureStatus> {
+        unimplemented!()
+    }
+}