| Name | ssb-project-cli JSON |
| Version |
1.5.0
JSON |
| download |
| home_page | None |
| Summary | SSB Project CLI |
| upload_time | 2025-02-19 13:24:56 |
| maintainer | None |
| docs_url | None |
| author | Statistics Norway |
| requires_python | <3.13,>=3.10 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# SSB Project CLI
[][pypi status]
[][pypi status]
[][pypi status]
[][license]
[](https://statisticsnorway.github.io/ssb-project-cli/)
[][tests]
[][codecov]
[][pre-commit]
[][black]
[pypi status]: https://pypi.org/project/ssb-project-cli/
[tests]: https://github.com/statisticsnorway/ssb-project-cli/actions?workflow=Tests
[codecov]: https://app.codecov.io/gh/statisticsnorway/ssb-project-cli
[pre-commit]: https://github.com/pre-commit/pre-commit
[black]: https://github.com/psf/black
## Features
- Create a new project quickly and easily with `ssb-project create`.
- Your colleagues can quickly get started when you share the project with them with `ssb-project build`.
- Includes:
- Local directory structure
- Virtual Environment
- Kernel for use on Jupyter
- Github repo (if desired)
- The project will follow the most recent SSB guidelines for security and quality.
- It will always be possible to update existing projects as guidelines change.
:sparkles: Now allows specifying _any_ Cookiecutter template which uses Poetry, for example
```shell
ssb-project create my-project --template-git-url https://github.com/cjolowicz/cookiecutter-hypermodern-python
```
## Installation
You can install _SSB Project CLI_ via [pip] from [PyPI]:
```console
pip install ssb-project-cli
```
## Releasing a new version
To release a new version of the CLI, run the following sequence.
```console
git switch --create release main
```
```console
poetry version <version>
```
```console
git commit --message="<project> <version>" pyproject.toml
```
```console
git push origin release
```
## Contributing
### Setup
1. [Install dependencies](https://cookiecutter-hypermodern-python.readthedocs.io/en/latest/guide.html#installation)
1. [Install pre-commit hooks](https://cookiecutter-hypermodern-python.readthedocs.io/en/latest/guide.html#running-pre-commit-from-git)
1. Run tests: `nox -r` ([More information here](https://cookiecutter-hypermodern-python.readthedocs.io/en/latest/guide.html#using-nox))
1. Run the help command: `poetry run ssb-project --help`
## License
Distributed under the terms of the [MIT license][license],
_SSB Project CLI_ is free and open source software.
<!-- github-only -->
[license]: https://github.com/statisticsnorway/ssb-project-cli/blob/main/LICENSE
Raw data
{
"_id": null,
"home_page": null,
"name": "ssb-project-cli",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Statistics Norway",
"author_email": "stat-dev@ssb.no",
"download_url": "https://files.pythonhosted.org/packages/f6/50/86df00e8cc1ac3ea16c8d0a2b017c834f63b543ec76c0955f05d2f07c490/ssb_project_cli-1.5.0.tar.gz",
"platform": null,
"description": "# SSB Project CLI\n\n[][pypi status]\n[][pypi status]\n[][pypi status]\n[][license]\n\n[](https://statisticsnorway.github.io/ssb-project-cli/)\n[][tests]\n[][codecov]\n\n[][pre-commit]\n[][black]\n\n[pypi status]: https://pypi.org/project/ssb-project-cli/\n[tests]: https://github.com/statisticsnorway/ssb-project-cli/actions?workflow=Tests\n[codecov]: https://app.codecov.io/gh/statisticsnorway/ssb-project-cli\n[pre-commit]: https://github.com/pre-commit/pre-commit\n[black]: https://github.com/psf/black\n\n## Features\n\n\n\n- Create a new project quickly and easily with `ssb-project create`.\n- Your colleagues can quickly get started when you share the project with them with `ssb-project build`.\n- Includes:\n - Local directory structure\n - Virtual Environment\n - Kernel for use on Jupyter\n - Github repo (if desired)\n- The project will follow the most recent SSB guidelines for security and quality.\n- It will always be possible to update existing projects as guidelines change.\n\n:sparkles: Now allows specifying _any_ Cookiecutter template which uses Poetry, for example\n\n```shell\nssb-project create my-project --template-git-url https://github.com/cjolowicz/cookiecutter-hypermodern-python\n```\n\n## Installation\n\nYou can install _SSB Project CLI_ via [pip] from [PyPI]:\n\n```console\npip install ssb-project-cli\n```\n\n## Releasing a new version\n\nTo release a new version of the CLI, run the following sequence.\n\n```console\ngit switch --create release main\n```\n\n```console\npoetry version <version>\n```\n\n```console\ngit commit --message=\"<project> <version>\" pyproject.toml\n```\n\n```console\ngit push origin release\n```\n\n## Contributing\n\n### Setup\n\n1. [Install dependencies](https://cookiecutter-hypermodern-python.readthedocs.io/en/latest/guide.html#installation)\n1. [Install pre-commit hooks](https://cookiecutter-hypermodern-python.readthedocs.io/en/latest/guide.html#running-pre-commit-from-git)\n1. Run tests: `nox -r` ([More information here](https://cookiecutter-hypermodern-python.readthedocs.io/en/latest/guide.html#using-nox))\n1. Run the help command: `poetry run ssb-project --help`\n\n## License\n\nDistributed under the terms of the [MIT license][license],\n_SSB Project CLI_ is free and open source software.\n\n<!-- github-only -->\n\n[license]: https://github.com/statisticsnorway/ssb-project-cli/blob/main/LICENSE\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "SSB Project CLI",
"version": "1.5.0",
"project_urls": {
"Changelog": "https://github.com/statisticsnorway/ssb-project-cli/releases",
"Documentation": "https://ssb-project-cli.readthedocs.io",
"Homepage": "https://github.com/statisticsnorway/ssb-project-cli",
"Repository": "https://github.com/statisticsnorway/ssb-project-cli"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cfeb2ac203aa70a39d20a83e4aa1836cfbf7e3ec8a0a93ce007b439ca32da4df",
"md5": "e1a759dafcef39f57cc37d4334334575",
"sha256": "ab59c340b519222b7290ff9abccbf485ec9c05f80250715b6b9d20a54247df48"
},
"downloads": -1,
"filename": "ssb_project_cli-1.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e1a759dafcef39f57cc37d4334334575",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 28231,
"upload_time": "2025-02-19T13:24:51",
"upload_time_iso_8601": "2025-02-19T13:24:51.678330Z",
"url": "https://files.pythonhosted.org/packages/cf/eb/2ac203aa70a39d20a83e4aa1836cfbf7e3ec8a0a93ce007b439ca32da4df/ssb_project_cli-1.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f65086df00e8cc1ac3ea16c8d0a2b017c834f63b543ec76c0955f05d2f07c490",
"md5": "e544faf78e379a984e535d44a0dd4130",
"sha256": "eea61cd31acc7bdd0698ebc4b441ecbee697bc8ffd500f87491d41fc8dee1722"
},
"downloads": -1,
"filename": "ssb_project_cli-1.5.0.tar.gz",
"has_sig": false,
"md5_digest": "e544faf78e379a984e535d44a0dd4130",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 20829,
"upload_time": "2025-02-19T13:24:56",
"upload_time_iso_8601": "2025-02-19T13:24:56.066549Z",
"url": "https://files.pythonhosted.org/packages/f6/50/86df00e8cc1ac3ea16c8d0a2b017c834f63b543ec76c0955f05d2f07c490/ssb_project_cli-1.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-19 13:24:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "statisticsnorway",
"github_project": "ssb-project-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ssb-project-cli"
}
