Dogeku 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7b19e310a2440b17d8bb566bb11320cc68d21eb9
+  data.tar.gz: f6859d3e8ce4573a24ea88e89cd682f5c4b493d7
+SHA512:
+  metadata.gz: 79d958c04e6be14586b8a667b811876f6846a71dc16e41cfd58ef3f228a35a300fc286a201fb048d690b7358d3c97063f8b41e6f185371ce4f85e82374a88a8c
+  data.tar.gz: 837523155b97e2a1c38657125ade068dea39d4c9972a39ce6403b6d325b64bccce2b3ddde803082ea1914b8686602e056bf5a5ec8e3c8ec7fbcff2c2e84878eb

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 
+
+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.md

@@ -0,0 +1,39 @@
+[![Build Status](https://travis-ci.org/DanAurea/Sudoku-L3S6.svg?branch=master)](https://travis-ci.org/DanAurea/Sudoku-L3S6) 
+[![Issue Count](https://codeclimate.com/github/DanAurea/Sudoku-L3S6/badges/issue_count.svg)](https://codeclimate.com/github/DanAurea/Sudoku-L3S6)
+[![Code Climate](https://codeclimate.com/github/DanAurea/Sudoku-L3S6/badges/gpa.svg)](https://codeclimate.com/github/DanAurea/Sudoku-L3S6)
+[![Inline docs](http://inch-ci.org/github/DanAurea/Sudoku-L3S6.svg?branch=master)](http://inch-ci.org/github/DanAurea/Sudoku-L3S6)
+
+# Introduction
+## Présentation
+Sudoku-L3S6 est un projet d'une application ayant pour but d'élaborer un assistant à la résolution d'un Sudoku, le projet s'inscrivant dans le module de Génie Logiciel dispensé à l'Université du Maine en fin de semestre de licence 3 de Sciences Pour l'Ingénieur.
+
+Ce Sudoku représente notre application de l'ensemble des connaissances étudiées au cours de cette année. Cela va de la gestion de projet (répartition des rôles, rédaction de cahier des charges et de conception, gestion d'un dépôt Github) à sa modélisation (programmation orientée objet, gestion de base de données) et à son lancement.
+
+Pour jouer, l'utilisateur se connecte via un nom profil qu'il insère au début de l'application. Puis selon ce qu'il souhaite jouer, il peut choisir le mode 'Apprentissage avec aides' ou bien 'Jeu Libre'. Le premier mode permet de mieux cerner le fonctionnement de chaque technique d'aide à la résolution du Sudoku avec des instructions pas à pas tandis que le deuxième mode fait jouer l'utilisateur selon un niveau de difficulté qu'il aura choisi avec des aides qui lui coûteront des points pour le score final. Ce score lui permettra d'ailleurs de se comparer aux autres joueurs pour pouvoir voir sa progression.
+De plus, l'utilisateur peut tout à fait modifier la police ainsi que les couleurs liées aux cases, au texte ou aux indices dans les règlages. S'il ne connaît pas les règles, un rappel lui est donné dans la section appropriée dans le menu principal.
+
+## Composition de l'équipe et rôle
+Cette application a été réalisé par 8 étudiants de l'Université du Maine en utilisant comme langage de programmation Ruby associé à la bibliothèque Gtk. Chaque membre du groupe a un rôle afin d'organiser au mieux le projet :
+* Bodineau Bastien [__Développeur & Testeur unitaires__] 
+* Bussereau Keryann [__Développeur__]
+* Cousin Brandon [__Architecte & Intégrateur__]
+* Duran Alizée [__Documentaliste & Client-type__]
+* Guenver Yann [__Développeur & Testeur intégration__]
+* Jean Marvin [__Chef de projet__]
+* Pavard Valentin [__Développeur GUI & Intégrateur__]
+* Tabot Alexandre [__Développeur & Testeur intégration__]
+
+
+# Installation
+Pour installer l'application rien de plus simple:
+
+> gem install Dogeku
+>
+
+Assurez-vous d'avoir SQLite3 et GTK3 d'installé sur votre machine pour utiliser l'application.
+
+# Exécution
+Pour lancer l'application lancer simplement la commande shell suivante:
+
+> dogeku
+>

data/app/Historique/Action.rb

@@ -0,0 +1,29 @@
+# => Author:: 		keryann
+# => Version:: 		0.1
+# => Copyright:: 	© 2016
+# => License:: 		Distributes under the same terms as Ruby
+
+##
+## Classe Action permettant d'initialiser et afficher une étiquette
+##
+class Action
+	##VI
+	@etiquette
+
+	##
+	## Initialise l'étiquette
+	##
+	## @param 	etiquette 		The etiquette
+	##
+	def initialize(etiquette)
+		@etiquette=etiquette
+	end
+
+	##
+	## Affiche l'étiquette
+	##
+	def faire()
+		print @etiquette
+	end
+
+end

data/app/Historique/ChangerCase.rb

@@ -0,0 +1,44 @@
+# => Author:: 		keryann
+# => Version:: 		0.1
+# => Copyright:: 	© 2016
+# => License:: 		Distributes under the same terms as Ruby
+
+##
+## Classe ChangerCase permettant de faire ou de défaire les actions de l'utilisateur
+##
+
+class ChangerCase < Action
+	##VI
+	@valeur
+	@ancienneValeur
+	@case
+
+
+	## Initialise
+	##
+	## @param 	cas 			Case à initialiser
+	## @param 	entier			Valeur à affecter à la case
+	## 
+	def initialize(cas, entier)
+		@case=cas
+		@valeur=entier
+		@ancienneValeur=nil
+	end
+
+	##
+	## Change la valeur de la case
+	##
+	def faire()
+		@ancienneValeur=@case.get
+		@case.set(@valeur)
+
+	end
+
+	##
+	## Défait le changement
+	##
+	def defaire()
+		@ancienneValeur=@valeur
+		@case.set(@ancienneValeur)
+	end
+end

data/app/Historique/HistoriqueAction.rb

@@ -0,0 +1,114 @@
+load "Action.rb"
+
+## => Author:: 		keryann
+## => version:: 	0.1
+## => copyright:: 	© 2016
+## => license:: 	Distributes under the same terms as Ruby
+
+##
+## Classe pour l'historique des actions.
+##--
+## Regarder slice-1 pour enlever bas de la pile
+##++
+class HistoriqueAction
+	##VI
+	@pileRefaire
+	@pileDefaire
+	@maxActions
+
+	##
+	## Méthode qui effectue une action présente dans la pileDefaire
+	##
+	## @return 	lui-même
+	##
+	def faire()
+		action=@pileDefaire.last()
+		action.faire()
+		return self
+	end
+
+
+	##
+	## Méthode qui annule la dernière action et l'empile dans pileRefaire
+	##
+	## @return lui-même
+	##
+	def defaire()
+		@pileRefaire.push(@pileDefaire.pop())
+		action=@pileDefaire.last()
+		action.faire()
+		return self
+	end
+
+
+	##
+	## Méthode qui permet de refaire une action qu'on a annulé
+	##
+	## @return 	lui-même
+	##
+	def refaire()
+		@pileDefaire.push(@pileRefaire.pop())
+		action=@pileDefaire.last()
+		action.faire()
+		return self
+	end
+
+
+	##
+	## Fonction d'initialisation
+	##
+	def initialize()
+		@pileRefaire=[]
+		@pileDefaire=[]
+		@maxActions=10
+	end
+
+
+	##
+	## Ajoute une nouvelle fonction dans la pileDefaire
+	##
+	## @param 	action 			L'action à ajouter
+	##
+	## @return 	lui-même
+	##
+	def nouvelleAction(action)
+		@pileDefaire.push(action)
+		return self
+	end
+
+	##
+	## Défait une action
+	##
+	## @return 	L'action dépilée
+	##
+	def defaireAction()
+		action=@pileDefaire.pop
+		@pileRefaire.push(action)
+		return action
+	end
+
+
+	##
+	## Fonction de test   
+	##
+	def HistoriqueAction.Test()
+		histo=HistoriqueAction.new()
+		act1=Action.new("Premiere action")
+		act2=Action.new("Deuxieme action")
+		#act3=Action.new("Troisieme action")
+		#act4=Action.new("Quatrieme action")
+		#act5=Action.new("Cinquieme action")
+		histo.nouvelleAction(act1)
+		histo.nouvelleAction(act2)
+		#histo.nouvelleAction(act3)
+		#histo.nouvelleAction(act4)
+		#histo.nouvelleAction(act5)
+		histo.faire()
+		print("\n")
+		histo.defaire()
+		print("\n")
+		histo.refaire()
+	end
+end
+
+HistoriqueAction.Test()

data/app/components/CaseDessin.rb

@@ -0,0 +1,325 @@
+require "observer"
+require Core::ROOT + "model/Configuration.rb"
+
+## => Author::      DanAurea
+## => version::     0.1
+## => copyright::   © 2016
+## => license::     Distributes under the same terms as Ruby
+
+##
+## Classe permettant de dessiner les cases d'une grille de Sudoku 
+##
+class CaseDessin < Gtk::DrawingArea
+    include Observable
+
+    attr_accessor :x, :y, :size, :nombre, :editable, :indices, :indice, :state
+
+    ##
+    ## Initialisation
+    ##
+    def initialize valeur, config
+
+        super()
+        
+        @x = 0
+        @y = 0
+
+        @nombre   = valeur["value"]
+        @editable = valeur["editable"]
+        @state    = ""
+
+        @indices  = {"1" => false, "2" => false, "3" => false, "4" => false, "5" => false, "6" => false, "7" => false, "8" => false, "9" => false}
+        @indice   = false
+
+        config = config
+        @configurationModel = Configuration.instance()
+
+        @police        = config["police"]
+        @taillePolice  = config["taillePolice"]
+        @tailleIndices = @taillePolice / 2
+
+        # Prend en compte la configuration utilisateur
+        @couleurCase       = @configurationModel.creerCouleur(config["caseBase"])
+        @couleurCaseFixe   = @configurationModel.creerCouleur(config["caseFixe"])
+        @couleurIndices    = @configurationModel.creerCouleur(config["couleurIndices"])
+        @couleurPolice     = @configurationModel.creerCouleur(config["couleurTexte"])
+        @couleurSurlignee  = @configurationModel.creerCouleur(config["caseSelectionne"])
+
+        ## Crée la zone de dessin au signal draw
+        signal_connect "draw" do  |_, cr|
+            dessiner cr
+        end
+
+        if(@editable == true)
+            ## Ajoute les évènements de survol et de clics
+            add_events(Gdk::EventMask::ENTER_NOTIFY_MASK)
+            add_events(Gdk::EventMask::BUTTON_PRESS_MASK)
+            add_events(Gdk::EventMask::LEAVE_NOTIFY_MASK)
+
+            ## Lie un callback sur la souris
+            signal_connect "button_press_event" do |_, evenement|
+                focused evenement
+            end
+
+            ## Lie un callback sur l'entrée du curseur dans la zone
+            signal_connect "enter_notify_event" do 
+                hover 
+            end
+
+            ## Lie un callback sur la sortie du curseur de la zone
+            signal_connect "leave_notify_event" do 
+                leave
+            end
+
+        end
+
+    end
+
+    ##
+    ## Réinitialise les indices de la cases
+    ##
+    def resetIndices
+        @indices = {"1" => false, "2" => false, "3" => false, "4" => false, "5" => false, "6" => false, "7" => false, "8" => false, "9" => false}
+    end
+
+    ##
+    ## Callback sur l'appui sur la souris (évènement ajouté à la main)
+    ##
+    ## @return  self
+    ##
+    def focused evenement
+        changed
+
+        ## Clic gauche
+        if evenement.button == 1
+            @state = "clicked"
+        end
+
+        notify_observers(@x, @y, @state)
+        
+        return self
+    end
+
+
+    ##
+    ## Action lors du survol de la case
+    ##
+    ## @return     self
+    ##
+    def hover
+        changed
+        
+        @state = "hover"
+
+        notify_observers(@x, @y, @state)
+
+        return self
+    end
+
+    ##
+    ## Définit l'état
+    ##
+    def set_state=(etat)
+        if(@state != "equal")
+            @state = etat
+        end
+    end
+
+    ##
+    ## Action lors de la sortie du curseur de la case
+    ##
+    ## @return     self
+    ##
+    def leave
+        changed
+
+        @state = "leave"
+
+        notify_observers(@x, @y, @state)
+
+        return self
+    end
+   
+    ##
+    ## Edite la couleur de la case
+    ## 
+    ## @param   cr      case
+    ## 
+    ## @return  self
+    ## 
+    def couleurCase cr
+        if(@editable && @state != "focus" && @state != "hover")
+            cr.set_source_color @couleurCase
+        elsif(@state == "focus" || @state == "hover")
+            cr.set_source_color @couleurSurlignee
+        elsif(@state == "equal")
+            coeff = 0.7
+            rouge, vert, bleu  = @couleurSurlignee.red * coeff, @couleurSurlignee.green * coeff, @couleurSurlignee.blue * coeff
+            composantes = [rouge, vert, bleu].join(",")
+
+            cr.set_source_color @configurationModel.creerCouleur(composantes)
+
+        else
+            cr.set_source_color @couleurCaseFixe
+        end
+
+        return self
+    end
+
+    ##
+    ## Définit la couleur de la police dans la case
+    ## 
+    ## @param cr    case
+    ##
+    ## @return self
+    ##
+    def couleurPolice cr
+        if((@indice == false || !@editable || @nombre != nil)) 
+            cr.set_source_color @couleurPolice
+        else
+            cr.set_source_color @couleurIndices
+        end
+
+        return self
+    end
+
+    ##
+    ## Redessine la case avec les nouvelles valeurs si modifiées
+    ## 
+    def redessiner()
+        self.queue_draw
+    end
+
+    ##
+    ## Dessine une case
+    ## 
+    ## @param   cr  case à dessiner
+    ## 
+    ## @return  self
+    ##
+    def dessiner cr
+
+        ## On définit la taille comme 1/12 de la fenêtre pour garder de l'espace
+        ## pour les boutons
+        @size = Fenetre::fenetre.size[1] / 12
+
+        ## Définit la largeur et la hauteur de la case (obligatoire pour gestion des évènements)
+        set_size_request(@size, @size )
+
+        ## Définit la couleur pour le dessin en fonction du type de case
+        self.couleurCase cr
+
+        ## Dessine un rectangle
+        cr.rectangle 0, 0, @size, @size
+        cr.fill
+
+        ## Définit la couleur du texte
+        self.couleurPolice cr
+
+        if(@indice == false || !@editable || @nombre != nil)
+            dessinerChiffre cr
+        else
+            dessinerIndices cr
+        end
+
+        dessinerContour cr
+
+        cr.stroke
+
+        return self
+
+    end
+
+
+    ##
+    ## Dessine le contour de la case
+    ##
+    ## @param   cr      case
+    ##
+    def dessinerContour cr
+        cr.set_source_rgb 0, 0, 0
+
+        cr.move_to 0 , 0
+
+        cr.set_line_width 0.5
+
+        ## Calcule le chemin du contour de la case
+        cr.rel_line_to @size, 0
+        cr.rel_line_to 0, @size
+        cr.rel_line_to -@size, 0
+        cr.rel_line_to 0, -@size
+        cr.stroke
+
+        cr.set_line_width 7
+
+        ## Bordure exétieure haut
+        if(@x == 0)
+            cr.move_to 0, 0
+            cr.line_to @size, 0
+            cr.stroke
+        end
+
+        ## Bordure extérieur gauche
+        if(@y == 0)
+            cr.move_to 0, 0
+            cr.line_to 0, @size
+            cr.stroke
+        end
+
+        ## Bordure bas
+        if(@x == 8 || @x % 3 == 2)
+            cr.move_to 0, @size
+            cr.line_to @size, @size
+            cr.stroke
+        end
+
+        ## Bordure droite
+        if(@y == 8 || @y % 3 == 2)
+            cr.move_to @size, 0
+            cr.rel_line_to 0, @size
+            cr.stroke
+        end
+
+    end
+
+    ##
+    ## Dessine le chiffre
+    ##
+    def dessinerChiffre cr
+        ## Définis les caractéristiques du texte
+        cr.select_font_face @police, 
+            Cairo::FONT_SLANT_NORMAL, Cairo::FONT_WEIGHT_NORMAL
+        cr.set_font_size @taillePolice
+
+        extents = cr.text_extents @nombre.to_s
+        cr.move_to @size / 2 - extents.width / 2,  @size / 2 + extents.height / 2 
+        ## Déplace le curseur de texte au centre de la case
+        cr.show_text @nombre.to_s
+    end
+
+    ##
+    ## Dessine les indices
+    ##
+    def dessinerIndices cr        
+        cr.set_font_size @tailleIndices
+
+        col = 1
+        lig = 1
+        @indices.each do | key, value|
+            
+            if(value == true)
+                extents = cr.text_extents key
+                cr.move_to (col * @size / 4) - extents.width / 2 , (lig * @size / 4).floor + (extents.height / 2).floor
+                ## Déplace le curseur de texte au centre de la case
+                cr.show_text key
+            end
+
+            if key.to_i % 3 == 0
+                lig += 1
+                col = 0
+            end
+            col += 1
+        end
+    end
+
+end