linear-cli 0.7.4 → 0.7.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80e40a55128542927047fc4469b07ca4d62e21dfa4340c842c07dfc50c9d4338
-  data.tar.gz: 36d3481ef7b65a2bdffeb46b99d9e98ee52c47e9ad97a41fa0716219a5f0038b
+  metadata.gz: ed24311870484d37b861be6bfe48af2edfc58b2c248764dd31f3f82a4ba282a5
+  data.tar.gz: c0404fc83e9157c97b75c1afa3fe0766a1d10838ea33e9284d380de6dde1d547
 SHA512:
-  metadata.gz: 86c6fc9b11f43136c03978add50a793d7cf615bd44eb908b71fddb8d7535d97cc4feb0cf59801b3b5803d127d8452e055bd0fbe819b115ea55658c9e5bed2008
-  data.tar.gz: 9aab63258d4d6242a38f911c12a09a6394fdd37065ba018b2ba4c5e139d25a27e4c6f1b73cea8b977d3c3eb40fd8ba45ca323d63d3e90a2774eed90e2ddc5757
+  metadata.gz: 529c58e8cfa1a550e23de0ea5f3c9bb43d559f34b8c6648aa80bdc0238ee63be00282bf6166da82bf4c5be909dd5a8212e74cd74b92e42a6d1e58bc0de98e0f8
+  data.tar.gz: ee09439dfb8d39fbec79ec0206822a9261b340b4e9c0bc15cfb529dcc68a0e3138810833250972cbbd4a30bee1149f5e280b544193dfc414cb825aefe1c20218

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+## [0.7.5] - 2024-02-05
+### Fixed
+- Fixed problem when choosing from multiple completed states (@bougyman)
+
 ## [0.7.3] - 2024-02-04
 ### Fixed
 - Fixed problem with issue relationship to user (@bougyman)
@@ -41,8 +45,9 @@
 ### Added
 - Added new changelog management system (changelog-rb) (@bougyman)
 
-[Unreleased]: https://github.com/rubyists/linear-cli/compare/0.7.3...HEAD
-[0.7.3]: https://github.com/rubyists/linear-cli/compare/v0.7.2...0.7.3
+[Unreleased]: https://github.com/rubyists/linear-cli/compare/0.7.5...HEAD
+[0.7.5]: https://github.com/rubyists/linear-cli/compare/v0.7.3...0.7.5
+[0.7.3]: https://github.com/rubyists/linear-cli/compare/v0.7.2...v0.7.3
 [0.7.2]: https://github.com/rubyists/linear-cli/compare/v0.7.1...v0.7.2
 [0.7.1]: https://github.com/rubyists/linear-cli/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/rubyists/linear-cli/compare/v0.6.1...v0.7.0

data/Readme.adoc

@@ -3,6 +3,8 @@
 :toclevels: 3
 :sectanchors:
 :icons: font
+:tip-caption: 💡
+:note-caption: 📝
 :experimental:
 
 A command line interface to https://linear.app.
@@ -59,7 +61,7 @@ You can get help/usage for any command or subcommand by using the `--help` flag.
 
 [source,sh]
 ----
-$ lc
+$ lc --help
 $ lc [COMMAND] --help
 $ lc [COMMAND] [SUBCOMMAND] --help
 ----
@@ -78,6 +80,8 @@ $ lc w --teams
 
 `lcls` is a helper provided to list issues. It's an alias for `lc issues list`.
 
+image::listings.cinema.gif[]
+
 [source,sh]
 ----
 $ lcls
@@ -102,7 +106,7 @@ $ lc issue take CRY-456 CRY-789
 [source,sh]
 ----
 $ lc i c --title "My new issue" --description "This is a new issue" --labels Bug,Feature --team CRY
-$ lc i c -t "My new issue" -T CRY -l Improvment,Feature
+$ lc i c -t "My new issue" -T CRY -l Improvement,Feature
 ----
 
 NOTE: If you don't provide a title, team, labels or description, you will be prompted to enter them.
@@ -118,7 +122,7 @@ This will switch to the branch for the issue, creating the branch if it doesn't
 $ lc i dev CRY-1234
 ----
 
-TIP: You may pass the --dev option to the create subcommand to immediately develop the creted issue.
+TIP: You may pass the --dev option to the create subcommand to immediately develop the created issue.
 
 ==== Update an issue
 
@@ -147,5 +151,5 @@ Some command aliases are available to make things easier to type.
 ----
 $ lcls
 $ lcreate --description "This is a new issue" --labels Bug,Feature --team CRY
-$ lclose --reason "This issues suck" CRY-1234 CRY-456
+$ lclose --reason "This issue sucks" CRY-1234 CRY-456
 ----

data/changelog/0.7.5/fixed_problem_when_choosing_from_multiple_completed_states.yml

@@ -0,0 +1,4 @@
+type: Fixed
+title: >
+  Fixed problem when choosing from multiple completed states
+author: bougyman

data/changelog/0.7.5/tag.yml

@@ -0,0 +1 @@
+date: 2024-02-05

data/cinemas/listings.cinema

@@ -0,0 +1,38 @@
+{"version": 2, "width": 160, "height": 46, "timestamp": 1707107455, "env": {"SHELL": "/bin/zsh", "TERM": "screen-256color"}}
+[0.08698, "o", "FOUND RBENV HOME\r\n"]
+[0.127279, "o", "\u001b[1m\u001b[3m%\u001b[23m\u001b[1m\u001b[0m                                                                                                                                                               \r \r"]
+[0.140171, "o", "\u001b[mdirenv: loading ~/rubyists/linear-cli/.envrc\r\n"]
+[0.147537, "o", "\u001b[mdirenv: loading ~/.envrc\r\n"]
+[0.189085, "o", "gpg: WARNING: server 'gpg-agent' is older than us (2.2.27 < 2.4.4)\r\n"]
+[0.189626, "o", "gpg: problem with fast path key listing: IPC parameter error - ignored\r\n"]
+[0.361065, "o", "direnv: export +EDITOR +GOPATH +INPUTRC +LINEAR_API_KEY +MAILNAME +PRIZE_LINK_DIRS +PRIZE_SLACK_TOKEN +RUBY_CONFIGURE_OPTS +SVDIR +YAMLFIX_SEQUENCE_STYLE ~PATH\r\n"]
+[0.442465, "o", "\r\u001b[0m\u001b[23m\u001b[24m\u001b[J\u001b[48;5;232mbougyman@camazotz\u001b[49m \u001b[1m\u001b[38;5;208m~/rubyists/linear-cli\r\n\r\u001b[37m % \u001b[0m\u001b[37m\u001b[39m\u001b[49m\u001b[K\u001b[115C\u001b[35m(\u001b[39mgit\u001b[35m)\u001b[33m-\u001b[35m[\u001b[32mmain\u001b[35m]\u001b[39m  <\u001b[35mmicrok8s\u001b[39m:\u001b[34mdefault\u001b[39m> \u001b[33m22:30:55\u001b[39m\u001b[156D"]
+[0.442549, "o", "\u001b[?1h\u001b=\u001b[?2004h"]
+[0.952794, "o", "\u001b[32mexit\u001b[39m"]
+[1.13176, "o", "\b\b\b\b\u001b[32ml\u001b[39m\u001b[39m \u001b[39m \u001b[39m \b\b\b"]
+[1.593229, "o", "\b\u001b[32ms\u001b[32meq\u001b[39m 1 9 | \u001b[33mwhile\u001b[39m \u001b[32mread\u001b[39m  num; \u001b[33mdo\u001b[39m \u001b[32mlc\u001b[39m i ls \u001b[33m\"CRY-\u001b[36m$num\u001b[39m\u001b[33m\"\u001b[39m -f; \u001b[32msleep\u001b[39m 2; \u001b[33mdone\u001b[39m"]
+[4.51933, "o", "\u001b[?1l\u001b>"]
+[4.524811, "o", "\u001b[?2004l\u001b[K\r\r\n"]
+[5.666735, "o", "CRY-1        Welcome to Linear 👋 (bougyman@hey.com)\r\n---------------------------------------------------\r\nHi there. Complete these issues to learn how to use Linear and discover ✨\u001b[33;1mProTips.\u001b[0m When you’re done, delete them or move them to another team for others to view.\r\n\r\n    \u001b[36;1m\u001b[33;1mTo start, type\u001b[0m \u001b[38;5;230mC\u001b[39m to \u001b[33;1mcreate your first issue.\u001b[0m\u001b[0m\r\n\r\n    Create issues from any view using \u001b[38;5;230mC\u001b[39m or by clicking the \u001b[38;5;230mNew issue\u001b[39m button.\r\n\r\n    1189b618-97f2-4e2c-ae25-4f25467679e7 » \u001b[33;4mhttps://uploads.linear.app/fe63b3e2-bf87-46c0-8784-cd7d639287c8/532d146d-bcd6-4602-bf1f-83f674b70fff/1189b618-97f2-4e2c-ae25-4f25467679e7\u001b[0m\r\n\r\n    Our issue editor and comments support Markdown. You can also:\r\n\r\n    \u001b[33m●\u001b[0m @mention a teammate\r\n    \u001b[33m●\u001b[0m Drag & drop images or video (Loom & Youtube embed automatically)\r\n    \u001b[33m●\u001b[0m Use emoji ✅\r\n\r\n\r\n"]
+[9.013736, "o", "CRY-2        Try 3 ways to navigate Linear: Command line, keyboard or mouse (bougyman@hey.com)\r\n----------------------------------------------------------------------------------------------\r\n\u001b[38;5;230mCmd/Ctrl\u001b[39m \u001b[38;5;230mK\u001b[39m \u001b[33;1mis our most powerful feature.\u001b[0m\r\n\r\nUse it to search for or take any action in the app.\r\n\r\ncf798178-b3bc-4ae1-b24f-577d4871ae5d » \u001b[33;4mhttps://uploads.linear.app/fe63b3e2-bf87-46c0-8784-cd7d639287c8/f477604b-f0d2-4ade-8a7a-571830a3b5de/cf798178-b3bc-4ae1-b24f-577d4871ae5d\u001b[0m\r\n\r\nIf you prefer to use a mouse, right click over any issue for \u001b[33;1mcontextual menus\u001b[0m. They’re a great way to learn the keyboard shortcuts, too.\r\n\r\n\u001b[90m(CleanShot 2023-07-10 at 16.03.57.png - https://uploads.linear.app/fe63b3e2-bf87-46c0-8784-cd7d639287c8/11668d24-67e7-431d-9c7d-4bb5f409cae8/650d277b-cc1e-498b-aabd-8d04e8f57680)\u001b[0m\r\n\r\nIf you prefer \u001b[33;1mkeyboard shortcuts\u001b[0m, type \u001b[38;5;230m?\u001b[39m to view our full list.\r\n\r\n\r\n"]
+[15.404919, "o", "CRY-3        Connect to Slack (bougyman@hey.com)\r\n------------------------------------------------\r\nIf your team uses Slack, enable this integration to keep your workflow and communication in sync.\r\n\r\n\u001b[33m●\u001b[0m See issue updates in a dedicated channel.\r\n\u001b[33m●\u001b[0m Use the \u001b[38;5;230m/linear\u001b[39m command to create new issues from Slack messages.\r\n\u001b[33m●\u001b[0m Sync comments between Slack and Linear.\r\n\u001b[33m●\u001b[0m Set up personal Slack notifications.\r\n\u001b[33m●\u001b[0m Import custom emoji 🥳 to your Linear workspace.\r\n\r\nConnect Slack → » \u001b[33;4mhttps://linear.app/settings/integrations/slack\u001b[0m\r\n\r\n\r\n"]
+[19.624854, "o", "CRY-4        Connect GitHub or GitLab (bougyman@hey.com)\r\n--------------------------------------------------------\r\nConnect your account to link issues to pull/merge requests and automate your workflow:\r\n\r\n\u001b[33m●\u001b[0m Link Linear issues to pull requests.\r\n\u001b[33m●\u001b[0m Automatically update an issue’s status when PRs are created or merged.\r\n\u001b[33m●\u001b[0m Connect one or multiple repos.\r\n\r\nConnect GitHub or GitLab → » \u001b[33;4mhttps://linear.app/settings/integrations/github\u001b[0m\r\n\r\n  \u001b[36;1mSetup tips\u001b[0m\r\n\r\n      \u001b[36;1mHow to link a Linear issue to a PR\u001b[0m\r\n\r\n      \u001b[33m●\u001b[0m \u001b[33;1mBranch name\u001b[0m (e.g. “LIN-123” or “username/LIN-123”). To quickly copy branch name for an issue to your clipboard, press \u001b[38;5;230mCmd/Ctrl\u001b[39m \u001b[38;5;230mShift\u001b[39m \u001b[38;5;230m.\u001b[39m\r\n      \u001b[33m●\u001b[0m \u001b[33;1mPull request title\u001b[0m (e.g. “GitHub Workflow LIN-123”)\r\n      \u001b[33m●\u001b[0m \u001b[33;1mPull request description\u001b[0m (e.g. \u001b[33mFixes LIN-123, Resolves LIN-123\u001b[0m) – it will not work if entered in commits o"]
+[19.624988, "o", "r comments.\r\n\r\n      \u001b[36;1mWhen you link a Linear issue to a PR, Linear will:\u001b[0m\r\n\r\n      \u001b[33m●\u001b[0m Create a link to the PR in the Linear issue.\r\n      \u001b[33m●\u001b[0m Comment on the PR with a link back to the Linear issue.\r\n      \u001b[33m●\u001b[0m Once PR has been opened, Linear will change the status of the issue to “In Progress”.\r\n      \u001b[33m●\u001b[0m Once PR has been merged, Linear will change the status of the issue as “Done”.\r\n\r\n      \u001b[36;1mSuggested Workflow\u001b[0m\r\n\r\n      \u001b[33m1.\u001b[0m Select or create the issue you want to work on next.\r\n      \u001b[33m2.\u001b[0m Open the command menu (\u001b[38;5;230mCmd\u001b[39m \u001b[38;5;230mK\u001b[39m on Mac, or \u001b[38;5;230mCtrl\u001b[39m \u001b[38;5;230mK\u001b[39m on Windows) and select \u001b[33;1mCopy git branch name,\u001b[0m or use the shortcut \u001b[38;5;230mCmd/Ctrl\u001b[39m \u001b[38;5;230mShift\u001b[39m \u001b[38;5;230m.\u001b[39m\r\n      \u001b[33m3.\u001b[0m This will copy the git branch name to your clipboard (e.g. \u001b[38;5;230musername/LIN-123-github-workflow\u001b[39m\r\n      \u001b[33m4.\u001b[0m Paste the branch name to your git checkout command to c"]
+[19.625036, "o", "reate a new branch: \u001b[38;5;230mgit checkout -b username/LIN-123-github-workflow\u001b[39m\r\n      \u001b[33m5.\u001b[0m Make your changes and push the branch to GitHub and open a pull request\r\n      \u001b[33m6.\u001b[0m Once the pull request is open, Linear will comment on the PR and change the issue state to \u001b[33;1mIn Progress\u001b[0m\u001b[33m.\u001b[0m\r\n      \u001b[33m7.\u001b[0m Once the PR merged, Linear will change the status to Done.\r\n\r\n      Read full integration instructions for GitHub » \u001b[33;4mhttps://linear.app/docs/github\u001b[0m and GitLab → » \u001b[33;4mhttps://linear.app/docs/gitlab\u001b[0m\r\n\r\n\r\n"]
+[22.710372, "o", "CRY-5        Customize settings (bougyman@hey.com)\r\n--------------------------------------------------\r\nGo to settings » \u001b[33;4mhttps://linear.app/settings\u001b[0m to enable features such as Roadmap, explore features and add integrations. Use \u001b[38;5;230mG\u001b[39m then \u001b[38;5;230mS\u001b[39m to get there.\r\n\r\n\u001b[90m(image.png - https://uploads.linear.app/fe63b3e2-bf87-46c0-8784-cd7d639287c8/558fcd30-245d-4ddf-b15b-d9f18b1f4626/image.png)\u001b[0m\r\n\r\nVisit individual team settings » \u001b[33;4mhttps://linear.app/settings/teams/\u001b[0m to customize features on a team level.\r\n\r\n\u001b[33m●\u001b[0m Configure automated issue workflows for issues linked to PRs\r\n\u001b[33m●\u001b[0m Add or edit \u001b[33mworkflow statuses\u001b[0m, and \u001b[33mlabels\u001b[0m\r\n\u001b[33m●\u001b[0m Add team Slack notifications\r\n\u001b[33m●\u001b[0m Create reusable \u001b[33mtemplates\u001b[0m. Use the keyboard shortcut \u001b[38;5;230mAlt\u001b[39m \u001b[38;5;230mC\u001b[39m to quickly create new issues from templates\r\n\u001b[33m●\u001b[0m Set your \u001b[33mestimate\u001b[0m scale and enable \u001b[33mcycles\u001b[0m\r\n\u001b[33m●\u001b[0m Configure time-saving feature"]
+[22.710471, "o", "s such as \u001b[33mAuto-close\u001b[0m and \u001b[33mAuto-archive\u001b[0m\r\n\r\n\u001b[90m(image.png - https://uploads.linear.app/fe63b3e2-bf87-46c0-8784-cd7d639287c8/9fc1632b-893e-422c-939f-0cdc9d009b37/image.png)\u001b[0m\r\n\r\n\r\n"]
+[25.812849, "o", "CRY-6        Use Cycles to focus work over n–weeks\r\n--------------------------------------------------\r\nCycles are a practice to keep up your team’s momentum. They’re similar to agile flavored sprints but help focus your work without tying it to a release date or feature.\r\n\r\n\u001b[33m●\u001b[0m Customize cycles to last between 1-8 weeks.\r\n\u001b[33m●\u001b[0m Add issues manually or automatically move issues marked \u001b[33mTodo\u001b[0m to your current cycle.\r\n\u001b[33m●\u001b[0m Follow progress over time with cycle graphs.\r\n\u001b[33m●\u001b[0m Any uncompleted issues roll to the next cycle automatically.\r\n\r\n\u001b[90m(CleanShot 2023-07-10 at 16.22.23.png - https://uploads.linear.app/fe63b3e2-bf87-46c0-8784-cd7d639287c8/29272f4b-ee87-487f-9191-2f4f2fcc14a7/ad0f609e-d9d4-45f0-870c-a0b1c1f305ab)\u001b[0m\r\n\r\n\u001b[33m┃\u001b[0m  \u001b[33m✨\u001b[33;1mProTip:\u001b[0m\u001b[33m Quickly run meetings with the cycles sidebar. Filter issues by assignee and then ask each member to share updates and blockers. At Linear, we run 2-week \u001b[0m\r\n\u001b[33m┃\u001b[0m  \u001b[33mcycles and follow this "]
+[25.812884, "o", "format at the beginning of each cycle.\u001b[0m\r\n\r\nRead more about cycles in the Linear Guide → » \u001b[33;4mhttps://linear.app/docs/use-cycles\u001b[0m\r\n\r\n\r\n"]
+[29.41905, "o", "CRY-7        Use Projects to organize work for features or releases (bougyman@hey.com)\r\n--------------------------------------------------------------------------------------\r\nProjects are meant for larger initiatives you have on your roadmap.\r\n\r\n\u001b[33m●\u001b[0m Share projects with multiple teams.\r\n\u001b[33m●\u001b[0m Set a target date.\r\n\u001b[33m●\u001b[0m View progress and estimate completion timeframe with graphs.\r\n\r\n\u001b[90m(header-projects.png - https://uploads.linear.app/fe63b3e2-bf87-46c0-8784-cd7d639287c8/3e49c9a1-8794-4740-80d9-4991c6021016/cded48fc-554a-472d-a27b-90df57550087)\u001b[0m\r\n\r\nLearn more about Projects in the Linear Guide → » \u001b[33;4mhttps://linear.app/docs/projects\u001b[0m\r\n\r\n\r\n"]
+[38.231422, "o", "CRY-8        Invite your teammates (bougyman@hey.com)\r\n-----------------------------------------------------\r\nInvite others to your workspace in settings » \u001b[33;4mhttp://linear.app/settings/members\u001b[0m.\r\n\r\n\r\n"]
+[41.297769, "o", "CRY-9        Next steps (bougyman@hey.com)\r\n------------------------------------------\r\nYou’re all set to use Linear.\r\n\r\n\u001b[33;1mWant to learn more?\u001b[0m\r\n\r\n\u001b[33m●\u001b[0m Check out our docs » \u001b[33;4mhttps://linear.app/docs\u001b[0m to dive into specific features\r\n\u001b[33m●\u001b[0m Learn about new features in weekly changelogs » \u001b[33;4mhttps://linear.app/changelog\u001b[0m\r\n\u001b[33m●\u001b[0m Read the Linear Method » \u001b[33;4mhttps://linear.app/linear-method\u001b[0m, our approach to software building\r\n\u001b[33m●\u001b[0m Join our Linear Customer Slack at this link » \u001b[33;4mhttp://linear.app/join-slack\u001b[0m\r\n\r\n\u001b[33;1mProTip: How to trial Linear on your team\u001b[0m\r\n\r\n\u001b[33m●\u001b[0m Use our in-app importer » \u001b[33;4mhttps://linear.app/settings/import-export\u001b[0m to add issues from Jira, Asana, Shortcut or GitHub\r\n\u001b[33m●\u001b[0m Trial it on your team. Pick a project or sprint, invite a few coworkers, add key integrations like Slack and GitHub to experience the full workflow.\r\n\r\n  \u001b[36;1mHave a question?\u001b[0m\r\n\r\n  Reach out to us via the Help & Support l"]
+[41.297901, "o", "ink in the sidebar.\r\n\r\n\r\n"]
+[43.304868, "o", "\u001b[1m\u001b[3m%\u001b[23m\u001b[1m\u001b[0m                                                                                                                                                               \r \r"]
+[43.383925, "o", "\r\u001b[0m\u001b[23m\u001b[24m\u001b[J\u001b[48;5;232mbougyman@camazotz\u001b[49m \u001b[1m\u001b[38;5;208m~/rubyists/linear-cli\r\n\r\u001b[37m % \u001b[0m\u001b[37m\u001b[39m\u001b[49m\u001b[K\u001b[115C\u001b[35m(\u001b[39mgit\u001b[35m)\u001b[33m-\u001b[35m[\u001b[32mmain\u001b[35m]\u001b[39m  <\u001b[35mmicrok8s\u001b[39m:\u001b[34mdefault\u001b[39m> \u001b[33m22:31:38\u001b[39m\u001b[156D"]
+[43.383956, "o", "\u001b[?1h\u001b=\u001b[?2004h"]
+[61.66531, "o", "\u001b[4me\u001b[24m"]
+[61.848614, "o", "\b\u001b[24m\u001b[32me\u001b[32mx\u001b[39m"]
+[62.043272, "o", "\b\b\u001b[1m\u001b[31me\u001b[1m\u001b[31mx\u001b[1m\u001b[31mi\u001b[0m\u001b[39m"]
+[62.130462, "o", "\b\b\b\u001b[0m\u001b[32me\u001b[0m\u001b[32mx\u001b[0m\u001b[32mi\u001b[32mt\u001b[39m"]
+[62.529001, "o", "\u001b[?1l\u001b>"]
+[62.529665, "o", "\u001b[?2004l\u001b[K\r\r\n"]

data/exe/linear-cli

@@ -3,4 +3,11 @@
 
 require 'linear'
 Rubyists::Linear::L :cli
-Dry::CLI.new(Rubyists::Linear::CLI).call
+begin
+  Dir.mktmpdir(Process.pid.to_s) do |dir|
+    Rubyists::Linear.tmpdir = dir
+    Dry::CLI.new(Rubyists::Linear::CLI).call
+  end
+ensure
+  FileUtils.rm_rf(Rubyists::Linear.tmpdir) if Rubyists::Linear.tmpdir.exist?
+end

data/lib/linear/cli/sub_commands.rb

@@ -54,11 +54,20 @@ module Rubyists
           prompt.ask(question)
         end
 
+        def cancelled_state_for(thingy)
+          states = thingy.cancelled_states
+          return states.first if states.size == 1
+
+          selection = prompt.select('Choose a cancelled state', states.to_h { |s| [s.name, s.id] })
+          Rubyists::Linear::WorkflowState.find selection
+        end
+
         def completed_state_for(thingy)
           states = thingy.completed_states
           return states.first if states.size == 1
 
-          prompt.select('Choose a completed state', states.to_h { |s| [s.name, s.id] })
+          selection = prompt.select('Choose a completed state', states.to_h { |s| [s.name, s.id] })
+          Rubyists::Linear::WorkflowState.find selection
         end
 
         def description_for(description = nil)

data/lib/linear/cli/version.rb

@@ -2,6 +2,6 @@
 
 module Rubyists
   module Linear
-    VERSION = '0.7.4'
+    VERSION = '0.7.6'
   end
 end

data/lib/linear/commands/issue/create.rb

@@ -27,7 +27,7 @@ module Rubyists
             logger.debug('Creating issue', options:)
             issue = make_da_issue!(**options)
             logger.debug('Issue created', issue:)
-            prompt.yes?('Do you want to take this issue?') && gimme_da_issue!(issue.id, User.me)
+            prompt.yes?('Do you want to take this issue?') && gimme_da_issue!(issue.id, me: User.me)
             display issue, options
             Rubyists::Linear::CLI::Issue::Develop.new.call(issue_id: issue.id, **options) if options[:develop]
           end

data/lib/linear/commands/issue/update.rb

@@ -18,18 +18,32 @@ module Rubyists
           include Rubyists::Linear::CLI::CommonOptions
           include Rubyists::Linear::CLI::Issue # for #gimme_da_issue! and other Issue methods
           desc 'Update an issue'
-          argument :issue_ids, type: :array, required: true, desc: 'Issue IDs (i.e. ISS-1)'
+          argument :issue_ids, type: :array, required: true, desc: 'Issue IDs (i.e. CRY-1)'
           option :comment, type: :string, aliases: ['-m'], desc: 'Comment to add to the issue'
           option :pr, type: :boolean, aliases: ['--pull-request'], default: false, desc: 'Create a pull request'
+          option :cancel, type: :boolean, default: false, desc: 'Cancel the issue'
           option :close, type: :boolean, default: false, desc: 'Close the issue'
           option :reason, type: :string, aliases: ['--butwhy'], desc: 'Reason for closing the issue'
+          option :trash,
+                 type: :boolean,
+                 default: false,
+                 desc: 'Also trash the issue (--close and --cancel support this option)'
+
+          example [
+            '--comment "This is a comment" CRY-1 CRY2    # Add a comment to multiple issues',
+            '--pr CRY-10                                 # Create a pull request for the issue',
+            '--close CRY-2                               # Close an issue. Will be prompted for a reason',
+            '--close --reason "Done" CRY-1 CRY-2         # Close multiple issues with a reason',
+            '--cancel --trash --reason "Garbage" CRY-2   # Cancel an issue, and throw it in the trash'
+          ]
 
           def call(issue_ids:, **options)
-            prompt.error('You should provide at least one issue ID') && raise(SmellsBad) if issue_ids.empty?
+            raise SmellsBad, 'No issue IDs provided!' if issue_ids.empty?
+            raise SmellsBad, 'You may only open a PR against a single issue' if options[:pr] && issue_ids.size > 1
 
             logger.debug('Updating issues', issue_ids:, options:)
             Rubyists::Linear::Issue.find_all(issue_ids).each do |issue|
-              update_issue(issue, **options)
+              update_issue(issue, **options) # defined in lib/linear/commands/issue.rb
             end
           end
         end

data/lib/linear/commands/issue.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+# This is where the #reason_for, #title_for, #description_for, #team_for, and #labels_for methods are defined
+# as well as other helpers which are used in multiple commands and subcommands
+# This is also where the #prompt method is defined, which is used to display messages to the user and get input
 require_relative '../cli/sub_commands'
 
 module Rubyists
@@ -27,12 +30,23 @@ module Rubyists
           prompt.ok("Comment added to #{issue.identifier}")
         end
 
+        def cancel_issue(issue, **options)
+          reason = reason_for(options[:reason], four: "cancelling #{issue.identifier} - #{issue.title}")
+          issue_comment(issue, reason)
+          cancel_state = cancel_state_for(issue)
+          issue.close!(state: cancel_state, trash: options[:trash])
+          prompt.ok("#{issue.identifier} was cancelled")
+        end
+
         def close_issue(issue, **options)
-          reason = reason_for(options[:reason], four: "closing #{issue.identifier} - #{issue.title}")
+          cancelled = options[:cancel]
+          doing = cancelled ? 'cancelling' : 'closing'
+          done = cancelled ? 'cancelled' : 'closed'
+          workflow_state = cancelled ? cancelled_state_for(issue) : completed_state_for(issue)
+          reason = reason_for(options[:reason], four: "#{doing} #{issue.identifier} - #{issue.title}")
           issue_comment(issue, reason)
-          close_state = completed_state_for(issue)
-          issue.close!(state: close_state, trash: options[:trash])
-          prompt.ok("#{issue.identifier} was closed")
+          issue.close!(state: workflow_state, trash: options[:trash])
+          prompt.ok("#{issue.identifier} was #{done}")
         end
 
         def issue_pr(issue)

data/lib/linear/models/base_model/class_methods.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Linear
+    class BaseModel
+      # Class methods for Linear models.
+      module ClassMethods
+        def many_to_one(relation, klass)
+          define_method relation do
+            return instance_variable_get("@#{relation}") if instance_variable_defined?("@#{relation}")
+            return unless (val = data[relation])
+
+            instance_variable_set("@#{relation}", Rubyists::Linear.const_get(klass).new(val))
+          end
+
+          define_method "#{relation}=" do |val|
+            hash = val.is_a?(Hash) ? val : val.data
+            updated_data[relation] = hash
+            instance_variable_set("@#{relation}", Rubyists::Linear.const_get(klass).new(hash))
+          end
+        end
+
+        alias one_to_one many_to_one
+
+        def find(id_val)
+          camel_name = just_name.camelize :lower
+          bf = base_fragment
+          query_data = Api.query(query { __node(camel_name, id: id_val) { ___ bf } })
+          new query_data[camel_name.to_sym]
+        end
+
+        def const_added(const)
+          return unless const == :Base
+
+          include MethodMagic
+        end
+
+        def allq(filter: nil, limit: 50, after: nil)
+          args = { first: limit }
+          args[:filter] = filter ? basic_filter.merge(filter) : basic_filter
+          args.delete(:filter) if args[:filter].empty?
+          args[:after] = after if after
+          all_query args, plural.to_s, base_fragment
+        end
+
+        def all_query(args, subject, base_fragment)
+          query do
+            __node(subject, args) do
+              edges do
+                node { ___ base_fragment }
+                cursor
+              end
+              ___ Fragments::PageInfo
+            end
+          end
+        end
+
+        def just_name
+          name.split('::').last
+        end
+
+        def base_fragment
+          const_get(:Base)
+        end
+
+        def basic_filter
+          return const_get(:BASIC_FILTER) if const_defined?(:BASIC_FILTER)
+
+          {}
+        end
+
+        def plural
+          return const_get(:PLURAL) if const_defined?(:PLURAL)
+
+          just_name.downcase.pluralize.to_sym
+        end
+
+        def gql_query(filter: nil, after: nil)
+          Api.query(allq(filter:, after:))
+        end
+
+        def all(after: nil, filter: nil, max: 100)
+          edges = []
+          moar = true
+          while moar
+            data = gql_query(filter:, after:)
+            subjects = data[plural]
+            edges += subjects[:edges]
+            moar = false if edges.size >= max || !subjects[:pageInfo][:hasNextPage]
+            after = subjects[:pageInfo][:endCursor]
+          end
+          edges.map { |edge| new edge[:node] }
+        end
+      end
+    end
+  end
+end

data/lib/linear/models/base_model/method_magic.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Linear
+    class BaseModel
+      # Methods for Linear models.
+      module MethodMagic
+        def self.included(base) # rubocop:disable Metrics/MethodLength
+          base.instance_eval do
+            base.base_fragment.__nodes.each do |node|
+              sym = node.__name.to_sym
+              define_method node.__name do
+                updated_data[sym]
+              end
+
+              define_method "#{node.__name}=" do |value|
+                updated_data[sym] = value
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/linear/models/base_model.rb

@@ -8,113 +8,17 @@ module Rubyists
   #  Namespace for Linear
   module Linear
     L :api, :fragments
-    # Module which provides a base model for Linear models.
+    M 'base_model/method_magic', 'base_model/class_methods'
+    # The base model for all Linear models
     class BaseModel
       extend GQLi::DSL
       include GQLi::DSL
       include SemanticLogger::Loggable
-
-      # Methods for Linear models.
-      module MethodMagic
-        def self.included(base) # rubocop:disable Metrics/MethodLength
-          base.instance_eval do
-            base.base_fragment.__nodes.each do |node|
-              sym = node.__name.to_sym
-              define_method node.__name do
-                updated_data[sym]
-              end
-
-              define_method "#{node.__name}=" do |value|
-                updated_data[sym] = value
-              end
-            end
-          end
-        end
-      end
-
-      # Class methods for Linear models.
-      class << self
-        def one_to_one(relation, klass)
-          define_method relation do
-            return instance_variable_get("@#{relation}") if instance_variable_defined?("@#{relation}")
-            return unless (val = data[relation])
-
-            instance_variable_set("@#{relation}", Rubyists::Linear.const_get(klass).new(val))
-          end
-
-          define_method "#{relation}=" do |val|
-            hash = val.is_a?(Hash) ? val : val.data
-            updated_data[relation] = hash
-            instance_variable_set("@#{relation}", Rubyists::Linear.const_get(klass).new(hash))
-          end
-        end
-
-        def const_added(const)
-          return unless const == :Base
-
-          include MethodMagic
-        end
-
-        def allq(filter: nil, limit: 50, after: nil)
-          args = { first: limit }
-          args[:filter] = filter ? basic_filter.merge(filter) : basic_filter
-          args.delete(:filter) if args[:filter].empty?
-          args[:after] = after if after
-          all_query args, plural.to_s, base_fragment
-        end
-
-        def all_query(args, subject, base_fragment)
-          query do
-            __node(subject, args) do
-              edges do
-                node { ___ base_fragment }
-                cursor
-              end
-              ___ Fragments::PageInfo
-            end
-          end
-        end
-
-        def just_name
-          name.split('::').last
-        end
-
-        def base_fragment
-          const_get(:Base)
-        end
-
-        def basic_filter
-          return const_get(:BASIC_FILTER) if const_defined?(:BASIC_FILTER)
-
-          {}
-        end
-
-        def plural
-          return const_get(:PLURAL) if const_defined?(:PLURAL)
-
-          just_name.downcase.pluralize.to_sym
-        end
-
-        def gql_query(filter: nil, after: nil)
-          Api.query(allq(filter:, after:))
-        end
-
-        def all(after: nil, filter: nil, max: 100)
-          edges = []
-          moar = true
-          while moar
-            data = gql_query(filter:, after:)
-            subjects = data[plural]
-            edges += subjects[:edges]
-            moar = false if edges.size >= max || !subjects[:pageInfo][:hasNextPage]
-            after = subjects[:pageInfo][:endCursor]
-          end
-          edges.map { |edge| new edge[:node] }
-        end
-      end
-
+      extend ClassMethods
       attr_reader :data, :updated_data
 
+      CANCELLED_STATES = %w[cancelled canceled].freeze
+
       def initialize(data)
         data.each_key { |k| raise SmellsBad, "Unknown key #{k}" unless respond_to? "#{k}=" }
         @data = data
@@ -129,6 +33,10 @@ module Rubyists
         workflow_states.select { |ws| ws.type == 'completed' }
       end
 
+      def cancelled_states
+        workflow_states.select { |ws| CANCELLED_STATES.include? ws.type }
+      end
+
       def to_h
         updated_data
       end

data/lib/linear.rb

@@ -24,6 +24,14 @@ module Rubyists
     FEATURE_ROOT = ROOT/:features
     DEBUG_LEVELS = %i[warn info debug trace].freeze
 
+    def self.tmpdir=(other)
+      @tmpdir = other.is_a?(Pathname) ? other : Pathname(other)
+    end
+
+    def self.tmpdir
+      @tmpdir || raise('tmpdir not set')
+    end
+
     def self.L(*libraries) # rubocop:disable Naming/MethodName
       Array(libraries).each { |library| require LIBROOT/library }
     end

data/linear-cli.gemspec

@@ -43,6 +43,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'semantic_logger', '~> 4.0'
   spec.add_dependency 'sequel', '~> 5.0'
   spec.add_dependency 'sqlite3', '~> 1.7'
+  spec.add_dependency 'tty-editor', '~> 0.7'
   spec.add_dependency 'tty-markdown', '~> 0.7'
   spec.add_dependency 'tty-prompt', '~> 0.23'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linear-cli
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.7.6
 platform: ruby
 authors:
 - Tj (bougyman) Vanderpoel
@@ -150,6 +150,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: tty-editor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: tty-markdown
   requirement: !ruby/object:Gem::Requirement
@@ -217,7 +231,10 @@ files:
 - changelog/0.7.2/tag.yml
 - changelog/0.7.3/fixed_problem_with_issue_relationship_to_user.yml
 - changelog/0.7.3/tag.yml
+- changelog/0.7.5/fixed_problem_when_choosing_from_multiple_completed_states.yml
+- changelog/0.7.5/tag.yml
 - changelog/unreleased/.gitkeep
+- cinemas/listings.cinema
 - exe/lc
 - exe/lc.sh
 - exe/lclose
@@ -247,6 +264,8 @@ files:
 - lib/linear/exceptions.rb
 - lib/linear/fragments.rb
 - lib/linear/models/base_model.rb
+- lib/linear/models/base_model/class_methods.rb
+- lib/linear/models/base_model/method_magic.rb
 - lib/linear/models/issue.rb
 - lib/linear/models/label.rb
 - lib/linear/models/team.rb
@@ -254,6 +273,7 @@ files:
 - lib/linear/models/workflow_state.rb
 - lib/linear/version.rb
 - linear-cli.gemspec
+- listings.cinema.gif
 homepage: https://github.com/rubyists/linear-cli
 licenses:
 - MIT