ntc-dev-kit 1.0.0__py3-none-any.whl

ntc/templates/react_structure/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "{project_name}",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host=127.0.0.1",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "axios": "^1.13.6",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-router-dom": "^7.13.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^24.12.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.0",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.56.1",
+    "vite": "^8.0.0"
+  }
+}

ntc/templates/react_structure/src/App.tsx

@@ -0,0 +1,63 @@
+import { useState, useEffect } from 'react'
+import './App.css'
+import Header from './components/Header'
+import { apiService } from './services/api'
+
+function App() {
+  const [apiStatus, setApiStatus] = useState<'checking' | 'connected' | 'disconnected'>('checking')
+  const [data, setData] = useState<any>(null)
+
+  useEffect(() => {
+    const checkApiConnection = async () => {
+      try {
+        const response = await apiService.get('/health')
+        setApiStatus('connected')
+        setData(response.data)
+      } catch (error) {
+        setApiStatus('disconnected')
+        console.error('API connection failed:', error)
+      }
+    }
+
+    checkApiConnection()
+  }, [])
+
+  return (
+    <div className="App">
+      <Header />
+      <main className="App-main">
+        <div className="welcome-section">
+          <h1>Welcome to {import.meta.env.VITE_APP_NAME || '{project_name}'}</h1>
+          <p>Your API-driven React application is ready!</p>
+          
+          <div className="api-status">
+            <h3>API Connection Status:</h3>
+            <div className={`status-indicator ${apiStatus}`}>
+              {apiStatus === 'checking' && '🔄 Checking...'}
+              {apiStatus === 'connected' && '✅ Connected'}
+              {apiStatus === 'disconnected' && '❌ Disconnected'}
+            </div>
+            {data && (
+              <div className="api-data">
+                <h4>API Response:</h4>
+                <pre>{JSON.stringify(data, null, 2)}</pre>
+              </div>
+            )}
+          </div>
+
+          <div className="getting-started">
+            <h3>Getting Started:</h3>
+            <ol>
+              <li>Start your backend API server</li>
+              <li>Update API_BASE_URL in .env file if needed</li>
+              <li>Begin building your components in src/components/</li>
+              <li>Add API calls using the apiService in src/services/</li>
+            </ol>
+          </div>
+        </div>
+      </main>
+    </div>
+  )
+}
+
+export default App

ntc/templates/react_structure/src/components/Header.tsx

@@ -0,0 +1,51 @@
+const Header = () => {
+  return (
+    <header style={headerStyle}>
+      <div style={containerStyle}>
+        <h2 style={logoStyle}>🚀 {import.meta.env.VITE_APP_NAME || '{project_name}'}</h2>
+        <nav style={navStyle}>
+          <a href="#home" style={linkStyle}>Home</a>
+          <a href="#about" style={linkStyle}>About</a>
+          <a href="#contact" style={linkStyle}>Contact</a>
+        </nav>
+      </div>
+    </header>
+  )
+}
+
+const headerStyle = {
+  background: 'rgba(255, 255, 255, 0.1)',
+  backdropFilter: 'blur(10px)',
+  padding: '1rem 0',
+  borderBottom: '1px solid rgba(255, 255, 255, 0.2)'
+}
+
+const containerStyle = {
+  maxWidth: '1200px',
+  margin: '0 auto',
+  display: 'flex',
+  justifyContent: 'space-between',
+  alignItems: 'center',
+  padding: '0 20px'
+}
+
+const logoStyle = {
+  color: 'white',
+  margin: 0,
+  fontSize: '1.5rem'
+}
+
+const navStyle = {
+  display: 'flex',
+  gap: '2rem'
+}
+
+const linkStyle = {
+  color: 'white',
+  textDecoration: 'none',
+  fontSize: '1.1rem',
+  transition: 'opacity 0.3s ease',
+  opacity: 0.8
+}
+
+export default Header

ntc/templates/react_structure/src/main.tsx

@@ -0,0 +1,5 @@
+import { createRoot } from 'react-dom/client'
+import './index.css'
+import App from './App.tsx'
+
+createRoot(document.getElementById('root')!).render(<App />)

ntc/templates/react_structure/src/services/api.ts

@@ -0,0 +1,90 @@
+import axios from 'axios'
+import { API_BASE_URL } from '../utils/constants'
+
+const apiClient = axios.create({
+  baseURL: API_BASE_URL,
+  timeout: 10000,
+  headers: {
+    'Content-Type': 'application/json',
+  },
+})
+
+apiClient.interceptors.request.use(
+  (config) => {
+    const token = localStorage.getItem('authToken')
+    if (token) {
+      config.headers.Authorization = `Bearer ${token}`
+    }
+    return config
+  },
+  (error) => {
+    return Promise.reject(error)
+  }
+)
+
+apiClient.interceptors.response.use(
+  (response) => {
+    return response
+  },
+  (error) => {
+    if (error.response?.status === 401) {
+      localStorage.removeItem('authToken')
+    }
+    return Promise.reject(error)
+  }
+)
+
+export const apiService = {
+  get: (url: string, config = {}) => {
+    return apiClient.get(url, config)
+  },
+
+  post: (url: string, data = {}, config = {}) => {
+    return apiClient.post(url, data, config)
+  },
+
+  put: (url: string, data = {}, config = {}) => {
+    return apiClient.put(url, data, config)
+  },
+
+  patch: (url: string, data = {}, config = {}) => {
+    return apiClient.patch(url, data, config)
+  },
+
+  delete: (url: string, config = {}) => {
+    return apiClient.delete(url, config)
+  },
+
+  uploadFile: (url: string, formData: FormData, onUploadProgress: any = null) => {
+    return apiClient.post(url, formData, {
+      headers: {
+        'Content-Type': 'multipart/form-data',
+      },
+      onUploadProgress,
+    })
+  },
+}
+
+export const authService = {
+  login: async (credentials: any) => {
+    const response = await apiService.post('/auth/login/', credentials)
+    if (response.data.token) {
+      localStorage.setItem('authToken', response.data.token)
+    }
+    return response
+  },
+
+  logout: () => {
+    localStorage.removeItem('authToken')
+  },
+
+  getCurrentUser: () => {
+    return apiService.get('/auth/user/')
+  },
+
+  isAuthenticated: () => {
+    return !!localStorage.getItem('authToken')
+  },
+}
+
+export default apiService

ntc/templates/react_structure/src/utils/constants.ts

@@ -0,0 +1 @@
+export const API_BASE_URL = import.meta.env.VITE_API_BASE_URL || 'http://localhost:8000'

ntc/templates/react_structure/structure.json

@@ -0,0 +1,65 @@
+{
+  "Project": {
+    "package.json": {
+      "template": "react_structure/package.json"
+    },
+    ".gitignore": "node_modules/\ndist/\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n.DS_Store\n",
+    "README.md": "# {project_name}\n\nA React + TypeScript + Vite application initialized by `ntc init`.\n\n## Getting Started\n\n```bash\nnpm install\nnpm run dev\n```\n\n## Available Scripts\n\n- `npm run dev` - Runs the app in development mode (Vite)\n- `npm run build` - Builds the app for production\n- `npm run lint` - Runs ESLint\n- `npm run preview` - Previews the production build\n",
+    "index.html": {
+      "template": "react_structure/index.html"
+    },
+    "vite.config.ts": {
+      "template": "react_structure/vite.config.ts"
+    },
+    "tsconfig.json": {
+      "template": "react_structure/tsconfig.json"
+    },
+    "tsconfig.app.json": {
+      "template": "react_structure/tsconfig.app.json"
+    },
+    "tsconfig.node.json": {
+      "template": "react_structure/tsconfig.node.json"
+    },
+    ".env.example": "VITE_API_BASE_URL=http://localhost:8000\nVITE_APP_NAME={project_name}\n",
+    "CLAUDE.md": {
+      "template": "react_structure/CLAUDE.md"
+    },
+    ".knowledge": {
+      "knowledge_structure.md": {
+        "template": "react_structure/knowledge/knowledge_structure.md"
+      },
+      "knowledge_description.md": {
+        "template": "react_structure/knowledge/knowledge_description.md"
+      },
+      "knowledge_design_pattern.md": {
+        "template": "react_structure/knowledge/knowledge_design_pattern.md"
+      }
+    },
+    "src": {
+      "main.tsx": {
+        "template": "react_structure/src/main.tsx"
+      },
+      "App.tsx": {
+        "template": "react_structure/src/App.tsx"
+      },
+      "index.css": {
+        "template": "react_structure/index.css"
+      },
+      "components": {
+        "Header.tsx": {
+          "template": "react_structure/src/components/Header.tsx"
+        }
+      },
+      "services": {
+        "api.ts": {
+          "template": "react_structure/src/services/api.ts"
+        }
+      },
+      "utils": {
+        "constants.ts": {
+          "template": "react_structure/src/utils/constants.ts"
+        }
+      }
+    }
+  }
+}

ntc/templates/react_structure/tsconfig.app.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src"]
+}

ntc/templates/react_structure/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

ntc/templates/react_structure/tsconfig.node.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["vite.config.ts"]
+}

ntc/templates/react_structure/vite.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import path from 'path'
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+})

ntc/utils/__init__.py

@@ -0,0 +1 @@
+"""Shared utilities for NTC toolkit."""

ntc/utils/environment.py

@@ -0,0 +1,67 @@
+"""Shared environment setup utilities."""
+
+import os
+import sys
+import subprocess
+import shutil
+from colorama import Fore, Style
+from ntc.utils.output import print_info, print_error, print_success
+from ntc.templates.drf_structure.main import create_virtual_env, install_requirements, find_conda_executable
+
+
+def setup_environment(project_root: str, env_type: str = "venv") -> None:
+    """
+    Shared environment setup logic for both init functions.
+    
+    Args:
+        project_root: Path to the project root directory
+        env_type: Type of environment to create ('venv' or 'conda')
+    """
+    print(f"\n{Fore.CYAN}{Style.BRIGHT}🐍 PYTHON ENVIRONMENT SETUP{Style.RESET_ALL}")
+    print("─" * 40)
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[1]{Style.RESET_ALL} {Fore.WHITE}Create new virtual environment{Style.RESET_ALL}")
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[2]{Style.RESET_ALL} {Fore.WHITE}Use existing active environment{Style.RESET_ALL}")
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[3]{Style.RESET_ALL} {Fore.WHITE}Skip environment setup{Style.RESET_ALL}")
+    
+    while True:
+        env_choice = input(f"{Fore.WHITE}{Style.BRIGHT}❓ Select environment option (1-3): {Style.RESET_ALL}").strip()
+        
+        # Clear screen after selection
+        os.system('cls' if os.name == 'nt' else 'clear')
+        
+        if env_choice == "1":
+            # Create new environment
+            os.system('cls' if os.name == 'nt' else 'clear')
+            env_type = input(f"{Fore.WHITE}{Style.BRIGHT}❓ Which environment to create? (venv/conda) [default: venv]: {Style.RESET_ALL}").strip().lower() or "venv"
+            env_dir = create_virtual_env(env_type, project_root)
+            install_requirements(env_type, env_dir, project_root)
+            break
+            
+        elif env_choice == "2":
+            # Use existing active environment
+            print_info("Using existing active environment...")
+            
+            # Check if we're in a virtual environment
+            if hasattr(sys, 'real_prefix') or (hasattr(sys, 'base_prefix') and sys.base_prefix != sys.prefix):
+                print_success("Detected active virtual environment!")
+                
+                # Install requirements in current environment
+                from ntc.cli_enhanced import animate_dependency_install
+                requirements_path = os.path.join(project_root, "requirements.txt")
+                animate_dependency_install(requirements_path)
+            else:
+                print_error("No active virtual environment detected!")
+                print_info("Make sure you have activated your environment before running this.")
+                print_info("You can install dependencies later with: pip install -r requirements.txt")
+            break
+            
+        elif env_choice == "3":
+            # Skip environment setup
+            print_info("Skipping environment setup.")
+            print_info("Remember to:")
+            print_info("  1. Activate your preferred Python environment")
+            print_info("  2. Install dependencies: pip install -r requirements.txt")
+            break
+            
+        else:
+            print_error("Invalid choice. Please select 1, 2, or 3.")

ntc/utils/output.py

@@ -0,0 +1,41 @@
+"""Shared output utilities for consistent colored terminal output."""
+
+from colorama import Fore, Style, init
+
+# Initialize colorama for cross-platform colored output
+init(autoreset=True)
+
+
+def print_success(message: str) -> None:
+    """Print success message with green color and checkmark."""
+    print(f"{Fore.GREEN}✅ {message}{Style.RESET_ALL}")
+
+
+def print_error(message: str) -> None:
+    """Print error message with red color and X mark."""
+    print(f"{Fore.RED}❌ {message}{Style.RESET_ALL}")
+
+
+def print_warning(message: str) -> None:
+    """Print warning message with yellow color and warning sign."""
+    print(f"{Fore.YELLOW}⚠️  {message}{Style.RESET_ALL}")
+
+
+def print_info(message: str) -> None:
+    """Print info message with blue color and info icon."""
+    print(f"{Fore.CYAN}ℹ️  {message}{Style.RESET_ALL}")
+
+
+def print_progress(message: str) -> None:
+    """Print progress message with blue color and rocket."""
+    print(f"{Fore.BLUE}🚀 {message}{Style.RESET_ALL}")
+
+
+def print_package(message: str) -> None:
+    """Print package-related message with magenta color and package icon."""
+    print(f"{Fore.MAGENTA}📦 {message}{Style.RESET_ALL}")
+
+
+def print_download(message: str) -> None:
+    """Print download message with green color and download icon."""
+    print(f"{Fore.GREEN}📥 {message}{Style.RESET_ALL}")

ntc_dev_kit-1.0.0.dist-info/METADATA

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: ntc-dev-kit
+Version: 1.0.0
+Summary: Nexent Toolkit Console - A CLI tool for scaffolding Django REST Framework, React, Next.js, and Flutter projects
+Home-page: https://github.com/nexent/ntc
+Author: Nexent
+Author-email: Nexent <dev@nexent.com>
+License: MIT
+Project-URL: Homepage, https://github.com/nexent/ntc
+Project-URL: Repository, https://github.com/nexent/ntc
+Project-URL: Issues, https://github.com/nexent/ntc/issues
+Keywords: cli,scaffold,django,drf,react,nextjs,flutter,generator,boilerplate
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# NTC - Nexent Toolkit Console
+
+A powerful CLI scaffolding tool for rapidly bootstrapping modern web and mobile projects.
+
+## Overview
+
+NTC (Nexent Toolkit Console) is a command-line interface that generates production-ready project boilerplates for:
+
+- **Backend**: Django REST Framework with authentication, Celery, Docker support
+- **Frontend**: React, React Admin, Next.js
+- **Mobile**: Flutter
+
+## Features
+
+- **Interactive project initialization** with step-by-step prompts
+- **Django REST Framework scaffolding** with JWT authentication, custom User models, and API documentation
+- **Environment setup automation** (virtual environments, dependency installation)
+- **Docker & Docker Compose** configuration included
+- **Authentication app generator** with login, register, password reset endpoints
+- **Modular app architecture** with pre-configured common utilities
+
+## Installation
+
+```bash
+pip install ntc-dev-kit
+```
+
+## Quick Start
+
+Create a new project interactively:
+
+```bash
+ntc init
+```
+
+Or specify technology directly:
+
+```bash
+# Django REST API backend
+ntc init --technology django
+
+# React frontend
+ntc init --technology react
+
+# Next.js full-stack
+ntc init --technology nextjs
+
+# Flutter mobile
+ntc init --technology flutter
+```
+
+## Usage
+
+### Interactive Mode
+
+```bash
+ntc init
+```
+
+Navigate menus with **arrow keys**, select with **Enter**, exit with **Escape**.
+
+### Technology Options
+
+| Technology | Description |
+|-----------|-------------|
+| `django` | Django REST Framework with JWT auth, Celery, Docker |
+| `react` | React Vite project with TypeScript |
+| `react-admin` | React Admin dashboard template |
+| `nextjs` | Next.js full-stack application |
+| `flutter` | Flutter mobile application |
+
+### Additional Commands
+
+```bash
+# Create a new Django app within your project
+ntc create app <app_name>
+
+# Show help
+ntc --help
+```
+
+## Django Project Structure
+
+When you create a Django project, you get:
+
+```
+myproject/
+├── .env                          # Environment variables
+├── .gitignore
+├── requirements.txt
+├── manage.py
+├── Dockerfile
+├── docker-compose.yml
+├── config/                       # Gunicorn & nginx config
+├── .entry/                       # Startup scripts
+├── .knowledge/                   # AI documentation
+├── apps/
+│   ├── __init__.py
+│   ├── common/                   # Common utilities
+│   └── authentication/           # (Optional) Auth app
+├── core/                         # Core utilities
+│   ├── pagination.py
+│   ├── base_model.py
+│   ├── response_wrapper.py
+│   └── services/                 # Azure/AWS services
+└── myproject/                    # Django project settings
+    ├── settings/
+    ├── urls.py
+    ├── asgi.py
+    ├── wsgi.py
+    └── commands/                 # Management commands
+```
+
+## Requirements
+
+- **Python**: >= 3.10
+- **Operating System**: Windows, macOS, Linux
+
+## Dependencies
+
+- `colorama` - Cross-platform colored terminal output
+- `pyyaml` - YAML configuration parsing
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/nexent/ntc.git
+cd ntc
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Code formatting
+black ntc/
+ruff check ntc/
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/nexent/ntc/issues)
+- **Repository**: [GitHub](https://github.com/nexent/ntc)