release 1.0

Author: pvsr

CHANGELOG.md

@@ -1,8 +1,6 @@
 # 1.0rc4
-  - built in support for more wayland menus:
-    - walker
-    - tofi
-    - wmenu
+  - `choose`: support `walker`, `tofi`, and `wmenu`
+  - better detection of invalid/nonexistent profiles
 
 # 1.0rc3
   - breaking: stop sourcing files from `~/.config/qutebrowser/conf.d/`
@@ -17,6 +15,22 @@
   - make generated `.desktop` files match qutebrowser's more closely
 
 # 1.0rc2:
-  - `choose`: builtin support for `fzf` and `fuzzel`
-  - moved argument handling to click
+  - `choose`: support `fzf` and `fuzzel`
+  - use `click `for CLI parsing
   - `qbpm launch`'s `-n`/`--new` renamed to `-c`/`--create`
+  - expand fish shell completions
+
+# 1.0rc:
+  - add a man page
+
+# 0.6
+  - better error handling
+
+# 0.5
+  - `choose`: support custom menu command
+  - `choose`: support `dmenu-wl` and `wofi`
+
+# 0.4
+  - `choose` subcommand (thanks, @mtoohey31!)
+  - load autoconfig.yml by default
+  - shell completions for fish

README.md

@@ -18,45 +18,39 @@ windows. But launching two distinct profiles will start two entirely separate
 instances of qutebrowser which can be opened and closed independently.
 
 ## Usage
-Create a new profile called "python", edit its `config.py`, then launch it:
+To create a new profile called "python" and launch it with the python docs open:
 ```
 $ qbpm new python
-$ qbpm edit python
 $ qbpm launch python docs.python.org
-$ qbpm choose # run dmenu or another launcher to pick a profile
 ```
 
-`qbpm from-session` can copy the tabs of a [saved qutebrowser
-session](https://qutebrowser.org/doc/help/commands.html#session-save) to a new
-profile. If you have a window full of tabs related to planning a vacation, you
-could save it to a session called "vacation" using `:session-save -o vacation`
-in qutebrowser, then create a new profile with those tabs:
-```
-$ qbpm from-session vacation
-```
+Note that all arguments after `qbpm launch PROFILE` are passed to qutebrowser,
+so options can be passed too: `qbpm launch python --target window pypi.org`.
 
-The default profile directory is `$XDG_DATA_HOME/qutebrowser-profiles`, where
-`$XDG_DATA_HOME` is usually `~/.local/share`, but you can create and launch
-profiles from anywhere using `--profile-dir`/`-P`:
-```
-$ qbpm --profile-dir ~/dev/my-project new qb-profile
-$ cd ~/dev/my-project
-$ qbpm -P . launch qb-profile
-# or
-$ qutebrowser --basedir qb-profile
-```
+If you have multiple profiles you can use `qbpm choose` to bring up a list of
+profiles and select one to launch. Depending on what your system has available
+the menu may be `dmenu`, `fuzzel`, `fzf`, an applescript dialog, or one of many
+other menu programs qbpm can detect. Any dmenu-compatible menu can be used with
+`--menu`, e.g. `qbpm choose --menu 'fuzzel --dmenu'`. As with `qbpm launch`,
+extra arguments are passed to qutebrowser.
+
+Run `qbpm --help` to see other available commands.
+
+By default when you create a new profile a `.desktop` file is created that
+launches the profile. This launcher does not depend on qbpm at all, so if you
+want you can run `qbpm new` once and keep using the profile without needing
+qbpm installed on your system.
 
 ## Installation
 If you use Nix, you can install or run qbpm as a [Nix flake](https://nixos.wiki/wiki/Flakes).
 For example, to run qbpm without installing it you can use `nix run github:pvsr/qbpm -- new my-profile`.
 
 On Arch and derivatives, you can install the AUR package: [qbpm-git](https://aur.archlinux.org/packages/qbpm-git).
 
-Otherwise you'll need to install from source, directly or using a tool like [uv](https://docs.astral.sh/uv/guides/tools/).
-Using uv you can run qbpm without installing it using
-`uv tool run --with git+https://github.com/pvsr/qbpm qbpm`, or install to `~/.local/bin` with
-`uv tool install --with git+https://github.com/pvsr/qbpm qbpm`.
-The downside of a source installation is that the [man page](https://github.com/pvsr/qbpm/blob/main/qbpm.1.scd)
+Otherwise you can install directly from PyPI using [uv](https://docs.astral.sh/uv/guides/tools/),
+pip, or your preferred client. With uv it's `uv tool run qbpm` to run qbpm
+without installing and `uv tool install qbpm` to install to `~/.local/bin`.
+The downside of going through PyPI is that the [man page](https://github.com/pvsr/qbpm/blob/main/qbpm.1.scd)
 and shell completions will not be installed automatically.
 
 On Linux you can copy [`contrib/qbpm.desktop`](https://raw.githubusercontent.com/pvsr/qbpm/main/contrib/qbpm.desktop)
@@ -66,11 +60,10 @@ to `~/.local/share/applications` to create a qbpm desktop application that runs
 ### MacOS
 
 Nix and uv will install qbpm as a command-line application, but if you want a
-native Mac application you can clone this repository or copy the contents of
-[`contrib/qbpm.platypus`](https://raw.githubusercontent.com/pvsr/qbpm/main/contrib/qbpm.platypus)
-to a local file, install [platypus](https://sveinbjorn.org/platypus),
-and create a qbpm app by running `platypus -P qbpm.platypus /Applications/qbpm.app`.
-That will also make qbpm available as a default browser in `System Preferences > General > Default web browser`.
+native Mac application you can download [`contrib/qbpm.platypus`](https://raw.githubusercontent.com/pvsr/qbpm/main/contrib/qbpm.platypus),
+install [platypus](https://sveinbjorn.org/platypus), and create a qbpm app with
+`platypus -P qbpm.platypus /Applications/qbpm.app`. That will also make qbpm
+available as a default browser in `System Preferences > General > Default web browser`.
 
 Note that there is currently [a qutebrowser bug](https://github.com/qutebrowser/qutebrowser/issues/3719)
 that results in unnecessary `file:///*` tabs being opened.

pyproject.toml

@@ -1,13 +1,12 @@
 [project]
 name = "qbpm"
-version = "1.0rc4"
+version = "1.0"
 description = "qutebrowser profile manager"
 license = "GPL-3.0-or-later"
 license-files = ["LICENSE"]
 readme = "README.md"
 authors = [{ name = "Peter Rice", email = "[email protected]" }]
 classifiers = [
-    "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: End Users/Desktop",
     "Operating System :: MacOS",