collaborativenotes-utils 0.1.0__tar.gz

collaborativenotes_utils-0.1.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: collaborativenotes-utils
+Version: 0.1.0
+Summary: Scoring, ranking and search utilities for CollaborativeNotes
+Author: Ayush Singh
+Project-URL: Homepage, https://github.com/yourusername/collaborativenotes-utils
+Keywords: notes,scoring,ranking,search,education
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# collaborativenotes-utils
+
+Scoring, ranking and search utilities for the CollaborativeNotes Django app.
+
+## Install
+
+```bash
+pip install collaborativenotes-utils
+```
+
+## Usage
+
+```python
+from collaborativenotes_utils import rank_notes, calculate_weighted_rating, search_score
+
+# Rank notes by relevance to a search query + rating + downloads
+ranked = rank_notes(notes, query="databases")
+
+# Bayesian weighted rating (avoids bias from notes with few votes)
+rating = calculate_weighted_rating([5, 4, 3, 5, 4])
+
+# Get a single note's relevance score
+score = search_score(note, query="normalisation")
+```

collaborativenotes_utils-0.1.0/README.md

@@ -0,0 +1,24 @@
+# collaborativenotes-utils
+
+Scoring, ranking and search utilities for the CollaborativeNotes Django app.
+
+## Install
+
+```bash
+pip install collaborativenotes-utils
+```
+
+## Usage
+
+```python
+from collaborativenotes_utils import rank_notes, calculate_weighted_rating, search_score
+
+# Rank notes by relevance to a search query + rating + downloads
+ranked = rank_notes(notes, query="databases")
+
+# Bayesian weighted rating (avoids bias from notes with few votes)
+rating = calculate_weighted_rating([5, 4, 3, 5, 4])
+
+# Get a single note's relevance score
+score = search_score(note, query="normalisation")
+```

collaborativenotes_utils-0.1.0/collaborativenotes_utils/__init__.py

@@ -0,0 +1,5 @@
+from .scoring import rank_notes, calculate_weighted_rating, search_score
+from .collections import group_by_collection
+
+__version__ = "0.1.0"
+__all__ = ["rank_notes", "calculate_weighted_rating", "search_score"]

collaborativenotes_utils-0.1.0/collaborativenotes_utils/collections.py

@@ -0,0 +1,7 @@
+def group_by_collection(notes: list) -> dict:
+
+    groups = {}
+    for note in notes:
+        name = note.get("collection", "").strip() or "Uncategorised"
+        groups.setdefault(name, []).append(note)
+    return groups

collaborativenotes_utils-0.1.0/collaborativenotes_utils/scoring.py

@@ -0,0 +1,32 @@
+def search_score(note: dict, query: str = "") -> float:
+   
+    score = 0.0
+    q = query.strip().lower()
+
+    if q:
+        if q in note.get("title", "").lower():
+            score += 10
+        if q in note.get("subject", "").lower():
+            score += 7
+        if q in note.get("description", "").lower():
+            score += 5
+
+    # Rating boost (avg_rating stored as string in DynamoDB)
+    try:
+        score += float(note.get("avg_rating", 0)) * 2
+    except (ValueError, TypeError):
+        pass
+
+    # Popularity boost (capped so viral notes don't dominate)
+    try:
+        score += min(int(note.get("download_count", 0)), 50) * 0.1
+    except (ValueError, TypeError):
+        pass
+
+    return score
+
+
+def rank_notes(notes: list, query: str = "") -> list:
+   
+    return sorted(notes, key=lambda n: search_score(n, query), reverse=True)
+

collaborativenotes_utils-0.1.0/collaborativenotes_utils.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: collaborativenotes-utils
+Version: 0.1.0
+Summary: Scoring, ranking and search utilities for CollaborativeNotes
+Author: Ayush Singh
+Project-URL: Homepage, https://github.com/yourusername/collaborativenotes-utils
+Keywords: notes,scoring,ranking,search,education
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# collaborativenotes-utils
+
+Scoring, ranking and search utilities for the CollaborativeNotes Django app.
+
+## Install
+
+```bash
+pip install collaborativenotes-utils
+```
+
+## Usage
+
+```python
+from collaborativenotes_utils import rank_notes, calculate_weighted_rating, search_score
+
+# Rank notes by relevance to a search query + rating + downloads
+ranked = rank_notes(notes, query="databases")
+
+# Bayesian weighted rating (avoids bias from notes with few votes)
+rating = calculate_weighted_rating([5, 4, 3, 5, 4])
+
+# Get a single note's relevance score
+score = search_score(note, query="normalisation")
+```

collaborativenotes_utils-0.1.0/collaborativenotes_utils.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+collaborativenotes_utils/__init__.py
+collaborativenotes_utils/collections.py
+collaborativenotes_utils/scoring.py
+collaborativenotes_utils.egg-info/PKG-INFO
+collaborativenotes_utils.egg-info/SOURCES.txt
+collaborativenotes_utils.egg-info/dependency_links.txt
+collaborativenotes_utils.egg-info/top_level.txt

collaborativenotes_utils-0.1.0/collaborativenotes_utils.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

collaborativenotes_utils-0.1.0/collaborativenotes_utils.egg-info/top_level.txt

@@ -0,0 +1 @@
+collaborativenotes_utils

collaborativenotes_utils-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "collaborativenotes-utils"
+version = "0.1.0"
+description = "Scoring, ranking and search utilities for CollaborativeNotes"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "Ayush Singh" }]
+keywords = ["notes", "scoring", "ranking", "search", "education"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/collaborativenotes-utils"

collaborativenotes_utils-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+