pypa / pypa/packaging.python.org

Document discouraged / deprecated setup arguments

Aperta
#293 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

type: enhancement
Lingua principale
Python
Stelle
1.7k
Fork
1.7k
Merge medio
3g 12h
PR unite (30g)
4

Descrizione

We presently document an opinionated set of setup args that are applicable to most packaging scenarios. We also have additional topics for more advanced use cases. However, we don't presently document arguments that should never be used or used with extreme caution.

So far, the ones I'm aware of are:

  1. requires dates from a pre-PyPI & setuptools time and has now been replaced by install_requires.
  2. provides is unused.
  3. obsoletes is unused.
  4. platforms has ambiguous behavior.
  5. dependency_links isn't supported by pip.
  6. download_url has surprising behavior and shouldn't be used.

(Original context: #264)

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Esamina la documentazione esistente sugli argomenti di setup e il contesto dell’issue #264 prima di decidere dove inserire queste note. Documenta le precauzioni relative a requires, provides, obsoletes, platforms, dependency_links e download_url, segnando il completamento quando tutti e sei gli argomenti sono stati trattati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Specificata chiaramente
Idoneità per principianti
45/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.