PHP-GTK Client for Gemini Protocol
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
yggverse 404da1fa74 add keyword 2 months ago
src remove demo address replacement 2 months ago
.gitignore initial commit 2 months ago
Cargo.toml add keyword 2 months ago
LICENSE initial commit 2 months ago
README.md update readme 2 months ago
rustfmt.toml init rustfmt.toml 2 months ago

README.md

Yoda - Browser for Gemini protocol

Rust / GTK 4 implementation

[!IMPORTANT] Project in development!

Install

Stable

cargo install Yoda

Repository

git clone https://github.com/YGGverse/Yoda.git
cd Yoda
git checkout Rust-GTK4
cargo run

Development

This guide in process

Modules

browser

  • Composition pattern, using standard mod.rs model
  • One mod = one widget. Create new mod for new widget implementation
  • The codebase of module must be as minimal as possible: separate different tasks to sub-modules
  • Every module must:
    • access 1 level of child API, never parents (e.g.super)
    • implement only one struct (same as one file for one class)
      • struct is public, where members - private
    • contain struct implementation:
      • at least one constructor that must return:
        • raw struct (new() -> Self) without cover to any kind of smart std or glib pointers
        • ownership to new object created
      • one public link getter for privately constructed widget (widget -> &Gtk)

Contribution

  • before commit, make sure:
    • new branch created for every new PR git checkout -b 'contribution-name'
    • new code follows common rustfmt style cargo fmt --check

See also

  • CPP-GTK4 - C++ / GTK 4 implementation
  • PHP-GTK3 - PHP / GTK 3 experimental branch