posit-dev / posit-dev/rsconnect-python
Suggestion: rename `rsconnect deploy api` command to `rsconnect deploy flask`
Ouverte
Personne n'a encore pris cette issue.
- #497 par @tdstein — fermée sans fusion
- Langage dominant
- Python
- Étoiles
- 37
- Forks
- 28
- Merge moyen
- 1 j 3 h
- PR mergées (30 j)
- 7
Description
The rsconnect deploy command has the following options:
$ rsconnect deploy --help
Usage: rsconnect deploy [OPTIONS] COMMAND [ARGS]...
Deploy content to Posit Connect, Posit Cloud, or shinyapps.io.
Options:
--help Show this message and exit.
Commands:
api Deploy a Python API to Posit Connect [v1.8.2+], Posit Cloud,
or shinyapps.io.
bokeh Deploy a Bokeh Application to Posit Connect [v1.8.4+], Posit
Cloud, or shinyapps.io.
dash Deploy a Dash Application to Posit Connect [v1.8.2+], Posit
Cloud, or shinyapps.io.
fastapi Deploy a Python FastAPI to Posit Connect [v2021.08.0+], Posit
Cloud, or shinyapps.io.
html Deploy html content to Posit Connect or Posit Cloud.
manifest Deploy content to Posit Connect, Posit Cloud, or shinyapps.io
by manifest.
notebook Deploy Jupyter notebook to Posit Connect [v1.7.0+].
other-content Describe deploying other content to Posit Connect.
quarto Deploy Quarto content to Posit Connect [v2021.08.0+] or Posit
Cloud.
shiny Deploy a Python Shiny Application to Posit Connect
[v2022.07.0+], Posit Cloud, or shinyapps.io.
streamlit Deploy a Streamlit Application to Posit Connect [v1.8.4+],
Posit Cloud, or shinyapps.io.
voila Deploy Jupyter notebook in Voila mode to Posit Connect
[v2023.03.0+].
I propose renaming rsconnect deploy api to rsconnect deploy flask.
- Now that FastAPI is supported, it is confusing that the command to deploy a flask API is called
api(all of the other deploy commands use the framework name). - The help message is also confusing and does not mention Flask (e.g.
Deploy a Python API to Posit Connect [v1.8.2+], Posit Cloud, or shinyapps.io.. It is unclear to users what a "Python API" is. - This can be done so that backwards compatibility is not broken, but we only document and recommend
rsconnect deploy flask.
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez au point d’entrée de la commande rsconnect deploy, en particulier avec le sous-commande api existante et son texte d’aide. Suivez l’endroit où la commande est enregistrée et documentée, puis vérifiez que flask est le nom recommandé, que api reste rétrocompatible et que le texte d’aide identifie clairement Flask.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- flask, python
- Domaine
- cli
- Type d'issue
- Fonctionnalité
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Activité
- À l'abandon
- Clarté
- Plutôt claire
- Accessibilité débutants
- 35/100