{"id":18694553,"url":"https://github.com/emilte/django-workshop","last_synced_at":"2026-01-11T01:58:27.527Z","repository":{"id":80578046,"uuid":"599665514","full_name":"emilte/django-workshop","owner":"emilte","description":"Workshop for Django","archived":false,"fork":false,"pushed_at":"2024-09-30T13:43:52.000Z","size":1427,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-01T15:22:15.304Z","etag":null,"topics":["django","docker","docker-compose","python","workshop"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emilte.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-09T16:14:49.000Z","updated_at":"2024-09-30T13:43:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"3b0e6ca0-5e6a-49dd-89fd-0bd73f2aec9c","html_url":"https://github.com/emilte/django-workshop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/emilte/django-workshop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emilte%2Fdjango-workshop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emilte%2Fdjango-workshop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emilte%2Fdjango-workshop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emilte%2Fdjango-workshop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emilte","download_url":"https://codeload.github.com/emilte/django-workshop/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emilte%2Fdjango-workshop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272953914,"owners_count":25021133,"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","status":"online","status_checked_at":"2025-08-31T02:00:09.071Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["django","docker","docker-compose","python","workshop"],"created_at":"2024-11-07T11:11:26.312Z","updated_at":"2026-01-11T01:58:27.484Z","avatar_url":"https://github.com/emilte.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# django-workshop\n\nHi, and welcome to my workshop! 😊\n\nIn this workshop, you will learn the basics of Django, and lots of other treats the python environment can provide.\n\nBefore we can start though, I need you to do something for me. You see, there are some tools I cannot install for you 😔 Please take a look at the list in [prerequisites](#prerequisites) and install the required tools 🔧\nThe project was made primarily to run in docker, but is compatible with local setup aswell.\n\n\u003cbr\u003e\n\u003chr\u003e\n\u003cbr\u003e\n\n## Table of contents:\n\n- [Table of contents:](#table-of-contents)\n- [Prerequisites](#prerequisites)\n- [Setup](#setup)\n  - [Step 1: Clone project](#step-1-clone-project)\n  - [Step 2: Copy environment files](#step-2-copy-environment-files)\n  - [Step 3: Run project](#step-3-run-project)\n  - [Step 4: Install dependencies (optional)](#step-4-install-dependencies-optional)\n  - [Step 5: Select interpreter in VSCode](#step-5-select-interpreter-in-vscode)\n- [Documentation](#documentation)\n\n\u003cbr\u003e\n\u003chr\u003e\n\u003cbr\u003e\n\n## Prerequisites\n\nSee [prerequisites](/documentation/prerequisites.md).\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Setup\n\n### Step 1: Clone project\n\nLocate directory you want to have the project, clone the project and navigate into it.\n\n```\ngit clone git@github.com:emilte/django-workshop.git \u0026\u0026 cd django-workshop\n```\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n### Step 2: Copy environment files\n\nThese files configure the environment the code runs in.  \nAfter running these commands, I recommend taking a look at them.\n\n\u003e - [.vscode/settings.json](.vscode/settings.json) contains configurations for VSCode.\n\u003e - [clean/.docker.env](clean/.docker.env) contains environment variables/secrets for your container named `clean`.\n\u003e - [solution/.docker.env](solution/.docker.env) contains environment variables/secrets for the `solution` container.\n\n```\ncp .vscode/settings.default.json .vscode/settings.json\ncp clean/.docker.example.env clean/.docker.env\ncp solution/.docker.example.env solution/.docker.env\n```\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003c!-- ### 3. Build project\n\n```\ndocker compose build\n``` --\u003e\n\n\u003c!-- \u003cbr\u003e --\u003e\n\u003c!-- \u003cbr\u003e --\u003e\n\n### Step 3: Run project\n\nThe workshop is setup with two docker containers I will reference throughout the workshop. One named `clean` and another named `solution`.\n\n- The `clean` container is for the moment completely empty. This is where you will start your django project.\n- The `solution` container is fully spec'ed with most of the tools I like to use on my own projects. It serves as an inspiration during your tasks as well as giving you an instant feeling as to what Django can provide.\n\n\u003e This command is expected to display errors for the `clean` container.  \n\u003e There isn't a project inside it yet, but you will make one pretty soon 😉\n\n```\ndocker compose up\n```\n\nThe `solution` server is now running on [http://localhost:8002](http://localhost:8002).  \nYou may browse the [admin panel](http://localhost:8002/admin).  \nCredentials can be found in [solution/.docker.env](/solution/.docker.env)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n### Step 4: Install dependencies (optional)\n\nThis step is only to enhance the VSCode experience where it can recognise Django, enable formatter, linters etc.\n\n```\ncd solution\n```\n\n\u003e `pipenv` will recognise dependencies automatically from [Pipfile](/solution/Pipfile).  \n\u003e `PIPENV_VENV_IN_PROJECT=1` will ensure that the environment is installed within this folder.\n\n```\nPIPENV_VENV_IN_PROJECT=1 pyenv exec pipenv install --dev --python 3.11\n```\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n### Step 5: Select interpreter in VSCode\n\n`Cmd + Shift + P` --\u003e `Select interpreter` --\u003e `+ Enter interpreter path`\n\nWrite `solution/.venv` and hit `Enter`.\n\n\u003cbr\u003e\n\u003chr\u003e\n\u003cbr\u003e\n\n## Documentation\n\nGo to [documentation](/documentation/README.md) to continue with workshop.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femilte%2Fdjango-workshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femilte%2Fdjango-workshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femilte%2Fdjango-workshop/lists"}