R Tutorial: Description and Namespace files

Key Takeaways

now you've seen the basic structure of a package and know what to do with your are functions let's take a look at two important aspects of your package the description and namespace the description file contains basic information about the package including its authors and maintainer its dependencies and the license let's take a look at an example description file now the basic package metadata includes the package name that you chose when you created the package as well as a one-line title for your package and a short description this is the information people typically use to judge the content of your package when searching for new packages so keep it relevant and descriptive and make sure you update it if you change the package the version field tells us which version of the package this is when you start making changes to your package you should remember to increment the version number this will allow you and others to keep track of which version of the package they are working with then we have the license this defines how other people can use ocurred in your package the authors at our field is where you list the package authors as occurred the our function person helps us to keep this in the right format you need to give the first name last name email and royal the role is an abbreviation and there are many many possibilities you could use but most common for our packages are CR e for the package maintainer aut for an author CTB for contributors and CP hich for the package copyright holder this is often used when a company owns copyright on a package people can have multiple roles you just supply them as a vector like in the example here you can also have multiple people you simply need to provide a vector of person calls one for each person the last entries of nerds are the depends and imports fields these ensure that any other package your package needs is installed and is available to use before someone tries to run the code you'll be looking at the differences between depends and imports later in this course but for now you can see that the minimum version of our is listed in the depends field and other package dependencies are listed in the imports field the namespace file allows you to control two very important things firstly which functions from other packages you need access to to run the curd in our package secondly which functions from your package you want to make available to people using it you will come back to both of these ideas later but all you need to know now is that you don't need to edit this file you will manage it with all of your other documentation for now let's just take a quick look at what a complete namespace might look like this file always contains a reminder to us not to edit it but otherwise you can see that in this package you are importing or making available to your package the functions from deep liar from your package you are exporting are making available to the package users any accounter now you have seen these two important files it's your turn to try creating a description file for your package