# DISCONTINUED
This has been discontinued in favor of
[ppa-dev-tools](https://code.launchpad.net/~bryce/ppa-dev-tools/+git/ppa-dev-tools-1).
While this is still useful for examples, I no longer intend to proceed with
development for this tool. Please, use ppa-dev-tools instead.
# lppa
Command line tool to create Launchpad PPAs and push deb source packages to them.
While this tool is intended to be used by distribution developers who often
need to prepare and push packages to test PPAs, this can also be used by
developers who wish to distribute their software through PPAs. For the latter,
please make sure to check the documentation since the default values are
designed to enhance the former use cases.
## Installation
```
pip install lppa
```
## Usage
lppa ships an `lppa` command line application to interact with Launchpad PPAs.
Run
```
lppa --help
```
for additional information.
### Create a new PPA
To create a new PPA, run
```
lppa create PPA_NAME [all|arch, ...]
```
where arch is a Launchpad processor (you can pass multiple architectures here)
or `all` to enable all available architectures. If no architecture is passed,
`all` is assumed.
The currently available Launchpad processors are
- amd64
- arm64
- s390x
- ppc64el
- armhf
- armel
- i386
- powerpc
- riscv64
### Delete an existing PPA
```
lppa delete PPA_NAME
```
### List user's PPAs
```
lppa list
```
This will print a list with the names of the user's available PPAs
### Fetch PPA information
Often, you may want to retrieve an URL for a PPA packages page or quickly fetch
a dput command to upload packages to a PPA. That can be achieved through the
`info` command.
```
lppa info PPA_NAME
```
Moreover, passing the `-v` option to the info command will also display the
architectures for which the PPA can build packages.
## Development
Run `make devel` to set the development environment up (a python virtual
environment is recommended).
Run `make check` to run the test suite and ensure the development environment
is up to date.
You can use `make coverage` to ensure code coverage is not drastically reduced
by new changes (if proposing changes, try to write some tests for them).
For instance, a complete bootstrap script would look like:
```
# apt install -y python3-virtualenv python3-virtualenvwrapper
$ mkvirtualenv lppa
$ workon lppa
$ make devel
$ make check
```
### Releasing
There is a `make release` target which will
- Change `lppa/__init__.py` to set the version to be published
- Update the CHANGELOG.md file with towncrier entries
- Commit the changes above and tag the repository
- Push the changes to PyPI (login required)
- Add a final commit bumping the package version to a new development one
Finally, a manual `git push` (including tags) is required.
Raw data
{
"_id": null,
"home_page": "https://github.com/athos-ribeiro/lppa",
"name": "lppa",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "PPA, Ubuntu, Launchpad",
"author": "Athos Ribeiro",
"author_email": "athos.ribeiro@canonical.com",
"download_url": "https://files.pythonhosted.org/packages/1c/45/ce7a85ccf4af8f39cec2dc0d90ed0a02e5bc507ef4de854a98ab6b10d481/lppa-0.3.0.tar.gz",
"platform": "any",
"description": "# DISCONTINUED\n\nThis has been discontinued in favor of\n[ppa-dev-tools](https://code.launchpad.net/~bryce/ppa-dev-tools/+git/ppa-dev-tools-1).\n\nWhile this is still useful for examples, I no longer intend to proceed with\ndevelopment for this tool. Please, use ppa-dev-tools instead.\n\n# lppa\n\nCommand line tool to create Launchpad PPAs and push deb source packages to them.\n\nWhile this tool is intended to be used by distribution developers who often\nneed to prepare and push packages to test PPAs, this can also be used by\ndevelopers who wish to distribute their software through PPAs. For the latter,\nplease make sure to check the documentation since the default values are\ndesigned to enhance the former use cases.\n\n## Installation\n\n```\npip install lppa\n```\n\n## Usage\n\nlppa ships an `lppa` command line application to interact with Launchpad PPAs.\nRun\n\n```\nlppa --help\n```\n\nfor additional information.\n\n### Create a new PPA\n\nTo create a new PPA, run\n\n```\nlppa create PPA_NAME [all|arch, ...]\n```\n\nwhere arch is a Launchpad processor (you can pass multiple architectures here)\nor `all` to enable all available architectures. If no architecture is passed,\n`all` is assumed.\n\nThe currently available Launchpad processors are\n\n- amd64\n- arm64\n- s390x\n- ppc64el\n- armhf\n- armel\n- i386\n- powerpc\n- riscv64\n\n### Delete an existing PPA\n\n```\nlppa delete PPA_NAME\n```\n\n### List user's PPAs\n\n```\nlppa list\n```\n\nThis will print a list with the names of the user's available PPAs\n\n### Fetch PPA information\n\nOften, you may want to retrieve an URL for a PPA packages page or quickly fetch\na dput command to upload packages to a PPA. That can be achieved through the\n`info` command.\n\n```\nlppa info PPA_NAME\n```\n\nMoreover, passing the `-v` option to the info command will also display the\narchitectures for which the PPA can build packages.\n\n## Development\n\nRun `make devel` to set the development environment up (a python virtual\nenvironment is recommended).\n\nRun `make check` to run the test suite and ensure the development environment\nis up to date.\n\nYou can use `make coverage` to ensure code coverage is not drastically reduced\nby new changes (if proposing changes, try to write some tests for them).\n\nFor instance, a complete bootstrap script would look like:\n\n```\n# apt install -y python3-virtualenv python3-virtualenvwrapper\n$ mkvirtualenv lppa\n$ workon lppa\n$ make devel\n$ make check\n```\n\n### Releasing\n\nThere is a `make release` target which will\n\n- Change `lppa/__init__.py` to set the version to be published\n- Update the CHANGELOG.md file with towncrier entries\n- Commit the changes above and tag the repository\n- Push the changes to PyPI (login required)\n- Add a final commit bumping the package version to a new development one\n\nFinally, a manual `git push` (including tags) is required.\n",
"bugtrack_url": null,
"license": "GPLv3+",
"summary": "Request PPAs for deb source packages",
"version": "0.3.0",
"project_urls": {
"Bug Tracker": "https://github.com/athos-ribeiro/lppa/issues",
"Changelog": "https://github.com/athos-ribeiro/lppa/blob/main/CHANGELOG.md",
"Homepage": "https://github.com/athos-ribeiro/lppa",
"Source Code": "https://github.com/athos-ribeiro/lppa"
},
"split_keywords": [
"ppa",
" ubuntu",
" launchpad"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "655171a1cbb5c49d35273fa325ecb2593255c2b16cc01bcaabb007164a5e9a9a",
"md5": "fbc36b046616fc434da847f3e13c5a97",
"sha256": "7309e87cd926e3aa187523b930a0b35c760688cf3fe8ddb119bc70578f3222d6"
},
"downloads": -1,
"filename": "lppa-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fbc36b046616fc434da847f3e13c5a97",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 23999,
"upload_time": "2024-04-21T12:47:00",
"upload_time_iso_8601": "2024-04-21T12:47:00.563465Z",
"url": "https://files.pythonhosted.org/packages/65/51/71a1cbb5c49d35273fa325ecb2593255c2b16cc01bcaabb007164a5e9a9a/lppa-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1c45ce7a85ccf4af8f39cec2dc0d90ed0a02e5bc507ef4de854a98ab6b10d481",
"md5": "e9c741a45a7a84b8b06e415bf582148f",
"sha256": "0cd79133c2c68a56b14c2eeebd538e675605b490603e3683c9ac6bf9e28ed856"
},
"downloads": -1,
"filename": "lppa-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "e9c741a45a7a84b8b06e415bf582148f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 24461,
"upload_time": "2024-04-21T12:47:02",
"upload_time_iso_8601": "2024-04-21T12:47:02.912193Z",
"url": "https://files.pythonhosted.org/packages/1c/45/ce7a85ccf4af8f39cec2dc0d90ed0a02e5bc507ef4de854a98ab6b10d481/lppa-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-21 12:47:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "athos-ribeiro",
"github_project": "lppa",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "lppa"
}
JSON
