logicuit 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dad7e6a6e7b924c46183e5ef4bfc6e4647fee1d8bc64b10792569664a6c4b80
-  data.tar.gz: a5c316448fc8b3019488131b53ad8115e11da5151fddc6f1d40d821f2b9862b8
+  metadata.gz: 26c6eb8e9b1845c097a5e64604ca2c71632c8d0f98f19e0df1d642e57ad6ee7a
+  data.tar.gz: 9e470fdd05e968fd46829a2df9a57015f40cd9460a2cef769e210d1e720c9144
 SHA512:
-  metadata.gz: e5b4c0ea5bf5922c99a6ed7ee0d1a0eafe388c481bd1c54995645f01498adb9979c8967e1f70bcbbc7327b9c6ed2b43bd06fef326b25b73bd24beca3705a0fcc
-  data.tar.gz: f37bec9789e8292558fd8cf58d4aa29a1765ba6d82826315afe1f4d11a24d2bb99d92ba88bdd52f52ff0e74c160ca552ebc99067f7c20151c127f7f756eee593
+  metadata.gz: beb747fa8ea167b01d3a765564f1ffcf546072afe315e8c8a9bb37601409204b002011d68a737302090e5f2808c54e75fa80de87ea4d02e66037d2c2a8792b74
+  data.tar.gz: dc144486811fc58d4ba1cda48f6fce95ed7776e7b3b059950388d3e41d8459c90e3d4500c4e0b97e9d9158654952fc1041e801c24a9b13c690f8d7c238bb5647

data/.rubocop.yml

@@ -1,8 +1,13 @@
 AllCops:
   TargetRubyVersion: 3.1
+  NewCops: disable
 
 Style/StringLiterals:
   EnforcedStyle: double_quotes
 
 Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
+
+require:
+  - rubocop-minitest
+  - rubocop-rake

data/README.md

@@ -19,14 +19,44 @@ gem install logicuit
 ## Usage
 
 ```
-Logicuit::And.new(1, 1).signal # [1]
-Logicuit::And.new(1, 0).signal # [0]
-Logicuit::And.new(0, 1).signal # [0]
-Logicuit::And.new(0, 0).signal # [0]
+require "logicuit"
+
+# 1 bit CPU
+#
+#  +-(Y)-|NOT|-(A)-+
+#  |               |
+#  +-(D)-|   |-(Q)-+
+#        |DFF|
+#   (CK)-|>  |
+#
+class OneBitCpu
+  def initialize
+    @dff = Logicuit::Circuits::Sequential::DFlipFlop.new
+    @not = Logicuit::Gates::Not.new
+    @dff.q >> @not.a
+    @not.y >> @dff.d
+  end
+
+  def to_s
+    <<~CIRCUIT
+      +-(#{@not.y})-|NOT|-(#{@not.a})-+
+      |               |
+      +-(#{@dff.d})-|   |-(#{@dff.q})-+
+            |DFF|
+       (CK)-|>  |
+    CIRCUIT
+  end
+end
+
+obc = OneBitCpu.new
+loop do
+  system("clear")
+  puts obc
+  sleep 1
+  Logicuit::Signals::Clock.tick
+end
 ```
 
-This is all for now :)
-
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/logicuit/circuits/combinational/half_adder.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+# TODO: implement the HalfAdder class

data/lib/logicuit/circuits/sequential/d_flip_flop.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Logicuit
+  module Circuits
+    module Sequential
+      # D Flip-Flop
+      #
+      # (D)--|   |--(Q)
+      #      |DFF|
+      # (CK)-|>  |
+      #
+      class DFlipFlop
+        def initialize(d = 0) # rubocop:disable Naming/MethodParameterName
+          Signals::Clock.on_tick << self
+
+          @d = d.is_a?(Signals::Signal) ? d : Signals::Signal.new(d == 1)
+
+          @q = Signals::Signal.new(false)
+          evaluate
+        end
+
+        attr_reader :d, :q
+
+        def evaluate
+          if d.current
+            q.on
+          else
+            q.off
+          end
+        end
+
+        def to_s
+          <<~CIRCUIT
+            (#{d})--|   |--(#{q})
+                 |DFF|
+            (CK)-|>  |
+          CIRCUIT
+        end
+      end
+    end
+  end
+end

data/lib/logicuit/circuits/system_level/one_bit_cpu.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Logicuit
+  module Circuits
+    module SystemLevel
+      # 1 bit CPU
+      #
+      #  +-(Y)-|NOT|-(A)-+
+      #  |               |
+      #  +-(D)-|   |-(Q)-+
+      #        |DFF|
+      #   (CK)-|>  |
+      #
+      class OneBitCpu
+        def initialize
+          @dff = Sequential::DFlipFlop.new
+          @not = Gates::Not.new
+          @dff.q >> @not.a
+          @not.y >> @dff.d
+        end
+
+        def to_s
+          <<~CIRCUIT
+            +-(#{@not.y})-|NOT|-(#{@not.a})-+
+            |               |
+            +-(#{@dff.d})-|   |-(#{@dff.q})-+
+                  |DFF|
+             (CK)-|>  |
+          CIRCUIT
+        end
+
+        def self.run
+          obc = new
+          loop do
+            system("clear")
+            puts obc
+            sleep 1
+            Signals::Clock.tick
+          end
+        end
+      end
+    end
+  end
+end

data/lib/logicuit/gates/and.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Logicuit
+  module Gates
+    # AND gate
+    #
+    # (A)-|
+    #     |AND|-(Y)
+    # (B)-|
+    #
+    class And
+      def initialize(a = 0, b = 0) # rubocop:disable Naming/MethodParameterName
+        @a = Signals::Signal.new(a == 1)
+        @a.on_change << self
+
+        @b = Signals::Signal.new(b == 1)
+        @b.on_change << self
+
+        @y = Signals::Signal.new(false)
+        evaluate
+      end
+
+      attr_reader :a, :b, :y
+
+      def evaluate
+        a.current && b.current ? y.on : y.off
+      end
+
+      def to_s
+        <<~CIRCUIT
+          (#{a})-|
+              |AND|-(#{y})
+          (#{b})-|
+        CIRCUIT
+      end
+    end
+  end
+end

data/lib/logicuit/gates/not.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Logicuit
+  module Gates
+    # NOT gate
+    #
+    # (A)-|NOT|-(Y)
+    #
+    class Not
+      def initialize(a = 0) # rubocop:disable Naming/MethodParameterName
+        @a = Signals::Signal.new(a == 1)
+        @a.on_change << self
+
+        @y = Signals::Signal.new(false)
+        evaluate
+      end
+
+      attr_reader :a, :y
+
+      def evaluate
+        a.current ? y.off : y.on
+      end
+
+      def to_s
+        <<~CIRCUIT
+          (#{a})-|NOT|-(#{y})
+        CIRCUIT
+      end
+    end
+  end
+end

data/lib/logicuit/gates/or.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Logicuit
+  module Gates
+    # OR gate
+    #
+    # (A)-|
+    #     |OR|-(Y)
+    # (B)-|
+    #
+    class Or
+      def initialize(a = 0, b = 0) # rubocop:disable Naming/MethodParameterName
+        @a = Signals::Signal.new(a == 1)
+        @a.on_change << self
+
+        @b = Signals::Signal.new(b == 1)
+        @b.on_change << self
+
+        @y = Signals::Signal.new(false)
+        evaluate
+      end
+
+      attr_reader :a, :b, :y
+
+      def evaluate
+        a.current || b.current ? y.on : y.off
+      end
+
+      def to_s
+        <<~CIRCUIT
+          (#{a})-|
+              |OR|-(#{y})
+          (#{b})-|
+        CIRCUIT
+      end
+    end
+  end
+end

data/lib/logicuit/signals/clock.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Logicuit
+  module Signals
+    # Clock
+    class Clock
+      def initialize
+        @on_tick = []
+      end
+
+      attr_reader :on_tick
+
+      def tick
+        @on_tick.each(&:evaluate)
+      end
+
+      def self.instance
+        @instance ||= new
+      end
+
+      def self.on_tick
+        instance.on_tick
+      end
+
+      def self.tick
+        instance.tick
+      end
+    end
+  end
+end

data/lib/logicuit/signals/signal.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Logicuit
+  module Signals
+    # Signal
+    class Signal
+      def initialize(current = false) # rubocop:disable Style/OptionalBooleanParameter
+        @current = current
+        @connected_by = nil
+        @on_change = []
+      end
+
+      attr_reader :current, :on_change
+      attr_accessor :connected_by
+
+      def on
+        changed = @current.!
+        @current = true
+        @on_change.each(&:evaluate) if changed
+      end
+
+      def off
+        changed = @current
+        @current = false
+        @on_change.each(&:evaluate) if changed
+      end
+
+      def toggle
+        @current ? off : on
+      end
+
+      def connects_to(other)
+        other.connected_by = self
+        other.evaluate
+        on_change << other
+      end
+      alias >> connects_to
+
+      def evaluate
+        return if @connected_by.nil?
+
+        @connected_by.current ? on : off
+      end
+
+      def to_s
+        current ? "1" : "0"
+      end
+    end
+  end
+end

data/lib/logicuit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Logicuit
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/logicuit.rb

@@ -1,4 +1,10 @@
 # frozen_string_literal: true
 
 require_relative "logicuit/version"
-require_relative "logicuit/and"
+require_relative "logicuit/gates/and"
+require_relative "logicuit/gates/or"
+require_relative "logicuit/gates/not"
+require_relative "logicuit/signals/signal"
+require_relative "logicuit/signals/clock"
+require_relative "logicuit/circuits/sequential/d_flip_flop"
+require_relative "logicuit/circuits/system_level/one_bit_cpu"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: logicuit
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Koji NAKAMURA
 bindir: exe
 cert_chain: []
-date: 2025-02-05 00:00:00.000000000 Z
+date: 2025-02-26 00:00:00.000000000 Z
 dependencies: []
 description: logi(c cir)cuit -> logicuit
 email:
@@ -21,7 +21,14 @@ files:
 - README.md
 - Rakefile
 - lib/logicuit.rb
-- lib/logicuit/and.rb
+- lib/logicuit/circuits/combinational/half_adder.rb
+- lib/logicuit/circuits/sequential/d_flip_flop.rb
+- lib/logicuit/circuits/system_level/one_bit_cpu.rb
+- lib/logicuit/gates/and.rb
+- lib/logicuit/gates/not.rb
+- lib/logicuit/gates/or.rb
+- lib/logicuit/signals/clock.rb
+- lib/logicuit/signals/signal.rb
 - lib/logicuit/version.rb
 - sig/logicuit.rbs
 homepage: https://github.com/kozy4324/logicuit

data/lib/logicuit/and.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Logicuit
-  # AND circuit
-  class And
-    def initialize(a, b) # rubocop:disable Naming/MethodParameterName
-      @a = a
-      @b = b
-    end
-
-    def signal
-      [@a == 1 && @b == 1 ? 1 : 0]
-    end
-  end
-end