fixing the results folder structure for exporting the outputs

- fixing the results folder structure for exporting the outputs
- adding github actions for PYPI

Author: Advait Patel

.DS_Store

@@ -0,0 +1,70 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'  # Triggers on version tags like v0.0.21, v1.0.0, etc.
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.12'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Extract version from tag
+      id: get_version
+      run: |
+        # Get the tag name (e.g., v0.0.21)
+        TAG=${GITHUB_REF#refs/tags/v}
+        echo "VERSION=$TAG" >> $GITHUB_OUTPUT
+        echo "Publishing version: $TAG"
+    
+    - name: Verify version matches setup.py
+      run: |
+        SETUP_VERSION=$(python -c "import re; content=open('setup.py').read(); print(re.search(r'version=\"([^\"]+)\"', content).group(1))")
+        TAG_VERSION="${{ steps.get_version.outputs.VERSION }}"
+        echo "setup.py version: $SETUP_VERSION"
+        echo "Git tag version: $TAG_VERSION"
+        if [ "$SETUP_VERSION" != "$TAG_VERSION" ]; then
+          echo "ERROR: Version mismatch!"
+          echo "setup.py has version $SETUP_VERSION but git tag is v$TAG_VERSION"
+          exit 1
+        fi
+        echo "✅ Versions match!"
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Check distribution files
+      run: |
+        ls -lh dist/
+        twine check dist/*
+    
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        twine upload dist/*
+    
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v1
+      with:
+        generate_release_notes: true
+        files: |
+          dist/*.tar.gz
+          dist/*.whl

.github/workflows/publish-to-pypi.yml

@@ -193,12 +193,3 @@ SESSION_SUMMARY.md
 CURSOR_CONFIGURATION.md
 
 # Internal/maintainer documentation (not for public repository)
-PUBLISHING_GUIDE.md
-RELEASE_CHECKLIST.md
-IMPLEMENTATION_SUMMARY.md
-COMMIT_GUIDE.md
-PYPI_UPLOAD_READY.md
-REDDIT_POSTS.md
-CLEANUP_PLAN.md
-CLEANUP_SUMMARY.md
-CLEANUP_COMPLETE.md

.gitignore

@@ -199,6 +199,10 @@ Quick links:
 **"Python version not supported"**  
 → DockSec requires Python 3.12+. Use `pyenv install 3.12` to upgrade.
 
+**"Where are my scan results?"**  
+→ Results are saved to `results/` directory in your DockSec installation  
+→ Customize location: `export DOCKSEC_RESULTS_DIR=/custom/path`
+
 For more issues, see [Troubleshooting Guide](docs/CONTRIBUTING.md#troubleshooting).
 
 ## License

README.md

@@ -52,10 +52,13 @@ def get_openai_api_key() -> str:
 
 BASE_DIR: str = os.path.abspath(os.path.dirname(__file__))
 
-# RESULTS_DIR = os.path.join(BASE_DIR, "results")
-RESULTS_DIR: str = os.path.join(os.getcwd(), "results")
+# Results directory configuration
+# Priority: 1. Environment variable, 2. DockSec installation directory (default)
+# Users can customize by setting: export DOCKSEC_RESULTS_DIR=/custom/path
+RESULTS_DIR: str = os.getenv("DOCKSEC_RESULTS_DIR", os.path.join(BASE_DIR, "results"))
 
-os.makedirs(os.path.dirname(RESULTS_DIR), exist_ok=True)
+# Create results directory if it doesn't exist
+os.makedirs(RESULTS_DIR, exist_ok=True)
 
 
 

config.py

@@ -944,7 +944,13 @@ def generate_all_reports(self, results: Dict) -> Dict:
                 report_paths['html'] = html_path
             progress.update(html_task, advance=1)
 
-        print("\n[SUCCESS] All reports generated successfully!")
+        print("[SUCCESS] All reports generated successfully!")
+        print(f"Results location: {self.RESULTS_DIR}")
+        print(f"\nGenerated files:")
+        for report_type, path in report_paths.items():
+            if path:
+                print(f"   • {report_type.upper()}: {os.path.basename(path)}")
+        
         return report_paths
 
     def get_security_score(self, results: Dict) -> float:

docker_scanner.py

@@ -3,7 +3,7 @@
 import glob
 setup(
     name="docksec",
-    version="0.0.20",
+    version="2026.1.24",
     description="AI-Powered Docker Security Analyzer",
     long_description=open("README.md").read(),
     long_description_content_type="text/markdown",