felflame 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c65245c163dfe596ebdfe551070f90cdbb838f852d0b36d349e26b77890b36ba
+  data.tar.gz: 0e2baf45d48d36a2c8d369f345f0f6b80283ac55f210bd637d84dbb3e288a96d
+SHA512:
+  metadata.gz: 9aa77caa16ca8ef8110f8a16641f784b4869928b91e40dfdc95d609d92e0ab9b3a4c447de88272f10f480e6560af7d7388410712c2b7522eb85c3b189c02dbd1
+  data.tar.gz: f7ae4a1354deefbff45a00719f3a4ce7f40eda46d4f87408b9cfc872373b96669ecad16832dc0b6f1ab95df3440dc5c8f0d90245cf7c6bb995c619057279cca4

data/.byebug_history

@@ -0,0 +1,20 @@
+c
+s
+var instance
+s
+var instance
+s
+v args
+s
+v instance
+s
+v instance
+v const
+v
+v all
+v args
+v local
+v
+tr
+s
+n

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/pkg/
+/spec/reports/
+/tmp/
+
+# Ignore generated coverage
+coverage/*
+coverage
+
+# Ignore yard metadata
+.yardoc/*
+.yardoc
+/_yardoc/
+
+# Ignore codeclimate executable and env vars
+codeclimate/env.rb
+codeclimate/test-reporter-latest-linux-amd64

data/.inch.yml

@@ -0,0 +1,11 @@
+files:
+  # define files included in the analysis (defaults to ["{app,lib}/**/*.rb"])
+  included:
+    - felflame.rb
+    - component_manager.rb
+    - entity_manager.rb
+    - system_manager.rb
+    - scene_manager.rb
+    - stage_manager.rb
+  # define files excluded from the analysis (defaults to [])
+  excluded:

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,13 @@
+AllCops:
+  TargetRubyVersion: 2.4
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Max: 120

data/.yardopts

@@ -0,0 +1,13 @@
+--readme README.mdown
+--markup=markdown|textile|rdoc(default)
+--protected
+--no-private
+
+LICENSE
+README.mdown
+system_manager.rb
+component_manager.rb
+entity_manager.rb
+scene_manager.rb
+stage_manager.rb
+felflame.rb

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2021-07-09
+
+- Initial release

data/Gemfile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in felflame.gemspec
+gemspec
+
+ruby '2.7.3'
+
+gem "rake", "~> 13.0"
+

data/Gemfile.lock

@@ -0,0 +1,87 @@
+PATH
+  remote: .
+  specs:
+    felflame (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ansi (1.5.0)
+    ast (2.4.2)
+    builder (3.2.4)
+    diff-lcs (1.4.4)
+    docile (1.4.0)
+    minitest (5.14.4)
+    minitest-reporters (1.4.3)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    parallel (1.20.1)
+    parser (3.0.1.1)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (13.0.3)
+    redcarpet (3.5.1)
+    regexp_parser (2.1.1)
+    rexml (3.2.5)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    rubocop (1.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.7.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.7.0)
+      parser (>= 3.0.1.1)
+    ruby-progressbar (1.11.0)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-console (0.9.1)
+      ansi
+      simplecov
+      terminal-table
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.3)
+    terminal-table (3.0.1)
+      unicode-display_width (>= 1.1.1, < 3)
+    unicode-display_width (2.0.0)
+    yard (0.9.26)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  felflame!
+  minitest-reporters (~> 1.4, >= 1.4.3)
+  rake (~> 13.0)
+  redcarpet (~> 3.5, >= 3.5.1)
+  rspec (~> 3.10)
+  rubocop (~> 1.7)
+  simplecov (~> 0.21.2)
+  simplecov-console (~> 0.9.1)
+  simplecov_json_formatter (~> 0.1.3)
+  yard (~> 0.9.26)
+
+RUBY VERSION
+   ruby 2.7.3p183
+
+BUNDLED WITH
+   2.1.4

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 _Tradam
+
+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/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 realtradam
+
+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/README.mdown

@@ -0,0 +1,410 @@
+
+![FelFlame](https://filestorage.catgirls.rodeo/images/felflame-logo-smaller-text.png)
+
+[![Maintainability](https://api.codeclimate.com/v1/badges/56d425d9078e98efb74b/maintainability)](https://codeclimate.com/github/realtradam/FelFlame/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/56d425d9078e98efb74b/test_coverage)](https://codeclimate.com/github/realtradam/FelFlame/test_coverage)
+[![Inline docs](http://inch-ci.org/github/realtradam/FelFlame.svg?branch=master)](http://inch-ci.org/github/realtradam/FelFlame)
+[![MIT License](https://img.shields.io/github/license/realtradam/FelFlame?label=license&style=flat)](https://github.com/realtradam/FelFlame/blob/master/LICENSE)
+[![Ko-Fi](https://img.shields.io/static/v1?message=Buy%20me%20a%20coffee&logo=kofi&labelColor=ff5e5b&color=434B57&logoColor=white&label=%20)](https://ko-fi.com/tradam)
+
+**[Check out the comprehensive documentation here!](https://felflame.tradam.fyi/)**
+
+---
+
+<!-- vim-markdown-toc GFM -->
+
++ [What is FelFlame?](#what-is-felflame)
++ [What is ECS?](#what-is-ecs)
+		- [Components](#components)
+		- [Entities](#entities)
+		- [Systems](#systems)
+		- [Scenes](#scenes)
+		- [Stage](#stage)
++ [Usage](#usage)
+	* [Entities](#entities-1)
+		- [Creation](#creation)
+		- [Accessing](#accessing)
+		- [Get ID](#get-id)
+		- [Adding and Removing Components](#adding-and-removing-components)
+		- [Deletion](#deletion)
+	* [Components](#components-1)
+		- [Creating a Component Manager](#creating-a-component-manager)
+		- [Creating a Component from a Component Manager](#creating-a-component-from-a-component-manager)
+		- [Accessing and Getting ID](#accessing-and-getting-id)
+		- [Accessing Attributes and Changing Them](#accessing-attributes-and-changing-them)
+		- [Deleting Components](#deleting-components)
+		- [Iterating over Components](#iterating-over-components)
+	* [Systems](#systems-1)
+		- [Creation](#creation-1)
+		- [Execution](#execution)
+		- [Alternative Execution](#alternative-execution)
+		- [Clearing Alternative Executions](#clearing-alternative-executions)
+		- [Redefinition](#redefinition)
+	* [Scenes](#scenes-1)
+		- [Creation](#creation-2)
+		- [Accessing](#accessing-1)
+		- [Adding Systems](#adding-systems)
+		- [Removing Systems](#removing-systems)
+		- [Clearing](#clearing)
+		- [Execution](#execution-1)
+	* [Stage](#stage-1)
+		- [Adding Scenes](#adding-scenes)
+		- [Removing Scenes](#removing-scenes)
+		- [Executing](#executing)
+	* [Closing Notes](#closing-notes)
++ [Contribution](#contribution)
+
+<!-- vim-markdown-toc -->
+
+# What is FelFlame?
+
+FelFlame is an ECS framework for developing games in the Ruby language. FelFlame has been designed from the ground up with these three ideas in mind:
+
+1. **Engine Agnostic:** FelFlame has been designed to be rendering engine agnostic as long as the target rendering engine is written in Ruby. This means that this framework can be dropped into existing rendering engines such as [Ruby2D](http://www.ruby2d.com) or [DRGTK](https://dragonruby.org/toolkit/game) with little modifications.
+2. **Easily Extensible:** FelFlame has been designed such that extensions to its capabilities can be easily added. Extensions such as rendering engine wrappers, premade systems, premade components, etcetera can be easily coded and then distributed as gems.
+3. **Priciple of (My) Least Astonishment:** I want to develop games using a language and framework I love and makes sense to me, inspired by the [Philosophy of the creator of Ruby](https://en.wikipedia.org/wiki/Ruby_(programming_language)#Philosophy).
+
+# What is ECS?
+ECS is a software architectural pattern that is used in video game development. Traditionally games were programmed using an object oriented method, while ECS instead attempts to program games using a data oriented method instead.  
+ECS stands for Entity, Component, and System.
+
+---
+
+### Components
+This is where the data or information of a given "object" is stored. There is no logic or code here. 
+
+### Entities
+Entities will contain one or more Components, but contains no logic or data otherwise
+
+### Systems
+Systems are where all the logic or code is kept. There is no data stored in here.
+
+---
+
+By using this pattern it allows programmers to easily control what an "object" or entity can do and how much data it needs to have. It avoids the issue of inhertance as no inhertance is ever required in this system. If you need a certain entity to have a certain functionality you just add the relevant component to it, and the systems that automatically go over specific components will give your entitiy the desired functionality.  
+
+**"But your framework also has `Scenes` and a `Stage`, what is that about?"**  
+
+---
+
+### Scenes
+Scenes are simply a collection or subset of Systems. This allows for an easy way to activate and deactivate Systems.
+
+### Stage
+The Stage is Scenes which are activated. This means any Scenes on the Stage are executed each frame, while the rest of the Systems are not.
+
+---
+
+If all of this sounds very confusing, don't worry. A video tutorial series is in the works where I will build a game using this framework and explain every step of the way. You can also read some examples and explanations below.
+
+# Usage
+
+To use FelFlame simply install the gem using `gem install felflame` or using bundler `bundle add felflame` and then require it in your project like so: `require 'felflame'`. Working outside of the gem for rendering engines that do not support the usage of gems is planned a planned feature in the works.
+
+## Entities
+
+### Creation
+Entities are essentially "objects" in the game world. To create a new Entity we do the following:
+
+```ruby
+@entity = FelFlame::Entities.new
+```
+or if we want to add (any number of)components to it:
+
+```ruby
+@entity = FelFlame::Entites.new(FelFlame::Components::Health.new,
+                     @component,
+		     FelFlame::Components::Armour[7])
+```
+
+### Accessing
+Once components are created we can access them using their ID like so:
+
+```ruby
+@entity = FelFlame::Entities[2]
+```
+
+### Get ID
+Entity ID's are generated starting from 0 and ascending, unless if there is a missing ID because of a deleted
+entity where a new entity will claim that ID. To get the ID of an Entity:
+
+```ruby
+@entity.id
+```
+
+### Adding and Removing Components
+We can still add or remove Components from an Entity after it has been created. Here is how:
+
+```ruby
+@entity.add @component
+@entity.remove @component
+```
+
+### Deletion
+To have all Components from an Entity removed and the Entity deleted we do the following:
+
+```ruby
+@entity.delete
+```
+
+## Components
+
+### Creating a Component Manager
+Components are where all the data is stored. The data is stored in variables or accessors in each component.
+These accessors and their defaults are configured when a component manager is created, like so:
+
+```ruby
+@component_manager = FelFlame::Components.new('Stats', :armour, hp: 100)
+```
+
+In this example we created a component manager called "Stats".
+The name given to component managers must follow the same rules for naming constants in ruby for a reason you will shortly see.
+The parameters following are all creating the attributes we can set.
+We can set any number of parameters we wish, in this example we define two.
+The `:armour` parameter is being created without a default, it will equal to `nil` when a new component is created, while `hp` will be equal to 100 when a component is created.
+When defining attributes symbols should be used.
+
+### Creating a Component from a Component Manager
+Now that we have a component manager we can make components from it like so:
+
+```ruby
+@component = FelFlame::Components::Stats.new
+```
+
+Or we can even change the defaults:
+
+```ruby
+@component = FelFlame::Components::Stats.new(armour: 'steel')
+```
+
+### Accessing and Getting ID
+Just like Entities, Components have IDs.
+These IDs are only unique within the scope of their respective Component Managers.
+Here is how we can get the ID, as well as how to access a Component from its Component Manager.
+
+```ruby
+@component = FelFlame::Components::Stats[2]
+@component.id # => 2
+```
+
+### Accessing Attributes and Changing Them
+There are a few different ways we can read or change the attributes of a component depending on what our needs are.
+Here are the ways to edit attrubutes, followed by the ways to read them.
+```ruby
+@component.armour = 'Mythril'
+@component.update_attrs(armour: 'Leather', hp: 95)
+```
+```ruby
+@component.hp # => 95
+@component.attrs # => {armour: 'Leather', hp: 95}
+```
+
+### Deleting Components
+Deleting a Component is the same format as deleting an Entity. When a Component is deleted referenced to it such as to entities are automatically cleared.
+
+```ruby
+@component.delete
+```
+
+### Iterating over Components
+When you make Systems you will want to be able to iterate over all Components of the same Component Manager(for example iterating over all sprites to render them). Here is how we do that:
+```ruby
+FelFlame::Components::Sprites.each do |component|
+  #do something with components
+end
+```
+
+## Systems
+
+### Creation
+We can create Systems like so:
+
+```ruby
+FelFlame::Systems.new(name: 'Render', priority: 2) do
+  # Code and Logic
+end
+```
+
+The name we assign is how we can access the System, like so:
+
+```ruby
+FelFlame::Systems::Render
+```
+Priority determines the order Systems should be executed, this is used for `Scenes` and the `Stage`.
+The lower the number, the earlier a given System will be executed.
+E.g priority 1 will go first, priority 2 will go second, etcetera.  
+
+Often we will want to execute some logic on each Component in a given Component Manager so our code might look like this:
+
+```ruby
+FelFlame::Systems.new(name: 'Render', priority: 2) do
+  FelFlame::Components::Sprites.each do |component|
+    # do something with these components
+  end
+end
+```
+
+### Execution
+After we create a System, it won't do anything on its own until we tell it to. Here is how:
+
+```ruby
+FelFlame::Systems::Render.call
+```
+
+Sometimes you might want to manually activate a System, but the more common way to have Systems be triggered is to use Scenes and the Stage or the alternative ways of execution.
+
+### Alternative Execution
+Sometimes you want a System to automatically trigger when a special even happens. FelFlame can keep track of when a Component is added, removed, or when an attribute is changed and then execute Systems linked to these events. Here is how to create these links:
+
+```ruby
+# When this Component is added to an Entity, this System will be called
+FelFlame::Systems::PassiveRegen.trigger_when_added(@component)
+
+# When this Component is removed from an Entity, this System will be called
+FelFlame::Systems::PassiveRegen.trigger_when_removed(@component)
+
+# When this Component's health attribute is changed, this System will be called
+FelFlame::Systems::PassiveRegen.trigger_when_is_set(@component, :health)
+```
+
+If we want these triggers to happen for all Components that belong to specific Component Manager then we can do that instead:
+
+```ruby
+# When a Component from this Component Manager is added to an Entity, this System will be called
+FelFlame::Systems::PassiveRegen.trigger_when_added(@component_manager)
+
+# When a Component from this Component Manager is removed from an Entity, this System will be called
+FelFlame::Systems::PassiveRegen.trigger_when_removed(@component_manager)
+
+# When this Component's health attribute from this Component Manager is changed, this System will be called
+FelFlame::Systems::PassiveRegen.trigger_when_is_set(@component_manager, :health)
+```
+
+We can create any number of these links between Systems, Components, and Component Manangers as we like, simply call the method again with our other Components and Component Managers
+
+### Clearing Alternative Executions
+
+If we wish to remove these links that we created, we can do that using the follwing function in any of the following ways:
+
+```ruby
+# clears ALL triggers with this system
+FelFlame::Systems::PassiveRegen.clear_triggers
+
+# clears ALL triggers with this Component Manager
+FelFlame::Systems::PassiveRegen.clear_triggers(@component)
+
+# clear the 'trigger_when_added' for this Component
+FelFlame::Systems::PassiveRegen.clear_triggers(@component, :added)
+
+# clear the 'trigger_when_removed' for this Component
+FelFlame::Systems::PassiveRegen.clear_triggers(@component, :removed)
+
+# clear the 'trigger_when_is_set' for this Component specifically for the health attribute
+FelFlame::Systems::PassiveRegen.clear_triggers(@component, :is_set, :health)
+```
+
+Likewise we can do the same with Component Managers:
+
+```ruby
+# clears ALL triggers with this Component
+FelFlame::Systems::PassiveRegen.clear_triggers(@component_manager) 
+
+# clear the 'trigger_when_added' for this Component Manager
+FelFlame::Systems::PassiveRegen.clear_triggers(@component_manager, :added) 
+
+# clear the 'trigger_when_removed' for this Component Manager
+FelFlame::Systems::PassiveRegen.clear_triggers(@component_manager, :removed) 
+
+# clear the 'trigger_when_is_set' for this Component Manager specifically for the health attribute
+FelFlame::Systems::PassiveRegen.clear_triggers(@component_manager, :is_set, :health) 
+```
+
+### Redefinition
+
+If we wanted to change what code or logic a given System executes, we could do that with:
+
+```ruby
+FelFlame::Systems::PassiveRegen.redefine do
+  # Some new logic or code
+end
+```
+
+## Scenes
+
+### Creation
+Once we have all the core parts of ECS, we will want to organize our Systems. To do this we will use Scenes to group up Systems so they can quickly be enabled or disabled. Note that [Alternative Executions](#alternative-execution) will occur even if they are not part of a Scene. Here is how we make a new Scene:
+
+```ruby
+@scene = FelFlame::Scenes.new('ExampleScene')
+```
+
+### Accessing
+Just like other classes in FelFlame, the name we gave the Scene is how we access it:
+
+```ruby
+@scene = FelFlame::Scenes::ExampleScene
+```
+
+### Adding Systems
+Adding Systems is simple. We can add as many as we want. In this example we add 3 different systems:
+
+```ruby
+FelFlame::Scenes::ExampleScene.add(FelFlame::Systems::Render, @system2, @system3)
+```
+
+### Removing Systems
+Removing Systems works simularly:
+
+```ruby
+FelFlame::Scenes::ExampleScene.remove(FelFlame::Systems::Render, @system2, @system3)
+```
+
+### Clearing
+If you want to remove all Systems from a Scene here is how we do it:
+
+```ruby
+@scene.clear
+```
+
+### Execution
+To execute all Systems within a scene once we can just do:
+
+```ruby
+@scene.call
+```
+
+The Scene will make sure that the systems are executed in the correct order based on their given priorities
+
+## Stage
+
+### Adding Scenes
+Finally we have the Stage. There is only a single Stage and we do not have to create it as it exists by default. By adding a Scene to the Stage we are saying that the Scene is active. To add a Scene we do the following:
+
+```ruby
+FelFlame::Stage.add FelFlame::Scene::ExampleScene
+```
+
+### Removing Scenes
+Likewise we can remove Scenes:
+
+```ruby
+FelFlame::Stage.remove FelFlame::Scene::ExampleScene
+```
+
+### Executing
+On each frame of the game we want to execute the Stage once. When the Stage is executed it is progressing your game 1 frame forward. The Stage will make sure for you that all the Systems from all Scenes added will be executed in the correct order according to their priority. Here is how we do it:
+
+```ruby
+FelFlame::Stage.call
+```
+
+## Closing Notes
+
+There are some methods I haven't gone over in the overview. If you want to see everything and read in more detail check out the [Documentation](https://felflame.tradam.fyi)!
+
+# Contribution
+Contributors are welcome! I am always looking to impove the capabilities of game development in Ruby. Feel free to open an issue to discuss a proposed changed or fix. To code a change or fix first fork the project. Next write your changes or fixes. Make sure all your changes and fixes are properly documented using Yard(I will not merge if it is not 100% documented) and make sure everything has tests written for it with Rspec(I will also not merge if it does not have 100% test coverage). Once you have your changes made then simply make a pull request.  
+
+If you need help writing documentation or tests feel free to ask!  
+
+If you want to contribute to development with a thanks you can always [buy me a coffee ;^)](https://ko-fi.com/tradam)