dsl-graph 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 15f6e7b0b4ee9295d215a4756c95a7c917e1f9fc708826fb4df7e815fa05f055
+  data.tar.gz: c0214d18168d4e8e9ba1f1522e0553608cf51d1a9736048aa38f8aab067b22b6
+SHA512:
+  metadata.gz: bf4a00bf704d9ddcbe77021cbeb3c7e138af271e02accd01aa35f6980af32ff393135723ee4695737c99059de3b3d509fd112aeab5fa5de35613ee130478aea6
+  data.tar.gz: 1a10df96eaf114ea84b4f301c6499ac720e974add568fede6d41e4a5d24aee695538172bd0c71a32080f82f2bead02c3604edc8387ad6fba5212a28acd693921

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+## [Unreleased]
+
+## [0.2.0] - 2026-04-21
+
+- Add features: export (pdf, yaml), load (yaml)
+
+## [0.1.0] - 2026-04-19
+
+- Initial release
+- Add features: create, debug

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Vargas
+
+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,17 @@
+# Dsl::Graph
+
+DSL para crear grafos.
+
+## Instalación
+
+* Instalar Ruby
+* Instalar Graphviz: `sudo zypper install graphviz`
+* `gem install dsl-graph`
+
+## Modo de uso
+
+> Consultar los [ejemplos](./examples/)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/dvarrui/dsl-graph.

data/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "standard/rake"
+
+task default: %i[test standard]

data/docs/graphviz-example.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require "graphviz"
+
+#        Jedi
+#    /     |    \
+#  Yoda Obiwan Ankin
+
+# Crear los nodos
+graph = Graphviz::Graph.new("Jedi")
+
+n0 = graph.add_node("Jedi")
+n1 = graph.add_node("Yoda")
+n2 = graph.add_node("Obiwan")
+n3 = graph.add_node("Anakin")
+
+# Conectar los nodos
+e1 = n0.connect(n1)
+e2 = n0.connect(n2)
+e3 = n0.connect(n3)
+
+# Crear pdf
+Graphviz::output(graph, :path => "data/test.pdf")

data/examples/1-create.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+require_relative "../lib/dsl/graph"
+
+puts "==> Create"
+
+graph do
+  n1 = add_node("Obiwan")
+  n2 = add_node("Anakin")
+  n3 = add_node("Yoda")
+
+  add_edge(n1, n2, "maestro_de")
+  add_edge(n3, n1, "maestro_de")
+end
+
+puts "==> Debug"
+graph.debug

data/examples/2-export.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+require_relative "../lib/dsl/graph"
+
+graph do
+  n1 = add_node("Obiwan")
+  n2 = add_node("Anakin")
+  n3 = add_node("Yoda")
+
+  add_edge(n1, n2, "maestro_de")
+  add_edge(n3, n1, "maestro_de")
+end
+
+puts "==> Export"
+
+graph.export("data/2-graph.pdf")
+graph.export("data/2-graph.yaml")

data/examples/3.load.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+require_relative "../lib/dsl/graph"
+
+puts "==> Create"
+
+g1 = graph "demo1" do
+  n1 = add_node("Obiwan")
+  n2 = add_node("Anakin")
+  n3 = add_node("Yoda")
+
+  add_edge(n1, n2, "maestro_de")
+  add_edge(n3, n1, "maestro_de")
+end
+
+g1.debug
+puts "==> Export"
+g1.export("data/3-graph.yaml")
+
+puts "==> Load"
+g2 = graph.load("data/3-graph.yaml")
+g2.label = "demo2"
+g2.debug

data/lib/dsl/graph/edge.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Dsl
+  module Graph
+    class Edge
+      attr_reader :id
+      attr_accessor :from
+      attr_accessor :to
+      attr_accessor :label
+      
+      def initialize(id, from, to, label="")
+        @id = id
+        @from = from
+        @to = to
+        @label = label
+      end
+  
+      def to_s
+        @label
+      end
+    end
+  end
+end
+

data/lib/dsl/graph/export.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+require "graphviz"
+require "yaml"
+  
+module Dsl::Graph
+  class ExportGraph
+    def initialize(graph, filename)
+      @graph = graph
+      @filename = filename
+    end
+
+    def call
+      ext = File.extname(@filename.downcase)
+
+      case ext
+      when ".pdf"
+        export_to_pdf
+      when ".yaml", ".yml"
+        export_to_yaml
+      else
+        warn "[ERROR] Unkown export format: (#{ext})"
+        exit 1
+      end
+    end
+
+    private
+
+    def export_to_pdf
+      graph = @graph
+      filename = @filename
+      viz = Graphviz::Graph.new(graph.label)
+      nodes = {}
+      graph.nodes.each do |k,v|
+        nodes[v.label] = viz.add_node(v.label)
+      end
+
+      graph.edges.each do |k,v|
+        n1 = nodes[v.from.label]
+        n2 = nodes[v.to.label]
+        n1.connect(n2)
+      end
+
+      Graphviz::output(viz, :path => filename)
+    end
+
+    def export_to_yaml
+      data = {
+        "graph" => {
+          "label" => @graph.label,
+          "nodes" => @graph.nodes.values.map { |n| { "label" => n.label } },
+          "edges" => @graph.edges.values.map do |e|
+            {
+              "from" => e.from.label,
+              "label" => e.label,
+              "to" => e.to.label
+            }
+          end
+        }
+      }
+  
+      File.write(@filename, data.to_yaml)
+    end
+  end
+end

data/lib/dsl/graph/graph.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require_relative "edge"
+require_relative "export"
+require_relative "load"
+require_relative "node"
+
+module Dsl
+  module Graph
+    class Graph
+      attr_accessor :label
+      attr_reader :nodes
+      attr_reader :edges
+
+      def initialize(label="graph")
+        @label = label
+        @next = { node: 0, edge: 0}
+        @nodes = {}
+        @edges = {}
+      end
+
+      def add_node(label)
+        id = (@next[:node] += 1)
+        node = Node.new(id, label)
+        @nodes[id] = node
+        node
+      end
+
+      def add_edge(node1, node2, label)
+        id = (@next[:edge] += 1)
+        edge = Edge.new(id, node1, node2, label)
+        @edges[id] = edge
+        edge
+      end
+
+      def debug
+        puts "graph: #{@label}"
+        puts "> nodes (#{@nodes.size})"
+        @nodes.each do |id, node|
+          puts "  - node(#{node.id}): #{node} "
+        end
+        puts "> edges (#{@edges.size})"
+        @edges.each do |id, edge| 
+          puts "  - edge(#{edge.id}): #{edge.from} --(#{edge})--> #{edge.to}"
+        end
+      end
+
+      def export(filename=nil)
+        if filename.nil?
+          filename = "#{graph.label}.yaml"
+          filename = "graph.yaml" if graph.label.nil? || graph.label.empty?
+        end
+        ExportGraph.new(self, filename).call
+      end
+
+      def load(filename=nil)
+        if filename.nil?
+          filename = "#{graph.label}.yaml"
+          filename = "graph.yaml" if graph.label.nil? || graph.label.empty?
+        end
+        LoadGraph.new(filename).call
+      end
+
+      def run(&block)
+        instance_eval(&block) 
+        self
+      end
+    end
+  end
+end

data/lib/dsl/graph/load.rb

@@ -0,0 +1,34 @@
+
+# frozen_string_literal: true
+
+require "yaml"
+
+module Dsl::Graph
+  class LoadGraph
+    def initialize(filename)
+      @filename = filename
+    end
+
+    def call
+      data = YAML.load_file(@filename)
+      graph_data = data["graph"]
+
+      graph = Graph.new(graph_data["label"])
+      nodes_by_label = {}
+
+      graph_data["nodes"].each do |node_data|
+        label = node_data["label"]
+        nodes_by_label[label] = graph.add_node(label)
+      end
+
+      graph_data["edges"].each do |edge_data|
+        from_node = nodes_by_label[edge_data["from"]]
+        to_node   = nodes_by_label[edge_data["to"]]
+        label     = edge_data["label"]
+        graph.add_edge(from_node, to_node, label)
+      end
+
+      graph
+    end
+  end
+end

data/lib/dsl/graph/node.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Dsl::Graph
+  class Node
+    attr_reader :id
+    attr_accessor :label
+    
+    def initialize(id, label)
+      @id = id
+      @label = label
+    end
+
+    def to_s
+      @label
+    end
+  end    
+end
+

data/lib/dsl/graph/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Dsl
+  module Graph
+    VERSION = "0.2.0"
+  end
+end

data/lib/dsl/graph.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "graph/graph"
+require_relative "graph/version"
+require "debug"
+
+def graph(label=nil, &block)
+  $GRAPH ||= Dsl::Graph::Graph.new(label)
+  return $GRAPH if block.nil?
+
+  $GRAPH.run(&block)
+  $GRAPH
+end

data/sig/dsl/graph.rbs

@@ -0,0 +1,6 @@
+module Dsl
+  module Graph
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: dsl-graph
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- David Vargas Ruiz
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: graphviz
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: DSL para crear grafos.
+email:
+- dvarrui@proton.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- data/.gitkeep
+- docs/graphviz-example.rb
+- examples/1-create.rb
+- examples/2-export.rb
+- examples/3.load.rb
+- lib/dsl/graph.rb
+- lib/dsl/graph/edge.rb
+- lib/dsl/graph/export.rb
+- lib/dsl/graph/graph.rb
+- lib/dsl/graph/load.rb
+- lib/dsl/graph/node.rb
+- lib/dsl/graph/version.rb
+- sig/dsl/graph.rbs
+homepage: https://github.com/dvarrui/dsl-graph
+licenses: []
+metadata:
+  homepage_uri: https://github.com/dvarrui/dsl-graph
+  source_code_uri: https://github.com/dvarrui/dsl-graph
+  changelog_uri: https://github.com/dvarrui/dsl-graph/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: DSL para crear grafos.
+test_files: []