fastgram-cli 0.1.6__tar.gz

fastgram_cli-0.1.6/.github/dependabot.yml

@@ -0,0 +1,23 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: daily
+    groups:
+      actions:
+        patterns:
+          - "*"
+    commit-message:
+      prefix: ⬆️
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: monthly
+    groups:
+      python-deps:
+        patterns:
+          - "*"
+    commit-message:
+      prefix: ⬆️

fastgram_cli-0.1.6/.github/workflows/cleanup.yml

@@ -0,0 +1,58 @@
+name: Cleanup Workflow Runs
+
+on:
+  schedule:
+    - cron: '0 0 * * 0'
+  workflow_dispatch:
+
+permissions:
+  actions: write
+  contents: read
+
+jobs:
+  cleanup:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Delete old workflow runs
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const workflowRuns = await github.rest.actions.listWorkflowRuns({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              status: 'completed',
+              per_page: 100
+            });
+            
+            let deleted = 0;
+            const toKeep = 10; // Keep last 10 runs per workflow
+            
+            // Group by workflow
+            const runsByWorkflow = {};
+            for (const run of workflowRuns.data.workflow_runs) {
+              if (!runsByWorkflow[run.workflow_id]) {
+                runsByWorkflow[run.workflow_id] = [];
+              }
+              runsByWorkflow[run.workflow_id].push(run);
+            }
+            
+            // Delete old runs
+            for (const [workflowId, runs] of Object.entries(runsByWorkflow)) {
+              if (runs.length > toKeep) {
+                const oldRuns = runs.slice(toKeep);
+                for (const run of oldRuns) {
+                  try {
+                    await github.rest.actions.deleteWorkflowRun({
+                      owner: context.repo.owner,
+                      repo: context.repo.repo,
+                      run_id: run.id
+                    });
+                    deleted++;
+                  } catch (e) {
+                    console.log(`Failed to delete run ${run.id}: ${e.message}`);
+                  }
+                }
+              }
+            }
+            
+            console.log(`Deleted ${deleted} old workflow runs`);

fastgram_cli-0.1.6/.github/workflows/release.yml

@@ -0,0 +1,83 @@
+name: Release & Publish
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Get version from pyproject
+        id: version
+        run: |
+          VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "version=$VERSION" >> $GITHUB_ENV
+      
+      - name: Check if tag already exists
+        id: tag_check
+        run: |
+          TAG="v${{ env.version }}"
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists, skipping release"
+            echo "skip=true" >> $GITHUB_OUTPUT
+          else
+            echo "skip=false" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Create tag and release
+        if: steps.tag_check.outputs.skip == 'false'
+        run: |
+          TAG="v${{ env.version }}"
+          
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag "$TAG"
+          git push origin "$TAG"
+
+      - name: Create GitHub Release
+        if: steps.tag_check.outputs.skip == 'false'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ env.version }}
+          name: v${{ env.version }}
+          generate_release_notes: true
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Python
+        if: steps.tag_check.outputs.skip == 'false'
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+          
+      - name: Install dependencies
+        if: steps.tag_check.outputs.skip == 'false'
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+          
+      - name: Build package
+        if: steps.tag_check.outputs.skip == 'false'
+        run: python -m build
+        
+      - name: Publish to PyPI
+        if: steps.tag_check.outputs.skip == 'false'
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          twine upload dist/*

fastgram_cli-0.1.6/.github/workflows/welcome.yml

@@ -0,0 +1,46 @@
+name: Welcome Bot
+
+on:
+  issues:
+    types: [opened]
+  pull_request:
+    types: [opened]
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  welcome:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Welcome contributor
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const { issue, pull_request, sender } = context.payload;
+            
+            let message;
+            
+            if (issue) {
+              // Issue opened
+              message = `👋 **Thanks @${sender.login}** for opening this issue! 🎉\n\nWe'll review it soon. Please make sure to:\n- Use a descriptive title\n- Include steps to reproduce if it's a bug\n- Check existing issues before creating a new one\n\nLooking forward to your contribution! ❤️`;
+              
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issue.number,
+                body: message
+              });
+              
+            } else if (pull_request) {
+              // PR opened
+              message = `👋 **Thanks @${sender.login}** for this contribution! 🚀\n\nWe're excited to review your PR.\n\n💡 **Tips:**\n- Keep your PR focused and atomic\n- Add tests if applicable\n- Update docs if needed\n\nHappy coding! ✨`;
+              
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: pull_request.number,
+                body: message
+              });
+            }

fastgram_cli-0.1.6/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

fastgram_cli-0.1.6/.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: detect-private-key
+
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.14.0
+    hooks:
+      - id: mypy
+        additional_dependencies: [typer, rich]
+        args: [--strict, --ignore-missing-imports]
+
+
+  - repo: https://github.com/pypa/pip-audit
+    rev: v2.7.3
+    hooks:
+      - id: pip-audit
+
+ci:
+  autoupdate_commit_msg: "chore: update pre-commit hooks"
+  skip: [pip-audit]

fastgram_cli-0.1.6/.python-version

@@ -0,0 +1 @@
+3.13

fastgram_cli-0.1.6/CONTRIBUTING.md

@@ -0,0 +1,116 @@
+# Contributing to fastgram
+
+Thank you for your interest in contributing! We welcome contributions from the community.
+
+## How to Contribute
+
+### 1. Fork the Repository
+
+Fork the repository on GitHub and clone it locally:
+
+```bash
+git clone https://github.com/ndugram/fastgram-cli.git
+cd fastgram
+```
+
+### 2. Set Up Development Environment
+
+```bash
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+pre-commit install
+```
+
+### 3. Make Your Changes
+
+- Create a new branch for your feature or bugfix
+- Write clean, documented code
+- Add tests for your changes
+- Ensure all tests pass
+
+### 4. Submit a Pull Request
+
+1. Push your changes to your fork
+2. Open a Pull Request against the `main` branch
+3. Fill in the PR template completely
+4. Link any related issues
+
+## Code Style
+
+- Follow [PEP 8](https://pep8.org/) guidelines
+- Use type hints for all functions
+- Write docstrings for public functions
+- Keep lines under 100 characters
+
+### Linting and Formatting
+
+```bash
+# Run linter
+ruff check .
+
+# Format code
+ruff format .
+
+# Run type checker
+mypy src/
+```
+
+## Testing
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=src
+```
+
+## Commit Messages
+
+Follow the [Conventional Commits](https://www.conventionalcommits.org/) format:
+
+```
+<type>(<scope>): <description>
+
+body (optional)
+
+footer (optional)
+```
+
+Types:
+- `feat` - New feature
+- `fix` - Bug fix
+- `docs` - Documentation changes
+- `style` - Code style changes
+- `refactor` - Code refactoring
+- `test` - Adding tests
+- `chore` - Maintenance tasks
+
+Example:
+```
+feat(ssl): add certificate expiration warning
+
+Add a warning when certificates are about to expire within 30 days.
+
+Closes #123
+```
+
+## Issue Tracking
+
+- Before submitting an issue, search existing issues to avoid duplicates
+- Use the issue template when creating a new issue
+- Provide as much detail as possible (steps to reproduce, expected vs actual behavior)
+
+## Questions?
+
+If you have questions, feel free to:
+- Open a [Discussion](https://github.com/ndugram/fastgram-cli/discussions)
+- Ask in our community chat
+
+We appreciate your contribution!

fastgram_cli-0.1.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 安𝐍ᴇғᴏʀ | ᵈᵉᵛ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFREMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fastgram_cli-0.1.6/PKG-INFO

@@ -0,0 +1,255 @@
+Metadata-Version: 2.4
+Name: fastgram-cli
+Version: 0.1.6
+Summary: CLI tool for FastAPI - generate SSL certificates and more
+Project-URL: Homepage, https://github.com/ndugram/fastgram-cli
+Project-URL: Repository, https://github.com/ndugram/fastgram-cli
+Project-URL: Issues, https://github.com/ndugram/fastgram-cli/issues
+Author-email: NEFORCEO <n7for8572@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: certificate,cli,fastgram,ssl,tool
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: fastapi>=0.128.0
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: rich>=14.2.0
+Requires-Dist: sqlalchemy>=2.0.45
+Requires-Dist: typer>=0.21.1
+Requires-Dist: uvicorn>=0.27.0
+Description-Content-Type: text/markdown
+
+# fastgram
+
+A modern CLI tool for FastAPI developers - initialize projects with middleware, manage settings, and generate SSL certificates.
+
+![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![PyPI Version](https://img.shields.io/badge/pypi-latest-blue)
+
+## Features
+
+- 🚀 Initialize FastAPI project structure with Django-like folder layout
+- 🔐 Generate self-signed SSL certificates
+- 📦 Pre-configured middleware (CORS, Request ID, Logging, Rate Limit)
+- ⚙️ Centralized settings (server, middleware, rate limits)
+- 💅 Beautiful output with Rich library
+- ⚡ Fast and easy to use
+- 📦 Ready for PyPI publication
+
+## Installation
+
+
+### From GitHub
+
+```bash
+pip install git+https://github.com/ndugram/fastgram-cli.git
+```
+
+### From Source
+
+```bash
+git clone https://github.com/ndugram/fastgram-cli.git
+cd fastgram
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Initialize a new project
+fastgram init myproject
+
+# Enter project directory
+cd myproject
+
+# Start development server
+python manage.py runserver
+
+# Open in browser
+# http://127.0.0.1:8000
+# API docs: http://127.0.0.1:8000/docs
+```
+
+## Initialize Project
+
+```bash
+fastgram init [name]
+```
+
+Creates a new FastAPI project structure with pre-configured middleware:
+
+```
+project_name/
+├── api/
+│   └── __init__.py
+├── core/
+│   └── __init__.py
+├── database/
+│   └── __init__.py
+├── schema/
+│   └── __init__.py
+├── service/
+│   └── __init__.py
+├── views/
+│   └── __init__.py
+├── middleware/
+│   ├── __init__.py
+│   ├── cors.py
+│   ├── logging.py
+│   ├── rate_limit.py
+│   ├── request_id.py
+│   └── loader.py
+├── main.py
+├── manage.py
+└── settings.py
+```
+
+Default project name: `backend`
+
+## Middleware
+
+Generated projects include these middleware by default:
+
+| Middleware | Description |
+|------------|-------------|
+| `RateLimitMiddleware` | Rate limiting (default: 5 requests/second) |
+| `LoggingMiddleware` | Logs incoming HTTP requests |
+| `CORSMiddleware` | Cross-Origin Resource Sharing (permissive) |
+| `RequestIDMiddleware` | Adds unique request ID to each request |
+
+### Configure Middleware
+
+Edit `settings.py` to modify middleware:
+
+```python
+MIDDLEWARE = [
+    "middleware.rate_limit.RateLimitMiddleware",
+    "middleware.logging.LoggingMiddleware",
+    "middleware.cors.CORSMiddleware",
+    "middleware.request_id.RequestIDMiddleware",
+]
+```
+
+### Rate Limit Settings
+
+Configure rate limiting in `settings.py`:
+
+```python
+RATE_LIMIT_LIMIT = "5/second"  # Format: "<count>/<second|minute>"
+```
+
+## Settings
+
+All configuration is centralized in `settings.py`:
+
+```python
+
+SECRET_KEY = "generated_secret_key_here"
+
+# Database settings
+DB_URL = "sqlite+aiosqlite:///./db.sqlite3"
+
+# Server settings
+HOST = "127.0.0.1"
+PORT = 8000
+RELOAD = True
+
+# Rate limit settings
+RATE_LIMIT_LIMIT = "5/second"
+
+# Middleware registration
+MIDDLEWARE = [
+    "middleware.rate_limit.RateLimitMiddleware",
+    "middleware.logging.LoggingMiddleware",
+    "middleware.cors.CORSMiddleware",
+    "middleware.request_id.RequestIDMiddleware",
+]
+```
+
+## Generate SSL Certificates
+
+Creates SSL certificates in `certs/` directory:
+- `certs/cert.pem` - SSL certificate
+- `certs/key.pem` - Private key
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init [name]` | Initialize FastAPI project structure |
+| `ssl` | Generate self-signed SSL certificates |
+| `help` | Show available commands |
+
+## manage.py Commands
+
+After initializing a project, use `manage.py` for development tasks:
+
+```bash
+cd myproject
+```
+
+### Run Development Server
+
+```bash
+python manage.py runserver                    # Default: 127.0.0.1:8000
+python manage.py runserver --host 0.0.0.0     # Bind to all interfaces
+python manage.py runserver --port 8080        # Custom port
+python manage.py runserver --noreload         # Disable auto-reload
+```
+
+### Database Migration
+
+```bash
+python manage.py migrate                      # Create database tables
+```
+
+### Show Help
+
+```bash
+python manage.py help
+```
+
+## Project Structure
+
+Generated projects follow a clean architecture:
+
+```
+myproject/
+├── api/          # API route handlers
+├── core/         # Core application settings
+├── database/     # Database models and connections
+├── middleware/   # Custom middleware (CORS, Logging, Rate Limit, etc.)
+├── schema/       # Pydantic schemas
+├── service/      # Business logic
+├── views/        # View controllers
+├── main.py       # FastAPI application entry point
+├── manage.py     # Django-like management script
+└── settings.py   # Centralized configuration
+```
+
+## Requirements
+
+- Python 3.10+
+- OpenSSL (for SSL certificate generation)
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md).
+
+## Security
+
+For security issues, please read our [Security Policy](SECURITY.md).
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.