build: import basic implementation

Import build-system related files as well as the basic str16
implementation. This is still largely based on the code from Tom, but
changed to stay more closely to what CStr/CString does in libstd.

Signed-off-by: David Rheinsberg <david.rheinsberg@gmail.com>

Author: dvdhrm

.travis.yml

@@ -0,0 +1,13 @@
+os: linux
+dist: xenial
+sudo: false
+language: rust
+cache: cargo
+
+rust:
+ - stable
+ - nightly
+
+script:
+ - cargo build --verbose --all-targets
+ - cargo test --verbose

AUTHORS

@@ -0,0 +1,37 @@
+LICENSE:
+        This project is dual-licensed under both the Apache License, Version
+        2.0, and the GNU Lesser General Public License, Version 2.1+.
+
+AUTHORS-ASL:
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+
+                http://www.apache.org/licenses/LICENSE-2.0
+
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+
+AUTHORS-LGPL:
+        This program is free software; you can redistribute it and/or modify it
+        under the terms of the GNU Lesser General Public License as published
+        by the Free Software Foundation; either version 2.1 of the License, or
+        (at your option) any later version.
+
+        This program is distributed in the hope that it will be useful, but
+        WITHOUT ANY WARRANTY; without even the implied warranty of
+        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+        Lesser General Public License for more details.
+
+        You should have received a copy of the GNU Lesser General Public License
+        along with this program; If not, see <http://www.gnu.org/licenses/>.
+
+COPYRIGHT: (ordered alphabetically)
+        Copyright (C) 2018-2019 Red Hat, Inc.
+
+AUTHORS: (ordered alphabetically)
+        David Rheinsberg <david.rheinsberg@gmail.com>
+        Tom Gundersen <teg@jklm.no>

Cargo.toml

@@ -0,0 +1,27 @@
+[package]
+name = "r-efi-string"
+version = "0.1.0"
+
+authors = [
+        "David Rheinsberg <david.rheinsberg@gmail.com>",
+        "Tom Gundersen <teg@jklm.no>",
+]
+categories = [
+        "embedded",
+        "hardware-support",
+        "no-std",
+        "os",
+]
+description = "UEFI String Types and Converters"
+edition = "2018"
+homepage = "https://r-util.github.com/r-efi"
+keywords = [
+        "efi",
+        "firmware",
+        "string",
+        "uefi",
+        "unicode",
+]
+license = "Apache-2.0 OR LGPL-2.1-or-later"
+readme = "README.md"
+repository = "https://github.com/r-util/r-efi-string"

README.md

@@ -0,0 +1,41 @@
+r-efi-string
+============
+
+UEFI String Types and Converters
+
+The r-efi-string project implements string types according to the Unicode
+strings described in the UEFI specification, as well as converters to/from
+common rust types. The UEFI specification defines several different string
+types. The most common one is UCS-2 based, but neither follows a strict UCS-2
+nor UTF-16 standard. Furthermore, it defines a UTF-8 based string as well as an
+ISO-8859-1 based string.
+
+### Project
+
+ * **Website**: <https://r-util.github.io/r-efi>
+ * **Bug Tracker**: <https://github.com/r-util/r-efi-string/issues>
+
+### Requirements
+
+The requirements for this project are:
+
+ * `rustc >= 1.31.0`
+
+### Build
+
+To build this project, run:
+
+```sh
+cargo build
+```
+
+### Repository:
+
+ - **web**:   <https://github.com/r-util/r-efi-string>
+ - **https**: `https://github.com/r-util/r-efi-string.git`
+ - **ssh**:   `git@github.com:r-util/r-efi-string.git`
+
+### License:
+
+ - **Apache-2.0** OR **LGPL-2.1-or-later**
+ - See AUTHORS file for details.

src/lib.rs

@@ -0,0 +1,26 @@
+//! UEFI String Types and Converters
+//!
+//! This projects implements string types for the different string encodings used on UEFI systems.
+//! While the types are rather specific to UEFI, this project does **not** depend on any UEFI
+//! headers or protocols, but is a stand-alone implementation.
+//!
+//! See the different modules for the types provided:
+//!
+//!  * `[str16]`: UCS-2 based strings, which use a `u16` based encoding.
+
+// We currently need some unstable features:
+//
+//  * We import `liballoc` since we want to explicitly allow running in no-std environments with
+//    custom allocators.
+//
+//  * We use `doc_cfg` to run conditional code in rustdoc compilations. This is, again, related to
+//    `no_std`, since we want to make sure the rustdoc examples still work correctly.
+#![feature(alloc, doc_cfg)]
+
+// We do not depend on `libstd`, but pull it in for our unit tests and documentation.
+#![cfg_attr(not(any(test, rustdoc)), no_std)]
+
+// We provide converters to/from `alloc::string::String`, so import `liballoc`.
+extern crate alloc;
+
+pub mod str16;