master 브랜치를 stable 브랜치로 병합

1.2.1 릴리즈

Author: kmc7468

CONTRIBUTING.md

@@ -23,6 +23,14 @@
 master 브랜치에서 버전의 개발이 완료되어 릴리즈를 할 준비가 완료되었으며, 정식 출시가 가능한 안정화 된 버전일 경우 master 브랜치에서 stable 브랜치로 커밋을 병합합니다.
 - **pre-release 브랜치**<br>
 master 브랜치에서 버전의 개발이 완료되어 릴리즈를 할 준비가 완료되었으나, 정식 출시 전 프리릴리즈일 경우 master 브랜치에서 pre-release 브랜치로 커밋을 병합합니다.
+### 브랜칭 전략
+- 신규 기능을 구현할 때, 작업이 오래 걸릴 것으로 보이는 기능을 구현한다면 `"feature/(기능 이름)"`의 이름을 가진 브랜치를 master 브랜치에서 분기시킬 수 있습니다. 작업이 끝난 후에는 다시 master 브랜치로 병합시켜야 합니다. 병합을 한 후에는 브랜치를 삭제합니다.
+	- 기능 이름은 알파벳 소문자, 언더바(`'_'`)로만 이루어진 명령문 형태의 영어 문장으로 되어 있어야 합니다. 문장은 최대한 간결하게 만듭니다. 예를 들어, `encoding` 클래스를 추가하는 작업을 할 예정이라면, 브랜치 이름을 `"feature/add_encoding_class"`로 지으면 됩니다.
+	- 해당 브랜치에는 해당 기능 구현과 관련 없는 작업은 하지 마십시오.
+- 버그를 수정할 때, 작업이 오래 걸릴 것으로 보이는 기능을 구현한다면 `"bugfix/(버그 이름)"`의 이름을 가진 브랜치를 master 브랜치에서 분기시킬 수 있습니다. 작업이 끝난 후에는 다시 master 브랜치로 병합시켜야 합니다. 병합을 한 후에는 브랜치를 삭제합니다.
+	- 버그 이름은 알파벳 소문자, 언더바(`'_'`)로만 이루어진 명령문 형태의 영어 문장으로 되어 있어야 합니다. 문장은 최대한 간결하게 만듭니다. 예를 들어, 리눅스에서 문자 입력이 되지 않는 버그를 수정할 예정이라면, 브랜치 이름을 `"bugfix/cannot_read_character"`로 지으면 됩니다.
+- 이미 출시된 릴리즈에 심각한 버그가 있을 경우 master 브랜치에서 stable 또는 pre-release 브랜치로 병합하는 커밋(안정된 릴리즈일 경우 stable 브랜치로, 프리릴리즈일 경우 pre-release 브랜치로 병합하는 커밋에서 분기합니다.)에서 `"bugfix/(버그 이름)"`의 이름을 가진 브랜치를 master 브랜치에서 분기한 후, 버그를 수정한 후 master 브랜치 및 stable 또는 pre-release 브랜치(안정된 릴리즈일 경우 stable 브랜치로, 프리릴리즈일 경우 pre-release 브랜치로 병합합니다.)로 병합합니다. 이때, master 브랜치에 먼저 병합을 한 후에 stable 또는 pre-release 브랜치에 병합해야 합니다. 병합을 한 후에는 브랜치를 삭제합니다.
+	- 단, 프리릴리즈를 포함하여 가장 최신 릴리즈에서 심각한 버그가 발견되었을 경우, master 브랜치에 부 버전을 올려야 하는 기능 구현을 하지 않았다면 브랜치를 분기하지 않고 master 브랜치에서 작업합니다(단, 이 경우에도 버그의 수정이 오래 걸릴 것으로 보이면 브랜치를 분기할 수 있습니다.).
 ## 릴리즈 절차
 1. master 브랜치에서 특정 버전에 대한 개발을 완료합니다.
 2. 만약 정식 출시가 가능한 안정화 된 버전일 경우 stable 브랜치로 커밋을 병합합니다. 만약 정식 출시 전 프리릴리즈일 경우 pre-release 브랜치로 커밋을 병합합니다.

README.md

@@ -56,6 +56,18 @@ $ make
 	- 값은 `"실행 파일"`, `"정적 라이브러리"` 중 하나입니다.
 ## [레퍼런스](https://github.com/kmc7468/Aheuiplusplus/wiki)
 아희++ 표준 및 예제를 수록하고 있습니다. 만약 구현체 개발을 진행하시다가 레퍼런스만 보고 동작을 결정하기 어려운 사안이 있다면 개발자에게 알려주시면 감사하겠습니다.
+## 예제
+더 많은 예제는 레퍼런스를 참조해 주십시오.
+### [개발자 수다방](https://gist.github.com/RanolP/6ecb4b1030fccad19dc05f3716d6c2c7) by [RanolP](https://gist.github.com/RanolP)
+```
+개반뭉반붓밪두빥붖빠뭏밠뭉박누망뭏따뿌삭뿌밪붅파투밣뚜타댜뎌뭏뷺다두타두밢두밙뚜빥푸다뿑빠뿌빥분받뚜삽쑤밪불빥두받투밧누
+발꾔바몽나몽망봀타뽀바몽맣본빠몽밤봃싹뫃빠소따뽅빥볼타빠쑺봃밠뽅소두봎뭏또두볻두봃쑵봃붖뽀뿌토붅또투도수소뚜도푸토뭏본뭉
+자두변번뻕떠벌벚멓더떠벓벐더머퍼뻕더뻕벒뻕더벇뻕떠벐번멓서볻퍼두뫃불포두봀뭏뽅뭏뽅투뫃불속뭏볾뚜쏩뭏뽅투뫃뿑노투도분소붋
+수뺝리밪밤따다맣밪타빥밠빥파타반밧나타타삭맣사맣밢타빥맣발다뽅맣속타뽅빥본밦토밦도밞토따도사뫃빠뽀밦도맣속반봇밠뽅삭뫃뿌
+다총통각하만세삼창해멓북번붏멓뚜벖두뻕숙멓붊번붇썩투퍼투너뚜벓수멓두번푸뻕푸터두번불벚두벘뿑벐뿑더뿑벑숮멓투떠붍번뿌떠붐
+방망희됴아하는난로당도너또범토더봆벌토벌토더토너뽀퍼뽅터봇번볻뻐속멓토머볾터포뻕뽅떠뫃더토더토퍼본더뫃뻐속멓봆더도뻕또더
+```
+출력: `2018.07.11. 개발자 수다방: 텔레그램 에디션 제 1회 개천절 경축!`
 ## 라이선스
 MIT 라이선스를 채택하고 있습니다.
 ```

include/Aheuiplusplus/Aheuiplusplus.hpp

@@ -2,7 +2,7 @@
 #include <Aheuiplusplus/command_line.hpp>
 #include <Aheuiplusplus/debugger.hpp>
 #include <Aheuiplusplus/encoding.hpp>
-#include <Aheuiplusplus/function.hpp>
 #include <Aheuiplusplus/interpreter.hpp>
+#include <Aheuiplusplus/memory.hpp>
 #include <Aheuiplusplus/storage.hpp>
 #include <Aheuiplusplus/version.hpp>

include/Aheuiplusplus/encoding.hpp

@@ -3,51 +3,12 @@
 
 #include <cstdint>
 #include <cstdio>
+#include <stdexcept>
 #include <string>
 #include <vector>
 
 namespace app
 {
-	bool is_little_endian();
-	template<typename Ty_>
-	std::uint8_t get_byte(const Ty_& data, int index)
-	{
-		if (index >= sizeof(Ty_))
-			throw std::invalid_argument("인수 index는 템플릿 인수 Ty_의 크기 미만이여야 합니다.");
-		
-		return *(reinterpret_cast<const std::uint8_t*>(&data) + index);
-	}
-	template<typename Ty_>
-	std::uint8_t get_byte_in_little_endian(const Ty_& data, int index)
-	{
-		if (index >= sizeof(Ty_))
-			throw std::invalid_argument("인수 index는 템플릿 인수 Ty_의 크기 미만이여야 합니다.");
-		
-		if (is_little_endian())
-		{
-			return *(reinterpret_cast<const std::uint8_t*>(&data) + index);
-		}
-		else
-		{
-			return *(reinterpret_cast<const std::uint8_t*>(&data) + ((sizeof(Ty_) - 1) - index));
-		}
-	}
-	template<typename Ty_>
-	std::uint8_t get_byte_in_big_endian(const Ty_& data, int index)
-	{
-		if (index >= sizeof(Ty_))
-			throw std::invalid_argument("인수 index는 템플릿 인수 Ty_의 크기 미만이여야 합니다.");
-
-		if (is_little_endian())
-		{
-			return *(reinterpret_cast<const std::uint8_t*>(&data) + ((sizeof(Ty_) - 1) - index));
-		}
-		else
-		{
-			return *(reinterpret_cast<const std::uint8_t*>(&data) + index);
-		}
-	}
-
 	namespace encoding
 	{
 		class utf8 final

include/Aheuiplusplus/function.hpp

@@ -1,15 +1,14 @@
 #ifndef AHEUIPLUSPLUS_HEADER_INTERPRETER_HPP
 #define AHEUIPLUSPLUS_HEADER_INTERPRETER_HPP
 
-#define AHEUIPLUSPLUS_VERSION_STRING ("1.2.0")
+#define AHEUIPLUSPLUS_VERSION_STRING ("1.2.1")
 #define AHEUIPLUSPLUS_VERSION_PRE ("")
 #define AHEUIPLUSPLUS_VERSION (1)
 #define AHEUIPLUSPLUS_VERSION_MAJOR AHEUIPLUSPLUS_VERSION
 #define AHEUIPLUSPLUS_VERSION_MINOR (2)
-#define AHEUIPLUSPLUS_VERSION_PATCH (0)
+#define AHEUIPLUSPLUS_VERSION_PATCH (1)
 
 #include <Aheuiplusplus/code.hpp>
-#include <Aheuiplusplus/function.hpp>
 #include <Aheuiplusplus/storage.hpp>
 #include <Aheuiplusplus/version.hpp>
 
@@ -94,7 +93,6 @@ namespace app
 		const std::vector<std::vector<app::storage*>>& storages() const noexcept;
 		const std::vector<std::size_t>& storage_indexs() const noexcept;
 		std::size_t selected_index() const noexcept;
-		const std::vector<function*>& functions() const noexcept;
 
 		bool is_integer_mode() const noexcept;
 		bool is_compatible_with_aheui() const noexcept;
@@ -107,7 +105,6 @@ namespace app
 		std::vector<std::vector<app::storage*>> storages_;
 		std::vector<std::size_t> storage_indexs_;
 		std::size_t selected_index_ = 0;
-		std::vector<function*> functions_;
 
 		bool is_integer_mode_ = true;
 		bool is_compatible_with_aheui_ = true;

include/Aheuiplusplus/interpreter.hpp

@@ -0,0 +1,47 @@
+#ifndef AHEUIPLUSPLUS_HEADER_MEMORY_HPP
+#define AHEUIPLUSPLUS_HEADER_MEMORY_HPP
+
+#include <cstdint>
+
+namespace app
+{
+	bool is_little_endian();
+
+	template<typename Ty_, int Index_>
+	std::uint8_t get_byte(const Ty_& data)
+	{
+		static_assert(Index_ < sizeof(Ty_), "Template Argument Index_ must be less than the size of template argument Ty_.");
+
+		return *(reinterpret_cast<const std::uint8_t*>(&data) + index);
+	}
+	template<typename Ty_, int Index_>
+	std::uint8_t get_byte_by_little_endian(const Ty_& data)
+	{
+		static_assert(Index_ < sizeof(Ty_), "Template Argument Index_ must be less than the size of template argument Ty_.");
+
+		if (is_little_endian())
+		{
+			return *(reinterpret_cast<const std::uint8_t*>(&data) + Index_);
+		}
+		else
+		{
+			return *(reinterpret_cast<const std::uint8_t*>(&data) + ((sizeof(Ty_) - 1) - Index_));
+		}
+	}
+	template<typename Ty_, int Index_>
+	std::uint8_t get_byte_by_big_endian(const Ty_& data)
+	{
+		static_assert(Index_ < sizeof(Ty_), "Template Argument Index_ must be less than the size of template argument Ty_.");
+
+		if (is_little_endian())
+		{
+			return *(reinterpret_cast<const std::uint8_t*>(&data) + ((sizeof(Ty_) - 1) - Index_));
+		}
+		else
+		{
+			return *(reinterpret_cast<const std::uint8_t*>(&data) + Index_);
+		}
+	}
+}
+
+#endif

include/Aheuiplusplus/memory.hpp

@@ -10,15 +10,6 @@
 
 namespace app
 {
-	class function;
-
-	enum class storage_type
-	{
-		list,
-		queue,
-		passage,
-	};
-
 	class number final
 	{
 	public:
@@ -51,7 +42,14 @@ namespace app
 		bool is_integer_ = true;
 	};
 
-	using element = std::variant<number, char32_t, raw_code, function*>;
+	using element = std::variant<number, char32_t, raw_code>;
+
+	enum class storage_type
+	{
+		list,
+		queue,
+		passage,
+	};
 
 	class storage
 	{

include/Aheuiplusplus/storage.hpp

@@ -8,14 +8,16 @@ namespace app
 		none = -1,
 		v1_0 = 0,
 		v1_1,
+		v2_0,
 
-		latest = v1_1,
+		latest = v2_0,
 	};
 
-	long long get_major(app::version version) noexcept;
-	long long get_minor(app::version version) noexcept;
-	version get_version(long long major) noexcept;
-	version get_version(long long major, long long minor) noexcept;
+	int get_major(app::version version) noexcept;
+	int get_minor(app::version version) noexcept;
+	version get_version(int major, int minor) noexcept;
+	version get_version(int major) noexcept;
+	bool is_later(app::version lhs, app::version rhs) noexcept;
 }
 
 #endif