{"id":15893592,"url":"https://github.com/alexdlaird/django-bootstrap-authentication-template-project","last_synced_at":"2025-03-20T14:30:34.864Z","repository":{"id":20050522,"uuid":"23318928","full_name":"alexdlaird/django-bootstrap-authentication-template-project","owner":"alexdlaird","description":"A simple template, including authentication forms, for a deployable Django application using Bootstrap","archived":false,"fork":false,"pushed_at":"2024-09-16T10:46:58.000Z","size":304,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-07T08:12:06.112Z","etag":null,"topics":["ansible","bootstrap","django","django-pipeline","education","heliumcli","python","travis-ci"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexdlaird.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"alexdlaird","patreon":"alexdlaird","custom":["https://www.paypal.me/alexdlaird"]}},"created_at":"2014-08-25T15:38:35.000Z","updated_at":"2024-09-16T10:46:55.000Z","dependencies_parsed_at":"2024-02-20T17:28:58.261Z","dependency_job_id":"26673503-3f5d-465b-a0b7-5bb83079c444","html_url":"https://github.com/alexdlaird/django-bootstrap-authentication-template-project","commit_stats":null,"previous_names":[],"tags_count":28,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Fdjango-bootstrap-authentication-template-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Fdjango-bootstrap-authentication-template-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Fdjango-bootstrap-authentication-template-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Fdjango-bootstrap-authentication-template-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexdlaird","download_url":"https://codeload.github.com/alexdlaird/django-bootstrap-authentication-template-project/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244629982,"owners_count":20484292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","bootstrap","django","django-pipeline","education","heliumcli","python","travis-ci"],"created_at":"2024-10-06T08:12:10.869Z","updated_at":"2025-03-20T14:30:34.491Z","avatar_url":"https://github.com/alexdlaird.png","language":"Python","funding_links":["https://github.com/sponsors/alexdlaird","https://patreon.com/alexdlaird","https://www.paypal.me/alexdlaird"],"categories":[],"sub_categories":[],"readme":"![Python Versions](https://img.shields.io/badge/python-%203.9%20|%203.10%20|%203.11%20-blue)\n[![Coverage](https://img.shields.io/codecov/c/github/alexdlaird/django-bootstrap-authentication-template-project)](https://codecov.io/gh/alexdlaird/django-bootstrap-authentication-template-project)\n[![Build](https://img.shields.io/github/actions/workflow/status/alexdlaird/django-bootstrap-authentication-template-project/build.yml)](https://github.com/alexdlaird/django-bootstrap-authentication-template-project/actions/workflows/build.yml)\n![GitHub License](https://img.shields.io/github/license/alexdlaird/django-bootstrap-authentication-template-project)\n\n# Django Bootstrap/Authentication Template Project\n\n## Getting Started\nThe project is developed using [Python](https://www.python.org/), [Django](https://www.djangoproject.com), and [Bootstrap](http://getbootstrap.com/docs/3.3/).\n\nThis repository contains the source code for a Django Bootstrap/Authentication Template Project.\n\n### Project Setup\nTo setup the Python/Django build environment, execute:\n\n```sh\nmake install\n```\n\nThis project is configured to work with a Virtualenv which has now been setup in the `venv` folder. If you're unfamiliar with how this works, read up on Virtualenv here. The short version is, virtualenv creates isolated environments for each project's dependencies. To activate and use this environment when developing, execute:\n\n```sh\nsource venv/bin/activate\n```\n\nAll commands below will now be run within the virtualenv (though `make` commands will always automatically enter the virtualenv before executing).\n\nTo ensure the database is in sync with the latest schema, database migrations are generated and run with Django. To run migrations, execute:\n\n```sh\nmake migrate\n```\n\nOnce migrations have been run, you can create a super user, which is a standard user that also has access to the /admin site.\n\n```sh\npython manage.py createsuperuser\n```\n\nBefore commits are made, be sure to run tests and check the generated coverage report.\n\n```sh\nmake test\n```\n\n### Development\nTo get started with minimal effort, assuming you have followed the \"Getting Started\" directions above, you should have the ENVIRONMENT environment\nvariable set to \"dev\". For convenience, [helium-cli](https://github.com/HeliumEdu/heliumcli#readme), which is compatible with this project and\nprovides a useful set of tools for maintaining, building, and deploying the code, has also been installed.\n\nTo start a local server, execute:\n\n```sh\nhelium-cli start-servers\n```\n\nA development server will be started at \u003chttp://localhost:8000\u003e.\n\nIf the `USE_NGROK` environment variable is set when a dev server is started (using `runserver`, [pyngrok](https://github.com/alexdlaird/pyngrok)\nwill be used to open a `ngrok` tunnel. This is especially useful when using webhooks.\n\nYou can also deploy builds of the code using `helium-cli`, for instance, to deploy `main` to `stage`, execute:\n\n```sh\nhelium-cli deploy-build main stage\n```\n\n[Ansible](https://www.ansible.com/) deployment scripts can be found in the `ansible` directory.\n\nAs a starting point for using this project as a template for a new project, search for usages of \"MYPROJECT\" and\nbegin refactoring from there.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexdlaird%2Fdjango-bootstrap-authentication-template-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexdlaird%2Fdjango-bootstrap-authentication-template-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexdlaird%2Fdjango-bootstrap-authentication-template-project/lists"}