Package: r2c-inputset-generator
Input Set GeneratorThis is the input set generator for the R2C platform.InstallationTo install, simplypip install r2c-inputset-generator. Then runr2c-isgto load the shell.Note:This application caches HTTP requests to the various package registries in the terminal's current directory. Be sure to navigate to an appropriate directory before loading the shell, or use the commandset-api --nocacheinside the shell.Quick StartTry the following command sequences:Load the top 4,000 pypi projects by downloads in the last 365 days, sort by descending number of downloads, trim to the top 100 most downloaded, download project metadata and all versions, and generate an input set json.load pypi list top4kyear
  sort "desc download_count"
  trim 100
  get -mv all
  set-meta -n test -v 1.0
  export inputset.jsonLoad all npm projects, sample 100, download the latest versions, and generate an input set json.load npm list allbydependents
  sample 100
  get -v latest
  set-meta -n test -v 1.0
  export inputset.jsonLoad a csv containing github urls and commit hashes, get project metadata and the latest versions, generate an input set json of type GitRepoCommit, remove all versions, and generate an input set json of type GitRepo.load --columns "url v.commit" github file list_of_github_urls_and_commits.csv
  get -mv latest
  set-meta -n test -v 1.0
  export inputset_1.json
  trim -v 0
  export inputset_2.jsonLoad a list of github repos from an organization name.load github org netflixShell UsageInput/Outputload(OPTIONS) [noreg | github | npm | pypi] [WEBLIST_NAME | FILEPATH.csv]Generates a dataset from a weblist or a local file. The following weblists are available:Github: top1kstarred, top1kforked; the top 1,000 most starred or forked reposNPM: allbydependents;allpackages, sorted from most to fewest dependents count (caution: 1M+ projects... handle with care)Pypi: top4kmonth and top4kyear; the top 4,000 most downloaded projects in the last 30/365 daysOptions:-c --columns"string of col names": A space-separated list of column names in a csv. Overrides default columns (name and version), as well as any headers listed in the file (headers in files begin with a '!'). The CSV reader recognizes the following column keywords: name, url, org, v.commit, v.version. All other columns are read in as project or version attributes.Example usage: --headers "name url downloads v.commit v.date".backup(FILEPATH.p)Backs up the dataset to a pickle file (defaults to ./dataset_name.p).restoreFILEPATH.pRestores a dataset from a pickle file.import[noreg | github | npm | pypi] FILEPATH.jsonBuilds a dataset from an R2C input set.export(FILEPATH.json)Exports a dataset to an R2C input set (defaults to ./dataset_name.json).Data Acquisitionget(OPTIONS)Downloads project and version metadata from Github/NPM/Pypi.Options:-m --metadata: Gets metadata for all projects.-v --versions[all | latest]: Gets historical versions for all projects.Transformationtrim(OPTIONS) NTrims the dataset tonprojects ornversions per project.Options-v --versions: Binary flag; trims on versions instead of projects.sample(OPTIONS) NSamplesnprojects ornversions per project.Options-v --versions: Binary flag; sample versions instead of projects.sort"[asc, desc] attributes [...]"Sorts the projects and versions based on a space-separated string of keywords. Valid keywords are:Any project attributesAny version attributes (prepend "v." to the attribute name)Any uuids (prepend "uuids." to the uuid nameAny meta values (prepend "meta." to the meta nameThe words "asc" and "desc"All values are sorted in ascending order by default. The first keyword in the string is the primary sort key, the next the secondary, and so on.Example: The string "uuids.name meta.url downloads desc v.version_str v.date" would sort the dataset by ascending project name, url, and download count; and descending version string and date (assuming those keys exist).Settingsset-meta(OPTIONS)Sets the dataset's metadata.Options:-n --nameNAME: Input set name. Must be set before the dataset can be exported.-v --versionVERSION: Input set version. Must be set before the dataset can be exported.-d --descriptionDESCRIPTION: Description string.-r --readmeREADME: Markdown-formatted readme string.-a --authorAUTHOR: Author name; defaults to git user.name.-e --emailEMAIL: Author email; defaults to git user.email.set-api(OPTIONS)--cache_dirCACHE_DIR: The path to the requests cache; defaults to ./.requests_cache.--cache_timeoutDAYS: The number of days before a cached request goes stale.--nocache: Binary flag; disables request caching for this dataset.--github_patGITHUB_PAT: A github personal access token, used to increase the max allowed hourly request rate from 60/hr to 5,000/hr. For instructions on how to obtain a token, see:https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line.VisualizationshowConverts the dataset to a json file and loads it in the system's native json viewer.Python ProjectYou can also import the package into your own project. Just import the Dataset structure, initialize it, and you're good to go!from r2c_isg.structures import Dataset

ds = Dataset.import_inputset(
    'file.csv' ~or~ 'weblist_name',
    registry='github' ~or~ 'npm' ~or~ 'pypi',
    cache_dir=path/to/cache/dir,      # optional; overrides ./.requests_cache
    cache_timeout=int(days_in_cache), # optional; overrides 1 week cache timeout
    nocache=True,                     # optional; disables caching
    github_pat=your_github_pat        # optional; personal access token for github api
)

ds.get_projects_meta()

ds.get_project_versions(historical='all' ~or~ 'latest')

ds.trim(
    n,
    on_versions=True	# optional; defaults to False
)

ds.sample(
    n,
    on_versions=True	# optional; defaults to False
)

ds.sort('string of sort parameters')

ds.update(**{'name': 'you_dataset_name', 'version': 'your_dataset_version'})

ds.export_inputset('your_inputset.json')TroubleshootingIf you run into any issues, you can run the shell with the--debugflag enabled to get a full error message. Then reach out tosupport@ret2.cowith the stack trace and the steps to reproduce the error.Note:If the issue is related to the "sample" command, be sure to seed the random number generator to ensure reproducibility.