networkx 0.1.0 → 0.2.0

data/lib/networkx/traversals/edge_dfs.rb

@@ -0,0 +1,114 @@
+module NetworkX
+  # Helper function for edge_dfs
+  #
+  # @param graph [Graph, DiGraph, MultiGraph, MultiDiGraph] a graph
+  # @param node [Object] a node in the graph
+  def self.out_edges(graph, node)
+    edges = []
+    visited = {}
+    case graph.class.name
+    when 'NetworkX::Graph', 'NetworkX::DiGraph'
+      graph.adj[node].each do |v, _|
+        if graph.instance_of?(::NetworkX::DiGraph) || visited[[v, node]].nil?
+          visited[[node, v]] = true
+          edges << [node, v]
+        end
+      end
+    else
+      graph.adj[node].each do |v, uv_keys|
+        uv_keys.each_key do |k|
+          if graph.instance_of?(::NetworkX::MultiDiGraph) || visited[[v, node, k]].nil?
+            visited[[node, v, k]] = true
+            edges << [node, v, k]
+          end
+        end
+      end
+    end
+    edges
+  end
+
+  # Helper function of edge_dfs
+  def self.edge_id(graph, edge)
+    return edge if graph.directed?
+    return Set.new([edge, (edge[0..1].reverse << edge[2])]) if graph.multigraph?
+
+    Set.new([edge, edge.reverse])
+  end
+
+  # Performs edge dfs on the graph
+  # Orientation :ignore, directed edges can be
+  #                     travelled in both fashions
+  # Orientation reverse, directed edges can be travelled
+  #                      in reverse fashion
+  # Orientation :nil, the graph is not meddled with
+  #
+  # @example
+  #   NetworkX.edge_dfs(graph, source, 'ignore')
+  #
+  # @param graph [Graph, DiGraph, MultiGraph, MultiDiGraph] a graph
+  # @param start [Object] node to start dfs from
+  # @param orientation [:ignore, :reverse', nil] the orientation of edges of graph
+  def self.edge_dfs(graph, start, orientation = nil)
+    case orientation
+    when :reverse
+      graph = graph.reverse if graph.instance_of?(::NetworkX::DiGraph) || graph.instance_of?(::NetworkX::MultiDiGraph)
+    when :ignore
+      graph = graph.to_undirected if graph.instance_of?(::NetworkX::DiGraph)
+      graph = graph.to_multigraph if graph.instance_of?(::NetworkX::MultiDiGraph)
+    end
+
+    visited_edges = []
+    visited_nodes = []
+    stack = [start]
+    current_edges = {}
+
+    e = Enumerator.new do |yield_var|
+      until stack.empty?
+        current = stack.last
+        unless visited_nodes.include?(current)
+          current_edges[current] = out_edges(graph, current)
+          visited_nodes << current
+        end
+
+        edge = current_edges[current].shift
+        if edge.nil?
+          stack.pop
+        else
+          unless visited_edges.include?(edge_id(graph, edge))
+            visited_edges << edge_id(graph, edge)
+            stack << edge[1]
+            yield_var.yield edge
+          end
+        end
+      end
+    end
+    e.take(graph.number_of_edges)
+  end
+
+  class Graph
+    def dfs_edges(node)
+      each_dfs_edge(node).to_a
+    end
+
+    def each_dfs_edge(node)
+      return enum_for(:each_dfs_edge, node) unless block_given?
+
+      st = [node]
+      used = {}
+      parents = {}
+      while st[-1]
+        node = st.pop
+
+        yield(parents[node], node) if parents[node]
+
+        used[node] = true
+        @adj[node].reverse_each do |v, _data|
+          next if used[v]
+
+          parents[v] = node
+          st << v unless used[v]
+        end
+      end
+    end
+  end
+end

data/lib/networkx/version.rb

@@ -1,3 +1,3 @@
 module NetworkX
-  VERSION = '0.1.0'.freeze
+  VERSION = '0.2.0'.freeze
 end

data/lib/networkx.rb

@@ -1 +1,43 @@
-require 'networkx/version'
+require 'set'
+require 'matrix'
+require 'rb_heap'
+require 'securerandom'
+require_relative 'networkx/version'
+require_relative 'networkx/graph'
+require_relative 'networkx/digraph'
+require_relative 'networkx/multigraph'
+require_relative 'networkx/multidigraph'
+require_relative 'networkx/traversals/bfs'
+require_relative 'networkx/traversals/dfs'
+require_relative 'networkx/traversals/edge_dfs'
+require_relative 'networkx/shortest_path/unweighted'
+require_relative 'networkx/to_matrix'
+require_relative 'networkx/shortest_path/dense'
+require_relative 'networkx/shortest_path/weighted'
+require_relative 'networkx/shortest_path/astar'
+require_relative 'networkx/operators/product'
+require_relative 'networkx/operators/binary'
+require_relative 'networkx/operators/unary'
+require_relative 'networkx/operators/all'
+require_relative 'networkx/flow/utils'
+require_relative 'networkx/flow/edmondskarp'
+require_relative 'networkx/flow/shortestaugmentingpath'
+require_relative 'networkx/flow/capacityscaling'
+require_relative 'networkx/flow/preflowpush'
+require_relative 'networkx/auxillary_functions/cliques'
+require_relative 'networkx/auxillary_functions/dag'
+require_relative 'networkx/auxillary_functions/eccentricity'
+require_relative 'networkx/auxillary_functions/mis'
+require_relative 'networkx/auxillary_functions/mst'
+require_relative 'networkx/auxillary_functions/union_find'
+require_relative 'networkx/auxillary_functions/vitality'
+require_relative 'networkx/auxillary_functions/wiener'
+require_relative 'networkx/auxillary_functions/cycles'
+require_relative 'networkx/link_analysis/hits'
+require_relative 'networkx/link_analysis/pagerank'
+require_relative 'networkx/others/bridges'
+require_relative 'networkx/others/generators'
+require_relative 'networkx/others/grid_2d_graph'
+require_relative 'networkx/others/info'
+require_relative 'networkx/others/number_connected_components'
+require_relative 'networkx/others/reads'

data/networkx.gemspec

@@ -1,4 +1,4 @@
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'networkx/version'
 
@@ -20,16 +20,18 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.15'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'redcarpet'
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rspec-its'
-  spec.add_development_dependency 'rubocop', '>= 0.40.0'
-  spec.add_development_dependency 'rubocop-rspec'
-  spec.add_development_dependency 'rubygems-tasks'
-  spec.add_development_dependency 'saharspec'
-  spec.add_development_dependency 'simplecov'
-  spec.add_development_dependency 'yard'
-  spec.add_development_dependency 'guard-rspec' if RUBY_VERSION >= '2.2.5'
+  spec.add_development_dependency 'rspec-its', '~> 1.0'
+  spec.add_development_dependency 'rubocop', '~> 1.0'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.6'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.0'
+  spec.add_development_dependency 'rubygems-tasks', '~> 0.2'
+  spec.add_development_dependency 'saharspec', '~> 0.0'
+  spec.add_development_dependency 'simplecov', '~> 0.21'
+  spec.add_development_dependency 'yard', '~> 0.9'
+
+  spec.add_runtime_dependency 'matrix', '~> 0.4'
+  spec.add_runtime_dependency 'rb_heap', '~> 1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: networkx
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Athitya Kumar
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-11-14 00:00:00.000000000 Z
+date: 2022-11-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,197 +16,254 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: redcarpet
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rspec-its
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: rspec-its
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.40.0
+        version: '0.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.40.0
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rubygems-tasks
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: saharspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.21'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.21'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
-  name: guard-rspec
+  name: matrix
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: '0.4'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: rb_heap
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: |2
-    A Ruby implemenation of the well-known graph library called "networkx".
+        version: '1.0'
+description: '  A Ruby implemenation of the well-known graph library called "networkx".
+
+  '
 email:
 - athityakumar@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/CODE_OF_CONDUCT.md"
+- ".github/CONTRIBUTING.md"
+- ".github/ISSUE_TEMPLATE.md"
+- ".github/PULL_REQUEST_TEMPLATE.md"
+- ".github/workflows/ci.yml"
+- ".github/workflows/doc.yml"
+- ".github/workflows/gem-push.yml"
 - ".gitignore"
 - ".rspec"
-- ".rspec_formatter.rb"
 - ".rubocop.yml"
-- ".travis.yml"
 - ".yardopts"
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
 - Gemfile
-- Guardfile
 - LICENSE.md
 - README.md
 - Rakefile
 - lib/networkx.rb
+- lib/networkx/auxillary_functions/cliques.rb
+- lib/networkx/auxillary_functions/cycles.rb
+- lib/networkx/auxillary_functions/dag.rb
+- lib/networkx/auxillary_functions/eccentricity.rb
+- lib/networkx/auxillary_functions/mis.rb
+- lib/networkx/auxillary_functions/mst.rb
+- lib/networkx/auxillary_functions/union_find.rb
+- lib/networkx/auxillary_functions/vitality.rb
+- lib/networkx/auxillary_functions/wiener.rb
+- lib/networkx/converters/to_csv.rb
+- lib/networkx/converters/to_json.rb
+- lib/networkx/digraph.rb
+- lib/networkx/flow/capacityscaling.rb
+- lib/networkx/flow/edmondskarp.rb
+- lib/networkx/flow/preflowpush.rb
+- lib/networkx/flow/shortestaugmentingpath.rb
+- lib/networkx/flow/utils.rb
+- lib/networkx/graph.rb
+- lib/networkx/link_analysis/hits.rb
+- lib/networkx/link_analysis/pagerank.rb
+- lib/networkx/multidigraph.rb
+- lib/networkx/multigraph.rb
+- lib/networkx/operators/all.rb
+- lib/networkx/operators/binary.rb
+- lib/networkx/operators/product.rb
+- lib/networkx/operators/unary.rb
+- lib/networkx/others/bridges.rb
+- lib/networkx/others/generators.rb
+- lib/networkx/others/grid_2d_graph.rb
+- lib/networkx/others/info.rb
+- lib/networkx/others/number_connected_components.rb
+- lib/networkx/others/reads.rb
+- lib/networkx/shortest_path/astar.rb
+- lib/networkx/shortest_path/dense.rb
+- lib/networkx/shortest_path/unweighted.rb
+- lib/networkx/shortest_path/weighted.rb
+- lib/networkx/to_matrix.rb
+- lib/networkx/traversals/bfs.rb
+- lib/networkx/traversals/dfs.rb
+- lib/networkx/traversals/edge_dfs.rb
 - lib/networkx/version.rb
 - networkx.gemspec
 homepage: https://github.com/athityakumar/networkx.rb
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -221,9 +278,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.12
-signing_key: 
+rubygems_version: 3.3.3
+signing_key:
 specification_version: 4
 summary: A Ruby implemenation of the well-known graph library called networkx.
 test_files: []

data/.rspec_formatter.rb

@@ -1,24 +0,0 @@
-RSpec::Support.require_rspec_core 'formatters/base_text_formatter'
-
-class SimpleFormatter < RSpec::Core::Formatters::BaseTextFormatter
-  RSpec::Core::Formatters.register self,
-    :example_passed, :example_pending, :example_failed, :dump_pending, :dump_failures, :dump_summary
-
-  def example_passed(message); end
-
-  def example_pending(message); end
-
-  def example_failed(message); end
-
-  def dump_pending(message); end
-
-  def dump_failures(message); end
-
-  def dump_summary(message)
-    colorizer = ::RSpec::Core::Formatters::ConsoleCodes
-
-    output.puts "\nFinished in #{message.formatted_duration} " \
-       "(files took #{message.formatted_load_time} to load)\n" \
-       "#{message.colorized_totals_line(colorizer)}\n"
-  end
-end

data/.travis.yml

@@ -1,18 +0,0 @@
-language:
-  ruby
-
-rvm:
-  - '2.1'
-  - '2.2'
-  - '2.3.0'
-  - '2.4.0'
-
-script:
-  - bundle exec rspec
-  - bundle exec rubocop
-
-install:
-  - gem install bundler
-  - gem install rainbow -v '2.2.1'
-  - sudo apt-get update -qq
-  - bundle install

data/Guardfile

@@ -1,7 +0,0 @@
-guard :rspec, cmd: 'rspec' do
-  watch(%r{^spec/.+_spec\.rb$})
-  watch(%r{^lib/networkx/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
-  watch('spec/spec_helper.rb')   { 'spec' }
-end
-
-# TODO: Run Rubocop in the background