Unofficial Write.as API client library for Vala. Still a work in progress.
I recommend including writeas-vala as a git submodule and adding writeas-vala/src/Writeas.vala to your sources list. This will avoid packaging conflicts and remote build system issues until I learn a better way to suggest this.
For libsoup3, use writeas-vala/src/Writeas3.vala.
meson
ninja-build
valac
libgtk-3-dev
meson build
cd build
meson configure -Denable_examples=true
ninja
./examples/hello-writeasExamples require update to username and password, don't check this in
string user = "username";
string password = "password";
Writeas.Client client = new Writeas.Client ();
string access_token;
if (client.authenticate ("user", "pass", out access_token)) {
print ("You logged in! Now get writing!");
}Writeas.Client client = new Writeas.Client ();
string access_token = "token-read-from-datastore";
if (client.set_token (access_token)) {
print ("You're already logged in! Now get back to writing!");
} else {
// Access token expired, reauth user
}bool client.logout ()Returns true if the client successfully logged out, false otherwise.
Writeas.Client client = new Writeas.Client ("https://write-freely-host.example/api");
string access_token;
if (client.authenticate ("user", "pass", out access_token)) {
print ("You logged in! Now get writing!");
}bool client.get_authenticated_user (out string username)Returns true if there's an existing access token and it's still valid. Username will be set.
False if the user is anonymous or if the access token is invalid. Username will be null.
GLib.List<Writeas.Post> posts = new GLib.List<Writeas.Post> ();
bool client.get_user_posts (ref posts);Returns true if auth token is valid, and populates posts with posts.
Returns false and leaves posts empty otherwise.
public class Writeas.Post {
public string id { get; set; }
public string slug { get; set; }
public string appearance {get; set; }
public string language { get; set; }
public bool rtl { get; set; }
public string created { get; set; }
public string updated { get; set; }
public string title { get; set; }
public string body { get; set; }
public string[] tags { get; set; }
public int views { get; set; }
public Writeas.Collection collection { get; set; }
public string token { get; set; }
}
public class Writeas.Collection {
public string alias { get; set; }
public string title { get; set; }
public string description { get; set; }
public string style_sheet { get; set; }
public bool @public { get; set; }
public int views { get; set; }
public string email { get; set; }
public string url { get; set; }
public string monetization_pointer { get; set; }
}GLib.List<Writeas.Collection> collections = new GLib.List<Writeas.Collection> ();
bool client.get_user_collections (ref collections);Returns true if auth token is valid, and populates collections with collections.
Returns false and leaves collections empty otherwise.
bool client.render_markdown (out string formatted_markdown, string markdown)When returns true, formatted_markdown will contain the resulting HTML from the markdown.
bool client.publish_post (
out string token,
out string id,
string body,
string title,
string font = "serif",
string lang = "en",
bool rtl = false,
string created = "")Returns true if post is published, false if the post is not published.
Can be used without logging in.
bool client.publish_collection_post (
out string token,
out string id,
string collection_alias,
string body,
string title,
string font = "serif",
string lang = "en",
bool rtl = false,
string created = "")Returns true if post is published, false if the post is not published.
User must be logged in.
bool upload_image_simple (
out string file_url,
string local_file_path,
string user_token = "")Returns true if image is uploaded, false if the image is not uploaded.
User must be logged in. Currently works with Write.as Pro Plan.
Writeas.Post post;
bool client.get_post (out Writeas.Post post, string post_id)Returns true if post exists and was obtained, false otherwise.
bool client.update_post (
string post_id,
string token,
string body,
string title,
string font = "serif",
string lang = "en",
bool rtl = false)Returns true if the post is updated, false otherwise.
User can be anonymous if token is provided. User must be authenticated if token does not exist.
bool client.delete_post (
string post_id,
string token = "")Returns true if the post is deleted, false otherwise.
User can be anonymous if token is provided. User must be authenticated if token does not exist.
bool client.claim_post (
string post_id,
string token)Returns true if the post is claimed, false otherwise.
User must be logged in, and a valid token must be provided