beeware/toga

examples dont work if you follow description

Closed this issue · 3 comments

hanscees commented

Describe the bug

This page in examples says:
https://github.com/beeware/toga/tree/main/examples

Each of the examples should run by installing Toga, and running the application as a Python module:

$ python -m pip install toga
$ cd
$ python -m

it does nort work, there are no subdirectories

Steps to reproduce

cd /home/hanscees/beeware-table
conda create -n beeware1-table
conda activate beeware1-table
conda activate beeware2-table
conda install python=3.12

sudo apt update
sudo apt install git build-essential pkg-config python3-dev libgirepository-2.0-dev libcairo2-dev gir1.2-gtk-3.0 libcanberra-gtk3-module

python -m pip install toga
cd table

there are no subdirectories

Expected behavior

there should be subdirectories with examples

Screenshots

No response

Environment

  • Operating System: Description: Ubuntu 24.04.3 LTS

  • Python version: 3.12

  • Software versions:

    • Briefcase: non, just installed toga
    • Toga: toga-core==0.5.2
    • ...

Logs

Additional context

No response

freakboy3742 commented

I think you've misunderstood the context in which the instructions are given. You've read those instructions in a README, in the examples folder. The instructions are assuming that you're in the examples folder of a checkout of the Toga code respository - as the first line of the README says, "This directory contains example code demonstrating each widget".

If you're running pip install toga and expecting the examples to be there - they won't be.

hanscees commented

I am sorry but while you are undoubtedly technically right, examples are there to help new users. The Readme would be more helpful if it would contain a tip howto get the examples folder checked out via some tutorial or something.
I for one have no clue where to begin.

freakboy3742 commented

Sure - I can see how the instructions are ambiguous. I've included a clarification as part of #3694.