Evolinx/appstream-generator
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
700 Commits 1 Branch 0 Tags 2.8 MiB
D 90.4%
HTML 4.4%
CSS 1.9%
Shell 1.5%
Meson 1.4%
Other 0.4%
2d1f3ce178
Go to file
Matthias Klumpp 2d1f3ce178 Add AV1 video sample for video support tests
2019-09-21 20:10:42 +02:00
contrib Drop wrap files: We don't need them anymore 2019-06-07 22:09:36 +02:00
data Implement improved validation issue reporting 2019-09-01 22:14:16 +02:00
docs Wire up locale processing 2019-01-27 21:22:27 +01:00
src Only add remote icons if we have a mediaBaseUrl and also permit image caches 2019-09-18 22:16:18 +02:00
tests Add AV1 video sample for video support tests 2019-09-21 20:10:42 +02:00
.gitignore Add initial code and primitives 2016-03-03 20:59:03 +01:00
.travis.yml ci: Build with GDC 9 2019-02-16 21:53:46 +01:00
LICENSE Update license 2016-03-03 20:59:11 +01:00
MAINTAINERS Add more documentation 2016-03-29 03:09:26 +02:00
meson_options.txt Fetch JavaScript bits with Yarn instead of Bower 2018-04-03 22:15:23 +02:00
meson.build Bump dependency on AppStream 2019-09-01 01:19:45 +02:00
NEWS Release version 0.7.7 2019-02-24 18:59:43 +01:00
README.md trivial: Update dependency list in README 2019-06-07 22:11:23 +02:00
RELEASE trivial: post release version bump 2019-02-24 19:00:43 +01:00
TODO trivial: Fonts are done 2016-10-03 18:56:09 +02:00

README.md

AppStream Generator

AppStream is an effort to provide additional metadata and unique IDs for all software available in a Linux system. This repository contains the server-side of the AppStream infrastructure, a tool to generate metadata from distribution packages. You can find out more about AppStream collection metadata at Freedesktop.

The AppStream generator is currently primarily used by Debian, but is written in a distribution agnostic way. Backends only need to implement two interfaces to to be ready.

If you are looking for the AppStream client-tools, the AppStream repository is where you want to go.

AppStream Generator Logo

Development

Build Status

Build dependencies

  • LDC1
  • Meson (>= 0.46) 2
  • GLibD 3
  • AppStream 4
  • libarchive (>= 3.2) 5
  • LMDB 6
  • GirToD 7
  • Cairo
  • GdkPixbuf 2.0
  • RSvg 2.0
  • FreeType
  • Fontconfig
  • Pango
  • Yarn (optional) 8

On Debian and derivatives of it, all build requirements can be installed using the following command:

sudo apt install meson ldc gir-to-d libappstream-dev libgdk-pixbuf2.0-dev libarchive-dev \
    librsvg2-dev liblmdb-dev libcairo2-dev libcurl4-gnutls-dev libfreetype6-dev libfontconfig1-dev \
    libpango1.0-dev libglibd-2.0-dev

Build instructions

To build the tool with Meson, create a build subdirectory, change into it and run meson .. && ninja to build. In summary:

$ mkdir build && cd build
$ meson -Ddownload-js=true ..
$ ninja
$ sudo ninja install

We support several options to be set to influence the build. Change into the build directory and run mesonconf to see them all.

You might want to perform an optimized debug build by passing --buildtype=debugoptimized to meson or just do a release build straight away with --buildtype=release in case you want to use the resulting binaries productively. By default, the build happens without optimizations which slows down the generator.

Usage

Take a look at the docs/ directory in the source tree for information on how to use the generator and write configuration files for it.

Hacking

Pull-requests and patches are very welcome! If you are new to D, it is highly recommended to take a few minutes to look at the D tour to get a feeling of what the language can do: https://tour.dlang.org/