Skip to content

A light-weight wrapper for the TMDb Api written in C#. TmdbEasy makes getting movie data a piece of cake..

License

Notifications You must be signed in to change notification settings

tonykaralis/TmdbEasy

Repository files navigation

TMdbEasy

Build Status Build Status

Nuget Package Nuget

License

A simple and lightweight library that wraps The Movie Database api and makes it super easy to get movie/tv/actor data and more.

Installation

Via Package Manager:

Install-Package TMdbEasy

Via .NET CLI

dotnet add package TMdbEasy

.NET Core Configuration

If your application uses an IOC container then the simplest and advised way to set up TmdbEasy is to register all the key services with the IOC container. TmdbEasy also works just fine with apps that don't use an IOC container.

TmdbEasy comes with baked in support for ASP.NET Core's default IOC container via an extension method called AddTmdbEasy().

Using the method as shown below will register all the required TmdbEasy services for you.

public void ConfigureServices(IServiceCollection services)
{   
    // Typically get these options from IConfiguration, Environment variables etc
    var options = new TmdbEasyOptions();
    
    // Adds TmdbEasy to your app
    services.AddTmdbEasy(options);
}

The AddTmdbEasy() method accepts an immutable options parameter that allows configuration of TmdbEasy at a global level.

public TmdbEasyOptions(string apiKey = null, bool useSsl = true, string defaultLanguage = "en", IJsonDeserializer customJsonSerializer = null)
{
    ApiKey = apiKey;
    UseSsl = useSsl;
    DefaultLanguage = defaultLanguage;
    JsonDeserializer = customJsonSerializer ?? new NewtonSoftDeserializer();
}

All requests will default to using the apiKey and language properties set at this level. This can however be overriden on a per request basis, should your app opt to use different api keys/languages for different users.

Newtonsoft is used by default for the deserialization of all http responses.

If for whatever reason, you wish to use a different JSON deserializer with TmdbEasy, this can be done easily by providing a new instance of IJsonDeserializer on the options.

Supported Services

As of v1 the following services are supported. We aim to add more over the coming months.

Usage

We have attempted to mirror the TMDb api as closely as possible and believe the methods are super simple to use. There really isn't that much to say. Inject the service api of your choice and off you go. Lets look at a few examples:

Inject the IMovieApi into a controller and find a specific movie

public class MovieController : Controller
{
    private readonly IMovieApi _movieApi;

    public HomeController(IMovieApi movieApi)
    {
        _movieApi = movieApi;
    }

    public async Task<IActionResult> Index()
    {
        int movieId = 550; //taken from the UI or wherever
        
        var movie = await _movieApi.GetDetailsAsync(movieId);

        return View(movie);
    }
}

This time we override the default apiKeyand language.

public class MovieController : Controller
{
    private readonly IMovieApi _movieApi;
    
    public HomeController(IMovieApi movieApi)
    {
        _movieApi = movieApi;
    }

    public async Task<IActionResult> Index()
    {
        int movieId = 550; //taken from the UI or wherever
        
        string apiKey = "xyz123"; // tyically you'd get this from the HttpContext or Database etc
        
        string language = "en"; // get the users chosen language from somewhere or set a default
        
        var movie = await _movieApi.GetDetailsAsync(movieId, language, apiKey);

        return View(movie);
    }
}

Lets try a console app.

// configure the library
var options = new TmdbEasyOptions();
var client =  new tmdbEasyClient(options);

// Get an endpoint
var movieApi = new MovieApi(client);

// Get the data
var jobs = await movieApi.GetJobsAsync();

How to contribute

  1. Fork the repo
  2. Create an account on the (The Movie DB - https://www.themoviedb.org/)
  3. Get a free Api Key under Profile & Settings -> Settings -> API -> API KEY (v3 auth)
  4. Add the key as an environment variable on your machine with the name tmdbapikey (you'll need this to run integration tests)
  5. Make changes and test (update tests appropriately)
  6. Submit a PR

Contributors

https://github.com/tonykaralis/TMdbEasy/graphs/contributors

License

Copyright © Tony Karalis and contributors.

TmdbEasy is provided as-is under the MIT license. For more information see LICENSE.

Acknowledgements

All film-related data and metadata gathered via this library is supplied by The Movie Database (TMDb). TmdbEasy uses the TMDb API but is not endorsed or certified in any way by TMDb.

https://www.themoviedb.org/

About

A light-weight wrapper for the TMDb Api written in C#. TmdbEasy makes getting movie data a piece of cake..

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •  

Languages