misskey 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71cbb354bf3e664aced3e95663daf3913fbc15164101b9e142c287b30ee8832c
-  data.tar.gz: 64b42af87b8adb89acf63b1127b7b33928f4eee6efd2ceea366ced0c3b46841e
+  metadata.gz: 03e2e920853b80640240b7ad629a1f998b23df4369542f9d8a6e909a3883147d
+  data.tar.gz: bd07e84986ca9e0d9807b5c3055c20c02ff9ec7ffe39e7388f5864cb0739af58
 SHA512:
-  metadata.gz: 36fbcabc078bc9802c708b1f9653a7a1677a29ab21433aa8ea34a95b90913945c975b33066e009ae948da8a44b52eafaab944eee34827c181d675628e0faaece
-  data.tar.gz: 9794cbf3ddaf2ae5bb4b2d8a2dd1a654d539f2be83cc5ef048178217bac8f60309c98c6b62b3f2b6ed4f89c5e251d570eb18e3bda6dce5123c43d0969119ba0e
+  metadata.gz: dadffdeacd82c3244c69a5e00a41bad5ed2ef275de8169deb4d384459bdb1788a78f6b143d6e53b19b3aabda3fdcd9bf359a3cd734a66836c4f0f8859818b777
+  data.tar.gz: e7e120302904faa5d1863bef0af94654a643f7788e0a4fc307a6a3897d59c2266361d3e14022dffdf165e14641d710887046cdf804d1b8c4e5a67f08af50d8ea

data/README.md

@@ -1,3 +1,219 @@
 # Misskey.rb
 
-A Ruby module for interacting with the Misskey API
+A Ruby module for interacting with the Misskey API. Releases hosted on [Rubygems](https://rubygems.org/gems/misskey). **This is not affiliated with Syuilo in any way!!**
+
+## Installation :neofox_science:
+Either add it to your Gemfile:
+```Gemfile
+gem "misskey"
+```
+or install it directly with Gem:
+```sh
+gem install misskey
+```
+
+## Contributing :neofox_laptop:
+Because it would be really difficult for me to implement *every* Misskey API feature, I would really appreciate contributions!
+
+When contributing please make sure to follow these guidelines. These may change as time goes on:
+
+1) No LLM-generated commits please! Vibecoded software tends to get really messy and introduce more issues than it solves. Also everything around LLMs are highly unethical and I don't want to support that. Thanks!
+
+2) Please do not create multiple functions that do the same thing.
+
+3) Follow common sense.
+
+Thank you! :neofox_heart:
+
+## Using :neofox_notice:
+I didn't have the energy to make a real wiki for this and I have no idea how to use the Rubygems documentation thingy so I just stuck it in one big readme. I am deeply sorry about this :neofox_googly_shocked:
+
+Like I said in the contributing guide, this doesn't implement every Misskey API feature and if you want to see a feature added it would mean a lot to me if you could contribute! Thanks :neofox_heart:
+
+### Authentication **(REQUIRED!!!)**
+#### `Misskey.auth.instanceURI`
+This sets the instance URI that your client will connect to. This and `Misskey.auth.token` are **required** when using Misskey.rb.
+
+This can be used like a variable. You can change it or access it at any time. See some examples below:
+
+Changing the value:
+```ruby
+require "misskey"
+
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+```
+
+Calling the value:
+```ruby
+require "misskey"
+
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+# Getting the value
+puts Misskey.auth.instanceURI
+```
+
+Pretty simple :neofox_floof_happy:
+
+#### `Misskey.auth.token`
+This sets the API key/token that your client will connect to. This and `Misskey.auth.instanceURI` are **required** when using Misskey.rb.
+
+This can be used like a variable. You can change it or access it at any time. See some examples below:
+
+Changing the value:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "blahblahtokenweeewooooooo"
+```
+
+Calling the value:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "wafwaftokenaaaaaa"
+
+# Getting the value
+puts Misskey.auth.token
+```
+
+You can also use this in pair with the `dotenv` module:
+```ruby
+require "misskey"
+require "dotenv"
+
+Dotenv.load "./.env"
+Misskey.auth.token = ENV["APIKey"]
+```
+
+Also pretty simple :neofox_floof_happy:
+
+### Notes
+#### `Misskey.notes.create`
+Creates a note.
+
+Order of arguments are as follows: `noteContent` also known as the body text (REQUIRED), `visibility`, `localonly`, `cw` also known as a content warning.
+
+Visibility options include: `public`, `home`, `followers`, and `specified`. `specified` is also known as a direct note or private message.
+
+Some examples:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+Misskey.notes.create "Hello world!! :neofox_floof:"
+```
+It will automatically convert things like ":neofox_floof:" to their respective emojis as seen above.
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+Misskey.notes.create "Hello there, this is a home note.", "home"
+```
+The example above shows a client creating a note with the visibility "home"
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+Misskey.notes.create "Hi this is local!", "public", true
+```
+The example above shows a client creating a public local (aka defederated) note.
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+Misskey.notes.create "Hi this is local and features a content warning!", "public", true, "Holy moly it's a post by me wow beware"
+```
+As the note body suggests, this is a local note that has a content warning.
+
+You may refer to the [Misskey API docs](https://sharkey.skydevs.me/api-doc#tag/notes/POST/notes/create) for more info.
+
+#### `Misskey.notes.create.reply`
+Very similar to `Misskey.notes.create` except it features a new required argument called `replyId`.
+
+Arguments for this are as follows: `replyId` (REQUIRED), `noteContent` (REQUIRED), visibility, localOnly, cw
+
+An example:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+Misskey.notes.create.reply "someReplyId", "Hello there, this is a reply."
+```
+You may refer to the [Misskey API docs](https://sharkey.skydevs.me/api-doc#tag/notes/POST/notes/create) for more info.
+
+#### `Misskey.notes.timeline`
+Retrieves the home timeline of the currently logged-in user I believe? Not too sure because I only tested it on a dummy account that doesn't follow anyone. 
+
+There is one optional argument which is `limit`. As the name suggests, it sets a limit to how many notes should be retrieved. By default it's set to 10.
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+puts Misskey.notes.timeline
+```
+You may refer to the [Misskey API docs](https://sharkey.skydevs.me/api-doc#tag/notes/POST/notes/timeline) for more info.
+
+### `Misskey.getOnlineUsersCount`
+Pretty self-explanatory, gets the number of users online. Using it is really simple, here's an example:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+puts "There are #{Misskey.getOnlineUsersCount} user(s) online right now!"
+```
+Slightly more complicated example:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+case Misskey.getOnlineUserscount.to_i
+when 0
+    puts "There are no users online :("
+when 1
+    puts "There is 1 user online."
+when > 1
+    puts "There are #{Misskey.getOnlineUserscount} users online"
+end
+```
+You may refer to the [Misskey API docs](https://sharkey.skydevs.me/api-doc#tag/meta/POST/get-online-users-count) for more info.
+
+### `Misskey.serverInfo`
+Retrieves the instance/server information. Example:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+puts Misskey.serverInfo
+```
+You may refer to the [Misskey API docs](https://sharkey.skydevs.me/api-doc#tag/meta/POST/server-info) for more info.
+
+### `Misskey.i`
+Retrieves the information about the currently logged-in user. Example:
+```ruby
+require "misskey"
+
+Misskey.auth.token = "tokenwaaaaaaa"
+Misskey.auth.instanceURI = "sharkey.skydevs.me"
+
+puts Misskey.i
+```
+You may refer to the [Misskey API docs](https://sharkey.skydevs.me/api-doc#tag/account/POST/i) for more info.

data/lib/misskey.rb

@@ -54,6 +54,27 @@ module Misskey
         Creates.created.reply replyId, noteContent, visibility = "public", localOnly = false, cw = ""
       end
     end
+
+    def timeline limit = 10
+      instance = "https://#{Misskey.auth.instanceURI}/api/notes/timeline"
+
+      postJSON = <<EOF
+{
+  "limit": #{limit}
+}
+EOF
+  
+      request = HTTParty.post(
+        instance,
+        body: postJSON,
+        headers: { 
+          "Content-Type" => "application/json",
+          "Authorization" => "Bearer #{Misskey.auth.token}"
+        }
+      )
+
+      return JSON.parse request.body
+    end
   end
 
   def getOnlineUsersCount
@@ -110,27 +131,6 @@ EOF
         "Authorization" => "Bearer #{Misskey.auth.token}"
       }
     )
-
-    def timeline limit = 100
-      instance = "https://#{Misskey.auth.instanceURI}/api/notes/timeline"
-
-      postJSON = <<EOF
-{
-  "limit": #{limit}
-}
-EOF
-  
-      request = HTTParty.post(
-        instance,
-        body: postJSON,
-        headers: { 
-          "Content-Type" => "application/json",
-          "Authorization" => "Bearer #{Misskey.auth.token}"
-        }
-      )
-
-      return JSON.parse request.body
-    end
     
     def notifications limit = 10
       instance = "https://#{Misskey.auth.instanceURI}/api/i/notifications"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: misskey
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Sky.Bit