Browse files

readme: add information about in progress points

Signed-off-by: Aleksa Sarai <>
  • Loading branch information...
1 parent 9e0a646 commit 5c85a5982d9ba6bdde4e80e56b9c9a7ab4082359 @cyphar committed Nov 4, 2016
Showing with 35 additions and 18 deletions.
  2. +0 −14 LICENSE
  3. +35 −4
File renamed without changes.
@@ -1,14 +0,0 @@
-imagectl: OCI image manipulation tool
-Copyright (C) 2016 SUSE LLC.
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-See the License for the specific language governing permissions and
-limitations under the License.
@@ -1,6 +1,10 @@
-## `imagectl` ###
+## `umoci` ###
-`imagectl` intends to be a complete manipulation tool for [OCI images][oci-image-spec].
+**u**moci **m**odifies **O**pen **C**ontainer **i**mages. Not a great name, but
+what are you going to do. It also is a cool way for people to "dip their toe"
+into OCI images ("umoci" also means "to dip" in Serbian).
+`umoci` intends to be a complete manipulation tool for [OCI images][oci-image-spec].
In particular, it should be seen as a more end-user-focused version of the
[`oci-image-tools` provided by the OCI][oci-image-tools]. The hope is that all
of this tooling will eventually be merged with the upstream repository, so that
@@ -18,12 +22,39 @@ what **I** would like to see in an `oci-image` tool.
+### In Progress ###
+Currently `umoci` isn't being developed, since there are several open PRs and
+issues that need to be resolved in order for this code to be worked on. In no
+particular order:
+* [ ] `go-mtree` needs to have better handling of comparing specifications and
+ directories. I have [an open pull request which is being reviewed and will
+ hopefully be merged soon][gomtree-pr].
+* [ ] The proposed implementation for [`oci-create-layer`][oci-create-layer]
+ needs to be finalised so that I can fork it to use `[]gomtree.InodeDelta` to
+ generate the diff layer. I intend to actually contribute that fork back
+ upstream, but the maintainers have expressed concerns about `go-mtree`
+ because of its age.
+* [ ] While I don't agree with the CLI tooling, in order to effectively access the
+ CAS of an OCI image we need to have the `Engine` interface from [this
+ PR][oci-cas] merged. In particular, I don't want to have to write my own
+ version of the blob writing code.
+There are also some other issues that I need to make a decision about (specifically)
### License ###
-`imagectl` is licensed under the terms of the Apache 2.0 license.
+`umoci` is licensed under the terms of the Apache 2.0 license.
-imagectl: OCI image manipulation tool
+umoci: Umoci Modifies Open Containers' Images
Copyright (C) 2016 SUSE LLC.
Licensed under the Apache License, Version 2.0 (the "License");

0 comments on commit 5c85a59

Please sign in to comment.