{"id":16175319,"url":"https://github.com/app-generator/django-dynamic-services","last_synced_at":"2025-04-07T11:14:38.980Z","repository":{"id":65900455,"uuid":"601471540","full_name":"app-generator/django-dynamic-services","owner":"app-generator","description":"Django Dynamic Services - Open-Source Project | AppSeed","archived":false,"fork":false,"pushed_at":"2024-10-17T04:17:21.000Z","size":62,"stargazers_count":12,"open_issues_count":1,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-06T18:12:58.640Z","etag":null,"topics":["api-generator","appseed","developer-tools","dynamic-programming"],"latest_commit_sha":null,"homepage":"https://appseed.us/developer-tools/dynamic-django/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/app-generator.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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-14T06:09:56.000Z","updated_at":"2024-10-17T04:17:24.000Z","dependencies_parsed_at":"2024-10-19T05:02:45.889Z","dependency_job_id":null,"html_url":"https://github.com/app-generator/django-dynamic-services","commit_stats":null,"previous_names":[],"tags_count":7,"template":true,"template_full_name":"app-generator/django-adminlte","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/app-generator%2Fdjango-dynamic-services","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/app-generator%2Fdjango-dynamic-services/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/app-generator%2Fdjango-dynamic-services/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/app-generator%2Fdjango-dynamic-services/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/app-generator","download_url":"https://codeload.github.com/app-generator/django-dynamic-services/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640467,"owners_count":20971558,"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":["api-generator","appseed","developer-tools","dynamic-programming"],"created_at":"2024-10-10T04:44:36.897Z","updated_at":"2025-04-07T11:14:38.939Z","avatar_url":"https://github.com/app-generator.png","language":"HTML","readme":"# [Django Dynamic Services](https://app-generator.dev/docs/developer-tools/dynamic-django/index.html) \n\nOpen-source **Django** project that showcases the **API Generator** and other **Dynamic Services** - actively supported by [App-Generator](https://app-generator.dev/).\n\n- 👉 [Django - Build Services without Coding](https://www.youtube.com/watch?v=EtMCK5AmdQI) - `video presentation` (learn how to use this starter)\n\n---\n\n\u003e For a **complete set of features** and long-term support, check out **[Dynamic Django](https://app-generator.dev/docs/developer-tools/dynamic-django/index.html)**, a powerful starter that incorporates:\n\n- ✅ [Dynamic DataTables](https://app-generator.dev/docs/developer-tools/dynamic-django/datatables.html): using a single line of configuration, the data saved in any table is automatically managed\n- ✅ [Dynamic API](https://app-generator.dev/docs/developer-tools/dynamic-django/api.html): any model can become a secure API Endpoint using DRF\n- ✅ [Dynamic Charts](https://app-generator.dev/docs/developer-tools/dynamic-django/charts.html): extract relevant charts without coding all major types are supported\n- ✅ [CSV Loader](https://app-generator.dev/docs/developer-tools/dynamic-django/csv-loader.html): translate CSV files into Django Models and (optional) load the information\n- ✅ Powerful [CLI Tools](https://app-generator.dev/docs/developer-tools/dynamic-django/cli.html) for the GIT interface, configuration editing, updating the configuration and database (create models, migrate DB)\n\n\u003cbr /\u003e\n\n## Start the app in Docker\n\n\u003e 👉 **Step 1** - Download the code from the GH repository (using `GIT`)\n\n```bash\n$ git clone https://github.com/app-generator/django-dynamic-services.git\n$ cd django-dynamic-services\n```\n\n\u003e 👉 **Step 2** - Start the APP in `Docker`\n\n```bash\n$ docker-compose up --build\n```\n\nVisit `http://localhost:5085` in your browser. The app should be up \u0026 running.\n\n\n\u003e 👉 **Step 3** - Create Superuser in `Docker`\n\n```bash\n$ # List containes \u0026 get the ID\n$ docker container ls  \n$ # Create the superuser\n$ docker exec \u003cCONTAINER_ID\u003e python manage.py createsuperuser \n```\n\n\u003cbr /\u003e\n\n## Manual Build \n\n\u003e 👉 Download the code  \n\n```bash\n$ git clone https://github.com/app-generator/django-dynamic-services.git\n$ cd django-dynamic-services\n```\n\n\u003cbr /\u003e\n\n\u003e 👉 Install modules via `VENV`  \n\n```bash\n$ virtualenv env\n$ source env/bin/activate\n$ pip install -r requirements.txt\n```\n\n\u003cbr /\u003e\n\n\u003e 👉 Set Up Database\n\n```bash\n$ python manage.py makemigrations\n$ python manage.py migrate\n```\n\n\u003cbr /\u003e\n\n\u003e 👉 Generate API\n\n```bash\n$ python manage.py generate-api     # requires confirmation\n// \n$ python manage.py generate-api -f  # no input (API folder is overwritten)\n```\n\n\u003cbr /\u003e\n\n\u003e 👉 Create the Superuser\n\n```bash\n$ python manage.py createsuperuser\n```\n\n\u003cbr /\u003e\n\n\u003e 👉 Start the app\n\n```bash\n$ python manage.py runserver\n```\n\nAt this point, the app runs at `http://127.0.0.1:8000/` and the generated API can be found at: \n\n- http://localhost:8000/api/product/ - For `products`\n- http://localhost:8000/api/sales/ - For `sales` \n\nThe default API nodes can be tested via this [POSTMAN](./media/test.postman_collection) Collection.  \n\n\u003cbr /\u003e\n\n## How to use the API\n\n- Start the app\n- Make sure the endpoints are up \u0026 running \n- Authenticate via API and het the access token\n  - `http://localhost:8000/login/jwt/` usind existing credentials \n  - Save the token in the requests `HEADER`\n- `GET Requests` are public (no token required)\n  - GET ALL products: `http://localhost:8000/api/product/`\n  - GET product by ID: `http://localhost:8000/api/product/1/`\n  - GET ALL Sales: `http://localhost:8000/api/sales/`\n- `Create`, `Delete`, `Update` requires a token in the header\n\nFor API sample requests, open and edit the [POSTMAN](./media/test.postman_collection) Collection sample.\n\n\u003cbr /\u003e\n\n## How Update the API\n\n- Define or update your models\n- Migrate the database\n- Update the configuration `API_GENERATOR` section\n- Regenerate the API\n  - `python manage.py generate-api`\n\nAt this point, you should be able to use the API. For more information regarding the library used to generate the code, access: \n\n\u003e 👉 [API Generator for Django](https://github.com/app-generator/django-api-generator) - Open-Source Library\n\n\u003cbr /\u003e\n\n## Codebase structure\n\nThe project is coded using a simple and intuitive structure presented below:\n\n```bash\n\u003c PROJECT ROOT \u003e\n   |\n   |-- core/                            \n   |    |-- settings.py                  # Project Configuration  \n   |    |-- urls.py                      # Project Routing\n   |\n   |-- home/\n   |    |-- views.py                     # APP Views \n   |    |-- urls.py                      # APP Routing\n   |    |-- models.py                    # APP Models \n   |    |-- tests.py                     # Tests  \n   |    |-- templates/                   # Theme Customisation \n   |         |-- includes                # \n   |              |-- footer.py          # Custom Footer      \n   |     \n   |-- requirements.txt                  # Project Dependencies\n   |\n   |-- env.sample                        # ENV Configuration (default values)\n   |-- manage.py                         # Start the app - Django default start script\n   |\n   |-- ************************************************************************\n```\n\n\u003cbr /\u003e \n\n---\n[Django Dynamic Services](https://app-generator.dev/docs/developer-tools/dynamic-django/index.html) - Open-Source **Django** starter provided by **[App-Generator](https://app-generator.dev/)**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapp-generator%2Fdjango-dynamic-services","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapp-generator%2Fdjango-dynamic-services","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapp-generator%2Fdjango-dynamic-services/lists"}