issuer 0.1.0

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.
Files changed (55) hide show
  1. checksums.yaml +7 -0
  2. data/.rspec +3 -0
  3. data/.vale/config/vocabularies/issuer/accept.txt +63 -0
  4. data/.vale/config/vocabularies/issuer/reject.txt +21 -0
  5. data/.vale.ini +42 -0
  6. data/Dockerfile +43 -0
  7. data/LICENSE +21 -0
  8. data/README.adoc +539 -0
  9. data/Rakefile +70 -0
  10. data/bin/console +0 -0
  11. data/bin/issuer +13 -0
  12. data/bin/setup +0 -0
  13. data/examples/README.adoc +56 -0
  14. data/examples/advanced-stub-example.yml +50 -0
  15. data/examples/basic-example.yml +33 -0
  16. data/examples/minimal-example.yml +9 -0
  17. data/examples/new-project-issues.yml +162 -0
  18. data/examples/validation-test.yml +8 -0
  19. data/exe/issuer +5 -0
  20. data/issuer.gemspec +43 -0
  21. data/lib/issuer/apis/github/client.rb +124 -0
  22. data/lib/issuer/cache.rb +197 -0
  23. data/lib/issuer/cli.rb +241 -0
  24. data/lib/issuer/issue.rb +393 -0
  25. data/lib/issuer/ops.rb +281 -0
  26. data/lib/issuer/sites/base.rb +109 -0
  27. data/lib/issuer/sites/factory.rb +31 -0
  28. data/lib/issuer/sites/github.rb +248 -0
  29. data/lib/issuer/version.rb +21 -0
  30. data/lib/issuer.rb +238 -0
  31. data/scripts/build.sh +40 -0
  32. data/scripts/lint-docs.sh +64 -0
  33. data/scripts/manage-runs.rb +175 -0
  34. data/scripts/pre-commit-template.sh +54 -0
  35. data/scripts/publish.sh +92 -0
  36. data/scripts/setup-vale.sh +59 -0
  37. data/specs/tests/README.adoc +451 -0
  38. data/specs/tests/check-github-connectivity.sh +130 -0
  39. data/specs/tests/cleanup-github-tests.sh +374 -0
  40. data/specs/tests/github-api/01-auth-connection.yml +21 -0
  41. data/specs/tests/github-api/02-basic-issues.yml +90 -0
  42. data/specs/tests/github-api/03-milestone-tests.yml +58 -0
  43. data/specs/tests/github-api/04-label-tests.yml +98 -0
  44. data/specs/tests/github-api/05-assignment-tests.yml +55 -0
  45. data/specs/tests/github-api/06-automation-tests.yml +102 -0
  46. data/specs/tests/github-api/07-error-tests.yml +29 -0
  47. data/specs/tests/github-api/08-complex-tests.yml +197 -0
  48. data/specs/tests/github-api/config.yml.example +17 -0
  49. data/specs/tests/rspec/cli_spec.rb +127 -0
  50. data/specs/tests/rspec/issue_spec.rb +184 -0
  51. data/specs/tests/rspec/issuer_spec.rb +5 -0
  52. data/specs/tests/rspec/ops_spec.rb +124 -0
  53. data/specs/tests/rspec/spec_helper.rb +54 -0
  54. data/specs/tests/run-github-api-tests.sh +424 -0
  55. metadata +200 -0
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: b9bb7bb2f93928b8bd959ce8e27f2989748f99be01e1ca3b9b95ca8a9bd6beb1
4
+ data.tar.gz: b64d1378586049efc2649da8babd304677c60d7db392a2dcf9988881a2ff5572
5
+ SHA512:
6
+ metadata.gz: 4cdf05b9e8493b342cf80ff6d1919f50e1b5b6e62c7d704a7f7c2648320c53a2cc4a9918506d3d25557e337d5bbd623245e610ced06337ea3d7770d9936fe153
7
+ data.tar.gz: 198a9cf0ca4a0ad8ee13a084bae3a755ede3ebfbda9a7723f67d6552fa0dff05820cbc6a62c64934b820134aa6f93acfb112339245974815b3fdebd62f1633f7
data/.rspec ADDED
@@ -0,0 +1,3 @@
1
+ --format documentation
2
+ --color
3
+ --pattern 'specs/tests/rspec/**/*_spec.rb'
@@ -0,0 +1,63 @@
1
+ # Project-specific vocabulary for issuer
2
+ # These terms are accepted and won't be flagged by spell checkers
3
+
4
+ # Project name and variations
5
+ issuer
6
+ Issuer
7
+ IMYML
8
+ imyml
9
+
10
+ # Technical terms
11
+ GitHub
12
+ GitLab
13
+ Octokit
14
+ AsciiDoc
15
+ asciidoc
16
+ YAML
17
+ JSON
18
+ APIs
19
+ API
20
+ CLI
21
+ summ
22
+ vrsn
23
+ proj
24
+ metadata
25
+ milestones
26
+ assignee
27
+ repos
28
+ repo
29
+
30
+ # Common tech abbreviations
31
+ dev
32
+ config
33
+ async
34
+ auth
35
+ env
36
+ vars
37
+ bool
38
+ bool
39
+ bool
40
+ timestamp
41
+ username
42
+ workflow
43
+ workflows
44
+
45
+ # Ruby/gem specific
46
+ Gemfile
47
+ gemspec
48
+ rspec
49
+ RSpec
50
+ bundler
51
+ Bundler
52
+
53
+ # Docker terms
54
+ dockerfile
55
+ Dockerfile
56
+ DocOps
57
+ docopslab
58
+
59
+ # Proper nouns
60
+ JIRA
61
+ OAuth
62
+ README
63
+ roadmap
@@ -0,0 +1,21 @@
1
+ # Terms to reject/flag in the issuer project
2
+ # These will always be flagged as errors
3
+
4
+ # Common misspellings in tech docs
5
+ seperately
6
+ seperate
7
+ recieve
8
+ definately
9
+ occured
10
+ teh
11
+ hte
12
+ thier
13
+ there own
14
+ there job
15
+
16
+ # Discouraged terms
17
+ simply
18
+ just
19
+ obviously
20
+ clearly
21
+ easily
data/.vale.ini ADDED
@@ -0,0 +1,42 @@
1
+ # Vale configuration for issuer project
2
+ StylesPath = .vale/styles
3
+
4
+ # Minimum alert level (suggestion, warning, error)
5
+ MinAlertLevel = suggestion
6
+
7
+ # Packages to install
8
+ Packages = Microsoft, proselint, write-good
9
+
10
+ # Global settings
11
+ IgnoredScopes = code, tt, script.go, script.python
12
+ SkippedScopes = script, style, pre, figure
13
+ WordTemplate = \b(?:%s)\b
14
+
15
+ # File type associations - All documentation files
16
+ [*.{md,adoc,asciidoc,txt}]
17
+ BasedOnStyles = Microsoft, proselint, write-good
18
+ # Disable rules per user preferences
19
+ Microsoft.Headings = NO
20
+ Microsoft.Contractions = NO
21
+ Microsoft.FirstPerson = NO
22
+ Microsoft.Acronyms = NO
23
+ Microsoft.Auto = NO
24
+ Microsoft.Vocab = NO
25
+ Microsoft.We = NO
26
+ Microsoft.Dashes = NO
27
+ write-good.E-Prime = NO
28
+ write-good.Passive = NO
29
+ write-good.TooWordy = NO
30
+ write-good.Weasel = NO
31
+ # Global ignores for all markup files
32
+ TokenIgnores = (\$[A-Z_]+), (`[^`]+`), (:[a-z-]+:), (\{[^}]+\}), (https?://[^\s]+), \bJIRA\b
33
+
34
+ # Ruby files for comments
35
+ [*.rb]
36
+ BasedOnStyles = Microsoft, write-good
37
+ TokenIgnores = (`[^`]+`), (\$[A-Z_]+), (:[a-z_]+), \bJIRA\b
38
+
39
+ # YAML files
40
+ [*.{yml,yaml}]
41
+ BasedOnStyles = Microsoft, write-good
42
+ TokenIgnores = (`[^`]+`), (\$[A-Z_]+), (:[a-z_]+:), \bJIRA\b
data/Dockerfile ADDED
@@ -0,0 +1,43 @@
1
+ FROM ruby:3.2-slim
2
+
3
+ ARG ISSUER_VERSION
4
+ ARG ISSUER_SOURCE=repo
5
+ LABEL org.opencontainers.image.version=$ISSUER_VERSION
6
+
7
+ # Install necessary build tools and dependencies (minimal footprint)
8
+ RUN apt-get update -qq && \
9
+ apt-get upgrade -y && \
10
+ apt-get install -y --no-install-recommends \
11
+ build-essential \
12
+ git && \
13
+ rm -rf /var/lib/apt/lists/*
14
+
15
+ # Install issuer gem based on ISSUER_SOURCE
16
+ RUN if [ "$ISSUER_SOURCE" = "published" ]; then \
17
+ echo "Installing issuer from RubyGems..." && \
18
+ gem install issuer; \
19
+ else \
20
+ echo "Will install issuer from repository source..."; \
21
+ fi
22
+
23
+ # Set app directory for build context (only needed for repo builds)
24
+ WORKDIR /app
25
+
26
+ # Copy repository source and build gem (only when ISSUER_SOURCE=repo)
27
+ COPY . .
28
+ RUN if [ "$ISSUER_SOURCE" = "repo" ]; then \
29
+ gem install rake && \
30
+ gem build issuer.gemspec && \
31
+ gem install issuer-*.gem && \
32
+ rm -rf /app/*; \
33
+ fi
34
+
35
+ # Ensure gem executables are in PATH
36
+ ENV PATH="/usr/local/bundle/bin:$PATH"
37
+
38
+ # Set runtime working dir to isolated mount point
39
+ WORKDIR /workdir
40
+
41
+ # Default entrypoint and fallback command
42
+ ENTRYPOINT ["issuer"]
43
+ CMD ["help"]
data/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 DocOps Lab
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.