Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
resources/ | H | 03-May-2022 | - | |||
src/ | H | 03-May-2022 | - | 159,894 | 140,279 | |
tests/ | H | 03-May-2022 | - | 13 | 7 | |
.cargo-checksum.json | H A D | 03-May-2022 | 89 | 1 | 1 | |
.cargo_vcs_info.json | H A D | 01-Jan-1970 | 74 | 6 | 5 | |
.gitignore | H A D | 22-Jun-2019 | 101 | 13 | 12 | |
.gitmodules | H A D | 22-Jun-2019 | 160 | 7 | 6 | |
.travis.yml | H A D | 22-Jun-2019 | 1.9 KiB | 70 | 69 | |
CHANGELOG.md | H A D | 22-Jun-2019 | 3.7 KiB | 101 | 71 | |
COPYRIGHT | H A D | 22-Jun-2019 | 2.5 KiB | 69 | 65 | |
Cargo.toml | H A D | 01-Jan-1970 | 2.8 KiB | 121 | 97 | |
Cargo.toml.orig-cargo | H A D | 22-Jun-2019 | 1.9 KiB | 73 | 65 | |
Gir.toml | H A D | 22-Jun-2019 | 54.4 KiB | 2,391 | 2,269 | |
LGPL | H A D | 22-Jun-2019 | 24.7 KiB | 483 | 400 | |
LICENSE | H A D | 22-Jun-2019 | 1.1 KiB | 23 | 17 | |
Makefile | H A D | 22-Jun-2019 | 689 | 32 | 23 | |
README.md | H A D | 22-Jun-2019 | 2.5 KiB | 82 | 52 | |
appveyor.yml | H A D | 22-Jun-2019 | 837 | 31 | 27 | |
build.rs | H A D | 22-Jun-2019 | 895 | 32 | 27 | |
check_init_asserts | H A D | 22-Jun-2019 | 541 | 20 | 17 | |
release_process.md | H A D | 22-Jun-2019 | 1.5 KiB | 16 | 12 |
README.md
1# gtk [![Build Status](https://travis-ci.org/gtk-rs/gtk.png?branch=master)](https://travis-ci.org/gtk-rs/gtk) [![Build status](https://ci.appveyor.com/api/projects/status/5mot32ipr12iocw0?svg=true)](https://ci.appveyor.com/project/GuillaumeGomez/gtk) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/gtk-rs/gtk) 2 3[Project site](http://gtk-rs.org/) | [Online documentation](http://gtk-rs.org/docs/) 4 5__Rust__ bindings and wrappers for __GLib__, __GDK 3__, __GTK+ 3__ and __Cairo__. 6 7## Building 8 9__gtk__ expects __GTK+__, __GLib__ and __Cairo__ development files to be installed on your system. 10See the [requirements page](http://gtk-rs.org/docs/requirements.html). 11 12## Using 13 14We recommend using [crates from crates.io](https://crates.io/keywords/gtk-rs), 15as [demonstrated here](http://gtk-rs.org/#using). 16 17If you want to track the bleeding edge, use the git dependency instead: 18 19```toml 20[dependencies] 21gtk = { git = "https://github.com/gtk-rs/gtk.git" } 22``` 23 24Avoid mixing versioned and git crates like this: 25 26```toml 27# This will not compile 28[dependencies] 29gdk = "0.2" 30gtk = { git = "https://github.com/gtk-rs/gtk.git" } 31``` 32 33## Documentation 34 35The majority of the documentation is kept [in a separate repo][gtk-md] due to 36licensing issues. You can pull it in with cargo: 37 38```shell 39> cargo build --features embed-lgpl-docs 40``` 41 42Changes to those doc-comments should be submitted to the `lgpl-docs` repo. Avoid 43including those embedded doc-comments in PRs to this repo. 44 45The opposite feature removes all of those docs regardless of edits: 46 47```shell 48> cargo build --features purge-lgpl-docs 49``` 50 51These features **rewrite the crate sources** so it's sufficient to enable them 52once. **Omitting them in the following `cargo` invocations will not undo their 53effects!** 54 55Generate the docs: 56 57```shell 58> cargo doc --features v3_16 59``` 60 61(if the installed GTK+ version is lower than 3.16, adjust the feature name accordingly). 62 63[gtk-md]: https://github.com/gtk-rs/lgpl-docs/blob/master/README.md 64 65## Contribute 66 67Contributor you're welcome! 68 69See the general [bindings documentation](http://gtk-rs.org/docs/glib/). 70 71Most of the bindings ([`src/auto`](src/auto)) are generated by [gir](https://github.com/gtk-rs/gir) using [this configuration file](Gir.toml). After editing `Gir.toml` the sources can be regenerated with 72 73```shell 74> make gir 75``` 76 77When opening a PR please put the changes to the `src/auto` directory in a separate commit. 78 79## License 80 81__gtk__ is available under the MIT License, please refer to it. 82