ntc-dev-kit 1.0.0__tar.gz

ntc_dev_kit-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nexent
+
+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 NONINFRINGEMENT. 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.

ntc_dev_kit-1.0.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include ntc/templates *.py *.json *.md *.txt *.html *.ts *.tsx *.css *.scss *.yml *.yaml *.sh *.conf *.cfg
+recursive-include ntc/templates *.env.example *.gitignore
+
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store

ntc_dev_kit-1.0.0/PKG-INFO

@@ -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)

ntc_dev_kit-1.0.0/README.md

@@ -0,0 +1,149 @@
+# 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)

ntc_dev_kit-1.0.0/ntc/__init__.py

@@ -0,0 +1,5 @@
+"""NTC - Nexent Toolkit Console."""
+
+__version__ = "1.0.0"
+__author__ = "Nexent"
+__license__ = "MIT"

ntc_dev_kit-1.0.0/ntc/app_creator.py

@@ -0,0 +1,296 @@
+import os
+import re
+from ntc.utils.output import print_success, print_error, print_info
+from ntc.templates.drf_structure.main import sanitize_project_name
+
+def get_app_template_content(template_name, app_name):
+    """Load app template content and replace variables."""
+    template_path = os.path.join(
+        os.path.dirname(__file__), 
+        'templates', 'drf_structure', 'templates', 'apps', template_name
+    )
+    
+    if not os.path.exists(template_path):
+        # Fallback to inline content if template not found
+        return get_fallback_content(template_name, app_name)
+    
+    with open(template_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+    
+    # Replace template variables
+    content = content.replace('{app_name}', app_name)
+    content = content.replace('{app_name_title}', app_name.replace('_', '').title())
+    
+    return content
+
+def get_fallback_content(template_name, app_name):
+    """Fallback content if template files are not found."""
+    fallbacks = {
+        'app_admin.py': '''from django.contrib import admin
+
+# Register your models here.
+''',
+        'app_apps.py': f'''from django.apps import AppConfig
+
+
+class {app_name.replace('_', '').title()}Config(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'apps.{app_name}'
+''',
+        'app_models.py': '''from django.db import models
+from apps.common.models import TimeStampedModel
+
+# Create your models here.
+''',
+        'app_urls.py': f'''from django.urls import path
+from . import views
+
+app_name = '{app_name}'
+
+urlpatterns = [
+    path('hello/', views.hello_world, name='hello_world'),
+    # Add your other URL patterns here
+]
+''',
+        'app_views.py': f'''from rest_framework import viewsets, status
+from rest_framework.decorators import api_view
+from rest_framework.response import Response
+from core.response_wrapper import success_response, error_response
+
+
+@api_view(['GET'])
+def hello_world(request):
+    """Test view that returns Hello World message."""
+    return success_response(
+        data={{"message": "Hello World from {app_name} app!"}},
+        message="Welcome to {app_name} API"
+    )
+
+
+# Create your other views here.
+''',
+    }
+    return fallbacks.get(template_name, '')
+
+def create_app_structure(app_name):
+    """Create the NTC app directory structure."""
+    # Sanitize app name using the same function as project names
+    original_name = app_name
+    app_name = sanitize_project_name(app_name)
+    
+    if app_name != original_name:
+        print_info(f"App name sanitized: '{original_name}' -> '{app_name}'")
+    
+    # Check if we're in a Django project root
+    if not os.path.exists('manage.py'):
+        print_error("Not in a Django project root directory. Please run this command from your project root.")
+        return False
+    
+    # Check if apps directory exists
+    if not os.path.exists('apps'):
+        print_info("Creating apps directory...")
+        os.makedirs('apps', exist_ok=True)
+        # Create apps/__init__.py
+        with open('apps/__init__.py', 'w') as f:
+            f.write('')
+    
+    base_path = os.path.join('apps', app_name)
+    
+    # Check if app already exists
+    if os.path.exists(base_path):
+        print_error(f"App '{app_name}' already exists in apps/{app_name}/")
+        return False
+    
+    print_info(f"Creating app structure for '{app_name}'...")
+    
+    # Create directories
+    directories = [
+        base_path,
+        os.path.join(base_path, 'permissions'),
+        os.path.join(base_path, 'serializers'),
+        os.path.join(base_path, 'selectors'),
+        os.path.join(base_path, 'services'),
+        os.path.join(base_path, 'socket'),
+        os.path.join(base_path, 'tasks'),
+        os.path.join(base_path, 'tests'),
+    ]
+    
+    for directory in directories:
+        os.makedirs(directory, exist_ok=True)
+        # Create __init__.py in each directory
+        init_file = os.path.join(directory, '__init__.py')
+        with open(init_file, 'w') as f:
+            f.write('')
+    
+    # Create main app files
+    files_content = {
+        'admin.py': get_app_template_content('app_admin.py', app_name),
+        'apps.py': get_app_template_content('app_apps.py', app_name),
+        'models.py': get_app_template_content('app_models.py', app_name),
+        'urls.py': get_app_template_content('app_urls.py', app_name),
+        'views.py': get_app_template_content('app_views.py', app_name),
+    }
+    
+    for filename, content in files_content.items():
+        file_path = os.path.join(base_path, filename)
+        with open(file_path, 'w') as f:
+            f.write(content)
+    
+    print_success(f"App '{app_name}' created successfully!")
+    
+    # Add to INSTALLED_APPS
+    if add_to_installed_apps(app_name):
+        print_success(f"Added 'apps.{app_name}' to INSTALLED_APPS")
+    else:
+        print_info(f"Please manually add 'apps.{app_name}' to INSTALLED_APPS in your settings")
+    
+    # Add to main URLs
+    if add_to_main_urls(app_name):
+        print_success(f"Added app URLs to main urls.py")
+    else:
+        print_info(f"Please manually add: path('{app_name}/', include('apps.{app_name}.urls')) to your main urls.py")
+    
+    print_info("Next steps:")
+    print_info(f"  1. Test the app: GET /{app_name}/hello/ (returns Hello World)")
+    print_info(f"  2. Run 'python manage.py makemigrations {app_name}' after creating models")
+    print_info(f"  3. Start building your API endpoints in apps/{app_name}/views.py")
+    
+    return True
+
+def add_to_installed_apps(app_name):
+    """Add the new app to INSTALLED_APPS in settings."""
+    # Find settings files
+    settings_files = []
+    
+    # Look for settings in common locations
+    possible_settings = [
+        'settings.py',
+        'settings/base.py',
+        'settings/dev.py',
+    ]
+    
+    # Find project directory (should contain settings)
+    for root, dirs, files in os.walk('.'):
+        if 'settings.py' in files or 'settings' in dirs:
+            for settings_file in possible_settings:
+                settings_path = os.path.join(root, settings_file)
+                if os.path.exists(settings_path):
+                    settings_files.append(settings_path)
+            break
+    
+    if not settings_files:
+        return False
+    
+    # Use the first settings file found (usually base.py or settings.py)
+    settings_file = settings_files[0]
+    
+    try:
+        with open(settings_file, 'r', encoding='utf-8') as f:
+            content = f.read()
+        
+        # Check if app is already in INSTALLED_APPS
+        if f"'apps.{app_name}'" in content or f'"apps.{app_name}"' in content:
+            return True  # Already added
+        
+        # Find INSTALLED_APPS and add the new app
+        import re
+        
+        # Pattern to match INSTALLED_APPS
+        pattern = r'(INSTALLED_APPS\s*=\s*\[)(.*?)(\])'
+        match = re.search(pattern, content, re.DOTALL)
+        
+        if match:
+            start, apps_content, end = match.groups()
+            
+            # Add the new app to the end of the list
+            new_app_line = f"    'apps.{app_name}',\n"
+            
+            # Insert before the closing bracket
+            new_content = content.replace(
+                match.group(0),
+                f"{start}{apps_content.rstrip()}\n{new_app_line}{end}"
+            )
+            
+            with open(settings_file, 'w', encoding='utf-8') as f:
+                f.write(new_content)
+            
+            return True
+        
+    except Exception as e:
+        print_error(f"Failed to update INSTALLED_APPS: {e}")
+        return False
+    
+    return False
+
+def add_to_main_urls(app_name):
+    """Add the new app URLs to the main urls.py file."""
+    # Find main urls.py
+    urls_files = []
+    
+    # Look for main urls.py (usually in project root or project directory)
+    for root, dirs, files in os.walk('.'):
+        if 'urls.py' in files:
+            urls_path = os.path.join(root, 'urls.py')
+            # Skip app-specific urls.py files
+            if 'apps' not in root:
+                urls_files.append(urls_path)
+    
+    if not urls_files:
+        return False
+    
+    # Use the first main urls.py found
+    urls_file = urls_files[0]
+    
+    try:
+        with open(urls_file, 'r', encoding='utf-8') as f:
+            content = f.read()
+        
+        # Check if app URLs are already included
+        if f"'{app_name}/'" in content or f'"{app_name}/"' in content:
+            return True  # Already added
+        
+        # Check if include is imported
+        if 'from django.urls import' in content:
+            if 'include' not in content:
+                # Add include to existing import
+                content = content.replace(
+                    'from django.urls import',
+                    'from django.urls import include,'
+                ).replace('include,', 'include, ')
+        else:
+            # Add the import at the top
+            lines = content.split('\n')
+            for i, line in enumerate(lines):
+                if line.startswith('from django.'):
+                    lines.insert(i + 1, 'from django.urls import path, include')
+                    break
+            content = '\n'.join(lines)
+        
+        # Find urlpatterns and add the new app
+        import re
+        
+        pattern = r'(urlpatterns\s*=\s*\[)(.*?)(\])'
+        match = re.search(pattern, content, re.DOTALL)
+        
+        if match:
+            start, urls_content, end = match.groups()
+            
+            # Add the new app URL pattern
+            new_url_line = f"    path('{app_name}/', include('apps.{app_name}.urls')),\n"
+            
+            # Insert before the closing bracket
+            new_content = content.replace(
+                match.group(0),
+                f"{start}{urls_content.rstrip()}\n{new_url_line}{end}"
+            )
+            
+            with open(urls_file, 'w', encoding='utf-8') as f:
+                f.write(new_content)
+            
+            return True
+        
+    except Exception as e:
+        print_error(f"Failed to update main urls.py: {e}")
+        return False
+    
+    return False

ntc_dev_kit-1.0.0/ntc/cli.py

@@ -0,0 +1,4 @@
+from ntc.cli_enhanced import main
+
+if __name__ == "__main__":
+    main()