demake 0.1.2 → 0.2.1

data/lib/apps/oreo/Makefile

@@ -0,0 +1,260 @@
+#
+# Makefile automatically generated by Ruby Gem - demake 0.2.0
+#
+MAKE += -j 8
+CC = gcc
+OS := $(shell uname)
+PROCESSOR := $(shell uname -p)
+MACHINE := $(shell uname -m)
+STRIP := strip
+STRIP_ARGS := --strip-unneeded
+PREFIX = /usr/local/bin/
+LIBRARY_PREFIX = /usr/local/lib/
+FLAGS = -ansi -pedantic -D_POSIX_C_SOURCE=200809L
+ifeq '$(MACHINE)' 'riscv64'
+  FLAGS += 
+endif
+DEBUG_FLAGS = -DOREO_DEBUG -g -Wall -Wextra -Wunused-variable -Wundef -Wconversion -Wshadow -Wcast-qual -Wwrite-strings
+OFLAGS = -O2
+CFLAGS =  $(FLAGS)
+LDFLAGS = 
+LIB_CFLAGS =  $(FLAGS)
+LIB_LDFLAGS = 
+BUILD_FLAGS = $(CFLAGS)
+LIBS = 
+LDLIBS = $(LIBS) 
+LIB_LDLIBS = $(LIBS) 
+BINARY = bin
+LIBRARY = lib
+SOURCE = src
+OBJECT = obj
+#
+# oreo - File List (FL1)
+#
+FL1 = oreo.o
+#
+# oreo - Object List (OL1)
+#
+OL1 = $(patsubst %.o, $(OBJECT)/%.o, $(FL1))
+#
+# oreo_debug - Debug File List (DFL1)
+#
+DFL1 = oreo_debug.o
+#
+# oreo_debug - Debug Object List (DOL1)
+#
+DOL1 = $(patsubst %.o, $(OBJECT)/%.o, $(DFL1))
+
+RUBY := $(shell command -v ruby 2> /dev/null)
+
+define LICENSE
+
+┌────────────────────────────────────────────────────────────────────────────────┐
+│ MIT License                                                                    │
+│                                                                                │
+│ Permission is hereby granted, free of charge, to any person obtaining a copy   │
+│ of this software and associated documentation files (the "Software"), to deal  │
+│ in the Software without restriction, including without limitation the rights   │
+│ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell      │
+│ copies of the Software, and to permit persons to whom the Software is          │
+│ furnished to do so, subject to the following conditions:                       │
+│                                                                                │
+│ The above copyright notice and this permission notice shall be included in all │
+│ copies or substantial portions of the Software.                                │
+│                                                                                │
+│ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR     │
+│ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,       │
+│ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE    │
+│ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER         │
+│ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,  │
+│ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE  │
+│ SOFTWARE.                                                                      │
+└────────────────────────────────────────────────────────────────────────────────┘
+
+endef
+export LICENSE
+define LICENSE_FILE
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+endef
+export LICENSE_FILE
+
+.PHONY : menu
+menu : LICENSE
+	@echo "╔═════════════════════════════════════════════════════════════════════════╗"
+	@echo "║                                                                         ║"
+	@echo "║                           Make targets:                                 ║"
+	@echo "║                                                                         ║"
+	@echo "║                             🚧  build                                   ║"
+	@echo "║                             📜  license                                 ║"
+	@echo "║                             🔥  clean                                   ║"
+	@echo "║                             🐛  debug                                   ║"
+	@echo "║                             🔩  install                                 ║"
+	@echo "║                             🔧  uninstall                               ║"
+	@echo "║                             ❓  test                                    ║"
+	@echo "║                                                                         ║"
+	@echo "╠═════════════════════════════════════════════════════════════════════════╣"
+	@echo "║           Build Executable: bin/oreo                                    ║"
+	@echo "╠═════════════════════════════════════════════════════════════════════════╣"
+	@echo "║           Debug Executable: bin/oreo_debug                              ║"
+	@echo "╠═════════════════════════════════════════════════════════════════════════╣"
+	@echo "║   Install Binary Directory: /usr/local/bin/                             ║"
+	@echo "║  Install Library Directory: /usr/local/lib/                             ║"
+	@echo "╚═════════════════════════════════════════════════════════════════════════╝"
+.PHONY : all
+all : LICENSE build debug
+
+
+.PHONY : license
+license:
+	@echo "$$LICENSE_FILE" > LICENSE
+	@echo "$$LICENSE" | less -F -R -X -e
+
+LICENSE:
+	@echo "$$LICENSE_FILE" > LICENSE
+	@echo "$$LICENSE" | less -R -X -e
+
+.PHONY : build
+build : LICENSE
+	@echo "╔═════════════════════════════════════════════════════════════════════════╗"
+	@echo "║ 🚧  Building executable: bin/oreo                                       ║"
+	@echo "╚═════════════════════════════════════════════════════════════════════════╝"
+	@$(MAKE) $(BINARY)/oreo
+	@if command -v $(STRIP) >/dev/null 2>&1 ; then 	  echo "Stripping $(BINARY)/oreo"; 	  $(STRIP) $(STRIP_ARGS) $(BINARY)/oreo || echo "Warning: strip failed for $(BINARY)/oreo"; 	else 	  echo "strip not found; skipping strip step"; 	fi
+
+.PHONY : library
+library : LICENSE
+
+# Dependencies
+$(OBJECT)/oreo.o : $(SOURCE)/oreo.c	\
+	$(SOURCE)/defines.h	\
+	$(SOURCE)/typedefs.h	\
+	$(SOURCE)/fast_read_file.h
+	@echo "║ 🛠  Compiling... $(OBJECT)/oreo.o"
+ifeq '$(OS)' 'Windows_NT'
+	@test -d $(OBJECT)/ || mkdir $(OBJECT)/
+else
+	@mkdir -p $(OBJECT)/
+endif
+	$(CC) $(BUILD_FLAGS) $(LIBS) -c $(SOURCE)/oreo.c -o $(OBJECT)/oreo.o
+# Dependencies for debug
+# $(OBJECT)/oreo_debug.o : BUILD_FLAGS := $(DEBUG_FLAGS) $(CFLAGS)
+#
+$(OBJECT)/oreo_debug.o : $(SOURCE)/oreo.c	\
+	$(SOURCE)/defines.h	\
+	$(SOURCE)/typedefs.h	\
+	$(SOURCE)/fast_read_file.h
+	@echo "║ 🐛  🛠  Compiling... $(OBJECT)/oreo_debug.o"
+ifeq '$(OS)' 'Windows_NT'
+	@test -d $(OBJECT)/ || mkdir $(OBJECT)/
+else
+	@mkdir -p $(OBJECT)/
+endif
+	$(CC) $(BUILD_FLAGS) $(LIBS) -c $(SOURCE)/oreo.c -o $(OBJECT)/oreo_debug.o
+
+$(BINARY)/oreo : BUILD_FLAGS := $(OFLAGS) $(CFLAGS) $(LDFLAGS)
+
+$(BINARY)/oreo : $(OL1)
+	@echo "╔═════════════════════════════════════════════════════════════════════════╗"
+	@echo "║ 🔗  Linking Files... bin/oreo                                           ║"
+	@echo "╚═════════════════════════════════════════════════════════════════════════╝"
+ifeq '$(OS)' 'Windows_NT'
+	@test -d $(BINARY) || mkdir $(BINARY)
+else
+	@mkdir -p $(BINARY)
+endif
+	$(CC) $(BUILD_FLAGS) $(OL1) $(LDLIBS) -o $(BINARY)/oreo
+
+$(BINARY)/oreo_debug : BUILD_FLAGS := $(DEBUG_FLAGS) $(CFLAGS) $(LDFLAGS)
+
+$(BINARY)/oreo_debug : LICENSE $(DOL1)
+	@echo "╔═════════════════════════════════════════════════════════════════════════╗"
+	@echo "║ 🐛  🔗  Linking Files... bin/oreo_debug                                 ║"
+	@echo "╚═════════════════════════════════════════════════════════════════════════╝"
+ifeq '$(OS)' 'Windows_NT'
+	@test -d $(BINARY) || mkdir $(BINARY)
+else
+	@mkdir -p $(BINARY)
+endif
+	$(CC) $(BUILD_FLAGS) $(LIBS) -o $(BINARY)/oreo_debug $(DOL1) 
+
+# General Auto-Dependencies
+$(OBJECT)/%.o : $(SOURCE)/%.c
+	@echo "║ 🛠  Compiling... $(@)"
+ifeq '$(OS)' 'Windows_NT'
+	@test -d $(BINARY) || mkdir $(BINARY)
+	@test -d $(OBJECT) || mkdir $(OBJECT)
+else
+	@mkdir -p $(BINARY)
+	@mkdir -p $(OBJECT)
+endif
+	$(CC) $(BUILD_FLAGS) $(LIBS) -c $< -o $@
+# General Auto-Dependencies for debug
+# $(OBJECT)/%_debug.o : BUILD_FLAGS := $(DEBUG_FLAGS) $(CFLAGS)
+#
+$(OBJECT)/%_debug.o : $(SOURCE)/%.c
+	@echo "║ 🐛  🛠  Compiling... $(@)"
+ifeq '$(OS)' 'Windows_NT'
+	@test -d $(BINARY) || mkdir $(BINARY)
+	@test -d $(OBJECT) || mkdir $(OBJECT)
+else
+	@mkdir -p $(BINARY)
+	@mkdir -p $(OBJECT)
+endif
+	$(CC) $(BUILD_FLAGS) $(LIBS) -c $< -o $@
+
+.PHONY : clean
+clean :
+	@echo "🔥  Removed everything from $(OBJECT), $(BINARY), and $(LIBRARY) directories"
+	@rm -rf $(OBJECT) $(BINARY) $(LIBRARY)
+
+.PHONY : debug
+debug : LICENSE
+	@echo "╔═════════════════════════════════════════════════════════════════════════╗"
+	@echo "║ 🐛  🚧  Building executable: bin/oreo_debug                             ║"
+	@echo "╚═════════════════════════════════════════════════════════════════════════╝"
+	@$(MAKE) $(BINARY)/oreo_debug
+
+test : LICENSE build
+	@echo -n "❓ Running tests:"
+	@echo
+	@echo "Basic functional testing of command oreo:"
+	bin/oreo Test 1
+	echo -n "Test 2" | bin/oreo
+	echo -n "Test 3" | bin/oreo Test 4
+	bin/oreo oreo_test.txt
+
+.PHONY : install
+install : LICENSE
+	@echo "🔩  Starting install..."
+	@test -d $(PREFIX) | install -d $(PREFIX)
+	@test -f bin/oreo && install -v -m 755 bin/oreo $(PREFIX) || \
+		(echo "Executable file bin/oreo not found."; \
+		echo "Please type 'make build' first, if you wish to install.")
+	@echo "🔩  ✔  Installation Finished"
+
+.PHONY : uninstall
+uninstall :
+	@echo "🔧  Starting uninstall..."
+	rm -f $(PREFIX)oreo
+ifneq '$(OS)' 'FreeBSD'
+	rmdir --ignore-fail-on-non-empty $(PREFIX)
+endif
+	@echo "🔧  ✔  Uninstall Finished"

data/lib/apps/oreo/demake/applications

@@ -0,0 +1 @@
+oreo

data/lib/apps/oreo/demake/brief_description

@@ -0,0 +1 @@
+Create a different sample application

data/lib/apps/oreo/demake/license

@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/lib/apps/oreo/demake/settings.rb

@@ -0,0 +1,62 @@
+# Uncomment to use / override
+#					# Default Setting | none = ""
+#@silent = true				# false
+#@strip = false				# true
+#@debug_enabled = false                 # true
+#@compiler = "clang"			# "gcc"
+#@num_threads = 16			# 8
+#@prefix = "/usr/local/bin64/"		# "/usr/local/bin/"
+#@library_prefix = "/usr/local/lib64/"	# "/usr/local/lib/"
+#
+# ** demake never makes changes **
+#
+#@source_directory = "source"		# "src"
+#
+# ** make clean deletes all files in these directories **
+#
+#@binary_directory = "binary"		# "bin"
+#@library_directory = "library"		# "lib"
+#@object_directory = "object"		# "obj"
+#
+#@emojis = false			# true
+#@replace_with = "|b*|n"		# "|mo|n"
+# Both compiler & linker
+@flags = "-ansi -pedantic -D_POSIX_C_SOURCE=200809L"
+@optimize_flags = "-O2"
+#@compiler_flags = "-fPIE"
+#@linker_flags = "-fPIE"
+#@linker_libraries = "-lc"
+# Platform based
+#@linux_flags = "-static"
+#@linux_flags = "-static -static-libgcc"
+#@x86_64_flags = "-msse2 -mssse3 -msse4.1 -msha"
+#@aarch64_flags = "-march=armv8-a+crypto"
+#@riscv64_flags = "-march=native"
+#@windows_flags = "-target x86_64-w64-windows-gnu"
+#@freebsd_flags = ""
+#@darwin_flags = "-bundle"
+# Both compiler & linker
+#@libraries = "-lc"
+#@libraries = "-I/usr/include/ruby-3.4"
+# Used for building libraries
+#@library_compiler_flags = "-fPIC"
+#@library_linker_flags = "-fPIC"
+#@library_linker_libraries = "-lruby340"
+# Debugging
+@debug_flags = "-DOREO_DEBUG -g -Wall -Wextra -Wunused-variable -Wundef " +
+               "-Wconversion -Wshadow -Wcast-qual -Wwrite-strings"
+=begin
+@debug_flags << "-Wpedantic -Wdeprecated-declarations -Wdiv-by-zero " +
+                "-Wimplicit-function-declaration -Wimplicit-int " +
+                "-Wpointer-arith -Wwrite-strings -Wold-style-definition " +
+                "-Wmissing-noreturn -Wno-cast-function-type " +
+                "-Wno-constant-logical-operand -Wno-long-long " +
+                "-Wno-missing-field-initializers -Wno-overlength-strings " +
+                "-Wno-packed-bitfield-compat -Wno-parentheses-equality " +
+                "-Wno-self-assign -Wno-tautological-compare " +
+                "-Wno-unused-parameter -Wno-unused-value " +
+                "-Wsuggest-attribute=format -Wsuggest-attribute=noreturn"
+=end
+# Manually include (relative to Makefile) other raw binaries in linking
+#@raw_binary_files = "myfile/hello.o myfile/goodbye.o"
+notify("#{@emoji_success} demake/settings.rb is present")

data/lib/apps/oreo/demake/suggestion

@@ -0,0 +1 @@
+cd oreo ; make ; make build ; make test

data/lib/apps/oreo/demake/test-target.rb

@@ -0,0 +1,9 @@
+test_targets = <<-END_OF_STRING
+\t@echo
+\t@echo "|YBasic functional testing of command oreo:|n"
+\tbin/oreo Test 1
+\techo -n "Test 2" | bin/oreo
+\techo -n "Test 3" | bin/oreo Test 4
+\tbin/oreo oreo_test.txt
+END_OF_STRING
+test_target << test_targets

data/lib/apps/oreo/oreo_test.txt

@@ -0,0 +1 @@
+Test 5

data/lib/apps/oreo/src/defines.h

@@ -0,0 +1,29 @@
+/*
+   defines.h -- Basic C preprocessor macro definitions
+*/
+
+#ifndef DEFINES_H_Minaswan	/* Header guard to prevent multiple inclusions */
+  #define DEFINES_H_Minaswan
+  #define DEFINES_VERSION	"0.1.0"
+  #ifndef NULL
+    #define NULL		((void *) 0)
+  #endif
+  #ifndef FALSE
+    #define FALSE		0
+  #endif
+  #ifndef TRUE
+    #define TRUE		1
+  #endif
+  #ifndef NO
+    #define NO			0
+  #endif
+  #ifndef YES
+    #define YES			1
+  #endif
+  #ifndef OFF
+    #define OFF			0
+  #endif
+  #ifndef ON
+    #define ON			1
+  #endif
+#endif /* DEFINES_H_Minaswan */

data/lib/apps/oreo/src/fast_read_file.h

@@ -0,0 +1,259 @@
+/*
+
+  fast_read_file.h -- *Full Library* Header File
+
+  For reading the entire contents of a file into 64-bit aligned memory.
+
+  See the end of this file for examples.
+
+  Public Functions:     ** DON'T FORGET TO FREE YOUR MEMORY AFTER USE **
+
+  c8 *fast_read_all_file_mapped(FILE *file, u64 *total_bytes);  ** READ ONLY **
+  void free_all_mapped_read_memory(c8 *data, u64 *total_bytes);
+
+  c8 *fast_read_all_file_aligned(FILE *file, u64 *total_bytes); ** READ/WRITE **
+  void free_all_aligned_read_memory(c8 *data);
+
+*/
+
+#ifndef FAST_READ_FILE_H_Minaswan	/* Prevent multiple inclusions	*/
+#define FAST_READ_FILE_H_Minaswan
+  #define FAST_READ_FILE_VERSION	"0.1.0"
+  #ifndef TYPEDEFS_H_Minaswan		/* Header guard for typedefs.h	*/
+    #define TYPEDEFS_H_Minaswan
+    #include <stdint.h>
+    typedef uint8_t b8;			/* Booleans			*/
+    typedef uint16_t b16;
+    typedef uint32_t b32;
+    typedef uint64_t b64;
+
+    typedef char c8;			/* Characters			*/
+    typedef unsigned char uc8;
+
+    typedef uint8_t u8;			/* Unsigned Numbers		*/
+    typedef uint16_t u16;
+    typedef uint32_t u32;
+    typedef uint64_t u64;
+
+    typedef int8_t i8;			/* Signed Numbers		*/
+    typedef int16_t i16;
+    typedef int32_t i32;
+    typedef int64_t i64;
+
+    typedef float f32;			/* Floating Point Numbers	*/
+    typedef double f64;
+  #endif				/* TYPEDEFS_H_Minaswan		*/
+
+  #include <stdio.h>
+
+  /* Public Functions */
+  void free_all_mapped_read_memory(c8 *data, u64 *total_bytes);
+  void free_all_aligned_read_memory(c8 *data);
+  c8 *fast_read_all_file_mapped(FILE *file, u64 *total_bytes);
+  c8 *fast_read_all_file_aligned(FILE *file, u64 *total_bytes);
+
+  #ifdef FAST_READ_FILE_IMPLEMENTATION	/* Effectively read_all_file.c	*/
+    #include <stdlib.h>
+    #include <string.h>
+    #if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
+      #include <windows.h>
+    #else
+      #include <sys/mman.h>
+      #include <sys/stat.h>
+      #include <fcntl.h>
+      #include <unistd.h>
+    #endif
+
+    extern i32 fileno(FILE *stream);
+
+    #define FAST_READ_FILE_BUFFER_SIZE	4096
+
+    #ifndef FALSE
+      #define FALSE			0
+    #endif
+
+    #ifndef TRUE
+      #define TRUE			1
+    #endif
+
+    #ifndef NULL
+      #define NULL			((void *) 0)
+    #endif
+
+    #ifndef MIN
+      #define MIN(a, b)			((a) < (b) ? a : b)
+    #endif
+
+    void *fast_file_align64_malloc(size_t size)
+    {
+      void *result = NULL;
+
+      if(size == 0)
+        return(NULL);
+    #if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
+      result = _aligned_malloc(size, 64);
+    #else
+      #if(defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 200112L) || \
+          (defined(_XOPEN_SOURCE) && _XOPEN_SOURCE >= 600)
+        if(posix_memalign(&result, 64, size) != 0)
+          return(NULL);
+      #else
+        result = malloc(size);
+      #endif
+    #endif
+      return(result);
+    }
+
+    void *fast_file_align64_calloc(size_t size)
+    {
+      void *result = fast_file_align64_malloc(size);
+
+      if(result)
+        memset(result, 0, size);
+      return(result);
+    }
+
+    void *fast_file_align64_realloc(void *existing_memory, size_t old_size, size_t new_size)
+    {
+      void *new_memory = fast_file_align64_calloc(new_size);
+
+      if(new_memory && existing_memory) {
+        memcpy(new_memory, existing_memory, MIN(new_size, old_size));
+        free(existing_memory);
+        return(new_memory);
+      }
+      return(NULL);
+    }
+
+    c8 *fast_read_all_file_aligned(FILE *file, u64 *total_bytes)
+    {
+      size_t bytes = 0, count = 0;
+      c8 buffer[FAST_READ_FILE_BUFFER_SIZE + 1];
+      c8 *data = NULL;
+
+      bytes = fread(buffer, sizeof(c8), FAST_READ_FILE_BUFFER_SIZE, file);
+      while(bytes) {
+        if(data) {
+          data = fast_file_align64_realloc(data, *total_bytes + 1, *total_bytes + bytes + 1);
+          count = 0;
+          while(count < bytes) {
+            *(data + *total_bytes + count) = buffer[count];
+            count++;
+          }
+        } else {
+          data = fast_file_align64_calloc(bytes + 1);
+          count = 0;
+          while(count < bytes) {
+            *(data + *total_bytes + count) = buffer[count];
+            count++;
+          }
+        }
+        *total_bytes += (u32)bytes;
+        *(data + *total_bytes) = '\0';
+        bytes = fread(buffer, sizeof(c8), FAST_READ_FILE_BUFFER_SIZE, file);
+      }
+      return(data);
+    }
+
+    c8 *fast_read_all_file_mapped(FILE *file, u64 *total_bytes)
+    {
+      c8 *data = NULL;
+    #if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
+      HANDLE windows_file_handle = {0};
+      HANDLE windows_map_handle = {0};
+      LARGE_INTEGER windows_file_size = {0};
+    #else
+      i32 file_descriptor = fileno(file);
+      struct stat st = {0};
+    #endif
+
+    #if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
+      windows_file_handle = (HANDLE)_get_osfhandle(fileno(file));
+      if(windows_file_handle == INVALID_HANDLE_VALUE)
+        return(NULL);
+      if(!GetFileSizeEx(windows_file_handle, &windows_file_size) ||
+          windows_file_size.QuadPart == 0) {
+        CloseHandle(windows_file_handle);
+        return(NULL);
+      }
+      *total_bytes = (u64)windows_file_size.QuadPart;
+      windows_map_handle = CreateFileMapping(windows_file_handle,
+          NULL, PAGE_READONLY, 0, 0, NULL);
+      data = MapViewOfFile(windows_map_handle, FILE_MAP_READ, 0, 0, 0);
+      CloseHandle(windows_file_handle);
+      CloseHandle(windows_map_handle);
+    #else
+      if(file_descriptor == -1)
+        return(NULL);
+      if(fstat(file_descriptor, &st) == -1 || st.st_size == 0) {
+        close(file_descriptor);
+        return(NULL);
+      }
+      *total_bytes = (u64)st.st_size;
+      data = mmap(NULL, *total_bytes, PROT_READ, MAP_PRIVATE,
+          file_descriptor, 0);
+      if(data == MAP_FAILED) {
+        close(file_descriptor);
+        return(NULL);
+      }
+      #ifdef POSIX_FADV_SEQUENTIAL
+        posix_fadvise(file_descriptor, 0, (i64)*total_bytes,
+            POSIX_FADV_SEQUENTIAL);
+      #endif
+      #ifdef MADV_SEQUENTIAL
+        madvise(data, *total_bytes, MADV_SEQUENTIAL);
+      #endif
+      close(file_descriptor);
+    #endif
+      return(data);
+    }
+
+    void free_all_mapped_read_memory(c8 *data, u64 *total_bytes)
+    {
+    #if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
+      UnmapViewOfFile(data);
+    #else
+      munmap(data, *total_bytes);
+    #endif
+    }
+
+    void free_all_aligned_read_memory(c8 *data)
+    {
+    #if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
+      _aligned_free(data);
+    #else
+      free(data);
+    #endif
+    }
+  #endif /* FAST_READ_FILE_IMPLEMENTATION */
+#endif /* FAST_READ_FILE_H_Minaswan */
+
+/*
+
+  Examples:      ** DON'T FORGET TO FREE YOUR MEMORY AFTER USE **
+
+  #define FAST_READ_FILE_IMPLEMENTATION
+  #include "fast_read_file.h"
+
+  // Read everything from file example:
+
+  FILE *file = fopen(argv[1], "rb");
+  u64 total_bytes = 0;
+  c8 *data = fast_read_all_file_mapped(file, &total_bytes);
+  use(string);
+  free_all_mapped_read_memory(string);	// Note: Doesn't use malloc/free
+
+  // Read everything from stdin / non-kernal mapping example:
+
+  u64 total_bytes = 0;
+  c8 *data = fast_read_all_file_aligned(stdin, &total_bytes);
+  use(string);
+  free_all_aligned_read_memory(string);	// Note: Might not use malloc/free
+
+  FILE *file = fopen(argv[1], "rb");
+  u64 total_bytes = 0;
+  c8 *data = fast_read_all_file_aligned(file, &total_bytes);
+  use(string);
+  free_all_aligned_read_memory(string);	// Note: Might not use malloc/free
+
+*/