devdocs/lib/docs/scrapers/matplotlib.rb

module Docs
  class Matplotlib < UrlScraper
    include MultipleBaseUrls

    self.name = 'Matplotlib'
    self.type = 'sphinx'
    self.root_path = 'index.html'
    self.links = {
      home: 'https://matplotlib.org/',
      code: 'https://github.com/matplotlib/matplotlib'
    }

    html_filters.push 'matplotlib/entries', 'sphinx/clean_html'

    options[:container] = '.body, section'
    options[:skip] = %w(api_changes.html tutorial.html faq.html)

    options[:attribution] = <<-HTML
      &copy; 2012&ndash;2023 Matplotlib Development Team. All rights reserved.<br>
      Licensed under the Matplotlib License Agreement.
    HTML

    version do
      self.release = '3.9.2'
      self.base_urls = [
        "https://matplotlib.org/stable/api/",
        "https://matplotlib.org/stable/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/stable/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.8' do
      self.release = '3.8.4'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.7' do
      self.release = '3.7.5'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.6' do
      self.release = '3.6.0'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.5' do
      self.release = '3.5.1'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.4' do
      self.release = '3.4.3'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.3' do
      self.release = '3.3.3'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.2' do
      self.release = '3.2.2'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.1' do
      self.release = '3.1.1'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '3.0' do
      self.release = '3.0.0'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '2.2' do
      self.release = '2.2.3'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '2.1' do
      self.release = '2.1.0'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '2.0' do
      self.release = '2.0.2'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    version '1.5' do
      self.release = '1.5.3'
      self.base_urls = [
        "https://matplotlib.org/#{release}/api/",
        "https://matplotlib.org/#{release}/mpl_toolkits/mplot3d/",
        "https://matplotlib.org/#{release}/mpl_toolkits/axes_grid/api/"
      ]
    end

    def get_latest_version(opts)
      get_latest_github_release('matplotlib', 'matplotlib', opts)
    end
  end
end