DeviantArtFs 7.0.0-beta1

This is a prerelease version of DeviantArtFs.
There is a newer version of this package available.
See the version list below for details.
dotnet add package DeviantArtFs --version 7.0.0-beta1                
NuGet\Install-Package DeviantArtFs -Version 7.0.0-beta1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DeviantArtFs" Version="7.0.0-beta1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DeviantArtFs --version 7.0.0-beta1                
#r "nuget: DeviantArtFs, 7.0.0-beta1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install DeviantArtFs as a Cake Addin
#addin nuget:?package=DeviantArtFs&version=7.0.0-beta1&prerelease

// Install DeviantArtFs as a Cake Tool
#tool nuget:?package=DeviantArtFs&version=7.0.0-beta1&prerelease                

DeviantArtFs

A .NET / F# library to interact with the DeviantArt / Sta.sh API.

Design

Each request that can be made to DeviantArt is represented by a function in one of the modules (static classes) in the DeviantArtFs.Api namespace. Each static method takes one or more parameters:

  • token (an object that implements the IDeviantArtAccessToken interface and provides the library with the API credentials)
  • expansion (on some requests; allows user object expansion)
  • A parameter specific to the request (if any)
  • A range specifier (for endpoints that ask the user to request a particular range of results
    • paging: a DeviantArtPagingParams record, which specifies an offset and an optional limit / page size
      • DeviantArtFs is aware of the maximum limits for each API request; to request the maximum page size, use DeviantArtPagingParams.MaxFrom
    • cursor: a string provided in the previous page's result (use null to start at the beginning)
    • offset / limit: used in place of paging or cursor in methods which return AsyncSeq<T>

In some cases, two methods are available for an API call. Functions whose names begin with Page will return a single page of results, while the corresponding Get function will return an asynchronous sequence which begins at the offset you specify (see "Interoperability" below). Be careful not to request too much data or you might hit API usage limits.

Interoperability

All return types from API calls are wrapped in either F# asynchronous workflows (FSharpAsync<T>) or F# asynchronous sequences (using the package FSharp.Control.AsyncSeq), and the FSharpOption<T> type is used extensively in object models. To help you work with these types in C# or VB.NET, DeviantArtFs provides extension methods in the namespace DeviantArtFs.Extensions:

  • Option types
    • .OrNull(): converts any option type to an equivalent nullable type
    • .IsTrue(): checks whether a bool option type (which might be true, false, or None) is true
    • .IsFalse(): checks whether a bool option type (which might be true, false, or None) is false
    • .OrEmpty(): returns the items contained by a list option type, or an empty list if the field is None
  • Asynchronous types
    • .Take(int count): sets a limit on the amount of items returned by an F# asynchronous sequence
    • .ThenToArray(): converts an F# asynchronous sequence into an asynchronous workflow that collects all items in a single array
    • .ThenToList(): converts an F# asynchronous sequence into an asynchronous workflow that collects all items in a single immutable list
    • .ToAsyncEnumerable(): converts an F# asynchronous sequence into a .NET IAsyncEnumerable<T> (.NET 5.0+ only)
    • .StartAsTask(TaskCreationOptions options = null, CancellationToken? token = null): executes a "cool" F# asynchronous workflow by creating a "hot" .NET task that can be awaited

The FSharpList<T> type also appears often, but this type implements IEnumerable<T> and can be converted to a normal list or array using LINQ.

Any C# or VB.NET code that uses this library to call the DeviantArt API is expected to use either .ToAsyncEnumerable() or .StartAsTask() on each API call.

Deleted deviations and status updates

Deviation and DeviantArtStatus objects can represent a deviation or status update that has been deleted; this is why most of the fields on those two types are marked optional. Check the is_deleted field (or IsDeleted property) before attempting to access any of the other fields.

Partial updates

Stash.Update and User.ProfileUpdate allow you to choose which fields to update on the object. DeviantArtFs uses discriminated unions to represent these updates:

await Requests.User.ProfileUpdate.ExecuteAsync(token, new[] {
    ProfileUpdateField.NewArtistLevel(ArtistLevel.Student),
    ProfileUpdateField.NewWebsite("https://www.example.com")
});

await Requests.Stash.Update.ExecuteAsync(token, 12345678L, new[] {
    UpdateField.NewTitle("new stack title"),
    UpdateField.ClearDescription
});

Note that DeviantArt allows a null value for the "description" field on a Sta.sh stack, and this is represented by its own union case.

Known issues

  • Mature content filtering is not supported (use the is_mature flag on the deviation instead).
  • The profile_pic field in the user.profile expansion is not supported due to circular type definitions. Get it from the full profile object instead.
  • The following fields in the deviation object are not supported:
    • challenge
    • challenge_entry
    • motion_book
    • premium_folder_data
    • text_content
    • suggested_reasons
  • The api_session return object is not supported.

Examples

  • ExampleConsoleApp: An F# console application that shows some data on the current user's recent (and not-so-recent) submissions, along with some of their Sta.sh info. Reads the access token interactively from standard input.
  • GalleryViewer: A VB.NET app that lets you see the "All" view of someone's gallery and read the descriptions of individual submissions. Uses the Client Credentials grant and stores tokens in a file.
  • WebApp: An ASP.NET Core app written in C# that lets you view someone's gallery folders and corresponding submission thumbnails. Uses the Client Credentials grant and stores tokens in a database.

Authentication

See also: https://www.deviantart.com/developers/authentication

Both Authorization Code (recommended) and Implicit grant types are supported. The DeviantArtAuth module provides methods to support the Authorization Code grant type (getting tokens from an authorization code and refreshing tokens).

If you are writing a Windows desktop application, the package DeviantArtFs.WinForms package uses Internet Explorer to provide a way to get a code or token from the user using either grant type.

If you need to store the access token somewhere (such as in a database or file), you may want to create your own class that implements the IDeviantArtAccessToken, IDeviantArtRefreshToken, or IDeviantArtAutomaticRefreshToken interface. Using the latter will allow DeviantArtFs to automatically refresh the token and store the new value when it recieves an HTTP 401 response. (An InvalidRefreshTokenException is thrown if the token cannot be refreshed.)

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on DeviantArtFs:

Package Downloads
DeviantArtFs.Stash.Marshal

An F#/.NET library to interact with the Sta.sh API and manage state (.NET Standard 2.0)

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
11.0.0 94 10/28/2024
11.0.0-beta2 77 10/28/2024
10.1.0-beta2 93 10/20/2024
10.1.0-beta1 81 9/21/2024
10.0.0 133 8/8/2024
10.0.0-rc1 104 8/8/2024
9.2.1-rc1 86 8/7/2024
9.2.0 119 6/19/2024
9.2.0-beta1 101 6/19/2024
9.1.1 127 4/27/2024
9.1.0-rc1 215 11/27/2023
9.0.0 277 11/22/2023
9.0.0-beta4 147 5/30/2023
9.0.0-beta2 112 5/28/2023
8.0.0 468 5/30/2021
8.0.0-beta4 284 5/30/2021
8.0.0-beta3 339 5/30/2021
8.0.0-beta2 239 5/30/2021
7.0.1 409 1/11/2021
7.0.0 387 1/9/2021
7.0.0-beta1 297 1/9/2021
6.0.2 373 1/5/2021
6.0.1 439 12/28/2020
6.0.0 349 12/27/2020
6.0.0-beta2 333 12/26/2020
6.0.0-beta1 325 12/26/2020
5.0.0 525 2/11/2020
5.0.0-beta1 440 2/11/2020
4.0.0 512 1/23/2020
4.0.0-beta2 455 1/23/2020
4.0.0-beta1 464 1/22/2020
3.0.0 560 1/17/2020
2.2.0 564 1/6/2020
2.1.0 540 9/9/2019
2.0.0-beta3 509 3/9/2019
2.0.0-beta2 487 3/8/2019
2.0.0-beta1 483 3/6/2019
1.1.0-beta1 478 3/5/2019
1.0.0 709 2/10/2019
0.9.0 1,357 1/29/2019
0.8.0 701 1/28/2019
0.7.3 723 1/22/2019
0.7.2 702 1/22/2019
0.7.1 1,365 1/19/2019
0.7.0 737 1/18/2019
0.6.0 1,397 1/14/2019
0.5.0 1,367 1/11/2019
0.4.0 1,389 1/3/2019
0.3.0 1,392 12/31/2018
0.2.0-alpha 1,187 12/27/2018
0.1.0-alpha 623 12/21/2018

7.0.0: New refactoring to remove repeated boilerplate