pgp-rb 0.2.1-x86_64-linux → 0.2.2-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0163bb8c9f1bc617a9f5a4710acb8881eb8630034e2097ed0d52d95c177783b3
-  data.tar.gz: 1570b8523b633d371180f1170ef0673dda37311026df404ba53fab7641070429
+  metadata.gz: f152c37e3d96b85ce6ffa1cbf4857e09d2ae4f6ea8b53a09d743502b3a399334
+  data.tar.gz: 5a979e0ccd0d4ba4f6e753905926cd700d1dd8454c4891769b6e6bcd8798d32c
 SHA512:
-  metadata.gz: 793ee98ee141f96d716d295ff377a0f968fb989cee1d5c6ee1462217be0f653b4a3c49ca20441e9286b574909044822f04d082c4df25f56bbdb9c5312a3d029e
-  data.tar.gz: b4ed21d4bb1f49375f373f3bb3177c8065eff63d75a9d3b3d67f796f104f75faf8f2db497ffb87089beb77d1238dac050226e30b272d4e25c282f0e9cb042a95
+  metadata.gz: 66dc75b7916765c43908100ae012d5c33b8607a727f1b6c58c01c2b9837d0842a3bd5d52f91c5bb48796242351dca7b5f79b199278786363ecb09ef3adc6cf6c
+  data.tar.gz: 3b955a6d0a66d7bd0511b945577b2e3bb6273118ef2a444b5486b86bb6e456aa1f0d299ce98610b03f7a0fcd7eb78e5c04ac1f8b9bcb281de4b699c5456edf76

data/lib/pgp-rb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PGP
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

data/lib/pgp.rb

@@ -52,6 +52,26 @@ module PGP
   ENCRIPTION_ALGORITHM_CAMELLIA_192 = 12
   ENCRIPTION_ALGORITHM_CAMELLIA_256 = 13
 
+  HASH_ALGORITHM_MD5 = 1
+  HASH_ALGORITHM_SHA1 = 2
+  HASH_ALGORITHM_SHA256 = 8
+  HASH_ALGORITHM_SHA384 = 9
+  HASH_ALGORITHM_SHA512 = 10
+  HASH_ALGORITHM_SHA224 = 11
+  HASH_ALGORITHM_SHA3_256 = 12
+  HASH_ALGORITHM_SHA3_512 = 14
+
+  HASH_ALGORITHM_NAMES = {
+    HASH_ALGORITHM_MD5 => 'MD5',
+    HASH_ALGORITHM_SHA1 => 'SHA1',
+    HASH_ALGORITHM_SHA256 => 'SHA256',
+    HASH_ALGORITHM_SHA384 => 'SHA384',
+    HASH_ALGORITHM_SHA512 => 'SHA512',
+    HASH_ALGORITHM_SHA224 => 'SHA224',
+    HASH_ALGORITHM_SHA3_256 => 'SHA3-256',
+    HASH_ALGORITHM_SHA3_512 => 'SHA3-512'
+  }.freeze
+
   # Public Key class provides an native extension representation for working with PGP public keys.
   class PublicKey
     private_class_method :new
@@ -123,4 +143,73 @@ module PGP
       encrypt_with_algorithm(data, algorithm)
     end
   end
+
+  # Private Key class provides an native extension representation for working with PGP private keys.
+  class PrivateKey
+    private_class_method :new
+
+    # @!method self.parse
+    #   Parses a PGP private key from a given string input.
+    #   @param input [String] the PGP private key in string format.
+    #   @return [PrivateKey] an instance of PrivateKey if parsing is successful.
+
+    # @!method fingerprint
+    #   Returns the fingerprint of the private key.
+    #   @return [String] the fingerprint of the private key.
+
+    # @!method algorithm
+    #   Returns the algorithm used by the private key.
+    #   @return [Integer] the algorithm identifier.
+
+    # @!method signing_supported?
+    #   Checks if the private key supports signing.
+    #   @return [Boolean] true if the key supports signing, false otherwise.
+
+    # @!method encryption_supported?
+    #   Checks if the private key supports encryption.
+    #   @return [Boolean] true if the key supports encryption, false otherwise.
+
+    # @!method version
+    #   Returns the version of the private key.
+    #   @return [Integer] the version of the private key.
+
+    # @!method created_at
+    #   Returns the creation time of the private key.
+    #   @return [Time] the creation time of the private key.
+
+    # @!method expires_at
+    #   Returns the expiration time of the private key, if any.
+    #   @return [Time, nil] the expiration time of the private key or nil if it does not expire.
+
+    # @!method sign_with_algorithm(input, algorithm)
+    #   Signs data with the specified hash algorithm.
+    #   @param input [String] the data to be signed.
+    #   @param algorithm [Integer] the hash algorithm identifier.
+    #   @return [String] the signed data encoded by base64.
+
+    # @!method sign(input)
+    #   Signs data with the default hash algorithm (SHA256).
+    #   @param input [String] the data to be signed.
+    #   @return [String] the signed data encoded by base64.
+
+    # Returns a string representation of the PrivateKey object, including its fingerprint, algorithm name, and version.
+    # @return [String] the string representation of the PrivateKey object.
+    def inspect
+      "#<#{self.class} #{fingerprint} #{algorithm_name} v#{version}>"
+    end
+
+    # Fetches the name of the algorithm used by the private key from a predefined list of names.
+    # @return [String] the name of the algorithm.
+    def algorithm_name
+      KEY_ALGORITHM_NAMES.fetch(algorithm, 'Unknown')
+    end
+
+    # Checks whether the private key has expired.
+    # @return [Boolean] true if the key has expired, false otherwise.
+    def expired?
+      return false if expires_at.nil?
+
+      expires_at.to_i <= Time.now.to_i
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pgp-rb
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: x86_64-linux
 authors:
 - Kirill Zaitsev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-30 00:00:00.000000000 Z
+date: 2026-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry