add versioning selection in the back and front end

app.py

@@ -115,11 +115,37 @@ def get_tdoc_url(doc_id):
             return tdoc["url"]
     return "Document not indexed (re-indexing documents ?)"
         
-def get_spec_url(document):
+def version_to_3gpp(version: str) -> str:
+    """Convert semantic version string (e.g. '17.6.0') to 3GPP filename suffix (e.g. 'h60').
+    Returns the input unchanged if it does not look like a semantic version."""
+    parts = version.split(".")
+    if len(parts) != 3:
+        return version
+    try:
+        major, minor, patch = int(parts[0]), int(parts[1]), int(parts[2])
+    except ValueError:
+        return version
+    if major < 10:
+        return version
+    letter = chr(ord('a') + major - 10)
+    return f"{letter}{minor}{patch}"
+
+def get_spec_url(document, version: str = None):
     series = document.split(".")[0].zfill(2)
     url = f"https://www.3gpp.org/ftp/Specs/archive/{series}_series/{document}"
     versions = get_docs_from_url(url)
-    return url + "/" + versions[-1] if versions != [] else f"Specification {document} not found"
+    if not versions:
+        return f"Specification {document} not found"
+    if version:
+        suffix = version_to_3gpp(version)
+        # filename pattern: <specnumber>-<suffix>.zip
+        spec_number = document.replace(".", "")
+        target = f"{spec_number}-{suffix}.zip"
+        for v in versions:
+            if v.lower() == target.lower():
+                return url + "/" + v
+        # fallback to latest if requested version not found
+    return url + "/" + versions[-1]
 
 def get_document(spec_id: str, spec_title: str, source: str):
     text = [f"{spec_id} - {spec_title}"]
@@ -230,14 +256,15 @@ def reconnect():
 def find_document(request: DocRequest):
     start_time = time.time()
     document = request.doc_id
+    requested_version = request.version
     if valid_3gpp_doc_format.match(document):
         url = get_tdoc_url(document)
     elif valid_3gpp_spec_format.match(document):
-        url = get_spec_url(document)
+        url = get_spec_url(document, requested_version)
     elif valid_etsi_doc_format.match(document):
         url = etsi_doc_finder.search_document(document)
     elif valid_etsi_spec_format.match(document):
-        url = etsi_spec_finder.search_document(document)
+        url = etsi_spec_finder.search_document(document, requested_version)
     elif document.startswith("GP"):
         for sp in gp_spec_locations:
             if document.lower() in sp.lower():
@@ -251,6 +278,10 @@ def find_document(request: DocRequest):
     version = None
     if valid_3gpp_spec_format.match(document):
         version = url.split("/")[-1].replace(".zip", "").split("-")[-1]
+    elif valid_etsi_spec_format.match(document):
+        # extract version from the resolved URL path segment before the filename
+        parts = url.rstrip("/").split("/")
+        version = parts[-2] if len(parts) >= 2 else None
     scope = None
     spec_metadatas = spec_metadatas_3gpp if valid_3gpp_spec_format.match(document) else spec_metadatas_etsi
     for spec in spec_metadatas:
@@ -286,6 +317,7 @@ def find_document(request: DocRequest):
 def find_document_batch(request: BatchDocRequest):
     start_time = time.time()
     documents = request.doc_ids
+    requested_version = request.version
     results = {}
     missing = []
 
@@ -293,11 +325,11 @@ def find_document_batch(request: BatchDocRequest):
         if valid_3gpp_doc_format.match(document):
             url = get_tdoc_url(document)
         elif valid_3gpp_spec_format.match(document):
-            url = get_spec_url(document)
+            url = get_spec_url(document, requested_version)
         elif valid_etsi_doc_format.match(document):
-            etsi_doc_finder.search_document(document)
+            url = etsi_doc_finder.search_document(document)
         elif valid_etsi_spec_format.match(document):
-            etsi_spec_finder.search_document(document)
+            url = etsi_spec_finder.search_document(document, requested_version)
         elif document.startswith("GP"):
             for sp in gp_spec_locations:
                 if document.lower() in sp.lower():
@@ -308,7 +340,7 @@ def find_document_batch(request: BatchDocRequest):
             missing.append(document)
         else:
             results[document] = url
-    
+
     return BatchDocResponse(
         results=results,
         missing=missing,

classes.py

@@ -100,7 +100,30 @@ class ETSISpecFinder:
             print(f"Error accessing {url}: {e}")
             return []
     
-    def search_document(self, doc_id: str):
+    def _normalise_version(self, version: str) -> str:
+        """Normalise a user-supplied version string to ETSI zero-padded format.
+        '17.6.0' -> '17.06.00'  (the '_60' release suffix is ignored during matching)
+        Already-normalised strings like '17.06.00' are returned unchanged."""
+        parts = version.strip("/").split(".")
+        if len(parts) == 3:
+            try:
+                return f"{int(parts[0]):02d}.{int(parts[1]):02d}.{int(parts[2]):02d}"
+            except ValueError:
+                pass
+        return version.strip("/")
+
+    def _pick_release(self, releases: list, version: str = None) -> str:
+        """Return the release folder matching version, or the latest if not found/specified."""
+        if version:
+            target = self._normalise_version(version)
+            for r in releases:
+                # folder names are like '17.06.00_60'; match on the part before '_'
+                folder = r.strip("/").split("_")[0]
+                if folder == target:
+                    return r
+        return releases[-1]
+
+    def search_document(self, doc_id: str, version: str = None):
         # Example : 103 666[-2 opt]
         original = doc_id
 
@@ -108,17 +131,21 @@ class ETSISpecFinder:
         url2 = f"{self.second_url}/{self.get_spec_path(original)}/"
         print(url)
         print(url2)
-        
+
         releases = self.get_docs_from_url(url)
-        files = self.get_docs_from_url(url + releases[-1])
-        for f in files:
-            if f.endswith(".pdf"):
-                return url + releases[-1] + "/" + f
-        
+        if releases:
+            release = self._pick_release(releases, version)
+            files = self.get_docs_from_url(url + release)
+            for f in files:
+                if f.endswith(".pdf"):
+                    return url + release + "/" + f
+
         releases = self.get_docs_from_url(url2)
-        files = self.get_docs_from_url(url + releases[-1])
-        for f in files:
-            if f.endswith('.pdf'):
-                return url + releases[-1] + "/" + f
-                    
+        if releases:
+            release = self._pick_release(releases, version)
+            files = self.get_docs_from_url(url2 + release)
+            for f in files:
+                if f.endswith(".pdf"):
+                    return url2 + release + "/" + f
+
         return f"Specification {doc_id} not found"

schemas.py

@@ -4,14 +4,20 @@ from typing import *
 class DocRequest(BaseModel):
     """
     Request model for single document retrieval.
-    
+
     Used to specify which document or specification to retrieve by its unique identifier.
     """
     doc_id: str = Field(
-        ..., 
+        ...,
         title="Document Identifier",
         description="Unique identifier for the document or specification.",
     )
+    version: Optional[str] = Field(
+        None,
+        title="Specification Version",
+        description="Desired version of the specification (e.g. '17.6.0'). Defaults to the latest version when omitted.",
+        examples=["17.6.0", "15.3.1", "18.0.0"]
+    )
 
 class DocResponse(BaseModel):
     """
@@ -48,14 +54,20 @@ class DocResponse(BaseModel):
 class BatchDocRequest(BaseModel):
     """
     Request model for batch document retrieval.
-    
+
     Allows retrieval of multiple documents in a single API call for efficiency.
     """
     doc_ids: List[str] = Field(
-        ..., 
+        ...,
         title="Document Identifier List",
         description="List of document identifiers to retrieve."
     )
+    version: Optional[str] = Field(
+        None,
+        title="Specification Version",
+        description="Desired version applied to all specification lookups in the batch (e.g. '17.6.0'). Defaults to latest when omitted.",
+        examples=["17.6.0", "15.3.1"]
+    )
 
 class BatchDocResponse(BaseModel):
     """

static/script.js

@@ -43,6 +43,18 @@ function switchMode(mode) {
     hideResults();
 }
 
+// Show version field only when the input looks like a spec (ETSI or 3GPP)
+const ETSI_SPEC_RE = /^\d{3} \d{3}/;
+const GPP_SPEC_RE  = /^\d{2}\.\d{3}/;
+
+function toggleVersionField() {
+    const docId = document.getElementById('doc-id').value.trim();
+    const group  = document.getElementById('single-version-group');
+    const isSpec = ETSI_SPEC_RE.test(docId) || GPP_SPEC_RE.test(docId);
+    group.style.display = isSpec ? 'block' : 'none';
+    if (!isSpec) document.getElementById('doc-version').value = '';
+}
+
 // Keyboard shortcuts management
 function setupKeyboardHandlers() {
     document.getElementById('doc-id').addEventListener('keypress', function(e) {
@@ -71,12 +83,16 @@ async function searchSingle() {
     updateHeaderStats('Searching...');
     
     try {
+        const version = document.getElementById('doc-version').value.trim() || null;
+        const body = { doc_id: docId };
+        if (version) body.version = version;
+
         const response = await fetch(`/find/single`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ doc_id: docId })
+            body: JSON.stringify(body)
         });
         
         const data = await response.json();
@@ -118,12 +134,16 @@ async function searchBatch() {
     updateHeaderStats('Searching...');
     
     try {
+        const version = document.getElementById('batch-version').value.trim() || null;
+        const body = { doc_ids: docIds };
+        if (version) body.version = version;
+
         const response = await fetch(`/find/batch`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ doc_ids: docIds })
+            body: JSON.stringify(body)
         });
         
         const data = await response.json();

static/style.css

@@ -136,6 +136,21 @@ body {
     color: var(--text-primary);
 }
 
+.label-hint {
+    font-weight: 400;
+    font-size: 0.8rem;
+    color: var(--text-secondary);
+}
+
+.version-group {
+    animation: fadeIn 0.2s ease;
+}
+
+@keyframes fadeIn {
+    from { opacity: 0; transform: translateY(-4px); }
+    to   { opacity: 1; transform: translateY(0); }
+}
+
 .input-group {
     display: flex;
     gap: 0.75rem;

templates/index.html

@@ -35,10 +35,14 @@
                     <div class="form-group">
                         <label for="doc-id">Document ID</label>
                         <div class="input-group">
-                            <input type="text" id="doc-id" placeholder="e.g., 23.401, S1-123456, SET(24)123">
+                            <input type="text" id="doc-id" placeholder="e.g., 23.401, S1-123456, SET(24)123, 102 223" oninput="toggleVersionField()">
                             <button class="btn btn-primary" onclick="searchSingle()">Search</button>
                         </div>
                     </div>
+                    <div class="form-group version-group" id="single-version-group" style="display:none;">
+                        <label for="doc-version">Version <span class="label-hint">(leave empty for latest)</span></label>
+                        <input type="text" id="doc-version" placeholder="e.g., 17.6.0">
+                    </div>
                 </div>
 
                 <!-- Batch Search -->
@@ -46,8 +50,12 @@
                     <div class="form-group">
                         <label for="batch-ids">List of IDs (one per line)</label>
                         <textarea id="batch-ids" placeholder="23.401&#10;S1-123456&#10;103 666" rows="6"></textarea>
-                        <button class="btn btn-primary" onclick="searchBatch()">Search Batch</button>
                     </div>
+                    <div class="form-group version-group">
+                        <label for="batch-version">Version <span class="label-hint">(applies to all specs — leave empty for latest)</span></label>
+                        <input type="text" id="batch-version" placeholder="e.g., 17.6.0">
+                    </div>
+                    <button class="btn btn-primary" onclick="searchBatch()">Search Batch</button>
                 </div>
 
                 <!-- Keyword Search -->