locksafe 0.3.2__tar.gz

locksafe-0.3.2/.github/workflows/publish-to-pip.yml

@@ -0,0 +1,71 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+
+    runs-on: ubuntu-latest
+
+    steps:
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Read version from pyproject.toml
+        id: version
+        run: |
+          python - <<EOF
+          import tomllib
+          with open("pyproject.toml","rb") as f:
+              data = tomllib.load(f)
+          version = data["project"]["version"]
+          print("VERSION="+version)
+          with open("$GITHUB_ENV","a") as f:
+              f.write("VERSION="+version+"\n")
+          EOF
+
+      - name: Check if tag already exists
+        id: tagcheck
+        run: |
+          if git rev-parse "v${VERSION}" >/dev/null 2>&1; then
+            echo "Tag already exists"
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create git tag
+        if: steps.tagcheck.outputs.exists == 'false'
+        run: |
+          git config user.name "github-actions"
+          git config user.email "actions@github.com"
+          git tag v${VERSION}
+          git push origin v${VERSION}
+
+      - name: Build package
+        run: |
+          python -m build
+
+      - name: Publish to PyPI
+        run: |
+          twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}

locksafe-0.3.2/.github/workflows/release.yml

@@ -0,0 +1,49 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Extract version
+        if: github.event_name == 'push'
+        id: version
+        run: |
+          VERSION=$(grep '^version' pyproject.toml | head -1 | cut -d '"' -f2)
+          echo "version=v$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        if: github.event_name == 'push'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.version }}
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

locksafe-0.3.2/.gitignore

@@ -0,0 +1,205 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+myenv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+.vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+test-migrations/

locksafe-0.3.2/.locksafe.toml

@@ -0,0 +1,5 @@
+[locksafe]
+dialect = "postgres"
+severity_threshold = "LOW"
+exclude_patterns = []
+ignore = []

locksafe-0.3.2/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.15.6
+  hooks:
+    - id: ruff-check
+      args: [ --fix ]
+    - id: ruff-format

locksafe-0.3.2/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: locksafe
+Version: 0.3.2
+Summary: Postgres migration safety analyzer — catch dangerous operations before they run
+Project-URL: Homepage, https://locksafe.dev
+Project-URL: Repository, https://github.com/yourusername/locksafe
+Project-URL: Issues, https://github.com/yourusername/locksafe/issues
+License: MIT
+Keywords: ci-cd,database,migrations,postgres,safety
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: sqlglot[c]>=25.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typing-extensions>=4.12.0
+Provides-Extra: api
+Requires-Dist: asyncpg>=0.29.0; extra == 'api'
+Requires-Dist: boto3>=1.35.0; extra == 'api'
+Requires-Dist: fastapi>=0.115.0; extra == 'api'
+Requires-Dist: pydantic>=2.0.0; extra == 'api'
+Requires-Dist: python-multipart>=0.0.9; extra == 'api'
+Requires-Dist: razorpay>=1.4.0; extra == 'api'
+Requires-Dist: sentry-sdk[fastapi]>=2.0.0; extra == 'api'
+Requires-Dist: uvicorn[standard]>=0.30.0; extra == 'api'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27.0; extra == 'dev'
+Requires-Dist: mypy>=1.11.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🔒 LockSafe
+
+> **Stop production downtime caused by unsafe Postgres migrations — before they ever run.**
+
+LockSafe analyzes Postgres migration files, detects dangerous operations, estimates lock duration, and rewrites migrations using safe patterns — integrated directly into CI/CD.
+
+---
+
+## The Product
+
+| | |
+|---|---|
+| **Problem** | Alembic, Flyway, Liquibase run migrations with zero safety awareness |
+| **Solution** | Pre-run static analyzer + CI/CD integration + safe rewrite engine |
+| **Free tier** | `pip install locksafe` — local CLI, forever free, no account needed |
+| **Team plan** | ₹1,499/mo — GitHub Action, PR comments, lock estimator, dashboard |
+| **Business plan** | ₹4,999/mo — safe rewrite engine, Slack alerts, audit log |
+| **MRR target** | ₹50,000 by Month 3 · ₹2,00,000 by Month 9 |
+
+---
+
+## Build Timeline
+
+| Phase | Dates | Status |
+|---|---|---|
+| Project setup + CLI scaffold | Mar 14 – Mar 28 | 🟡 In progress |
+| SQL parser + risk rule engine | Mar 28 – Apr 18 | ⬜ Upcoming |
+| Safe rewrite engine | Apr 18 – May 9 | ⬜ Upcoming |
+| GitHub Actions integration | May 9 – May 23 | ⬜ Upcoming |
+| Payments + landing page | May 23 – May 30 | ⬜ Upcoming |
+| Beta testing + bug fixes | May 30 – Jun 12 | ⬜ Upcoming |
+| **Public launch** | **Jun 12, 2026** | ⬜ Upcoming |
+| First revenue target | Jun 26, 2026 | ⬜ Upcoming |
+
+---
+
+## Repo Structure
+
+```
+.
+├── README.md
+│
+├── docs/                          # Business, strategy, and product decisions
+│   ├── Idea/                      # Problem discovery, market research, competition
+│   ├── Validation/                # Customer interviews, waitlist, pre-sales
+│   ├── Planning/                  # Roadmap, MVP scope, tech stack, dev plan
+│   ├── Design/                    # Wireframes, UX flows, design system
+│   ├── Launch/                    # Landing page, Product Hunt, early adopters
+│   ├── Acquisition/               # SEO, content, social, cold email
+│   ├── Distribution/              # Directories, communities, partnerships
+│   ├── Conversion/                # Funnel, pricing, freemium, checkout
+│   ├── Revenue/                   # Subscriptions, upsells, enterprise
+│   ├── Analytics/                 # Tracking, funnels, KPIs, A/B tests
+│   ├── Retention/                 # Onboarding, email automation, churn
+│   ├── Growth/                    # Referrals, PLG, viral loops
+│   └── Scaling/                   # Automation, hiring, exit
+│
+└── tech/                          # Engineering decisions and implementation docs
+    ├── Development/               # Backend, frontend, APIs, database, auth
+    ├── Infrastructure/            # Cloud hosting, DevOps, CI/CD, monitoring
+    └── Testing/                   # Unit, integration, performance, beta
+```
+
+---
+
+## Tech Stack
+
+```
+CLI          → Python + Click       pip install locksafe
+SQL Parser   → sqlglot              Postgres AST, no regex
+Backend API  → FastAPI + asyncpg    Async, raw SQL, no ORM
+Database     → PostgreSQL           RDS on AWS
+File Storage → AWS S3               Report archives
+Payments     → Razorpay             Subscriptions + webhooks
+Deployment   → Docker Compose → EC2 (MVP)  →  EKS + Terraform (post-revenue)
+```
+
+---
+
+## Quick Links
+
+| | |
+|---|---|
+| Product & feature spec | [docs/Planning/MVP-Scope](docs/Planning/MVP-Scope/README.md) |
+| Full roadmap | [docs/Planning/Product-Roadmap](docs/Planning/Product-Roadmap/README.md) |
+| Tech stack decisions | [docs/Planning/Tech-Stack](docs/Planning/Tech-Stack/README.md) |
+| Development plan | [docs/Planning/Development-Plan](docs/Planning/Development-Plan/README.md) |
+| Pricing strategy | [docs/Conversion/Pricing-Strategy](docs/Conversion/Pricing-Strategy/README.md) |
+| Backend architecture | [tech/Development/Backend](tech/Development/Backend/README.md) |
+| Database schema | [tech/Development/Database](tech/Development/Database/README.md) |
+| CI/CD setup | [tech/Infrastructure/CI-CD](tech/Infrastructure/CI-CD/README.md) |
+| Competitor analysis | [docs/Idea/Competitor-Analysis](docs/Idea/Competitor-Analysis/README.md) |
+| KPI dashboard | [docs/Analytics/KPI-Dashboard](docs/Analytics/KPI-Dashboard/README.md) |
+
+---
+
+*Solo build · Part-time · 10–20 hrs/week · Started March 14, 2026*

locksafe-0.3.2/README.md

@@ -0,0 +1,97 @@
+# 🔒 LockSafe
+
+> **Stop production downtime caused by unsafe Postgres migrations — before they ever run.**
+
+LockSafe analyzes Postgres migration files, detects dangerous operations, estimates lock duration, and rewrites migrations using safe patterns — integrated directly into CI/CD.
+
+---
+
+## The Product
+
+| | |
+|---|---|
+| **Problem** | Alembic, Flyway, Liquibase run migrations with zero safety awareness |
+| **Solution** | Pre-run static analyzer + CI/CD integration + safe rewrite engine |
+| **Free tier** | `pip install locksafe` — local CLI, forever free, no account needed |
+| **Team plan** | ₹1,499/mo — GitHub Action, PR comments, lock estimator, dashboard |
+| **Business plan** | ₹4,999/mo — safe rewrite engine, Slack alerts, audit log |
+| **MRR target** | ₹50,000 by Month 3 · ₹2,00,000 by Month 9 |
+
+---
+
+## Build Timeline
+
+| Phase | Dates | Status |
+|---|---|---|
+| Project setup + CLI scaffold | Mar 14 – Mar 28 | 🟡 In progress |
+| SQL parser + risk rule engine | Mar 28 – Apr 18 | ⬜ Upcoming |
+| Safe rewrite engine | Apr 18 – May 9 | ⬜ Upcoming |
+| GitHub Actions integration | May 9 – May 23 | ⬜ Upcoming |
+| Payments + landing page | May 23 – May 30 | ⬜ Upcoming |
+| Beta testing + bug fixes | May 30 – Jun 12 | ⬜ Upcoming |
+| **Public launch** | **Jun 12, 2026** | ⬜ Upcoming |
+| First revenue target | Jun 26, 2026 | ⬜ Upcoming |
+
+---
+
+## Repo Structure
+
+```
+.
+├── README.md
+│
+├── docs/                          # Business, strategy, and product decisions
+│   ├── Idea/                      # Problem discovery, market research, competition
+│   ├── Validation/                # Customer interviews, waitlist, pre-sales
+│   ├── Planning/                  # Roadmap, MVP scope, tech stack, dev plan
+│   ├── Design/                    # Wireframes, UX flows, design system
+│   ├── Launch/                    # Landing page, Product Hunt, early adopters
+│   ├── Acquisition/               # SEO, content, social, cold email
+│   ├── Distribution/              # Directories, communities, partnerships
+│   ├── Conversion/                # Funnel, pricing, freemium, checkout
+│   ├── Revenue/                   # Subscriptions, upsells, enterprise
+│   ├── Analytics/                 # Tracking, funnels, KPIs, A/B tests
+│   ├── Retention/                 # Onboarding, email automation, churn
+│   ├── Growth/                    # Referrals, PLG, viral loops
+│   └── Scaling/                   # Automation, hiring, exit
+│
+└── tech/                          # Engineering decisions and implementation docs
+    ├── Development/               # Backend, frontend, APIs, database, auth
+    ├── Infrastructure/            # Cloud hosting, DevOps, CI/CD, monitoring
+    └── Testing/                   # Unit, integration, performance, beta
+```
+
+---
+
+## Tech Stack
+
+```
+CLI          → Python + Click       pip install locksafe
+SQL Parser   → sqlglot              Postgres AST, no regex
+Backend API  → FastAPI + asyncpg    Async, raw SQL, no ORM
+Database     → PostgreSQL           RDS on AWS
+File Storage → AWS S3               Report archives
+Payments     → Razorpay             Subscriptions + webhooks
+Deployment   → Docker Compose → EC2 (MVP)  →  EKS + Terraform (post-revenue)
+```
+
+---
+
+## Quick Links
+
+| | |
+|---|---|
+| Product & feature spec | [docs/Planning/MVP-Scope](docs/Planning/MVP-Scope/README.md) |
+| Full roadmap | [docs/Planning/Product-Roadmap](docs/Planning/Product-Roadmap/README.md) |
+| Tech stack decisions | [docs/Planning/Tech-Stack](docs/Planning/Tech-Stack/README.md) |
+| Development plan | [docs/Planning/Development-Plan](docs/Planning/Development-Plan/README.md) |
+| Pricing strategy | [docs/Conversion/Pricing-Strategy](docs/Conversion/Pricing-Strategy/README.md) |
+| Backend architecture | [tech/Development/Backend](tech/Development/Backend/README.md) |
+| Database schema | [tech/Development/Database](tech/Development/Database/README.md) |
+| CI/CD setup | [tech/Infrastructure/CI-CD](tech/Infrastructure/CI-CD/README.md) |
+| Competitor analysis | [docs/Idea/Competitor-Analysis](docs/Idea/Competitor-Analysis/README.md) |
+| KPI dashboard | [docs/Analytics/KPI-Dashboard](docs/Analytics/KPI-Dashboard/README.md) |
+
+---
+
+*Solo build · Part-time · 10–20 hrs/week · Started March 14, 2026*

locksafe-0.3.2/docs/Acquisition/Affiliate-Marketing/README.md

@@ -0,0 +1,9 @@
+# Affiliate Marketing
+
+## Status
+
+Planned — see [Product Roadmap](../../Planning/Product-Roadmap/README.md) for timeline.
+
+---
+
+*Last updated: March 2026*

locksafe-0.3.2/docs/Acquisition/Cold-Email/README.md

@@ -0,0 +1,48 @@
+# Cold Email
+
+## Target: Engineering leads and platform engineers at Postgres-using startups
+
+---
+
+## List Building
+
+- LinkedIn search: "platform engineer" + "backend" at Series A/B Indian startups
+- GitHub: contributors to Alembic, Flask-Migrate, Django-migrations
+- AngelList / YC company list filtered by tech stack
+
+---
+
+## Email Template
+
+**Subject:** "Quick question about your Postgres migration workflow"
+
+**Body:**
+Hi [Name],
+
+I'm building LockSafe — a CLI tool that analyzes Postgres migrations before they run and flags dangerous operations (non-concurrent indexes, table rewrites, etc.).
+
+Has your team ever had a migration cause unexpected downtime in production?
+
+If yes, I'd love 15 minutes to understand your workflow and see if LockSafe could help. No pitch — just genuinely trying to understand the problem.
+
+If you're curious: `pip install locksafe && locksafe check <any migration file>` takes 10 seconds.
+
+[Your name]
+
+---
+
+## Personalization Notes
+
+- Reference a specific technology they use (Alembic, SQLAlchemy)
+- Mention any open-source work they've done
+- If they've written about database ops publicly, reference that post
+
+---
+
+## Metrics
+
+Target: 50 emails/week, 20% reply rate, 5% book a call.
+
+---
+
+*Last updated: March 2026*

locksafe-0.3.2/docs/Acquisition/Content-Marketing/README.md

@@ -0,0 +1,40 @@
+# Content Marketing
+
+## Strategy
+
+Educate developers about migration safety. Position LockSafe as the resource they find when they search for this topic.
+
+---
+
+## Content Types
+
+### Blog posts (high effort, high ROI)
+- Deep technical posts on migration dangers
+- "We analyzed 10,000 Alembic migration files — here's what we found"
+- Post-mortems of migration-caused incidents (with permission or fictionalized)
+
+### Twitter/X threads (low effort, fast distribution)
+- "7 Postgres operations that can take down production (thread 🧵)"
+- "The right way to add a NOT NULL column without downtime"
+- Reply to threads about production incidents with helpful context
+
+### README / docs (permanent, compounds)
+- The CLI's README is a content asset
+- Clear, detailed rule explanations in `locksafe explain`
+- Docs site with migration safety guide
+
+---
+
+## Content Calendar (Post-Launch)
+
+| Month | Post |
+|---|---|
+| Jun | "Why we built LockSafe" — founder story post |
+| Jul | "CREATE INDEX CONCURRENTLY: complete guide" |
+| Aug | "Postgres lock types every backend engineer should know" |
+| Sep | "How to add NOT NULL columns to large Postgres tables" |
+| Oct | "Migration horror stories: a collection" |
+
+---
+
+*Last updated: March 2026*

locksafe-0.3.2/docs/Acquisition/Influencer-Outreach/README.md

@@ -0,0 +1,9 @@
+# Influencer Outreach
+
+## Status
+
+Planned — see [Product Roadmap](../Planning/Product-Roadmap/README.md) for timeline.
+
+---
+
+*Last updated: March 2026*