ssb-project-cli


Namessb-project-cli JSON
Version 1.3.9 PyPI version JSON
download
home_pagehttps://github.com/statisticsnorway/ssb-project-cli
SummarySSB Project CLI
upload_time2023-12-08 13:23:52
maintainer
docs_urlNone
authorStatistics Norway
requires_python>=3.10,<3.12
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # SSB Project CLI

[![PyPI](https://img.shields.io/pypi/v/ssb-project-cli.svg)][pypi status]
[![Status](https://img.shields.io/pypi/status/ssb-project-cli.svg)][pypi status]
[![Python Version](https://img.shields.io/pypi/pyversions/ssb-project-cli)][pypi status]
[![License](https://img.shields.io/pypi/l/ssb-project-cli)][license]

[![Read the documentation](https://img.shields.io/badge/docs-Github%20Pages-purple)](https://statisticsnorway.github.io/ssb-project-cli/)
[![Tests](https://github.com/statisticsnorway/ssb-project-cli/workflows/Tests/badge.svg)][tests]
[![Codecov](https://codecov.io/gh/statisticsnorway/ssb-project-cli/branch/main/graph/badge.svg)][codecov]

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]
[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][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

![Help text](/docs/assets/images/cli_help_screenshot.png)

- 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": "https://github.com/statisticsnorway/ssb-project-cli",
    "name": "ssb-project-cli",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10,<3.12",
    "maintainer_email": "",
    "keywords": "",
    "author": "Statistics Norway",
    "author_email": "stat-dev@ssb.no",
    "download_url": "https://files.pythonhosted.org/packages/b7/96/483ed1419794cf1d4f4c2bdd4ac724db9e353736051edd4771b82ea1c8ef/ssb_project_cli-1.3.9.tar.gz",
    "platform": null,
    "description": "# SSB Project CLI\n\n[![PyPI](https://img.shields.io/pypi/v/ssb-project-cli.svg)][pypi status]\n[![Status](https://img.shields.io/pypi/status/ssb-project-cli.svg)][pypi status]\n[![Python Version](https://img.shields.io/pypi/pyversions/ssb-project-cli)][pypi status]\n[![License](https://img.shields.io/pypi/l/ssb-project-cli)][license]\n\n[![Read the documentation](https://img.shields.io/badge/docs-Github%20Pages-purple)](https://statisticsnorway.github.io/ssb-project-cli/)\n[![Tests](https://github.com/statisticsnorway/ssb-project-cli/workflows/Tests/badge.svg)][tests]\n[![Codecov](https://codecov.io/gh/statisticsnorway/ssb-project-cli/branch/main/graph/badge.svg)][codecov]\n\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]\n[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][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![Help text](/docs/assets/images/cli_help_screenshot.png)\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.3.9",
    "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": "4c674144f40d8c2fc43a25e8e8639d2c67384fc6679d8fd9b1d1020fe9cbacb8",
                "md5": "2a524d50f6164d5c7573d90d2e918570",
                "sha256": "8e020eff7d3c2b83e86fd70f5cefee9d1fcf9af125e8cb6eedcdf8f95fc99223"
            },
            "downloads": -1,
            "filename": "ssb_project_cli-1.3.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2a524d50f6164d5c7573d90d2e918570",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10,<3.12",
            "size": 27424,
            "upload_time": "2023-12-08T13:23:50",
            "upload_time_iso_8601": "2023-12-08T13:23:50.639083Z",
            "url": "https://files.pythonhosted.org/packages/4c/67/4144f40d8c2fc43a25e8e8639d2c67384fc6679d8fd9b1d1020fe9cbacb8/ssb_project_cli-1.3.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b796483ed1419794cf1d4f4c2bdd4ac724db9e353736051edd4771b82ea1c8ef",
                "md5": "c2db3089d7258f27dc2311f6b1dbd45f",
                "sha256": "6b70b1f7cbb88c6c9562204b37a3014d10ebb05277819b91403f3ab121b8070b"
            },
            "downloads": -1,
            "filename": "ssb_project_cli-1.3.9.tar.gz",
            "has_sig": false,
            "md5_digest": "c2db3089d7258f27dc2311f6b1dbd45f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10,<3.12",
            "size": 20745,
            "upload_time": "2023-12-08T13:23:52",
            "upload_time_iso_8601": "2023-12-08T13:23:52.358942Z",
            "url": "https://files.pythonhosted.org/packages/b7/96/483ed1419794cf1d4f4c2bdd4ac724db9e353736051edd4771b82ea1c8ef/ssb_project_cli-1.3.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-12-08 13:23:52",
    "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"
}
        
Elapsed time: 0.14122s