discloud 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6d03d0d7da77e364684084dd9626ee2d86afd873959dbdec07bbfc08a8701a13
+  data.tar.gz: 01b8520f7bb353f43a4afa0cbd32ef008a8ee4a3c40e2a06e6817231300516a8
+SHA512:
+  metadata.gz: bbdeda81225ff3981a52d00a36f2c8110e3c5901157222a667520e9257a6a76d55c815d5c733ad63f9eae0021964754343fa830da70d52a8748e1b5f9a4fc6f7
+  data.tar.gz: 1f8dc1f0892fa2603832e55b5caeb9ed454a7d54367f225400220e9716e6707d654f2515828ac313805daa69be1269358deddf70710b7caabdab51687404a7d3

data/README.md

@@ -0,0 +1,196 @@
+# DISCLOUD SDK RUBY
+
+---
+## Installation
+```sh
+gem install discloud
+```
+---
+## Links
+
+[Documentation](https://discloud.github.io/discloud-rb)
+[Github](https://github.com/discloud/discloud-rb)
+[Discloud Server](https://discord.discloudbot.com)
+---
+## Usage Examples
+
+> API > User
+```ruby
+require "discloud"
+
+client = Discloud::Client.new(token: "API-TOKEN")
+user = Discloud::Resources::User.new(client)
+
+puts "== USER INFO =="
+begin
+  response = user.info
+  pp response.parsed_response
+rescue => e
+  puts "[Error getting user information] \#{e.message}"
+end
+
+puts "\n== SET LOCALE =="
+begin
+  locale_response = user.set_locale("en-US")
+  pp locale_response.parsed_response
+rescue => e
+  puts "[Error changing locale] \#{e.message}"
+end
+```
+> API > App
+```ruby
+require "discloud"
+
+client = Discloud::Client.new(token: "API-TOKEN")
+app = Discloud::Resources::App.new(client)
+
+app_id = "YOUR_APP_ID"
+zip_path = "path/to/app.zip"
+
+puts "== APP INFO =="
+begin
+  response = app.info(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error getting app info] \#{e.message}"
+end
+
+puts "\n== APP STATUS =="
+begin
+  response = app.status(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error getting app status] \#{e.message}"
+end
+
+puts "\n== APP LOGS =="
+begin
+  response = app.logs(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error fetching app logs] \#{e.message}"
+end
+
+puts "\n== APP BACKUP =="
+begin
+  response = app.backup(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error downloading app backup] \#{e.message}"
+end
+
+puts "\n== START APP =="
+begin
+  response = app.start(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error starting app] \#{e.message}"
+end
+
+puts "\n== RESTART APP =="
+begin
+  response = app.restart(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error restarting app] \#{e.message}"
+end
+
+puts "\n== STOP APP =="
+begin
+  response = app.stop(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error stopping app] \#{e.message}"
+end
+
+puts "\n== CHANGE APP RAM =="
+begin
+  response = app.change_ram(app_id, 512)
+  pp response.parsed_response
+rescue => e
+  puts "[Error changing RAM] \#{e.message}"
+end
+
+puts "\n== COMMIT APP =="
+begin
+  response = app.commit(app_id, zip_path)
+  pp response.parsed_response
+rescue => e
+  puts "[Error committing app] \#{e.message}"
+end
+
+puts "\n== UPLOAD APP =="
+begin
+  response = app.upload(zip_path)
+  pp response.parsed_response
+rescue => e
+  puts "[Error uploading app] \#{e.message}"
+end
+
+puts "\n== DELETE APP =="
+begin
+  response = app.delete(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error deleting app] \#{e.message}"
+end
+
+puts "\n== LIST ALL APPS =="
+begin
+  response = app.list_all
+  pp response.parsed_response
+rescue => e
+  puts "[Error listing apps] \#{e.message}"
+end
+```
+> API > Team
+```ruby
+require "discloud"
+
+client = Discloud::Client.new(token: "API-TOKEN")
+team = Discloud::Resources::Team.new(client)
+
+app_id = "YOUR_APP_ID"
+mod_id = "MOD_USER_ID"
+
+puts "== TEAM INFO =="
+begin
+  response = team.info(app_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Error getting team info] \#{e.message}"
+end
+
+puts "\n== ADDING MEMBER =="
+begin
+  response = team.add_member(app_id, mod_id, ["start_app", "stop_app"])
+  pp response.parsed_response
+rescue => e
+  puts "[Add member failed] \#{e.message}"
+end
+
+puts "\n== EDITING MEMBER PERMISSIONS =="
+begin
+  response = team.edit_member(app_id, mod_id, [
+    "backup_app",
+    "commit_app",
+    "edit_ram",
+    "logs_app",
+    "restart_app",
+    "start_app",
+    "status_app",
+    "stop_app",
+  ])
+  pp response.parsed_response
+rescue => e
+  puts "[Edit member failed] \#{e.message}"
+end
+
+puts "\n== REMOVING MEMBER =="
+begin
+  response = team.remove_member(app_id, mod_id)
+  pp response.parsed_response
+rescue => e
+  puts "[Remove member failed] \#{e.message}"
+end
+```

data/lib/discloud/client.rb

@@ -0,0 +1,71 @@
+require "httparty"
+
+module Discloud
+  class Client
+    include HTTParty
+
+    base_uri "https://api.discloud.app/v2"
+    default_timeout 300
+
+    def initialize(token:)
+      @headers = {
+        "api-token" => token
+      }
+    end
+
+    def get(path)
+      with_rescue { self.class.get(path, headers: @headers) }
+    end
+
+    def post(path, body = {}, extra_headers = {})
+      with_rescue { self.class.post(path, headers: @headers.merge(extra_headers), body: body) }
+    end
+
+    def put(path, body = {}, extra_headers = {})
+      with_rescue { self.class.put(path, headers: @headers.merge(extra_headers), body: body) }
+    end
+
+    def delete(path)
+      with_rescue { self.class.delete(path, headers: @headers) }
+    end
+
+    private
+
+    def with_rescue(max_retries = 5, delay = 10)
+      retries = 0
+      begin
+        yield
+      rescue Net::ReadTimeout, Net::OpenTimeout, Errno::ECONNRESET, SocketError => e
+        retries += 1
+        if retries <= max_retries
+          puts "[Warning] Timeout or connection error: #{e.class}. Retrying (#{retries}/#{max_retries}) in #{delay}s..."
+          sleep delay
+          retry
+        else
+          puts "[Fatal] Connection failed after #{max_retries} retries."
+          raise e
+        end
+      end
+    end
+  end
+end
+
+# require "httparty"
+
+# module Discloud
+#   class Client
+#     include HTTParty
+#     base_uri "https://api.discloud.app/v2"
+
+#     def initialize(token:)
+#       @headers = {
+#         'api-token' => token
+#       }
+#     end
+
+#     def get(path) = self.class.get(path, headers: @headers)
+#     def post(path, body = {}) = self.class.post(path, headers: @headers, body: body)
+#     def put(path, body = {}) = self.class.put(path, headers: @headers, body: body)
+#     def delete(path) = self.class.delete(path, headers: @headers)
+#   end
+# end

data/lib/discloud/resources/app.rb

@@ -0,0 +1,84 @@
+module Discloud
+  module Resources
+    class App
+      def initialize(client)
+        @client = client
+      end
+
+      def info(app_id)
+        @client.get(Routes::App.info(app_id))
+      end
+
+      def status(app_id)
+        @client.get(Routes::App.status(app_id))
+      end
+
+      def logs(app_id)
+        @client.get(Routes::App.logs(app_id))
+      end
+
+      def backup(app_id)
+        @client.get(Routes::App.backup(app_id))
+      end
+
+      def start(app_id)
+        @client.put(Routes::App.start(app_id))
+      end
+
+      def restart(app_id)
+        @client.put(Routes::App.restart(app_id))
+      end
+
+      def stop(app_id)
+        @client.put(Routes::App.stop(app_id))
+      end
+
+      def change_ram(app_id, ram_mb)
+        unless ram_mb.is_a?(Integer) && ram_mb > 0
+          raise ArgumentError, "RAM must be a positive integer"
+        end
+
+        body = { ramMB: ram_mb }.to_json
+        headers = { "Content-Type" => "application/json" }
+
+        @client.put(Routes::App.ram(app_id), body, headers)
+      end
+
+      def commit(app_id, file_path)
+        validate_file!(file_path)
+
+        File.open(file_path, "rb") do |file|
+          body = { file: file }
+          @client.put(Routes::App.commit(app_id), body)
+        end
+      end
+
+      def upload(file_path)
+        validate_file!(file_path)
+
+        File.open(file_path, "rb") do |file|
+          body = { file: file }
+          @client.post(Routes::App.upload, body)
+        end
+      end
+
+      def delete(app_id)
+        @client.delete(Routes::App.delete(app_id))
+      end
+
+      def list_all
+        @client.delete(Routes::App.list_all)
+      end
+
+      def validate_file!(file_path)
+        unless File.exist?(file_path)
+          raise ArgumentError, "File not found: #{file_path}"
+        end
+
+        unless File.extname(file_path) == ".zip"
+          raise ArgumentError, "Only .zip files are supported for upload or commit"
+        end
+      end
+    end
+  end
+end

data/lib/discloud/resources/team.rb

@@ -0,0 +1,31 @@
+require 'json'
+
+module Discloud
+  module Resources
+    class Team
+      def initialize(client)
+        @client = client
+      end
+
+      def info(app_id)
+        @client.get(Routes::Team.get(app_id))
+      end
+
+      def add_member(app_id, mod_id, perms = [])
+        body = { modID: mod_id, perms: perms }.to_json
+        headers = { "Content-Type" => "application/json" }
+        @client.post(Routes::Team.add(app_id), body, headers)
+      end
+
+      def edit_member(app_id, mod_id, perms = [])
+        body = { modID: mod_id, perms: perms }.to_json
+        headers = { "Content-Type" => "application/json" }
+        @client.put(Routes::Team.edit(app_id), body, headers)
+      end
+
+      def remove_member(app_id, mod_id)
+        @client.delete(Routes::Team.remove(app_id, mod_id))
+      end
+    end
+  end
+end

data/lib/discloud/resources/user.rb

@@ -0,0 +1,17 @@
+module Discloud
+  module Resources
+    class User
+      def initialize(client)
+        @client = client
+      end
+
+      def info
+        @client.get(Routes::User.info)
+      end
+
+      def set_locale(locale)
+        @client.put(Routes::User.set_locale(locale))
+      end
+    end
+  end
+end

data/lib/discloud/routes/app.rb

@@ -0,0 +1,20 @@
+module Discloud
+  module Routes
+    module App
+      class << self
+        def info(app_id) = "/app/#{app_id}"
+        def status(app_id) = "/app/#{app_id}/status"
+        def logs(app_id) = "/app/#{app_id}/logs"
+        def backup(app_id) = "/app/#{app_id}/backup"
+        def start(app_id) = "/app/#{app_id}/start"
+        def restart(app_id) = "/app/#{app_id}/restart"
+        def stop(app_id) = "/app/#{app_id}/stop"
+        def ram(app_id) = "/app/#{app_id}/ram"
+        def commit(app_id) = "/app/#{app_id}/commit"
+        def delete(app_id) = "/app/#{app_id}/delete"
+        def list_all = "/app/all/getApps"
+        def upload = "/upload"
+      end
+    end
+  end
+end

data/lib/discloud/routes/team.rb

@@ -0,0 +1,23 @@
+module Discloud
+  module Routes
+    module Team
+      class << self
+        def get(app_id)
+          "/app/#{app_id}/team"
+        end
+
+        def add(app_id)
+          "/app/#{app_id}/team"
+        end
+
+        def edit(app_id)
+          "/app/#{app_id}/team"
+        end
+
+        def remove(app_id, mod_id)
+          "/app/#{app_id}/team/#{mod_id}"
+        end
+      end
+    end
+  end
+end

data/lib/discloud/routes/user.rb

@@ -0,0 +1,16 @@
+module Discloud
+  module Routes
+    module User
+      locales = ['pt-BR', 'en-US']
+
+      def self.info = "/user"
+      
+      def self.set_locale(locale)
+        unless locales.include?(locale)
+          raise ArgumentError, "Invalid Location. Available values: #{locales.join(', ')}"
+        end
+        "/v2/locale/#{locale}"
+      end
+    end
+  end
+end

data/lib/discloud/version.rb

@@ -0,0 +1,3 @@
+module Discloud
+  VERSION = "0.0.1"
+end

data/lib/discloud.rb

@@ -0,0 +1,8 @@
+require "discloud/version"
+require "discloud/client"
+require "discloud/routes/user"
+require "discloud/routes/app"
+require "discloud/routes/team"
+require "discloud/resources/user"
+require "discloud/resources/app"
+require "discloud/resources/team"

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: discloud
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- 1gcw
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-09-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+description: Ruby SDK Discloud (https://discloud.com)
+email:
+- failed@discloud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/discloud.rb
+- lib/discloud/client.rb
+- lib/discloud/resources/app.rb
+- lib/discloud/resources/team.rb
+- lib/discloud/resources/user.rb
+- lib/discloud/routes/app.rb
+- lib/discloud/routes/team.rb
+- lib/discloud/routes/user.rb
+- lib/discloud/version.rb
+homepage: https://discloud.com
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby module to facilitate the use of the Discloud API
+test_files: []