19 import xml
.dom
.minidom
37 # Use xdg module when it's less painful to have as a dependency
40 class XDG(NamedTuple
):
45 XDG_CACHE_HOME
=os
.getenv(
47 os
.path
.expanduser('~/.cache')))
50 class VerificationError(Exception):
56 def __init__(self
) -> None:
59 def status(self
, s
: str) -> None:
60 print(s
, end
=' ', file=sys
.stderr
, flush
=True)
61 self
.line_length
+= 1 + len(s
) # Unicode??
64 def _color(s
: str, c
: int) -> str:
65 return '\033[%2dm%s\033[00m' % (c
, s
)
67 def result(self
, r
: bool) -> None:
68 message
, color
= {True: ('OK ', 92), False: ('FAIL', 91)}
[r
]
70 cols
= shutil
.get_terminal_size().columns
or 80
71 pad
= (cols
- (self
.line_length
+ length
)) % cols
72 print(' ' * pad
+ self
._color
(message
, color
), file=sys
.stderr
)
75 raise VerificationError()
77 def check(self
, s
: str, r
: bool) -> None:
85 Digest16
= NewType('Digest16', str)
86 Digest32
= NewType('Digest32', str)
89 class ChannelTableEntry(types
.SimpleNamespace
):
97 class AliasPin(NamedTuple
):
101 class SymlinkPin(NamedTuple
):
103 def release_name(self
) -> str:
107 class GitPin(NamedTuple
):
112 class ChannelPin(NamedTuple
):
119 Pin
= Union
[AliasPin
, SymlinkPin
, GitPin
, ChannelPin
]
122 def copy_to_nix_store(v
: Verification
, filename
: str) -> str:
123 v
.status('Putting tarball in Nix store')
124 process
= subprocess
.run(
125 ['nix-store', '--add', filename
], stdout
=subprocess
.PIPE
)
126 v
.result(process
.returncode
== 0)
127 return process
.stdout
.decode().strip() # type: ignore # (for old mypy)
130 def symlink_archive(v
: Verification
, path
: str) -> str:
131 with tempfile
.TemporaryDirectory() as td
:
132 archive_filename
= os
.path
.join(td
, 'link.tar.gz')
133 os
.symlink(path
, os
.path
.join(td
, 'link'))
134 with tarfile
.open(archive_filename
, mode
='x:gz') as t
:
135 t
.add(os
.path
.join(td
, 'link'), arcname
='link')
136 return copy_to_nix_store(v
, archive_filename
)
139 class AliasSearchPath(NamedTuple
):
142 # pylint: disable=no-self-use
143 def pin(self
, _
: Verification
, __
: Optional
[Pin
]) -> AliasPin
:
147 class SymlinkSearchPath(NamedTuple
):
150 # pylint: disable=no-self-use
151 def pin(self
, _
: Verification
, __
: Optional
[Pin
]) -> SymlinkPin
:
154 def fetch(self
, v
: Verification
, _
: Pin
) -> str:
155 return symlink_archive(v
, self
.path
)
158 class GitSearchPath(NamedTuple
):
162 def pin(self
, v
: Verification
, old_pin
: Optional
[Pin
]) -> GitPin
:
163 if old_pin
is not None:
164 assert isinstance(old_pin
, GitPin
)
165 old_revision
= old_pin
.git_revision
if old_pin
is not None else None
167 new_revision
= git_fetch(v
, self
, None, old_revision
)
168 return GitPin(release_name
=git_revision_name(v
, self
, new_revision
),
169 git_revision
=new_revision
)
171 def fetch(self
, v
: Verification
, pin
: Pin
) -> str:
172 assert isinstance(pin
, GitPin
)
173 ensure_git_rev_available(v
, self
, pin
, None)
174 return git_get_tarball(v
, self
, pin
)
177 class ChannelSearchPath(NamedTuple
):
182 def pin(self
, v
: Verification
, old_pin
: Optional
[Pin
]) -> ChannelPin
:
183 if old_pin
is not None:
184 assert isinstance(old_pin
, ChannelPin
)
185 old_revision
= old_pin
.git_revision
if old_pin
is not None else None
187 channel_html
, forwarded_url
= fetch_channel(v
, self
)
188 table
, new_gitpin
= parse_channel(v
, channel_html
)
189 fetch_resources(v
, new_gitpin
, forwarded_url
, table
)
190 ensure_git_rev_available(v
, self
, new_gitpin
, old_revision
)
191 check_channel_contents(v
, self
, table
, new_gitpin
)
193 release_name
=new_gitpin
.release_name
,
194 tarball_url
=table
['nixexprs.tar.xz'].absolute_url
,
195 tarball_sha256
=table
['nixexprs.tar.xz'].digest
,
196 git_revision
=new_gitpin
.git_revision
)
198 # pylint: disable=no-self-use
199 def fetch(self
, v
: Verification
, pin
: Pin
) -> str:
200 assert isinstance(pin
, ChannelPin
)
202 return fetch_with_nix_prefetch_url(
203 v
, pin
.tarball_url
, Digest16(pin
.tarball_sha256
))
206 SearchPath
= Union
[AliasSearchPath
,
210 TarrableSearchPath
= Union
[GitSearchPath
, ChannelSearchPath
]
213 def compare(a
: str, b
: str) -> Tuple
[List
[str], List
[str], List
[str]]:
215 def throw(error
: OSError) -> None:
218 def join(x
: str, y
: str) -> str:
219 return y
if x
== '.' else os
.path
.join(x
, y
)
221 def recursive_files(d
: str) -> Iterable
[str]:
222 all_files
: List
[str] = []
223 for path
, dirs
, files
in os
.walk(d
, onerror
=throw
):
224 rel
= os
.path
.relpath(path
, start
=d
)
225 all_files
.extend(join(rel
, f
) for f
in files
)
226 for dir_or_link
in dirs
:
227 if os
.path
.islink(join(path
, dir_or_link
)):
228 all_files
.append(join(rel
, dir_or_link
))
231 def exclude_dot_git(files
: Iterable
[str]) -> Iterable
[str]:
232 return (f
for f
in files
if not f
.startswith('.git/'))
234 files
= functools
.reduce(
237 recursive_files(x
))) for x
in [a
, b
]))
238 return filecmp
.cmpfiles(a
, b
, files
, shallow
=False)
242 v
: Verification
, channel
: ChannelSearchPath
) -> Tuple
[str, str]:
243 v
.status('Fetching channel')
244 request
= urllib
.request
.urlopen(channel
.channel_url
, timeout
=10)
245 channel_html
= request
.read().decode()
246 forwarded_url
= request
.geturl()
247 v
.result(request
.status
== 200) # type: ignore # (for old mypy)
248 v
.check('Got forwarded', channel
.channel_url
!= forwarded_url
)
249 return channel_html
, forwarded_url
252 def parse_channel(v
: Verification
, channel_html
: str) \
253 -> Tuple
[Dict
[str, ChannelTableEntry
], GitPin
]:
254 v
.status('Parsing channel description as XML')
255 d
= xml
.dom
.minidom
.parseString(channel_html
)
258 v
.status('Extracting release name:')
259 title_name
= d
.getElementsByTagName(
260 'title')[0].firstChild
.nodeValue
.split()[2]
261 h1_name
= d
.getElementsByTagName('h1')[0].firstChild
.nodeValue
.split()[2]
263 v
.result(title_name
== h1_name
)
265 v
.status('Extracting git commit:')
266 git_commit_node
= d
.getElementsByTagName('tt')[0]
267 git_revision
= git_commit_node
.firstChild
.nodeValue
268 v
.status(git_revision
)
270 v
.status('Verifying git commit label')
271 v
.result(git_commit_node
.previousSibling
.nodeValue
== 'Git commit ')
273 v
.status('Parsing table')
274 table
: Dict
[str, ChannelTableEntry
] = {}
275 for row
in d
.getElementsByTagName('tr')[1:]:
276 name
= row
.childNodes
[0].firstChild
.firstChild
.nodeValue
277 url
= row
.childNodes
[0].firstChild
.getAttribute('href')
278 size
= int(row
.childNodes
[1].firstChild
.nodeValue
)
279 digest
= Digest16(row
.childNodes
[2].firstChild
.firstChild
.nodeValue
)
280 table
[name
] = ChannelTableEntry(url
=url
, digest
=digest
, size
=size
)
282 return table
, GitPin(release_name
=title_name
, git_revision
=git_revision
)
285 def digest_string(s
: bytes) -> Digest16
:
286 return Digest16(hashlib
.sha256(s
).hexdigest())
289 def digest_file(filename
: str) -> Digest16
:
290 hasher
= hashlib
.sha256()
291 with open(filename
, 'rb') as f
:
292 # pylint: disable=cell-var-from-loop
293 for block
in iter(lambda: f
.read(4096), b
''):
295 return Digest16(hasher
.hexdigest())
298 def to_Digest16(v
: Verification
, digest32
: Digest32
) -> Digest16
:
299 v
.status('Converting digest to base16')
300 process
= subprocess
.run(
301 ['nix', 'to-base16', '--type', 'sha256', digest32
], stdout
=subprocess
.PIPE
)
302 v
.result(process
.returncode
== 0)
303 return Digest16(process
.stdout
.decode().strip())
306 def to_Digest32(v
: Verification
, digest16
: Digest16
) -> Digest32
:
307 v
.status('Converting digest to base32')
308 process
= subprocess
.run(
309 ['nix', 'to-base32', '--type', 'sha256', digest16
], stdout
=subprocess
.PIPE
)
310 v
.result(process
.returncode
== 0)
311 return Digest32(process
.stdout
.decode().strip())
314 def fetch_with_nix_prefetch_url(
317 digest
: Digest16
) -> str:
318 v
.status('Fetching %s' % url
)
319 process
= subprocess
.run(
320 ['nix-prefetch-url', '--print-path', url
, digest
], stdout
=subprocess
.PIPE
)
321 v
.result(process
.returncode
== 0)
322 prefetch_digest
, path
, empty
= process
.stdout
.decode().split('\n')
324 v
.check("Verifying nix-prefetch-url's digest",
325 to_Digest16(v
, Digest32(prefetch_digest
)) == digest
)
326 v
.status("Verifying file digest")
327 file_digest
= digest_file(path
)
328 v
.result(file_digest
== digest
)
329 return path
# type: ignore # (for old mypy)
336 table
: Dict
[str, ChannelTableEntry
]) -> None:
337 for resource
in ['git-revision', 'nixexprs.tar.xz']:
338 fields
= table
[resource
]
339 fields
.absolute_url
= urllib
.parse
.urljoin(forwarded_url
, fields
.url
)
340 fields
.file = fetch_with_nix_prefetch_url(
341 v
, fields
.absolute_url
, fields
.digest
)
342 v
.status('Verifying git commit on main page matches git commit in table')
343 v
.result(open(table
['git-revision'].file).read(999) == pin
.git_revision
)
346 def git_cachedir(git_repo
: str) -> str:
350 digest_string(git_repo
.encode()))
353 def tarball_cache_file(channel
: TarrableSearchPath
, pin
: GitPin
) -> str:
358 (digest_string(channel
.git_repo
.encode()),
363 def verify_git_ancestry(
365 channel
: TarrableSearchPath
,
367 old_revision
: Optional
[str]) -> None:
368 cachedir
= git_cachedir(channel
.git_repo
)
369 v
.status('Verifying rev is an ancestor of ref')
370 process
= subprocess
.run(['git',
377 v
.result(process
.returncode
== 0)
379 if old_revision
is not None:
381 'Verifying rev is an ancestor of previous rev %s' %
383 process
= subprocess
.run(['git',
390 v
.result(process
.returncode
== 0)
395 channel
: TarrableSearchPath
,
396 desired_revision
: Optional
[str],
397 old_revision
: Optional
[str]) -> str:
398 # It would be nice if we could share the nix git cache, but as of the time
399 # of writing it is transitioning from gitv2 (deprecated) to gitv3 (not ready
400 # yet), and trying to straddle them both is too far into nix implementation
401 # details for my comfort. So we re-implement here half of nix.fetchGit.
404 cachedir
= git_cachedir(channel
.git_repo
)
405 if not os
.path
.exists(cachedir
):
406 v
.status("Initializing git repo")
407 process
= subprocess
.run(
408 ['git', 'init', '--bare', cachedir
])
409 v
.result(process
.returncode
== 0)
411 v
.status('Fetching ref "%s" from %s' % (channel
.git_ref
, channel
.git_repo
))
412 # We don't use --force here because we want to abort and freak out if forced
413 # updates are happening.
414 process
= subprocess
.run(['git',
419 '%s:%s' % (channel
.git_ref
,
421 v
.result(process
.returncode
== 0)
423 if desired_revision
is not None:
424 v
.status('Verifying that fetch retrieved this rev')
425 process
= subprocess
.run(
426 ['git', '-C', cachedir
, 'cat-file', '-e', desired_revision
])
427 v
.result(process
.returncode
== 0)
434 channel
.git_ref
)).read(999).strip()
436 verify_git_ancestry(v
, channel
, new_revision
, old_revision
)
441 def ensure_git_rev_available(
443 channel
: TarrableSearchPath
,
445 old_revision
: Optional
[str]) -> None:
446 cachedir
= git_cachedir(channel
.git_repo
)
447 if os
.path
.exists(cachedir
):
448 v
.status('Checking if we already have this rev:')
449 process
= subprocess
.run(
450 ['git', '-C', cachedir
, 'cat-file', '-e', pin
.git_revision
])
451 if process
.returncode
== 0:
453 if process
.returncode
== 1:
455 v
.result(process
.returncode
== 0 or process
.returncode
== 1)
456 if process
.returncode
== 0:
457 verify_git_ancestry(v
, channel
, pin
.git_revision
, old_revision
)
459 git_fetch(v
, channel
, pin
.git_revision
, old_revision
)
462 def compare_tarball_and_git(
465 channel_contents
: str,
466 git_contents
: str) -> None:
467 v
.status('Comparing channel tarball with git checkout')
468 match
, mismatch
, errors
= compare(os
.path
.join(
469 channel_contents
, pin
.release_name
), git_contents
)
471 v
.check('%d files match' % len(match
), len(match
) > 0)
472 v
.check('%d files differ' % len(mismatch
), len(mismatch
) == 0)
480 for ee
in expected_errors
:
483 benign_errors
.append(ee
)
485 '%d unexpected incomparable files' %
489 '(%d of %d expected incomparable files)' %
491 len(expected_errors
)),
492 len(benign_errors
) == len(expected_errors
))
497 table
: Dict
[str, ChannelTableEntry
],
499 v
.status('Extracting tarball %s' % table
['nixexprs.tar.xz'].file)
500 shutil
.unpack_archive(table
['nixexprs.tar.xz'].file, dest
)
506 channel
: TarrableSearchPath
,
509 v
.status('Checking out corresponding git revision')
510 git
= subprocess
.Popen(['git',
512 git_cachedir(channel
.git_repo
),
515 stdout
=subprocess
.PIPE
)
516 tar
= subprocess
.Popen(
517 ['tar', 'x', '-C', dest
, '-f', '-'], stdin
=git
.stdout
)
522 v
.result(git
.returncode
== 0 and tar
.returncode
== 0)
527 channel
: TarrableSearchPath
,
529 cache_file
= tarball_cache_file(channel
, pin
)
530 if os
.path
.exists(cache_file
):
531 cached_tarball
= open(cache_file
).read(9999)
532 if os
.path
.exists(cached_tarball
):
533 return cached_tarball
535 with tempfile
.TemporaryDirectory() as output_dir
:
536 output_filename
= os
.path
.join(
537 output_dir
, pin
.release_name
+ '.tar.xz')
538 with open(output_filename
, 'w') as output_file
:
540 'Generating tarball for git revision %s' %
542 git
= subprocess
.Popen(['git',
544 git_cachedir(channel
.git_repo
),
546 '--prefix=%s/' % pin
.release_name
,
548 stdout
=subprocess
.PIPE
)
549 xz
= subprocess
.Popen(['xz'], stdin
=git
.stdout
, stdout
=output_file
)
552 v
.result(git
.returncode
== 0 and xz
.returncode
== 0)
554 store_tarball
= copy_to_nix_store(v
, output_filename
)
556 os
.makedirs(os
.path
.dirname(cache_file
), exist_ok
=True)
557 open(cache_file
, 'w').write(store_tarball
)
558 return store_tarball
# type: ignore # (for old mypy)
561 def check_channel_metadata(
564 channel_contents
: str) -> None:
565 v
.status('Verifying git commit in channel tarball')
571 '.git-revision')).read(999) == pin
.git_revision
)
574 'Verifying version-suffix is a suffix of release name %s:' %
576 version_suffix
= open(
580 '.version-suffix')).read(999)
581 v
.status(version_suffix
)
582 v
.result(pin
.release_name
.endswith(version_suffix
))
585 def check_channel_contents(
587 channel
: TarrableSearchPath
,
588 table
: Dict
[str, ChannelTableEntry
],
589 pin
: GitPin
) -> None:
590 with tempfile
.TemporaryDirectory() as channel_contents
, \
591 tempfile
.TemporaryDirectory() as git_contents
:
593 extract_tarball(v
, table
, channel_contents
)
594 check_channel_metadata(v
, pin
, channel_contents
)
596 git_checkout(v
, channel
, pin
, git_contents
)
598 compare_tarball_and_git(v
, pin
, channel_contents
, git_contents
)
600 v
.status('Removing temporary directories')
604 def git_revision_name(
606 channel
: TarrableSearchPath
,
607 git_revision
: str) -> str:
608 v
.status('Getting commit date')
609 process
= subprocess
.run(['git',
611 git_cachedir(channel
.git_repo
),
616 '--no-show-signature',
618 stdout
=subprocess
.PIPE
)
619 v
.result(process
.returncode
== 0 and process
.stdout
!= b
'')
620 return '%s-%s' % (os
.path
.basename(channel
.git_repo
),
621 process
.stdout
.decode().strip())
628 def partition_dict(pred
: Callable
[[K
, V
], bool],
629 d
: Dict
[K
, V
]) -> Tuple
[Dict
[K
, V
], Dict
[K
, V
]]:
630 selected
: Dict
[K
, V
] = {}
631 remaining
: Dict
[K
, V
] = {}
632 for k
, v
in d
.items():
637 return selected
, remaining
640 def filter_dict(d
: Dict
[K
, V
], fields
: Set
[K
]
641 ) -> Tuple
[Dict
[K
, V
], Dict
[K
, V
]]:
642 return partition_dict(lambda k
, v
: k
in fields
, d
)
645 def read_config_section(
646 conf
: configparser
.SectionProxy
) -> Tuple
[SearchPath
, Optional
[Pin
]]:
647 mapping
: Mapping
[str, Tuple
[Type
[SearchPath
], Type
[Pin
]]] = {
648 'alias': (AliasSearchPath
, AliasPin
),
649 'channel': (ChannelSearchPath
, ChannelPin
),
650 'git': (GitSearchPath
, GitPin
),
651 'symlink': (SymlinkSearchPath
, SymlinkPin
),
653 SP
, P
= mapping
[conf
['type']]
654 _
, all_fields
= filter_dict(dict(conf
.items()), set(['type']))
655 pin_fields
, remaining_fields
= filter_dict(all_fields
, set(P
._fields
))
656 # Error suppression works around https://github.com/python/mypy/issues/9007
657 pin_present
= pin_fields
!= {} or P
._fields
== ()
658 pin
= P(**pin_fields
) if pin_present
else None # type: ignore
659 return SP(**remaining_fields
), pin
662 def read_pinned_config_section(
663 section
: str, conf
: configparser
.SectionProxy
) -> Tuple
[SearchPath
, Pin
]:
664 sp
, pin
= read_config_section(conf
)
667 'Cannot update unpinned channel "%s" (Run "pin" before "update")' %
672 def read_config(filename
: str) -> configparser
.ConfigParser
:
673 config
= configparser
.ConfigParser()
674 config
.read_file(open(filename
), filename
)
678 def read_config_files(
679 filenames
: Iterable
[str]) -> Dict
[str, configparser
.SectionProxy
]:
680 merged_config
: Dict
[str, configparser
.SectionProxy
] = {}
681 for file in filenames
:
682 config
= read_config(file)
683 for section
in config
.sections():
684 if section
in merged_config
:
685 raise Exception('Duplicate channel "%s"' % section
)
686 merged_config
[section
] = config
[section
]
690 def pinCommand(args
: argparse
.Namespace
) -> None:
692 config
= read_config(args
.channels_file
)
693 for section
in config
.sections():
694 if args
.channels
and section
not in args
.channels
:
697 sp
, old_pin
= read_config_section(config
[section
])
699 config
[section
].update(sp
.pin(v
, old_pin
)._asdict
())
701 with open(args
.channels_file
, 'w') as configfile
:
702 config
.write(configfile
)
705 def updateCommand(args
: argparse
.Namespace
) -> None:
707 exprs
: Dict
[str, str] = {}
709 section
: read_pinned_config_section(section
, conf
) for section
,
710 conf
in read_config_files(
711 args
.channels_file
).items()}
712 alias
, nonalias
= partition_dict(
713 lambda k
, v
: isinstance(v
[0], AliasSearchPath
), config
)
715 for section
, (sp
, pin
) in nonalias
.items():
716 assert not isinstance(sp
, AliasSearchPath
) # mypy can't see through
717 assert not isinstance(pin
, AliasPin
) # partition_dict()
718 tarball
= sp
.fetch(v
, pin
)
720 'f: f { name = "%s"; channelName = "%%s"; src = builtins.storePath "%s"; }' %
721 (pin
.release_name
, tarball
))
723 for section
, (sp
, pin
) in alias
.items():
724 assert isinstance(sp
, AliasSearchPath
) # For mypy
725 exprs
[section
] = exprs
[sp
.alias_of
]
733 '<nix/unpack-channel.nix>',
735 '--from-expression'] + [exprs
[name
] % name
for name
in sorted(exprs
.keys())]
737 print(' '.join(map(shlex
.quote
, command
)))
739 v
.status('Installing channels with nix-env')
740 process
= subprocess
.run(command
)
741 v
.result(process
.returncode
== 0)
745 parser
= argparse
.ArgumentParser(prog
='pinch')
746 subparsers
= parser
.add_subparsers(dest
='mode', required
=True)
747 parser_pin
= subparsers
.add_parser('pin')
748 parser_pin
.add_argument('channels_file', type=str)
749 parser_pin
.add_argument('channels', type=str, nargs
='*')
750 parser_pin
.set_defaults(func
=pinCommand
)
751 parser_update
= subparsers
.add_parser('update')
752 parser_update
.add_argument('--dry-run', action
='store_true')
753 parser_update
.add_argument('--profile', default
=(
754 '/nix/var/nix/profiles/per-user/%s/channels' % getpass
.getuser()))
755 parser_update
.add_argument('channels_file', type=str, nargs
='+')
756 parser_update
.set_defaults(func
=updateCommand
)
757 args
= parser
.parse_args()
761 if __name__
== '__main__':