Skip to main content

A Django command to create a project and app with a single command

Project description

Django Hey

Django Hey is a lightweight, command-line utility that simplifies the process of initializing Django projects and applications. With a single command, it automates the creation of a Django project, an accompanying app, URL configurations, and a starter view—streamlining your workflow and letting you dive into development faster. Built for developers of all levels, django-hey ensures consistency and efficiency in setting up Django environments.

Key Features

  • Rapid Project Setup: Generate a fully structured Django project in seconds.
  • App Creation: Automatically create an app within your project.
  • URL Configuration: Pre-configure urls.py for both project and app with a default route.
  • Settings Integration: Seamlessly add your app to the project’s INSTALLED_APPS.
  • Starter View: Include a basic view with a welcome message to get you started.
  • Verbose Feedback: Receive clear success messages for each step.

Installation

To use django-hey, ensure you have Python 3.6+ installed. Install the package globally via pip:

pip install django-hey

Prerequisites
Django: The tool requires Django 3.0 or higher. Install it if not already present:

pip install django>=3.0

Usage
Run the following command to create a new Django project and app:

hey django create <project_name> <app_name>

Example

hey django create blogproject blogapp

What It Does
1. Creates a Django project named blogproject in your current directory.
2. Adds an app named blogapp inside blogproject.
3. Generates blogapp/urls.py with a default route ('') linked to a home view.
4. Updates blogproject/settings.py to include blogapp in INSTALLED_APPS.
5. Modifies blogproject/urls.py to integrate blogapp.urls.
6. Creates a home view in blogapp/views.py that returns "Welcome to blogapp!".

Command Output

Project 'blogproject' created successfully!
App 'blogapp' created successfully!
'urls.py' created in 'blogapp' successfully!
App 'blogapp' added to INSTALLED_APPS!
Project 'urls.py' updated to include 'blogapp.urls'!
Basic view created in 'blogapp/views.py'!

Running Your Project
Navigate to the project directory and launch the development server:

cd blogproject
python manage.py runserver

Open your browser to http://127.0.0.1:8000/ to see "Welcome to blogapp!".

Requirements
Python: Version 3.6 or later
Django: Version 3.0 or later (installed separately)

Troubleshooting
"django-admin: command not found": Install Django with pip install django and ensure it’s available in your PATH.
Permission Issues: Run your terminal with elevated privileges or use a virtual environment.
Command Not Recognized: Confirm installation with pip show django-hey and check your PATH.

Contributing
Contributions are welcome! To contribute:

Fork the repository on GitHub.
Submit pull requests with improvements or bug fixes.
Report issues or suggest features via the issue tracker.

License
django-hey is released under the . See the LICENSE file for full details.

Author
Developed by Sabari Nathan

Email: sabareee000@gmail.com

GitHub: github.com/sabari7497

For questions, feedback, or support, feel free to reach out!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_hey-0.1.6.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_hey-0.1.6-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file django_hey-0.1.6.tar.gz.

File metadata

  • Download URL: django_hey-0.1.6.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for django_hey-0.1.6.tar.gz
Algorithm Hash digest
SHA256 e36920a5b83ebe12712276809162eb56a2bae7718887e3e8fb714223a5514f8c
MD5 939419730200be20e507c9a464715f66
BLAKE2b-256 0abfa431c00fc5f9a3ef1bc165fc9e79ee3bea8537567f7f13e8a4a3067c6186

See more details on using hashes here.

File details

Details for the file django_hey-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: django_hey-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for django_hey-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8abfbfe749d20f4bad47ce8f6d31bd376ca3bb6d4fd01aa86c1a015c71f4cc3b
MD5 441e8073d3106582f4b2f44dd6d3e796
BLAKE2b-256 3b2775f267517db000e75e3599ad8bb8a5ea9baef8f37e63598f666d936ccb63

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page