From: Alexis Laferrière <alexis.laf@xymus.net>
Date: Sun, 20 Dec 2015 00:46:05 +0000 (-0500)
Subject: lib/app: intro `Asset` and `TextAsset`
X-Git-Tag: v0.8~15^2~7
X-Git-Url: http://nitlanguage.org

lib/app: intro `Asset` and `TextAsset`

Signed-off-by: Alexis Laferrière <alexis.laf@xymus.net>
---

diff --git a/lib/app/app.nit b/lib/app/app.nit
index 79cbb38..587e5a2 100644
--- a/lib/app/app.nit
+++ b/lib/app/app.nit
@@ -21,3 +21,4 @@
 module app
 
 import app_base
+import assets
diff --git a/lib/app/assets.nit b/lib/app/assets.nit
new file mode 100644
index 0000000..8c2dc5c
--- /dev/null
+++ b/lib/app/assets.nit
@@ -0,0 +1,44 @@
+# This file is part of NIT ( http://www.nitlanguage.org ).
+#
+# 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.
+
+# Portable services to load resources from the assets folder
+module assets
+
+# Resource from the assets folder
+#
+# At compilation, the asset folder should be at the root of the package.
+# In practice, this is usually next to the folders `src` and `bin`.
+#
+# These assets are packaged with the application.
+abstract class Asset
+
+	# Path to this asset within the assets folder
+	var path: String
+end
+
+# Text file from the assets folder
+#
+# Use `to_s` to get the content of this asset.
+class TextAsset
+	super Asset
+
+	# Text content of this asset
+	redef var to_s = load is lazy
+
+	# Load this asset
+	fun load: String is abstract
+
+	# Error on the last call to `load`, if any
+	var error: nullable Error = null
+end