ethspecify 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

{ethspecify-0.1.0.dist-info → ethspecify-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: ethspecify
-Version: 0.1.0
+Version: 0.1.1
 Summary: A utility for processing Ethereum specification tags.
 Home-page: https://github.com/jtraglia/ethspecify
 Author: Justin Traglia
@@ -33,81 +33,44 @@ When that happens, they can update the implementations appropriately.
 
 ## Getting Started
 
-### Adding Spec Tags
-
-In your client, add an HTML tag like this:
-
-```
-/*
- * <spec fn="is_fully_withdrawable_validator" fork="deneb">
- */
-```
-
-This supports all languages and comment styles. It preserves indentation, so something like this
-would also work:
-
-```
-/// <spec fn="is_fully_withdrawable_validator" fork="deneb">
-```
-
-After the script is finished executing, a new `hash` field will exist in the tag. This tag is used
-to tell if the specification changed, without having to include the specification content.
-
-```
-/// <spec fn="is_fully_withdrawable_validator" fork="deneb" hash="e936da25" />
-```
-
-> [!NOTE]
-> Closing tags will be added automatically. For `style="hash"` tags, a self-closing tag is used for
-> conciseness. For `style="full"` and `style="diff"` tags, a paired closing tag must be used.
-
 ### Installation
 
-#### Install with Pip
-
 ```
 python3 -mpip install ethspecify
 ```
 
-#### Manual Install
+### Adding Spec Tags
 
-First, clone the repository. You only need the latest commit.
+In your client, add HTML tags like this:
 
 ```
-git clone https://github.com/jtraglia/ethspecify.git --depth=1
-cd ethspecify
+/*
+ * <spec fn="is_fully_withdrawable_validator" fork="deneb">
+ */
 ```
 
-Next, build and install the utility.
+### Populate Spec Tags
 
-```
-python3 -mpip install .
-```
-
-Then, change directory to the source source directory and run `ethspecify`.
+Then, navigate to your codebase and run `ethspecify`:
 
 ```
-Projects/client$ ethspecify
-Processing file: /Users/user/Projects/client/src/file.ext
-spec tag: {'custom_type': 'Blob', 'fork': 'electra'}
-spec tag: {'dataclass': 'PayloadAttributes', 'fork': 'electra'}
-spec tag: {'ssz_object': 'ConsolidationRequest', 'fork': 'electra'}
+ethspecify
 ```
 
-### Specification Options
+## Specification Options
 
-#### Fork
+### Fork
 
 This attribute can be any of the [executable
 specifications](https://github.com/ethereum/consensus-specs/blob/e6bddd966214a19d2b97199bbe3c02577a22a8b4/Makefile#L3-L15)
 in the consensus-specs. At the time of writing, these are: phase0, altair, bellatrix, capella,
 deneb, electra, fulu, whisk, eip6800, and eip7732.
 
-#### Style
+### Style
 
 This attribute can be used to change how the specification content is shown.
 
-##### `hash` (default)
+#### `hash` (default)
 
 This style adds a hash of the specification content to the spec tag, without showing the content.
 
@@ -120,7 +83,7 @@ This style adds a hash of the specification content to the spec tag, without sho
 > [!NOTE]
 > The hash is the first 8 characters of the specification content's SHA256 digest.
 
-##### `full`
+#### `full`
 
 This style displays the whole content of this specification item, including comments.
 
@@ -140,10 +103,7 @@ This style displays the whole content of this specification item, including comm
  */
 ```
 
-##### `link`
-
-> [!WARNING]
-> This feature is a work-in-progress.
+#### `link`
 
 This style displays a GitHub link to the specification item.
 
@@ -155,7 +115,7 @@ This style displays a GitHub link to the specification item.
  */
 ```
 
-##### `diff`
+#### `diff`
 
 This style displays a diff with the previous fork's version of the specification.
 
@@ -203,9 +163,9 @@ This can be used with any specification item, like functions too:
  */
 ```
 
-### Supported Specification Items
+## Supported Specification Items
 
-#### Constants
+### Constants
 
 These are items found in the `Constants` section of the specifications.
 
@@ -217,7 +177,7 @@ These are items found in the `Constants` section of the specifications.
  */
 ```
 
-#### Custom Types
+### Custom Types
 
 These are items found in the `Custom types` section of the specifications.
 
@@ -229,7 +189,7 @@ These are items found in the `Custom types` section of the specifications.
  */
 ```
 
-#### Preset Variables
+### Preset Variables
 
 These are items found in the
 [`presets`](https://github.com/ethereum/consensus-specs/tree/dev/presets) directory.
@@ -259,7 +219,7 @@ It's not strictly necessary to specify the preset attribute. The default preset
  */
 ```
 
-#### Config Variables
+### Config Variables
 
 These are items found in the
 [`configs`](https://github.com/ethereum/consensus-specs/tree/dev/presets) directory.
@@ -272,7 +232,7 @@ These are items found in the
  */
 ```
 
-#### SSZ Objects
+### SSZ Objects
 
 These are items found in the `Containers` section of the specifications.
 
@@ -287,7 +247,7 @@ These are items found in the `Containers` section of the specifications.
  */
 ```
 
-#### Dataclasses
+### Dataclasses
 
 These are classes with the `@dataclass` decorator.
 
@@ -304,7 +264,7 @@ These are classes with the `@dataclass` decorator.
  */
 ```
 
-#### Functions
+### Functions
 
 These are all the functions found in the specifications.
 

ethspecify-0.1.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+ethspecify/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ethspecify/cli.py,sha256=EFjH1ioHibDG1U-6XiozQ2aT2j-GyaWhUJJ-QMALrLc,925
+ethspecify/core.py,sha256=sxmTdXCQIpaAjebMG0NE-7mTf4m0NG_J9IjgGlmOTVk,12064
+ethspecify-0.1.1.dist-info/LICENSE,sha256=Awxsr73mm9YMBVhBYnzeI7bNdRd-bH6RDtO5ItG0DaM,1071
+ethspecify-0.1.1.dist-info/METADATA,sha256=WfBBcZ6NDCt_z0JKDGp66mFvGmjv7UiMB3fhmE_5XYA,8705
+ethspecify-0.1.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+ethspecify-0.1.1.dist-info/entry_points.txt,sha256=09viGkCg9J3h0c9BFRN-BKaJUEaIc4JyULNgBP5EL_g,51
+ethspecify-0.1.1.dist-info/top_level.txt,sha256=0klaMvlVyOkXW09fwZTijJpdybITEp2c9zQKV5v30VM,11
+ethspecify-0.1.1.dist-info/RECORD,,

ethspecify-0.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-ethspecify/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ethspecify/cli.py,sha256=EFjH1ioHibDG1U-6XiozQ2aT2j-GyaWhUJJ-QMALrLc,925
-ethspecify/core.py,sha256=sxmTdXCQIpaAjebMG0NE-7mTf4m0NG_J9IjgGlmOTVk,12064
-ethspecify-0.1.0.dist-info/LICENSE,sha256=Awxsr73mm9YMBVhBYnzeI7bNdRd-bH6RDtO5ItG0DaM,1071
-ethspecify-0.1.0.dist-info/METADATA,sha256=-ot8oXPC7HfNHVD6_ZCcwn7oZJ6EHN5bJeQL9ERByDg,9965
-ethspecify-0.1.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-ethspecify-0.1.0.dist-info/entry_points.txt,sha256=09viGkCg9J3h0c9BFRN-BKaJUEaIc4JyULNgBP5EL_g,51
-ethspecify-0.1.0.dist-info/top_level.txt,sha256=0klaMvlVyOkXW09fwZTijJpdybITEp2c9zQKV5v30VM,11
-ethspecify-0.1.0.dist-info/RECORD,,