|
1 | | -# norwegianblue |
2 | | - |
3 | | -[](https://pypi.org/project/norwegianblue/) |
4 | | -[](https://pypi.org/project/norwegianblue/) |
5 | | -[](https://pypistats.org/packages/norwegianblue) |
6 | | -[](https://github.com/hugovk/norwegianblue/actions) |
7 | | -[](https://codecov.io/gh/hugovk/norwegianblue) |
8 | | -[](LICENSE.txt) |
| 1 | +# pepotron |
| 2 | + |
| 3 | +[](https://pypi.org/project/pepotron/) |
| 4 | +[](https://pypi.org/project/pepotron/) |
| 5 | +[](https://pypistats.org/packages/pepotron) |
| 6 | +[](https://github.com/hugovk/pepotron/actions) |
| 7 | +[](https://codecov.io/gh/hugovk/pepotron) |
| 8 | +[](LICENSE.txt) |
9 | 9 | [](https://github.com/psf/black) |
10 | 10 |
|
11 | | -<p align="center"><img src="https://raw.githubusercontent.com/hugovk/norwegianblue/main/img/eol-python.png" width="319" height="197"></p> |
12 | | - |
13 | | -Python interface to [endoflife.date](https://endoflife.date/docs/api/) to show |
14 | | -end-of-life dates for a number of products. |
| 11 | +CLI to open PEPs in your browser. |
15 | 12 |
|
16 | 13 | ## Installation |
17 | 14 |
|
18 | 15 | ### From PyPI |
19 | 16 |
|
20 | 17 | ```bash |
21 | | -python -m pip install --upgrade norwegianblue |
| 18 | +python3 -m pip install --upgrade pepotron |
22 | 19 | ``` |
23 | 20 |
|
24 | 21 | ### From source |
25 | 22 |
|
26 | 23 | ```bash |
27 | | -git clone https://github.com/hugovk/norwegianblue |
28 | | -cd norwegianblue |
| 24 | +git clone https://github.com/hugovk/pepotron |
| 25 | +cd pepotron |
29 | 26 | pip install . |
30 | 27 | ``` |
31 | 28 |
|
32 | | -## Example command-line use |
33 | | - |
34 | | -Run `norwegianblue` or `eol`, they do the same thing. |
| 29 | +## Usage |
35 | 30 |
|
36 | | -Top-level help: |
| 31 | +### Help |
37 | 32 |
|
38 | 33 | <!-- [[[cog |
39 | 34 | from scripts.run_command import run |
40 | | -run("eol --help") |
| 35 | +run("pep --help") |
41 | 36 | ]]] --> |
42 | 37 |
|
43 | 38 | ```console |
44 | | -$ eol --help |
45 | | -usage: eol [-h] [-f {html,json,markdown,rst,tsv}] [-c {yes,no,auto}] |
46 | | - [--clear-cache] [-v] [-V] |
47 | | - [product] |
48 | | - |
49 | | -CLI to show end-of-life dates for a number of products, from https://endoflife.date |
| 39 | +$ pep --help |
| 40 | +usage: pep [-h] [-u URL] [-V] search |
50 | 41 |
|
51 | | -For example: |
52 | | - |
53 | | -* `eol python` to see Python EOLs |
54 | | -* `eol ubuntu` to see Ubuntu EOLs |
55 | | -* `eol all` to list all available products |
56 | | - |
57 | | -Something missing? Please contribute! https://endoflife.date/contribute |
| 42 | +CLI to open PEPs in your browser |
58 | 43 |
|
59 | 44 | positional arguments: |
60 | | - product Product to check, or 'all' to list all available |
61 | | - (default: all) |
| 45 | + search PEP number, or Python version for its schedule |
62 | 46 |
|
63 | 47 | options: |
64 | | - -h, --help show this help message and exit |
65 | | - -f {html,json,markdown,rst,tsv}, --format {html,json,markdown,rst,tsv} |
66 | | - The format of output (default: markdown) |
67 | | - -c {yes,no,auto}, --color {yes,no,auto} |
68 | | - color terminal output (default: auto) |
69 | | - --clear-cache Clear cache before running (default: False) |
70 | | - -v, --verbose Print debug messages to stderr (default: False) |
71 | | - -V, --version show program's version number and exit |
| 48 | + -h, --help show this help message and exit |
| 49 | + -u URL, --url URL Base URL for PEPs (default: https://peps.python.org) |
| 50 | + -V, --version show program's version number and exit |
72 | 51 | ``` |
73 | 52 |
|
74 | 53 | <!-- [[[end]]] --> |
75 | 54 |
|
76 | | -List all available products with end-of-life dates: |
| 55 | +### Open a PEP |
77 | 56 |
|
78 | 57 | ```console |
79 | | -$ # eol all |
80 | | -$ # or: |
| 58 | +$ pep 8 |
| 59 | +https://peps.python.org/pep-0008/ |
81 | 60 | ``` |
82 | 61 |
|
83 | | -<!-- [[[cog |
84 | | -from scripts.run_command import run |
85 | | -run("eol", line_limit=5) |
86 | | -]]] --> |
| 62 | +### Open release schedule PEP for a Python version |
87 | 63 |
|
88 | 64 | ```console |
89 | | -$ eol |
90 | | -alpine |
91 | | -amazon-eks |
92 | | -amazon-linux |
93 | | -android |
94 | | -angular |
95 | | -... |
| 65 | +$ pep 3.11 |
| 66 | +https://peps.python.org/pep-0664/ |
96 | 67 | ``` |
97 | | - |
98 | | -<!-- [[[end]]] --> |
99 | | - |
100 | | -Show end-of-life dates: |
101 | | - |
102 | | -<!-- [[[cog |
103 | | -from scripts.run_command import run |
104 | | -run("norwegianblue python") |
105 | | -]]] --> |
106 | | - |
107 | | -```console |
108 | | -$ norwegianblue python |
109 | | -| cycle | latest | release | eol | |
110 | | -|:------|:-------|:----------:|:----------:| |
111 | | -| 3.10 | 3.10.0 | 2021-10-04 | 2026-10-04 | |
112 | | -| 3.9 | 3.9.9 | 2020-10-05 | 2025-10-05 | |
113 | | -| 3.8 | 3.8.12 | 2019-10-14 | 2024-10-14 | |
114 | | -| 3.7 | 3.7.12 | 2018-06-27 | 2023-06-27 | |
115 | | -| 3.6 | 3.6.15 | 2016-12-23 | 2021-12-23 | |
116 | | -| 3.5 | 3.5.10 | 2015-09-30 | 2020-09-13 | |
117 | | -| 3.4 | 3.4.10 | 2014-03-16 | 2019-03-18 | |
118 | | -| 3.3 | 3.3.7 | 2012-09-29 | 2017-09-29 | |
119 | | -| 2.7 | 2.7.18 | 2010-07-03 | 2020-01-01 | |
120 | | -``` |
121 | | - |
122 | | -<!-- [[[end]]] --> |
123 | | - |
124 | | -The table is Markdown, ready for pasting in GitHub issues and PRs: |
125 | | - |
126 | | -<!-- [[[cog |
127 | | -from scripts.run_command import run |
128 | | -run("norwegianblue python", with_console=False) |
129 | | -]]] --> |
130 | | - |
131 | | -| cycle | latest | release | eol | |
132 | | -| :---- | :----- | :--------: | :--------: | |
133 | | -| 3.10 | 3.10.0 | 2021-10-04 | 2026-10-04 | |
134 | | -| 3.9 | 3.9.9 | 2020-10-05 | 2025-10-05 | |
135 | | -| 3.8 | 3.8.12 | 2019-10-14 | 2024-10-14 | |
136 | | -| 3.7 | 3.7.12 | 2018-06-27 | 2023-06-27 | |
137 | | -| 3.6 | 3.6.15 | 2016-12-23 | 2021-12-23 | |
138 | | -| 3.5 | 3.5.10 | 2015-09-30 | 2020-09-13 | |
139 | | -| 3.4 | 3.4.10 | 2014-03-16 | 2019-03-18 | |
140 | | -| 3.3 | 3.3.7 | 2012-09-29 | 2017-09-29 | |
141 | | -| 2.7 | 2.7.18 | 2010-07-03 | 2020-01-01 | |
142 | | - |
143 | | -<!-- [[[end]]] --> |
144 | | - |
145 | | -With options: |
146 | | - |
147 | | -<!-- [[[cog |
148 | | -from scripts.run_command import run |
149 | | -run("eol nodejs --format rst") |
150 | | -]]] --> |
151 | | - |
152 | | -```console |
153 | | -$ eol nodejs --format rst |
154 | | -.. table:: |
155 | | - |
156 | | - ======== ========= ============ ============ ============ |
157 | | - cycle latest release support eol |
158 | | - ======== ========= ============ ============ ============ |
159 | | - 17 17.1.0 2021-10-19 2022-04-01 2022-06-01 |
160 | | - 16 LTS 16.13.0 2021-04-20 2022-10-18 2024-04-30 |
161 | | - 15 15.14.0 2020-10-20 2021-04-01 2021-06-01 |
162 | | - 14 LTS 14.18.1 2020-04-21 2021-10-19 2023-04-30 |
163 | | - 12 LTS 12.22.7 2019-04-23 2020-10-20 2022-04-30 |
164 | | - 10 LTS 10.24.1 2018-04-24 2020-05-19 2021-04-30 |
165 | | - ======== ========= ============ ============ ============ |
166 | | -``` |
167 | | - |
168 | | -<!-- [[[end]]] --> |
169 | | - |
170 | | -## Example programmatic use |
171 | | - |
172 | | -Return values are from the JSON responses documented in the API: |
173 | | -https://endoflife.date/docs/api/ |
174 | | - |
175 | | -```python |
176 | | -import norwegianblue |
177 | | - |
178 | | -# Call the API |
179 | | -print(norwegianblue.norwegianblue()) |
180 | | -print(norwegianblue.norwegianblue(product="ubuntu")) |
181 | | -print(norwegianblue.norwegianblue(format="json")) |
182 | | -``` |
183 | | - |
184 | | -## Why "Norwegian Blue"? |
185 | | - |
186 | | -[The Norwegian Blue has reached end-of-life.](https://youtu.be/vnciwwsvNcc) |
0 commit comments