libreqda 1.2.0.post1__tar.gz → 1.2.1__tar.gz

{libreqda-1.2.0.post1 → libreqda-1.2.1}/CHANGELOG.md

@@ -1,6 +1,17 @@
 LibreQDA Changelog
 ==================
 
+1.2.1 (2026-09-24)
+------------------
+- New features:
+  - Rename a project on SQLite3 import
+  - Outdated-version banner shown on every install method
+- Bugfixes:
+  - Extracts no longer bloat to full document via orphan highlights
+  - `TagDelete` now also removes highlights whose only tag was the one deleted
+- Docs:
+  - README: clearer Docker and dev setup instructions
+
 1.2.0 (2026-09-10)
 ------------------
 - New features:

{libreqda-1.2.0.post1 → libreqda-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libreqda
-Version: 1.2.0.post1
+Version: 1.2.1
 Summary: Free and open source qualitative research tool
 Home-page: https://www.libreqda.org/
 License: BSD-3-Clause
@@ -111,24 +111,37 @@ Docker
 ------
 
     docker pull phunudes/libreqda
-    docker run -d -p 7465:7465 -v libreqda-data:/data phunudes/libreqda
+    docker run -d --name libreqda -p 7465:7465 -v libreqda-data:/data phunudes/libreqda
+    docker logs libreqda | grep -A1 "is now running"
 
-Browse to [localhost:7465](http://localhost:7465/). Data persists in the `libreqda-data` volume.
+The second command prints the token URL (single-user mode). Browse to it. Data persists in the `libreqda-data` volume.
+
+Prefer to see the token URL live? Drop `-d` and let it run in the foreground — closing the terminal will stop the container, so you'd relaunch each session:
+
+    docker run --name libreqda -p 7465:7465 -v libreqda-data:/data phunudes/libreqda
 
 Development Setup from the Repository
 -------------------------------------
 
-You can install from a local clone of this repository, which will allow you to easily change the sources to suit your needs. Taguette provide the base infrastructure for LibreQDA, which is reflected in these instructions:
-
-1. Clone this git repository from the terminal: `git clone https://gitlab.com/bin-cirst/libreqda/libre-qda/`
-2. Navigate on the command line to the repository you've just cloned locally, using the `cd` command. To get help using `cd`, use [this tutorial](https://swcarpentry.github.io/shell-novice/02-filedir/index.html).
-3. LibreQDA uses [Poetry](https://python-poetry.org/) for its packaging and dependency management. You will need to [install Poetry](https://python-poetry.org/docs/#installation).
-4. Install LibreQDA and its dependencies by running `poetry install`. Poetry will create a virtual environment for you by default, activate it by running `poetry shell`.
-   - To install dependencies for mysql or postgres, use the following command `poetry install -E postgres`. 
-5. Build translation files using `scripts/update_translations.sh`.
-6. You can start LibreQDA in development mode using `libreqda --debug` (or `libreqda --debug server <config_file>`). This will start Tornado in debug mode, which means in particular that it will auto-restart every time you make changes. 
-   1. A config file can be created by running `libreqda default-config > taguette.conf`
-7. Navigate to [localhost:7465](http://localhost:7465/) to use LibreQDA!
+Requires **Python 3.11** (3.12+ fails because `frozenlist 1.3.3` in the lock file has no wheels for it) and [Poetry](https://python-poetry.org/docs/#installation).
+
+```
+git clone https://gitlab.com/bin-cirst/libreqda/libre-qda/
+cd libre-qda
+poetry env use python3.11
+poetry install                          # add -E postgres or -E mysql for those drivers
+poetry run bash scripts/update_translations.sh
+poetry run libreqda --debug             # single-user, local SQLite (~/.local/share/taguette/)
+```
+
+Open [localhost:7465](http://localhost:7465/). Tornado auto-restarts on file changes.
+
+For multi-user mode, generate a config first and pass it to the `server` subcommand:
+
+```
+poetry run libreqda default-config > taguette.conf
+poetry run libreqda --debug server taguette.conf
+```
 
 Create custom theme
 -------------------

{libreqda-1.2.0.post1 → libreqda-1.2.1}/README.md

@@ -54,24 +54,37 @@ Docker
 ------
 
     docker pull phunudes/libreqda
-    docker run -d -p 7465:7465 -v libreqda-data:/data phunudes/libreqda
+    docker run -d --name libreqda -p 7465:7465 -v libreqda-data:/data phunudes/libreqda
+    docker logs libreqda | grep -A1 "is now running"
 
-Browse to [localhost:7465](http://localhost:7465/). Data persists in the `libreqda-data` volume.
+The second command prints the token URL (single-user mode). Browse to it. Data persists in the `libreqda-data` volume.
+
+Prefer to see the token URL live? Drop `-d` and let it run in the foreground — closing the terminal will stop the container, so you'd relaunch each session:
+
+    docker run --name libreqda -p 7465:7465 -v libreqda-data:/data phunudes/libreqda
 
 Development Setup from the Repository
 -------------------------------------
 
-You can install from a local clone of this repository, which will allow you to easily change the sources to suit your needs. Taguette provide the base infrastructure for LibreQDA, which is reflected in these instructions:
-
-1. Clone this git repository from the terminal: `git clone https://gitlab.com/bin-cirst/libreqda/libre-qda/`
-2. Navigate on the command line to the repository you've just cloned locally, using the `cd` command. To get help using `cd`, use [this tutorial](https://swcarpentry.github.io/shell-novice/02-filedir/index.html).
-3. LibreQDA uses [Poetry](https://python-poetry.org/) for its packaging and dependency management. You will need to [install Poetry](https://python-poetry.org/docs/#installation).
-4. Install LibreQDA and its dependencies by running `poetry install`. Poetry will create a virtual environment for you by default, activate it by running `poetry shell`.
-   - To install dependencies for mysql or postgres, use the following command `poetry install -E postgres`. 
-5. Build translation files using `scripts/update_translations.sh`.
-6. You can start LibreQDA in development mode using `libreqda --debug` (or `libreqda --debug server <config_file>`). This will start Tornado in debug mode, which means in particular that it will auto-restart every time you make changes. 
-   1. A config file can be created by running `libreqda default-config > taguette.conf`
-7. Navigate to [localhost:7465](http://localhost:7465/) to use LibreQDA!
+Requires **Python 3.11** (3.12+ fails because `frozenlist 1.3.3` in the lock file has no wheels for it) and [Poetry](https://python-poetry.org/docs/#installation).
+
+```
+git clone https://gitlab.com/bin-cirst/libreqda/libre-qda/
+cd libre-qda
+poetry env use python3.11
+poetry install                          # add -E postgres or -E mysql for those drivers
+poetry run bash scripts/update_translations.sh
+poetry run libreqda --debug             # single-user, local SQLite (~/.local/share/taguette/)
+```
+
+Open [localhost:7465](http://localhost:7465/). Tornado auto-restarts on file changes.
+
+For multi-user mode, generate a config first and pass it to the `server` subcommand:
+
+```
+poetry run libreqda default-config > taguette.conf
+poetry run libreqda --debug server taguette.conf
+```
 
 Create custom theme
 -------------------

{libreqda-1.2.0.post1 → libreqda-1.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "libreqda"
-version = "1.2.0.post1"
+version = "1.2.1"
 description = "Free and open source qualitative research tool"
 packages = [
     { include = "taguette" },

{libreqda-1.2.0.post1 → libreqda-1.2.1}/taguette/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.1.3'
+__version__ = '1.2.1'
 
 
 from gettext import NullTranslations

{libreqda-1.2.0.post1 → libreqda-1.2.1}/taguette/database/copy.py

@@ -17,6 +17,7 @@ tracer = opentelemetry.trace.get_tracer(__name__)
 def copy_project(
         src_db, dest_db,
         project_id, user_login,
+        new_name=None,
 ):
     def copy(
             table, pkey, fkeys, size,
@@ -42,9 +43,11 @@ def copy_project(
     ).fetchone()
     if project is None:
         raise KeyError("project ID not found")
+    project = dict(project)
+    if new_name is not None:
+        project['name'] = new_name
     validate.project_name(project['name'])
     validate.description(project['description'])
-    project = dict(project)
     project.pop('id')
     project['is_archived'] = False
     new_project_id, = insert(Project.__table__, project).inserted_primary_key

{libreqda-1.2.0.post1 → libreqda-1.2.1}/taguette/templates/base.html

@@ -23,7 +23,7 @@
     {% if outdated_version %}
     <div id="version-outdated-banner" class="alert alert-warning alert-dismissible mb-0 rounded-0 border-0 text-center d-none" role="alert" style="position: fixed; top: 6.5em; left: 0; right: 0; z-index: 101;">
       {% set downloads_url = reverse_url('downloads') %}
-      {% trans latest_version=outdated_version, current_version=version, url=downloads_url %}A newer version of LibreQDA ({{ latest_version }}) is available. You are running {{ current_version }}. <a href="{{ url }}">Download the latest installer</a>.{% endtrans %}
+      {% trans latest_version=outdated_version, current_version=version, url=downloads_url %}A newer version of LibreQDA ({{ latest_version }}) is available. You are running {{ current_version }}. <a href="{{ url }}">Update now</a>.{% endtrans %}
       <button type="button" class="btn-close" id="version-outdated-dismiss" aria-label="{% trans %}Close{% endtrans %}"></button>
     </div>
     <script>

{libreqda-1.2.0.post1 → libreqda-1.2.1}/taguette/templates/project_import.html

@@ -21,6 +21,13 @@
       </select>
     </div>
   </div>
+  <div class="form-group row">
+    <label for="new-name" class="col-sm-2 col-form-label">{% trans "form label for new project name" %}New name:{% endtrans %}</label>
+    <div class="col-sm-10">
+      <input type="text" class="form-control" name="new-name" id="new-name" maxlength="200"
+             placeholder="{% trans %}Optional — leave blank to keep the original name{% endtrans %}" disabled>
+    </div>
+  </div>
   <p>
     <input type="submit" class="btn btn-primary" id="submit" value="{% trans "form submit button" %}Import project{% endtrans %}" disabled>
   </p>
@@ -57,6 +64,7 @@ projectFile.addEventListener('change', function() {
         elem.innerText = '' + project.id + ' - ' + project.name;
         projectList.appendChild(elem);
       }
+      document.getElementById('new-name').disabled = false;
       document.getElementById('submit').disabled = false;
     } else {
       console.error("Project upload failed:", xhr.status);
@@ -85,6 +93,10 @@ function importProject() {
   var file = projectFile.files[0];
   var form_data = new FormData();
   form_data.append('project_id', parseInt(document.getElementById('project').value, 10));
+  var newName = document.getElementById('new-name').value.trim();
+  if(newName) {
+    form_data.append('new_name', newName);
+  }
   form_data.append('file', file);
   var xsrf = document.cookie.match('\\b' + '_xsrf' + '=([^;]*)\\b');
   if(xsrf) {

{libreqda-1.2.0.post1 → libreqda-1.2.1}/taguette/version_check.py

@@ -72,7 +72,7 @@ async def _fetch_latest():
         _cache['in_flight'] = False
 
 
-def is_desktop_bundle():
+def is_standalone_bundle():
     return getattr(sys, 'frozen', False)
 
 
@@ -81,9 +81,6 @@ def get_outdated_version():
     if forced:
         return forced
 
-    if not is_desktop_bundle():
-        return None
-
     now = time.time()
     if (
         not _cache['in_flight']

{libreqda-1.2.0.post1 → libreqda-1.2.1}/taguette/web/api.py

@@ -580,6 +580,11 @@ class TagUpdate(BaseHandler):
         tag = self.db.query(database.Tag).get(int(tag_id))
         if tag is None or tag.project_id != project.id:
             return self.send_error_json(404, self.gettext("No such tag"))
+        # Drop highlights that would become orphaned.
+        self.db.query(database.Highlight).filter(
+            database.Highlight.tags.any(database.Tag.id == tag.id),
+            ~database.Highlight.tags.any(database.Tag.id != tag.id),
+        ).delete(synchronize_session=False)
         self.db.delete(tag)
         cmd = database.Command.tag_delete(
             self.current_user,
@@ -1045,7 +1050,8 @@ class Highlights(BaseHandler):
             all_tag_ids = set(t.id for t in hl.tags if t.path not in excluded)
 
             # Find related highlights: any overlap
-            # (identical, contained, containing, or partial)
+            # (identical, contained, containing, or partial).
+            # Skip orphans (no tags) — they inflate the union range.
             related_highlights = (
                 self.db.query(database.Highlight)
                 .options(joinedload(database.Highlight.tags))
@@ -1054,6 +1060,7 @@ class Highlights(BaseHandler):
                     database.Highlight.id != hl.id,
                     database.Highlight.start_offset < hl.end_offset,
                     database.Highlight.end_offset > hl.start_offset,
+                    database.Highlight.tags.any(),
                 )
                 .all()
             )
@@ -1369,7 +1376,12 @@ class ProjectImport(BaseHandler):
                     return await self.send_json({
                         'error': "Invalid project ID",
                     })
-                return await self._import_project(filename, project_id)
+                new_name = (
+                    self.get_body_argument('new_name', '').strip() or None
+                )
+                return await self._import_project(
+                    filename, project_id, new_name=new_name,
+                )
 
     async def _list_projects(self, filename):
         # Connect to the database
@@ -1415,7 +1427,7 @@ class ProjectImport(BaseHandler):
             self.write('{"projects": [')
         return await self.finish(']}')
 
-    async def _import_project(self, filename, project_id):
+    async def _import_project(self, filename, project_id, new_name=None):
         # Connect to the database
         try:
             src_db = database.connect(
@@ -1431,6 +1443,7 @@ class ProjectImport(BaseHandler):
         new_project_id = database.copy_project(
             src_db, self.db,
             project_id, self.current_user,
+            new_name=new_name,
         )
         src_db.close()