{"id":19406094,"url":"https://github.com/avsolatorio/pyscaffoldext-dsproject-vscode","last_synced_at":"2026-05-07T03:33:35.918Z","repository":{"id":62583294,"uuid":"285673668","full_name":"avsolatorio/pyscaffoldext-dsproject-vscode","owner":"avsolatorio","description":"A quick way to start your data science project. This extension is derived from the dsproject pyscaffold. It extends the scaffold to seamlessly integrate with VS Code's containerized dev environment. The design allows for multiple DS projects in a single host to share a single base conda container containing some core DS libraries.","archived":false,"fork":false,"pushed_at":"2020-11-12T03:51:10.000Z","size":113,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-07T18:15:48.425Z","etag":null,"topics":["conda","data-science","docker","docker-compose","pyscaffold","pyscaffold-extension","python","vscode","vscode-extension"],"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/avsolatorio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-06T21:20:36.000Z","updated_at":"2020-11-12T03:42:31.000Z","dependencies_parsed_at":"2022-11-03T21:22:05.259Z","dependency_job_id":null,"html_url":"https://github.com/avsolatorio/pyscaffoldext-dsproject-vscode","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avsolatorio%2Fpyscaffoldext-dsproject-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avsolatorio%2Fpyscaffoldext-dsproject-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avsolatorio%2Fpyscaffoldext-dsproject-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avsolatorio%2Fpyscaffoldext-dsproject-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avsolatorio","download_url":"https://codeload.github.com/avsolatorio/pyscaffoldext-dsproject-vscode/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240582045,"owners_count":19824145,"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":["conda","data-science","docker","docker-compose","pyscaffold","pyscaffold-extension","python","vscode","vscode-extension"],"created_at":"2024-11-10T11:41:02.470Z","updated_at":"2026-05-07T03:33:35.891Z","avatar_url":"https://github.com/avsolatorio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://api.travis-ci.com/avsolatorio/pyscaffoldext-dsproject-vscode.svg?branch=master)](https://travis-ci.com/github/avsolatorio/pyscaffoldext-dsproject-vscode)\n[![Coverage Status](https://coveralls.io/repos/github/avsolatorio/pyscaffoldext-dsproject-vscode/badge.svg?branch=master)](https://coveralls.io/github/avsolatorio/pyscaffoldext-dsproject-vscode?branch=master)\n[![PyPI-Server](https://img.shields.io/pypi/v/pyscaffoldext-dsproject-vscode.svg)](https://pypi.org/project/pyscaffoldext-dsproject-vscode)\n\n# pyscaffoldext-dsproject-vscode\n\nThis extension is forked from the awesome [PyScaffold DSProject](https://github.com/pyscaffold/pyscaffoldext-dsproject) extension.\n\nThis version of the extension extends the functionality by adding a scaffold component for using the VS Code container development integration.\n\nTo benefit from this setup, you must use VS Code with Python and Remote - Containers extensions installed. Docker should also be installed on the host machine.\n\n## Usage\n\nJust install this package with `pip install pyscaffoldext-dsproject-vscode`\nand note that `putup -h` shows a new option `--dsproject-vscode`.\nCreating a data science project with VS Code container development integration is then as easy as:\n\n```\nputup --dsproject-vscode my_ds_project\n```\n\nAfter the project is created, set the following softlinks from the project root:\n\n```\nln -s path.env .env\n```\n\nIf you want to develop locally, create this softlink:\n\n```\nln -s .devcontainer/devcontainer.local.json .devcontainer/devcontainer.json\n```\n\nAlternatively, if you want to develop using a remote docker server, use this:\n\n```\nln -s .devcontainer/devcontainer.remote.json .devcontainer/devcontainer.json\n```\n\nIf you have an application that will run inside the dev container that requires a port, specify the list of ports under the `forwardPorts` attribute in the following files:\n\n```\n.devcontainer/devcontainer.local.json\n.devcontainer/devcontainer.remote.json\n```\n\n## Remote docker server\n\nTo use a remote docker server, specify the `docker.host` attribute in the `.vscode/settings.json` following the template in the file.\n\nEdit the value of the `REMOTE_PATH` attribute in the `.env` file with the absolute path of the project in the remote server.\n\n----------------------------\n\n# pyscaffoldext-dsproject\n\n[PyScaffold] extension tailored for *Data Science* projects. This extension is inspired by\n[cookiecutter-data-science] and enhanced in many ways. The main differences are that it\n1. advocates a proper Python package structure that can be shipped and distributed,\n2. uses a [conda] environment instead of something [virtualenv]-based and is thus more suitable\n   for data science projects,\n3. more default configurations for [Sphinx], [py.test], [pre-commit], etc. to foster\n   clean coding and best practices.\n\nAlso consider using [dvc] to version control and share your data within your team.\nRead [this blogpost] to learn how to work with JupyterLab notebooks efficiently by using a\ndata science project structure like this.\n\nThe final directory structure looks like:\n```\n├── AUTHORS.rst             \u003c- List of developers and maintainers.\n├── CHANGELOG.rst           \u003c- Changelog to keep track of new features and fixes.\n├── LICENSE.txt             \u003c- License as chosen on the command-line.\n├── README.md               \u003c- The top-level README for developers.\n├── configs                 \u003c- Directory for configurations of model \u0026 application.\n├── data\n│   ├── external            \u003c- Data from third party sources.\n│   ├── interim             \u003c- Intermediate data that has been transformed.\n│   ├── processed           \u003c- The final, canonical data sets for modeling.\n│   └── raw                 \u003c- The original, immutable data dump.\n├── docs                    \u003c- Directory for Sphinx documentation in rst or md.\n├── environment.yaml        \u003c- The conda environment file for reproducibility.\n├── models                  \u003c- Trained and serialized models, model predictions,\n│                              or model summaries.\n├── notebooks               \u003c- Jupyter notebooks. Naming convention is a number (for\n│                              ordering), the creator's initials and a description,\n│                              e.g. `1.0-fw-initial-data-exploration`.\n├── references              \u003c- Data dictionaries, manuals, and all other materials.\n├── reports                 \u003c- Generated analysis as HTML, PDF, LaTeX, etc.\n│   └── figures             \u003c- Generated plots and figures for reports.\n├── scripts                 \u003c- Analysis and production scripts which import the\n│                              actual PYTHON_PKG, e.g. train_model.\n├── setup.cfg               \u003c- Declarative configuration of your project.\n├── setup.py                \u003c- Use `python setup.py develop` to install for development or\n|                              or create a distribution with `python setup.py bdist_wheel`.\n├── src\n│   └── PYTHON_PKG          \u003c- Actual Python package where the main functionality goes.\n├── tests                   \u003c- Unit tests which can be run with `py.test`.\n├── .coveragerc             \u003c- Configuration for coverage reports of unit tests.\n├── .isort.cfg              \u003c- Configuration for git hook that sorts imports.\n└── .pre-commit-config.yaml \u003c- Configuration of pre-commit git hooks.\n```\n\nSee a demonstration of the initial project structure under [dsproject-demo] and also check out\nthe the documentation of [PyScaffold] for more information.\n\n\n## Usage\n\nJust install this package with `pip install pyscaffoldext-dsproject`\nand note that `putup -h` shows a new option `--dsproject`.\nCreating a data science project is then as easy as:\n```\nputup --dsproject my_ds_project\n```\n\n## Note\n\nThis project has been set up using PyScaffold 3.2. For details and usage\ninformation on PyScaffold see https://pyscaffold.org/.\n\n[PyScaffold]: https://pyscaffold.org/\n[cookiecutter-data-science]: https://github.com/drivendata/cookiecutter-data-science\n[Miniconda]: https://docs.conda.io/en/latest/miniconda.html\n[Jupyter]: https://jupyter.org/\n[dsproject-demo]: https://github.com/pyscaffold/dsproject-demo\n[Sphinx]: http://www.sphinx-doc.org/\n[py.test]: https://docs.pytest.org/\n[conda]: https://docs.conda.io/\n[virtualenv]: https://virtualenv.pypa.io/\n[pre-commit]: https://pre-commit.com/\n[dvc]: https://dvc.org/\n[this blogpost]: https://florianwilhelm.info/2018/11/working_efficiently_with_jupyter_lab/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favsolatorio%2Fpyscaffoldext-dsproject-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favsolatorio%2Fpyscaffoldext-dsproject-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favsolatorio%2Fpyscaffoldext-dsproject-vscode/lists"}