libdcp
pkl.h
1 /*
2  Copyright (C) 2018-2021 Carl Hetherington <cth@carlh.net>
3 
4  This file is part of libdcp.
5 
6  libdcp is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 2 of the License, or
9  (at your option) any later version.
10 
11  libdcp is distributed in the hope that it will be useful,
12  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  GNU General Public License for more details.
15 
16  You should have received a copy of the GNU General Public License
17  along with libdcp. If not, see <http://www.gnu.org/licenses/>.
18 
19  In addition, as a special exception, the copyright holders give
20  permission to link the code of portions of this program with the
21  OpenSSL library under certain conditions as described in each
22  individual source file, and distribute linked combinations
23  including the two.
24 
25  You must obey the GNU General Public License in all respects
26  for all of the code used other than OpenSSL. If you modify
27  file(s) with this exception, you may extend this exception to your
28  version of the file(s), but you are not obligated to do so. If you
29  do not wish to do so, delete this exception statement from your
30  version. If you delete this exception statement from all source
31  files in the program, then also delete it here.
32 */
33 
34 
40 #ifndef LIBDCP_PKL_H
41 #define LIBDCP_PKL_H
42 
43 
44 #include "object.h"
45 #include "types.h"
46 #include "util.h"
47 #include "certificate_chain.h"
48 #include <libcxml/cxml.h>
49 #include <boost/filesystem.hpp>
50 
51 
52 namespace dcp {
53 
54 
55 class PKL : public Object
56 {
57 public:
58  PKL (Standard standard, boost::optional<std::string> annotation_text, std::string issue_date, std::string issuer, std::string creator)
59  : _standard (standard)
60  , _annotation_text (annotation_text)
61  , _issue_date (issue_date)
62  , _issuer (issuer)
63  , _creator (creator)
64  {}
65 
66  explicit PKL (boost::filesystem::path file);
67 
68  Standard standard () const {
69  return _standard;
70  }
71 
72  boost::optional<std::string> annotation_text () const {
73  return _annotation_text;
74  }
75 
76  boost::optional<std::string> hash (std::string id) const;
77  boost::optional<std::string> type (std::string id) const;
78 
79  void add_asset (std::string id, boost::optional<std::string> annotation_text, std::string hash, int64_t size, std::string type);
80  void write (boost::filesystem::path file, std::shared_ptr<const CertificateChain> signer) const;
81 
83  boost::optional<boost::filesystem::path> file () const {
84  return _file;
85  }
86 
87  class Asset : public Object
88  {
89  public:
90  Asset (cxml::ConstNodePtr node)
91  : Object (remove_urn_uuid(node->string_child("Id")))
92  , _annotation_text (node->optional_string_child("AnnotationText"))
93  , _hash (node->string_child("Hash"))
94  , _size (node->number_child<int64_t>("Size"))
95  , _type (node->string_child("Type"))
96  {}
97 
98  Asset (std::string id, boost::optional<std::string> annotation_text, std::string hash, int64_t size, std::string type)
99  : Object (id)
100  , _annotation_text (annotation_text)
101  , _hash (hash)
102  , _size (size)
103  , _type (type)
104  {}
105 
106  boost::optional<std::string> annotation_text () const {
107  return _annotation_text;
108  }
109 
110  std::string hash () const {
111  return _hash;
112  }
113 
114  int64_t size () const {
115  return _size;
116  }
117 
118  std::string type () const {
119  return _type;
120  }
121 
122  private:
123  boost::optional<std::string> _annotation_text;
124  std::string _hash;
125  int64_t _size = 0;
126  std::string _type;
127  };
128 
129  std::vector<std::shared_ptr<Asset>> asset_list () const {
130  return _asset_list;
131  }
132 
133 private:
134 
135  Standard _standard = dcp::Standard::SMPTE;
136  boost::optional<std::string> _annotation_text;
137  std::string _issue_date;
138  std::string _issuer;
139  std::string _creator;
140  std::vector<std::shared_ptr<Asset>> _asset_list;
142  mutable boost::optional<boost::filesystem::path> _file;
143 };
144 
145 
146 }
147 
148 
149 #endif
CertificateChain class.
Some part of a DCP that has a UUID.
Definition: object.h:63
Definition: pkl.h:56
boost::optional< boost::filesystem::path > file() const
Definition: pkl.h:83
boost::optional< boost::filesystem::path > _file
Definition: pkl.h:142
Namespace for everything in libdcp.
Definition: array_data.h:50
Object class.
Miscellaneous types.
Utility methods and classes.