doc-zero 0.1.1__tar.gz → 0.1.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: doc-zero
3
- Version: 0.1.1
3
+ Version: 0.1.2
4
4
  Summary: Zero-configuration documentation generator for Python.
5
5
  Author: Fábio Macêdo Mendes
6
6
  Author-email: Fábio Macêdo Mendes <fabiomacedomendes@gmail.com>
@@ -22,14 +22,14 @@ Requires-Dist: typer>=0.27.0
22
22
  Maintainer: Fábio Macêdo Mendes
23
23
  Maintainer-email: Fábio Macêdo Mendes <fabiomacedomendes@gmail.com>
24
24
  Requires-Python: >=3.13
25
- Project-URL: Homepage, http://github.com/fabiommendes/zero-doc
26
- Project-URL: Repository, http://github.com/fabiommendes/zero-doc
27
- Project-URL: Documentation, https://zero-doc.readthedocs.io/
25
+ Project-URL: Homepage, http://github.com/fabiommendes/doc0
26
+ Project-URL: Repository, http://github.com/fabiommendes/doc0
27
+ Project-URL: Documentation, https://doc-zero.readthedocs.io/
28
28
  Description-Content-Type: text/markdown
29
29
 
30
30
  # doc-zero
31
31
 
32
- `doc-zero` streamlines the process of writing documentation for your project. It is
32
+ **Doc-zero** streamlines the process of writing documentation for your project. It is
33
33
  an opinionated and explicitly non-configurable tool that extracts information
34
34
  from your Python codebase and generates nice documentation with minimal effort.
35
35
 
@@ -40,28 +40,28 @@ but somewhat clunky to use and configure.
40
40
 
41
41
  ## How does it work?
42
42
 
43
- `doc0` introspect your codebase and creates a Sphinx project under the hood. In
43
+ `doc-zero` introspect your codebase and creates a Sphinx project under the hood. In
44
44
  practice, if you have a relatively modern Python project (i.e., it assumes the
45
45
  existence of pyproject.toml) just type
46
46
 
47
47
  ```bash
48
- $ doc0 build
48
+ $ doc-zero build # or the doc0 alias
49
49
  ```
50
50
 
51
51
  in the project root and it will create and build the documentation under
52
- `<project-root>/docs`. In `doc0`, all your documentation resides either in the
52
+ `<project-root>/docs`. In `doc-zero`, all your documentation resides either in the
53
53
  README.md file in your repository or inside the source code.
54
54
 
55
55
  You can also type
56
56
 
57
57
  ```bash
58
- $ doc0 serve
58
+ $ doc-zero serve
59
59
  ```
60
60
 
61
61
  and
62
62
 
63
63
  ```bash
64
- doc0 test
64
+ doc-zero test
65
65
  ```
66
66
 
67
67
  to run either the live server or to test the doctests inside the documentation.
@@ -69,16 +69,16 @@ to run either the live server or to test the doctests inside the documentation.
69
69
 
70
70
  ## Adding the documentation to your project
71
71
 
72
- Doc0 assumes your project is already documented using docstrings and that
72
+ Doc-zero assumes your project is already documented using docstrings and that
73
73
  you have a README.md file in the project root. It will use those assets to
74
74
  generate the documentation and the necessary configurations to make it buildable
75
75
  with Sphinx and ready to be hosted to readthedocs.io.
76
76
 
77
- The first step is to install `doc0` as a development dependency in your project.
77
+ The first step is to install `doc-zero` as a development dependency in your project.
78
78
  You can do this by running
79
79
 
80
80
  ```bash
81
- $ pip install doc0
81
+ $ pip install doc-zero
82
82
  ```
83
83
 
84
84
  or the equivalent command for the package manager of choice.
@@ -87,10 +87,10 @@ or the equivalent command for the package manager of choice.
87
87
  Then, the following command generates the documentation:
88
88
 
89
89
  ```bash
90
- $ doc0 build
90
+ $ doc-zero build
91
91
  ```
92
92
 
93
- `doc0` always creates a module documentation for your toplevel module. It will
93
+ `doc-zero` always creates a module documentation for your toplevel module. It will
94
94
  also scan all sub-modules and generate a documentation page if they satisfy the
95
95
  following conditions:
96
96
 
@@ -98,5 +98,5 @@ following conditions:
98
98
  * The module has a docstring.
99
99
  * The module defines a `__all__` variable that lists its public API.
100
100
 
101
- `doc0` only includes the public API in the generated documentation.
101
+ `doc-zero` only includes the public API in the generated documentation.
102
102
 
@@ -1,6 +1,6 @@
1
1
  # doc-zero
2
2
 
3
- `doc-zero` streamlines the process of writing documentation for your project. It is
3
+ **Doc-zero** streamlines the process of writing documentation for your project. It is
4
4
  an opinionated and explicitly non-configurable tool that extracts information
5
5
  from your Python codebase and generates nice documentation with minimal effort.
6
6
 
@@ -11,28 +11,28 @@ but somewhat clunky to use and configure.
11
11
 
12
12
  ## How does it work?
13
13
 
14
- `doc0` introspect your codebase and creates a Sphinx project under the hood. In
14
+ `doc-zero` introspect your codebase and creates a Sphinx project under the hood. In
15
15
  practice, if you have a relatively modern Python project (i.e., it assumes the
16
16
  existence of pyproject.toml) just type
17
17
 
18
18
  ```bash
19
- $ doc0 build
19
+ $ doc-zero build # or the doc0 alias
20
20
  ```
21
21
 
22
22
  in the project root and it will create and build the documentation under
23
- `<project-root>/docs`. In `doc0`, all your documentation resides either in the
23
+ `<project-root>/docs`. In `doc-zero`, all your documentation resides either in the
24
24
  README.md file in your repository or inside the source code.
25
25
 
26
26
  You can also type
27
27
 
28
28
  ```bash
29
- $ doc0 serve
29
+ $ doc-zero serve
30
30
  ```
31
31
 
32
32
  and
33
33
 
34
34
  ```bash
35
- doc0 test
35
+ doc-zero test
36
36
  ```
37
37
 
38
38
  to run either the live server or to test the doctests inside the documentation.
@@ -40,16 +40,16 @@ to run either the live server or to test the doctests inside the documentation.
40
40
 
41
41
  ## Adding the documentation to your project
42
42
 
43
- Doc0 assumes your project is already documented using docstrings and that
43
+ Doc-zero assumes your project is already documented using docstrings and that
44
44
  you have a README.md file in the project root. It will use those assets to
45
45
  generate the documentation and the necessary configurations to make it buildable
46
46
  with Sphinx and ready to be hosted to readthedocs.io.
47
47
 
48
- The first step is to install `doc0` as a development dependency in your project.
48
+ The first step is to install `doc-zero` as a development dependency in your project.
49
49
  You can do this by running
50
50
 
51
51
  ```bash
52
- $ pip install doc0
52
+ $ pip install doc-zero
53
53
  ```
54
54
 
55
55
  or the equivalent command for the package manager of choice.
@@ -58,10 +58,10 @@ or the equivalent command for the package manager of choice.
58
58
  Then, the following command generates the documentation:
59
59
 
60
60
  ```bash
61
- $ doc0 build
61
+ $ doc-zero build
62
62
  ```
63
63
 
64
- `doc0` always creates a module documentation for your toplevel module. It will
64
+ `doc-zero` always creates a module documentation for your toplevel module. It will
65
65
  also scan all sub-modules and generate a documentation page if they satisfy the
66
66
  following conditions:
67
67
 
@@ -69,5 +69,5 @@ following conditions:
69
69
  * The module has a docstring.
70
70
  * The module defines a `__all__` variable that lists its public API.
71
71
 
72
- `doc0` only includes the public API in the generated documentation.
72
+ `doc-zero` only includes the public API in the generated documentation.
73
73
 
@@ -128,7 +128,7 @@ class Doc0:
128
128
  # Write the requirements.txt file for Read the Docs, if it doesn't exist.
129
129
  req_path = self.root / "docs" / "requirements.txt"
130
130
  if not req_path.exists():
131
- req_path.write_text(f"doc0>={module_version('doc0')}")
131
+ req_path.write_text(f"doc-zero>={module_version('doc0')}")
132
132
 
133
133
  def build(self) -> None:
134
134
  """
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "doc-zero"
3
- version = "0.1.1"
3
+ version = "0.1.2"
4
4
  description = "Zero-configuration documentation generator for Python."
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.13"
@@ -33,9 +33,9 @@ name = "Fábio Macêdo Mendes"
33
33
  email = "fabiomacedomendes@gmail.com"
34
34
 
35
35
  [project.urls]
36
- Homepage = "http://github.com/fabiommendes/zero-doc"
37
- Repository = "http://github.com/fabiommendes/zero-doc"
38
- Documentation = "https://zero-doc.readthedocs.io/"
36
+ Homepage = "http://github.com/fabiommendes/doc0"
37
+ Repository = "http://github.com/fabiommendes/doc0"
38
+ Documentation = "https://doc-zero.readthedocs.io/"
39
39
 
40
40
  [project.scripts]
41
41
  doc0 = "doc0.cli:main"
@@ -73,11 +73,11 @@ release = '''
73
73
  '''
74
74
 
75
75
  [tool.taskipy.tasks.docs]
76
- cmd = "sphinx-build -b html docs/source docs/build -n"
76
+ cmd = "uv run doc-zero build"
77
77
  help = "Build HTML documentation"
78
78
 
79
79
  [tool.taskipy.tasks.docs-serve]
80
- cmd = "sphinx-autobuild docs/source docs/build -n"
80
+ cmd = "uv run doc-zero serve"
81
81
  help = "Serve HTML documentation with live reload"
82
82
 
83
83
  [tool.doc-zero]
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "doc-zero"
3
- version = "0.1.1"
3
+ version = "0.1.2"
4
4
  description = "Zero-configuration documentation generator for Python."
5
5
  readme = "README.md"
6
6
  authors = [
@@ -31,9 +31,9 @@ classifiers = [
31
31
  license = "MIT"
32
32
 
33
33
  [project.urls]
34
- Homepage = "http://github.com/fabiommendes/zero-doc"
35
- Repository = "http://github.com/fabiommendes/zero-doc"
36
- Documentation = "https://zero-doc.readthedocs.io/"
34
+ Homepage = "http://github.com/fabiommendes/doc0"
35
+ Repository = "http://github.com/fabiommendes/doc0"
36
+ Documentation = "https://doc-zero.readthedocs.io/"
37
37
 
38
38
  [project.scripts]
39
39
  doc0 = "doc0.cli:main"
@@ -61,8 +61,8 @@ source = ["doc0"]
61
61
  omit = ["doc0/__main__.py"]
62
62
 
63
63
  [tool.taskipy.tasks]
64
- docs = { cmd = "sphinx-build -b html docs/source docs/build -n", help = "Build HTML documentation" }
65
- docs-serve = { cmd = "sphinx-autobuild docs/source docs/build -n", help = "Serve HTML documentation with live reload" }
64
+ docs = { cmd = "uv run doc-zero build", help = "Build HTML documentation" }
65
+ docs-serve = { cmd = "uv run doc-zero serve", help = "Serve HTML documentation with live reload" }
66
66
  test = "pytest tests"
67
67
  coverage = "pytest tests --cov=doc0 --cov-report=term-missing"
68
68
  lint = "ruff check ."
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes