github-to-canvas 0.0.21 → 0.0.26
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +5 -0
- data/bin/github-to-canvas +40 -8
- data/lib/github-to-canvas.rb +12 -3
- data/lib/github-to-canvas/canvas_interface.rb +24 -8
- data/lib/github-to-canvas/create_canvas_lesson.rb +7 -4
- data/lib/github-to-canvas/github_interface.rb +12 -7
- data/lib/github-to-canvas/repository_converter.rb +33 -1
- data/lib/github-to-canvas/update_canvas_lesson.rb +7 -4
- data/lib/github-to-canvas/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 49af565aafcbebe3151fdf8546a6153600e6425afcf1af8034fdc914d4003b51
|
4
|
+
data.tar.gz: 01a5ac504f7d905394f1eb42f2cec5b89237f1e2af7f7e42fad3bacd6001b0de
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 535eeae8522d06b60b35a5f26a7a427fecd28cfa4c89f8d359b472e290a34ef58b5a7532f79c28219a20a8333bdd643052b497052b853749ecfc9ff0ba91c174
|
7
|
+
data.tar.gz: c7dc94133876c712d5e3f0fc1003553d2ea3f21b967d8ffa742fa98be1147f09f7024f0f0baa5ffc6f286a64dc9bbb6f7ab90b480da59449956fba0faf69aec5
|
data/README.md
CHANGED
data/bin/github-to-canvas
CHANGED
@@ -18,19 +18,27 @@ OptionParser.new do |opts|
|
|
18
18
|
github-to-canvas --create COURSE [--branch BRANCH] [--name NAME]
|
19
19
|
github-to-canvas --create COURSE [--branch BRANCH] [--name NAME] [--type TYPE]
|
20
20
|
github-to-canvas --create COURSE [--dry-run]
|
21
|
+
github-to-canvas --create COURSE [--fis-links]
|
22
|
+
github-to-canvas --create COURSE [--fis-links] [--remove-header-and-footer]
|
21
23
|
github-to-canvas --align
|
24
|
+
github-to-canvas --align [--branch BRANCH]
|
25
|
+
github-to-canvas --align [--branch BRANCH] [--fis-links]
|
22
26
|
github-to-canvas --version
|
27
|
+
|
23
28
|
|
24
29
|
Run these commands from inside a local GitHub repository. This gem is built for Flatiron School's internal use.
|
25
30
|
Some default behaviors assume this, like the default Canvas API path.
|
26
31
|
|
27
32
|
Example usage:
|
28
33
|
|
29
|
-
github-to-canvas --create 154 -> Creates a lesson in course 154,
|
30
|
-
github-to-canvas --create 154 --name "Fetch Lab" -> Creates a lesson in course 154 with the provided name,
|
34
|
+
github-to-canvas --create 154 -> Creates a lesson in course 154, derives the name and type from the local repo
|
35
|
+
github-to-canvas --create 154 --name "Fetch Lab" -> Creates a lesson in course 154 with the provided name, derives the type from the local repo
|
31
36
|
github-to-canvas --create 154 --name "Fetch Lab" --type assignment -> Creates an assignment in course 154 with the provided name
|
32
|
-
github-to-canvas --create 154 --name "Fetch Lab" --branch solution -> Creates a lesson in course 154 with the provided name,
|
33
|
-
|
37
|
+
github-to-canvas --create 154 --name "Fetch Lab" --branch solution -> Creates a lesson in course 154 with the provided name, uses the repository's solution branch and derives the type from the local repo
|
38
|
+
github-to-canvas --align -> Patches existing lessons in Canvas based on the .canvas file
|
39
|
+
github-to-canvas --align --fis-links -> Patches existing lessons in Canvas based on the .canvas file, adds addition Flatiron School specific HTML
|
40
|
+
github-to-canvas --align --remove-header-and-footer -> Patches existing lessons in Canvas based on the .canvas file, removes top lesson header before converting to HTML
|
41
|
+
|
34
42
|
EOBANNER
|
35
43
|
|
36
44
|
opts.on("-cCOURSE", "--create COURSE",
|
@@ -48,7 +56,7 @@ OptionParser.new do |opts|
|
|
48
56
|
end
|
49
57
|
opts.on("-tTYPE", "--type TYPE",
|
50
58
|
"Sets the type Canvas lesson to be created (page or assignment). If no type, type decided based on repository structure") do |type|
|
51
|
-
if type == 'page' || type == 'assignment'
|
59
|
+
if type == 'page' || type == 'assignment' || type == 'discussion'
|
52
60
|
options[:type] = type
|
53
61
|
else
|
54
62
|
puts "Invalid type. Defaulting to page"
|
@@ -64,9 +72,17 @@ OptionParser.new do |opts|
|
|
64
72
|
options[:version] = true
|
65
73
|
end
|
66
74
|
opts.on("-d", "--dry-run",
|
67
|
-
"Runs through creation without pushing to Canvas or GitHub") do |
|
75
|
+
"Runs through creation without pushing to Canvas or GitHub") do |d|
|
68
76
|
options[:dry] = true
|
69
77
|
end
|
78
|
+
opts.on("-f", "--fis-links",
|
79
|
+
"Adds additional Flatiron School HTML after markdown conversion") do |f|
|
80
|
+
options[:fis] = true
|
81
|
+
end
|
82
|
+
opts.on("-r", "--remove-header-and-footer",
|
83
|
+
"Removes top lesson header and any Learn.co specific footer links before converting to HTML") do |r|
|
84
|
+
options[:remove_header_and_footer] = true
|
85
|
+
end
|
70
86
|
|
71
87
|
end.parse!
|
72
88
|
|
@@ -91,9 +107,25 @@ if !options[:name]
|
|
91
107
|
end
|
92
108
|
|
93
109
|
if options[:create]
|
94
|
-
GithubToCanvas.new(mode: "create",
|
110
|
+
GithubToCanvas.new(mode: "create",
|
111
|
+
course: options[:course],
|
112
|
+
filepath: Dir.pwd,
|
113
|
+
branch: options[:branch],
|
114
|
+
name: options[:name],
|
115
|
+
type: options[:type],
|
116
|
+
dry: !!options[:dry],
|
117
|
+
fis_links: !!options[:fis],
|
118
|
+
remove_header_and_footer: !!options[:remove_header_and_footer])
|
95
119
|
end
|
96
120
|
|
97
121
|
if options[:align]
|
98
|
-
GithubToCanvas.new(mode: "align",
|
122
|
+
GithubToCanvas.new(mode: "align",
|
123
|
+
course: nil,
|
124
|
+
filepath: Dir.pwd,
|
125
|
+
branch: options[:branch],
|
126
|
+
name: options[:name],
|
127
|
+
type: options[:type],
|
128
|
+
dry: !!options[:dry],
|
129
|
+
fis_links: !!options[:fis],
|
130
|
+
remove_header_and_footer: !!options[:remove_header_and_footer])
|
99
131
|
end
|
data/lib/github-to-canvas.rb
CHANGED
@@ -9,7 +9,16 @@ require_relative './github-to-canvas/version'
|
|
9
9
|
|
10
10
|
class GithubToCanvas
|
11
11
|
|
12
|
-
def initialize(mode:,
|
12
|
+
def initialize(mode:,
|
13
|
+
course:,
|
14
|
+
filepath:Dir.pwd,
|
15
|
+
branch:'master',
|
16
|
+
name:File.basename(Dir.getwd),
|
17
|
+
type:"page",
|
18
|
+
dry:false,
|
19
|
+
fis_links:false,
|
20
|
+
remove_header_and_footer:false)
|
21
|
+
|
13
22
|
if mode == 'version'
|
14
23
|
puts VERSION
|
15
24
|
return
|
@@ -17,12 +26,12 @@ class GithubToCanvas
|
|
17
26
|
|
18
27
|
if mode == 'create'
|
19
28
|
puts "github-to-canvas will now create a Canvas lesson based on the current repo"
|
20
|
-
CreateCanvasLesson.new(course, filepath, branch, name, type, dry)
|
29
|
+
CreateCanvasLesson.new(course, filepath, branch, name, type, dry, fis_links, remove_header_and_footer)
|
21
30
|
end
|
22
31
|
|
23
32
|
if mode == 'align'
|
24
33
|
puts "github-to-canvas will now align any existing Canvas lessons based on the current repo. NOTE: .canvas file must be present"
|
25
|
-
UpdateCanvasLesson.new(filepath, branch, name, type, dry)
|
34
|
+
UpdateCanvasLesson.new(filepath, branch, name, type, dry, fis_links, remove_header_and_footer)
|
26
35
|
end
|
27
36
|
end
|
28
37
|
|
@@ -17,20 +17,31 @@ class CanvasInterface
|
|
17
17
|
end
|
18
18
|
|
19
19
|
def self.push_to_canvas(course_id, type, name, new_readme)
|
20
|
-
|
20
|
+
if type == 'discussion'
|
21
|
+
url = "#{ENV['CANVAS_API_PATH']}/courses/#{course_id}/#{type}_topics"
|
22
|
+
else
|
23
|
+
url = "#{ENV['CANVAS_API_PATH']}/courses/#{course_id}/#{type}s"
|
24
|
+
end
|
21
25
|
payload = self.build_payload(type, name, new_readme)
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
+
begin
|
27
|
+
RestClient.post(url, payload, headers={
|
28
|
+
"Authorization" => "Bearer #{ENV['CANVAS_API_KEY']}"
|
29
|
+
})
|
30
|
+
rescue
|
31
|
+
puts "Something went wrong while pushing lesson #{id} to course #{course_id}"
|
32
|
+
end
|
26
33
|
end
|
27
34
|
|
28
35
|
def self.update_existing_lesson(course_id, id, type, name, new_readme, dry_run)
|
29
36
|
url = "#{ENV['CANVAS_API_PATH']}/courses/#{course_id}/#{type}s/#{id}"
|
30
37
|
payload = self.build_payload(type, name, new_readme)
|
31
|
-
|
32
|
-
|
33
|
-
|
38
|
+
begin
|
39
|
+
RestClient.put(url, payload, headers={
|
40
|
+
"Authorization" => "Bearer #{ENV['CANVAS_API_KEY']}"
|
41
|
+
})
|
42
|
+
rescue
|
43
|
+
puts "Something went wrong while pushing lesson #{id} to course #{course_id}"
|
44
|
+
end
|
34
45
|
end
|
35
46
|
|
36
47
|
def self.build_payload(type, name, new_readme)
|
@@ -39,6 +50,11 @@ class CanvasInterface
|
|
39
50
|
'assignment[name]' => name,
|
40
51
|
'assignment[description]' => new_readme
|
41
52
|
}
|
53
|
+
elsif type == "discussion"
|
54
|
+
payload = {
|
55
|
+
'title' => name,
|
56
|
+
'message' => new_readme
|
57
|
+
}
|
42
58
|
else
|
43
59
|
payload = {
|
44
60
|
'wiki_page[title]' => name,
|
@@ -1,18 +1,21 @@
|
|
1
1
|
class CreateCanvasLesson
|
2
2
|
|
3
|
-
def initialize(course, filepath, branch, name, type, dry_run)
|
3
|
+
def initialize(course, filepath, branch, name, type, dry_run, fis_links, remove_header_and_footer)
|
4
4
|
name = name.split(/[- _]/).map(&:capitalize).join(' ')
|
5
5
|
original_readme = File.read("#{filepath}/README.md")
|
6
6
|
if !original_readme
|
7
7
|
puts 'README.md not found in current directory. Exiting...'
|
8
8
|
abort
|
9
9
|
end
|
10
|
-
create_canvas_lesson(original_readme, course, filepath, branch, name, type, dry_run)
|
10
|
+
create_canvas_lesson(original_readme, course, filepath, branch, name, type, dry_run, fis_links, remove_header_and_footer)
|
11
11
|
end
|
12
12
|
|
13
|
-
def create_canvas_lesson(readme, course, filepath, branch, name, type, dry_run)
|
13
|
+
def create_canvas_lesson(readme, course, filepath, branch, name, type, dry_run, fis_links, remove_header_and_footer)
|
14
14
|
GithubInterface.get_updated_repo(filepath, branch)
|
15
|
-
new_readme = RepositoryConverter.convert(filepath, readme, branch)
|
15
|
+
new_readme = RepositoryConverter.convert(filepath, readme, branch, remove_header_and_footer)
|
16
|
+
if fis_links
|
17
|
+
new_readme = RepositoryConverter.add_fis_links(filepath, new_readme)
|
18
|
+
end
|
16
19
|
response = CanvasInterface.submit_to_canvas(course, type, name, new_readme, dry_run)
|
17
20
|
if dry_run
|
18
21
|
puts 'DRY RUN: Skipping dotfile creation and push to GitHub'
|
@@ -1,20 +1,25 @@
|
|
1
|
-
|
2
1
|
class GithubInterface
|
3
2
|
|
3
|
+
def self.cd_into_and(filepath, command)
|
4
|
+
cmd = "cd #{filepath} && #{command}"
|
5
|
+
puts cmd
|
6
|
+
`#{cmd}`
|
7
|
+
end
|
8
|
+
|
4
9
|
def self.get_updated_repo(filepath, branch)
|
5
10
|
self.git_co_branch(filepath, branch)
|
6
11
|
self.git_pull(filepath, branch)
|
7
12
|
end
|
8
13
|
|
9
|
-
def self.
|
10
|
-
|
11
|
-
puts cmd
|
12
|
-
`#{cmd}`
|
14
|
+
def self.get_current_branch(filepath)
|
15
|
+
self.cd_into_and(filepath, "git rev-parse --abbrev-ref HEAD")
|
13
16
|
end
|
14
17
|
|
15
18
|
def self.git_co_branch(filepath, branch)
|
16
|
-
|
17
|
-
|
19
|
+
self.cd_into_and(filepath, "git checkout #{branch}")
|
20
|
+
current_branch = self.get_current_branch(filepath)
|
21
|
+
puts "Current branch #{current_branch.strip}"
|
22
|
+
if !current_branch.match(branch)
|
18
23
|
puts "#{branch} branch not found. Exiting..."
|
19
24
|
abort
|
20
25
|
end
|
@@ -1,11 +1,24 @@
|
|
1
1
|
require 'redcarpet'
|
2
2
|
class RepositoryConverter
|
3
3
|
|
4
|
-
def self.convert(filepath, readme, branch)
|
4
|
+
def self.convert(filepath, readme, branch, remove_header_and_footer)
|
5
|
+
if remove_header_and_footer
|
6
|
+
readme = self.remove_header(readme)
|
7
|
+
readme = self.remove_footer(readme)
|
8
|
+
p readme
|
9
|
+
end
|
5
10
|
self.fix_local_images(filepath, readme, branch)
|
6
11
|
self.convert_to_html(filepath, readme)
|
7
12
|
end
|
8
13
|
|
14
|
+
def self.remove_header(readme)
|
15
|
+
readme.gsub(/^# .+?\n\n/,"")
|
16
|
+
end
|
17
|
+
|
18
|
+
def self.remove_footer(readme)
|
19
|
+
readme.gsub(/<p (.+?)<\/p>/,"")
|
20
|
+
end
|
21
|
+
|
9
22
|
def self.fix_local_images(filepath, readme, branch)
|
10
23
|
raw_remote_url = self.set_raw_image_remote_url(filepath)
|
11
24
|
self.adjust_local_markdown_images(readme, raw_remote_url, branch)
|
@@ -20,6 +33,13 @@ class RepositoryConverter
|
|
20
33
|
remote.strip!
|
21
34
|
end
|
22
35
|
|
36
|
+
def self.get_repo_url(filepath)
|
37
|
+
remote = GithubInterface.git_remote(filepath)
|
38
|
+
remote.gsub!("git@github.com:","https://github.com/")
|
39
|
+
remote.gsub!(/.git$/,"")
|
40
|
+
remote.strip!
|
41
|
+
end
|
42
|
+
|
23
43
|
def self.adjust_local_markdown_images(readme, raw_remote_url, branch)
|
24
44
|
readme.gsub!(/\!\[.+\]\(.+\)/) {|image|
|
25
45
|
if !image.match('amazonaws.com') && !image.match('https://') && !image.match('youtube')
|
@@ -52,4 +72,16 @@ class RepositoryConverter
|
|
52
72
|
redcarpet.render(readme)
|
53
73
|
end
|
54
74
|
|
75
|
+
def self.add_fis_links(filepath, readme)
|
76
|
+
repo = self.get_repo_url(filepath)
|
77
|
+
github_repo_link = "<a class='fis-git-link' href='#{repo}' target='_blank' rel='noopener'><img id='repo-img' title='Open GitHub Repo' alt='GitHub Repo' /></a>"
|
78
|
+
github_issue_link = "<a class='fis-git-link' href='#{repo}/issues/new' target='_blank' rel='noopener'><img id='issue-img' title='Create New Issue' alt='Create New Issue' /></a>"
|
79
|
+
thumbs_up_link = "<a id='thumbs-up' data-repository='#{repo.split('/')[-1]}'><img title='Thumbs up!' alt='thumbs up' /></a>"
|
80
|
+
thumbs_down_link = "<a id='thumbs-down' data-repository='#{repo.split('/')[-1]}'><img title='Thumbs down!' alt='thumbs down' /></a>"
|
81
|
+
feedback_link = "<h5>Have specific feedback? <a href='#{repo}/issues/new'>Tell us here!</a></h5>"
|
82
|
+
header = "<header class='fis-header' style='visibility: hidden;'>#{github_repo_link}#{github_issue_link}</header>"
|
83
|
+
footer = "<footer class='fis-footer' style='visibility: hidden;'><div class='fis-feedback'><h5>How do you feel about this lesson?</h5>#{thumbs_up_link}#{thumbs_down_link}</div>#{feedback_link}</footer>"
|
84
|
+
header + readme + footer
|
85
|
+
end
|
86
|
+
|
55
87
|
end
|
@@ -1,18 +1,21 @@
|
|
1
1
|
class UpdateCanvasLesson
|
2
2
|
|
3
|
-
def initialize(filepath, branch, name, type, dry_run)
|
3
|
+
def initialize(filepath, branch, name, type, dry_run, fis_links, remove_header_and_footer)
|
4
4
|
name = name.split(/[- _]/).map(&:capitalize).join(' ')
|
5
5
|
readme = File.read("#{filepath}/README.md")
|
6
6
|
if !readme
|
7
7
|
puts 'README.md not found in current directory. Exiting...'
|
8
8
|
abort
|
9
9
|
end
|
10
|
-
update_canvas_lesson(readme, filepath, branch, name, type, dry_run)
|
10
|
+
update_canvas_lesson(readme, filepath, branch, name, type, dry_run, fis_links, remove_header_and_footer)
|
11
11
|
end
|
12
12
|
|
13
|
-
def update_canvas_lesson(readme, filepath, branch, name, type, dry_run)
|
13
|
+
def update_canvas_lesson(readme, filepath, branch, name, type, dry_run, fis_links, remove_header_and_footer)
|
14
14
|
GithubInterface.get_updated_repo(filepath, branch)
|
15
|
-
new_readme = RepositoryConverter.convert(filepath, readme, branch)
|
15
|
+
new_readme = RepositoryConverter.convert(filepath, readme, branch, remove_header_and_footer)
|
16
|
+
if fis_links
|
17
|
+
new_readme = RepositoryConverter.add_fis_links(filepath, new_readme)
|
18
|
+
end
|
16
19
|
canvas_data = CanvasDotfile.read_canvas_data
|
17
20
|
canvas_data[:lessons].each { |lesson|
|
18
21
|
CanvasInterface.update_existing_lesson(lesson[:course_id], lesson[:id], type, name, new_readme, dry_run)
|