aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNao Pross <np@0hm.ch>2021-02-11 19:09:00 +0100
committerNao Pross <np@0hm.ch>2021-02-11 19:28:49 +0100
commitf2cffe5df0cbc32f819b0e8e2a7ed8d60fd76fdd (patch)
tree13ef2186ff14d769af7349927922067a234a8d24
parentAdd dev dependency pycodestyle to replace PEP8 (diff)
downloadMuddle-f2cffe5df0cbc32f819b0e8e2a7ed8d60fd76fdd.tar.gz
Muddle-f2cffe5df0cbc32f819b0e8e2a7ed8d60fd76fdd.zip
Update README
Diffstat (limited to '')
-rw-r--r--README.md68
-rw-r--r--doc/muddle_windows.pngbin0 -> 30182 bytes
2 files changed, 29 insertions, 39 deletions
diff --git a/README.md b/README.md
index 08b9bf5..4186964 100644
--- a/README.md
+++ b/README.md
@@ -1,69 +1,59 @@
# Muddle (Work in progress!)
A desktop Moodle client, because the web interface is painfully slow if you quickly need to grab a file.
-![](./muddle.png)
+<table><tr>
+ <td><img src="doc/muddle.png"/></td>
+ <td><img src="doc/muddle_windows.png"/></td>
+</tr></table>
## Configuration
On linux, copy `muddle.ini.sample` to `~/.config/muddle/muddle.ini` and add a token.
On other platforms there is no specific path implemented yet, so it will look for a file `muddle.ini` in the same folder as the executable.
## Development
-This is written in Python 3 + PyQt. VirtualEnv is probably the most comfortable way to work.
+This is written in Python 3 + PyQt and the dependencies are managed with
+[Poetry](https://python-poetry.org/docs/#installation).
The code is a bit garbage, as I hacked it toghether in one morning, though I've tried to clean it up a bit.
### Linux / MacOS
-If you don't know how to set up a venv, type in you terminal (while in the project directory):
+Check that you have Python >= 3.5, install
+[Poetry](https://python-poetry.org/docs/#installation)
+and then:
```bash
-$ python3 -m venv venv
-$ source ./venv/bin/activate
-(venv) $ pip3 install -r requirements.txt
-(venv) $ ./muddle -v --gui
+$ git clone https://github.com/NaoPross/Muddle.git
+$ cd Muddle
+$ poetry install
+$ poetry run python muddle --gui
```
### Windows
-
1. Install [Python](https://www.python.org), and in the installer enable **Add Python to the path**.
-2. Navigate to the project directory using Explorer, then Shift + Right Click and *Open Powershell Window here*
-3. In the Powershell you can now create a VirtualEnv by typing
-```powershell
-PS> python -m venv venv
-PS> .\venv\Scripts\activate
-(venv) PS> pip3 install -r requirements.txt
-(venv) PS> python muddle.py -v --gui
-```
-
-#### VirtualEnv says `running scripts is diabled on this System`
-If when activating the virtualenv using powershell you get something like this
-```
-.\venv\Scripts\activate : File C:\Users\NaoPross\Documents\Code\Muddle\venv\Scripts\Activate.ps1 cannot be loaded
-because running scripts is disabled on this system. For more information, see about_Execution_Policies at
-https:/go.microsoft.com/fwlink/?LinkID=135170.
-At line:1 char:1
-+ .\venv\Scripts\activate
-+ ~~~~~~~~~~~~~~~~~~~~~~~
- + CategoryInfo : SecurityError: (:) [], PSSecurityException
- + FullyQualifiedErrorId : UnauthorizedAccess
-```
-You need to change your ExecutionPolicy, to do that you need to type the following to allow for scripts to be executed
+2. Clone this repository
+3. Navigate to the project directory using Explorer, then Shift + Right Click and *Open Powershell Window here*
+4. In the Powershell you can now start working with
```powershell
-PS> Get-ExecutionPolicy -List # see the current settings
-PS> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # allow your user to run script
+PS> poetry install
+PS> poetry run python muddle --gui
```
### Coding style
-
-Use PEP8 except where Qt bindings are used (`gui.py`). To check use
+Use pycodestyle (PEP8) except where Qt bindings are used (`gui.py`). To check use
```
-$ pep8 --show-source --ignore=E501 moodle.py muddle.py <more files...>
+$ poetry run pycodestyle --show-source --ignore=E501 muddle/__main__.py muddle/moodle.py
```
### Compilation / Release
+<!-- TODO: fix this, because it doesn't work (poetry bug, will be fixed by poetry bundle) -->
To create an executable you need PyInstaller, you can get it with
+```bash
+poetry shell
```
-$ pip3 install pyinstaller
-```
-And then run
+On Linux / MacOS:
+```bash
+(poetry) $ pyinstaller --onefile --name muddle --specpath build --add-data "muddle/muddle.ui:muddle/muddle.ui" muddle
```
-$ pyinstaller --onefile muddle
+On Windows (the difference is `;`):
+```powershell
+(poetry) > pyinstaller --onefile --name muddle --specpath build --add-data "muddle/muddle.ui;muddle/muddle.ui" muddle
```
The computer will think for a while, and then once its done there will be a single executable `dist/muddle`.
diff --git a/doc/muddle_windows.png b/doc/muddle_windows.png
new file mode 100644
index 0000000..7a01fd0
--- /dev/null
+++ b/doc/muddle_windows.png
Binary files differ