sucharyruby 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9663196acab2c9f57826c543809e4647c5bf6a289e25c3b5992bde463a19e40f
-  data.tar.gz: fb21ddae8fffd21afa363eaae47dd05f87b9dd8508aab3818c2f9cc6dc9b490f
+  metadata.gz: a4f6a70f04bd57e8a4569c0bee784ccea800de1bc4000833aa3caaee100e850b
+  data.tar.gz: '04329a6c1138dcdb1763a57f60adc36827f93cf63a0517b799d7fba0dae78b10'
 SHA512:
-  metadata.gz: eb44365a90ebc3c6c3ef55a2f29f9f6a7aed9aab1e57d3fe5fa5a2eb0f87a430fa1e8f6d54929f5989730c9bb90ec5486c0bc162b3de0b71484aa75990db13f1
-  data.tar.gz: b32e8002226d10c301e560388a8091a7f654e03882756b42103807b9df49820596dd92b773efbd698f6ea4086d592a0a5696fdee852e92fc10e70f267a996174
+  metadata.gz: 48ed408b340d8ca6dfcf7a5ef2225da1c54649c9432cedd312a7e959ce8697169fc568040e7703df57fc408fecd79124be53b5af856df8b329ee352ff4cea3b6
+  data.tar.gz: 84d29d5115f6281163aa2969f335f289165019259a313f4b063d77707abdcae59f05152a40f003f5474593d9d7cff2291935c3c5476e0b2cb20893e4568a3fb0

data/README.md

@@ -1,60 +1,80 @@
-# SucharyPL - oficjalna biblioteka bazy SucharyAPI
-Rubyowa biblioteka do pobierania kawałów z ogólnopolskiej bazy SucharyAPI
+# SucharyRuby - oficjalna biblioteka bazy SucharyAPI
+Biblioteka Ruby do pobierania kawałów z ogólnopolskiej bazy SucharyAPI
 
-[![Ruby Version](https://img.shields.io/badge/ruby-2.7%2B-red)](https://www.ruby-lang.org/)
+[![Ruby Version](https://img.shields.io/badge/ruby-3.2%2B-red)](https://www.ruby-lang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
 ---
 
 ## 🚀 Instalacja
 ### Za pomocą gem
-
 ```bash
 gem install sucharyruby
 ```
 
 ### Za pomocą Bundlera
-
-(W pliku Gemfile)
-```ruby
-gem "sucharyruby"
-```
-
-albo w nowym Bundlerze:
-(komenda)
 ```bash
 bundle add sucharyruby
 ```
 
 ---
 
-## ⚡ Szybki start
+## ⚡ Suchary
 ### Pobranie losowego suchara
-
 ```ruby
 require "sucharyruby"
 
+# Pobierz losowy suchar z dowolnej kategorii
 suchar = Sucharyruby.dajKawal
 puts suchar
 ```
 
 ### Pobranie suchara z konkretnej kategorii
-
 ```ruby
 require "sucharyruby"
 
-# Możesz użyć ciągu znaków:
+# Pobierz suchar z kategorii "programowanie"
 suchar = Sucharyruby.dajKawal("programowanie")
+puts suchar
+```
 
-# Albo użyć stałej z klasy Kategoria:
-suchar = Sucharyruby.dajKawal(Sucharyruby::Kategoria::PROGRAMOWANIE)
+### Pobranie większej liczby sucharów
+```ruby
+require "sucharyruby"
 
-puts suchar
+# Pobierz 3 suchary
+suchary = Sucharyruby.wieleKawalow(3)
+puts suchary
+
+# Funkcja wieleKawalow() zwraca listę (array []) z żartami
 ```
 
 ---
 
-## Kategorie
+## Masakry
+### Pobranie masakry
+```ruby
+require "sucharyruby"
+
+# Pobierz masakrę
+masakra = Sucharyruby.masakra
+puts masakra
+```
+
+### Pobranie większej liczby masakr
+```ruby
+require "sucharyruby"
+
+# Pobierz 3 masakry
+masakry = Sucharyruby.wieleMasakr(3)
+puts masakry
+
+# Funkcja wieleMasakr() zwraca listę (array []) z masakrami
+```
+
+---
+
+## Kategorie sucharów
 - `"programowanie"` - Suchary o programowaniu
 - `"dwuznaczne"` - Suchary dwuznaczne
 - `"szkolne"` - Suchary szkolne
@@ -66,45 +86,20 @@ puts suchar
 ---
 
 ## 🛡️ Obsługa błędów
-
 Biblioteka rzuca sformalizowane wyjątki, które możesz łatwo obsługiwać:
-
 ### Dostępne wyjątki
-
 - `Sucharyruby::SucharyError` - Bazowy wyjątek, rodzic wszystkich błędów z biblioteki
-- `Sucharyruby::KategoriaError` - Nieprawidłowa kategoria
-- `Sucharyruby::ConnectionError` - Problemy z połączeniem (brak internetu, timeout)
 - `Sucharyruby::HTTPError` - Błędy serwera (np. 404 dla nieistniejącej kategorii)
-- `Sucharyruby::TimeoutError` - Przekroczony limit czasu zapytania
-
-### Przykład obsługi błędów
-
-```ruby
-require "sucharyruby"
-
-begin
-  suchar = Sucharyruby.dajKawal("programowanie")
-  puts suchar
-rescue Sucharyruby::ConnectionError
-  puts "❌ Błąd połączenia - sprawdź połączenie internetowe!"
-rescue Sucharyruby::HTTPError => e
-  puts "❌ Błąd serwera: #{e.status} - #{e.message}"
-rescue Sucharyruby::KategoriaError => e
-  puts "❌ Nieprawidłowa kategoria: #{e.message}"
-rescue Sucharyruby::SucharyError => e
-  puts "❌ Nieoczekiwany błąd: #{e.message}"
-end
-```
+- `Sucharyruby::TimeoutError` - Żądanie przekroczyło limit czasu (6.5s)
+- `Sucharyruby::ConnectionError` - Problemy z połączeniem (brak internetu)
 
 ---
 
 ## 📡 API
-
 Biblioteka jest produktem oraz korzysta z oficjalnej bazy SucharyAPI:
-🔗 https://sucharyapi.onrender.com
+🔗 [https://sucharyapi.onrender.com](https://sucharyapi.onrender.com)
 
 ---
 
 ## 📝 Licencja
-
 MIT

data/example/example.rb

@@ -22,4 +22,16 @@ rescue Sucharyruby::KategoriaError => e
   puts "Wyłapano błąd kategorii: #{e.message}"
 rescue Sucharyruby::SucharyError => e
   puts "Wyłapano ogólny błąd biblioteki: #{e.message}"
-end
+end
+
+# 4. Wiele żartów (3)
+puts "\n4. Wiele żartów (3): "
+puts Sucharyruby.wieleKawalow(3)
+
+# 5. Masakra
+puts "\n5. Masakra: "
+puts Sucharyruby.masakra
+
+# 6. Wiele masakr (3)
+puts "\n6. Wiele masakr (3): "
+puts Sucharyruby.wieleMasakr(3)

data/lib/sucharyruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sucharyruby
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/sucharyruby.rb

@@ -35,6 +35,7 @@ module Sucharyruby
   # Customowe błędy
   class SucharyError < StandardError; end
   class KategoriaError < SucharyError; end
+  class IloscError < SucharyError; end
   class ConnectionError < SucharyError; end
   class HTTPError < SucharyError
     attr_reader :status
@@ -80,4 +81,74 @@ module Sucharyruby
       raise SucharyError, "Otrzymano niepoprawny format danych z serwera: #{e.message}"
     end
   end
+
+  def self.wieleKawalow(ilosc)
+    dane = pobierz_json("/zart/#{zwaliduj_ilosc(ilosc)}")
+    unless dane.is_a?(Array)
+      raise SucharyError, "Serwer zwrócił niepoprawną listę kawałów"
+    end
+
+    dane.map do |zart|
+      unless zart.is_a?(Hash) && zart["tresc"].is_a?(String)
+        raise SucharyError, "Serwer zwrócił niepoprawny kawał"
+      end
+
+      zart["tresc"]
+    end
+  end
+
+  def self.masakra
+    dane = pobierz_json("/masakra")
+    unless dane.is_a?(Hash) && dane["masakra"].is_a?(String)
+      raise SucharyError, "Serwer zwrócił niepoprawną masakrę"
+    end
+
+    dane["masakra"]
+  end
+
+  def self.wieleMasakr(ilosc)
+    dane = pobierz_json("/masakra/#{zwaliduj_ilosc(ilosc)}")
+    unless dane.is_a?(Array)
+      raise SucharyError, "Serwer zwrócił niepoprawną listę masakr"
+    end
+
+    dane.map do |masakra|
+      unless masakra.is_a?(Hash) && masakra["masakra"].is_a?(String)
+        raise SucharyError, "Serwer zwrócił niepoprawną masakrę"
+      end
+
+      masakra["masakra"]
+    end
+  end
+
+  def self.zwaliduj_ilosc(ilosc)
+    unless ilosc.is_a?(Integer) && ilosc.positive?
+      raise IloscError, "Ilość musi być dodatnią liczbą całkowitą"
+    end
+
+    ilosc
+  end
+  private_class_method :zwaliduj_ilosc
+
+  def self.pobierz_json(sciezka)
+    adres = URI.parse("https://sucharyapi.onrender.com#{sciezka}")
+    http = Net::HTTP.new(adres.host, adres.port)
+    http.use_ssl = (adres.scheme == "https")
+    http.open_timeout = 6.5
+    http.read_timeout = 6.5
+    odpowiedz = http.request(Net::HTTP::Get.new(adres))
+
+    unless odpowiedz.is_a?(Net::HTTPSuccess)
+      raise HTTPError.new(odpowiedz.code.to_i, "Serwer zwrócił kod błędu #{odpowiedz.code}")
+    end
+
+    JSON.parse(odpowiedz.body)
+  rescue Net::OpenTimeout, Net::ReadTimeout => e
+    raise TimeoutError, "Zapytanie przekroczyło limit czasu: #{e.message}"
+  rescue SocketError, Errno::ECONNREFUSED => e
+    raise ConnectionError, "Błąd połączenia z serwerem: #{e.message}"
+  rescue JSON::ParserError => e
+    raise SucharyError, "Otrzymano niepoprawny format danych z serwera: #{e.message}"
+  end
+  private_class_method :pobierz_json
 end

data/sig/sucharyruby.rbs

@@ -1,4 +1,7 @@
 module Sucharyruby
   VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  def self.wieleKawalow: (Integer ilosc) -> Array[String]
+  def self.wieleZartow: (Integer ilosc) -> Array[String]
+  def self.masakra: () -> String
+  def self.wieleMasakr: (Integer ilosc) -> Array[String]
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sucharyruby
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - SucharyAPI